重新安裝及還原元件

本文件說明如何重新安裝及還原 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，不需要還原資料。

1. 重新安裝 Cassandra：

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

2. 使用安裝原始節點時相同的設定檔，在 Cassandra 節點上執行設定：

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

3. 啟動 Cassandra：

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

4. 安裝 Cassandra 後，節點就已啟用 (因為所有索引鍵空間的 RF>=2) 執行下列 nodetool 指令來初始化節點：
   

   /opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h localhost repair -pr

   只有在為 Cassandra 啟用 JMX 驗證時，才需要傳送使用者名稱和密碼。

還原完整叢集

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

PostgreSQL 資料庫

PosgreSQL 可獨立執行或做為主要版本

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

   /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 伺服器和 Postgres 伺服器：

   /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 的設定檔重新設定 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 伺服器：

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

2. 移除舊的 Postgres 伺服器目錄：

   /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 伺服器：

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

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

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

5. 在所有主要執行個體和待命節點中啟動 Postgres 伺服器：

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

Qpid 伺服器和 Qpidd

1. 在所有節點中停止 Qpidd、Qpid Server 和 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 伺服器、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