復原 Apigee Edge 4.52.02

如果更新至 Edge 4.52.02 時發生錯誤，可以復原 ，然後再次嘗試更新。

您可以將 Edge 4.52.02 復原至下列主要版本：

  • 版本 4.52.01
  • 版本 4.52.00
  • 版本 4.51.00

復原版本時，您必須復原所有已升級的元件。此外，根據初始版本，在復原特定軟體元件前，您可能需考量特別注意事項。下表列出執行復原時可能需要用到特殊步驟的各種軟體：

復原至版本 軟體的特別注意事項
4.52.01 Cassandra
4.52.00 Cassandra、Zookeeper、Qpid
4.51.00 Cassandra、Zookeeper、Qpid、Postgres

在以下兩種情況中，您可能會想執行復原作業：

  1. 復原至先前的主要或次要版本。例如： 4.52.02 至 4.52.00。
  2. 復原至先前修補程式版本 ( 版本。例如從 4.52.00.02 到 4.52.00.01。

詳情請參閱 Apigee Edge 版本 程序。

復原順序

元件應按照升級順序反向復原，但在 Cassandra 後應復原管理伺服器。

Private Cloud 4.52.02 的一般復原順序如下：

  1. 復原 Postgres、Qpid 和其他數據分析相關元件
  2. 復原路由器和訊息處理器
  3. 復原 Cassandra、Zookeeper
  4. 復原管理伺服器

舉例來說，假設您已從 4.52.01 版將整個 Cassandra 叢集、所有管理伺服器和一些 RMP 升級至 4.52.02 版，並希望復原。此時，您應採取以下做法：

  1. 逐一復原所有 RMP
  2. 使用備份復原整個 Cassandra 叢集
  3. 逐一復原 Edge Management 伺服器節點

誰可以執行復原作業

執行復原作業的使用者必須與最初更新 Edge 的使用者相同，或 也就是以根的身分執行的使用者

根據預設，Edge 元件會以使用者「apigee」執行。在某些情況下，您可能在作業系統上執行 Edge 將元件當做不同使用者舉例來說，如果路由器必須存取具有特殊權限的通訊埠， 則必須以根層級使用者的身分執行路由器，或是將路由器以根使用者的身分執行 通訊埠。或者，您也可以分別以一個使用者身分執行元件和另一個元件，做為另一個使用者執行。

含有通用程式碼的元件

以下 Edge 元件會共用通用程式碼。因此，只要復原其中一個參數 所以對該節點上的這些元件而言，您必須復原該節點上的所有這些元件。

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

舉例來說，如果您在裝置上安裝了管理伺服器、路由器和訊息處理器， 如要將其中一個節點復原，您必須復原這三個節點。

復原 Cassandra

針對特定 Cassandra 節點執行 Cassandra 重大升級時，Cassandra 會修改儲存在節點上資料的結構定義，使其無法直接復原。復原的方法有兩種。您必須根據要復原的升級狀態，使用其中一種方法。

復原的方法

清除並使用叢集中的現有節點，以重新建構節點

如果您在舊版 Cassandra (Cassandra 2.1.22 版本) 的叢集中，至少有一個功能完整的資料中心，可以按照這項程序進行。如果您已升級整個 Cassandra 叢集，並想要復原，請按照清除及還原備份或 VM 快照一文中的步驟操作。

復原步驟

  1. 從要復原的節點開始：
    • 在節點上停止 Cassandra： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • 從節點解除安裝 Cassandra 軟體： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
    • 移除節點中的資料目錄： 
      rm -rf /opt/apigee/data/apigee-cassandra
    • 下載並執行要復原的舊版 Edge for Private Cloud 啟動程序。

    範例：復原至 4.52.01 版，

    • 下載 4.52.01 版的啟動項目： 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
    • 執行 4.52.01 的啟動載入： 
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    • 在節點上設定 Cassandra： 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
    • 提供功能性資料中心名稱，在節點上執行重新建構： 
      /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>
    • 對要復原的每個節點重複上述步驟，逐一執行。
  2. 復原並重新建構所有節點後：
    • 執行任何管理伺服器節點的設定。確保管理伺服器使用的是復原版本。如果不能，請一併復原管理伺服器。
    • 停止管理伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
    • 如果使用營利功能，請一併解除安裝營利功能： 
      /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
    • 解除安裝管理伺服器： 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    • 下載並執行舊版本的啟動作業。舉例來說，如要下載並執行 4.52.01 版的 Bootstrap，請按照下列步驟操作： 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
    • 執行單一管理伺服器節點的設定： 
      /opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile

重新建構後進行最佳化

在上述步驟中，所有在重建期間，都會從遠端資料中心串流處理該節點中的所有資料。將所有備用資源串流至本機資料中心後，您可以使用維修程序來最佳化這項程序。這可避免跨資料中心串流作業，且應比從遠端 DC 重新建構所有節點的速度更快。

範例：假設本機資料中心有六個 Cassandra 節點。根據預設，Apigee 的複製係數為三個，因此每個節點都可擁有 50% 的資料。在這種情況下，您可以按照上述程序重新建構節點 #1 和 #4。針對節點 #2、#3、#5 和 #6，請按照下列步驟還原備份並執行修復。

  1. 按照步驟最多步驟六步，在本機資料中心重新建構備用資源。
  2. 針對其餘節點，請一次對其餘的節點執行下列步驟。
    • 還原您從這個節點擷取的備份 (注意：這項備份作業可能是在您開始 Cassandra 升級前進行而過時的資料)： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
    • 如果有節點的 VM 快照，可以還原快照，不必還原 Cassandra 備份。
    • 還原備份後，請在節點上啟動 Cassandra 服務： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
    • 在節點上執行修復作業，以便從現有的資料中心串流最新資料： 
      /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>
    • 在要修復的每個節點上重複執行步驟 3 至 6。
，瞭解如何調查及移除這項存取權。

清除及還原備份/VM 快照

如果您已升級整個 Cassandra 叢集，並想要復原，則只能採用這項程序。

此外，Apigee 備份是節點專屬的。無法將某個節點的備份還原至其他節點。Cassandra 備份包含節點中繼資料資訊 (例如 IP 位址、環位位置等)。

  1. 從叢集中 1 個 Cassandra 節點開始：
    • 在節點上停止 Cassandra 服務： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • 從節點解除安裝 Cassandra 軟體： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
    • 移除節點中的資料目錄： 
      rm -rf /opt/apigee/data/apigee-cassandra
    • 下載並執行要復原的舊版 Edge for Private Cloud。

    範例：復原至 4.52.01 版

    • 下載 4.52.01 版的啟動項目： 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
    • 執行 4.52.01 的啟動載入： 
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    • 在節點上設定 Cassandra： 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
    • 按照「從備份還原」一節的程序還原節點上的備份。
    • 在節點上停止 Cassandra： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • 刪除資料目錄： 
      rm -rf /opt/apigee/data/apigee-cassandra/data
    • 還原備份： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
    • 在節點上啟動 Cassandra 服務： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
    • 在每個 Cassandra 節點上一次重複執行一個步驟。
    • 一次執行一個節點的修復作業： 
      /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr
，瞭解如何調查及移除這項存取權。

復原 Zookeeper 3.8.3 更新

如果您要復原至 4.52.00 或 4.51.00 版，在復原 Zookeeper 之前，請先參考一些特殊步驟。相關步驟請參閱「復原」一節。

如果您要復原到 4.52.01 版，請復原 Zookeeper，方法和復原任何軟體一樣，如下方「復原至先前的主要或次要版本」一節所述。

復原 Qpid

如果您要復原為 4.52.00 或 4.51.00 版，在復原 Qpid 之前，請先參考一些特殊步驟。相關步驟請參閱「復原」一節。

如果您復原為 4.52.01 版，請按照「復原至先前的主要或次要版本」一節所述的方式復原 Qpid，

復原 Postgres 10.17 更新

如果您要復原至 4.51.00 版，在復原 Postgres 之前，請先參考一些特殊步驟。相關步驟請參閱「復原」一節。

如果您復原到 4.52.01 或 4.52.00 版，請像復原任何軟體一樣復原 Postgres，如下方「復原至先前的主要或次要版本」一節所述。

復原至前一個主要或次要版本

如要復原至先前的主要或次要版本，請在代管 元件：

  1. 下載所需版本的 bootstrap.sh 檔案 返回：

    • 如要復原為 4.51.00 版，請下載 bootstrap_4.51.00.sh： 
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.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. 如要復原節點上的任何「other」元件，請停止該元件： 
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. 如果您要復原營利服務，請從所有管理伺服器和訊息中解除安裝 處理器節點： 
    /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，您必須刪除 /opt/nginx/conf.d 檔案，除瞭解除安裝 edge-gateway 元件群組： 
      cd /opt/nginx/conf.d
 rm -rf *
  5. 解除安裝 4.52.02 版的 apigee-setup： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. 安裝 4.51.00 版本的 apigee-service 公用程式和依附元件以下範例會安裝 apigee-service: 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

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

    如果收到錯誤訊息，請確實下載 bootstrap.sh 檔案 1.

  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，請清除 iptable： 
    sudo iptables -F
  10. 針對您要復原的元件的每個節點重複此程序。

復原至前一個修補程式版本

如要將元件復原至特定的修補程式版本，請針對每個節點執行下列操作 代管元件：

  1. 下載特定元件版本： 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    其中 component_version 是要安裝的元件和修補程式版本。適用對象 範例：

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-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. 針對您要復原的元件的每個節點重複此程序。

復原 mTLS

如要復原 mTLS 更新，請在所有主機上執行下列步驟：

  1. 停止 Apigee： 
    apigee-all stop
  2. 停止 mTLS： 
    apigee-service apigee-mtls uninstall
  3. 重新安裝 mTLS： 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf