更新 Apigee Edge 4.50.00 或 4.51.00 至 4.52.00

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

誰可以執行更新

執行更新的使用者，應與當初安裝 Edge 的使用者相同，或以根權限執行更新的使用者。

安裝邊緣 RPM 後，任何人都可以進行設定。

必須更新哪些元件

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

更新必要條件

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

• 備份所有節點
  基於安全考量，建議您在更新前執行所有節點的完整備份作業。使用目前邊緣版本的程序執行備份。

  以便您建立備份方案，以便在更新至新版本時正常運作。如要進一步瞭解備份，請參閱備份與還原一文。

• 確保 Edge 正在執行
  請使用下列指令，確保 Edge 在更新過程中已啟動且正在執行：

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

• 確保 Cassandra 壓縮策略為 LeveledCompactionStrategy
  確保 Cassandra 壓縮策略已設為 LeveledCompactionStrategy，詳情請參閱「變更 Cassandra 壓縮策略」一文。

自動傳播房源設定

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

需要升級至 Zookeeper 3.8.0

這個版本的 Edge for Private Cloudes 包含 Zookeeper 3.8.0 版。在升級過程中，所有 Zookeeper 資料都會遷移至 Zookeeper 3.8.0。

升級 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。

1. 如果 ZooKeeper 節點上尚未安裝 nc，請安裝 nc：

     sudo yum install nc

2. 在節點上執行以下 nc 指令，其中 2181 是 ZooKeeper 通訊埠：

     echo stat | nc localhost 2181

   您會看到如下所示的輸出：

     Zookeeper version: 3.8.0-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 行中，視節點設定而定，您應該會看到觀察者、領先者或追蹤者 (代表不是主要選民)。注意：在含有單一 ZooKeeper 節點的 Edge 獨立安裝作業中，Mode 會設定為獨立安裝。

3. 在每個 ZooKeeper 節點上重複執行步驟 1 和 2。

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

按照下列方式升級每個觀察器和追蹤者節點上的 Zookeeper：

1. 按照 在具有外部網際網路連線的節點中更新至 4.52.00 版的說明，下載並執行 Private Cloud 4.52 適用的 Edge 啟動程序。這個程序可能因節點有外部網際網路連線，或您執行離線安裝作業而異。
2. 升級 Zookeeper 元件：

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

   注意：如果這些節點已安裝其他元件 (例如 Cassandra)，您可以立即升級這些節點 (例如使用 cs、zk 設定檔)，也可以稍後再升級其他元件。Apigee 建議您先升級 Zookeeper，並確保叢集正常運作，再升級其他元件。
3. 在每個 Zookeeper 觀察器和追蹤者節點上重複上述步驟。

關閉領先者

所有觀察器和追蹤者節點都升級完成後，請關閉主要元件。在標示為主要的節點上執行下列指令：

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

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

確認已選出新的領導者

按照上方「識別領導者、追蹤者和觀察者」一節所述步驟，在現有領導人停止後，確認已選擇新的主管。請注意，主管可能已在與目前領先者不同的資料中心內選民。

升級領導者

按照上述「 在觀察器和追蹤器節點升級 Zookeeper」一節所述的步驟操作。

舊主要節點也升級後，請驗證叢集健康狀態，並確認有主要節點。

復原

如果需要復原帳戶，請按照下列步驟操作：

1. 請先對觀察者和追蹤者執行復原步驟。
2. 下載並執行要復原的版本 4.50 或 4.51。實際程序可能因節點有外部網際網路連線，或是您採用離線安裝狀態而有所差異。
3. 如果 Zookeeper 在節點上執行，請停止 Zookeeper：

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

4. 解除安裝現有的動物園管理員：

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

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

還原備份內容

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

必須升級至 Postgres 14

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

大部分 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.50.00 或 4.51.00) 安裝新的 Postgres 待命伺服器，而非 4.52.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 4.51.00：

      1. 將 Edge 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

      2. 安裝 Edge apigee-service 公用程式和依附元件：

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

      如果目前使用 Edge 4.50.00：

      1. 將 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

      2. 安裝 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 之前，請在主要主機和待命都執行下列步驟，以更新 apigee-postgresql 的 max_locks_per_transaction 屬性：

1. 如果找不到，請建立 /opt/apigee/customer/application/postgresql.properties 檔案。
2. 將這個檔案的擁有權變更為 apigee：

   sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

3. 在檔案中加入下列屬性：

   conf/postgresql.conf+max_locks_per_transaction=30000

4. 設定apigee-postgresql：

   apigee-service apigee-postgresql configure

5. 重新啟動「apigee-postgresql」：

   apigee-service apigee-postgresql restart

執行直接升級

如要直接升級至 Postgres 14，請按照下列步驟操作：

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. 在主要主機上執行 setup 指令：

   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 安裝版本已升級至 14，則可忽略錯誤。

   /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

12. 在主要主機和待命主機上，從 /opt/apigee/customer/application/postgresql.properties 檔案中移除 conf/postgresql.conf+max_locks_per_transaction=30000 這一行。這一行已在初步步驟中新增。

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

