將元件還原至現有環境

本文說明如何將任何 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. 如果單一 ZooKeeper 節點失敗,且該節點屬於集合的一部分,您可以建立具有相同主機名稱/IP 位址的新節點 (請按照「如何重新安裝及還原元件」一節所述的重新安裝步驟操作),當該節點加入 ZooKeeper 集合時,就會從 Leader 取得最新快照,並開始為用戶端提供服務。您不需要還原這個執行個體中的資料。

還原完整叢集

  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. 如果單一 Cassandra 節點失敗,且該節點屬於某個集合,您可以建立具有相同主機名稱/IP 位址的新節點 (請按照「如何重新安裝及還原元件」一文所述的重新安裝步驟操作)。您只需要重新安裝 Cassandra,不必還原資料。

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

    安裝 Cassandra 且節點啟動後 (假設所有 keyspace 的 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 資料庫

獨立執行的 PostgreSQL 或以主機身分執行

  1. 停止所有節點上的管理伺服器、Qpid 伺服器和 Postgres 伺服器:
    /opt/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 資料庫正在運作:
    /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 edge-qpid-server start
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

以待機模式執行的 PostgreSQL

  1. 使用安裝時所用的設定檔,重新設定 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

SymasLDAP

  1. 移除舊的 SymasLDAP 目錄:
    /opt/apigee/data/apigee-openldap
    /opt/apigee/etc/apigee-openldap.d
  2. 從備份檔案還原 SymasLDAP:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restore 2016.03.17,14.40.41
  3. 重新啟動 SymasLDAP:
    /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. 停止新版 Edge UI:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
  2. 移除舊的 New Edge UI 目錄:
    /opt/apigee/data/edge-management-ui
    /opt/apigee/etc/edge-management-ui.d
  3. 從備份檔案還原新版 Edge 使用者介面:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restore 2019.03.17,14.40.41

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

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

  4. 重新啟動新版 Edge 使用者介面:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui start