將 Apigee Edge 4.19.06 或 4.50.00 更新至 4.51.00

本節說明如何從 Apigee Edge 4.19.06 或 4.50.00 升級至 4.51.00。

誰可以執行更新

執行更新的使用者必須是最初安裝 Edge 的使用者，或是以系統管理員身分執行的使用者。

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

您必須更新哪些元件

您必須更新所有 Edge 元件。Edge 不支援包含多個版本元件的設定。

自動傳播資源設定

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

必須升級至 Postgres 10.17

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

大多數 Edge 實際運作系統都會使用兩個 Postgres 節點，並將其設定為主/備用複寫。在更新程序期間，當 Postgres 節點因更新而關閉時，分析資料仍會寫入 Qpid 節點。更新 Postgres 節點並恢復連線後，系統就會將數據分析資料推送至 Postgres 節點。

執行 Postgres 更新的方式取決於您為 Postgres 節點設定資料儲存空間的方式：

• 如果您使用本機資料儲存空間來儲存 Postgres 節點，則必須在升級期間安裝新的 Postgres 待命節點。升級完成後，您可以停用新的 Postgres 待命節點。

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

  在 Edge 的 1 個節點和 2 個節點設定中，用於製作原型和測試的拓樸圖只有一個 Postgres 節點。您可以直接更新這些 Postgres 節點，而無需建立新的 Postgres 節點。

• 如果您使用網路儲存空間來儲存 Postgres 節點，則不必按照 Apigee 建議安裝新的 Postgres 節點。在下列程序中，您可以略過指定安裝新 Postgres 待命節點，並稍後將其停用的步驟。

  開始更新程序前，請為 Postgres 使用的資料儲存庫拍攝網路快照。接著，如果更新期間發生任何錯誤，且您必須執行回溯作業，則可以從該快照還原 Postgres 節點。

安裝新的 Postgres 待命節點

這個程序會在新節點上建立 Postgres 待命伺服器。請確認您為現有 Edge 版本 (4.19.06 或 4.50.00) 安裝新的 Postgres 備援伺服器，而非 4.51.00 版。

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

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

1. 在目前的 Postgres 主機上，編輯 /opt/apigee/customer/application/postgresql.properties 檔案，設定下列符記。如果該檔案不存在，請建立該檔案：

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

   其中 existing_standby_ip 是目前 Postgres 備援伺服器的 IP 位址，而 new_standby_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_standby_ip/32 trust
   host replication apigee new_standby_ip/32 trust

4. 安裝新的 Postgres 待命伺服器：
   1. 編輯用於安裝目前 Edge 版本的設定檔，指定下列項目：

      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102

   2. 按照「安裝 Edge apigee-setup 公用程式」中的說明停用 SELinux。
   3. 視您要從哪個 Edge 版本升級而定，請執行下列任一操作：
      • 如果您要從 Edge 4.19.06 升級，請將 Edge bootstrap_4.19.06.sh 檔案下載到 /tmp/bootstrap_4.19.06.sh ：

        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

        接下來，請安裝 Edge apigee-service 公用程式和依附元件：

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      • 如果您要從 Edge 4.50.00 升級，請將 Edge bootstrap_4.50.00.sh 檔案下載至 /tmp/bootstrap_4.50.00.sh ：

        curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

        接下來，請安裝 Edge apigee-service 公用程式和依附元件：

        sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

   4. 使用 apigee-service 安裝 apigee-setup 公用程式：

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   5. 安裝 Postgres：

      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile

   6. 在新的待命節點上執行下列指令：

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      確認系統顯示為待機模式。

執行 Postgres 就地升級

如要執行就地升級至 Postgres 10.17，請執行下列步驟：

1. 在主機主機上升級 postgres

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

2. 在主機上執行設定指令：

   apigee-service apigee-postgresql setup -f /opt/silent.conf

3. 在主要主機上執行設定指令：

   apigee-service apigee-postgresql configure

4. 重新啟動主機：

   apigee-service apigee-postgresql restart

5. 將其設為主機：

   apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

6. 確認主機已啟動：

   apigee-service apigee-postgresql wait_for_ready

