將 Apigee Edge 4.51.00 或 4.52.00 或 4.52.01 更新至 4.52.02

Apigee 支援直接從 4.51.00、4.52.00 或 4.52.01 版升級至 4.52.02 版。本頁說明如何執行這類升級作業。

可執行更新的使用者

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

安裝邊緣 RPM 後，任何人都能設定。

您需要更新哪些元件

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

更新必要條件

升級 Apigee Edge 前，請確認以下事項：

  • 備份所有節點
    基於安全考量，建議您在更新前執行所有節點的完整備份。按照目前 Edge 版本的程序執行備份。

    這樣系統才能備妥備份方案，以防更新至新版本時無法正常運作。如要進一步瞭解備份，請參閱備份與還原。

  • 確保 Edge 正在執行
    使用下列指令，在更新程序期間確保 Edge 已啟動且正在執行： 
    /opt/apigee/apigee-service/bin/apigee-all status
  • 確認 Cassandra 壓縮策略為 LeveledCompactionStrategy
    確保如變更 Cassandra 壓縮策略中所述，將 Cassandra 壓縮策略設為 LeveledCompactionStrategy。

升級時應考慮的特殊步驟

如要升級至 Private Cloud 4.52.02 版，建議您執行升級特定軟體的特定步驟。必要步驟取決於目前版本。請參閱下表，瞭解各種需要補充步驟的軟體。本頁後續章節會提供每項軟體的詳細討論和具體步驟。

目前版本 需要特殊步驟才能升級至 4.52.02 的軟體
4.52.01 Cassandra
4.52.00 Cassandra、Zookeeper、Qpid
4.51.00 Cassandra、Zookeeper、Qpid、Postgres

自動傳播資源設定

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

必須升級至 Cassandra 3.11.16

Apigee Edge for Private Cloud 4.52.02 包含 Cassandra 升級至 3.11.16 版。Cassandra 是 Apigee 的重要元件，本次升級也包括在用於查詢及寫入 Cassandra 的各種執行階段和管理元件中的驅動程式軟體更新。

由於這是重大升級，因此需要對 Cassandra 中的 Apigee 資料模型進行特定變更，以確保在新版本中達到最佳效能。雖然這些異動幅度最少，但升級程序會破壞特定管理 API，進而影響 Apigee 使用者介面和開發人員入口網站。下方文件列出了無法運作的 API，並概述服務中斷開始和結束時的步驟。重要的是，升級期間應不會中斷執行階段流量。

高階復原作業

一次套用一個 Cassandra 升級節點。一旦節點更新，某些結構定義變更就會生效，但無法直接復原。請詳閱「復原」一節，瞭解根據叢集升級數量而定，可用的技巧各有不同。

如果您需要在整個 Cassandra 叢集升級後復原升級作業，只能選擇還原備份。做好萬全準備，並熟悉 Cassandra 備份還原功能。如果還原 VM 層級快照的速度比 Apigee 備份更快，請使用 VM 快照將 Cassandra VM 還原至先前的狀態。

詳情請參閱復原 Cassandra 3.11.16 更新一節。

在開發人員入口網站中記錄 API

Apigee Drupal 開發人員入口網站提供多種用來記錄 API 的功能。儘管建議您從 Drupal 7 型開發人員入口網站上調用此入口網站，但如果您仍在使用 Drupal 7 的開發人員入口網站，也改為使用 SmartDoc 功能，則適用 使用 SmartDoc API 文件。如果您使用的是較新版本的開發人員入口網站，本次升級期間您的 API 說明文件不會受到影響。

將 Apigee 升級至 4.52.02 版後，使用 Drupal 7 開發人員入口網站 SmartDoc 功能建立的任何 API 模型都不會自動遷移至新版本。請使用開發人員入口網站手動匯出每個模型，然後在完成升級後再次匯入。

以下各節使用的術語

執行階段：執行階段會處理執行階段 Proxy 流量的處理。其中包含路由器和訊息處理器執行的所有作業，可有效處理現有 Proxy 的執行階段 API 要求。但不包含新 Proxy 的部署或新 Proxy 修訂版本。

管理：包括 Apigee Edge 系統的管理作業。這包括但不限於部署、修改應用程式、產品、目標伺服器和 KeyStore 等。所有管理 API (以及其用戶端，例如 Apigee UI 和開發人員入口網站) 都包含在內。

下列每個步驟都會在升級程序的各個階段中，說明執行階段和管理的狀態。請注意，升級期間不會影響執行階段流量。不過，少數管理 API 和開發人員入口網站功能也會中斷。

