本頁面由 Cloud Translation API 翻譯而成。

將 Apigee Edge 4.16.09 更新至 4.18.01

Private Cloud v4.18.01 專用 Edge

哪些 Edge 版本可以更新至 4.18.01

您可以使用這個程序將 Apigee Edge 4.16.09.0x 版更新至 4.18.01 版。

如果您使用的是舊版 Edge 4.16.01 版，就必須先遷移至以下版本： 4.16.01.x 版，然後更新至 4.18.01 版。

可執行更新的使用者

執行更新的使用者必須與當初安裝 Edge 的使用者相同，或也就是以根的身分執行的使用者

任何使用者都可設定邊緣 RPM 套件。

您需要更新哪些元件

您必須更新所有 Edge 元件。Edge 不支援含有元件的設定以便擷取來自多個版本的內容

必須升級至 Qpid 1.35

這個版本包含 Qpid 1.35 的必要更新。更新 Qpid 節點時須：

暫時防止路由器和訊息處理器寫入 Qpid 節點，方法是：阻斷通訊埠 5672您可以使用下列指令封鎖這個通訊埠 Qpid 節點：
>sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
等待 Qpid 佇列沒有任何訊息，以確保 Qpid 節點已處理完所有訊息訊息。使用下列指令來確保 Qpid 訊息佇列空白：
>qpid-stat -q
更新 Qpid 節點。
解除封鎖 Qpid 節點上的通訊埠 5672，允許從路由器和訊息處理器存取。您可以使用下列指令來解除封鎖這個通訊埠：
>sudo iptables -F

請注意，如果您將 iptable 用於其他規則，可以使用 -D 選項將特定變更：
>sudo iptables -D INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP

下文將詳細說明每個 Edge 拓撲。

必須升級至 Postgres 9.6

這個版本的 Edge 包含 Postgres 9.6 的升級版本。本次升級 Postgres 資料會遷移至 Postgres 9.6。

在更新過程中，當 Postgres 節點停止進行更新時，Analytics 資料會維持寫入 Qpid 節點Postgres 節點更新並恢復上線後，Analytics 再將資料推送至 Postgres 節點

如果必須復原任何舊的 Postgres 待命節點，原因。如果必須復原更新，新的 Postgres 待命節點會成為主要執行個體復原後的 Postgres 節點。因此，當您安裝新的 Postgres 待命節點時應位於符合 Postgres 伺服器所有硬體需求的節點上，定義請見找到邊緣的「安裝需求」。

安裝新 Postgres 待命節點

這項程序會在新的節點上建立 Postgres 待命伺服器。務必安裝新的「現有」版本的 Edge (4.16.09) 適用的 Postgres 待命伺服器，不適用於版本 4.18.01。

使用與安裝目前版本相同的設定檔執行安裝這些物件

如何建立新的 Postgres 待命節點：

在目前的 Postgres 主要執行個體中，編輯 /opt/apigee/customer/application/postgresql.properties 檔案來設定下列權杖。如果該檔案不存在，請建立一個：

conf_pg_hba_replication.connection=host 複製作業 Apigee existing_slave_ip/32 信任\ \n 主機複製 Apigee new_slave_ip/32 信任

其中 existing_slave_ip 是目前 Postgres 的 IP 位址待命伺服器，new_slave_ip 是新待命的 IP 位址節點。
重新啟動 apigee-postgresql 適用於 Postgres 主要執行個體：
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
查看 /opt/apigee/apigee-postgresql/conf/pg_hba.conf，確認已新增待命節點複製到主要執行個體該檔案中應會顯示下列幾行內容：
主機複製 Apigee existing_slave_ip/32 信任
主機複製作業 Apigee new_slave_ip/32 信任
安裝新的 Postgres 待命伺服器：
1. 編輯您用於安裝最新 Edge 版本的設定檔，以指定包含下列內容：
  
  # 個目前 IP 位址主要執行個體：
  PG_MASTER=192.168.56.103
  新待命節點的 # 個 IP 位址
  PG_STANDBY=192.168.56.102
2. 按照安裝 Edge apigee-setup 公用程式停用 SELinux。
3. 下載 Edge bootstrap_4.16.09.sh 檔案至 /tmp/bootstrap_4.16.09.sh：
  >curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