7. 停止待命：

   apigee-service apigee-postgresql stop

8. 升級待機模式。

   注意：如果這個步驟發生錯誤/失敗，可以忽略。update.sh 會嘗試以不正確的設定啟動待命伺服器。只要 Postgres 安裝升級至 10.17，即可忽略此錯誤。

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

9. 確認已停止待機：

   apigee-service apigee-postgresql stop

10. 移除舊的待命設定：

    rm -rf /opt/apigee/data/apigee-postgresql/

11. 在待命伺服器上設定複寫：

    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

完成這項程序後，待命主機就會成功啟動。

停用 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_standby_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 檔案，確認新備援節點是否已移除。您應該只會在該檔案中看到下列一行：

   host replication apigee existing_standby_ip/32 trust

7. 在管理伺服器節點上發出下列 Edge 管理 API 呼叫，即可從 ZooKeeper 刪除待命節點的 UUID：

   curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

更新必要條件

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

• 備份所有節點
  為了安全起見，建議您在更新前完整備份所有節點。請按照目前 Edge 版本的程序執行備份作業。

  這樣一來，如果更新至新版本後無法正常運作，您就能使用備用方案。如要進一步瞭解備份功能，請參閱「備份與還原」。

• 確認 Edge 是否正在執行
  請使用下列指令，確認 Edge 在更新程序期間是否已啟用並執行：

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

新的 Edge UI

本節列出 Edge UI 的注意事項。詳情請參閱「適用於私人雲端的新 Edge UI」。

安裝 Edge UI

完成初始安裝後，Apigee 建議您安裝 Edge UI，這是專為 Apigee Edge for Private Cloud 的開發人員和管理員提供的強化版使用者介面。

請注意，Edge UI 要求您停用基本驗證，並使用 SAML 或 LDAP 等 IDP。

詳情請參閱「安裝新的 Edge UI」。

更新 Edge UI

如要更新 Edge UI 元件，請考量您要從哪個版本的 Edge for Private Cloud 升級：

• 從 4.19.06 或 4.50.00 升級至 4.51.00 (已安裝新的 Edge UI)：請針對 edge-management-ui 元件使用本節中的升級操作說明。

更新為 Apigee mTLS

如要更新 Apigee mTLS，請按照下列步驟操作：

• 解除安裝 Apigee mTLS。
• 重新安裝 Apigee mTLS。

復原更新

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

如果失敗問題需要將更新內容還原為先前版本，請參閱「還原 4.51.00 版本」一文，瞭解詳細操作說明。

記錄更新資訊

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

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

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

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

零停機更新

零停機更新或滾動式更新可讓您更新 Edge 安裝作業，而不會導致 Edge 停機。

只有 5 個節點以上的設定才能進行零停機更新。

要想在無停機時間的情況下升級，關鍵在於從負載平衡器中逐一移除每個路由器。接著，請更新路由器和路由器所在電腦上的任何其他元件，然後將路由器重新加入負載平衡器。

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

請在更新前後注意下列事項：

• 在路由器和訊息處理器節點上：
  • 更新前：請執行下列操作：
    1. 讓路由器無法連線。
    2. 讓訊息處理工具無法連線。
  • 更新後：請執行下列操作：
    1. 讓訊息處理工具可供存取。
    2. 讓路由器可供存取。
• 在單一路由器節點上：
  • 更新前，請讓 Router 無法連線。
  • 更新完成後，讓路由器可供存取。
• 在單一 Message Processor 節點上：
  • 更新前，請讓 Message Processor 無法存取。
  • 更新完成後，讓 Message Processor 可供存取。

使用靜默設定檔

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

在有外部網際網路連線的節點上更新至 4.51.00

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

1. 如果有，請停用任何已設定為在 Cassandra 上執行修復作業的 cron 工作，直到更新完成為止。
2. 以 root 身分登入節點，安裝 Edge RPM。
3. 安裝 yum-utils 和 yum-plugin-priorities：

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. 按照「安裝 Edge apigee-setup 公用程式」中的說明，停用 SELinux。
5. 如果您是在 Oracle 7.x 上安裝，請執行下列指令：

   sudo yum-config-manager --enable ol7_optional_latest

6. 如果您是在 AWS 上安裝，請執行下列 yum-configure-manager 指令：

   yum update rh-amazon-rhui-client.noarch
   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

7. 將 Edge 4.51.00 bootstrap_4.51.00.sh 檔案下載至 /tmp/bootstrap_4.51.00.sh：

   curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

8. 執行下列指令，安裝 Edge 4.51.00 apigee-service 公用程式和依附元件：

   sudo bash /tmp/bootstrap_4.51.00.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。
9. 使用 apigee-service 更新 apigee-setup 公用程式，如以下範例所示：

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

10. 請更新管理伺服器上的 apigee-validate 公用程式，如以下範例所示：

    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

11. 請更新管理伺服器上的 apigee-provision 公用程式，如以下範例所示：

    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

12. 執行下列指令，即可在節點上執行 update 公用程式：

    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    請按照「機器更新順序」一節所述的順序執行這項操作。

    在此情況下：

    • component 是 Edge 元件要更新的項目。可能的值包括：
      • cs：Cassandra
      • edge：所有 Edge 元件 (Edge UI 除外)：管理伺服器、訊息處理器、路由器、QPID 伺服器、Postgres 伺服器
      • ldap：OpenLDAP
      • ps：postgresql
      • qpid：qpidd
      • sso：Apigee 單一登入 (如果您安裝了 SSO)
      • ue：新的 Edge UI
      • ui：Edge 傳統版 UI
      • zk：Zookeeper
    • configFile 與您在 4.19.06 或 4.50.00 安裝期間用來定義 Edge 元件的設定檔相同。

    您可以將 component 設為「all」，讓 update.sh 對所有元件執行，但前提是您必須有 Edge 一體式 (AIO) 安裝設定檔。例如：

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config

13. 如果尚未在執行 Edge UI 的所有節點上重新啟動，請按照下列步驟操作：

    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

14. 如測試安裝程序所述，請在管理伺服器上執行 apigee-validate 公用程式，以測試更新。

如果您之後決定要回復更新，請按照「回復 4.51.00」一文所述的程序操作。

從本機存放區更新至 4.51.00

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

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

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

如要從本機 4.51.00 存放區更新：

1. 按照「安裝 Edge apigee-setup 公用程式」一文中的「建立本機 Apigee 存放區」說明，建立本機 4.51.00 存放區。
2. 如何從 .tar 檔案安裝 apigee-service：
   1. 在含有本機存放區的節點上，使用下列指令將本機存放區封裝至名為 /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz 的單一 .tar 檔案：

      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

   2. 將 .tar 檔案複製到要更新 Edge 的節點。例如，將其複製到新節點的 /tmp 目錄中。
   3. 在新節點上，將檔案解壓縮至 /tmp 目錄：

      tar -xzf apigee-4.51.00.tar.gz

      這個指令會在包含 .tar 檔案的目錄中建立名為 repos 的新目錄。例如 /tmp/repos。

   4. 從 /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件：

      sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      請注意，您必須在這個指令中加入 repos 目錄的路徑。

3. 如何使用 NGINX 網路伺服器安裝 apigee-service：
   1. 依照「安裝 Edge apigee-setup 公用程式」一文的「使用 NGINX 網路伺服器從存放區安裝」所述，設定 NGINX 網路伺服器。
   2. 在遠端節點上，將 Edge bootstrap_4.51.00.sh 檔案下載至 /tmp/bootstrap_4.51.00.sh：

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

      其中 uName:pWord 是您先前為存放區設定的使用者名稱和密碼，而 remoteRepo 則是存放區節點的 IP 位址或 DNS 名稱。

   3. 在遠端節點上安裝 Edge apigee-setup 公用程式和依附元件：

      sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      其中 uName:pWord 是存放區使用者名稱和密碼。

4. 使用 apigee-service 更新 apigee-setup 公用程式，如以下範例所示：

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 

5. 請更新管理伺服器上的 apigee-validate 公用程式，如以下範例所示：

   /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

