將 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 版，建議您執行升級特定軟體的特定步驟。必要步驟取決於目前版本。請參閱下表，瞭解各種需要補充步驟的軟體。本頁後續章節會提供每項軟體的詳細討論和具體步驟。

自動傳播資源設定

如果您在 /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 升級後，下列管理功能會降低： Management API：透過環境建立 API 產品 Management API，用於透過環境更新 API 產品 用於刪除機構的 Management API

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

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

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

執行階段狀態	管理狀態
執行階段完整功能	Management API 降級： Drupal 7 開發人員入口網站的 SmartDoc 功能不會顯示任何資料

步驟 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 版本 升級自：

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

使用 Apigee mTLS 更新

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

• 解除安裝 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 個節點設定完成。

升級到零停機時間的關鍵，在於從負載中逐一移除每個路由器，一次一個 。接著在路由器上更新路由器和任何其他元件，這些元件與路由器相同。 然後將路由器加回負載平衡器

1. 按照安裝程序的正確順序更新機器 機器更新順序。
2. 需要更新路由器時，請選取任一路由器並設為無法連線，如下所示： 如啟用/停用伺服器中所述 (訊息處理器/路由器) 可連性。
3. 在與路由器相同的機器上，更新所選路由器和所有其他 Edge 元件。 所有邊緣設定會在相同節點上顯示路由器和訊息處理器。
4. 重新連線至路由器。
5. 針對其餘的路由器，重複步驟 2 到 4。
6. 請繼續為安裝中其餘的機器進行更新。

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

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

使用靜音設定檔

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

更新為 4.52.02 版 (位於具備外部網際網路連線的節點)

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

1. 如果有建立要執行修復作業的 cron 工作，請停用這些工作 Cassandra 直到更新完成為止。
2. 以根權限登入節點，安裝邊緣 RPM。
3. 安裝 yum-utils 和 yum-plugin-priorities：

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. 按照安裝 使用 Edge Apigee-setup 公用程式。
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 以外的所有 Edge 元件： Management Server、Message 處理器、路由器、QPID Server、Postgres Server
        • ldap：OpenLDAP
        • ps：postgresql
        • qpid：qpidd
        • sso：Apigee 單一登入 (如果已安裝單一登入)
        • ue：新版 Edge UI
        • ui：傳統版 Edge UI
        • zk：Zookeeper
      • configFile 與您過去使用的設定檔相同 定義您的邊緣 元件。

      您可以設定 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.02 版。

從本機存放區更新至 4.52.02

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

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

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

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

1. 按照「建立本機 Apigee 存放區」中的說明建立本機 4.52.02 存放區於 安裝 Edge apigee-setup 公用程式。
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

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

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

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

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

3. 使用 Nginx 網路伺服器安裝 apigee-service：
   1. 按照「使用 Nginx 從存放區安裝」一節的說明，設定 Nginx 網路伺服器 webserver"「Install the Edge apigee-setup 公用程式。
   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 伺服器、Postgres 伺服器
     • ldap：OpenLDAP
     • ps：postgresql
     • qpid：qpidd
     • sso：Apigee 單一登入 (如果已安裝單一登入)
     • ue 新增 Edge UI
     • ui：傳統版 Edge UI
     • zk：Zookeeper
   • configFile 與您過去使用的設定檔相同 定義 Edge 元件 閱讀進度

   您可以設定 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.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

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

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

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

3. 在電腦 9 上更新 Postgres：

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

4. 在電腦 1 上更新 LDAP：

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

5. 請依照下列順序更新機器 6、7、8、9、1、4 和 5 上的 Edge 元件：

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

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

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

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

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

8. (如果您已安裝 apigee-adminapi) 在電腦 1 上更新 apigee-adminapi 公用程式：

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

9. (如果您已安裝 Apigee 單一登入) 在機器 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. 在機器 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 的新版使用者介面 (ue) 或傳統版 UI (ui)，並 7：

   /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

    • 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 的機器 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

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

9. 重新啟動新版 Edge UI (edge-management-ui) 或傳統版 Edge UI 機器 1 和 7 上的 (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. 邊緣，表示「-c 邊緣」依序排列所有節點和含有 Qpid 伺服器的節點 Edge Postgres Server、管理伺服器、訊息處理器和路由器。
6. qpidd
7. Edge UI (傳統版或新版)
8. apigee-adminapi
9. Apigee 單一登入 (SSO)

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