停用資料中心

有時，您可能需要停用資料中心。舉例來說，如果您要升級作業系統，就必須在新的資料中心安裝新的作業系統，然後停用舊的資料中心。以下各節將舉例說明如何停用資料中心，其中 12 節點叢集安裝有兩個資料中心，分別是 dc-1 和 dc-2：

• dc-1 是要停用的資料中心。
• dc-2 是第二個資料中心，用於停用程序。

如果您要升級作業系統，dc-2 可能是您安裝新版作業系統 (OS) 的資料中心。不過，停用資料中心不一定要安裝新的 OS。

停用資料中心前的注意事項

停用資料中心時，請注意下列事項：

• 封鎖傳送至要停用資料中心的所有執行階段和管理流量，並將這些流量重新導向至其他資料中心。
• 停用資料中心後，Apigee 叢集的容量會減少。為彌補這項損失，請考慮在停用後增加其餘資料中心的容量，或新增資料中心。
• 在停用過程中，分析資料可能會遺失，具體取決於要停用的資料中心安裝了哪些分析元件。詳情請參閱「新增或移除 Qpid 節點」。
• 在停用資料中心之前，您應瞭解所有資料中心內所有元件的設定方式，尤其是 OpenLDAP、ZooKeeper、Cassandra 和 Postgres 伺服器。此外，您也應備份所有元件及其設定。

事前準備

• 管理伺服器： 所有停用步驟都高度依賴管理伺服器。如果只有一個管理伺服器可用，建議您先在 dc-1 以外的資料中心安裝新的管理伺服器元件，再停用 dc-1 上的管理伺服器，並確保其中一個管理伺服器一律可用。
• 路由器： 在停用路由器之前，請封鎖通訊埠 15999，停用路由器的連線能力。確認沒有任何執行階段流量導向要停用的路由器。

• Cassandra 和 ZooKeeper： 以下各節說明如何在雙資料中心設定中停用 dc-1。 如果您有兩個以上的資料中心，請務必從其餘所有資料中心的所有靜默設定檔中，移除所有指向要停用的節點 (在本例中為 dc-1) 的參照。針對要停用的 Cassandra 節點，請從 CASS_HOSTS 中捨棄這些主機。其餘 Cassandra 節點應維持 CASS_HOSTS 的原始順序。

• Postgres：如果停用 Postgres 主節點，請務必將任何可用的待命節點升級為新的 Postgres 主節點。雖然 QPID 伺服器會在佇列中保留緩衝區，但如果 Postgres 主伺服器長時間無法使用，您可能會遺失數據分析資料。

必要條件

• 建議您先完整備份所有節點，再停用任何元件。請按照目前 Edge 版本的程序執行備份。如要進一步瞭解備份，請參閱「備份與還原」。

  注意：如果您有多個 Cassandra 或 ZooKeeper 節點，請逐一備份，因為備份程序會暫時關閉 ZooKeeper。

• 使用下列指令，確保 Edge 在停用前正常運作：

  /opt/apigee/apigee-service/bin/apigee-all status

• 確認目前沒有任何執行階段流量傳送至要停用的資料中心。

停用元件的順序

如果您在多個節點上安裝 Edge for Private Cloud，請按照下列順序停用這些節點上的 Edge 元件：

1. Edge UI (edge-ui)
2. Management Server (edge-management-server)
3. OpenLDAP (apigee-openldap)
4. 路由器 (邊緣路由器)
5. 訊息處理器 (edge-message-processor)
6. Qpid 伺服器和 Qpidd (edge-qpid-server 和 apigee-qpidd)
7. Postgres 和 PostgreSQL 資料庫 (edge-postgres-server 和 apigee-postgresql)
8. ZooKeeper (apigee-zookeeper)
9. Cassandra (apigee-cassandra)

以下各節將說明如何停用各個元件。

Edge UI

如要停止並解除安裝 dc-1 的 Edge UI 元件，請輸入下列指令：

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

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

管理伺服器

如要停用 dc-1 上的 Management Server，請按照下列步驟操作：

1. 停止 dc-1 上的管理伺服器：

   apigee-service edge-management-server stop

