將 Apigee Edge 4.17.09 更新至 4.19.01

Private Cloud v4.19.01 版

本節說明如何執行下列升級作業：

  • 從 4.17.09 至 4.19.01

可執行更新的使用者

執行更新的使用者必須與當初安裝 Edge 的使用者相同，或 也就是以根的身分執行的使用者

任何使用者都可設定邊緣 RPM 套件。

您需要更新哪些元件

您必須更新所有 Edge 元件。Edge 不支援含有元件的設定 以便擷取來自多個版本的內容

維持相容性

將適用於私有雲的 Apigee Edge 升級至 4.19.01 版時，您必須確保 產生的實作只會參照其設定檔中支援的屬性。

屬性 位置 說明
conf_load_balancing_load.balancing.
  driver.nginx.server.retry		 router.properties 從 router.properties 檔案移除這個屬性。如何在以下位置設定重試選項： 4.19.01，使用虛擬 主機設定屬性。

屬性自動傳播 設定

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

必須升級至 Postgres 9.6

這個版本的 Edge 包含 Postgres 9.6 的升級版本。本次升級 Postgres 資料會遷移至 Postgres 9.6。

大多數 Edge 生產系統使用兩個為主待命複製設定的 Postgres 節點。 在更新過程中，當 Postgres 節點停止進行更新時，Analytics 資料仍然存在 寫入 Qpid 節點Postgres 節點更新並恢復上線後，Analytics 資料 再推送至 Postgres 節點

Postgres 更新的方式取決於您為 Postgres 節點：

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

    如果必須復原更新，就必須新增額外的 Postgres 待命節點 。如果必須復原更新，新的 Postgres 待命節點 成為復原後的主要 Postgres 節點。因此，當您安裝 新的 Postgres 待命節點，應位於符合所有硬體的節點上 要求 Postgres 伺服器的要求 (如 Edge 內所定義) 安裝需求。

    在 1 節點和 2 節點的 Edge 設定中，您會使用用於原型設計和測試的拓撲 只會有一個 Postgres 節點您可以直接更新這些 Postgres 節點，不必 來建立新的 Postgres 節點

  • 如果 Postgres 節點使用了網路儲存空間： 您不必安裝新的 Postgres 節點，這是 Apigee 的建議。在 您可以按照下方程序，略過指定安裝後停用新安裝 Postgres 待命節點。

    開始更新程序前，請擷取 Postgres。然後，如果在更新期間發生任何錯誤，您也被強制復原， 可以從該快照還原 Postgres 節點。

安裝新 Postgres 待命節點

這項程序會在新的節點上建立 Postgres 待命伺服器。務必安裝新的 現有 Edge (4.17.09 版) 適用的 Postgres 待命伺服器 不適用於版本 4.19.01

使用與安裝目前版本相同的設定檔執行安裝 這些物件

如何建立新的 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 公用程式。
    3. 下載 Edge bootstrap_4.17.09.sh 檔案， /tmp/bootstrap_4.17.09.sh : 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    4. 安裝 Edge apigee-service 公用程式和依附元件： 
      sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
    5. 使用 apigee-service 安裝 apigee-setup 公用程式： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. 安裝 Postgres： 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. 在新待命節點上執行下列指令： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      驗證裝置是否為待機。

停用 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 管理功能，以便從 ZooKeeper 刪除待命節點的 UUID Management Server 節點上的 API 呼叫： 
    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

處理失敗的更新

如果更新失敗，您可以嘗試修正問題，然後執行 update.sh 可以選取「重新建立」，再次生成新的提示您可以多次執行更新，系統會從上次中斷的地方繼續更新 關閉。

如果作業失敗而需要您將更新復原為先前版本，請參閱 復原 4.19.01 版以取得更多時間。

記錄更新資訊

根據預設，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 元件。 所有邊緣設定會在相同節點上顯示路由器和訊息處理器。
  4. 重新連線至路由器。
  5. 針對其餘的路由器，重複步驟 2 到 4。
  6. 請繼續更新設定中其餘的機器。

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

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

使用靜音設定檔

您必須將靜音設定檔傳送至 update 指令。靜音設定檔 必須與您安裝 Edge 4.17.09 時使用的相同。

更新為 在具備外部網際網路連線的節點上執行 4.19.01

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

  1. 如果您目前搭配本機儲存空間使用 Postgres 主待命複製功能， 按照安裝新的 Postgres 說明，安裝新的 Postgres 待命節點 待命節點

    如果您已使用網路儲存空間，就不必安裝新的節點。請改為 Postgres 所用資料儲存庫的網路快照。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

  2. 如果有 CRON 工作顯示，則請停用在 Cassandra 上執行修復作業的所有 CRON 工作 直到更新完成為止
  3. 以根權限登入節點，安裝邊緣 RPM。
  4. 安裝 yum-utils 和 yum-plugin-priorities： 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. 按照安裝 使用 Edge Apigee-setup 公用程式。
  6. 如果您是在 Oracle 7.x 上安裝，請執行下列指令： 
    sudo yum-config-manager --enable ol7_optional_latest
  7. 如要在 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
  8. 下載 Edge 4.19.01 bootstrap_4.19.01.sh 檔案， /tmp/bootstrap_4.19.01.sh: 
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  9. 安裝 Edge 4.19.01 apigee-service 公用程式和依附元件： 
    sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

    其中 uName:pWord 是您從 Apigee 收到的使用者名稱和密碼。如果發生以下情況： 省略 pWord，系統會提示您輸入。

    根據預設，安裝程式會檢查您是否已安裝 Java 1.8。如果不是， 便會自動安裝使用 JAVA_FIX 選項指定處理 Java 的方式 安裝。JAVA_FIX 會使用下列值：

    • I = 安裝 OpenJDK 1.8 (預設)
    • C = 在不安裝 Java 的情況下繼續操作
    • 問：退出，如果採用這個選項，您必須自行安裝 Java。
  10. 使用 apigee-service 更新 apigee-setup 公用程式： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. 在管理伺服器上更新 apigee-validate 公用程式： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. 更新 apigee-provision 公用程式： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. 請依下列說明，在節點上執行更新公用程式。 機器更新順序： 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    設定檔的唯一規定是設定檔必須能存取 或可由「apigee」讀取內容。

    使用 -c 選項指定要更新的元件。系統會列出 元件包括：

    • 「cs」= Cassandra
    • 「邊緣」=所有 Edge UI 以外的所有邊緣元件。「邊緣」元件包括 Management Server、訊息處理器、路由器、QPID Server、Edge Postgres Server。
    • 「ldap」= OpenLDAP
    • 「ps」= postgresql
    • 「qpid」= Qpidd
    • 「Sso」= 邊緣單一登入 (SSO)
    • 「ui」= 邊緣 UI
    • 「zk」= 祖母

    您可以設定 component，對所有元件執行 update.sh 只要您有 Edge 全包式 (AIO) 組態設定檔，您就會看到「all」。例如：

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. 請在所有執行該元件的機器上重新啟動 Edge UI 元件 (如果尚未重新啟動)： 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  15. 在管理頁面執行 apigee-validate 公用程式，測試更新作業 伺服器，如「測試安裝」一節中所述。
  16. 如果您已安裝新的 Postgres 待命節點，請按照下文說明停用該節點 請參閱停用 Postgres 節點。

    如果您已使用網路儲存空間，就不必安裝新的節點。詳情請見 必須升級至 Postgres 9.6，進一步瞭解詳情。

如要稍後再復原更新，請按照 復原 4.19.01 版。

從本機存放區更新至 4.19.01

如果您的 Edge 節點在防火牆後面，或以其他方式遭禁止存取 透過網際網路取得 Apigee 存放區，接著您可以從本機存放區執行更新 或鏡像功能

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

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

如何從本機 4.19.01 存放區更新：

  1. 如果您目前使用的是 Postgres 主待命複製功能，請安裝新的 Postgres 待命節點，如安裝新 Postgres 一文所述 待命節點

    如果您已使用網路儲存空間，就不必安裝新的節點。請改為 Postgres 所用資料儲存庫的網路快照。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

  2. 按照「建立本機 Apigee 存放區」一節的說明，建立本機 4.19.01 存放區於 安裝 Edge apigee-setup 公用程式。
  3. 如要從 .tar 檔案安裝 apigee-service：
    1. 在含有本機存放區的節點上，使用下列指令來封裝本機存放區 複製到名為 /opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz 的單一 .tar 檔案： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. 將 .tar 檔案複製到要更新 Edge 的節點。例如，請複製到 新節點上的 /tmp 目錄。
    3. 在新節點上，將檔案卸離至 /tmp 目錄： 
      tar -xzf apigee-4.19.01tar.gz

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

    4. 從 /tmp/repos 安裝 Edge apigee-service 公用程式和依附元件：
      sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  4. 使用 Nginx 網路伺服器安裝 apigee-service：
    1. 按照「使用 Nginx 從存放區安裝」一節的說明，設定 Nginx 網路伺服器 webserver"「Install the Edge apigee-setup 公用程式。
    2. 在遠端節點上，將 Edge bootstrap_4.19.01.sh 檔案下載至 /tmp/bootstrap_4.19.01.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

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

    3. 在遠端節點上安裝 Edge apigee-service 公用程式並 依附元件： 
      sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

  5. 使用 apigee-service 更新 apigee-setup 公用程式： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. 在管理伺服器上更新 apigee-validate 公用程式： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  7. 更新 apigee-provision 公用程式： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. 請依下列說明，在節點上執行 update 公用程式。 機器更新順序： 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    設定檔的唯一規定是設定檔必須可供存取 可由「apigee」讀取內容。

    使用 -c 選項指定要更新的元件。系統會列出 元件包括：

    • 「cs」= Cassandra
    • 「邊緣」=所有 Edge UI 以外的所有邊緣元件。「邊緣」元件包括 Management Server、訊息處理器、路由器、QPID Server、Edge Postgres Server。
    • 「ldap」= OpenLDAP
    • 「ps」= postgresql
    • 「qpid」= Qpidd
    • 「Sso」= 邊緣單一登入 (SSO)
    • 「ui」= 邊緣 UI
    • 「zk」= 祖母

    您可以設定 component，對所有元件執行 update.sh 只要您有 Edge 全包式 (AIO) 組態設定檔，您就會看到「all」。例如：

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. 請在所有執行該元件的機器上重新啟動 Edge UI 元件 (如果尚未重新啟動)： 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  10. 在管理頁面執行 apigee-validate 公用程式，測試更新作業 伺服器，如「測試安裝」一節中所述。
  11. 如果您已安裝新的 Postgres 待命節點，請按照下文說明停用該節點 「停用 一個 Postgres 節點

    如果您已使用網路儲存空間，就不必安裝新的節點。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

如要在之後復原更新，請使用復原 4.19.01 版所述的程序。

機器更新順序

您在 Edge 設定中更新機器的順序相當重要。最常出現 更新時的重要注意事項如下：

  • 您必須先更新「所有」Cassandra 和 ZooKeeper 節點，才能更新任何節點 和其他節點
  • 適用於具備多個 Edge 元件 (管理伺服器、訊息處理器) 的任何機器 路由器、QPID 伺服器，而非 Postgres 伺服器)，使用「-c 邊緣」或是更新
  • 如果步驟指定應在多部機器上執行，請在該步驟中執行 指定的機器順序
  • 更新營利設定無須另外執行一個步驟。這個清單會在您指定「-c」時更新 邊緣」如果有需要 SQL 指令的分析工作負載 則 BigQuery 可能是最佳選擇
，瞭解如何調查及移除這項存取權。

1 個節點獨立昇級授權

  1. 更新 Cassandra 和 ZooKeeper： 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. 更新 Qpid： 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. 更新 LDAP： 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. 停止 Postgres Server、Qpid 伺服器和 PostgreSQL： 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  5. 更新 postgresql： 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. 更新其餘 Edge 元件： 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. 更新 Edge UI： 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (如果您已安裝 apigee-adminapi) 更新 apigee-adminapi 公用程式： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (如果您已安裝 Edge SSO) 更新邊緣單一登入 (SSO)： 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    其中 sso_config_file 是您在記錄專案時建立的設定檔 已安裝單一登入 (SSO)。

  10. 重新啟動 Edge UI 元件： 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

雙節點獨立昇級

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

  1. 在機器 1 上更新 Cassandra 和 ZooKeeper： 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. 更新機器 2 的 Qpid： 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. 在電腦 1 上更新 LDAP： 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. 更新裝置 1 上的邊緣元件： 
    /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. (如果您已安裝 Edge SSO) 在電腦 1 上更新邊緣單一登入 (SSO)： 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    其中 sso_config_file 是您在記錄專案時建立的設定檔 已安裝單一登入 (SSO)。

  8. 在機器 2 上更新 postgresql：
    1. 停止 Postgres Server、Qpid 伺服器和 postgresql：
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. 更新 postgresql： 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. 更新裝置 2 上的邊緣元件： 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. 在電腦 1 上重新啟動 Edge UI 元件： 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

