如何將元件還原至現有環境

私有雲 v4.19.01 的邊緣

本文件說明如何將任何 Edge 元件還原至現有環境，而不必重新安裝元件。這表示您要還原元件的節點，其 IP 位址或 DNS 名稱與執行備份時相同。

如需重新安裝元件，請參閱「如何重新安裝及還原元件」。

Apache ZooKeeper

還原一個獨立節點

1. 移除舊的 ZooKeeper 目錄：

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

2. 從備份檔案還原 ZooKeeper 資料：

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore backup-2016.03.17,14.40.41.tar.gz

3. 重新啟動所有元件，以使用還原的新 ZooKeeper 建立同步。

還原 1 個叢集節點

1. 如果單一 ZooKeeper 節點發生錯誤，其中一部分屬於整體節點，您可以使用相同的主機名稱/IP 位址建立新的節點 (按照「如何重新安裝及還原元件」中所述的重新安裝步驟)，並在加入 ZooKeeper 資源時取得領導者的最新快照，並開始為用戶端提供服務。您不需要還原這個執行個體中的資料。

還原完整叢集

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

Apache Cassandra

還原一個獨立節點

1. 移除舊的 Cassandra 目錄：

   /opt/apigee/data/apigee-cassandra

2. 從備份檔案還原 Cassandra 節點：

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup-2016.03.17,14.40.41.tar.gz

3. 重新啟動所有元件。

還原 1 個叢集節點

1. 如果單一 Cassandra 節點故障，屬於整體元件，則可使用相同的主機名稱/IP 位址建立新節點 (按照如何重新安裝及還原元件中所述的重新安裝步驟進行)。您只需要重新安裝 Cassandra，不需要還原資料。

   在非種子節點上執行還原作業時，請確認至少有一個 Cassandra 種子節點。

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

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
   /opt/apigee/apigee-service/bin/apigee-service apigee-sso 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 資料庫正在執行：

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql status

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

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2016.03.17,14.40.41.dump

4. 在「所有節點」上啟動管理伺服器、Qpid 伺服器和 Postgres 伺服器：

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server start
   /opt/apigee/apigee-service/bin/apigee-service apigee-sso 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 的設定檔重新設定 PostgreSQL 資料庫：

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

2. 啟動 PostgreSQL：

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

Postgres 伺服器

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

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

2. 從備份檔案還原 Postgres 伺服器：

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restore backup-2016.03.17,14.40.41.tar.gz

3. 啟動 Postgres 伺服器：

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

Qpidd 資料庫

1. 移除舊的 Qpidd 目錄：

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

2. 還原 Qpidd：

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restore backup-2016.03.17,14.40.41.tar.gz 

3. 開始 Qpidd：

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

Qpid 伺服器

1. 移除舊的 Qpid 伺服器目錄：

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

2. 從備份檔案還原 Qpid 伺服器：

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restore backup-2016.03.17,14.40.41.tar.gz

3. 啟動 Qpid 伺服器：

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

OpenLDAP

1. 移除舊的 OpenLDAP 目錄：

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

2. 從備份檔案還原 OpenLDAP：

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

3. 重新啟動 OpenLDAP：

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

管理伺服器

1. 移除舊的管理伺服器目錄：

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

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

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restore backup-2016.03.17,14.40.41.tar.gz

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

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

訊息處理器

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

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

2. 從備份檔案還原郵件處理器：

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restore backup-2016.03.17,14.40.41.tar.gz

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

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

路由器

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

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

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

   /opt/apigee/apigee-service/bin/apigee-service edge-router restore backup-2016.03.17,14.40.41.tar.gz

3. 重新啟動路由器：

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

Edge UI

1. 移除舊的 UI 目錄：

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

2. 從備份檔案還原 UI：

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restore backup-2016.03.17,14.40.41.tar.gz

3. 重新啟動 UI：

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