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:開始狀態
- 在 Apigee 中以 2.1.22 版執行的 Cassandra。
- Edge for Private Cloud 4.52.02 元件:
- 管理伺服器透過舊版的竊取通訊協定與 Cassandra 通訊。
- 執行階段伺服器 (訊息處理器和路由器) 透過舊版的竊取通訊協定與 Cassandra 通訊。
這個階段的執行階段狀態 | 這個階段的管理狀態 |
---|---|
執行階段完整功能 | 管理功能完全正常運作 |
步驟 1:為升級做好準備
您除了可以建立的標準檔案 (例如可讓您啟用元件升級的 Apigee 標準設定檔) 以外,下面還有下列步驟。
- 將 Cassandra 變更為使用 LeveledCompactionStrategy。
- 使用 Apigee 備份 Cassandra。
- 為 Cassandra 節點拍攝 VM 快照 (如果可行)。
-
在
/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 節點
-
逐一升級所有區域中的所有 Cassandra 節點。請在各節點上執行下列指令:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
-
更新節點後,請在節點上執行下列指令,先執行一些驗證作業,然後再繼續操作:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
-
上述指令會輸出下列幾行內容:
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 版本:
- 從 4.51.00 至 4.52.00 (已安裝新版 Edge UI):請參閱本節的升級操作說明 (適用於
edge-management-ui
元件)。
使用 Apigee mTLS 更新
如要更新 Apigee mTLS,請按照下列步驟操作:
將更新復原
如果更新失敗,您可以嘗試修正問題,然後再次執行 update.sh
。您可以多次執行更新,並從上次中斷處繼續更新。
如果作業失敗,您就必須將更新復原為先前版本,請參閱復原 4.52.00 版的詳細說明。
記錄更新資訊
根據預設,update.sh
公用程式會將記錄資訊寫入:
/opt/apigee/var/log/apigee-setup/update.log
如果執行 update.sh
公用程式的使用者無法存取該目錄,便會將記錄以名為 update_username.log
的檔案寫入 /tmp
目錄。
如果使用者無法存取 /tmp
,update.sh
公用程式就會失敗。
零停機時間更新
零停機時間更新或滾動式更新可讓您在不啟動 Edge 的情況下更新 Edge 安裝作業。
零停機時間更新只能透過 5 個節點設定完成。
升級到零停機時間的關鍵,在於從負載平衡器中逐一移除每個路由器,一次一個。接著,在與路由器相同的機器中更新路由器和任何其他元件,然後將路由器新增回負載平衡器。
- 按照「機器更新順序」的說明,以正確的安裝順序更新機器。
- 需要更新路由器時,請選取任一路由器,使其無法連上,如啟用/停用伺服器 (訊息處理器/路由器) 可連性中所述。
- 在與路由器相同的機器上,更新所選路由器和所有其他 Edge 元件。所有邊緣設定會在相同節點上顯示路由器和訊息處理器。
- 重新連線至路由器。
- 針對其餘的路由器,重複步驟 2 到 4。
- 請繼續為安裝中其餘的機器進行更新。
請在更新前後進行下列操作:
- 在合併的路由器和訊息處理器節點上:
- 更新前,請執行下列步驟:
- 將路由器設為無法連線。
- 將無法連線至訊息處理器設為連線。
- 更新完成後,請執行下列步驟:
- 請連線至訊息處理器。
- 將路由器設為可連線。
- 更新前,請執行下列步驟:
- 在單一路由器節點上:
- 在更新前,請將路由器設為無法連上。
- 更新後,請將路由器設為可連線。
- 在單一訊息處理器節點上:
- 更新前,請將訊息處理器設為無法存取。
- 更新後,請將訊息處理器設為可連線。
使用靜音設定檔
您必須將靜音設定檔傳送至 update 指令。靜音設定檔應與您安裝 Edge 4.50.00 或 4.51.00 時使用的設定檔相同。
請在有外部網際網路連線的節點上更新至 4.52.02
請使用下列程序更新節點上的 Edge 元件:
- 如果有的話,請將所有設定為在 Cassandra 上執行修復作業的
cron
工作停用,直到更新完成為止。 - 以根權限登入節點,安裝邊緣 RPM。
- 安裝
yum-utils
和yum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- 按照安裝 Edge apigee-setup 公用程式停用 SELinux。
- 如果您是在 Oracle 7.x 上安裝,請執行下列指令:
sudo yum-config-manager --enable ol7_optional_latest
- 如果您是在 AWS 上安裝,請執行以下
yum-configure-manager
指令:yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
如果目前使用 Edge 4.51.00:
- 將 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
- 執行下列指令,安裝 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。
- 使用
apigee-service
更新apigee-setup
公用程式,如以下範例所示:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- 更新管理 Server 上的
apigee-validate
公用程式,如以下範例所示:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- 更新管理 Server 上的
apigee-provision
公用程式,如以下範例所示:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- 執行下列指令,在節點上執行
update
公用程式:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
請按照「機器更新順序」中所述的順序執行。
在此情況下:
- component 是要更新的邊緣元件。可能的值包括:
cs
:Cassandraedge
:Edge UI 以外的所有邊緣元件:管理伺服器、訊息處理器、路由器、QPID Server、Postgres Serverldap
:OpenLDAPps
:postgresqlqpid
:qpiddsso
:Apigee 單一登入 (如果已安裝單一登入)ue
:新版 Edge UIui
:傳統版 Edge UIzk
: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
- component 是要更新的邊緣元件。可能的值包括:
- 請在執行該元件的所有節點上重新啟動 Edge UI 元件 (如果尚未重新啟動):
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 按照「測試安裝」一節的說明,在管理伺服器中執行
apigee-validate
公用程式來測試更新。
- 將 Edge
如果您之後決定復原更新,請使用復原 4.52.02 版所述的程序。
從本機存放區更新至 4.52.02
如果您的 Edge 節點位於防火牆後面,或是以其他方式禁止透過網際網路存取 Apigee 存放區,您就可以從 Apigee 存放區的本機存放區 (或鏡像) 執行更新作業。
建立本機 Edge 存放區後,您可以透過下列兩種方式從本機存放區更新 Edge:
- 建立存放區的 .tar 檔案,將 .tar 檔案複製到節點,然後從 .tar 檔案更新 Edge。
- 在含有本機存放區的節點中安裝網路伺服器,以便其他節點存取。Apigee 提供 Nginx 網路伺服器供您使用,您也可以使用自己的網路伺服器。
如何從本機 4.52.02 存放區更新:
- 按照「安裝 Edge apigee-setup 公用程式」中的「建立本機 Apigee 存放區」一節所述,建立本機 4.52.02 存放區。
- 如要從 .tar 檔案安裝 apigee-service:
- 在含有本機存放區的節點上,使用下列指令將本機存放區封裝成名為
/opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz
的單一 .tar 檔案:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- 將 .tar 檔案複製到要更新 Edge 的節點。例如,將檔案複製到新節點上的
/tmp
目錄。 - 在新節點上,將檔案解壓縮至
/tmp
目錄:tar -xzf apigee-4.52.02.tar.gz
這個指令會在包含 .tar 檔案的目錄中建立名為
repos
的新目錄。例如/tmp/repos
。 - 從
/tmp/repos
安裝 Edgeapigee-service
公用程式和依附元件:sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
請注意,您會在這個指令中加入存放區目錄的路徑。
- 在含有本機存放區的節點上,使用下列指令將本機存放區封裝成名為
- 使用 Nginx 網路伺服器安裝 apigee-service:
- 按照安裝 Edge apigee-setup 公用程式,按照「使用 Nginx 網路伺服器從存放區安裝」一節的說明,設定 Nginx 網路伺服器。
- 在遠端節點上,將 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 名稱。
- 在遠端節點上,安裝 Edge
apigee-setup
公用程式和依附元件:sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
其中 uName:pWord 是存放區使用者名稱和密碼。
- 使用
apigee-service
更新apigee-setup
公用程式,如以下範例所示:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- 更新管理 Server 上的
apigee-validate
公用程式,如以下範例所示:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- 更新管理 Server 上的
apigee-provision
公用程式,如以下範例所示:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- 依照「機器更新順序」中的說明,在節點上執行
update
公用程式:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
地點:
- component 是要更新的邊緣元件。您通常會更新下列元件:
cs
:Cassandraedge
:Edge UI 以外的所有邊緣元件:管理伺服器、訊息處理器、路由器、QPID Server、Postgres Serverldap
:OpenLDAPps
:postgresqlqpid
:qpiddsso
:Apigee 單一登入 (如果已安裝單一登入)ue
新增 Edge UIui
:傳統版 Edge UIzk
: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
- component 是要更新的邊緣元件。您通常會更新下列元件:
- 請在執行該元件的所有節點中重新啟動 UI 元件 (如果尚未重新啟動):
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- 按照「測試安裝」一節的說明,在管理伺服器中執行
apigee-validate
公用程式來測試更新。
如果您之後決定復原更新,請使用復原 4.52.02 版所述的程序。
機器更新順序
請務必按照以下順序更新 Edge 安裝過程中的機器:
- 您必須先更新「所有」Cassandra 和 ZooKeeper 節點,才能更新任何其他節點。
- 針對具有多個 Edge 元件 (管理伺服器、訊息處理器、路由器、QPID 伺服器,但不含 Postgres 伺服器) 的任何機器,使用
-c edge
選項一次更新所有項目。 - 如果步驟指定要在多部機器上執行,請按照指定的機器順序執行。
- 更新營利設定無須另外執行一個步驟。指定
-c edge
選項時,系統會更新這項資訊。
1 個節點獨立昇級授權
如要將 1 個節點的獨立設定升級至 4.52.02 版:
- 更新所有元件:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (如果您已安裝
apigee-adminapi
) 更新apigee-adminapi
公用程式:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
雙節點獨立昇級
針對雙節點獨立安裝更新下列元件:
如需 Edge 拓撲和節點編號清單,請參閱安裝拓撲。
- 在機器 1 中更新 Cassandra 和 ZooKeeper:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 在機器 2 上更新 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 在裝置 1 上更新 LDAP:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 更新機器 2 和 1 上的邊緣元件:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 在機器 2 上更新 Qpid:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 更新裝置 1 上的 UI:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (如果您已安裝
apigee-adminapi
) 更新裝置 1 上的apigee-adminapi
公用程式:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (如果您已安裝 Apigee 單一登入) 在機器 1 上更新 Apigee 單一登入 (SSO):
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
其中 sso_config_file 是您安裝單一登入 (SSO) 時建立的設定檔。
- 在機器 1 上重新啟動 Edge UI 元件:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
升級 5 個節點
針對 5 節點安裝作業更新下列元件:
如需 Edge 拓撲和節點編號清單,請參閱安裝拓撲。
- 在機器 1、2 和 3 中更新 Cassandra 和 ZooKeeper:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 在機器 4 上更新 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 在機器 5 上更新 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 在裝置 1 上更新 LDAP:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 更新機器 4、5、1、2、3 上的 Edge 元件:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 在機器 4 上更新 Qpid:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 在機器 5 上更新 Qpid:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 更新 Edge UI:
- 傳統版 UI:如果您使用的是傳統版 UI,請更新機器 1 上的
ui
元件,如以下範例所示:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- 新版 Edge UI:如果您安裝了新的 Edge UI,則請在適當機器上更新
ue
元件 (非機器 1):/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- 傳統版 UI:如果您使用的是傳統版 UI,請更新機器 1 上的
- (如果您已安裝
apigee-adminapi
) 更新裝置 1 上的apigee-adminapi
公用程式:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (如果您已安裝 Apigee 單一登入) 在機器 1 上更新 Apigee 單一登入 (SSO):
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
其中 sso_config_file 是您安裝單一登入 (SSO) 時建立的設定檔。
- 重新啟動 UI 元件:
- 傳統版 UI:如果您使用的是傳統版 UI,請在機器 1 上重新啟動
edge-ui
元件,如以下範例所示:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 新版 Edge UI:如果您安裝了新的 Edge UI,請在適當的機器上重新啟動
edge-management-ui
元件 (可能並非機器 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- 傳統版 UI:如果您使用的是傳統版 UI,請在機器 1 上重新啟動
9 個節點叢集升級作業
針對 9 節點的叢集安裝作業更新下列元件:
如需 Edge 拓撲和節點編號清單,請參閱安裝拓撲。
- 在機器 1、2 和 3 中更新 Cassandra 和 ZooKeeper:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 在機器 8 上更新 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 在機器 9 上更新 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 在裝置 1 上更新 LDAP:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 請依照下列順序更新機器 6、7、8、9、1、4 和 5 上的 Edge 元件:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 在機器 6 和 7 中更新 Qpid:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 在機器 1 上更新新版使用者介面 (
ue
) 或傳統版 UI (ui
):/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (如果您已安裝
apigee-adminapi
) 更新電腦 1 上的apigee-adminapi
公用程式:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (如果您已安裝 Apigee 單一登入) 在機器 1 上更新 Apigee 單一登入 (SSO):
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
其中 sso_config_file 是您安裝單一登入 (SSO) 時建立的設定檔。
- 重新啟動 UI 元件:
- 傳統版 UI:如果您使用的是傳統版 UI,請在機器 1 上重新啟動
edge-ui
元件,如以下範例所示:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 新版 Edge UI:如果您安裝了新的 Edge UI,請在適當的機器上重新啟動
edge-management-ui
元件 (可能並非機器 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- 傳統版 UI:如果您使用的是傳統版 UI,請在機器 1 上重新啟動
13 個節點叢集升級
針對 13 節點的叢集安裝作業更新下列元件:
如需 Edge 拓撲和節點編號清單,請參閱安裝拓撲。
- 在機器 1、2 和 3 中更新 Cassandra 和 ZooKeeper:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 在機器 8 上更新 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 在機器 9 上更新 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 在電腦 4 和 5 上更新 LDAP:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 請依照下列順序更新機器 12、13、8、9、6、7、10 和 11 中的 Edge 元件:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 在機器 12 和 13 中更新 Qpid:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 在電腦 6 和 7 上更新新版 UI (
ue
) 或傳統版 UI (ui
):/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (如果您已安裝
apigee-adminapi
) 已更新電腦 6 和 7 上的apigee-adminapi
公用程式:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (如果您已安裝 Apigee 單一登入) 在機器 6 和 7 上更新 Apigee 單一登入:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
其中 sso_config_file 是您安裝單一登入 (SSO) 時建立的設定檔。
- 重新啟動 UI 元件:
- 傳統版 UI:如果您使用的是傳統版 UI,請在電腦 6 和 7 上重新啟動
edge-ui
元件,如以下範例所示:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 新版 Edge UI:如果您安裝了新的 Edge UI,則在機器 6 和 7 上重新啟動
edge-management-ui
元件:/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- 傳統版 UI:如果您使用的是傳統版 UI,請在電腦 6 和 7 上重新啟動
12 個節點叢集升級
針對 12 個節點的叢集安裝作業更新下列元件:
如需 Edge 拓撲和節點編號清單,請參閱安裝拓撲。
- 更新 Cassandra 和 ZooKeeper:
- 在資料中心 1 的機器 1、2 和 3 中:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 在資料中心 2 的機器 7、8 和 9 中
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 在資料中心 1 的機器 1、2 和 3 中:
- 更新 Postgres:
- 資料中心 1 中的機器 6
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 資料中心 2 中的機器 12
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 資料中心 1 中的機器 6
- 更新 LDAP:
- 資料中心 1 中的機器 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 資料中心 2 中的機器 7
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 資料中心 1 中的機器 1
- 更新 Edge 元件:
- 資料中心 1 中的機器 4、5、6、1、2、3
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 資料中心 2 中的機器 10、11、12、7、8、9
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 資料中心 1 中的機器 4、5、6、1、2、3
- 更新 Qpidd:
- 資料中心 1 中的機器 4、5
- 在機器 4 上更新
qpidd
:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 在機器 5 上更新
qpidd
:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 在機器 4 上更新
- 資料中心 2 中的機器 10、11
- 在機器 10 上更新
qpidd
:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 在機器 11 上更新
qpidd
:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 在機器 10 上更新
- 資料中心 1 中的機器 4、5
- 更新新版 UI (
ue
) 或傳統版 UI (ui
):- 資料中心 1 中的機器 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- 資料中心 2 中的機器 7:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- 資料中心 1 中的機器 1:
- (如果您已安裝
apigee-adminapi
) 更新apigee-adminapi
公用程式:- 資料中心 1 中的機器 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- 資料中心 2 中的機器 7:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- 資料中心 1 中的機器 1:
- (如果您已安裝 Apigee 單一登入) 更新 Apigee 單一登入 (SSO):
- 資料中心 1 中的機器 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- 資料中心 2 中的機器 7:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
其中 sso_config_file 是您安裝單一登入 (SSO) 時建立的設定檔。
- 資料中心 1 中的機器 1:
- 在機器 1 和 7 上重新啟動新的 Edge UI (
edge-management-ui
) 或傳統版 Edge UI (edge-ui
) 元件:/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
針對非標準設定
如果您的設定並非標準設定,請依下列順序更新 Edge 元件:
- ZooKeeper
- Cassandra
- ps
- LDAP
- Edge 名稱,亦即所有節點上的「-c 邊緣」設定檔 (順序為:具有 Qpid 伺服器的節點、Edge Postgres Server、管理伺服器、訊息處理器和路由器)。
- Qpidd
- Edge UI (傳統版或新版)
apigee-adminapi
- Apigee 單一登入 (SSO)
完成更新後,請務必在所有執行該元件的機器上重新啟動 Edge UI 元件。