升級 5 個節點

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

  1. 確認您已按照下列說明安裝新的 Postgres 待命節點： 安裝 新的 Postgres 待命節點

    如果您已使用網路儲存空間，就不必安裝新的節點。請改為 Postgres 所用資料儲存庫的網路快照。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

  2. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper： 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. 更新機器 4 和 5 的 Qpid： 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. 在電腦 1 上更新 LDAP： 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 更新機器 1、2、3 上的邊緣元件： 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -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. (如果您已安裝 Edge SSO) 在電腦 1 上更新邊緣單一登入 (SSO)： 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    其中 sso_config_file 是您在記錄專案時建立的設定檔 已安裝單一登入 (SSO)。

  9. 更新機器 4 和 5：
    1. 在機器 4 上停止 Postgres 伺服器和 Qpid 伺服器：
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. 在電腦 5 上停止 Postgres 伺服器、Qpid 伺服器和 postgresql： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. 如果已安裝，請在新待命上停止 Postgres 伺服器和 postgresql 您為復原作業新增的節點： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. 在機器 4 上更新 postgresql： 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. 在機器 5 上更新 postgresql： 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. 在機器 4 和 5 上啟動 Postgres 伺服器和 Qpid 伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    7. 在機器 5 上執行下列指令，將 Postgres 設為待命節點： 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    8. 在兩個伺服器上發出下列指令碼，驗證複製狀態。 應在兩台伺服器上顯示相同的結果，以確保複製成功：
      • 在機器 4 (主要節點) 中，執行下列指令： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        驗證其是否為主版本。

      • 機器 5 上的待命節點： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        驗證裝置是否為待機。

  10. 更新機器 4，5 上的 Edge 元件： 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. 確認您已按照說明停用新的待命節點 「停用 一個 Postgres 節點

    如果您已使用網路儲存空間，就不必安裝新的節點。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

  12. 在電腦 1 上重新啟動 Edge UI 元件： 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

9 個節點叢集升級作業

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

  1. 確認您已按照說明安裝新的 Postgres 待命節點 說明：安裝 新的 Postgres 待命節點

    如果您已使用網路儲存空間，就不必安裝新的節點。請改為 Postgres 所用資料儲存庫的網路快照。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

  2. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper： 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. 更新機器 6 和 7 的 Qpid： 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. 在電腦 1 上更新 LDAP： 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 請按照下列步驟更新機器 6、7、1、4 和 5 上的 Edge 元件： 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -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. (如果您已安裝 Edge SSO) 在電腦 1 上更新邊緣單一登入 (SSO)： 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    其中 sso_config_file 是您在記錄專案時建立的設定檔 已安裝單一登入 (SSO)。

  9. 更新機器 8 和 9：
    1. 在機器 8 上停止 Postgres 伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. 在機器 9 上停止 Postgres 伺服器和 postgresql： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. 在機器 6 和 7 上停止 Qpid 伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. 如果已安裝，請在新待命上停止 Postgres 伺服器和 postgresql 您為復原作業新增的節點： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. 在機器 8 上更新 postgresql： 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. 在機器 9 上更新 postgresql： 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. 在機器 8 和 9 上啟動 Postgres 伺服器伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. 在機器 6 和 7 上啟動 Qpid 伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. 在機器 9 上執行下列指令，將 Postgres 設為待命節點： 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. 在兩個伺服器上發出下列指令碼，驗證複製狀態。 應在兩台伺服器上顯示相同的結果，以確保複製成功：
      • 在機器 8 中，主要節點，執行下列指令： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        驗證其是否為主版本。

      • 機器 9 上的待命節點： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        驗證裝置是否為待機。

  10. 更新裝置 8 和 9 上的 Edge 元件： 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. 確認您已按照說明停用新的待命節點 「停用 一個 Postgres 節點。

    如果您已使用網路儲存空間，就不必安裝新的節點。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

  12. 在電腦 1 上重新啟動 Edge UI 元件： 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

