このページは Cloud Translation API によって翻訳されました。

データセンターの追加

Edge for Private Cloud v4.18.01

このドキュメントでは、データセンター（リージョン）を既存のデータセンターに追加する方法について説明します。

データセンターを追加する前の考慮事項

データセンターを追加する前に、OpenLDAP、ZooKeeper、Cassandra、Postgres のサーバーをデータセンター全体で構成する方法について理解しておく必要があります。また、2 つのデータセンターのノード間で必要なポートを開いておく必要もあります。

OpenLDAP
各データセンターには、レプリケーションを有効にして構成されている独自の OpenLDAP サーバーがあります。新しいデータセンターをインストールする場合は、その OpenLDAP でレプリケーションを有効にする必要があり、さらに既存のデータセンターの OpenLDAP サーバーでレプリケーションを再構成する必要があります。
ZooKeeper
両方のデータセンターの ZK_HOSTS プロパティで、両方のデータセンターのすべての ZooKeeper ノードの IP アドレスまたは DNS 名を同じ順序で指定し、任意のノードに「observer」修飾子を付けます。「:observer」修飾子が付いていないノードは「ボーター」と呼ばれます。構成内の「ボーター」の数は奇数である必要があります。

このトポロジでは、ホスト 9 の ZooKeeper ホストがオブザーバです。

下記の構成ファイルの例では、ノード 9 に「:observer」修飾子がタグ付けされているため、ノード 1、2、3、7、8 の 5 つがボーターになります。

各データセンターの ZK_CLIENT_HOSTS プロパティで、データセンター内のすべての 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
デフォルトでは、すべての Postgres ノードがマスターモードでインストールされます。ただし、複数のデータセンターがある場合は、マスター / スタンバイレプリケーションを使用するように Postgres ノードを構成します。そうすることにより、マスターノードに障害が発生した場合にスタンバイノードがサーバートラフィックを続行できます。通常、あるデータセンターでマスター Postgres サーバーを構成し、2 番目のデータセンターでスタンバイサーバーを構成します。

既存のデータセンターが、マスター/スタンバイモードで 2 つの 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 の以前のスタンバイ Postgres ノードを登録解除する

変更前

変更後

dc-1 に単一のマスター Postgres ノード

dc-1 のマスター Postgres ノード

dc-2 にスタンバイ Postgres ノード

dc-1 のマスター Postgres ノード

dc-1 にスタンバイ Postgres ノード

dc-1 のマスター Postgres ノード

dc-2 のスタンバイ Postgres ノード

dc-1 の以前のスタンバイ Postgres ノードを登録解除する

ポート要件
2 つのデータセンターのノード間で必要なポートを開いておく必要があります。ポートの図については、インストール要件をご覧ください。

既存のデータセンターの更新

データセンターを追加するには、新しいデータセンターノードをインストールして構成する手順を実行する必要がありますが、元のデータセンターのノードを更新する必要もあります。新しいデータセンターで追加する新しい Cassandra ノードと ZooKeeper ノードは既存のデータセンターにアクセスできる必要があり、レプリケーションを使用するように OpenLDAP を再構成する必要があるため、元のデータセンターでも変更が必要です。

構成ファイルの作成

以下に示すサイレント構成ファイルは、インストールトポロジに示す、それぞれ 6 つのノードで構成された 2 つのデータセンターを作成する場合の例です。dc-1 用の構成ファイルに次の設定が追加されていることに注意してください。

2 つの 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 の元の Cassandra ノードで、dc-2 の Cassandra ノードを含む新しい dc-1 構成ファイルを使用して setup.sh を再実行します。
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile1
dc-1 で、Management Server ノードで 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 を指定して rebuild コマンドを実行します。
> /opt/apigee/apigee-cassandra/bin/nodetool -h cassIP rebuild dc-1
dc-2 の該当するノードに Management Server をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile2
dc-2 の Management Server ノードに、apigee-provision をインストールします。これにより、apigee-adminapi.sh ユーティリティがインストールされます。
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
dc-2 で、適切なノードに Route と Message Processor をインストールします。
> /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 で、2 つの 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 の Management Server ノードで、Postgres ノードの UUID を取得します。
  > apigee-adminapi.sh servers list -r dc-1 -p analytics -t postgres-server --admin adminEmail --pwd adminPword --host localhost
  
  返されたデータの末尾に UUID が表示されます。その値を保存します。
  
  注: dc-1 で 2 つの Postgres ノードがマスター/スタンバイモードで構成されている場合は、2 つの IP アドレスと UUID が出力に表示されます。両方の UUID の値を保存します。これらの IP から、どちらの UUID がマスターノードで、どの UUID がスタンバイノードであるかを判断できます。
2. dc-2 の Management Server ノードで、前のステップで示した Postgres ノードの UUID を取得します。その値を保存します。
3. dc-1 の Management Server ノードで、分析グループとコンシューマグループの名前を決定します。以下のコマンドの多くでその情報を指定する必要があります。
  デフォルトでは、分析グループの名前は axgroup-001 で、コンシューマグループの名前は consumer-group-001 です。リージョンのサイレント構成ファイルで、AXGROUP プロパティを使用して分析グループの名前を設定できます。
  
  分析グループとコンシューマグループの名前がわからない場合は、次のコマンドで確認します。
  > apigee-adminapi.sh analytics groups list --admin adminEmail --pwd adminPword --host localhost
  
  このコマンドは、name フィールドに分析グループ名を、consumer-groups フィールドにコンシューマグループ名を返します。
4. dc-1 の Management Server ノードで、分析グループから既存の Postgres サーバーを削除します。
  1. 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 で 2 つの 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. 分析グループから Postgres ノードを削除します。分析グループから Postgres ノードを削除します。分析グループから Postgres ノードを削除します。分析グループから Postgres ノードを削除します。
    
    UUID
5. dc-1 の Management Server ノードで、新しいマスター/スタンバイ Postgres サーバーを分析グループに追加します。
  1. 両方の Postgres サーバーを分析グループに追加します。
    > apigee-adminapi.sh Analytics groups postgres_server add -g axgroup-001 -u "UUID_1,UUID_2" --admin adminEmail --pwd adminPword --host localhost
  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 サーバーを分析グループに追加します。
  1. dc-1 の Management Server ノードで、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 の Management Server ノード dc-1 の Management Server ノードで dc-1 の Management Server ノード（dc-1 の Management Server ノード 管理サーバーノード（dc-1 の Management Server ノード）で Qpid ノードを分析グループに追加します（両方のコマンドを実行します（次のコマンドを実行してコマンドの両方を実行します）。
  3. dc-1 の Management Server ノードで、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 サーバー delete -u UUID --admin adminEmail --pwd adminPword --host localhost
2 つのデータセンターに適切なレプリケーション係数を使用して Cassandra キースペースを更新します。このステップは、どちらかのデータセンターの任意の Cassandra サーバーで一度だけ行います。

注: 以下のコマンドはすべて、レプリケーション係数を 3 に設定します。これはクラスタ内に 3 つの Cassandra ノードがあることを示します。実際のインストール環境に合わせて、この値を変更します。
1. Cassandra cqlsh ユーティリティを起動します。
  > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
2. cqlsh> プロンプトに対して以下の CQL コマンドを実行して、Cassandra キースペースのレプリケーションレベルを設定します。
  1. cqlsh> ALTER KEYSPACE "identityzone" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
  2. cqlsh> ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
  3. 次のコマンドを使用してキースペースを表示します。
    cqlsh> select * from system.schema_keyspaces;
  4. cqlsh を終了します。
    cqlsh> exit
dc-1 のすべての Cassandra ノードで次の nodetool コマンドを実行して、メモリを解放します。
> /opt/apigee/apigee-cassandra/bin/nodetool -h cassandraIP cleanup
すべてのデータセンターでサポートする各組織の環境ごとに、次のことを行います。
1. dc-1 の Management Server ノードで、新しい 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 プロパティで定義されているゲートウェイポッドの名前です。
2. 新しい Message Processor を組織と環境に追加します。
  1. dc-2 の Management Server ノードで、dc-2 の Message Processor ノードの 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 の Management Server ノードで、dc-2 の各 Message Processor に対して、組織の環境に Message Processor を追加します。
    > apigee-adminapi.sh orgs envs servers add -o orgName -e envName -u adminPword -adminEmail --pwd adminPword --host UUID
3. dc-1 の Management Server ノードで、組織を確認します。
  > apigee-adminapi.sh orgs apis deployments -o orgName -a apiProxyName --admin adminEmail --pwd adminPword --host localhost
  
  ここで、apiProxyName は、組織にデプロイされている API プロキシの名前です。