Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Menambahkan pusat data

Dokumen ini menjelaskan cara menambahkan pusat data (juga disebut region) ke pusat data yang sudah ada.

Pertimbangan sebelum menambahkan pusat data

Sebelum menginstal pusat data, Anda harus memahami cara mengonfigurasi server OpenLDAP, ZooKeeper, Cassandra, dan Postgres di seluruh pusat data. Anda juga harus memastikan bahwa the port yang diperlukan terbuka di antara node di kedua pusat data.

OpenLDAP
Setiap pusat data memiliki server OpenLDAP sendiri yang dikonfigurasi dengan replikasi diaktifkan. Saat menginstal pusat data baru, Anda harus mengonfigurasi OpenLDAP untuk menggunakan replikasi, dan Anda harus mengonfigurasi ulang server OpenLDAP di pusat data yang ada untuk menggunakan replikasi.
ZooKeeper
Untuk properti ZK_HOSTS bagi kedua pusat data, tentukan alamat IP atau nama DNS semua node ZooKeeper dari kedua pusat data, dalam urutan yang sama, dan tandai node apa pun dengan pengubah “:observer”. Node tanpa pengubah :observer disebut "voter". Anda harus memiliki jumlah "voter" ganjil dalam konfigurasi Anda.

Dalam topologi ini, host ZooKeeper di host 9 adalah pengamat:

Dalam contoh file konfigurasi yang ditampilkan di bawah, node 9 ditandai dengan pengubah :observer sehingga Anda memiliki lima voter: Node 1, 2, 3, 7, dan 8.

Untuk properti ZK_CLIENT_HOSTS bagi setiap pusat data, tentukan alamat IP atau nama DNS hanya node ZooKeeper di pusat data, dalam urutan yang sama, untuk semua node ZooKeeper di pusat data.
Cassandra
Catatan: Semua pusat data harus memiliki jumlah node Cassandra yang sama.

Untuk CASS_HOSTS bagi setiap pusat data, pastikan Anda menentukan semua alamat IP Cassandra (bukan nama DNS) untuk kedua pusat data. Untuk pusat data 1, cantumkan node Cassandra di pusat data tersebut terlebih dahulu. Untuk pusat data 2, cantumkan node Cassandra di pusat data tersebut terlebih dahulu. Cantumkan node Cassandra dalam urutan yang sama untuk semua node Cassandra di pusat data.

Semua node Cassandra harus memiliki akhiran ':d,r'; misalnya 'ip:1,1 = pusat data 1 dan rak/zona ketersediaan 1 dan 'ip:2,1 = pusat data 2 dan rak/zona ketersediaan 1.

Misalnya, "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"

Node pertama di rak/zona ketersediaan 1 dari setiap pusat data akan digunakan sebagai server awal. Dalam model deployment ini, penyiapan Cassandra akan terlihat seperti ini:

Postgres

Secara default, Edge menginstal semua node Postgres dalam mode master. Namun, jika Anda memiliki beberapa pusat data, Anda mengonfigurasi node Postgres untuk menggunakan replikasi master-standby sehingga jika node master gagal, node standby dapat terus melayani traffic server. Biasanya, Anda mengonfigurasi server Postgres master di satu pusat data, dan server standby di pusat data kedua center.

Jika pusat data yang ada sudah dikonfigurasi untuk memiliki dua node Postgres yang berjalan dalam mode master/standby, sebagai bagian dari prosedur ini, batalkan pendaftaran node standby yang ada dan ganti dengan node standby di pusat data baru.

Tabel berikut menunjukkan konfigurasi Postgres sebelum dan sesudah untuk kedua skenario:

Sebelum	Setelah
Node Postgres Master Tunggal di dc-1	Node Postgres Master di dc-1 Node Postgres Standby di dc-2
Node Postgres Master di dc-1 Node Postgres Standby di dc-1	Node Postgres Master di dc-1 Node Postgres Standby di dc-2 Batalkan pendaftaran node Postgres Standby lama di dc-1

Sebelum

Setelah

Node Postgres Master Tunggal di dc-1

Node Postgres Master di dc-1

Node Postgres Standby di dc-2

Node Postgres Master di dc-1

Node Postgres Standby di dc-1

Node Postgres Master di dc-1

Node Postgres Standby di dc-2

Batalkan pendaftaran node Postgres Standby lama di dc-1

Persyaratan port
Anda harus memastikan bahwa port yang diperlukan terbuka di antara node di kedua pusat data. Untuk diagram port, lihat Persyaratan port.

Memperbarui pusat data yang ada

Untuk menambahkan pusat data, Anda harus melakukan langkah-langkah untuk menginstal dan mengonfigurasi node pusat data baru, tetapi Anda juga harus memperbarui node di pusat data asli. Perubahan ini diperlukan karena Anda menambahkan node Cassandra dan ZooKeeper baru di pusat data baru yang harus dapat diakses oleh pusat data yang ada, dan Anda harus mengonfigurasi ulang OpenLDAP untuk menggunakan replikasi.

Membuat file konfigurasi

Di bawah ini ditampilkan file konfigurasi senyap untuk kedua pusat data, dengan setiap pusat data memiliki 6 node seperti yang ditunjukkan dalam Topologi penginstalan. Perhatikan bahwa file konfigurasi untuk dc-1 menambahkan setelan tambahan ke:

Mengonfigurasi OpenLDAP dengan replikasi di dua node OpenLDAP.
Menambahkan node Cassandra dan ZooKeeper baru dari dc-2 ke file konfigurasi untuk 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>"

Menambahkan pusat data baru

Gunakan prosedur di bawah untuk menginstal pusat data baru.

Catatan: Cassandra menggunakan nama pusat data tetap dc-1, dc-2, dan seterusnya, terlepas dari nama region yang ditentukan dalam properti REGION dari file konfigurasi untuk region tempat Anda menginstal node baru. Dalam prosedur berikut, Anda harus menggunakan nama pusat data Cassandra (dc-1, dc-2, dll.) dalam perintah.

Dalam prosedur ini, pusat data memiliki nama berikut:

dc-1: pusat data yang ada
dc-2: pusat data baru

Untuk menambahkan pusat data baru:

Di dc-1, jalankan kembali setup.sh di node Cassandra asli dengan file konfigurasi dc-1 baru yang menyertakan node Cassandra dari dc-2:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile1
```
Di dc-2, instal apigee-setup di semua node. Lihat Menginstal utilitas apigee-setup Edge untuk mengetahui info selengkapnya.

Di dc-2, instal Cassandra dan ZooKeeper di node yang sesuai:

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

Di dc-1, jalankan kembali setup.sh di node Server Pengelolaan:

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

Jika berlaku, jalankan kembali penyiapan Monetisasi:

/opt/apigee/apigee-setup/bin/setup.sh -p mo -f mint_configFile1

Di dc-2, jalankan perintah rebuild di semua node Cassandra, dengan menentukan nama region dc-1:
```
/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h cassIP rebuild dc-1
```
Anda hanya perlu meneruskan nama pengguna dan sandi jika mengaktifkan autentikasi JMX untuk Cassandra.

Di dc-2, instal Server Pengelolaan di node yang sesuai:

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

Di node Server Pengelolaan di dc-2, instal apigee-provision, yang menginstal utilitas apigee-adminapi.sh:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision install
```

Di dc-2, instal Rute dan Pemroses Pesan di node yang sesuai:

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

Di dc-2, instal Qpid di node yang sesuai:

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

Di dc-2, instal Postgres di node yang sesuai:

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

Siapkan master/standby Postgres untuk node Postgres. Node Postgres di dc-1 adalah master, dan node Postgres di dc-2 adalah server standby.
Catatan: Jika dc-1 sudah dikonfigurasi untuk memiliki dua node Postgres yang berjalan dalam mode master/standby, sebagai bagian dari prosedur ini, gunakan node Postgres master yang ada di dc-1 sebagai master, dan node Postgres di dc-2 sebagai server standby. Nantinya dalam prosedur ini, Anda akan membatalkan pendaftaran server standby Postgres yang ada di dc-1.
1. Di node master di dc-1, edit file konfigurasi untuk menetapkan:
```
PG_MASTER=IPorDNSofDC1Master
PG_STANDBY=IPorDNSofDC2Standby
```
2. Aktifkan replikasi di master baru:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFIle
```
3. Di node standby di dc-2, edit file konfigurasi untuk menetapkan:
```
PG_MASTER=IPorDNSofDC1Master
PG_STANDBY=IPorDNSofDC2Standby
```
4. Di node standby di dc-2, hentikan server, lalu hapus data Postgres yang ada:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
rm -rf /opt/apigee/data/apigee-postgresql/
```
  Jika perlu, Anda dapat mencadangkan data ini sebelum menghapusnya.
5. Konfigurasikan node standby di dc-2:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
```
Di dc-1, perbarui konfigurasi Analytics dan konfigurasikan organisasi.
1. Di node Server Pengelolaan dc-1, dapatkan UUID node Postgres node:
```
apigee-adminapi.sh servers list -r dc-1 -p analytics -t postgres-server \
  --admin adminEmail --pwd adminPword --host localhost
```
  UUID muncul di akhir data yang ditampilkan. Simpan nilai tersebut.
  
  Catatan: Jika dc-1 dikonfigurasi untuk memiliki dua node Postgres yang berjalan dalam mode master/standby, Anda akan melihat dua alamat IP dan UUID dalam output. Simpan kedua UUID. Dari IP, Anda akan dapat menentukan UUID mana untuk master dan mana untuk node standby.
2. Di node Server Pengelolaan dc-2, dapatkan UUID node Postgres seperti yang ditunjukkan pada langkah sebelumnya. Simpan nilai tersebut.
3. Di node Server Pengelolaan dc-1, tentukan nama grup Analytics dan konsumen. Banyak perintah di bawah ini memerlukan informasi tersebut.
  Secara default, nama grup Analytics adalah "axgroup-001", dan nama grup konsumen adalah "consumer-group-001". Dalam file konfigurasi senyap untuk region, Anda dapat menetapkan nama grup Analytics menggunakan properti AXGROUP.
  
  Jika Anda tidak yakin dengan nama grup Analytics dan konsumen, gunakan perintah berikut untuk menampilkannya:
```
apigee-adminapi.sh analytics groups list \
  --admin adminEmail --pwd adminPword --host localhost
```
  Perintah ini menampilkan nama grup Analytics di kolom nama, dan nama grup konsumen di kolom consumer-groups.
4. Di node Server Pengelolaan dc-1, hapus server Postgres yang ada dari grup Analytics:
  1. Hapus node Postgres dari consumer-group:
```
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
```
    Jika dc-1 dikonfigurasi untuk memiliki dua node Postgres yang berjalan dalam mode master/standby, hapus keduanya:
```
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. Hapus node Postgres dari grup Analytics:
```
apigee-adminapi.sh analytics groups postgres_server remove \
  -g axgroup-001 -u UUID -Y --admin adminEmail \
  --pwd adminPword --host localhost
```
    Jika dc-1 dikonfigurasi untuk memiliki dua node Postgres yang berjalan dalam mode master/standby, hapus keduanya:
```
apigee-adminapi.sh analytics groups postgres_server \
  remove -g axgroup-001 -u UUID1,UUID2 -Y --admin adminEmail \
  --pwd adminPword --host localhost
```
5. Di node Server Pengelolaan dc-1, tambahkan server Postgres master/standby baru ke grup Analytics:
  1. Tambahkan kedua server Postgres ke grup Analytics:
```
apigee-adminapi.sh analytics groups postgres_server \
  add -g axgroup-001 -u "UUID_1,UUID_2" --admin adminEmail \
  --pwd adminPword --host localhost
```
    Di mana UUID_1 sesuai dengan node Postgres master di dc-1, dan UUID_2 sesuai dengan node Postgres standby di dc-2.
  2. Tambahkan server PG ke consumer-group sebagai master/standby:
```
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. Tambahkan server Qpid dari dc-2 ke grup Analytics:
  1. Di node Server Pengelolaan dc-1, dapatkan UUID node Qpid di dc-2:
```
apigee-adminapi.sh servers list -r dc-2 -p central -t qpid-server \
  --admin adminEmail --pwd adminPword --host localhost
```
    UUID muncul di akhir data yang ditampilkan. Simpan nilai tersebut.
  2. Di node Server Pengelolaan dc-1, tambahkan node Qpid ke grup Analytics (jalankan kedua perintah):
```
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. Di node Server Pengelolaan dc-1, tambahkan node Qpid ke grup konsumen (jalankan kedua perintah):
```
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
```
    Jika Anda menggunakan Monetisasi, tambahkan node Qpid ke grup MINT di node Server Pengelolaan dc-1:
```
apigee-adminapi.sh analytics groups qpid_server \
add -g mxgroup001 -u UUID_1 --admin adminEmail \
--pwd adminPword --host localhost

apigee-adminapi.sh analytics groups qpid_server \
add -g mxgroup001 -u UUID_2 --admin adminEmail \
--pwd adminPword --host localhost
```
7. Batalkan pendaftaran dan hapus server standby Postgres lama dari dc-1:
  1. Batalkan pendaftaran server standby Postgres dc-1 yang ada:
```
apigee-adminapi.sh servers deregister -u UUID -r dc-1 \
-p analytics -t postgres-server -Y --admin adminEmail \
--pwd adminPword --host localhost
```
    Dengan UUID adalah node Postgres standby lama di dc-1.
  2. Hapus server standby Postgres dc-1 yang ada:
    Catatan: Perintah ini tidak meng-uninstal node server server Postgres. Perintah ini hanya menghapusnya dari daftar node Edge. Anda dapat meng-uninstal Postgres dari node nanti, jika diperlukan.
```
apigee-adminapi.sh servers delete -u UUID \
--admin adminEmail --pwd adminPword --host localhost
```
Perbarui keyspace Cassandra dengan faktor replikasi yang benar untuk kedua pusat data. Anda hanya perlu menjalankan langkah ini satu kali di server Cassandra mana pun di salah satu pusat data:
Catatan: Semua perintah di bawah ini menetapkan faktor replikasi ke "3", yang menunjukkan tiga node Cassandra dalam cluster. Ubah nilai ini sesuai kebutuhan untuk penginstalan Anda.
1. Mulai utilitas cqlsh Cassandra:
```
/opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
```
2. Jalankan perintah CQL berikut di prompt "cqlsh>" untuk menetapkan tingkat replikasi untuk keyspace 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. Lihat keyspace menggunakan perintah:
```
SELECT * FROM system_schema.keyspaces;
```
  4. Keluar dari cqlsh:
```
exit
```
Jalankan perintah nodetool berikut di semua node Cassandra di dc-1 untuk mengosongkan memori:
```
/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h cassandraIP cleanup
```
Anda hanya perlu meneruskan nama pengguna dan sandi jika Anda mengaktifkan autentikasi JMX untuk Cassandra.
Untuk setiap organisasi dan untuk setiap lingkungan yang ingin Anda dukung di seluruh pusat data:
1. Di node Server Pengelolaan dc-1, tambahkan MP_POD baru ke Organisasi:
```
apigee-adminapi.sh orgs pods add -o orgName -r dc-2 -p gateway-2 \
  --admin adminEmail --pwd adminPword --host localhost
```
  Dengan gateway-2 adalah nama pod gateway seperti yang ditentukan oleh properti MP_POD dalam file konfigurasi dc-2.
2. Tambahkan Pemroses Pesan baru ke organisasi dan lingkungan:
  1. Di node Server Pengelolaan dc-2, dapatkan UUID dari node Pemroses Pesan di dc-2:
```
apigee-adminapi.sh servers list -r dc-2 -p gateway-2 \
  -t message-processor --admin adminEmail --pwd adminPword --host localhost
```
    UUID muncul di akhir data yang ditampilkan. Simpan nilai tersebut.
  2. Di node Server Pengelolaan dc-1, untuk setiap Pemroses Pesan di dc-2, tambahkan Pemroses Pesan ke lingkungan untuk organisasi:
```
apigee-adminapi.sh orgs envs servers add -o orgName -e envName \
  -u UUID --admin adminEmail --pwd adminPword --host localhost
```
3. Di node Server Pengelolaan dc-1, periksa organisasi:
```
apigee-adminapi.sh orgs apis deployments -o orgName -a apiProxyName \
  --admin adminEmail --pwd adminPword --host localhost
```
  Dengan apiProxyName adalah nama proxy API yang di-deploy di organisasi.
Jika Anda menggunakan Monetisasi, instal node Monetisasi di DC2.

Jalankan perintah penyiapan MINT di node Server Pengelolaan dan Pemroses Pesan di DC2:
```
/opt/apigee/apigee-setup/bin/setup.sh -p mo -f mint_configFile1
```