降級 Apigee 元件和 NGINX

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件
資訊

2021 年 3 月修補程式版本

Edge for Private Cloud 2021 年 3 月修補程式版本的 RPM 已推送至 Apigee 正式存放區apigee-nginx-1.18 有意外的依附元件更新。因此,我們已從存放區中移除 RPM,並替換為正確的 RPM。無效的 RPM 檔案位於 2021 年 3 月 25 日上午 8:45 到 03:45 (太平洋標準時間)。 如果您在該日期下載並安裝了 Edge RPM,可能需要將下列 Apigee 元件降級至先前版本:

  • 邊緣閘道
  • 邊緣管理伺服器
  • 邊緣訊息處理器
  • edge-postgres-server
  • Edge-qpid-server
  • 邊緣路由器
  • nginx

下列各節將說明如何檢查是否需要降級,以及如何在必要時降級 Apigee 元件。

檢查是否需要降級

如要確認是否需要降級 Apigee 元件或 NGINX,請根據您使用的是 Edge Cloud 的 Edge 4.50.00 或 4.19.06,採取下列任一程序。

Edge 4.50.00 的程序

在每個節點上輸入下列指令來找出閘道版本:

-- apigee-service edge-gateway version

如果 edge-gateway 的版本號碼為:

  • 不到 20113 年,您無須採取進一步行動。
  • 等於 20113,您必須將 Apigee 元件和 NGINX 降級。
  • 如要找出 NGINX 版本,請輸入以下指令:
    -- sudo yum list installed apigee-nginx

    以下是指令的輸出範例:

    Installed Packages
    apigee-nginx.x86_64 1.18.0-1.el7
    @apigee-thirdparty

    如果 NGINX 版本為 apigee-nginx.x86_64 1.18.0-XXX,您只需將 NGINX 降級即可。

Edge 4.19.06 的程序

在每個節點上輸入下列指令來找出閘道版本:

-- apigee-service edge-gateway version

如果 edge-gateway 的版本號碼為:

  • 不到 20114 年,您無須採取進一步行動。
  • 等於 20114,您必須將 Apigee 元件降級將 NGINX 降級
  • 如要找出 NGINX 版本,請輸入以下指令:
    -- sudo yum list installed apigee-nginx

    以下是指令的輸出範例:

    Installed Packages
    apigee-nginx.x86_64 1.18.0-1.el7
    @apigee-thirdparty

    如果 NGINX 版本為 apigee-nginx.x86_64 1.18.0-XXX,您只需將 NGINX 降級即可。

    要降級的元件

    如果您已從以下清單安裝任何 RPM,就必須降級至舊版 RPM 的前一個版本。

    要降級至 Edge for Private Cloud 4.50.00 的元件

    edge-gateway-4.50.00-0.0.20113.noarch.rpm
    edge-management-server-4.50.00-0.0.20113.noarch.rpm
    edge-message-processor-4.50.00-0.0.20113.noarch.rpm
    edge-postgres-server-4.50.00-0.0.20113.noarch.rpm
    edge-qpid-server-4.50.00-0.0.20113.noarch.rpm
    edge-router-4.50.00-0.0.20113.noarch.rpm

    要降級至 Edge for Private Cloud 4.19.06 的元件

    edge-gateway-4.19.06-0.0.20114.noarch.rpm
    edge-management-server-4.19.06-0.0.20114.noarch.rpm
    edge-message-processor-4.19.06-0.0.20114.noarch.rpm
    edge-postgres-server-4.19.06-0.0.20114.noarch.rpm
    edge-qpid-server-4.19.06-0.0.20114.noarch.rpm
    edge-router-4.19.06-0.0.20114.noarch.rpm

    如要檢查這些 RPM 是否已安裝完成,請在已安裝上述適當清單內任一元件的每個節點上,為每個元件輸入以下指令:

    -- apigee-service component version

    降級 Apigee 元件

    如要降級 Apigee 元件,請按照下列程序操作。

    在每個已安裝下列任一元件的節點上:

    • 邊緣閘道
    • 邊緣管理伺服器
    • 邊緣訊息處理器
    • edge-postgres-server
    • Edge-qpid-server
    • 邊緣路由器

    如要停止元件,請輸入

    --apigee-service component stop

    然後將元件降級:

    -- sudo yum downgrade 

    例如:

    如果已安裝閘道和邊緣訊息處理器:

    -- sudo yum downgrade edge-gateway edge-message-processor

    如已安裝閘道和邊緣路由器:

    -- sudo yum downgrade edge-gateway edge-router

    如已設定 AIO:

    -- sudo yum downgrade edge-gateway edge-postgres-server edge-router edge-management-server edge-message-processor edge-qpid-server

    降級完成後,請為每個元件執行 configure 並重新啟動。

    --apigee-service  component configure
    --apigee-service  component start

    以下是降級後觀看的正確 RPM 版本。

    私有雲 4.50.00 版邊緣

    edge-gateway-4.50.00-0.0.20110
    Edge-management-server-4.50.00-0.0.20110
    edge-message-processor-4.50.00-0.0.20110
    edge-postgres-server-4.50.00-0.0.20110
    edge-qpid-server-4.50.00-0.0.20110
    edge-router-4.50.00-0.0.20110

    私有雲 4.19.06 邊緣

    edge-gateway-4.19.06-0.0.20112
    Edge-management-server-4.19.06-0.0.20112
    edge-message-processor-4.19.06-0.0.20112
    edge-postgres-server-4.19.06-0.0.20112
    edge-qpid-server-4.19.06-0.0.20112
    edge-router-4.19.06-0.0.20112

    降級 NGINX

    如要降級 apigee-nginx,請逐一對 Edge Router 執行下列步驟 (一次一個節點):

    1. 停止路由器。
      --apigee-service edge-router stop
    2. 降級 apigee-ngix
       -- sudo yum downgrade apigee-nginx
      降級後預期的 apigee-nginx 版本:
      -- yum list installed apigee-nginx
      apigee-nginx.x86_64 -1.16.1-6.el7
    3. 設定路由器。
      apigee-service edge-router configure
    4. 啟動路由器。
      apigee-service edge-router start