本頁面由 Cloud Translation API 翻譯而成。

新增資料中心

Edge for Private Cloud 4.18.05

本文說明如何將資料中心 (又稱為區域) 新增至現有資料中心。

新增資料中心前的注意事項

安裝新增資料中心之前，您必須瞭解如何在各資料中心中設定 OpenLDAP、ZooKeeper、Cassandra 和 Postgres 伺服器。您也必須確保兩個資料中心的節點之間已開啟必要的通訊埠。

OpenLDAP
每個資料中心都有自己的 OpenLDAP 伺服器，並已啟用複寫功能。安裝新資料中心時，您必須設定 OpenLDAP 使用複寫功能，並重新設定現有資料中心中的 OpenLDAP 伺服器，以便使用複寫功能。
ZooKeeper
針對兩個資料中心的 ZK_HOSTS 屬性，請依序指定兩個資料中心的所有 ZooKeeper 節點的 IP 位址或 DNS 名稱，並使用「:observer」修飾符標記任何節點。沒有 :observer 修飾符的節點稱為「投票者」。設定中必須有奇數個「投票者」。

在這個拓撲中，主機 9 上的 ZooKeeper 主機是觀察器：

在下方顯示的設定檔範例中，節點 9 已標記 :observer 修飾符，因此您有五個投票者：節點 1、2、3、7 和 8。

針對每個資料中心的 ZK_CLIENT_HOSTS 屬性，請依照相同順序，為資料中心中的所有 ZooKeeper 節點指定資料中心中 ZooKeeper 節點的 IP 位址或 DNS 名稱。
Cassandra
所有資料中心的 Cassandra 節點數量都必須相同。

針對每個資料中心的 CASS_HOSTS，請務必為兩個資料中心指定所有 Cassandra IP 位址 (而非 DNS 名稱)。針對資料中心 1，請先列出該資料中心中的 Cassandra 節點。針對資料中心 2，請先列出該資料中心中的 Cassandra 節點。以相同順序列出資料中心中所有 Cassandra 節點。

所有 Cassandra 節點都必須有後置字串 ':d,r'，例如 'ip:1,1 = 資料中心 1 和機架/可用性區域 1，以及 'ip:2,1 = 資料中心 2 和機架/可用性區域 1。

例如「192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1 192.168.124.205:2,1 192.168.124.206:2,1」

每個資料中心的機架/可用性區域 1 中的第一個節點，都會用來做為種子伺服器。在這個部署模型中，Cassandra 設定如下所示：

Postgres

根據預設，Edge 會在主模式下安裝所有 Postgres 節點。不過，如果您有多個資料中心，請將 Postgres 節點設為使用主-待命複寫功能，這樣一來，如果主節點發生故障，待命節點就能繼續處理伺服器流量。通常，您會在一個資料中心中設定主 Postgres 伺服器，並在第二個資料中心中設定待命伺服器。

如果現有資料中心已設定為在主/備援模式下執行兩個 Postgres 節點，請在這個程序中取消註冊現有的備援節點，並用新資料中心中的備援節點取代。

下表列出兩種情境下 Postgres 設定的前後對照：

之前	使用後
dc-1 中的單一 Postgres 主要節點	dc-1 中的 Postgres 主要節點 dc-2 中的待命 Postgres 節點
dc-1 中的 Postgres 主要節點 dc-1 中的待機 Postgres 節點	dc-1 中的 Postgres 主要節點 dc-2 中的待命 Postgres 節點在 dc-1 中取消註冊舊的 Standby Postgres 節點

之前

使用後

dc-1 中的單一 Postgres 主要節點

dc-1 中的 Postgres 主要節點

dc-2 中的待命 Postgres 節點

dc-1 中的 Postgres 主要節點

dc-1 中的待機 Postgres 節點

dc-1 中的 Postgres 主要節點

dc-2 中的待命 Postgres 節點

在 dc-1 中取消註冊舊的 Standby Postgres 節點

通訊埠需求
請務必確認兩個資料中心的節點之間已開啟必要的通訊埠。如需轉移圖表，請參閱「轉移需求」。

更新現有資料中心

新增資料中心時，您必須執行安裝及設定新資料中心節點的步驟，但也必須更新原始資料中心中的節點。您必須進行這些修改，因為您要在新資料中心中新增 Cassandra 和 ZooKeeper 節點，且這些節點必須可供現有資料中心存取，您也必須重新設定 OpenLDAP 才能使用複寫功能。

建立設定檔

下方是兩個資料中心的靜默設定檔，每個資料中心有 6 個節點，如「安裝拓撲」所示。請注意，dc-1 的設定檔會新增下列額外設定：

設定 OpenLDAP，並在兩個 OpenLDAP 節點之間進行複製。
將 dc-2 中的新 Cassandra 和 ZooKeeper 節點新增至 dc-1 的設定檔。

# Datacenter 1
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
HOSTIP=$(hostname -i)
MSIP=$IP1
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=secret
MP_POD=gateway-1
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
SMTPPASSWORD=smtppwd   
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"

# Datacenter 2
IP1=IPorDNSnameOfNode1
IP2=IPorDNSnameOfNode2
IP3=IPorDNSnameOfNode3
IP7=IPorDNSnameOfNode7
IP8=IPorDNSnameOfNode8
IP9=IPorDNSnameOfNode9 
HOSTIP=$(hostname -i)
MSIP=$IP7
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=secret
MP_POD=gateway-2
REGION=dc-2
ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer"
ZK_CLIENT_HOSTS="$IP7 $IP8 $IP9"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com 
SMTPPASSWORD=smtppwd   
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"

新增資料中心

在這個程序中，資料中心的名稱如下：

dc-1：現有資料中心
dc-2：新的資料中心

如要新增資料中心，請按照下列步驟操作：

在 dc-1 上，使用包含 dc-2 中 Cassandra 節點的新 dc-1 設定檔，在原始 Cassandra 節點上重新執行 setup.sh：
```
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile1
```
在 dc-1 上，在管理伺服器節點上重新執行 setup.sh：
```
/opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile1
```
在 dc-2 上，請在所有節點上安裝 apigee-setup。詳情請參閱「安裝 Edge apigee-setup 公用程式」。
在 dc-2 上，在適當的節點上安裝 Cassandra 和 ZooKeeper：
```
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile2
```
在 dc-2 上，針對所有 Cassandra 節點執行重建指令，並指定 dc-1 的區域名稱：
```
/opt/apigee/apigee-cassandra/bin/nodetool -h cassIP rebuild dc-1
```
在 dc-2 上，請在適當的節點上安裝管理伺服器：
```
/opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile2
```
在 dc-2 的管理伺服器節點上，安裝 apigee-provision，以便安裝 apigee-adminapi.sh 公用程式：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision install
```
在 dc-2 上，請在適當的節點上安裝路由和訊息處理器：
```
/opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile2
```

在 dc-2 上，在適當的節點上安裝 Qpid：

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

在 dc-2 上，在適當的節點上安裝 Postgres：

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

為 Postgres 節點設定 Postgres 主機/待命機。dc-1 中的 Postgres 節點是主節點，dc-2 中的 Postgres 節點則是待命伺服器。
注意：如果 dc-1 已設定為在主/備援模式下執行兩個 Postgres 節點，請在這個程序中使用 dc-1 中現有的 Postgres 主節點做為主節點，並使用 dc-2 中的 Postgres 節點做為備援伺服器。稍後在這個程序中，您將在 dc-1 中取消註冊現有的 Postgres 待命伺服器。
1. 在 dc-1 的主節點上，編輯設定檔來設定：
```
PG_MASTER=IPorDNSofDC1Master
PG_STANDBY=IPorDNSofDC2Standby
```
2. 在新的主控台上啟用複製功能：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFIle
```
3. 在 dc-2 的待命節點上，編輯設定檔來設定：
```
PG_MASTER=IPorDNSofDC1Master
PG_STANDBY=IPorDNSofDC2Standby
```
4. 在 dc-2 的待命節點上，請停止伺服器，然後刪除任何現有的 Postgres 資料：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
rm -rf /opt/apigee/data/apigee-postgresql/
```
  注意：如有需要，您可以在刪除資料前先備份資料。
5. 在 dc-2 中設定待命節點：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
```
在 dc-1 上更新數據分析設定，並設定機構。
1. 在 dc-1 的管理伺服器節點上，取得 Postgres 節點的 UUID：
```
apigee-adminapi.sh servers list -r dc-1 -p analytics -t postgres-server \
  --admin adminEmail --pwd adminPword --host localhost
```
  UUID 會顯示在傳回資料的結尾。儲存該值。
  
  注意：如果 dc-1 已設定為在主/備用模式下執行兩個 Postgres 節點，輸出內容中就會顯示兩個 IP 位址和 UUID。儲存兩個 UUID。您應該可以根據 IP 判斷哪個 UUID 屬於主節點，哪個 UUID 屬於待命節點。
2. 在 dc-2 的管理伺服器節點上，取得 Postgres 節點的 UUID，如上一個步驟所示。儲存該值。
3. 在 dc-1 的管理伺服器節點中，決定 Analytics 和消費者群組的名稱。下方的許多指令都需要這項資訊。
  根據預設，分析群組的名稱為「axgroup-001」，消費者群組的名稱為「consumer-group-001」。在區域的靜默設定檔中，您可以使用 AXGROUP 屬性設定分析群組的名稱。
  
  如果不確定分析和消費者群組的名稱，請使用下列指令顯示這些名稱：
```
apigee-adminapi.sh analytics groups list \
  --admin adminEmail --pwd adminPword --host localhost
```
  這個指令會在名稱欄位中傳回分析群組名稱，以及在消費者群組欄位中傳回消費者群組名稱。
4. 在 dc-1 的管理伺服器節點中，從資料分析群組中移除現有的 Postgres 伺服器：
  1. 從 consumer-group 中移除 Postgres 節點：
```
apigee-adminapi.sh analytics groups consumer_groups datastores remove \
  -g axgroup-001 -c consumer-group-001 -u UUID \
  -Y --admin adminEmail --pwd adminPword --host localhost
```
    如果 dc-1 已設定為在主/待機模式下執行兩個 Postgres 節點，請將兩者都移除：
```
apigee-adminapi.sh analytics groups consumer_groups datastores remove \
  -g axgroup-001 -c consumer-group-001 -u "UUID_1,UUID_2" \
  -Y --admin adminEmail --pwd adminPword --host localhost
```
  2. 從 Analytics 群組中移除 Postgres 節點：
```
apigee-adminapi.sh analytics groups postgres_server remove \
  -g axgroup-001 -u UUID -Y --admin adminEmail \
  --pwd adminPword --host localhost
```
    如果 dc-1 已設定為讓兩個 Postgres 節點以主/備用模式執行，請一併移除這兩個節點：
```
apigee-adminapi.sh analytics groups postgres_server \
  remove -g axgroup-001 -u UUID1,UUID2 -Y --admin adminEmail \
  --pwd adminPword --host localhost
```
5. 在 dc-1 的管理伺服器節點上，將新的主/備用 Postgres 伺服器新增至 Analytics 群組：
  1. 將兩部 Postgres 伺服器新增至 Analytics 群組：
```
apigee-adminapi.sh analytics groups postgres_server \
  add -g axgroup-001 -u "UUID_1,UUID_2" --admin adminEmail \
  --pwd adminPword --host localhost
```
    UUID_1 對應於 dc-1 中的主 Postgres 節點，而 UUID_2 則對應於 dc-2 中的待命 Postgres 節點。
  2. 將 PG 伺服器新增至消費者群組，做為主/備用伺服器：
```
apigee-adminapi.sh analytics groups consumer_groups datastores \
  add -g axgroup-001 -c consumer-group-001 -u "UUID_1,UUID_2" --admin adminEmail \
  --pwd adminPword --host localhost
```
6. 將 dc-2 中的 Qpid 伺服器新增至 Analytics 群組：
  1. 在 dc-1 的管理伺服器節點上，取得 dc-2 中 Qpid 節點的 UUID：
```
apigee-adminapi.sh servers list -r dc-2 -p central -t qpid-server \
  --admin adminEmail --pwd adminPword --host localhost
```
    UUID 會顯示在傳回資料的結尾。儲存這些值。
  2. 在 dc-1 的管理伺服器節點上，將 Qpid 節點新增至分析群組 (執行兩個指令)：
```
apigee-adminapi.sh analytics groups qpid_server \
  add -g axgroup-001 -u "UUID_1" --admin adminEmail \
  --pwd adminPword --host localhost

apigee-adminapi.sh analytics groups qpid_server \
  add -g axgroup-001 -u "UUID_2" --admin adminEmail \
  --pwd adminPword --host localhost
```
  3. 在 dc-1 的管理伺服器節點上，將 Qpid 節點新增至消費者群組 (執行這兩個指令)：
```
apigee-adminapi.sh analytics groups consumer_groups consumers \
  add -g axgroup-001 -c consumer-group-001 -u "UUID_1" \
  --admin adminEmail --pwd adminPword --host localhost

apigee-adminapi.sh analytics groups consumer_groups consumers \
  add -g axgroup-001 -c consumer-group-001 -u "UUID_2" \
  --admin adminEmail --pwd adminPword --host localhost
```
7. 從 dc-1 取消註冊並刪除舊的 Postgres 待命伺服器：
  1. 取消註冊現有的 dc-1 Postgres 待命伺服器：
```
apigee-adminapi.sh servers deregister -u UUID -r dc-1 \
  -p analytics -t postgres-server -Y --admin adminEmail \
  --pwd adminPword --host localhost
```
    其中 UUID 是 dc-1 中的舊備援 Postgres 節點。
  2. 刪除現有的 dc-1 Postgres 待命伺服器：
    注意：這個指令不會解除安裝 Postgres 伺服器節點。只會將其從 Edge 節點清單中移除。之後，您可以視需要從節點解除安裝 Postgres。
```
apigee-adminapi.sh servers delete -u UUID \
  --admin adminEmail --pwd adminPword --host localhost
```
請為兩個資料中心更新 Cassandra 鍵值空間，並使用正確的複製因子。您只需在任一資料中心的任何 Cassandra 伺服器上執行這個步驟一次：
注意：下列指令都將複製因子設為「3」，表示叢集中有三個 Cassandra 節點。視安裝需求修改這個值。
1. 啟動 Cassandra cqlsh 公用程式：
```
/opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
```
2. 在「cqlsh>」提示訊息中執行下列 CQL 指令，設定 Cassandra 鍵值空間的複製層級：
  1. ```
  ALTER KEYSPACE "identityzone" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' }; 
```
2. ```
ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
```
  3. 使用下列指令查看鍵值空間：
```
select * from system.schema_keyspaces;
```
  4. 退出 cqlsh：
```
exit
```
在 dc-1 的所有 Cassandra 節點上執行下列 nodetool 指令，釋放記憶體：
```
/opt/apigee/apigee-cassandra/bin/nodetool -h cassandraIP cleanup
```
針對您要在各資料中心支援的每個機構和環境：
1. 在 dc-1 的管理伺服器節點中，將新的 MP_POD 新增至機構：
```
apigee-adminapi.sh orgs pods add -o orgName -r dc-2 -p gateway-2 \
  --admin adminEmail --pwd adminPword --host localhost
```
  其中 gateway-2 是 dc-2 設定檔中 MP_POD 屬性定義的閘道 pod 名稱。
2. 將新的訊息處理工具新增至組織和環境：
  1. 在 dc-2 的管理伺服器節點上，取得 dc-2 中訊息處理器節點的 UUID：
```
apigee-adminapi.sh servers list -r dc-2 -p gateway-2 \
  -t message-processor --admin adminEmail --pwd adminPword --host localhost
```
    UUID 會顯示在傳回資料的結尾。儲存這些值。
  2. 在 dc-1 的管理伺服器節點上，針對 dc-2 中的每個 Message Processor，將 Message Processor 新增至機構的環境：
```
apigee-adminapi.sh orgs envs servers add -o orgName -e envName \
  -u UUID --admin adminEmail --pwd adminPword --host localhost
```
3. 在 dc-1 的管理伺服器節點上，檢查機構：
```
apigee-adminapi.sh orgs apis deployments -o orgName -a apiProxyName \
  --admin adminEmail --pwd adminPword --host localhost
```
  其中 apiProxyName 是機構中部署的 API Proxy 名稱。