停用資料中心

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

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

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

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

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

• 封鎖所有傳送至停用資料中心的執行階段和管理流量，並將這些流量重新導向至其他資料中心。
• 資料中心停用後，Apigee 叢集的容量就會減少。 為彌補這項缺點，請考慮增加其餘資料中心的容量，或在停用後新增資料中心。
• 在停用程序期間，視停用資料中心安裝的 Analytics 元件而定，可能會遺失 Analytics 資料。詳情請參閱「新增或移除 Qpid 節點」。
• 停用資料中心前，請先瞭解所有資料中心的所有元件設定，尤其是 SymasLDAP、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 主機長時間無法使用，您可能會遺失 Analytics 資料。

必要條件

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

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

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

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

元件停用順序

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

1. Edge UI (edge-ui)
2. 管理伺服器 (edge-management-server)
3. Symas LDAP (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 上停用管理伺服器，請按照下列步驟操作：

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

Symas LDAP

本節說明如何停用 dc-1 上的 SymasLDAP。

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

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

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

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

   1. 檢查目前狀態：

            /opt/symas/bin/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}mdb,cn=config
      changetype: modify
      delete: olcSyncRepl
      
      dn: olcDatabase={2}mdb,cn=config
      changetype: modify
      delete: olcMirrorMode

   3. 執行 ldapmodify 指令：

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

      輸出內容應如下所示：

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

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

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

   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` 指令新增使用者：

      /opt/symas/bin/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 中沒有該使用者，您就能確定兩個 LDAPs 不再複製：

      /opt/symas/bin/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. 移除先前新增的唯讀使用者：

      /opt/symas/bin/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 中停止 SymasLDAP：

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

5. 在 dc-1 上解除安裝 SymasLDAP 元件：

   /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」一節所述，取得 Router 的 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&region=dc-1&pod=gateway-1&uuid=UUID&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 停用 Message Processor。如要進一步瞭解如何移除訊息處理器，請參閱「 移除伺服器」。

由於我們假設 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&region=dc-1&pod=gateway-1&uuid=UUID&action=remove"

4. 將環境與訊息處理工具取消關聯。

   curl -H "Content-Type:application/x-www-form-urlencoded" <AdminEmailID>:'<AdminPassword>’  \
   -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. 如要取得 Qpidd 的 UUID，請參閱「取得 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 主機長時間無法使用，您可能會遺失 Analytics 資料。

如要停用 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 節點。您已停用現有主要節點，並將其中一個剩餘的 PostgreSQL 待命節點升級為主要節點。按照下列步驟設定其餘待命節點：

   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. 從 Analytics 群組和消費者群組中移除及新增 PostgreSQL 伺服器。
      1. 按照「 從分析群組移除 PostgreSQL 伺服器」一文中的指示，從分析群組移除舊的 PostgreSQL 伺服器。
      2. 按照「 將現有 Postgres 伺服器新增至分析群組」一文中的操作說明，將新的 Postgres 伺服器新增至分析群組。
   6. 從 dc-1 取消註冊舊的 postgres 伺服器：

      curl -u <AdminEmailID>:<AdminPassword> -X POST http://{MS_IP}:8080/v1/servers \
      -d "type=postgres-server®ion=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」一文中的操作說明，取得 PostgreSQL 伺服器的 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. 從 Analytics 群組和消費者群組中移除及新增 PostgreSQL 伺服器。
      1. 按照「 從分析群組移除 PostgreSQL 伺服器」一文中的指示，從分析群組移除舊的 PostgreSQL 伺服器。
      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 中有 IP $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 Router 和 Message Processor 設定在同一個節點上，請輸入：

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

      • 如果 Edge Router 和 Message Processor 是在不同節點上設定，請輸入下列內容：

        路由器：

        /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

   此時，您已完成 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

   驗證

   您可以使用下列指令驗證停用程序。

   管理伺服器

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

      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

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

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

   3. 檢查數據分析群組。

      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 節點

   1. 在所有 Cassandra 節點上輸入：

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

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

   2. 在其中一個節點上輸入：

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

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

      上述指令會傳回有效資料中心資訊。

   3. 在 ZooKeeper 節點上，請先輸入：

      echo ruok | nc <host> 2181
      

      這項指令會傳回 imok。

      接著輸入：

      echo stat | nc <host> 2181 | grep Mode
      

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

   4. 在其中一個 ZooKeeper 節點中執行：

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

   5. 在 Postgres 主要節點上執行：

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

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

   6. 在待命節點上執行：

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

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

   7. 使用下列指令登入 PostgreSQL 資料庫：

      psql -h localhost -d apigee -U postgres

      系統顯示提示時，請輸入 postgres 使用者的密碼 (預設為 postgres)。

      接著執行下列查詢，檢查 client_received_start_timestamp 的上限：

      SELECT max(client_received_start_timestamp) FROM "analytics"."$org.$env.fact" LIMIT 1;

   記錄

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