將 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 後，任何人都可以設定。

哪些元件必須更新

您必須更新所有 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 待命節點時，該節點應位於符合 Postgres 伺服器所有硬體需求的節點上，詳情請參閱 Edge 安裝規定。

  在 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. 升級主要主機「

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

   」中的 Postgres
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 Management 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 會要求您停用基本驗證，並使用 IDP (例如 SAML 或 LDAP)。

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

更新 Edge UI

如要更新 Edge UI 元件，請考慮要升級的 Private Cloud 適用的 Edge 版本：

• 從 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 公用程式的人員無法存取該目錄，系統便會以名為 update_username.log 的檔案將記錄寫入 /tmp 目錄。

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

零停機時間更新

零停機時間更新或滾動式更新可讓您在不降低 Edge 的情況下更新 Edge 安裝。

只有在設定 5 節點以上設定的情況下，零停機時間更新才能使用。

升級零停機的關鍵就是從負載平衡器一次移除一個路由器。接著，您要更新路由器和同一部機器上的任何其他元件，然後再將路由器加回負載平衡器。

1. 按照機器更新順序的說明，按照正確的安裝順序更新機器。
2. 需要更新路由器時，請選取任一個路由器，並使其無法連線至該路由器，詳情請參閱啟用/停用伺服器 (訊息處理器/路由器) 可連性一文。
3. 在與路由器相同的機器上，更新所選路由器和所有其他 Edge 元件。 所有邊緣設定都會在同一節點上顯示路由器和訊息處理器。
4. 重新連線至路由器。
5. 針對其餘的路由器重複步驟 2 到步驟 4。
6. 繼續更新安裝檔中剩餘的任何機器。

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

• 在合併的路由器和訊息處理器節點上：
  • 更新前，請執行下列步驟：
    1. 無法連線至路由器。
    2. 將無法連上「訊息處理器」。
  • 更新後，請執行下列步驟：
    1. 將訊息處理器設為可連線。
    2. 確定路由器可連線。
• 在單一路由器節點上：
  • 更新前，請將路由器無法連上。
  • 更新完成後，請將路由器恢復連線。
• 針對單一訊息處理器節點：
  • 更新前，請讓訊息處理者無法存取。
  • 更新完成後，請讓訊息處理器可連線。

使用無訊息設定檔

您必須將無訊息設定檔傳送至更新指令。靜音設定檔應該與用來安裝 Edge 4.19.06 或 4.50.00 的檔案相同。

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

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

1. 如有顯示，請停用所有設為在 Cassandra 上執行修復作業的 cron 工作，直到更新完成為止。
2. 以根層級登入節點即可安裝 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 UI 以外的所有邊緣元件：管理伺服器、訊息處理器、路由器、QPID 伺服器、Postgres 伺服器
      • ldap：OpenLDAP
      • ps：postgresql
      • qpid：qpidd
      • sso：Apigee SSO (如果已安裝單一登入)
      • ue：新 Edge UI
      • ui：傳統 Edge UI
      • zk：動物園
    • 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。
• 在含有本機存放區的節點中安裝網路伺服器，方便其他節點存取。 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

      請注意，您會在這個指令中加入存放區目錄的路徑。

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 UI 除外)：管理伺服器、訊息處理器、路由器、QPID 伺服器、Postgres 伺服器
     • ldap：OpenLDAP
     • ps：postgresql
     • qpid：qpidd
     • sso：Apigee SSO (如果已安裝單一登入)
     • ue 新 Edge UI
     • ui：傳統 Edge UI
     • zk：動物園
   • 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 元件 (如果尚未重新啟動)：

   /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 節點獨立安裝：

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

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 上的使用者介面：

   /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 節點安裝：

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

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，請在適當的機器上更新 ue 元件 (不得為機器 1)：

     /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，然後在適當的機器上重新啟動 edge-management-ui 元件 (不得為機器 1)：

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

9 節點叢集升級作業

更新下列元件以進行 9 個節點的叢集安裝作業：

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

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，然後在適當的機器上重新啟動 edge-management-ui 元件 (不得為機器 1)：

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

13 個節點叢集升級作業

更新下列元件以進行 13 個節點的叢集安裝：

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

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 個節點的叢集安裝：

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

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. 資料中心 4、5 在資料中心 1
      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. 資料中心的機器 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

      /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、5、6、1、2、3 中的機器 1

      /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. 邊緣，代表所有節點上的「-c 邊緣」設定檔，順序為：包含 Qpid 伺服器、Edge Postgres 伺服器、管理伺服器、訊息處理器和路由器的節點。
6. Edge UI (傳統版或新版)
7. apigee-adminapi
8. Apigee 單一登入 (SSO)

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