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

更新 Apigee Edge 4.51.00 或 4.52.00 至 4.52.01

Apigee 支援將 Edge for Private Cloud 從 4.51.00 版或 4.52.00 版直接升級至 4.52.01 版。本頁說明如何執行這兩種升級作業。

誰可以執行更新

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

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

您必須更新哪些元件

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

更新必要條件

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

備份所有節點
為了安全起見，建議您在更新前完整備份所有節點。請按照目前 Edge 版本的程序執行備份作業。
這樣一來，如果更新至新版本後無法正常運作，您就能使用備用方案。如要進一步瞭解備份功能，請參閱「備份與還原」。
確認 Edge 是否正在執行
請使用下列指令，確認 Edge 在更新程序期間是否已啟用並運作：
```
/opt/apigee/apigee-service/bin/apigee-all status
```
確認 Cassandra 壓縮策略為 LeveledCompactionStrategy
確認 Cassandra 壓縮策略已設為 LeveledCompactionStrategy，如「變更 Cassandra 壓縮策略」一文所述。

自動傳播資源設定

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

必須升級至 Zookeeper 3.8.3

這次推出的 Edge for Private Cloud 版本包含升級至 Zookeeper 3.8.3。在升級過程中，所有 Zookeeper 資料都會遷移至 Zookeeper 3.8.3。

升級 Zookeeper 前，請先詳閱 Zookeeper 維護指南。大多數 Edge 實際運作系統會使用一組 Zookeeper 節點，分散在多個資料中心。其中部分節點會設為參與 Zookeeper 領導者選舉的投票者，其餘節點則設為觀察者。詳情請參閱「關於領袖、追隨者、投票者和觀察者」。投票節點會選出領導者，之後投票節點本身就會成為追隨者。

在更新程序期間，當領導節點關閉時，可能會出現暫時性延遲或寫入 Zookeeper 的失敗。這可能會影響寫入 Zookeeper 的管理作業，例如 Proxy 的部署作業，以及 Apigee 基礎架構變更，例如新增或移除訊息處理器等。在遵循下列程序升級 Zookeeper 時，對 Apigee 的執行階段 API 不應有任何影響 (除非這些執行階段 API 呼叫管理 API)。

從大方向來看，升級程序會備份每個節點。接著升級所有觀察者和追隨者，最後升級領導節點。

備份

請備份 Zookeeper 的所有節點，以備需要回溯時使用。請注意，回溯會將 Zookeeper 還原至備份時的狀態。注意：自備份建立以來，Apigee 中任何部署或基礎架構變更 (相關資訊儲存在 Zookeeper 中) 都會在還原期間遺失。

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

如果您使用的是虛擬機器，且具備相關能力，也可以拍攝 VM 快照或備份，以便在必要時還原或回復。

找出領袖、追隨者和觀察者

注意：下方的範例指令會使用 nc 公用程式將資料傳送至 Zookeeper。您也可以使用其他公用程式將資料傳送至 Zookeeper。

如果 ZooKeeper 節點未安裝 nc，請安裝 nc：
```
  sudo yum install nc
```
在節點上執行下列 nc 指令，其中 2181 是 ZooKeeper 通訊埠：
```
  echo stat | nc localhost 2181
```
您會看到如下所示的輸出：
```
  Zookeeper version: 3.8.3-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597
```
在節點輸出的 Mode 行中，您應該會看到觀察者、領導者或追隨者 (意即不是領導者的投票者)，具體取決於節點設定。注意：在 Edge 的獨立安裝程序中，如果只有一個 ZooKeeper 節點，Mode 就會設為獨立。
針對每個 ZooKeeper 節點重複執行步驟 1 和 2。

在觀察器和追隨節點上升級 Zookeeper

請按照下列步驟，在每個觀察者和追隨者節點上升級 Zookeeper：

請按照「在有外部網際網路連線的節點上更新至 4.52.01」一文的說明，下載並執行 Edge for Private Cloud 4.52 的 bootstrap。這個程序可能會因節點是否有外部網際網路連線，或您是否執行離線安裝作業而有所不同。
升級 Zookeeper 元件：
```
  /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
```
注意：如果這些節點已安裝其他元件 (例如 Cassandra)，您可以立即升級這些元件 (例如 cs、zk 設定檔)，也可以稍後再升級其他元件。Apigee 建議您先升級 Zookeeper，並確保叢集運作正常，再升級其他元件。
針對每個 Zookeeper 觀察器和追隨者節點重複執行上述步驟。

關閉領導者

所有觀察者和追隨者節點都升級完畢後，請關閉領導節點。在標示為領導節點的節點上，執行下列指令：

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

請注意，在選出新領袖之前，Zookeeper 可能會出現暫時性延遲或寫入失敗。這可能會影響寫入 Zookeeper 的作業，例如 Proxy 的部署動作，或 Apigee 基礎架構變更，例如新增或移除訊息處理器等。

確認新領袖已當選

請按照上方「找出領袖、追隨者和觀察者」一節的步驟，確認在現有領袖停止運作後，是否已從追隨者中選出新的領袖。請注意，選出的領導節點可能位於與目前領導節點不同的資料中心。

升級勝出者

按照「在觀察器和追隨者節點上升級 Zookeeper」一節中的步驟操作。

舊的領導節點也升級完成後，請驗證叢集健康狀態，並確認是否有領導節點。

復原

如果需要回溯：

請先對觀察者和追隨者執行回溯步驟。
下載並執行要回溯至的版本的 bootstrap，也就是 4.50 或 4.51。這個程序可能會因節點是否有外部網路連線，或您是否要進行離線安裝而異。

如果 Zookeeper 正在節點上執行，請停止該服務：

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

解除安裝現有的 zookeeper：

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

照常安裝 Zookeeper：

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

所有追隨者和觀察者都已回溯後，請按照領導節點的步驟 2 至 5 回溯領導節點。
所有節點都已復原後，請確認叢集的健康狀態，並確保叢集中有領導節點。

還原備份

請參閱「從備份還原」一文。請注意，從 Edge for Private Cloud 的舊版 (例如 4.50 和 4.51) 取得的 Zookeeper 備份，應與 Edge for Private Cloud 4.52 中的 Zookeeper 版本相容。

必須升級至 Postgres 14

這次 Edge for Private Cloud 的版本包含升級至 Postgres 14。在此次升級中，所有 Postgres 資料都會遷移至 Postgres 14。

如果您要從 Edge for Private Cloud 4.51.00 升級至 4.52.01，則必須遵循其他 Postgres 升級步驟。如果您要從 4.51.00 版升級至 4.52.01 版，請參閱「必須升級至 Postgres 14」一節。
如果您要從 Edge for Private Cloud 4.52.00 升級至 4.52.01，則不需要執行額外的 Postgres 升級步驟。

升級 Qpid

這次的 Edge for Private Cloud 版本包含 Qpid J-Broker 升級。

apigee-qpidd-4.52.01-X.X.X 引進的新要求：從 4.52.01 版開始，安裝程序中引進了新要求。請務必在設定檔中加入 QPID_MGMT_USERNAME 和 QPID_MGMT_PASSWORD 屬性。請務必加入這些屬性並設定適當的值，以利順利安裝。

建議您選取下列任一方法來執行 Qpid 升級作業：

就地升級，完全不必停機
啟用新的 Qpid 節點

無需停機的直接升級

這個方法可確保 Edge 執行階段環境不會發生停機情形，並盡可能減少用於分析的執行階段資料 (如有) 損失。

先決條件：請先升級 edge-message-processor、edge-management-server 和 edge-qpid-server，再開始 Qpid 升級作業。

如要執行 Qpid 的直接升級作業，並確保升級期間不中斷服務：

請先選取一個 Qpid 節點。
停止節點上的 Qpid 仲介：
```
apigee-service apigee-qpidd stop
```
套用防火牆，封鎖所有訊息處理器透過仲介通訊埠 5672 傳入的流量。您可以在 Qpid 節點例項或其他外部防火牆/網路元件層級套用這項防火牆。

建議您對所有郵件處理器 IP 位址執行相同的步驟。舉例來說，如要使用 IPTables 將來自訊息處理器 IP 位址的傳送要求，DROP 至位於 5672 的 Qpid 節點，您可以使用以下指令：
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
再次啟動 Qpid 仲介器，以便排空現有訊息 (如有)：
```
apigee-service apigee-qpidd start
```
確認現有佇列是否為空白：
```
qpid-stat -q
```
如果訊息卡在死信佇列 (DLQ) (ax-q-axgroup-001-consumer-group-001-dl)，請按照這些步驟，排空佇列，解決卡在死信佇列中的 Analytics 資料。
確認舊節點上的佇列已排空後，請停止 apigee-qpidd：
```
apigee-service apigee-qpidd stop
```

在節點上升級 Qpid：

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