步驟 0：開始狀態

  1. 在 Apigee 中以 2.1.22 版執行的 Cassandra。
  2. Edge for Private Cloud 4.52.02 元件：
    • 管理伺服器透過舊版的竊取通訊協定與 Cassandra 通訊。
    • 執行階段伺服器 (訊息處理器和路由器) 透過舊版的竊取通訊協定與 Cassandra 通訊。
這個階段的執行階段狀態 這個階段的管理狀態
執行階段完整功能 管理功能完全正常運作

步驟 1：為升級做好準備

您除了可以建立的標準檔案 (例如可讓您啟用元件升級的 Apigee 標準設定檔) 以外，下面還有下列步驟。

  1. 將 Cassandra 變更為使用 LeveledCompactionStrategy。
  2. 使用 Apigee 備份 Cassandra。
  3. 為 Cassandra 節點拍攝 VM 快照 (如果可行)。
  4. 在 /opt/apigee/apigee-cassandra/cass_upgrade.conf 的每個 Cassandra 節點上，建立含有下列內容的 Cassandra 升級設定檔： 
    # IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    如果無法在 /opt/apigee/apigee-cassandra/cass_upgrade.conf 建立檔案，請在各個 Cassandra 節點上建立含有相同內容的檔案 /opt/silent.conf。
  • 如果您是使用 Apigee Drupal 7 開發人員入口網站的 SmartDoc 功能，請透過開發人員入口網站以 JSON 格式下載每個模型，以匯出每個模型。更新管理伺服器後，這些模型必須重新匯入 Apigee。
  • 確保所有 Edge for Private Cloud 4.52.02 元件都能從所有 Edge 的 Private Cloud 4.52.02 元件存取通訊埠 9160 和 9042 (如果尚未存取)。詳情請參閱通訊埠需求。

步驟 2：升級所有 Cassandra 節點

  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 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
這個階段的執行階段狀態 這個階段的管理狀態
執行階段完整功能 Cassandra 升級後，下列管理功能會降低：

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

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
執行階段狀態 管理狀態
執行階段完整功能 Management API 降級：

步驟 3a：[選用] 匯入先前匯出的 SmartDoc

當所有管理伺服器升級後，您就可以匯入您在步驟 1 匯出的 SmartDoc 模型。您可以稍後再決定。

執行階段狀態 管理狀態
執行階段完整功能 管理功能完全正常運作

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

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
執行階段狀態 管理狀態
執行階段完整功能 管理功能完全正常運作

步驟 5：為 Private Cloud 4.52.02 元件升級所有其餘的 Edge

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

在這個階段，如果您要從 Private Cloud 4.52.01 之前的 Edge 版本升級，而且需要執行其他升級 Qpid 或 Postgres 的步驟，請按照相關步驟操作。

執行階段狀態 管理狀態
執行階段完整功能 管理功能完全正常運作

步驟 6：升級後的步驟

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

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

執行下列指令，從 Cassandra 叢集中刪除舊的未使用的資料表。在此之前，您無法使用 Cassandra 的某些功能 (例如設定新驗證機制 - 舊驗證機制仍可運作)。這項指令只能在叢集內的 1 個節點上執行：

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

完成步驟 3a (如果您尚未完成的話)。

執行階段狀態 管理狀態
執行階段完整功能 管理功能完全正常運作

必須升級至 Zookeeper 3.8.3

雖然 Private Cloud 4.52.02 的 Edge 不會包含 Zookeeper 版本，但如果你要升級至 4.52.01 以下版本，就必須按照步驟升級 Zookeeper。

  • 如要從 Edge for Private Cloud 4.51.00 或 4.52.00 升級，請參閱必須升級至 Zookeeper 3.8.3 中的步驟，以升級 Zookeeper。
  • 如果您是從 Edge for Private Cloud 4.52.01 版升級，應該已經使用 Zookeeper 3.8.3 版，而不必採取任何特殊步驟來升級 Zookeeper。

必須升級至 Postgres 14

  • 如要將 Private Cloud 4.51.00 升級至 4.52.02，您必須按照相關步驟升級 Postgres，但 Private Cloud 4.52.02 的 Edge 並未包含 Postgres 升級作業。從 Private Cloud 4.51.00 升級至 4.52.02 時，必須完成額外的 Postgres 升級步驟。請參閱「升級至 Postgres 14 的必要升級」一節。
  • 如要將 Private Cloud 4.52.00 或 4.52.01 升級至 4.52.02，則無須採取額外的 Postgres 升級步驟。

必須升級至 Qpid J-Broker