13 個節點叢集升級

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

  1. 確認您已按照說明安裝新的 Postgres 待命節點 說明：安裝 新的 Postgres 待命節點

    如果您已使用網路儲存空間，就不必安裝新的節點。請改為 Postgres 所用資料儲存庫的網路快照。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

  2. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper： 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. 更新機器 12 和 13 的 Qpid： 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. 在電腦 4 和 5 上更新 LDAP： 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. 請依照下列順序更新機器 12、13、6、7、10 和 11 上的 Edge 元件： 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. 更新機器 6 和 7 的 UI： 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (如果您已安裝 apigee-adminapi) 在電腦 6 和 7 上更新 apigee-adminapi 公用程式： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (如果您已安裝 Edge SSO) 在電腦 6 和 7 上更新邊緣單一登入 (SSO)： 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    其中 sso_config_file 是您在記錄專案時建立的設定檔 已安裝單一登入 (SSO)。

  9. 更新機器 8 和 9：
    1. 在機器 8 上停止 Postgres 伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. 在機器 9 上停止 Postgres 伺服器和 postgresql： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. 在機器 12 與 13 上停止 Qpid 伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. 如果已安裝，請在新待命上停止 Postgres 伺服器和 postgresql 您為復原作業新增的節點： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. 在機器 8 上更新 postgresql： 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. 在機器 9 上更新 postgresql： 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. 在機器 8 和 9 上啟動 Postgres 伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. 在機器 12 和 13 上啟動 Qpid 伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. 在機器 9 上執行下列指令，將 Postgres 設為待命節點： 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. 在兩個伺服器上發出下列指令碼，驗證複製狀態。 應在兩台伺服器上顯示相同的結果，以確保複製成功：
      • 在機器 8 中，主要節點，執行下列指令： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        驗證其是否為主版本。

      • 機器 9 上的待命節點： 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        驗證裝置是否為待機。

  10. 更新裝置 8 和 9 上的 Edge 元件： 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. 確認您已按照說明停用新的待命節點 「停用 一個 Postgres 節點。

    如果您已使用網路儲存空間，就不必安裝新的節點。詳情請參閱必須升級至 Postgres 9.6 的相關說明。

  12. 在機器 6 和 7 上重新啟動 Edge UI 元件： 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

12 個節點叢集升級

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

  1. 確認您已按照說明安裝新的 Postgres 待命節點 於「安裝 新的 Postgres 待命節點

    如果您已使用網路儲存空間，就不必安裝新的節點。請改為 Postgres 所用資料儲存庫的網路快照。詳情請見 必須升級至 Postgres 9.6，進一步瞭解詳情。

  2. 更新 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
  3. 更新 qpidd：
    1. 資料中心 1 中的機器 4、5 部
      1. 在機器 4 上更新 qpidd： 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. 使用機器 5 重複步驟 1。
    2. 資料中心 2 中的機器 10、11
      1. 在機器 10 上更新 qpidd ： 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. 在機器 11 上重複執行步驟 1。
  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、1、2、3 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. 資料中心 2 中的機器 10、11、7、8、9 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. 更新 UI：
    1. 資料中心 1 中的機器 1： 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. 資料中心 2 中的機器 7： 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -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. (如果您已安裝 Edge SSO) 更新邊緣單一登入 (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

      3. 其中 sso_config_file 是您在記錄專案時建立的設定檔 已安裝單一登入 (SSO)。

  9. 在資料中心 2 中更新資料中心 1 和 12 中的機器 6：
    1. 在機器 6 上停止 Postgres 伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. 在機器 12 上停止 Postgres 伺服器和 postgresql： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. 在機器 4、5、10 和 11 上停止 Qpid 伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. 如果已安裝，請在新待命上停止 Postgres 伺服器和 postgresql 您為復原作業新增的節點： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. 在機器 6 上更新 postgresql： 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. 在機器 12 上更新 postgresql： 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. 在機器 6 和 12 上啟動 Postgres 伺服器伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. 在機器 4、5、10 和 11 上啟動 Qpid 伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. 在機器 12 上執行下列指令，將 Postgres 設為待命節點： 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. 在兩個伺服器上發出下列指令碼，驗證複製狀態。 兩台伺服器上應該顯示相同的結果， 複製：

      在機器 6 (主要節點) 上，執行下列指令：

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

      驗證其是否為主版本。

      機器 12 上的待命節點：

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

      驗證裝置是否為待機。

  10. 更新裝置 6 和 12 上的 Edge 元件： 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. 確認您已按照下列說明停用新的待命節點： 停用 Postgres 節點。

    如果您已使用網路儲存空間，就不必安裝新的節點。詳情請見 必須升級至 Postgres 9.6，進一步瞭解詳情。

  12. 在機器 1 和 7 上重新啟動 Edge UI 元件： 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

非標準升級

如果您有非標準設定，請在下方更新 Edge 元件 順序：

  1. ZooKeeper
  2. Cassandra
  3. qpidd、ps
  4. LDAP
  5. 邊緣，表示「-c 邊緣」依序排列所有節點和含有 Qpid 伺服器的節點 Edge Postgres Server、管理伺服器、訊息處理器和路由器。
  6. Edge UI
  7. apigee-adminapi
  8. 邊緣單一登入 (SSO)

完成更新後，請務必在所有執行中的機器重新啟動 Edge UI 元件 基礎架構