將 Apigee Edge 4.18.05 更新至 4.50.00

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

  • 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

如果使用者無法存取 /tmpupdate.sh 公用程式 失敗。

零停機時間更新

零停機時間更新或滾動式更新可讓您在沒有停機時間的情況下更新 Edge 安裝作業 進而關閉 Edge

零停機時間更新只能透過 5 個節點設定完成。

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

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

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

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

使用靜音設定檔

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

更新為 4.50.00 個節點 (具備外部網際網路連線的節點)

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

  1. 如果有 CRON 工作顯示,則請停用在 Cassandra 上執行修復作業的所有 CRON 工作 直到更新完成為止
  2. 以根權限登入節點,安裝邊緣 RPM。
  3. 安裝 yum-utilsyum-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.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
  8. 安裝 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。
  9. 使用 apigee-service 更新 apigee-setup 公用程式:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. 依照下列方式更新管理 Server 上的 apigee-validate 公用程式 範例如下所示:
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. 依照下列方式更新管理 Server 上的 apigee-provision 公用程式 範例如下所示:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  12. 請依下列說明,在節點上執行 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
  13. 請在所有執行該元件的節點上重新啟動 Edge UI 元件 (如果尚未重新啟動):
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  14. 在管理頁面執行 apigee-validate 公用程式,測試更新作業 伺服器,如「測試安裝」一節中所述。

如果您之後決定要復原更新,請使用 復原 4.50.00 版

從本機存放區更新至 4.50.00

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

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

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

如何從本機 4.50.00 存放區更新:

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

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

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

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

  3. 使用 Nginx 網路伺服器安裝 apigee-service:
    1. 按照「使用 Nginx 從存放區安裝」一節的說明,設定 Nginx 網路伺服器 webserver"「Install the Edge apigee-setup 公用程式
    2. 在遠端節點上,將 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 名稱。

    3. 在遠端節點上,安裝 Edge apigee-setup 公用程式和依附元件:
      sudo bash /tmp/bootstrap_4.50.00.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 以外的所有 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
  8. 請在所有執行該元件的節點上重新啟動 Edge UI 元件 (如果尚未重新啟動):
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  9. 在管理頁面執行 apigee-validate 公用程式,測試更新作業 伺服器,如「測試安裝」一節中所述。

如果您之後決定要復原更新,請使用 復原 4.50.00 版

機器更新順序

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

  • 您必須先更新「所有」Cassandra 和 ZooKeeper 節點,才能更新任何節點 和其他節點
  • 適用於具備多個 Edge 元件 (管理伺服器、訊息處理器) 的任何機器 路由器、QPID 伺服器,而非 Postgres 伺服器),使用 -c edge 選項更新
  • 如果步驟指定應在多部機器上執行,請在該步驟中執行 指定的機器順序
  • 更新營利設定無須另外執行一個步驟。這個物件會在您指定 -c edge選項。
,瞭解如何調查及移除這項存取權。

1 個節點獨立昇級授權

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

  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 上更新 Qpid 和 Postgres:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid,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. 更新裝置 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. (如果您已安裝 Apigee 單一登入) 在機器 1 上更新 Apigee 單一登入 (SSO):
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  8. 在電腦 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 上更新 Qpid 和 Postgres:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  3. 在機器 5 上更新 Qpid 和 Postgres:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, 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. 更新裝置 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

9 個節點叢集升級作業

針對 9 節點的叢集安裝作業更新下列元件:

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

  1. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. 更新機器 6 和 7 上的 Qpid:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. 在機器 8 上更新 Postgres:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. 在電腦 9 上更新 Postgres:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. 在電腦 1 上更新 LDAP:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. 請依照下列順序更新機器 6、7、8、9、1、4 和 5 上的 Edge 元件:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. 更新裝置 1 的 UI:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -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. 在電腦 1 上重新啟動 Edge UI 元件:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

13 個節點叢集升級

針對 13 節點的叢集安裝作業更新下列元件:

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

  1. 在機器 1、2 和 3 上更新 Cassandra 和 ZooKeeper:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. 更新機器 12 和 13 的 Qpid:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. 在機器 8 上更新 Postgres:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. 在電腦 9 上更新 Postgres:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. 在電腦 4 和 5 上更新 LDAP:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. 請依照下列順序更新機器 12、13、8、9、6、7、10 和 11 中的 Edge 元件:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. 更新機器 6 和 7 的 UI:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -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. 在機器 6 和 7 上重新啟動 Edge UI 元件:
    /opt/apigee/apigee-service/bin/apigee-service edge-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. 更新 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
  3. 更新 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
  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、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
  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
    3. 在機器 1 和 7 上重新啟動 Edge UI 元件:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  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)

針對非標準設定

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

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

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