6. 請更新管理伺服器上的 apigee-provision 公用程式，如以下範例所示：

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

7. 依照「機器更新順序」一節的說明，在節點上依序執行 update 公用程式：

   /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

   其中：

   • component 是 Edge 元件要更新的項目。您通常會更新下列元件：
     • cs：Cassandra
     • edge：所有 Edge 元件 (Edge UI 除外)：管理伺服器、訊息處理器、路由器、QPID 伺服器、Postgres 伺服器
     • ldap：OpenLDAP
     • ps：postgresql
     • qpid：qpidd
     • sso：Apigee 單一登入 (如果您安裝了 SSO)
     • ue 新的 Edge UI
     • ui：Edge 傳統版 UI
     • zk：Zookeeper
   • configFile 與您在 4.19.06 或 4.50.00 安裝期間用來定義 Edge 元件的設定檔相同。

   您可以將 component 設為「all」，讓 update.sh 對所有元件執行，但前提是您必須有 Edge 一體式 (AIO) 安裝設定檔。例如：

   /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config

8. 如果尚未重新啟動，請在執行 UI 的所有節點上重新啟動 UI 元件：

   /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

9. 如測試安裝程序所述，請在管理伺服器上執行 apigee-validate 公用程式，以測試更新。

如果您之後決定要回復更新，請按照「回復 4.51.00」一文所述的程序操作。

機器更新順序

在 Edge 安裝中更新機器的順序非常重要：

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

1 個節點的獨立升級

如何將 1 個節點的獨立設定升級至 4.51.00：

1. 更新所有元件：

   /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

2. (如果您已安裝 apigee-adminapi) 已更新 apigee-adminapi 公用程式：

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

2 個節點的獨立升級

針對 2 個節點的獨立安裝作業更新下列元件：

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

1. 更新機器 1 上的 Cassandra 和 ZooKeeper：

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. 在機器 2 上更新 Qpid 和 Postgres：

   /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile

3. 更新機器 1 上的 LDAP：

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

4. 在機器 2 和 1 上更新 Edge 元件：

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5. 更新機器 1 上的 UI：

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

6. (如果您已安裝 apigee-adminapi) 在機器 1 上更新 apigee-adminapi 公用程式：

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

7. (如果您已安裝 Apigee SSO) 更新機器 1 上的 Apigee SSO：

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   其中 sso_config_file 是您在安裝 SSO 時建立的設定檔。

8. 在機器 1 上重新啟動 Edge UI 元件：

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

5 節點升級

針對 5 節點安裝作業更新下列元件：

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

1. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. 在機器 4 上更新 Qpid 和 Postgres：

   /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

3. 在機器 5 上更新 Qpid 和 Postgres：

   /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

4. 更新機器 1 上的 LDAP：

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

5. 在機器 4、5、1、2、3 上更新 Edge 元件：

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. 更新 Edge UI：
   • 傳統 UI：如果您使用的是傳統 UI，請更新機器 1 上的 ui 元件，如以下範例所示：

     /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

   • 新 Edge UI：如果您已安裝新 Edge UI，請在適當的機器 (可能不是機器 1) 上更新 ue 元件：

     /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf

7. (如果您已安裝 apigee-adminapi) 在機器 1 上更新 apigee-adminapi 公用程式：

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (如果您已安裝 Apigee SSO) 更新機器 1 上的 Apigee SSO：

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   其中 sso_config_file 是您在安裝 SSO 時建立的設定檔。

9. 重新啟動 UI 元件：
   • 傳統 UI：如果您使用的是傳統 UI，請在機器 1 上重新啟動 edge-ui 元件，如以下範例所示：

     /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

   • 新 Edge UI：如果您已安裝新 Edge UI，請在適當的機器 (可能不是機器 1) 上重新啟動 edge-management-ui 元件：

     /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

9 節點叢集升級

針對 9 節點的叢集安裝作業更新下列元件：

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

1. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. 在機器 6 和 7 上更新 Qpid：

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. 更新機器 8 上的 Postgres：

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. 更新機器 9 上的 Postgres：

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. 更新機器 1 上的 LDAP：

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

6. 依序更新機器 6、7、8、9、1、4 和 5 的 Edge 元件：

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. 在機器 1 上更新新版 UI (ue) 或傳統版 UI (ui)：

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. (如果您已安裝 apigee-adminapi) 更新機器 1 上的 apigee-adminapi 公用程式：

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (如果您已安裝 Apigee SSO) 更新機器 1 上的 Apigee SSO：

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   其中 sso_config_file 是您在安裝 SSO 時建立的設定檔。

10. 重新啟動 UI 元件：
    • 傳統 UI：如果您使用的是傳統 UI，請在機器 1 上重新啟動 edge-ui 元件，如以下範例所示：

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • 新 Edge UI：如果您已安裝新 Edge UI，請在適當的機器 (可能不是機器 1) 上重新啟動 edge-management-ui 元件：

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

13 節點叢集升級

針對 13 個節點的叢集安裝作業，更新下列元件：

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

1. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. 在機器 12 和 13 上更新 Qpid：

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. 更新機器 8 上的 Postgres：

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. 更新機器 9 上的 Postgres：

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. 在機器 4 和 5 上更新 LDAP：

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

6. 依序更新機器 12、13、8、9、6、7、10 和 11 的 Edge 元件：

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. 在機器 6 和 7 上更新新版 UI (ue) 或傳統版 UI (ui)：

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. (如果您已安裝 apigee-adminapi) 在機器 6 和 7 上更新 apigee-adminapi 公用程式：

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (如果您已安裝 Apigee SSO) 在機器 6 和 7 上更新 Apigee SSO：

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   其中 sso_config_file 是您在安裝 SSO 時建立的設定檔。

10. 重新啟動 UI 元件：
    • 傳統 UI：如果您使用的是傳統 UI，請在機器 6 和 7 上重新啟動 edge-ui 元件，如以下範例所示：

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • 新 Edge UI：如果您已安裝新 Edge UI，請在機器 6 和 7 上重新啟動 edge-management-ui 元件：

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

12 節點叢集升級

針對 12 節點的叢集安裝作業更新下列元件：

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

1. 更新 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

2. 更新 qpidd：
   1. 資料中心 1 中的機器 4、5
      1. 在機器 4 上更新 qpidd：

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. 更新機器 5 上的 qpidd：

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

   2. 資料中心 2 中的機器 10、11
      1. 在機器 10 上更新 qpidd ：

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. 在機器 11 上更新 qpidd ：

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. 更新 Postgres：
   1. 資料中心 1 中的機器 6

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   2. 資料中心 2 中的機器 12

      /opt/apigee/apigee-setup/bin/update.sh -c ps -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、6、1、2、3

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   2. 資料中心 2 中的機器 10、11、12、7、8、9

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. 更新新版 UI (ue) 或傳統版 UI (ui)：
   1. 資料中心 1 中的機器 1：

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   2. 資料中心 2 中的機器 7：

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

7. (如果您已安裝 apigee-adminapi) 更新 apigee-adminapi 公用程式：
   1. 資料中心 1 中的機器 1：

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   2. 資料中心 2 中的機器 7：

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (如果您安裝了 Apigee SSO) 更新 Apigee SSO：
   1. 資料中心 1 中的機器 1：

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   2. 資料中心 2 中的機器 7：

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   其中 sso_config_file 是您在安裝 SSO 時建立的設定檔。

9. 在機器 1 和 7 上重新啟動新的 Edge UI (edge-management-ui) 或傳統 Edge UI (edge-ui) 元件：

   /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

非標準設定

如果您使用非標準設定，請依照下列順序更新 Edge 元件：

1. ZooKeeper
2. Cassandra
3. qpidd、ps
4. LDAP
5. Edge，表示所有節點上的「-c edge」設定檔，依序為：含有 Qpid 伺服器的節點、Edge Postgres 伺服器、管理伺服器、訊息處理器和路由器。
6. Edge UI (傳統版或新版)
7. apigee-adminapi
8. Apigee SSO

更新完成後，請務必在執行 Edge UI 的所有機器上重新啟動 Edge UI 元件。