4. 安裝 Edge apigee-service 公用程式並依附元件：
  >sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
5. 使用 apigee-service 可以安裝 apigee-setup 公用程式：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
6. 安裝 Postgres：
  > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
7. 在新待命節點上執行下列指令：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  驗證裝置是否為待機。

停用 Postgres 節點

更新完成後，停用新的待命節點：

確認 Postgres 正在執行：
> /opt/apigee/apigee-service/bin/apigee-all status

如果 Postgres 未執行，請啟動：
> /opt/apigee/apigee-service/bin/apigee-all start
請在新的待命節點上執行以下 cURL 指令，取得新待命節點的 UUID 待命節點：
>curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

輸出內容結尾處會顯示節點的 UUID，格式如下：
「類型」: [ "postgres-server" ],
「uUID」："599e8ebf-5d69-4ae4-aa71-154970a8ec75"
對新的待命節點執行下列指令，以停止新的待命節點：
> /opt/apigee/apigee-service/bin/apigee-all stop
在 Postgres 主要節點上，編輯 /opt/apigee/customer/application/postgresql.properties 從 conf_pg_hba_replication.connection 中移除新的待命節點：
conf_pg_hba_replication.connection=host 複製作業 Apigee existing_slave_ip/32 信任
在 Postgres 主要執行個體上重新啟動 apigee-postgresql：
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
查看 /opt/apigee/apigee-postgresql/conf/pg_hba.conf，驗證新的待命節點是否已移除。複製到主要執行個體該檔案中應該只會出現以下這行內容：
主機複製 Apigee existing_slave_ip/32 信任
建立下列 Edge 管理功能，以便從 ZooKeeper 刪除待命節點的 UUID Management Server 節點上的 API 呼叫：
>curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

必須授予這項權限，才能啟用 EPEL 存放區

您必須啟用 [額外套件] Enterprise Linux (或 EPEL)：安裝或更新 Edge。您使用的指令取決於或是使用您的 RedHat/CentOS 版本：

適用於 RedHat/CentOS/Oracle 7.x：
>wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm;rpm - Vh epel-release-latest-7.noarch.rpm
適用於 RedHat/CentOS/Oracle 6.x：
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm;rpm - Vh epel-release-latest-6.noarch.rpm

必須新增 SMTP MailFROM 設定參數

在您啟用設定檔時使用的設定檔時，Edge 4.17.05 新增了必要參數具備 SMTP 伺服器連線如果是透過 4.17.01 更新，則必須在設定檔中設定 SMTPmailFROM 啟用時可能發生這種情況

API BaaS 4.17.09 版也開始支援 SMTP MailFROM 屬性。更新 API BaaS 時，您必須在設定檔

這個參數的格式如下：

SMTPMAILFROM="My Company <myco@company.com>"

若使用外部驗證

您可以將外部目錄服務整合至現有的 Apigee Edge 私有雲安裝。此功能適合與任何支援 LDAP、例如 Active Directory 和 OpenLDAP 等外部 LDAP 解決方案可讓系統管理員可透過集中式目錄管理服務來管理使用者憑證， (例如 Apigee Edge 等使用這類系統的系統)。

請參閱外部驗證設定。

啟用外部驗證後，大部分的客戶都會使用 Active Directory SAM 帳戶做為驗證使用者名稱的名稱，而不是 Edge OpenLDAP 伺服器。

如果您已與外部目錄服務整合，請將下列程式碼新增至來安裝您的設定檔：

IS_EXTERNAL_AUTH="true"

這一行會將 Edge 設定為支援帳戶名稱，而非電子郵件地址，使用者名稱。

屬性自動傳播設定

如果您在 /opt/apigee/customer/application 中編輯 .properties 檔案來設定任何屬性，則這些屬性值都會由更新保留。

更新必要條件

升級 Apigee Edge 前，請先瞭解下列事項：

備份所有節點
更新前，建議您對所有節點執行完整備份以確保安全理由。按照目前 Edge 版本的程序執行備份。

這樣一來，您就可以建立備份方案，以在未更新至新版本時派上用場功能。如要進一步瞭解備份，請參閱備份和還原。
確保 Edge 正在執行
使用下列指令，確保 Edge 在更新程序期間已啟動並執行：

> /opt/apigee/apigee-service/bin/apigee-all status

處理失敗的更新

如果更新失敗，您可以嘗試修正問題，然後執行 update.sh 可以選取「重新建立」，再次生成新的提示您可以多次執行更新，系統會從上次中斷的地方繼續更新關閉。

如果作業失敗，您必須將更新復原為先前版本，請參閱 4.18.01 復原程序以取得更多資訊。

記錄更新資訊

根據預設，update.sh 公用程式會將記錄資訊寫入：

/opt/apigee/var/log/apigee-setup/update.log

如果執行 update.sh 公用程式的使用者無法存取並將記錄寫入 /tmp 目錄，名稱為 update_username.log。

如果使用者無法存取 /tmp，update.sh 公用程式就會失敗。

零停機時間更新

零停機時間更新或滾動式更新可讓您在沒有停機時間的情況下更新 Edge 安裝作業進而關閉 Edge

零停機時間更新只能透過 5 個節點設定完成。

升級到零停機時間的關鍵，在於從負載中逐一移除每個路由器，一次一個。接著在路由器上更新路由器和任何其他元件，這些元件與路由器相同。然後將路由器加回負載平衡器

請依照下方「訂單」一節的說明，按照正確的安裝順序更新機器機器更新」
需要更新路由器時，請選取任一路由器並設為無法連線，如下所示：如啟用/停用伺服器中所述 (訊息處理器/路由器) 可連性。
在與路由器相同的機器上，更新所選路由器和所有其他 Edge 元件。所有邊緣設定會在相同節點上顯示路由器和訊息處理器。
重新連線至路由器。
針對其餘的路由器，重複步驟 2 到 4。
請繼續為安裝中其餘的機器進行更新。

更新前後請謹慎處理下列事項：

在合併的路由器和訊息處理器節點上：
- 更新前 - 執行下列動作：
  1. 將路由器設為無法連線。
  2. 將無法連線至訊息處理器設為連線。
- 更新後，請執行下列步驟：
  1. 請連線至訊息處理器。
  2. 將路由器設為可連線。
在單一路由器節點上：
- 更新前，請先將無法連線至路由器設為無法使用。
- 更新後，請將路由器設為可連線。
在單一訊息處理器節點上：
- 更新前，請先設為無法連線至訊息處理器。
- 更新後，請連線至「訊息處理器」，

使用靜音設定檔

您必須將靜音設定檔傳送至 update 指令。靜音設定檔必須與您安裝 Edge 4.16.09 時使用的相同。

程序時間：在有外部網際網路連線的節點上更新至 4.18.01

請使用下列程序更新節點上的 Edge 元件：

如果您目前使用的是 Postgres 主待命複製功能，請安裝新的 Postgres 待命節點，如上方「安裝新 Postgres」一節所述待命節點
如果有 CRON 工作顯示在 Cassandra 上，請將該工作設為停用。直到更新完成為止
以根權限登入節點，安裝邊緣 RPM。
注意：雖然 RPM 安裝作業需要 Root 存取權，但你可以執行 Edge 沒有根目錄存取權的話
安裝 yum-utils 並 yum-plugin-priorities:
>sudo yum install yum-utils
>sudo yum install yum-plugin-priorities
按照安裝使用 Edge Apigee-setup 公用程式。
按照上述方式啟用 EPEL 存放區。
如果是在 Oracle 7.x 上安裝，請執行下列指令：
>sudo yum-config-manager --enable ol7_optional_latest
如果您是在 AWS 上安裝，請執行以下 yum-configure-manager 指令：
>Yum 更新 rh-amazon-rhui-client.noarch
>sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
下載 Edge 4.18.01 bootstrap_4.18.01.sh 檔案至 /tmp/bootstrap_4.18.01.sh：
>curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
安裝 Edge 4.18.01 apigee-service 公用程式並依附元件：
>sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

其中 uName:pWord 是你收到的使用者名稱和密碼 Apigee。如果您省略 pWord，系統會提示您輸入。

根據預設，安裝程式會檢查您是否已安裝 Java 1.8。如果不是，便會自動安裝使用 JAVA_FIX 選項指定處理方式 Java 安裝。JAVA_FIX 採用下列值：

I = 安裝 OpenJDK 1.8 (預設)
C = 在不安裝 Java 的情況下繼續操作
問：退出，如果採用這個選項，您必須自行安裝 Java。
使用 apigee-service 更新 Apigee-setup 公用程式：
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
更新 apigee-validate 管理伺服器的公用程式：
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate 更新
更新 apigee-provision 公用程式：
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
依照以下「機器順序」一節的說明，在節點上執行更新公用程式更新」如下：
> /opt/apigee/apigee-setup/bin/update.sh -c 元件 -f configFile

設定檔的唯一規定是設定檔必須可供存取可由「apigee」讀取內容。

使用「-c」選項指定要更新的元件。系統會列出元件包括：
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =所有 Edge 元件除了 Edge UI：管理伺服器、訊息處理器、路由器、QPID Server、Postgres 伺服器
ui = Edge UI
all = 更新機器 (僅適用於 Edge aio 安裝設定檔或 API BaaS 作為安裝之用個人資料)
e = ElasticSearch
b = API BaaS 堆疊
p = API BaaS 入口網站
ebp = ElasticSearch、API BaaS 在同一節點上建立堆疊和 API BaaS 入口網站
在管理伺服器上執行 Apigee-validate 公用程式，以測試更新。請參閱「測試安裝」一文。
如果您已安裝新的 Postgres 待命節點，請按照上述說明停用該節點停用 Postgres 節點。

如要稍後復原更新，請使用 4.18.01 復原程序所述的程序。

從本機更新至 4.18.01 的程序存放區

如果您的 Edge 節點在防火牆後面，或以其他方式遭禁止存取透過網際網路取得 Apigee 存放區，接著您可以從本機存放區執行更新或鏡像功能

建立本機 Edge 存放區後，您可以透過兩種方式更新 Edge 本機存放區：

建立存放區的 .tar 檔案，將 .tar 檔案複製到節點，然後從 .tar 檔案。
在含有本機存放區的節點中安裝網路伺服器，以便其他節點存取。 Apigee 提供 Nginx 網路伺服器供您使用，您也可以使用自己的網路伺服器

如何從本機 4.18.01 存放區更新：

如果您目前使用的是 Postgres 主要執行個體待命複製功能，請安裝新的 Postgres 待命節點，方法如「安裝新的 Postgres 待命節點功能。
按照「建立本機 Apigee 存放區」中的說明建立本機 4.18.01 存放區請參閱安裝 Edge apigee-setup 公用程式。
注意：如果已有 4.16.09 存放區，則可新增 4.18.01 版複製到該存放區，如「更新本機 Apigee 存放區」中所述請參閱安裝 Edge apigee-setup 公用程式。
如要從 .tar 檔案安裝 apigee-service：
1. 在含有本機存放區的節點上，使用下列指令來封裝本機存放區複製到名為 /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz 的單一.tar 檔案：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror 套件
2. 將 .tar 檔案複製到要更新 Edge 的節點。例如，請複製到上的 /tmp 目錄新節點
3. 在新節點上，將檔案解壓縮至 /tmp 目錄：
  >tar -xzf apigee-4.18.01.tar.gz
  
  這個指令會在包含 .tar 的目錄中建立新的目錄 (名稱為存放區) 檔案。例如 /tmp/repos。
4. 從 /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件：
  >sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file:// apigeerepobasepath=/tmp/repos
  
  請注意，您會在這個指令中加入存放區目錄的路徑。
使用 Nginx 網路伺服器安裝 apigee-service：
1. 按照「使用 Nginx 從存放區安裝」一節的說明，設定 Nginx 網路伺服器 webserver"「Install the Edge apigee-setup 公用程式。
2. 在遠端節點上，下載 Edge bootstrap_4.18.01.sh 檔案， /tmp/bootstrap_4.18.01.sh：
  >/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  
  其中 uName:pWord 是您在上方設定的使用者名稱和密碼存放區，而 remoteRepo 是存放區節點
3. 在遠端節點上，安裝 Edge apigee-service 公用程式和依附元件：
  >sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo：3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  其中 uName:pWord 是存放區的使用者名稱和密碼。