雖然 Private Cloud 4.52.02 的 Edge 不會升級到 QPID，但若您從 4.52.01 以下版本升級，就必須按照步驟升級 QPID。

  • 如要將 Private Cloud 4.51.00 或 4.52.00 升級至 4.52.02，則須按照額外的 QPID 升級步驟操作。如要從 4.51.00 或 4.52.00 升級至 4.52.02，請參閱升級 Qpid 一節。
  • 如果從 Private Cloud 4.52.01 升級至 4.52.02，您應已使用最新版本的 Qpid Broker，無需進行其他 QPID 升級步驟。

新版 Edge UI

本節列出 Edge UI 的注意事項。詳情請參閱「Private Cloud 適用的新 Edge UI」。

安裝 Edge UI

完成初始安裝程序後，Apigee 建議您安裝 Edge UI，這是適用於 Private Cloud 的 Apigee Edge 開發人員和管理員的強化使用者介面。

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

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

更新 Edge UI

如要更新 Edge UI 元件，請考慮升級所用私有雲的 Edge 版本：

使用 Apigee mTLS 更新

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

將更新復原

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

如果作業失敗，您就必須將更新復原為先前版本，請參閱復原 4.52.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. 請繼續為安裝中其餘的機器進行更新。

請在更新前後進行下列操作：

使用靜音設定檔

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

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

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

  1. 如果有的話，請將所有設定為在 Cassandra 上執行修復作業的 cron 工作停用，直到更新完成為止。
  2. 以根權限登入節點，安裝邊緣 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.02.sh 檔案下載至 /tmp/bootstrap_4.52.02.sh： 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. 執行下列指令，安裝 Edge 4.52.02 apigee-service 公用程式和依附元件： 
      sudo bash /tmp/bootstrap_4.52.02.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. 更新管理 Server 上的 apigee-validate 公用程式，如以下範例所示： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. 更新管理 Server 上的 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 Server、Postgres Server
        • ldap：OpenLDAP
        • ps：postgresql
        • qpid：qpidd
        • sso：Apigee 單一登入 (如果已安裝單一登入)
        • 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-ui restart
    8. 按照「測試安裝」一節的說明，在管理伺服器中執行 apigee-validate 公用程式來測試更新。

如果您之後決定復原更新，請使用復原 4.52.02 版所述的程序。

從本機存放區更新至 4.52.02

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

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

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

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

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

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

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

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

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

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

    3. 在遠端節點上，安裝 Edge apigee-setup 公用程式和依附元件： 
      sudo bash /tmp/bootstrap_4.52.02.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. 更新管理 Server 上的 apigee-validate 公用程式，如以下範例所示： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. 更新管理 Server 上的 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 Server、Postgres Server
      • ldap：OpenLDAP
      • ps：postgresql
      • qpid：qpidd
      • sso：Apigee 單一登入 (如果已安裝單一登入)
      • 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 元件 (如果尚未重新啟動)： 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. 按照「測試安裝」一節的說明，在管理伺服器中執行 apigee-validate 公用程式來測試更新。

如果您之後決定復原更新，請使用復原 4.52.02 版所述的程序。

機器更新順序

請務必按照以下順序更新 Edge 安裝過程中的機器：

  • 您必須先更新「所有」Cassandra 和 ZooKeeper 節點，才能更新任何其他節點。
  • 針對具有多個 Edge 元件 (管理伺服器、訊息處理器、路由器、QPID 伺服器，但不含 Postgres 伺服器) 的任何機器，使用 -c edge 選項一次更新所有項目。
  • 如果步驟指定要在多部機器上執行，請按照指定的機器順序執行。
  • 更新營利設定無須另外執行一個步驟。指定 -c edge 選項時，系統會更新這項資訊。

1 個節點獨立昇級授權

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

  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

雙節點獨立昇級

針對雙節點獨立安裝更新下列元件：

如需 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 上的邊緣元件： 
    /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 單一登入) 在機器 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，則請在適當機器上更新 ue 元件 (非機器 1)： 
      /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 單一登入) 在機器 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，請在適當的機器上重新啟動 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. 在機器 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 上更新新版使用者介面 (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 單一登入) 在機器 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 節點的叢集安裝作業更新下列元件：

如需 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 單一登入) 在機器 6 和 7 上更新 Apigee 單一登入： 
    /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 單一登入) 更新 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

      3. 其中 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 邊緣」設定檔 (順序為：具有 Qpid 伺服器的節點、Edge Postgres Server、管理伺服器、訊息處理器和路由器)。
  6. Qpidd
  7. Edge UI (傳統版或新版)
  8. apigee-adminapi
  9. Apigee 單一登入 (SSO)

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