重新啟動 edge-qpid-server：
```
apigee-service edge-qpid-server restart
```
移除在步驟 3 中套用的防火牆規則。

針對套用防火牆的所有郵件處理器 IP 位址，執行相同的移除步驟。防火牆移除後，系統就會接受來自訊息處理器 IP 位址的請求，並將其傳送至位於 5672 的 Qpid 節點。如果您使用 iptables 新增防火牆，則可以使用下列指令移除防火牆並列出現有設定：
```
iptables -F
  iptables -L
```
使用網路監控功能，確認 Qpid 佇列是否正在接收訊息：
```
http://QPID_NODE_IP:8090
```
針對每個 Qpid 節點重複執行步驟 1 到 9。

啟用新的 Qpid 節點

這個方法會在新的節點上設定及安裝 apigee-qpidd 和 edge-qpid-server。

新增 Qpid 節點。這個步驟會使用 J-broker 設定 Qpid 節點。如需詳細步驟，請參閱「新增 Qpid 伺服器」。
選取現有的 Qpid 節點 (來自要升級的版本的節點)。
停止節點上的 Qpid 仲介：
```
apigee-service apigee-qpidd stop
```
套用防火牆，封鎖所有訊息處理器透過仲介通訊埠 5672 傳入的流量。您可以在 Qpid 節點例項或其他外部防火牆/網路元件層級套用這項防火牆。

建議您對所有郵件處理器 IP 位址執行相同的步驟。舉例來說，如要使用 IPTables 將來自訊息處理器 IP 位址的傳送要求，DROP 至位於 5672 的 Qpid 節點，您可以使用以下指令：
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
再次啟動 Qpid 仲介器，以便排空現有訊息 (如有)：
```
apigee-service apigee-qpidd start
```
請確認現有佇列是否為空白：
```
qpid-stat -q
```
如果訊息卡在死信佇列 (DLQ) (ax-q-axgroup-001-consumer-group-001-dl)，請按照「 Analytics 資料卡在 Qpidd 死信佇列中」這個疑難排解主題中的步驟，清空佇列。
確認舊節點上的佇列已清空後，請停止 apigee-qpidd
```
apigee-service apigee-qpidd stop
```
按照「移除 Qpid 伺服器」一文中的步驟，註銷舊的 Qpid 節點。
請繼續逐一新增節點並移除舊節點，直到所有 Qpid 節點都升級完成為止。

復原

注意：請先回復 apigee-qpidd，再嘗試回復其他 Edge 元件 (edge-qpid-server、edge-message-processor、edge-management-server)。

如要復原至先前的功能版本，請務必下載要復原的版本的 bootstrap.sh 檔案。如要回溯至 4.52.00 版，請下載 bootstrap_4.52.00.sh。

如要回復 Qpid，請在所有 Qpid 主機上執行下列步驟：

停止現有的 Qpid 仲介服務
```
apigee-service apigee-qpidd stop
```
套用防火牆，封鎖所有訊息處理器透過仲介通訊埠 5672 傳入的流量。您可以在 Qpid 節點例項或其他外部防火牆/網路元件層級套用這項防火牆。

建議您對所有郵件處理器 IP 位址執行相同的步驟。舉例來說，如要使用 IPTables 將來自訊息處理器 IP 位址的傳送要求，DROP 至位於 5672 的 Qpid 節點，您可以使用以下指令：
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
再次啟動 qpid 中介服務，以便排空現有訊息 (如有)：
```
apigee-service apigee-qpidd start
```
確認現有佇列為空白。如要確認，請登入 Qpid 管理入口網站：
```
http://QPID_NODE_IP:8090
```
注意： 如果無法存取 QPID 節點上的這個 8090 通訊埠，您可以使用 SSH 通訊埠轉送等替代機制來存取這個網址。
確認佇列已清空後，請停止並解除安裝 Qpid：
```
apigee-service apigee-apidd uninstall
```
刪除 Qpid 資料目錄：
```
rm -r APIGEE_ROOT/data/apigee-qpidd
```

重新安裝 Qpid 中介軟體：

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

重新安裝 Qpid 中介服務後，請移除防火牆設定，並使用下列指令列出任何現有設定：
```
iptables -F
```
```
iptables -L
```

新的 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.51.00 升級至 4.52.00 (已安裝新 Edge UI)：請參閱本節中的升級操作說明，瞭解如何升級 edge-management-ui 元件。

更新至 Apigee mTLS

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

復原更新

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

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

記錄更新資訊

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

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

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

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

零停機更新

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

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

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

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

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

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

使用靜默設定檔

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

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

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

如果有，請停用任何已設定為在 Cassandra 上執行修復作業的 cron 工作，直到更新完成為止。
以 root 身分登入節點，安裝 Edge RPM。
注意：雖然 RPM 安裝作業需要 Root 存取權，但您可以不必取得 Root 存取權，也能執行 Edge 設定。
安裝 yum-utils 和 yum-plugin-priorities：
注意：如果您的作業系統是 RHEL 8.0 至 8.6，請略過這個步驟。
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
按照「安裝 Edge apigee-setup 公用程式」中的說明，停用 SELinux。
如果您是在 Oracle 7.x 上安裝，請執行下列指令：
```
sudo yum-config-manager --enable ol7_optional_latest
```

如果您是在 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

如果您目前使用的是 Edge 4.51.00 版：
1. 將 Edge bootstrap_4.52.01.sh 檔案下載至 /tmp/bootstrap_4.52.01.sh：
```
curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
```
2. 執行下列指令，安裝 Edge 4.52.01 apigee-service 公用程式和依附元件：
```
sudo bash /tmp/bootstrap_4.52.01.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。
3. 使用 apigee-service 更新 apigee-setup 公用程式，如以下範例所示：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
4. 請更新管理伺服器上的 apigee-validate 公用程式，如以下範例所示：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
5. 請更新管理伺服器上的 apigee-provision 公用程式，如以下範例所示：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
6. 執行下列指令，即可在節點上執行 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 ./sa_silent_config
```
7. 如果尚未在執行 Edge UI 元件的所有節點上重新啟動，請按照下列步驟操作：
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
8. 如測試安裝程序所述，請在管理伺服器上執行 apigee-validate 公用程式來測試更新。

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

從本機存放區更新至 4.52.01

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

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

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

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

按照「安裝 Edge apigee-setup 公用程式」中的「建立本機 Apigee 存放區」說明，建立本機 4.52.01 存放區。
注意：如果您已有現有的存放區，可以按照「安裝 Edge apigee-setup 公用程式」中的「更新本機 Apigee 存放區」一節所述，將 4.52.01 存放區新增至該存放區。
如何從 .tar 檔案安裝 apigee-service：
1. 在含有本機存放區的節點上，使用下列指令將本機存放區封裝至名為 /opt/apigee/data/apigee-mirror/apigee-4.52.01.tar.gz 的單一 .tar 檔案：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
2. 將 .tar 檔案複製到要更新 Edge 的節點。例如，將其複製到新節點的 /tmp 目錄中。
3. 在新節點上，將檔案解壓縮至 /tmp 目錄：
```
tar -xzf apigee-4.52.01.tar.gz
```
  這個指令會在包含 .tar 檔案的目錄中建立名為 repos 的新目錄。例如 /tmp/repos。
4. 從 /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件：
```
sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  請注意，您必須在這個指令中加入 repos 目錄的路徑。
如何使用 Nginx 網路伺服器安裝 apigee-service：
1. 依據「安裝 Edge apigee-setup 公用程式」一文的「使用 Nginx 網路伺服器從存放區安裝」說明，設定 Nginx 網路伺服器。
2. 在遠端節點上，將 Edge bootstrap_4.52.01.sh 檔案下載至 /tmp/bootstrap_4.52.01.sh：
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
```
  其中 uName:pWord 是您先前為存放區設定的使用者名稱和密碼，而 remoteRepo 則是存放區節點的 IP 位址或 DNS 名稱。
3. 在遠端節點上安裝 Edge apigee-setup 公用程式和依附元件：
```
sudo bash /tmp/bootstrap_4.52.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 update
```
請更新管理伺服器上的 apigee-provision 公用程式，如以下範例所示：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
依照「機器更新順序」一節的說明，在節點上依序執行 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 元件的設定檔相同。
  注意：「apigee」使用者必須能讀取設定檔。如要變更擁有者，請使用下列指令：
```
chown apigee:apigee configFile
```
您可以將 component 設為「all」，讓 update.sh 對所有元件執行，但前提是您必須有 Edge 一體式 (AIO) 安裝設定檔。例如：
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
如果尚未重新啟動，請在執行 UI 的所有節點上重新啟動 UI 元件：
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
如測試安裝程序所述，請在管理伺服器上執行 apigee-validate 公用程式來測試更新。

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

機器更新順序

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

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

1 個節點的獨立升級

如要將 1 個節點的獨立設定升級至 4.52.01：

更新所有元件：

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

(如果您已安裝 apigee-adminapi) 更新 apigee-adminapi 公用程式：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

2 個節點的獨立升級

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

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

更新機器 1 上的 Cassandra 和 ZooKeeper：

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

更新機器 2 上的 Postgres：

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

更新機器 1 上的 LDAP：

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

更新機器 2 和 1 的 Edge 元件：

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

在機器 2 上更新 Qpid：

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

更新機器 1 上的 UI：

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

(如果您已安裝 apigee-adminapi) 在機器 1 上更新 apigee-adminapi 公用程式：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(如果您安裝了 Apigee SSO) 在機器 1 上更新 Apigee SSO：
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
其中 sso_config_file 是您在安裝 SSO 時建立的設定檔。

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

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

5 節點升級

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

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

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

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

更新機器 4 上的 Postgres：

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

更新機器 5 上的 Postgres：

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

更新機器 1 上的 LDAP：

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

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

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

在機器 4 上更新 Qpid：

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

更新機器 5 的 Qpid：

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

更新 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
```
(如果您已安裝 apigee-adminapi) 在機器 1 上更新 apigee-adminapi 公用程式：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(如果您安裝了 Apigee SSO) 在機器 1 上更新 Apigee SSO：
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
其中 sso_config_file 是您在安裝 SSO 時建立的設定檔。
重新啟動 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、2 和 3 上更新 Cassandra 和 ZooKeeper：

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

更新機器 8 上的 Postgres：

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

更新機器 9 上的 Postgres：

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

更新機器 1 上的 LDAP：

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

依序更新機器 6、7、8、9、1、4 和 5 的 Edge 元件：
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

更新機器 6 和 7 的 Qpid：

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

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

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

(如果您已安裝 apigee-adminapi) 更新機器 1 上的 apigee-adminapi 公用程式：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(如果您安裝了 Apigee SSO) 在機器 1 上更新 Apigee SSO：
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
其中 sso_config_file 是您在安裝 SSO 時建立的設定檔。
重新啟動 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、2 和 3 上更新 Cassandra 和 ZooKeeper：

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

更新機器 8 上的 Postgres：

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

更新機器 9 上的 Postgres：

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

在機器 4 和 5 上更新 LDAP：

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

依序更新機器 12、13、8、9、6、7、10 和 11 的 Edge 元件：
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

更新機器 12 和 13 上的 Qpid：

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

在機器 6 和 7 上更新新版 UI (ue) 或傳統版 UI (ui)：
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(如果您已安裝 apigee-adminapi) 在機器 6 和 7 上更新 apigee-adminapi 公用程式：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(如果您已安裝 Apigee SSO)：在機器 6 和 7 上更新 Apigee SSO：
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
其中 sso_config_file 是您在安裝 SSO 時建立的設定檔。
重新啟動 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 拓撲和節點編號的清單，請參閱「安裝拓撲」。

更新 Cassandra 和 ZooKeeper：

在資料中心 1 的機器 1、2 和 3 上：

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

在資料中心 2 的機器 7、8 和 9 上

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

更新 Postgres：

資料中心 1 中的機器 6

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

資料中心 2 中的機器 12

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

更新 LDAP：

資料中心 1 中的機器 1

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

資料中心 2 中的機器 7

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

更新 Edge 元件：

資料中心 1 中的機器 4、5、6、1、2、3

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

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

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

更新 qpidd：

資料中心 1 中的機器 4、5

在機器 4 上更新 qpidd：

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

更新機器 5 上的 qpidd：

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

資料中心 2 中的機器 10、11

在機器 10 上更新 qpidd ：

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

在機器 11 上更新 qpidd ：

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

更新新版 UI (ue) 或傳統版 UI (ui)：

資料中心 1 中的機器 1：

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

資料中心 2 中的機器 7：

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

(如果您已安裝 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
```
(如果您安裝了 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
```
在機器 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 元件：

ZooKeeper
Cassandra
ps
LDAP
Edge，表示所有節點上的「-c edge」設定檔，依序為：含有 Qpid 伺服器的節點、Edge Postgres 伺服器、管理伺服器、訊息處理器和路由器。
注意：如果節點同時安裝 Qpid 伺服器和 Edge Postgres 伺服器，請執行「-c edge」設定檔步驟。
qpidd
Edge UI (傳統版或新版)
apigee-adminapi
Apigee 單一登入 (SSO)

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