使用 apigee-service 可以更新 apigee-setup 公用程式：
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
更新 apigee-validate 公用程式。
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate 更新
更新 apigee-provision 公用程式：
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
依照以下「機器順序」一節的說明，在節點上執行更新公用程式更新」如下：
> /opt/apigee/apigee-setup/bin/update.sh -c 元件 -f configFile

設定檔的唯一規定是設定檔必須可供存取可由「apigee」讀取內容。

使用「-c」選項指定要更新的元件。系統會列出元件包括：
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =所有 Edge 元件除了 Edge UI：管理伺服器、訊息處理器、路由器、QPID Server、Postgres 伺服器
ui = Edge UI
all = 更新機器 (僅適用於 Edge aio 安裝設定檔或 API BaaS 作為安裝之用個人資料)
e = ElasticSearch
b = API BaaS 堆疊
p = API BaaS 入口網站
ebp = ElasticSearch、API BaaS 在同一節點上建立堆疊和 API BaaS 入口網站
在管理伺服器上執行 Apigee-validate 公用程式，以測試更新。請參閱「測試安裝」一文。
如果您已安裝新的 Postgres 待命節點，請按照下文說明停用該節點以上停用一個 Postgres 節點

如要稍後復原更新，請使用 4.18.01 復原程序所述的程序。

機器更新順序

您在 Edge 安裝程序中更新機器的順序相當重要。最常出現更新時的重要注意事項如下：

您必須先更新「所有」Cassandra 和 ZooKeeper 節點，才能更新任何節點和其他節點
適用於具備多個 Edge 元件 (管理伺服器、訊息處理器) 的任何機器路由器、QPID 伺服器，而非 Postgres 伺服器)，使用「-c 邊緣」或是更新
如果步驟指定應在多部機器上執行，請在該步驟中執行指定的機器順序
更新營利設定無須另外執行一個步驟。這個清單會在您指定「-c」時更新邊緣」如果有需要 SQL 指令的分析工作負載則 BigQuery 可能是最佳選擇

單獨使用安裝

在設定檔 (前提是您已啟用 Edge 上的 SMTP)，這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
更新 Cassandra 和 ZooKeeper：
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
設定以下 iptable 規則：
>sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
檢查 Qpid 訊息佇列：
>qpid-stat -q

繼續查看佇列，直到「訊息」中的計數值為 0。無法升級 Qpid 直到處理完所有訊息為止
更新 qpidd：
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
清除 iptable：
>sudo iptables -F
更新 LDAP：
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
停止 Postgres Server、Qpid 伺服器和 PostgreSQL：
> /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
>/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
>/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
更新 postgresql：
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
更新 Postgres 資料庫：
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
更新其餘 Edge 元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
更新 Edge UI：
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

獨立 2 主機安裝

如需 Edge 清單，請參閱「安裝拓撲」拓撲和節點編號

在設定檔 (前提是您已啟用 Edge 上的 SMTP)，這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
在機器 1 上更新 Cassandra 和 ZooKeeper：
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
在機器 2 上設定下列 iptable 規則：
>sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
檢查機器 2 的 Qpid 訊息佇列：
>qpid-stat -q

繼續查看佇列，直到「訊息」中的計數值為 0。無法升級 Qpid 直到處理完所有訊息為止
更新 qpidd 的平台機器 2：
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
在機器 2 上清除 iptable：
>sudo iptables -F
在電腦 1 上更新 LDAP：
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
更新裝置 1 上的邊緣元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
在機器 1 上更新 UI：
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile?
在機器 2 上更新 postgresql：
1. 停止 Postgres Server、Qpid 伺服器和 postgresql：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
2. 更新 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
3. 更新 Postgres 資料庫：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
4. 更新裝置 2 上的邊緣元件：
  > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

針對 5 個主機叢集安裝

如需 Edge 清單，請參閱「安裝拓撲」拓撲和節點編號

在設定檔 (前提是您已啟用 Edge 上的 SMTP)，這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
確認已安裝新的 Postgres 待命節點 (如上所述) 說明：安裝新的 Postgres 待命節點
在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
在機器 4 上設定下列 iptable 規則：
>sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
檢查機器 4 的 Qpid 訊息佇列：
>qpid-stat -q