2. 找出在 dc-1 註冊的管理伺服器 UUID：

   curl -u <AdminEmailID>:'<AdminPassword>' \
   -X GET “http://{MS_IP}:8080/v1/servers?pod=central&region=dc-1&type=management-server”

3. 取消註冊伺服器的類型：

   curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
   -d "type=management-server&region=dc-1&pod=central&uuid=UUID&action=remove"

4. 刪除伺服器。注意：如果這部伺服器上也安裝了其他元件，請先取消註冊所有元件，再刪除 UUID。

   curl -u <AdminEmailID>:'<AdminPassword> -X DELETE http://{MS_IP}:8080/v1/servers/{UUID}

5. 解除安裝 dc-1 上的管理伺服器元件：

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

Open LDAP

本節說明如何在 dc-1 上停用 OpenLDAP。

注意：如果您有兩個以上的資料中心，請參閱下方的「設定兩個以上的資料中心」。

如要停用 dc-1 上的 OpenLDAP，請按照下列步驟操作：

1. 按照「如何備份」中的步驟，備份 dc-1 OpenLDAP 節點。

2. 在兩個資料中心 (dc-1 和 dc-2) 執行下列步驟，中斷兩者之間的資料複製作業。

   1. 查看目前狀態：

      ldapsearch -H ldap://{HOST}:{PORT} -LLL -x -b "cn=config" -D "cn=admin,cn=config" -w {credentials} -o ldif-wrap=no 'olcSyncRepl' | grep olcSyncrepl

      輸出內容應與下方類似：

      olcSyncrepl: {0}rid=001 provider=ldap://{HOST}:{PORT}/ binddn="cn=manager,dc=apigee,dc=com" bindmethod=simple credentials={credentials} searchbase="dc=apigee,dc=com" attrs="*,+" type=refreshAndPersist retry="60 1 300 12 7200 +" timeout=1

   2. 建立包含下列指令的檔案 break_repl.ldif：

      dn: olcDatabase={2}bdb,cn=config
      changetype: modify
      delete: olcSyncRepl
      
      dn: olcDatabase={2}bdb,cn=config
      changetype: modify
      delete: olcMirrorMode

   3. 執行 ldapmodify 指令：

      ldapmodify -x -w {credentials} -D "cn=admin,cn=config" -H "ldap://{HOST}:{PORT}/" -f path/to/file/break_repl.ldif

      輸出內容應與下方類似：

      modifying entry "olcDatabase={2}bdb,cn=config"
      modifying entry "olcDatabase={2}bdb,cn=config"

3. 您可以在 dc-2 LDAP 中建立項目，並確認該項目未顯示在 dc-1 的 LDAP 中，藉此確認 dc-2 不再複製到 dc-1。

   您也可以選擇按照下列步驟，在 dc-2 OpenLDAP 節點中建立唯讀權限使用者，然後檢查使用者是否已複製。使用者隨後會遭到刪除。

   1. 在 dc-2 中建立 readonly-user.ldif 檔案，並加入以下內容：

      dn: uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com
      objectClass: organizationalPerson
      objectClass: person
      objectClass: inetOrgPerson
      objectClass: top
      cn: readonly-user
      sn: readonly-user
      userPassword: {testPassword}

   2. 在 dc-2 中使用 `ldapadd` 指令新增使用者：

      ldapadd -H ldap://{HOST}:{PORT} -w {credentials} -D "cn=manager,dc=apigee,dc=com" -f path/to/file/readonly-user.ldif

      輸出內容大致如下：

      adding new entry "uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com"

   3. 在 dc-1 中搜尋使用者，確認使用者未複製。如果使用者不在 dc-1 中，則可確定兩個 LDAP 都不再複製：

      ldapsearch -H ldap://{HOST}:{PORT} -x -w {credentials} -D "cn=manager,dc=apigee,dc=com" -b uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com -LLL

      畫面會顯示如下的輸出內容：

      No such object (32)
      Matched DN: ou=users,ou=global,dc=apigee,dc=com

   4. 移除先前新增的唯讀權限使用者：

      ldapdelete -v -H ldap://{HOST}:{PORT} -w {credentials} -D "cn=manager,dc=apigee,dc=com" "uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com"

4. 停止 dc-1 中的 OpenLDAP：

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

5. 解除安裝 dc-1 上的 OpenLDAP 元件：

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap uninstall

路由器

本節說明如何停用路由器。如要進一步瞭解如何移除路由器，請參閱「 移除伺服器」。

下列步驟會停用 dc-1 的路由器。如果 dc-1 中設定了多個路由器節點，請逐一在所有路由器節點中執行步驟

注意：這裡假設負載平衡器已設定路由器的健康狀態檢查通訊埠 15999，且封鎖通訊埠 15999 會導致路由器無法連線。您可能需要具備 Root 存取權，才能封鎖通訊埠。

如要停用路由器，請按照下列步驟操作：

1. 封鎖健康狀態檢查通訊埠 15999，停用路由器的可連性。確認這個資料中心的執行階段流量已遭到封鎖：

   iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT

2. 確認路由器可連線：

   curl -vvv -X GET http://{ROUTER_IP}:15999/v1/servers/self/reachable

   輸出內容應與下方類似：

   About to connect() to 10.126.0.160 port 15999 (#0)
   Trying 10.126.0.160...
   Connection refused
   Failed connect to 10.126.0.160:15999; Connection refused
   Closing connection 0
   curl: (7) Failed connect to 10.126.0.160:15999; Connection refused

3. 按照「取得 UUID」一節的說明，取得路由器的 UUID。
4. 停止路由器：

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

5. 使用下列指令，列出組織中可用的閘道 Pod：

   curl -u  <AdminEmailID>:<AdminPassword> -X GET "http://{MS_IP}:8080/v1/organizations/{ORG}/pods"

   請參閱「 關於 Pod」。

6. 取消註冊伺服器類型：

   curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
   -d "type=router&amp;region=dc-1&amp;pod=gateway-1&amp;uuid=UUID&amp;action=remove"

7. 刪除伺服器：

   curl -u <AdminEmailID>:'<AdminPassword>’ -X DELETE http://{MS_IP}:8080/v1/servers/UUID

8. 解除安裝 edge-router：

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

   請參閱「 移除伺服器」。
9. 清除 iptables 規則，啟用遭封鎖的通訊埠 15999：

   iptables -F

訊息處理器

本節說明如何從 dc-1 停用訊息處理器。如要進一步瞭解如何移除訊息處理器，請參閱「 移除伺服器」。

假設 dc-1 採用12 節點叢集安裝，則 dc-1 中會設定兩個訊息處理器節點。在兩個節點中執行下列指令。

1. 按照「取得 UUID」一節的說明，取得訊息處理器的 UUID。
2. 停止訊息處理器：

   apigee-service edge-message-processor stop

3. 取消註冊伺服器類型：

   curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers  \
   -d "type=message-processor&amp;region=dc-1&amp;pod=gateway-1&amp;uuid=UUID&amp;action=remove"/pre>

4. Disassociate an environment from the Message Processor.

   Note: You need to remove the bindings on each org/env that associates the Message Processor UUID.

   curl -H "Content-Type:application/x-www-form-urlencoded" -u <AdminEmailID>:''  \
   -X POST http://{MS_IP}:8080/v1/organizations/{ORG}/environments/{ENV}/servers \
   -d "action=remove&uuid=UUID"

5. 取消註冊伺服器類型：

   curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://MS_IP:8080/v1/servers -d "type=message-processor&region=dc-1&pod=gateway-1&uuid=UUID&action=remove"

6. 解除安裝訊息處理器：

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

7. 取消註冊伺服器：

   curl -u <AdminEmailID>:'<AdminPassword> -X DELETE http://{MS_IP}:8080/v1/servers/UUID

Qpid 伺服器和 Qpidd

本節說明如何停用 Qpid 伺服器 (edge-qpid-server) 和 Qpidd (apigee-qpidd)。dc-1 中設定了兩個 Qpid 節點，因此您必須對這兩個節點執行下列步驟：

1. 按照「取得 UUID」一節的說明，取得 Qpidd 的 UUID。
2. 停止 edge-qpid-server 和 apigee-qpidd：

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

3. 取得 Analytics 和消費者群組清單：

   curl -u <AdminEmailID>:'<AdminPassword>' -X GET http://{MS_IP}:8080/v1/analytics/groups/ax

4. 從消費者群組中移除 Qpid：

   curl -u <AdminEmailID>:'<AdminPassword>' -H "Content-Type: application/json"  -X DELETE \ "http://{MS_IP}:8080/v1/analytics/groups/ax/{ax_group}/consumer-groups/{consumer_group}/consumers/{QPID_UUID}"

5. 從數據分析群組中移除 Qpid：

   curl -v -u <AdminEmailID>:'<AdminPassword>' \
   -X DELETE "http://{MS_IP}:8080/v1/analytics/groups/ax/{ax_group}/servers?uuid={QPID_UUID}&type=qpid-server"

6. 從 Edge 安裝作業中取消註冊 Qpid 伺服器：

   curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
   -d "type=qpid-server&region=dc-1&pod=central&uuid={QPID_UUID}&action=remove"

7. 從 Edge 安裝作業中移除 Qpid 伺服器：

   curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID

8. 重新啟動所有節點上的所有 edge-qpid-server 元件，確保這些元件採用變更：

   $ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
   $ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready

9. 解除安裝 edge-qpid-server 和 apigee-qpidd：

   $ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall
   $ /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall

Postgres 和 Postgresql

您要停用的資料中心可能含有 Postgres 主執行個體或 Postgres 待命執行個體。以下各節將說明如何停用這些項目：

• 停用 Postgres 主要執行個體
• 停用 Postgres 待命執行個體

停用 Postgres 主要執行個體

注意：如果停用 Postgres 主節點，請務必將任何可用的待命節點升級為新的 Postgres 主節點。雖然 QPID 佇列會緩衝資料，但如果 Postgres 主執行個體長時間無法使用，您可能會遺失數據分析資料。

如要停用 Postgres 主節點，請按照下列步驟操作：

1. 請按照下列連結中的指示，備份 dc-1 Postgres 主要節點：
   • 備份與還原
   • 如何備份
2. 按照「取得 UUID」一文所述，取得 Postgres 伺服器的 UUID。
3. 在 dc-1 上，停止目前主要節點上的 edge-postgres-server 和 apigee-postgresql：

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

4. 在 dc-2 的待命節點上，輸入下列指令，將其設為主節點：

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql promote-standby-to-master <IP of OLD Progress master>

   注意：如果您有多個待命 Postgres 節點，則必須在新的主節點上新增主機項目，並更新所有可用 Postgres 待命節點的複製設定。

   如要將主機項目新增至新的 Postgres 主節點，請按照下方適用章節中的步驟操作：

   如果只剩一個待命節點

   舉例來說，假設在停用前，已設定三個 Postgres 節點。您已停用現有的主要節點，並將其中一個剩餘的 Postgres 待命節點升級為主要節點。請按照下列步驟設定其餘待命節點：

   1. 在新主要執行個體上，編輯設定檔並設定：

      PG_MASTER=IP_or_DNS_of_new_PG_MASTER
      PG_STANDBY=IP_or_DNS_of_PG_STANDBY

   2. 在新主要執行個體上啟用複製功能：

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFIle

   如果有多個待命節點

   1. 在 /opt/apigee/customer/application/postgresql.properties 中新增下列設定：

      conf_pg_hba_replication.connection=host replication apigee standby_1_ip/32 trust \n host replication apigee standby_2_ip/32 trust

   2. 確認 /opt/apigee/customer/application/postgresql.properties 檔案的擁有者是 apigee 使用者：

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

   3. 重新啟動 apigee-postgresql：

      apigee-service apigee-postgresql restart

   如要更新待命節點的複製設定，請按照下列步驟操作：

   1. 修改設定檔 /opt/silent.conf，並使用新 Postgres 主要執行個體的 IP 位址更新 PG_MASTER 欄位。
   2. 使用下列指令移除所有舊的 Postgres 資料：

      rm -rf /opt/apigee/data/apigee-postgresql/

   3. 在待命節點上設定複製作業：

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

   4. 在 dc-2 中輸入下列指令，確認 Postgres 主要執行個體設定正確：

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

   5. 從數據分析群組和消費者群組中移除及新增 PostgreSQL 伺服器。
      1. 按照「 從數據分析群組中移除 Postgres 伺服器」一文的操作說明，從數據分析群組中移除舊的 Postgres 伺服器。
      2. 按照「 將現有 Postgres 伺服器新增至數據分析群組」一文中的操作說明，將新的 Postgres 伺服器新增至數據分析群組。
   6. 從 dc-1 取消註冊舊的 postgres 伺服器：

      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
      -d "type=postgres-server&region=dc-1&pod=analytics&uuid=UUID&action=remove"<

   7. 從 dc-1 刪除舊的 postgres 伺服器：

      curl -u >AdminEmailID>:'>AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID

   8. 現在可以放心停用舊的 Postgres 主要執行個體。解除安裝 edge-postgres-server 和 apigee-postgresql：

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server uninstall
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql uninstall

   停用 Postgres 待命執行個體

   注意：12 節點叢集安裝說明文件會將 dc-1 postgresql 節點顯示為主要節點，但為方便起見，本節假設 dc-1 postgresql 節點為待命節點，dc-2 postgresql 節點為主要節點。

   如要停用 Postgres 待命，請按照下列步驟操作：

   1. 按照「取得 UUID」中的操作說明，取得 Postgres 伺服器的 UUID。
   2. 停止 dc-1 中目前待命節點上的 apigee-postgresql：

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

   3. 從數據分析群組和消費者群組中移除及新增 PostgreSQL 伺服器。
      1. 按照「 從數據分析群組中移除 Postgres 伺服器」一文的操作說明，從數據分析群組中移除舊的 Postgres 伺服器。
      2. 按照「 將現有 Postgres 伺服器新增至數據分析群組」一文中的操作說明，將新的 Postgres 伺服器新增至數據分析群組。
   4. 從 dc-1 取消註冊舊的 postgres 伺服器：

      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
      -d "type=postgres-server&region=dc-1&pod=analytics&uuid=UUID&action=remove"<

   5. 從 dc-1 刪除舊的 postgres 伺服器：

      curl -u >AdminEmailID>:'>AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID

   6. 現在可以放心停用舊的 Postgres 主要執行個體。解除安裝 edge-postgres-server 和 apigee-postgresql：

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server uninstall
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql uninstall

   ZooKeeper 和 Cassandra

   本節說明如何在雙資料中心設定中，停用 ZooKeeper 和 Cassandra 伺服器。

   如果您有兩個以上的資料中心，請務必從其餘所有資料中心的所有靜默設定檔中，移除所有指向要停用的節點 (在本例中為 dc-1) 的參照。針對要停用的 Cassandra 節點，請從 CASS_HOSTS 中捨棄這些主機。其餘 Cassandra 節點應維持 CASS_HOSTS 的原始順序。

   ZooKeeper 附註：修改設定檔中的 ZK_HOST 屬性時，必須維持投票節點的仲裁，確保 ZooKeeper 集合能正常運作。設定中的投票者節點數量必須為奇數。詳情請參閱「Apache ZooKeeper 維護工作」。

   如要停用 ZooKeeper 和 Cassandra 伺服器，請按照下列步驟操作：

   1. 請按照下列連結中的指示，備份 dc-1 Cassandra 和 ZooKeeper 節點：
      • 備份與還原
      • 如何備份

   2. 列出資料中心內 ZooKeeper 和 Cassandra 伺服器的 UUID，Cassandra 節點即將在該資料中心停用。

      apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin <AdminEmailID> --pwd '<AdminPassword>' --host localhost

   3. 取消註冊伺服器類型：

      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://MS_IP:8080/v1/servers -d "type=cache-datastore&type=user-settings-datastore&type=scheduler-datastore&type=audit-datastore&type=apimodel-datastore&type=application-datastore&type=edgenotification-datastore&type=identityzone-datastore&type=user-settings-datastore&type=auth-datastore&region=dc-1&pod=central&uuid=UUID&action=remove"

   4. 取消註冊伺服器：

      curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MS_IP:8080/v1/servers/UUID

   5. 更新設定檔，從 ZK_HOSTS 和 CASS_HOSTS 移除已停用節點的 IP。

      範例：假設您在 dc-1 中有 IP $IP1 $IP2 $IP3，在 dc-2 中有 $IP4 $IP5 $IP6，而您要停用 dc-1。然後從設定檔中移除 IP $IP1 $IP2 $IP3。

      • 現有的設定檔項目：

        ZK_HOSTS="$IP1 $IP2 $IP3 $IP4 $IP5 $IP6"
        CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1, $IP4:2,1 $IP5:2,1 $IP6:2,1”

      • 新的設定檔項目：

        ZK_HOSTS="$IP4 $IP5 $IP6"
        CASS_HOSTS="$IP4:2,1 $IP5:2,1 $IP6:2,1"

   6. 使用已移除的停用節點 IP 更新自動設定檔 (在步驟 e 中修改)，並在託管管理伺服器的所有節點上執行管理伺服器設定檔：

      /opt/apigee/apigee-setup/bin/setup.sh -p ms -f updated_config_file

   7. 使用已移除的停用節點 IP 更新設定檔，並在所有路由器和訊息處理器節點上執行 MP/RMP 設定檔：
      • 如果 Edge 路由器和訊息處理器是在同一個節點上設定，請輸入：

        /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f updated_config_file

      • 如果 Edge 路由器和訊息處理器是在不同的節點上設定，請輸入以下內容：

        路由器：

        /opt/apigee/apigee-setup/bin/setup.sh -p r -f updated_config_file

        訊息處理器：

        /opt/apigee/apigee-setup/bin/setup.sh -p mp -f updated_config_file

   8. 重新設定所有 Qpid 節點，並從回應檔案中移除已停用節點的 IP：

      /opt/apigee/apigee-setup/bin/setup.sh -p qs -f updated_config_file

   9. 重新設定所有 Postgres 節點，並從回應檔案中移除已停用節點的 IP：

      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f updated_config_file

   10. 修改 system_auth 鍵空間。如果現有 Cassandra 節點已啟用 Cassandra 驗證，請執行下列指令，更新 system_auth 鍵空間的複製係數：

       ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-2': '3'};

       這個指令會將複製係數設為 '3'，表示叢集中有三個 Cassandra 節點。請視需要修改這個值。

       完成這個步驟後，Cassandra 拓撲的任何鍵空間都不應有 dc-1。

   11. 逐一停用 dc-1 上的 Cassandra 節點。

       如要停用 Cassandra 節點，請輸入下列指令：

       /opt/apigee/apigee-cassandra/bin/nodetool -h cassIP -u cassandra -pw '<AdminPassword>' decommission

   12. 使用下列其中一個指令，檢查 dc-1 的 Cassandra 節點連線：

       /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p '<AdminPassword>'

       或是在已停用的節點上執行次要驗證指令：

       /opt/apigee/apigee-cassandra/bin/nodetool netstats

       上述指令應會傳回：

       Mode: DECOMMISSIONED

   13. 為 dc-2 中的所有 Cassandra 和 ZooKeeper 節點執行 DS 設定檔：

       /opt/apigee/apigee-setup/bin/setup.sh -p ds -f updated_config_file

   14. 停止 dc-1 中的 apigee-cassandra 和 apigee-zookeeper：

       apigee-service apigee-cassandra stop
       apigee-service apigee-zookeeper stop

   15. 在 dc-1 中解除安裝 apigee-cassandra 和 apigee-zookeeper：

       apigee-service apigee-cassandra uninstall
       apigee-service apigee-zookeeper uninstall

   刪除 dc-1 的繫結

   如要刪除 dc-1 的繫結，請按照下列步驟操作：

   1. 刪除 dc-1 的繫結。
      1. 列出組織下的所有可用 Pod：

         curl -v -u  <AdminEmailID>:<AdminPassword> -X GET "http://MS_IP:8080/v1/o/ORG/pods"

      2. 如要確認是否已移除所有繫結，請取得與 Pod 相關聯的伺服器 UUID：

         curl -v -u  <AdminEmailID>:<AdminPassword> \
         -X GET "http://MS_IP:8080/v1/regions/dc-1/pods/gateway-1/servers"

         如果這個指令未傳回任何 UUID，表示先前的步驟已移除所有繫結，您可以略過下一個步驟。否則，請執行下一個步驟。

      3. 移除上一個步驟中取得的 UUID 所有伺服器繫結：

         curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MS_IP:8080/v1/servers/UUID

      4. 取消機構與 Pod 的關聯：

         curl -v -u  <AdminEmailID>:<AdminPassword>  "http://MS_IP:8080/v1/o/ORG/pods" -d "action=remove&region=dc-1&pod=gateway-1" -H "Content-Type: application/x-www-form-urlencoded" -X POST

   2. 刪除 Pod：

      curl -v -u <AdminEmailID>:<AdminPassword> "http://MS_IP:8080/v1/regions/dc-1/pods/gateway-1" -X DELETE

   3. 刪除區域。

      curl -v -u <AdminEmailID>:<AdminPassword>  "http://MS_IP:8080/v1/regions/dc-1" -X DELETE

   注意：如果刪除伺服器時漏掉其中一個步驟，上述步驟會傳回錯誤訊息，指出 Pod 中仍有特定伺服器。因此，請按照下方的疑難排解步驟刪除這些資源，並自訂 curl 指令中的類型。

   此時，您已完成 dc-1 的停用作業。

   附錄

   疑難排解

   如果執行上述步驟後，某些 Pod 中仍有伺服器，請按照下列步驟取消註冊並刪除伺服器。注意：請視需要變更類型和 Pod。

   1. 使用下列指令取得 UUID：

      apigee-adminapi.sh servers list -r dc-1 -p POD -t  --admin <AdminEmailID> --pwd  '<AdminPassword>’ --host localhost

   2. 取消註冊伺服器的類型：

      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://MP_IP:8080/v1/servers -d "type=TYPE=REGION=dc-1&pod=POD&uuid=UUID&action=remove"

   3. 逐一刪除伺服器：

      curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MP_IP:8080/v1/servers/UUID

   驗證

   您可以使用下列指令，驗證停用作業。

   管理伺服器

   在所有區域的管理伺服器上執行下列指令。

   curl -v  -u  <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/servers?pod=central&region=dc-1
   curl -v  -u  <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/servers?pod=gateway&region=dc-1
   curl -v -u  <AdminEmailID>:'<AdminPassword>'  http://MS_IP:8080/v1/servers?pod=analytics&region=dc-1

   在所有元件上執行下列指令，檢查所有管理通訊埠的通訊埠需求。

   curl -v http://MS_IP:8080/v1/servers/self

   查看數據分析群組。

   curl  -v  -u  <AdminEmailID>:'<AdminPassword>' "http://MS_IP:8080}/v1/o/ORG/e/ENV/provisioning/axstatus"
   curl -v  -u  <AdminEmailID>:'<AdminPassword>'  http://MS_IP:8080/v1/analytics/groups/ax

   Cassandra/ZooKeeper 節點

   在所有 Cassandra 節點上輸入：

   /opt/apigee/apigee-cassandra/bin/nodetool -h <host> statusthrift

   這會傳回該特定節點的 running 或 not running 狀態。

   在一個節點上輸入：

   /opt/apigee/apigee-cassandra/bin/nodetool -h <host> ring

   /opt/apigee/apigee-cassandra/bin/nodetool -h <host> status

   上述指令會傳回使用中的資料中心資訊。

   在 ZooKeeper 節點上，先輸入：

   echo ruok | nc <host> 2181

   這個指令會傳回 imok。

   接著輸入：

   echo stat | nc <host> 2181 | grep Mode

   上述指令傳回的 Mode 值會是下列其中一項：observer、leader 或 follower。

   在一個 ZooKeeper 節點中：

   /opt/apigee/apigee-zookeeper/contrib/zk-tree.sh >> /tmp/zk-tree.out.txt

   在 Postgres 主要節點上執行：

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

   確認回應指出該節點是主要節點。

   在待命節點上：

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

   確認回應指出節點為待命節點。

   使用指令登入 PostgreSQL 資料庫

   psql -h localhost -d apigee -U postgres

   系統提示時，請輸入「postgres」使用者密碼：'postgres'。從數據分析中選取 max(client_received_start_timestamp)。

   ”$org.$env.fact” limit 1;

   記錄

   檢查元件的記錄，確認沒有錯誤。