將 Apigee Edge 4.52.02 更新至 4.53.00

Apigee 支援直接將 Edge for Private Cloud 從 4.52.02 版升級至 4.53.00 版。本頁面說明如何執行這類升級作業。

如需相容升級路徑的總覽，請參閱 Edge for Private Cloud 版本的升級相容性矩陣。

誰可以執行更新

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

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

您必須更新哪些元件

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

更新必要條件

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

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

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

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

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

• 確認 Cassandra 必要條件
  如果您先前已從較舊的 Edge for Private Cloud 版本升級至 4.52.02 版，現在又打算升級至 4.53.00 版，請務必完成 Cassandra 的必要升級後步驟。這些步驟已在 4.52.02 版升級說明文件的「升級後步驟」中列出。如果您不確定先前升級時是否已完成這些步驟，請先再次完成這些步驟，再繼續升級至 4.53.00 版。
• Python 相關規定
  請務必先在所有節點 (包括 Cassandra 節點) 上安裝 Python 3，再嘗試升級。

自動傳播資源設定

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

必須升級至 Cassandra 4.0.13

Apigee Edge for Private Cloud 4.53.00 包含 Cassandra 升級至 4.0.13 版本。

升級和復原

• 從 Cassandra 3.11.X 升級至 Cassandra 4.0.X 的過程相當順暢。與 Private Cloud 4.53.00 版的 Edge 一併發布的 Cassandra 4.0.X 版，與 Private Cloud 4.52.02 版的執行階段和管理元件相容。
• 無法直接將 Cassandra 4.0.X 還原至 3.11.X。使用副本或備份回溯的程序相當複雜，可能會導致服務中斷和/或資料遺失。建議您排解問題並升級至 Cassandra 4.0.X，而非回復舊版本。
• 請務必先熟悉回溯程序，再嘗試升級。在升級期間，請務必考量回溯的細微差異，確保可使用適當的回溯路徑。

單一資料中心

在單一資料中心內，從 Cassandra 3.11.X 升級至 4.0.X 的過程是無縫的，但回滾作業相當複雜，可能會導致服務中斷和資料遺失。對於實際工作負載，強烈建議您在啟動升級程序前，新增一個資料中心，並在該資料中心中至少提供一個 Cassandra 節點。這樣一來，您就能在不會造成資料遺失或 API 流量中斷的情況下，回復 Cassandra。升級完成或達到第 2 個檢查點後，您就可以停用這個額外資料中心。

如果無法新增新資料中心，但仍需要回溯功能，則必須備份資料才能還原 Cassandra 3.11.X。不過，這種方法可能會導致服務中斷和資料遺失。

多個資料中心

使用 Edge for Private Cloud 4.52.02 管理多個資料中心，可在升級至 Edge for Private Cloud 4.53.00 時，更靈活地進行回溯。

• 回復作業取決於至少有一個資料中心執行舊版 Cassandra (3.11.X)。
• 如果整個 Cassandra 叢集已升級至 4.0.X，則不得回溯至 Cassandra 3.11.X。您必須繼續使用較新的 Cassandra 版本，搭配 Private Cloud 4.53.00 或 4.52.02 的其他元件。

建議的升級方法

1. 一次升級一個 Cassandra 資料中心：請先在單一資料中心內個別升級 Cassandra 節點。請先完成一個資料中心內所有 Cassandra 節點的升級作業，再繼續進行下一個資料中心。
2. 暫停並驗證：升級一個資料中心後，請暫停，確保私有雲叢集 (尤其是已升級的資料中心) 運作正常。
3. 提醒：只有在至少有一個資料中心仍執行舊版 Cassandra 時，您才能回復為舊版。
4. 時間敏感：雖然您可以暫停一段時間 (建議為幾小時) 來驗證功能，但無法無限期處於混合版本狀態。這是因為非均質 Cassandra 叢集 (節點使用不同版本) 有運作限制。
5. 徹底測試：Apigee 強烈建議您在升級下一個資料中心之前，先進行全面的效能和功能測試。所有資料中心升級完畢後，就無法回溯至先前的版本。

以兩個檢查點的程序進行回復

1. 檢查點 1：初始狀態，所有元件皆為 4.52.02 版。只要至少有一個 Cassandra 資料中心仍使用舊版，就能進行完整回溯。
2. 查核點 2：所有資料中心的所有 Cassandra 節點都已更新。您可以回復至此狀態，但無法還原至檢查點 1。

範例

請考慮兩個資料中心 (DC) 叢集：

1. 起始狀態：兩個資料中心的 Cassandra 節點均為 3.11.X 版本。所有其他節點皆使用 Edge for Private Cloud 4.52.02 版。假設每個資料中心有三個 Cassandra 節點。
2. 升級 DC-1：依序升級 DC-1 中的三個 Cassandra 節點。
3. 暫停並驗證：暫停叢集，特別是 DC-1，確保叢集正常運作 (檢查效能和功能)。您可以使用 DC-2 中的 Cassandra 節點，將系統還原至初始狀態。請注意，由於混合版本 Cassandra 叢集的限制，這項暫停措施必須是暫時性的。
4. 升級 DC-2：升級 DC-2 中剩餘的三個 Cassandra 節點。這會成為新的回復點。
5. 升級其他元件：按照慣例升級所有資料中心的管理、執行階段和分析節點，一次一個節點和一個資料中心。如果發生問題，您可以還原至步驟 4 的狀態。

Cassandra 升級作業的必要條件

您應搭配 Edge for Private Cloud 4.52.02 執行 Cassandra 3.11.16，並確保以下事項：

• 整個叢集可正常運作，並支援 Cassandra 3.11.16。
• 壓縮策略已設為 LeveledCompactionStrategy (升級至 4.52.02 版的必要條件)。
• 所有升級後步驟 (從初始升級至 Cassandra 3.11.16 的過程，是 4.52.02 升級的一部分) 都已完成。如果沒有，請重新執行這些步驟。只有從舊版升級至 Private Cloud 4.52.02 時，才需要執行這項操作。

步驟 1：準備升級

除了您通常會建立的標準檔案之外，請按照以下步驟操作，例如為啟用元件升級功能而建立 Apigee 的標準設定檔。

1. 使用 Apigee 備份 Cassandra。
2. 拍攝 Cassandra 節點的 VM 快照 (如可行)。
3. 請確認所有 Edge for Private Cloud 元件 (包括管理伺服器、訊息處理器、路由器、Qpid 和 Postgres) 都能存取 9042 連接埠，以便連線至 Cassandra 節點 (如果尚未設定)。詳情請參閱連接埠規定。

步驟 2：升級所有 Cassandra 節點

所有 Cassandra 節點應逐一更新，且每次只更新一個資料中心。在資料中心內升級節點之間，請等待幾分鐘，確保已更新的節點已完全啟動並加入叢集，再繼續升級同一資料中心中的另一個節點。

升級資料中心內的所有 Cassandra 節點後，請稍候一段時間 (30 分鐘至數小時)，再繼續處理下一個資料中心的節點。在此期間，請仔細檢查已更新的資料中心，確保 Apigee 叢集的功能和效能指標保持完整。這項步驟非常重要，可確保資料中心的穩定性，因為 Cassandra 已升級至 4.0.X 版，而其他 Apigee 元件仍維持在 4.52.02 版。

1. 如要升級 Cassandra 節點，請執行下列指令：

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

2. 更新節點後，請在節點上執行下列指令，在繼續執行前先執行一些驗證程序：

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile

3. 上述指令會輸出類似以下的內容：

   Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] 
   Metadata is verified

步驟 3：升級所有管理節點

逐一升級所有區域的所有管理節點：

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

步驟 4：升級所有執行階段節點

逐一升級所有區域中的所有路由器和訊息處理器節點：

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

步驟 5：升級所有剩餘的 Edge for Private Cloud 4.53.00 元件

逐一升級所有區域中剩餘的 edge-qpid-server 和 edge-postgres-server 節點。

步驟 6：升級後的步驟

升級完成後，請逐一對每個 Cassandra 節點執行下列指令：

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

新的 Edge UI

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

安裝 Edge UI

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

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

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

更新為 Apigee mTLS

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

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

復原更新

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

如果失敗導致您必須將更新內容還原為先前版本，請參閱「還原 4.53.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 for Private Cloud 4.52.02 的檔案相同。

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

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

1. 如果有，請停用任何已設定為在 Cassandra 上執行修復作業的 cron 工作，直到更新完成為止。
2. 以 root 身分登入節點，安裝 Edge RPM。
3. 按照「安裝 Edge apigee-setup 公用程式」中的說明，停用 SELinux。
4. 如果您是在 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

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

從本機存放區更新至 4.53.00

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

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

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

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

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

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

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

      tar -xzf apigee-4.53.00.tar.gz

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

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

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

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

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

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

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

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

      sudo bash /tmp/bootstrap_4.53.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.50.00 或 4.51.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.53.00」一文所述的程序操作。

機器更新順序

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

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

1 個節點的獨立升級

如何將 1 個節點的獨立設定升級至 4.53.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 上的 Postgres：

   /opt/apigee/apigee-setup/bin/update.sh -c 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. 在機器 2 上更新 Qpid：

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

6. 更新機器 1 上的 UI：

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

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. 在機器 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 上更新 Postgres：

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

3. 更新機器 5 上的 Postgres：

   /opt/apigee/apigee-setup/bin/update.sh -c 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. 在機器 4 上更新 Qpid：

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

7. 在機器 5 上更新 Qpid：

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

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

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

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

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

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

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

11. 重新啟動 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. 更新機器 8 上的 Postgres：

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

3. 更新機器 9 上的 Postgres：

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

4. 更新機器 1 上的 LDAP：

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

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

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

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

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -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. 更新機器 8 上的 Postgres：

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

3. 更新機器 9 上的 Postgres：

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

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

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

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

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

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

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -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. 更新 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

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

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

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

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

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