將 Apigee Edge 更新至 4.16.09

Private Cloud v. 4.16.09 版本

哪些 Edge 版本可更新至 4.16.09

您可以將 Apigee Edge 4.16.01.0x 版和 4.16.05.x 版更新至 4.16.09 版。

如果您使用的是 4.16.01 以下版本的 Edge，則必須先遷移至 4.16.01.x 版本，再更新至 4.16.09 版本。

誰可以執行更新

執行更新的使用者必須與當初安裝 Edge 的使用者相同，或以 root 執行的使用者相同。

安裝 Edge RPM 後，任何使用者都可以設定這些 RPM。

必須升級至 Java JDK 第 8 版

這個 Edge 版本要求您在所有 Edge 處理節點上安裝 Java JDK 8 版。您可以安裝 Oracle JDK 8 或 OpenJDK 8。如果尚未安裝 Java JDK 8，更新指令碼可以為您安裝。

在更新至 Java 8 的過程中，Oracle JDK 8 不再支援部分 TLS 密碼。如需完整清單，請參閱 http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html 中的「Default Disabled Cipher Suites」一節。

如果從 4.16.01 更新，則降級 Zookeeper

Edge for Private Cloud 4.16.01 中的 Zookeeper RPM 版本為 apigee-zookeeper-3.4.5-1.0.905.noarch.rpm。在後續的 Edge 版本中，Zookeeper 版本已改回 apigee-zookeeper-3.4.5-0.0.94x。這可防止 yum 將 Zookeeper 從 4.16.01 升級至更新版本。解決這個問題的方法是先執行 yum 降級 apigee-zookeeper，接著再更新 Zookeeper。

您可以使用下列指令檢查 Zookeeper 版本：

> rpm -qa |grep apigee-zookeeper

如果這項指令傳回 Zookeeper 版本：

apigee-zookeeper-3.4.5-1.0.905

就必須執行降級。

自動傳播資源設定

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

更新必要條件

升級 Apigee Edge 前，請先確認下列必要條件：

• 備份所有節點
  基於安全考量，建議在更新前執行所有節點的完整備份。請按照目前 Edge 版本的程序執行備份作業。
  
  這樣一來，如果更新至新版本後無法正常運作，您就能使用備用方案。如要進一步瞭解備份功能，請參閱「備份與還原」。
• 確認 Edge 正在執行
  請使用以下指令，確認 Edge 在更新程序期間已啟動並正在執行：
  
  > /<inst_root>/apigee/apigee-service/bin/apigee-all status

處理更新失敗

如果更新失敗，您可以嘗試修正問題，然後再次執行 update.sh。您可以多次執行更新，並從上次中斷處繼續更新。

如果失敗的情況需要將更新內容回復至先前的版本，請參閱「4.16.09 回復程序」瞭解詳情。

記錄更新資訊

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

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

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

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

必須升級至 Postgres 9.4

這個 Edge 版本包含升級至 Postgres 9.4。在升級過程中，所有 Postgres 資料都會遷移至 Postgres 9.4。

在更新程序期間，當 Postgres 節點因更新而關閉時，分析資料仍會寫入 Qpid 節點。Postgres 節點完成更新並恢復上線後，數據分析資料就會推送至 Postgres 節點。

如果您因任何原因而必須回復更新，就必須使用額外的 Postgres 待命節點。如果您必須回復更新，新的 Postgres 待命節點會在回復後成為主 Postgres 節點。因此，當您安裝新的 Postgres 待命節點時，該節點應符合 Edge 安裝需求中定義的 Postgres 伺服器所有硬體需求。

安裝新的 Postgres 待命節點

這個程序會在新節點上建立 Postgres 待命伺服器。請務必為「現有的」 Edge 版本 (4.16.01 或 4.16.05) 安裝新的 Postgres 待命伺服器，而非 4.16.09 版。

如要執行安裝作業，請使用安裝目前 Edge 版本時使用的設定檔。

如要建立新的 Postgres 待命節點，請按照下列步驟操作：

1. 在目前的 Postgres 主要執行個體上，編輯 /opt/apigee/customer/application/postgresql.properties 檔案，即可設定下列權杖。如果該檔案不存在，請建立檔案：
   
   conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust
   
   其中 existing_slave_ip 是目前 Postgres 備援伺服器的 IP 位址，而 new_slave_ip 則是新備援節點的 IP 位址。
2. 在 Postgres 主控台上重新啟動 apigee-postgresql：
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
3. 透過查看主要執行個體上的 /opt/apigee/apigee-postgresql/conf/pg_hba.conf 檔案，確認已新增待命節點。您應該會在該檔案中看到以下行：
   host replication apigee existing_slave_ip/32 trust
   host replication apigee new_slave_ip/32 trust
4. 安裝新的 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.05.sh 檔案下載至 /tmp/bootstrap_4.16.05.sh：
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
      
      注意：如果您要從 4.16.01 更新，請下載 Edge 的 bootstrap.sh 檔案。
   4. 安裝 Edge apigee-service 公用程式和依附元件：
      > sudo bash /tmp/bootstrap_4.16.05.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 節點

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

1. 確認 Postgres 是否正在執行：
   > /opt/apigee/apigee-service/bin/apigee-all status
   
   如果 Postgres 未執行，請啟動它：
   > /opt/apigee/apigee-service/bin/apigee-all start
2. 在新的待命節點上執行下列 cURL 指令，即可取得新待命節點的 UUID：
   > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self
   
   您應該會在輸出內容的結尾看到節點的 UUID，格式如下：
   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
3. 在新的待命節點上執行下列指令，即可停止新的待命節點：
   > /opt/apigee/apigee-service/bin/apigee-all stop
4. 在 Postgres 主要節點上，編輯 /opt/apigee/customer/application/postgresql.properties，從 conf_pg_hba_replication.connection 中移除新的待命節點：
   conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
5. 在 Postgres 主控台上重新啟動 apigee-postgresql：
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
6. 查看主要執行個體上的 /opt/apigee/apigee-postgresql/conf/pg_hba.conf 檔案，確認新備援節點已移除。該檔案中應該只會出現以下這行內容：
   主機複製作業 Apigee existing_slave_ip/32 信任
7. 在管理伺服器節點上執行下列 Edge 管理 API 呼叫，即可從 ZooKeeper 刪除待機節點的 UUID：
   > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

無停機更新

零停機更新 (或滾動式更新) 可讓您在不關閉 Edge 的情況下更新 Edge 安裝作業。

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

要想在無停機時間的情況下升級，關鍵在於從負載平衡器中逐一移除每個路由器。接著，在與路由器相同的機器中更新路由器和任何其他元件，然後將路由器新增回負載平衡器。

1. 請按照下方「機器更新順序」所述的正確順序更新機器。
2. 更新路由器時，請選取任一路由器並使其無法連線，如「啟用/停用伺服器 (訊息處理器/路由器) 可連線性」一文所述。
3. 在與路由器相同的機器上，更新所選路由器和所有其他 Edge 元件。所有 Edge 設定都會在同一個節點上顯示路由器和訊息處理器。
4. 讓路由器再次可供存取。
5. 針對其他路由器重複執行步驟 2 到 4。
6. 繼續為安裝環境中的其他機器更新。

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

• 在合併後的路由器和訊息處理器節點上：
  • 更新前：請執行下列操作：
    1. 將路由器設為無法連線。
    2. 讓訊息處理工具無法連線。
  • 更新後，請執行下列步驟：
    1. 讓訊息處理工具可供存取。
    2. 讓路由器可供存取。
• 在單一路由器節點上：
  • 更新前，請先將無法連線至路由器設為無法使用。
  • 更新完成後，請確保路由器可供存取。
• 在單一訊息處理器節點上：
  • 在更新前，請讓 Message Processor 無法連線。
  • 更新後，請連線至「訊息處理器」，

使用靜默設定檔

您必須將靜默設定檔傳遞至更新指令。無聲設定檔應與用於安裝 Edge 4.16.01 或 4.16.05 的檔案相同。

程序在具備外部網際網路連線的節點上更新至 4.16.09 的程序

請按照下列程序更新節點上的 Edge 元件：

1. 如果您目前使用 Postgres 主備用複寫功能，請按照上述「安裝新的 Postgres 備用節點」一節所述，安裝新的 Postgres 備用節點。
2. 如果有，請停用任何設定為在 Cassandra 上執行修復作業的 CRON 工作，直到更新完成為止。
3. 以 root 身分登入節點，安裝 Edge RPM。
   注意：雖然 RPM 安裝作業需要 Root 存取權，但您可以不必取得 Root 存取權，即可執行 Edge 設定。
4. 按照「安裝 Edge apigee-setup 公用程式」中的說明，停用 SELinux。
5. 將 Edge 4.16.09 的 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
6. 安裝 Edge 4.16.09 的 apigee-service 公用程式和依附元件：
   > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
   
   其中 uName:pWord 是您從 Apigee 收到的使用者名稱和密碼。如果您省略 pWord，系統會提示您輸入。
   
   根據預設，安裝程式會檢查您是否已安裝 Java 1.8。如果沒有，系統會自動為您安裝。使用 JAVA_FIX 選項指定處理 Java 安裝的方式。JAVA_FIX 的值如下：
   
   I = 安裝 OpenJDK 1.8 (預設)
   C = 繼續，但不安裝 Java
   Q = 結束。使用這個選項時，您必須自行安裝 Java。
7. 使用 apigee-service 更新 apigee-setup 公用程式：
   1. 如果您是透過升級 Edge 4.15.07.0x 版本來安裝 4.16.01，則必須安裝 apigee-setup 公用程式：
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      
      這個指令會在 <inst_dir>/apigee/apigee-setup/bin 中安裝 update.sh 公用程式。
      
      如果您已安裝 apigee-setup 公用程式，請更新它：
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
   2. 如果您直接安裝 4.16.01，也就是未從 4.15.07.0x 執行升級作業，則必須更新 apigee-setup 公用程式：
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      這項對 apigee-service 的更新會在 <inst_dir>/apigee/apigee-setup/bin 中安裝 update.sh 公用程式。
   3. 如果您直接安裝 4.16.05 版或藉由更新，就必須更新 apigee-setup 公用程式：
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      將安裝 update.sh 公用程式。
8. 視您目前的 Edge 版本而定，您必須在管理伺服器上安裝或更新 apigee-validate 公用程式。
   1. 如果您目前使用的是 Edge 4.16.05：請在管理伺服器中更新 apigee-validate 公用程式：
      > > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
   2. 如果您目前使用 Edge 4.16.01：請在管理伺服器上安裝 apigee-validate 公用程式：
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
      
      注意：如果您在安裝 4.16.01 時已在訊息處理器節點上安裝 apigee-validate 公用程式，則可以在該節點上使用下列指令進行更新：
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      
      不過，自 4.16.05 起，Apigee 建議您在管理伺服器上安裝及執行 apigee-validate 公用程式。
   3. 如果是從 4.16.01 版升級：請編輯傳遞至 apigee-validate 公用程式的設定檔。在 4.16.01 Edge 版本中，apigee-validate 使用的設定檔需要下列屬性：
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1
      
      在這個版本中，設定檔只需要 APIGEE_ADMINPW 屬性。您可以從檔案中移除其他兩個屬性。
9. 更新 apigee-provision 公用程式：
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
10. 按照下方「機器更新順序」所述的順序，在節點上執行更新公用程式：
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    
    設定檔唯一的要求是，設定檔必須可供「apigee」使用者存取或讀取。
    
    請使用「-c」選項指定要更新的元件。可能的元件清單包括：
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =所有 Edge 安裝元件 (E Edge UI： Management Server、Message Processor、 Router 路由器、QPID Server 設定檔) 的所有 Edge 安裝元件
    E Edge UI、Message Processor、 Router 路由器、QPID 伺服器上的所有邊緣安裝 API 全部元件
    ps = Postgresql
    edge = 所有邊緣安裝元件
    
    
    
11. 在管理伺服器上執行 Apigee-validate 公用程式，以測試更新，如測試安裝一節中所述。
12. 如果您安裝了新的 Postgres 待命節點，請按照上述「停用 Postgres 節點」一節所述，停用該節點。

如要日後回復更新，請按照「4.16.09 回復程序」一節所述程序操作。

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

如果您的 Edge 節點位於防火牆後面，或是以其他方式禁止透過網際網路存取 Apigee 存放區，您就可以從 Apigee 存放區的本機存放區 (或鏡像) 執行更新作業。

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

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

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

1. 如果您目前使用 Postgres 主備用複寫功能，請按照上述「安裝新的 Postgres 備用節點」一節所述，安裝新的 Postgres 備用節點。
2. 按照「安裝 Edge apigee-setup 公用程式」一文中的「建立本機 Apigee 存放區」說明，建立本機 4.16.09 存放區。
   注意：如果您已有 4.16.01 或 4.16.05 存放區，可以按照安裝 Edge apigee-setup 公用程式的「更新本機 Apigee 存放區」一節的說明，將 4.16.09 存放區新增至該存放區。
3. 如何從 .tar 檔案安裝 apigee-service：
   1. 在含有本機存放區的節點上，使用下列指令將本機存放區封裝至名為 /opt/apigee/data/apigee-mirror/apigee-4 .16.09.tar.gz 的單一.tar 檔案。
      
   2. 將 .tar 檔案複製到要更新 Edge 的節點。例如，將檔案複製到新節點的 /tmp 目錄。
   3. 在新節點上，將檔案解壓縮至 /tmp 目錄：
      > tar -xzf apigee-4.16.09.tar.gz
      
      這個指令會在包含 .tar 檔案的目錄中建立名為 repos 的新目錄。例如 /tmp/repos。
   4. 從 /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件：
      > sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      請注意，您必須在這個指令中加入 repos 目錄的路徑。
4. 如何使用 Nginx 網路伺服器安裝 apigee-service：
   1. 按照安裝 Edge apigee-setup 公用程式，按照「使用 Nginx 網路伺服器從存放區安裝」一節的說明，設定 Nginx 網路伺服器。
   2. 在遠端節點上，將 Edge bootstrap_4.16.09.sh 檔案下載至 /tmp/bootstrap_4.16.09.sh：
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
      
      其中 uName:pWord 是您在上述設定的存放區使用者名稱和密碼，而 remoteRepo 則是存放區節點的 IP 位址或 DNS 名稱。
   3. 在遠端節點上安裝 Edge apigee-service 公用程式和依附元件：
      > sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
      
      其中 uName:pWord 是 repo 使用者名稱和密碼。
5. 使用 apigee-service 更新 apigee-setup 公用程式：
   1. 如果您是透過升級 Edge 4.15.07.0x 版本來安裝 4.16.01，則必須安裝 apigee-setup 公用程式：
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      
      這個指令會在 <inst_dir>/apigee/apigee-setup/bin 中安裝 update.sh 公用程式。
      
      如果您已安裝 apigee-setup 公用程式，請更新它：
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
   2. 如果您直接安裝 4.16.01，也就是沒有從 4.15.07.0x 升級，則必須更新 apigee-setup 公用程式：
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      這項 apigee-service 更新會在 <inst_dir>/apigee/apigee-setup/bin 中安裝 update.sh 公用程式。
   3. 如果您直接或透過更新安裝 4.16.05，則必須更新 apigee-setup 公用程式：
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      這項 apigee-service 更新會在 <inst_dir>/apigee/apigee-setup/bin 中安裝 update.sh 公用程式。
6. 視您目前的 Edge 版本而定，您必須在管理伺服器上安裝或更新 apigee-validate 公用程式。
   1. 如果您目前使用的是 Edge 4.16.05：請在管理伺服器中更新 apigee-validate 公用程式：
      > > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
   2. 如果目前使用 Edge 4.16.01 (目前使用 Edge/間隔 4.16.01 版)：在管理伺服器上安裝 apigee/validate/apigee-validate 公用程式，請在管理伺服器安裝：
      > /opt/apigee/apigee-service/bin/apigee-service apigee-service apigee-validate-validate 安裝
      使用
      
      但請注意：
      
      
   3. 如果您要從 4.16.01 升級：請編輯傳遞至 apigee-validate 公用程式的設定檔。在 4.16.01 Edge 版本中，apigee-validate 使用的設定檔需要下列屬性：
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1
      
      在這個版本中，設定檔只需要 APIGEE_ADMINPW 屬性。您可以從檔案中移除其他兩個屬性。
7. 更新 apigee-provision 公用程式：
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
8. 請按照下方「機器更新順序」一節所述的順序，在節點上執行更新公用程式：
   > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
   
   設定檔唯一的要求是，設定檔必須可供「apigee」使用者存取或讀取。
   
   使用「-c」選項指定要更新的元件。可能的元件清單包括：
   ldap = OpenLDAP
   cs = Cassandra
   zk = Zookeeper
   qpid = qpidd
   ps = postgresql
   edge =除了 Edge UI 以外的所有 Edge 元件：管理伺服器、訊息處理器、路由器、QPID 伺服器、Postgres 伺服器
   ui = Edge UI
   all = 更新機器上的所有元件 (僅適用於 Edge aio 安裝設定檔或 API BaaS asa 安裝設定檔)
   e = ElasticSearch
   b = API BaaS 堆疊
   p = API BaaS 入口網站
   ebp = 同一個節點上的 ElasticSearch、API BaaS 堆疊和 API BaaS 入口網站
9. 如測試安裝程序所述，在管理伺服器上執行 apigee-validate 公用程式，即可測試更新。
10. 如果您安裝了新的 Postgres 待命節點，請按照上方停用 Postgres 節點一節的說明停用該節點。

如要日後回復更新，請按照「4.16.09 回復程序」一節所述程序操作。

機器更新順序

更新 Edge 安裝中的機器順序非常重要。更新時最重要的考量事項如下：

• 您必須先更新 所有 Cassandra 和 ZooKeeper 節點，再更新任何其他節點。
• 對於任何具有多個 Edge 元件 (管理伺服器、訊息處理器、路由器、QPID 伺服器，但不包括 Postgres 伺服器) 的機器，請使用「-c edge」選項同時更新所有元件。
• 如果步驟指定應在多部機器上執行，請按照指定的機器順序執行。
• 你不需要另外採取任何步驟來更新營利功能。您指定「-cedge」選項時，系統會更新此值。

針對 1 主機獨立安裝

1. 如果您要從 4.16.01 更新，請降級 Zookeeper：
   > yum downgrade apigee-zookeeper
2. 更新 Cassandra 和 ZooKeeper：
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. 更新 qpidd：
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
4. 更新 LDAP：
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
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
6. 更新 postgresql：
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
7. 更新 Postgres 資料庫：
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
8. 更新其他 Edge 元件：
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
9. 更新 Edge UI：
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

2 個主機的獨立安裝

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

1. 如果是從 4.16.01 更新，請在機器 1 上將 Zookeeper 降級：
   > yum 降級 apigee-zookeeper
2. 在機器 1 上更新 Cassandra 和 ZooKeeper：
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. 在機器 2 上更新 qpidd：
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
4. 更新機器 1 上的 LDAP：
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
5. 更新機器 1 中的 Edge 元件：
   > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
6. 更新機器 1 上的 UI：
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
7. 更新機器 2 上的 postgresql：
   1. 停止 Postgres Server、Qpid 伺服器和 postgresql：
      > /opt/apigee/service/bin/apigee-service Edge-postgres-server stop
      > /opt/apigee-service/bin/apigee-service Edge-qpid-server stop
      > /opt/apigee-service/bin/apigee-service stop-postg
   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 和機器 1 中的 Edge 元件：
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
8. 更新機器 2 中的 Edge 元件：
   > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile

針對 5 主機叢集安裝

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

1. 確認您已按照「安裝新的 Postgres 待命節點」一文所述安裝新的 Postgres 待命節點。
2. 如果是從 4.16.01 更新的版本，請在機器 1、2 和 3 上將 Zookeeper 降級
   >yum 降級 apigee-zookeeper
3. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. 在機器 4 和 5 上更新 qpidd：
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
5. 更新機器 1 上的 LDAP：
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. 更新機器 1、2、3 中的 Edge 元件：
   > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
7. 更新機器 1 上的 UI：
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
8. 更新機器 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 apige-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/service/bin/apigee-service Edge-postgres-server start
      > /opt/apigee-service/bin/apigee-service Edge-qpid-server start
   8. 在機器 5 上執行下列指令，將 Postgres 設為待命節點：
      > 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/service/bin/apigee-service apigee-postgresql postgres-check-master
      
      驗證確認其為主要執行個體。
      
      在機器 5 的待機節點上：
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
      
      確認系統顯示為待機節點。
9. 在機器 4 和 5 上更新 Edge 元件：
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. 請務必使用「停用 Postgres 節點」一節中的上述程序，停用新的待命節點。

針對 9 主機叢集安裝

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