繼續查看佇列，直到「訊息」中的計數值為 0。無法升級 Qpid 直到處理完所有訊息為止
更新 qpidd 的平台機器 4：
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
在機器 4 上清除 iptable：
>sudo iptables -F
對電腦 5 重複步驟 4 至 7。
在電腦 1 上更新 LDAP：
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
更新機器 1、2、3 上的邊緣元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
在機器 1 上更新 UI：
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
更新機器 4 和 5：
1. 在機器 4 上停止 Postgres 伺服器和 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
2. 在電腦 5 上停止 Postgres 伺服器、Qpid 伺服器和 postgresql：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. 在您新增的待命節點上停止 Postgres 伺服器和 postgresql 復原：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
4. 更新機器 4 的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
5. 更新機器 4 中的 Postgres 資料庫 (僅限 Postgres 主要執行個體)：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
6. 更新機器 5 的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
7. 在機器 4 和 5 上啟動 Postgres 伺服器和 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
  >/opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
8. 在電腦上執行下列指令，將 Postgres 設為待命節點 5：
  >cd /opt/apigee/data/apigee-postgresql/pgdata
  >rm -rf *
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
9. 在兩個伺服器上發出下列指令碼，驗證複製狀態。兩台伺服器上應該顯示相同的結果，複製作業：
  
  在機器 4 (主要節點) 中，執行：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  驗證其是否為主版本。
  
  在機器 5 中，待命節點：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  驗證裝置是否為待機。
更新機器 4，5：
上的邊緣元件 > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
務必使用上述程序停用新的待命節點「停用一個 Postgres 節點。

針對 9 主機叢集安裝

如需 Edge 清單，請參閱「安裝拓撲」拓撲和節點編號

在設定檔 (前提是您已啟用 Edge 上的 SMTP)，這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
確認已安裝新的 Postgres 待命節點 (如上所述) 說明：安裝新的 Postgres 待命節點
在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
在機器 6 上設定下列 iptable 規則：
>sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
檢查機器 6 上的 Qpid 訊息佇列：
>qpid-stat -q

繼續查看佇列，直到「訊息」中的計數值為 0。無法升級 Qpid 直到處理完所有訊息為止
更新 qpidd 的平台機器 6：
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
在機器 6 上清除 iptable：
>sudo iptables -F
在電腦 7 上重複步驟 4 到 7。
在電腦 1 上更新 LDAP：
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
請按照下列步驟更新機器 6、7、1、4 和 5 上的 Edge 元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
在機器 1 上更新 UI：
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
更新機器 8 和 9：
1. 在機器 8 上停止 Postgres 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
2. 在機器 9 上停止 Postgres 伺服器和 postgresql：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. 在機器 6 和 7 上停止 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
4. 在您新增的待命節點上停止 Postgres 伺服器和 postgresql 復原：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
5. 更新機器 8 的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
6. 更新機器 8 上的 Postgres 資料庫 (僅限 Postgres 主要執行個體)：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. 更新機器 9 的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. 在機器 8 和 9 上啟動 Postgres 伺服器伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
9. 在機器 6 和 7 上啟動 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
10. 在電腦上執行下列指令，將 Postgres 設為待命節點 9：
  >cd /opt/apigee/data/apigee-postgresql/pgdata
  >rm -rf *
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
11. 在兩個伺服器上發出下列指令碼，驗證複製狀態。兩台伺服器上應該顯示相同的結果，複製作業：
  在機器 8 中，執行主要節點：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  驗證其是否為主版本。
  
  機器 9 上的待命節點：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  驗證裝置是否為待機。
更新機器 8 和 9 上的邊緣元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
務必使用上述程序停用新的待命節點「停用一個 Postgres 節點。

13 主機叢集安裝

如需 Edge 清單，請參閱「安裝拓撲」拓撲和節點編號

在設定檔 (前提是您已啟用 Edge 上的 SMTP)，這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
確認已安裝新的 Postgres 待命節點 (如上所述) 說明：安裝新的 Postgres 待命節點
在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
在機器 12 上設定下列 iptable 規則：
>sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
檢查機器 12 上的 Qpid 訊息佇列：
>qpid-stat -q

繼續查看佇列，直到「訊息」中的計數值為 0。無法升級 Qpid 直到處理完所有訊息為止
更新 qpidd 的平台機器 12：
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
在機器 12 上清除 iptable：
>sudo iptables -F
對機器 13 重複步驟 4 到 7。
在電腦 4 和 5 上更新 LDAP：
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
請依照下列順序更新機器 12、13、6、7、10 和 11 上的 Edge 元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
更新機器 6 和 7 上的 UI：
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile？
更新機器 8 和 9：
1. 在機器 8 上停止 Postgres 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
2. 在機器 9 上停止 Postgres 伺服器和 postgresql：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. 在機器 12 與 13 上停止 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
4. 在您新增的待命節點上停止 Postgres 伺服器和 postgresql 復原：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
5. 更新機器 8 的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
6. 更新機器 8 上的 Postgres 資料庫 (僅限 Postgres 主要執行個體)：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. 更新機器 9 的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. 在機器 8 和 9 上啟動 Postgres 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
9. 在機器 12 和 13 上啟動 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
10. 在電腦上執行下列指令，將 Postgres 設為待命節點 9：
  >cd /opt/apigee/data/apigee-postgresql/pgdata
  >rm -rf *
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
11. 在兩個伺服器上發出下列指令碼，驗證複製狀態。兩台伺服器上應該顯示相同的結果，複製作業：
  在機器 8 中，執行主要節點：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  驗證其是否為主版本。
  
  機器 9 上的待命節點：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  驗證裝置是否為待機。
更新機器 8 和 9 上的邊緣元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile??
務必使用上述程序停用新的待命節點「停用一個 Postgres 節點。

針對 12 個主機叢集安裝

如需 Edge 清單，請參閱「安裝拓撲」拓撲和節點編號

在設定檔 (前提是您已啟用 Edge 上的 SMTP)，這個參數的格式如下：
SMTP MailFROM="我的公司 <myco@company.com>"
確認已安裝新的 Postgres 待命節點 (如上所述) 說明：安裝新的 Postgres 待命節點
更新 Cassandra 和 ZooKeeper：
1. 在資料中心 1 的機器 1、2 和 3 中：
  > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
2. 位於資料中心 2 中的機器 7、8 和 9
  > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
更新 qpidd：
1. 資料中心 1 中的機器 4、5 部
  1. 在機器 4 上設定下列 iptable 規則：
    >sudo iptables -A INPUT -p tcp --destination-port 5672！-s `hostname` -i eth0 -j DROP
  2. 檢查機器 4 的 Qpid 訊息佇列：
    >qpid-stat -q
    
    繼續查看佇列，直到「訊息」中的計數值為 0。你無法升級 Qpid，直到處理完所有訊息為止。
  3. 在機器 4 上更新 qpidd ：
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. 在機器 4 上清除 iptable：
    >sudo iptable -週五
  5. 對機器 5 重複步驟 1 到 4。
2. 資料中心 2 中的機器 10、11
  1. 在機器 10 上設定下列 iptable 規則：
    >sudo iptables -A INPUT -p tcp --destination-port 5672！-s `hostname` -i eth0 -j DROP
  2. 檢查機器 10 上的 Qpid 訊息佇列：
    >qpid-stat -q
    
    繼續查看佇列，直到「訊息」中的計數值為 0。你無法升級 Qpid，直到處理完所有訊息為止。
  3. 在電腦 10 上更新 qpidd ：
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. 在機器 10 中清除 iptable：
    >sudo iptable -週五
  5. 在機器 11 上重複步驟 1 到 4。
更新 LDAP：
1. 資料中心 1
  中的機器 1 > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
2. 資料中心 2
  中的機器 7 > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
更新 Edge 元件：
1. 資料中心 1
  中的機器 4、5、1、2、3 > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
2. 資料中心 2 中的機器 10、11、7、8、9
  > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
更新 UI：
1. 資料中心 1 中的機器 1：
  > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
2. 資料中心 2 中的機器 7：
  > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile？？
在資料中心 2 中更新資料中心 1 和 12 中的機器 6：
1. 在機器 6 上停止 Postgres 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
2. 在機器 12 上停止 Postgres 伺服器和 postgresql：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
3. 在機器 4、5、10 和 11 上停止 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server stop
4. 在您新增的待命節點上停止 Postgres 伺服器和 postgresql 復原：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server stop
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
5. 更新機器 6 上的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
6. 更新機器 6 上的 Postgres 資料庫 (僅限 Postgres 主要執行個體)：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
7. 更新機器 12 上的 postgresql：
  > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. 在機器 6 和 12 上啟動 Postgres 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
9. 在機器 4、5、10 和 11 上啟動 Qpid 伺服器：
  > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
10. 在電腦上執行下列指令，將 Postgres 設為待命節點 12：
  >cd /opt/apigee/data/apigee-postgresql/pgdata
  >rm -rf *
  >/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
11. 在兩個伺服器上發出下列指令碼，驗證複製狀態。系統應在兩台伺服器上顯示相同的結果，複製作業：
  在機器 6 (主要節點) 上執行：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
  
  驗證其是否為主版本。
  
  在機器 12 中，待命節點：
  > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
  
  驗證裝置是否為待機。
更新裝置 6 和 12 上的 Edge 元件：
> /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
務必使用上述程序停用新的待命節點「停用一個 Postgres 節點。

7 主機 API BaaS 安裝

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

如需完整的設定檔範例，請參閱 API BaaS 安裝。

您也必須確保所有堆疊節點已開啟通訊埠 2551，以從所有其他堆疊節點存取節點。

如需 Edge 清單，請參閱「安裝拓撲」拓撲和節點編號

在機器 5、6 和 7 上更新 Cassandra：
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
在機器 1、2 和 3 上更新 ElasticSearch 和 API BaaS 堆疊：
> /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile
在機器 4 上更新 API BaaS 入口網站：
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

10 主機 API BaaS 安裝

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

如需完整的設定檔範例，請參閱 API BaaS 安裝。

您也必須確保所有堆疊節點已開啟通訊埠 2551，以從所有其他堆疊節點存取節點。

如需 Edge 清單，請參閱「安裝拓撲」拓撲和節點編號

在機器 8、9 與 10 上更新 Cassandra：
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
在機器 1、2 和 3 上更新 ElasticSearch：
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
在機器 4、5 和 6 上更新 API BaaS 堆疊：
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
在機器 7 上更新 API BaaS 入口網站：
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

非標準安裝

如果您安裝的是非標準版本，請在下方更新 Edge 元件順序：

ZooKeeper
Cassandra
qpidd、ps
LDAP
邊緣，表示「-c 邊緣」依序排列所有節點和含有 Qpid 伺服器的節點 Postgres 伺服器、管理伺服器、訊息處理器和路由器。
注意：如果節點同時安裝 Qpid 伺服器和 Postgres 伺服器，請執行「-c 邊緣」設定檔步驟
Edge UI

將 Apigee Edge 4.16.09 更新至 4.18.01

哪些 Edge 版本可以更新至 4.18.01

可執行更新的使用者

您需要更新哪些元件

必須升級至 Qpid 1.35

必須升級至 Postgres 9.6

安裝新 Postgres 待命節點

停用 Postgres 節點

必須授予這項權限，才能啟用 EPEL 存放區

必須新增 SMTP MailFROM 設定參數

若使用 外部驗證

屬性自動傳播 設定

更新必要條件

處理失敗的更新

記錄更新資訊

零停機時間更新

使用靜音設定檔

程序時間： 在有外部網際網路連線的節點上更新至 4.18.01

從本機更新至 4.18.01 的程序 存放區

機器更新順序

單獨使用 安裝

獨立 2 主機 安裝

針對 5 個主機叢集 安裝

針對 9 主機叢集 安裝

13 主機叢集 安裝

針對 12 個主機叢集 安裝

7 主機 API BaaS 安裝

10 主機 API BaaS 安裝

非標準安裝

若使用外部驗證

屬性自動傳播設定

程序時間：在有外部網際網路連線的節點上更新至 4.18.01

從本機更新至 4.18.01 的程序存放區

單獨使用安裝

獨立 2 主機安裝

針對 5 個主機叢集安裝

針對 9 主機叢集安裝

13 主機叢集安裝

針對 12 個主機叢集安裝