本節說明如何執行下列升級作業:
- 4.18.05 至 4.50.00
可執行更新的使用者
執行更新的使用者必須與當初安裝 Edge 的使用者相同,或 也就是以根的身分執行的使用者
任何使用者都可設定邊緣 RPM 套件。
您需要更新哪些元件
您必須更新所有 Edge 元件。Edge 不支援含有元件的設定 以便擷取來自多個版本的內容
自動傳播資源設定
如果你已透過編輯 .properties
檔案來設定任何屬性
/opt/apigee/customer/application
,則這些值會由更新保留。
更新必要條件
升級 Apigee Edge 前,請先瞭解下列事項:
- 備份所有節點
更新前,建議您對所有節點執行完整備份以確保安全 理由。按照目前 Edge 版本的程序執行備份。這樣一來,您便可有備份方案,以在未更新至新版本時派上用場 功能。如要進一步瞭解備份,請參閱備份 並還原。
- 確保 Edge 正在執行
使用下列指令,確保 Edge 在更新程序期間已啟動且正在執行:/opt/apigee/apigee-service/bin/apigee-all status
新版 Edge UI
本節列出新版 Edge UI 的注意事項。
安裝 Edge UI
完成初始安裝程序後,Apigee 建議您安裝 Edge UI,這是進階使用者介面 Apigee Edge 私有雲的開發人員和管理員
詳情請參閱「安裝新版 Edge UI」。
更新 Edge UI
如果您已安裝 Edge UI (舊稱「New Edge」)Beta 版 4.18.05 使用體驗或 UE),您必須解除安裝該應用程式,並 重新安裝 4.19.01、4.19.06 或 4.50.00 版的 Edge UI。如要 詳情請參閱 The new Edge UI for Private Cloud (私有雲適用的新 Edge UI)。
處理失敗的更新
如果更新失敗,您可以嘗試修正問題,然後執行 update.sh 可以選取「重新建立」,再次生成新的提示您可以多次執行更新,系統會從上次中斷的地方繼續更新 關閉。
如果作業失敗而需要您將更新復原為先前版本,請參閱 復原 4.50.00 即可查看更多內容。
記錄更新資訊
根據預設,update.sh
公用程式會將記錄資訊寫入:
/opt/apigee/var/log/apigee-setup/update.log
如果執行 update.sh
公用程式的使用者沒有存取權
目錄,就會以名稱為 /tmp
的名檔將記錄寫入
update_username.log
。
如果使用者無法存取 /tmp
,update.sh
公用程式
失敗。
零停機時間更新
零停機時間更新或滾動式更新可讓您在沒有停機時間的情況下更新 Edge 安裝作業 進而關閉 Edge
零停機時間更新只能透過 5 個節點設定完成。
升級到零停機時間的關鍵,在於從負載中逐一移除每個路由器,一次一個 。接著在路由器上更新路由器和任何其他元件,這些元件與路由器相同。 然後將路由器加回負載平衡器
- 按照安裝程序的正確順序更新機器 機器更新順序。
- 需要更新路由器時,請選取任一路由器並設為無法連線,如下所示: 如啟用/停用伺服器中所述 (訊息處理器/路由器) 可連性。
- 在與路由器相同的機器上,更新所選路由器和所有其他 Edge 元件。 所有邊緣設定會在相同節點上顯示路由器和訊息處理器。
- 重新連線至路由器。
- 針對其餘的路由器,重複步驟 2 到 4。
- 請繼續為安裝中其餘的機器進行更新。
更新前後請謹慎處理下列事項:
- 在合併的路由器和訊息處理器節點上:
- 更新前 - 執行下列動作:
- 將路由器設為無法連線。
- 將無法連線至訊息處理器設為連線。
- 更新後,請執行下列步驟:
- 請連線至訊息處理器。
- 將路由器設為可連線。
- 更新前 - 執行下列動作:
- 在單一路由器節點上:
- 更新前,請先將無法連線至路由器設為無法使用。
- 更新後,請將路由器設為可連線。
- 在單一訊息處理器節點上:
- 更新前,請先設為無法連線至訊息處理器。
- 更新後,請連線至「訊息處理器」,
使用靜音設定檔
您必須將靜音設定檔傳送至 update 指令。靜音設定檔 必須與您安裝 Edge 4.18.05 時使用的相同。
更新為 4.50.00 個節點 (具備外部網際網路連線的節點)
請使用下列程序更新節點上的 Edge 元件:
- 如果有 CRON 工作顯示,則請停用在 Cassandra 上執行修復作業的所有 CRON 工作 直到更新完成為止
- 以根權限登入節點,安裝邊緣 RPM。
- 安裝
yum-utils
和yum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- 按照安裝 使用 Edge Apigee-setup 公用程式。
- 如果您是在 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.50.00
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
- 安裝 Edge 4.50.00
apigee-service
公用程式和依附元件:sudo bash /tmp/bootstrap_4.50.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。
- 使用
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 是要更新的 Edge 元件。可能的值包括:
- 「cs」:Cassandra
- 「edge」:除了 Edge UI 以外的所有 Edge 元件:管理伺服器、訊息處理器、路由器 QPID 伺服器、Postgres 伺服器
- 「ldap」:OpenLDAP
- 「ps」:postgresql
- "qpid": qpidd
- "sso":Apigee 單一登入 (SSO) (如果您已安裝單一登入 (SSO))
- 「ui」:Edge UI
- "zk":動物名星
而 configFile 與您過去使用的設定檔相同 定義 Edge 元件 。
將 component 設為「all」,即可對所有元件執行
update.sh
,但 您必須擁有 Edge 全方位 (aio) 安裝設定檔。例如:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- 請在所有執行該元件的節點上重新啟動 Edge UI 元件 (如果尚未重新啟動):
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 在管理頁面執行
apigee-validate
公用程式,測試更新作業 伺服器,如「測試安裝」一節中所述。
如果您之後決定要復原更新,請使用 復原 4.50.00 版。
從本機存放區更新至 4.50.00
如果您的 Edge 節點在防火牆後面,或以其他方式遭禁止存取 透過網際網路取得 Apigee 存放區,接著您可以從本機存放區執行更新 或鏡像功能
建立本機 Edge 存放區後,您可以透過兩種方式更新 Edge 本機存放區:
- 建立存放區的 .tar 檔案,將 .tar 檔案複製到節點,然後從 .tar 檔案。
- 在含有本機存放區的節點中安裝網路伺服器,以便其他節點存取。 Apigee 提供 Nginx 網路伺服器供您使用,您也可以使用自己的 網路伺服器
如何從本機 4.50.00 存放區更新:
- 按照「建立本機 Apigee 存放區」一節的說明,建立本機 4.50.00 存放區於 安裝 Edge apigee-setup 公用程式。
- 如要從 .tar 檔案安裝 apigee-service:
- 在含有本機存放區的節點上,使用下列指令來封裝本機存放區
複製到名為
/opt/apigee/data/apigee-mirror/apigee-4.50.00.tar.gz
的單一 .tar 檔案:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- 將 .tar 檔案複製到要更新 Edge 的節點。例如,請複製到
新節點上的
/tmp
目錄。 - 在新節點上,將檔案解壓縮至
/tmp
目錄:tar -xzf apigee-4.50.00.tar.gz
這個指令會在目錄中建立名為
repos
的新目錄 這個檔案包含 .tar 檔案例如/tmp/repos
。 - 從下列位置安裝 Edge
apigee-service
公用程式和依附元件:/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.50.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
請注意,您會在這個指令中加入存放區目錄的路徑。
- 在含有本機存放區的節點上,使用下列指令來封裝本機存放區
複製到名為
- 使用 Nginx 網路伺服器安裝 apigee-service:
- 按照「使用 Nginx 從存放區安裝」一節的說明,設定 Nginx 網路伺服器 webserver"「Install the Edge apigee-setup 公用程式。
- 在遠端節點上,將 Edge
bootstrap_4.50.00.sh
檔案下載至/tmp/bootstrap_4.50.00.sh
:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
其中 uName:pWord 是您先前設定的使用者名稱和密碼 存放區,remoteRepo 是存放區節點的 IP 位址或 DNS 名稱。
- 在遠端節點上,安裝 Edge
apigee-setup
公用程式和依附元件:sudo bash /tmp/bootstrap_4.50.00.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」:Cassandra
- 「edge」:除了 Edge UI 以外的所有 Edge 元件。「邊緣」包括管理元件 伺服器、訊息處理器、路由器、QPID 伺服器和 Edge Postgres Server。
- 「ldap」:OpenLDAP
- 「ps」:postgresql
- "qpid": qpidd
- "sso":Apigee 單一登入 (SSO) (如果您已安裝單一登入 (SSO))
- 「ui」:Edge UI
- "zk":動物名星
- configFile 與您過去使用的設定檔相同 定義 Edge 元件 。
您可以設定 component,對所有元件執行
update.sh
。例如:/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
- component 是要更新的邊緣元件。您通常會更新
加入下列元件:
- 請在所有執行該元件的節點上重新啟動 Edge UI 元件 (如果尚未重新啟動):
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 在管理頁面執行
apigee-validate
公用程式,測試更新作業 伺服器,如「測試安裝」一節中所述。
如果您之後決定要復原更新,請使用 復原 4.50.00 版。
機器更新順序
請務必按照以下順序更新 Edge 安裝過程中的機器:
- 您必須先更新「所有」Cassandra 和 ZooKeeper 節點,才能更新任何節點 和其他節點
- 適用於具備多個 Edge 元件 (管理伺服器、訊息處理器) 的任何機器
路由器、QPID 伺服器,而非 Postgres 伺服器),使用
-c edge
選項更新 - 如果步驟指定應在多部機器上執行,請在該步驟中執行 指定的機器順序
- 更新營利設定無須另外執行一個步驟。這個物件會在您指定
-c edge
選項。
1 個節點獨立昇級授權
如要將 1 個節點的獨立設定升級至 4.50.00 版:
- 更新所有元件:
/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 上更新 Qpid 和 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c qpid,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
- 更新裝置 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 上更新 Qpid 和 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- 在機器 5 上更新 Qpid 和 Postgres:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, 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
- 更新裝置 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
9 個節點叢集升級作業
針對 9 節點的叢集安裝作業更新下列元件:
如需 Edge 拓撲和節點編號清單,請參閱安裝拓撲。
- 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 更新機器 6 和 7 上的 Qpid:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -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
- 更新裝置 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
13 個節點叢集升級
針對 13 節點的叢集安裝作業更新下列元件:
如需 Edge 拓撲和節點編號清單,請參閱安裝拓撲。
- 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- 更新機器 12 和 13 的 Qpid:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -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
- 更新機器 6 和 7 的 UI:
/opt/apigee/apigee-setup/bin/update.sh -c ui -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)。
- 在機器 6 和 7 上重新啟動 Edge UI 元件:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
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 中:
- 更新 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 部
- 更新 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
- 更新 UI:
- 資料中心 1 中的機器 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- 資料中心 2 中的機器 7:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- 在機器 1 和 7 上重新啟動 Edge UI 元件:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- 資料中心 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:
針對非標準設定
如果您有非標準設定,請在下方更新 Edge 元件 順序:
- ZooKeeper
- Cassandra
- qpidd、ps
- LDAP
- 邊緣,表示「-c 邊緣」依序排列所有節點和含有 Qpid 伺服器的節點 Edge Postgres Server、管理伺服器、訊息處理器和路由器。
- Edge UI
apigee-adminapi
- Apigee 單一登入 (SSO)
完成更新後,請務必在所有執行中的機器重新啟動 Edge UI 元件 基礎架構