復原 Apigee Edge 4.19.01

Edge for Private Cloud 4.19.01 版

如果在更新至 Edge 4.19.01 時發生錯誤，可以復原導致錯誤的元件，然後再次嘗試更新。

您可以將 Edge 4.19.01 復原至下列功能版本：

• 4.18.05 版
• 4.18.01 版
• 4.17.09 版^*

^* 如要從 4.19.01 復原至 4.17.09，除了復原各節點上的元件外，您還必須復原 Postgres。如果復原至 4.18.01 或 4.18.05，則不必復原 Postgres，因為升級程序不含 Postgres 更新。

您可能需要在以下兩種情況下執行復原：

1. 復原至先前的功能版本。例如從 4.19.01 降級至 4.18.05。
2. 復原至同一版本中的前一個更新版本。例如從 4.19.01.02 降級至 4.19.01.01。

詳情請參閱「Apigee Edge 發布程序」。

誰可以執行復原

執行復原作業的使用者應與原先更新 Edge 的使用者相同，或以 root 身分執行的使用者。

根據預設，Edge 元件會以「apigee」使用者身分執行。在某些情況下，您可能會以不同使用者身分執行 Edge 元件。舉例來說，如果路由器必須存取特殊權限通訊埠 (例如低於 1000 的通訊埠)，則必須以 root 身分或具備這些通訊埠存取權的使用者身分執行路由器。或者，您也可以以某個使用者的身分執行一個元件，並以另一個使用者的身分執行另一個元件。

具有通用程式碼的元件

下列 Edge 元件共用程式碼。因此，如要復原節點上的任何一個元件，就必須復原該節點上的所有元件。

• edge-management-server (管理伺服器)
• edge-message-processor (訊息處理器)
• edge-router (路由器)
• edge-postgres-server (Postgres 伺服器)
• edge-qpid-server (Qpid 伺服器)

舉例來說，如果您在節點上安裝了管理伺服器、路由器和訊息處理器，則必須復原這三個元件，才能復原其中任何一個元件。

復原至先前的功能版本

如要從 4.19.01 復原至 4.17.09，除了復原各節點上的元件外，還必須復原 Postgres。如果您從 4.18.01 或 4.18.05 復原，則不需要復原 Postgres，因為升級程序不包含 Postgres 更新。

如要復原至先前的功能版本，請在託管元件的每個節點上執行下列操作：

1. 下載要復原版本的 bootstrap.sh 檔案：

   • 如要復原至 4.18.05，請下載 bootstrap_4.18.05.sh：

     curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh 

   • 如要復原至 4.18.01，請下載 bootstrap_4.18.01.sh：

     curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh 

   • 如要復原至 4.17.09，請下載 bootstrap_4.17.09.sh：

     curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh 

2. 停止要復原的元件：
   1. 如要復原節點上具有通用程式碼的任何元件，您必須停止所有元件，如以下範例所示：

      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-router stop
      /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

   2. 如要復原節點上的任何「其他」元件，請只停止該元件：
      • /opt/apigee/apigee-service/bin/apigee-service component stop

3. 如要復原 Monetization，請從所有管理伺服器和訊息處理器節點解除安裝：

   /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall

4. 解除安裝元件，在節點上復原：
   1. 如要復原節點上具有通用程式碼的任何元件，您必須解除安裝 edge-gateway 元件群組，才能解除安裝所有元件，如以下範例所示：

      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall

   2. 如要復原節點上的任何其他元件，請只解除安裝該元件，如下例所示：

      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      其中 component 是元件名稱。

   3. 如要復原 Edge Router，除了要解除安裝 edge-gateway 元件群組，還必須刪除 /opt/nginx/conf.d 檔案的內容：

      cd /opt/nginx/conf.d
      rm -rf *

5. 解除安裝 4.19.01 版 apigee-setup：

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

6. 安裝 4.18.05、4.18.01 或 4.17.09 版的 apigee-service 公用程式及其依附元件。以下範例會安裝 4.17.09 版的 apigee-service：

   sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

   其中 uName 和 pWord 是您從 Apigee 收到的使用者名稱和密碼。如果省略 pWord，系統會提示您輸入。

   如果收到錯誤訊息，請確認您已在步驟 1 下載 bootstrap.sh 檔案。

7. 安裝 apigee-setup：

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

8. 安裝舊版元件：

   /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

   其中 component 是要安裝的元件，configFile 是舊版設定檔。

9. 如果您要復原 Qpid，請清除 iptables：

   sudo iptables -F

10. 針對託管要復原元件的每個節點，重複執行這項程序。

如要從 4.19.01 復原至 4.17.09，除了復原各節點上的元件外，還必須復原 Postgres。如果您從 4.18.01 或 4.18.05 復原，則不需要復原 Postgres，因為升級程序不包含 Postgres 更新。

復原至先前的更新版本

如要將元件復原至特定版本，請在託管該元件的每個節點上執行下列操作：

1. 下載特定元件版本：

   /opt/apigee/apigee-service/bin/apigee-service component_version install

   其中 component_version 是要安裝的元件和更新版本。例如：

   /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.17.09-0.0.3749 install

   如果您使用的是 Apigee 線上存放區，可以使用下列指令判斷可用的元件版本：

   yum --showduplicates list comp

   例如：

   yum --showduplicates list edge-ui

2. 使用 apigee-setup 安裝元件：

   /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

   例如：

   /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

   請注意，安裝時只需指定元件名稱，不需指定版本。

3. 針對託管要復原元件的每個節點，重複執行這項程序。

如要從 4.19.01 復原至 4.17.09，除了復原各節點上的元件外，還必須復原 Postgres。如果您從 4.18.01 或 4.18.05 復原，則不需要復原 Postgres，因為升級程序不包含 Postgres 更新。

復原 Postgres 9.6 更新

如果您是從 4.17.09 版升級至 4.19.01，除了 Edge 元件外，還必須復原 Postgres 更新。

如要在主備用設定中更新 Postgres 時復原 Postgres 更新：

• 將新的待命節點升級為 Postgres 主要節點。新的 Postgres 主執行個體版本會與先前的 Edge 安裝版本相同。
• 將舊的待命節點設為新主要節點的待命節點。舊的待命節點會與先前的 Edge 安裝版本相同。
• 向數據分析和消費者群組註冊新的主要和待命節點。

復原完成後，就不再需要舊的主節點。接著，您可以停用舊的主節點。

1. 確認新的待命 Postgres 節點正在運作：

   /opt/apigee/apigee-service/bin/apigee-all status

   如果 Postgres 未執行，請啟動：

   /opt/apigee/apigee-service/bin/apigee-all start

2. 確認 Postgres 已在舊的主要節點和舊的待命節點上停止：

   /opt/apigee/apigee-service/bin/apigee-all status

   如果 Postgres 正在執行，請停止執行：

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

3. 如果已安裝，請在舊的待命節點上啟動 Qpid：

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

4. 將新的待命節點升級為 Postgres 主要節點：
   1. 將新的待命節點升級為新的主要節點：

      apigee-service apigee-postgresql promote-standby-to-master new_standby_IP

      如果出現提示，請輸入「apigee」使用者的 Postgres 密碼，預設值為「postgres」。

   2. 編輯用來安裝目前 Edge 版本的設定檔，指定下列項目：

      # IP address of the new master:
      PG_MASTER=new_standby_IP
      # IP address of the old standby node
      PG_STANDBY=old_standby_IP

   3. 設定新主要執行個體：
      

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile

5. 重建舊的待命節點：
   1. 編輯用來安裝目前 Edge 版本的設定檔，指定下列項目：

      # IP address of the new master:
      PG_MASTER=new_standby_IP
      # IP address of the old standby node
      PG_STANDBY=old_standby_IP

   2. 移除舊待命節點上的資料目錄：

      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *

   3. 將舊的待命節點重新設定為新主節點的待命節點：

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

   4. 確認 Postgres 在舊的待命節點上執行：

      /opt/apigee/apigee-service/bin/apigee-all status

      如果未執行，請啟動：

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

6. 查看新主節點上的 /opt/apigee/apigee-postgresql/conf/pg_hba.conf 檔案，確認已新增待命節點。
7. 在管理伺服器上執行下列指令，查看目前的數據分析和消費者群組資訊：

   curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

   這個指令會在 name 欄位中傳回數據分析群組名稱，並在 consumer-groups 下方的 name 欄位中傳回消費者群組名稱。此外，這項作業也會在 postgres-server 欄位和 datastores 欄位中，傳回舊 Postgres 主要和待命節點的 UUID。您應該會看到以下格式的輸出內容：

   {
     "name" : "axgroup-001",
     "properties" : {
     },
     "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
     "uuids" : {
       "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
       "postgres-server" : [
         "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
       ]
     },
     "consumer-groups" : [ {
       "name" : "consumer-group-001",
       "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
       "datastores" :
         [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
         "properties" : {     }
       }
     ],
     "data-processors" : {
     }
   }

8. 在舊主節點上執行下列 curl 指令，取得舊主節點的 UUID 位址：

   curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

   輸出內容結尾應會顯示節點的 UUID，格式如下：

   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

9. 重複上述步驟，取得舊待命節點和新主要節點的 IP 位址。
10. 從消費者群組中移除舊的主要和待命節點：

    curl -u sysAdminEmail:password -X DELETE \
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v

    其中 axgroup-001 和 consumer-group-001 是數據分析和消費者群組的預設名稱。masterUUID,standbyUUID的順序與您在上方查看目前數據分析和消費者群組資訊時顯示的順序相同。您可能需要將其指定為 standbyUUID,masterUUID。

    consumer-groups 的 datastores 屬性現在應為空白。

11. 從數據分析群組中移除舊的主要和待命節點：

    curl -u sysAdminEmail:password -X DELETE \
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

    uuids 下方的 postgres-server 屬性現在應為空白。

12. 向數據分析和消費者群組註冊新的 PG 主要和待命節點：
    

    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
    curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v

13. 驗證數據分析群組：

    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    您應該會在數據分析群組和消費者群組中，看到新主要和待命節點的 UUID。

14. 重新啟動 Edge Management Server：

    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

15. 重新啟動所有 Qpid 伺服器：

    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

16. 重新啟動所有 Postgres 伺服器：

    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

17. 在兩部伺服器上執行下列指令碼，驗證複製狀態。系統應在兩部伺服器上顯示相同的結果，確保複製成功：

    在新主要執行個體上執行：

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

    確認顯示為主要執行個體。在舊的待命節點上：

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

    確認狀態顯示為待命。

18. 提出多個 API 要求後，請重複執行上一個步驟，確保節點已同步。
19. 按照「將 Apigee Edge 4.16.01/4.16.05 更新至 4.17.09」一文中的程序，停用舊的 Postgres 主節點。

    或者，您也可以從舊的主要節點解除安裝 Qpid，並在新的主要節點上安裝 Qpid。解除安裝 Qpid 後，即可停用舊的主節點。

從舊的主要執行個體解除安裝 Qpid，並在新的主要執行個體上安裝 Qpid

如要從舊的主要執行個體解除安裝 Qpid，並在新的主要執行個體上安裝 Qpid，請按照下列步驟操作：

1. 在所有訊息處理器上執行下列指令，禁止訊息處理器存取舊主節點上的 Qpid 通訊埠 5672：

   iptables -A OUTPUT -p tcp -d 10.233.147.20 --dport 5672 -j DROP

2. 執行下列指令，確保 Qpid 訊息佇列為空白。在 Qpid 處理完所有待處理訊息之前，您無法解除安裝 Qpid：

   qpid-stat -q

   這個指令會顯示包含 msg, msgIn, and msgOut 計數的表格。 當 msg=0 和 msgIn=msgOut 時，所有訊息都會處理完畢。

3. 在舊主節點上執行下列指令，判斷舊主節點上 Qpid 伺服器的 UUID。請儲存這項資訊，稍後會用到：

   curl -u sysAdminEmail:password http://node_IP::8083/v1/servers/self

4. 在舊的主節點上停止 Qpid：

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop

5. 解除安裝 Qpid 伺服器：

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall
   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall

6. 從數據分析和消費者群組中移除舊的 Qpid 伺服器：

   curl -u sysAdminEmail:password -X DELETE -H "Content-Type: application/json" -d '' \
     "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/consumers/qpid_UUID" -v
   curl -u sysAdminEmail:password -X DELETE \
     "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=qpid_UUID&type=qpid-server" -v

7. 從 Zookeeper 移除舊的 Qpid 伺服器：

   curl -u sysAdminEmail:password -X DELETE \
     http://ms_IP:8080/v1/servers/qpid_UUID

8. 在新主節點上安裝 Qpid：

   /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

9. 在新主節點上執行下列指令，判斷新主節點上 Qpid 伺服器的 UUID。請儲存這項資訊，稍後會用到：

   curl -u sysAdminEmail:password
     http://node_IP::8083/v1/servers/self

10. 向數據分析和消費者群組註冊新的 Qpid 伺服器：

    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d '' \
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=qpid_UUID&type=qpid-server" -v
    curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d '' \
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/consumers?uuid=qpid_UUID" -v

11. 重新啟動所有訊息處理器：

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

12. 在新 Qpid 伺服器上執行下列指令，確認佇列已建立：
    

    qpid-stat -q

    確認 Qpid 伺服器處理訊息時，msg、msgIn 和 msgOut 會更新。

如果復原時發生問題，請與 Apigee Edge 支援團隊聯絡。