停用 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. 在 Management Server 節點上執行下列 Edge Management API 呼叫，藉此從 ZooKeeper 中刪除待命節點的 UUID：

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

新的 Edge UI

本節列出 Edge UI 的注意事項。詳情請參閱私有雲適用的全新 Edge UI 一文。

安裝 Edge UI

完成初始安裝後，Apigee 會建議您安裝 Edge UI。Edge UI 是 Apigee Edge for Private Cloud 的開發人員和管理員適用的改良版使用者介面。

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

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

更新 Edge UI

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

• 從 4.51.00 到 4.52.00 (已安裝新版 Edge UI)：請使用本節中的升級操作說明 edge-management-ui 元件。

使用 Apigee mTLS 更新

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

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

將更新復原

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

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

Logging 更新資訊

根據預設，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 元件。所有 Edge 設定都會在同一個節點上顯示路由器和訊息處理器。
4. 讓路由器恢復連線。
5. 針對其餘的路由器，重複步驟 2 到 4。
6. 繼續更新安裝檔中所有剩餘的電腦。

請在更新前後執行下列作業：

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

使用靜音設定檔

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

使用外部網際網路連線的節點更新至 4.52.00

使用下列程序更新節點上的邊緣元件：

1. 如果有的話，請停用所有設為在 Cassandra 上執行修復作業的 cron 工作，直到更新完成為止。
2. 以 Root 權限登入節點，以安裝邊緣 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：

   1. 將 Edge bootstrap_4.52.00.sh 檔案下載至 /tmp/bootstrap_4.52.00.sh：

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

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

      sudo bash /tmp/bootstrap_4.52.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。
   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 是要更新的邊緣元件。可能的值包括：
        • cs：Cassandra
        • edge：所有邊緣元件 (Edge UI 除外)：管理伺服器、訊息處理器、路由器、QPID 伺服器、Postgres Server
        • ldap：OpenLDAP
        • ps：postgresql
        • qpid：qpidd
        • sso：Apigee SSO (如果您已安裝單一登入 (SSO))
        • ue：新的 Edge UI
        • ui：傳統版 Edge UI
        • zk：動物守護者
      • configFile 和您在安裝 4.50.00 或 4.51.00 期間用來定義 Edge 元件的設定檔相同。

      只有在您擁有 Edge 多功能 (AIO) 安裝設定檔時，才能將 component 針對所有元件執行 update.sh。例如：

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

   7. 在所有執行它的節點上重新啟動 Edge UI 元件 (如果尚未重新啟動的話)：

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

   8. 您可以按照「測試安裝作業」的說明，在管理伺服器執行 apigee-validate 公用程式來測試更新。

   如果您之後決定復原更新，請按照復原 4.52.00 版中所述的程序操作。

   從本機存放區更新至 4.52.00

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

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

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

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

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

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

      2. 將 .tar 檔案複製到要更新 Edge 的節點。舉例來說，請將這個檔案複製到新節點的 /tmp 目錄。
      3. 在新節點上，將檔案解壓縮至 /tmp 目錄：

         tar -xzf apigee-4.52.00.tar.gz

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

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

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

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

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

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

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

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

         sudo bash /tmp/bootstrap_4.52.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 是要更新的邊緣元件。您通常會更新下列元件：
        • cs：Cassandra
        • edge：所有邊緣元件 (Edge UI 除外)：管理伺服器、訊息處理器、路由器、QPID 伺服器、Postgres Server
        • ldap：OpenLDAP
        • ps：postgresql
        • qpid：qpidd
        • sso：Apigee SSO (如果您已安裝單一登入 (SSO))
        • ue 新的 Edge UI
        • ui：傳統版 Edge UI
        • zk：動物守護者
      • configFile 和您在安裝 4.50.00 或 4.51.00 期間用來定義 Edge 元件的設定檔相同。

      只有在您擁有 Edge 多功能 (AIO) 安裝設定檔時，才能將 component 針對所有元件執行 update.sh。例如：

      /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.52.00 版中所述的程序操作。

   機器更新順序

   在 Edge 安裝作業中更新機器的順序重要：

   • 您必須先更新「所有」Cassandra 和 ZooKeeper 節點，才能更新其他節點。
   • 如果機器具有多個 Edge 元件 (管理伺服器、訊息處理器、路由器、QPID 伺服器，而非 Postgres 伺服器)，請使用 -c edge 選項同時更新所有裝置。
   • 如果步驟指定應在多部機器上執行，請以指定的機器順序執行該步驟。
   • 您不需要另外完成一個步驟即可更新營利設定。當您指定 -c edge 選項時，該屬性就會更新。

   1 個節點獨立昇級

   如要將 1 節點獨立設定升級至 4.52.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 個節點獨立昇級

   為雙節點獨立安裝作業更新下列元件：

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

      /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

      • New 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

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

        /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

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

         /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

       • New 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、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. 資料中心 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. 更新新版使用者介面 (ue) 或傳統使用者介面 (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

   適用於非標準設定

   如果您有非標準設定，請依照下列順序更新邊緣元件：

   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 元件。