重新安裝及還原元件

本文件說明如何重新安裝及還原 Edge 元件。使用這項程序 否則您必須在還原備份前重新安裝 Edge 元件。

Apache ZooKeeper

還原獨立節點

1. 停止 ZooKeeper：

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

2. 移除舊的 ZooKeeper 目錄：

   /opt/apigee/data/apigee-zookeeper
   /opt/apigee/etc/apigee-zookeeper.d

3. 重新安裝 ZooKeeper：

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

4. 還原 ZooKeeper：

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore 2019.03.17,14.40.41

   請注意，還原元件時，您無法指定備份的目錄路徑 檔案，也不會指定「backup-」前置字串或「.tar.gz」尾碼。您只需指定 備份檔案名稱的日期/時間部分。

   您可以選擇在 restore 指令中省略備份檔案，Edge 將 使用元件備份目錄中最新的備份檔案。

5. 重新啟動所有元件：

   /opt/apigee/apigee-service/bin/apigee-all restart

還原 1 個叢集節點

如果某個 ZooKeeper 節點因組成部分失敗，您可以使用 使用相同的主機名稱/IP 位址，然後重新安裝 ZooKeeper。當新的 ZooKeeper 節點加入 ZooKeeper 透過程式化的方式取得領導者的最新快照，並開始為客戶提供服務。 您不需要還原這個執行個體中的資料。

1. 重新安裝 ZooKeeper：

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

2. 在 ZooKeeper 節點上執行設定，方法是使用安裝 原始節點：

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f configFile

3. 啟動 ZooKeeper：

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper start

還原完整的叢集

1. 停止整個叢集。
2. 按照上文所述的步驟還原單一節點的所有 ZooKeeper 節點。
3. 啟動 ZooKeeper 叢集。
4. 重新啟動所有元件。

Apache Cassandra

還原獨立節點

1. 停止 Cassandra：

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

2. 移除舊的 Cassandra 目錄：

   /opt/apigee/data/apigee-cassandra

3. 重新安裝 Cassandra：

   /apigee/apigee-service/bin/apigee-service apigee-cassandra install

4. 還原 Cassandra：

   /apigee/apigee-service/bin/apigee-service apigee-cassandra restore 2019.03.17,14.40.41

   請注意，還原元件時，您無法指定備份的目錄路徑 檔案，也不會指定「backup-」前置字串或「.tar.gz」尾碼。您只需指定 備份檔案名稱的日期/時間部分。

   您可以選擇在 restore 指令中省略備份檔案，Edge 將 使用元件備份目錄中最新的備份檔案。

5. 重新啟動所有元件：
   

   /apigee/apigee-service/bin/apigee-all restart

還原 1 個叢集節點

如果同屬一個 Cassandra 節點故障，您可以使用相同的主機名稱/IP 位址建立新節點。您只需要重新安裝 Cassandra 並按照幾個額外步驟操作。您不需要從備份還原資料。其他節點可用的備用資源可用來還原失敗節點上的資料。如果 Cassandra 叢集中的節點因硬體故障等原因而當機，則通常適用這些步驟。

，瞭解如何調查及移除這項存取權。

如果失敗的節點已無法存取，請刪除節點並隔離網路，確保不會意外重新加入 Cassandra 叢集。接著，啟動使用與原始節點相同 IP 位址的新節點，並在該節點上執行一般的 Apigee Bootstrap 步驟。

如果節點仍可存取，並想重複使用，請執行下列步驟：

1. 停止節點上的 Cassandra 程序：
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
2. 從節點解除安裝 Cassandra 軟體：
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
3. 清除節點中的資料目錄：
   rm -rf /opt/apigee/data/apigee-cassandra

完成上述步驟後，您應該會有節點的 IP 位址與無法安裝 Apigee 軟體的節點相同。請執行下列步驟：

1. 找出資料中心的種子節點。
   1. 在與還原節點位於相同資料中心的任何運作 Cassandra 節點上，執行下列指令：

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. 輸出的內容應如下所示：

      Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties
      Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties
      Found key conf_cassandra_seeds, with value, "10.1.0.1,10.1.0.2", in /opt/apigee/token/application/cassandra.properties
      apigee-configutil: apigee-cassandra: # OK

   3. 請參閱輸出內容的最後一行。這裡列出了以半形逗號分隔的 IP 位址，是由這個資料中心的節點使用種子節點。
2. 在要還原的新節點上建立或編輯下列檔案：
   

   vi /opt/apigee/customer/application/cassandra.properties
   

3. Add the following line:
   

   conf_jvm_options_custom_settings=-Dcassandra.replace_address=<ip-address-of-dead-node>

4. 如果這個節點是其中一個種子節點 (節點的 IP 位址顯示在步驟 1 的種子節點清單中)，請在檔案中新增一行：
   

   conf_cassandra_seeds="<comma-separated-seed-list-except-this-node’s-ip>"

   1. 舉例來說，在上述範例中，種子清單有 2 個 IP - 10.1.0.1 &10.1.0.2.如果要還原的節點是 10.1.0.1，新增一行如下：
      

      conf_cassandra_seeds="10.1.0.2"

5. 儲存檔案，確認檔案具備擁有權，Apigee 使用者可讀取：
   

   chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

6. 安裝 Cassandra 軟體：
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

7. 執行 Cassandra 設定：
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f <configFile>

8. 設定會在內部嘗試啟動 Cassandra 服務。視從其他節點串流的資料量、網路處理量等條件而定，這項作業可能需要較長時間。
9. [進階選項] 可在節點上執行下列 nodetool 指令，加快資料串流作業：
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. Cassandra 節點恢復後，請使用類似下方的標準指令，驗證節點是否已成功加入環形：
    

    /opt/apigee/apigee-cassandra/bin/nodetool ring
    /opt/apigee/apigee-cassandra/bin/nodetool status

11. 確認節點能順利執行後，請再次編輯 /opt/apigee/customer/application/cassandra.properties 檔案，並移除先前在步驟 3 和 4 中新增的各行。
12. 在節點上重新啟動 Cassandra 服務：
    

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

還原完整的叢集

1. 停止整個叢集。
2. 從備份檔案還原所有 Cassandra 節點。
3. 啟動 Cassandra 叢集。
4. 重新啟動所有元件。

PostgreSQL 資料庫

執行獨立或 Cloud Storage 的 PosgreSQL 主要

1. 停止所有節點上的管理伺服器、Qpid Server 和 Postgres Server：

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

2. 重新安裝 PostgreSQL 資料庫：

   /apigee/apigee-service/bin/apigee-service apigee-postgresql install 

3. 啟動 PostgreSQL：

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

4. 從備份檔案還原 PostgreSQL 資料庫：

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2019.03.17,14.40.41

   請注意，還原 PostgreSQL 元件時，不會指定將 備份檔案，也不會指定「.dump」尾碼。您只需指定 備份檔案名稱的日期/時間部分。

   您可以選擇在 restore 指令中省略備份檔案，Edge 將 使用元件備份目錄中最新的備份檔案。

5. 在所有節點上啟動管理伺服器、Qpid Server 和 Postgres Server：

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

PosgreSQL 以待命模式運作

1. 重新安裝 PostgreSQL 資料庫：

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql install

2. 使用當初安裝的設定檔，重新設定 PostgreSQL 資料庫：
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup -f configFile

3. 啟動 PostgreSQL：

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start 

Postgres 伺服器

1. 在所有主要節點和待命節點上停止 Postgres Server：

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

2. 移除舊的 Postgres Server 目錄：

   /opt/apigee/data/edge-postgres-server /opt/apigee/etc/edge-postgres-server.d

3. 重新安裝 Postgres 伺服器：

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

4. 從備份檔案還原 Postgres Server：

   /opt/apigee/apigee-service/bin/apigee-service edge-postgre-server restore 2019.03.17,14.40.41

   請注意，還原元件時，您無法指定備份的目錄路徑 檔案，也不會指定「backup-」前置字串或「.tar.gz」尾碼。您只需指定 備份檔案名稱的日期/時間部分。

   您可以選擇在 restore 指令中省略備份檔案，Edge 將 使用元件備份目錄中最新的備份檔案。

5. 在所有主要節點和待命節點上啟動 Postgres Server：

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

Qpid 伺服器和 Qpidd

1. 在所有節點中停止 Qpidd、Qpid 伺服器和 Postgres Server：
   

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

2. 移除舊的 Qpid 伺服器和 Qpidd 目錄：

   /opt/apigee/data/edge-qpid-server
   /opt/apigee/etc/edge-qpid-server.d
   /opt/apigee/data/apigee-qpidd
   /opt/apigee/etc/apigee-qpidd.d 

3. 重新安裝 Qpidd：

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd install 

4. 還原 Qpidd：

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restore 2019.03.17,14.40.41

   請注意，還原元件時，您無法指定備份的目錄路徑 檔案，也不會指定「backup-」前置字串或「.tar.gz」尾碼。您只需指定 備份檔案名稱的日期/時間部分。

   您可以選擇在 restore 指令中省略備份檔案，Edge 將 使用元件備份目錄中最新的備份檔案。

5. 從 Qpidd 開始：

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start 

6. 重新安裝 Qpid 伺服器：

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