1. 確認您已安裝新的 Postgres 待命節點 (如上方「安裝新的 Postgres 待命節點」一節所述)。
2. 如果您要從 4.16.01 更新，請在機器 1、2 和 3 上降級 Zookeeper：
   > yum downgrade apigee-zookeeper
3. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. 在機器 6 和 7 中更新 qpidd：
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
5. 更新機器 1 上的 LDAP：
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. 依序在機器 6、7、1、4 和 5 上更新 Edge 元件：
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. 更新機器 1 上的 UI：
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
8. 更新機器 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 設為待命節點：
       > cd /opt/apigee/data/apigee-postgresql/pgdata
       > rm -rf *
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f config-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
       
       確認該節點是待命節點。
9. 更新機器 8 和 9 中的 Edge 元件：
   > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
10. 請務必使用「停用 Postgres 節點」一節中的上述程序，停用新的待命節點。

如為 13 主機叢集安裝

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

1. 確認您已按照「安裝新的 Postgres 待命節點」一文所述安裝新的 Postgres 待命節點。
2. 如果您要從 4.16.01 更新，請在機器 1、2 和 3 上降級 Zookeeper：
   > yum downgrade apigee-zookeeper
3. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. 在機器 12 和 13 上更新 qpidd：
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
5. 在機器 4 和 5 上更新 LDAP：
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. 依序更新機器 12、13、6、7、10 和 11 上的 Edge 元件：
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. 更新機器 6 和 7 中的 UI：
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
8. 更新機器 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-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. 在機器 9 上執行下列指令，將 Postgres 設為待命節點：
       > 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
       
       確認該節點是待命節點。
9. 更新機器 8 和 9 上的 Edge 元件：
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. 請務必使用「停用 Postgres 節點」一節中的程序，停用新的待命節點。

適用於 12 主機叢集式安裝

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

1. 確認您已安裝新的 Postgres 待命節點 (如上方「安裝新的 Postgres 待命節點」一節所述)。
2. 更新 Cassandra 和 ZooKeeper：
   1. 如果您要從 4.16.01 進行更新，請在資料中心 1 的機器 1、2 和 3 上降級 Zookeeper：
      > yum downgrade apigee-zookeeper
   2. 在資料中心 1 中的機器 1、2 和 3：
      > /opt/apigee/setup/bin/update.sh -c cs,zk -f configFile
   3. 如果您要從 4.16.01 更新，請在資料中心 2 的機器 7、8 和 9 上降級 Zookeeper：
      > yum downgrade apigee-zookeeper
   4. 機器 7、8 和 9，位於資料中心 2
      > /opt/apigee/setup/bin/update.sh -c cs,zk -f configFile
3. 更新 qpidd：
   1. 資料中心 1 中的機器 4、5
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
   2. 資料中心 2 中的機器 10、11
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
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
5. 更新 Edge 元件：
   1. 資料中心 1 中的機器 4、5、1、2、3
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
   2. Data Center 2 中的機器 10、11、7、8、9
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
6. 更新 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
7. 更新資料中心 1 中的機器 6 和資料中心 2 中的機器 12：
   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-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 設為待命節點：
       > 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
       
       確認系統顯示為待命節點。
8. 更新機器 6 和 12 的 Edge 元件：
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
9. 請務必使用「停用 Postgres 節點」一節中的上述程序，停用新的待命節點。

針對 7 個主機 API BaaS 安裝

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

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

適用於 10 個主機的 API BaaS 安裝程序

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

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

非標準安裝

如果您採用非標準安裝方式，請依下列順序更新 Edge 元件：

1. ZooKeeper
2. Cassandra
3. qpidd
4. LDAP
5. Edge，即所有節點上的「-c edge」設定檔，依序為：含有 Qpid 伺服器但不含 Postgres 伺服器的節點、管理伺服器、訊息處理器和路由器。
   注意：如果節點同時安裝了 Qpid 伺服器和 Postgres 伺服器，請在步驟 8 中執行「-c edge」設定檔步驟。
6. Edge UI
7. Postgres 主控台上的 PostgreSQL，包括升級。
8. 在 Postgres 備援主機上執行 postgresql。
9. Edge 代表所有合併的 Qpid 與 Postgres 節點上的「-c 邊緣」設定檔，或任何獨立 Postgres 節點上的「-c 邊緣」設定檔。