7. 還原 Qpid 伺服器：

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restore 2019.03.17,14.40.41

   請注意，還原元件時，您無法指定備份的目錄路徑 檔案，也不會指定「backup-」前置字串或「.tar.gz」尾碼。您只需指定 備份檔案名稱的日期/時間部分。

   您可以選擇在 restore 指令中省略備份檔案，Edge 將 使用元件備份目錄中最新的備份檔案。

8. 在所有節點上重新啟動 Qpid Server、Qpidd 和 Postgres 伺服器：

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

OpenLDAP

1. 停止 OpenLDAP：

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop

2. 重新安裝 OpenLDAP：

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap install

3. 移除舊的 OpenLDAP 目錄：

   /opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d

4. 還原 OpenLDAP：

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restore 2019.03.17,14.40.41

   請注意，還原元件時，您無法指定備份的目錄路徑 檔案，也不會指定「backup-」前置字串或「.tar.gz」尾碼。您只需指定 備份檔案名稱的日期/時間部分。

   您可以選擇在 restore 指令中省略備份檔案，Edge 將 使用元件備份目錄中最新的備份檔案。

5. 重新啟動 OpenLDAP：

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap start

6. 重新啟動所有管理伺服器：

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

管理伺服器

1. 停止管理伺服器：

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

2. 移除舊的「管理伺服器」目錄：

   /opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d

3. 重新安裝管理伺服器：

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

4. 從備份檔案還原管理伺服器：

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restore 2019.03.17,14.40.41

   請注意，還原元件時，您無法指定備份的目錄路徑 檔案，也不會指定「backup-」前置字串或「.tar.gz」尾碼。您只需指定 備份檔案名稱的日期/時間部分。

   您可以選擇在 restore 指令中省略備份檔案，Edge 將 使用元件備份目錄中最新的備份檔案。

5. 重新啟動管理伺服器：

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

訊息處理器

1. 停止訊息處理器：

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

2. 移除舊的訊息處理器目錄：

   /opt/apigee/data/edge-message-processor
   /opt/apigee/etc/edge-message-processor.d

3. 重新安裝訊息處理器：

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

4. 從備份檔案還原訊息處理器：

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restore 2019.03.17,14.40.41

   請注意，還原元件時，您無法指定備份的目錄路徑 檔案，也不會指定「backup-」前置字串或「.tar.gz」尾碼。您只需指定 備份檔案名稱的日期/時間部分。

   您可以選擇在 restore 指令中省略備份檔案，Edge 將 使用元件備份目錄中最新的備份檔案。

5. 重新啟動訊息處理器：

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

路由器

1. 停止路由器：

   /opt/apigee/apigee-service/bin/apigee-service edge-router stop

2. 移除舊的路由器目錄：

   /opt/apigee/data/edge-router
   /opt/apigee/etc/edge-router.d

3. 重新安裝路由器：
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router install

4. 從備份檔案還原路由器：

   /opt/apigee/apigee-service/bin/apigee-service edge-router restore 2019.03.17,14.40.41

   請注意，還原元件時，您無法指定備份的目錄路徑 檔案，也不會指定「backup-」前置字串或「.tar.gz」尾碼。您只需指定 備份檔案名稱的日期/時間部分。

   您可以選擇在 restore 指令中省略備份檔案，Edge 將 使用元件備份目錄中最新的備份檔案。

5. 重新啟動路由器：
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router start

Edge UI

1. 停止 UI：

   /opt/apigee/apigee-service/bin/apigee-service edge-ui stop

2. 移除舊版 UI 目錄：

   /opt/apigee/data/edge-ui
   /opt/apigee/etc/edge-ui.d

3. 重新安裝 UI：
   

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

4. 從備份檔案還原 UI：

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restore 2019.03.17,14.40.41

   請注意，還原元件時，您無法指定備份的目錄路徑 檔案，也不會指定「backup-」前置字串或「.tar.gz」尾碼。您只需指定 備份檔案名稱的日期/時間部分。

   您可以選擇在 restore 指令中省略備份檔案，Edge 將 使用元件備份目錄中最新的備份檔案。

5. 重新啟動 UI：
   

   /opt/apigee/apigee-service/bin/apigee-service edge-ui start

完成站點復原

1. 停止所有元件節點。請注意，停止子系統的順序十分重要： 停止所有 Edge 節點，「然後」停止所有資料儲存庫節點。
2. 按照上述說明還原所有元件。
3. 現在，請依照下列順序啟動所有元件。請注意， 子系統很重要：
   1. 啟動 ZooKeeper 叢集
   2. 啟動 Cassandra 叢集
   3. 確認 OpenLDAP 運作正常
   4. 開始 qpid
   5. 確認 PostgreSQL 資料庫已啟動且正在運作
   6. 啟動管理伺服器
   7. 啟動路由器和訊息處理器
   8. 啟動 Qpid 伺服器
   9. 啟動 Postgres 伺服器
   10. 啟動 Apigee UI