Menginstal komponen Edge pada node

Setelah Anda menginstal utilitas apigee-setup Edge di node, gunakan utilitas apigee-setup untuk menginstal satu atau beberapa komponen Edge di node.

Utilitas apigee-setup menggunakan perintah dalam bentuk:

/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

Dengan component sebagai komponen Edge yang akan diinstal, dan configFile sebagai file konfigurasi otomatis yang berisi informasi penginstalan. File konfigurasi harus dapat diakses atau dibaca oleh pengguna "apigee". Misalnya, Anda dapat membuat direktori baru untuk file, menempatkannya di direktori /usr/local atau /usr/local/share, atau di mana pun pada node yang dapat diakses oleh pengguna "apigee".

Misalnya, untuk menginstal Edge Management Server:

/opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig

Untuk mengetahui informasi tentang cara menginstal apigee-setup Edge, lihat Menginstal utilitas apigee-setup Edge.

Pertimbangan penginstalan

Saat Anda menulis file konfigurasi, pertimbangkan opsi berikut.

Menyiapkan replikasi master-standby Postgres

Secara default, Edge menginstal semua node Postgres dalam mode master. Namun, di sistem produksi dengan beberapa node Postgres, Anda harus mengonfigurasinya untuk menggunakan replikasi master-standby sehingga jika node master gagal, node standby dapat terus melayani traffic.

Anda dapat mengaktifkan dan mengonfigurasi replikasi master-standby pada waktu penginstalan menggunakan properti dalam file konfigurasi otomatis. Atau, Anda dapat mengaktifkan replikasi master-standby setelah penginstalan. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan replikasi master-standby untuk Postgres.

Instal SymasLDAP 2.6.10

Penginstalan di tempat memerlukan SymasLDAP 2.6.10, yang disertakan dalam repositori apigee-thirdparty-opdk. Sebelum menginstal, hapus library symasldap-compat.

Untuk penginstalan 13 host, dan penginstalan 12 host dengan dua pusat data, replikasi SymasLDAP diperlukan karena ada beberapa node yang menghosting SymasLDAP.

Mengaktifkan autentikasi Cassandra

Secara default, Cassandra diinstal tanpa mengaktifkan autentikasi. Artinya, siapa pun dapat mengakses Cassandra. Anda dapat mengaktifkan autentikasi setelah menginstal Edge, atau sebagai bagian dari proses penginstalan.

Untuk mengetahui informasi selengkapnya, lihat Mengaktifkan autentikasi Cassandra.

Menggunakan port yang dilindungi saat membuat host virtual

Jika Anda ingin membuat host virtual yang mengikat Router ke port yang dilindungi, seperti nomor port kurang dari 1000, Anda harus mengonfigurasi Router agar berjalan sebagai pengguna dengan akses ke port tersebut. Secara default, Router berjalan sebagai pengguna "apigee" yang tidak memiliki akses ke port dengan hak istimewa.

Untuk mengetahui informasi tentang cara mengonfigurasi host virtual dan Router untuk mengakses port di bawah 1000, lihat Menyiapkan host virtual.

Persyaratan baru yang diperkenalkan oleh apigee-qpidd-4.52.01-X.X.X

Mulai versi 4.52.01, persyaratan baru telah diperkenalkan selama penginstalan. Properti ini memerlukan penyertaan properti QPID_MGMT_USERNAME dan QPID_MGMT_PASSWORD selama penginstalan. Pastikan properti ini ditambahkan dengan nilai yang sesuai dalam file konfigurasi untuk memfasilitasi penginstalan yang berhasil.

Mengonfigurasi UI Edge Baru

UI Edge Baru (komponen edge-management-ui dan edge-management-ui-static) diinstal secara default selama penginstalan Edge. Secara default, UI New Edge menggunakan autentikasi Dasar, dan juga dapat dikonfigurasi untuk menggunakan Apigee SSO atau IDP eksternal seperti SAML atau OIDC.

Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi UI Edge Baru, lihat Mengonfigurasi UI Edge Baru.

Menentukan komponen yang akan diinstal

Tabel berikut mencantumkan opsi yang Anda teruskan ke opsi -p dari utilitas apigee-service untuk menentukan komponen yang akan diinstal di node:

Komponen Deskripsi

c

Hanya instal Cassandra.
zk menginstal ZooKeeper saja.

ds

Instal ZooKeeper dan Cassandra.

ld

Instal SymasLDAP saja.

mt

Instal Server Pengelolaan Edge, yang juga menginstal SymasLDAP.

Jika Anda menetapkan USE_LDAP_REMOTE_HOST=y dalam file konfigurasi, penginstalan SymasLDAP akan dilewati dan Server Pengelolaan akan menggunakan SymasLDAP yang diinstal pada node yang berbeda.

ms

Instal Edge Management Server, yang juga menginstal New Edge UI dan SymasLDAP.

Jika Anda menetapkan USE_LDAP_REMOTE_HOST=y dalam file konfigurasi, penginstalan SymasLDAP akan dilewati dan Server Pengelolaan akan menggunakan SymasLDAP yang diinstal pada node yang berbeda.

r

Hanya menginstal Router Edge.

mp

Hanya menginstal Pemroses Pesan Edge.

rmp

Instal Edge Router dan Message Processor.

ue

Menginstal UI Edge Baru (edge-management-ui dan edge-management-ui-static).

qs

Hanya menginstal Server Qpid.

ps

Instal Server Postgres saja.
pdb Hanya menginstal database Postgres - hanya digunakan saat menginstal portal Layanan Developer Apigee (atau cukup, portal). Lihat Menginstal portal.

sax

Instal komponen analisis, yaitu Qpid dan Postgres.

Gunakan opsi ini hanya untuk pengembangan dan pengujian, bukan untuk produksi.

mo

Menginstal Monetisasi.

sa

Instal Edge secara mandiri, yang berarti Cassandra, ZooKeeper, Server Pengelolaan, SymasLDAP, UI Edge Baru, Router, dan Message Processor. Opsi ini menghilangkan komponen analisis Edge: Qpid dan Postgres.

Gunakan opsi ini hanya untuk pengembangan dan pengujian, bukan untuk produksi.

aio

Instal semua komponen pada satu node.

Gunakan opsi ini hanya untuk pengembangan dan pengujian, bukan untuk produksi.
dp

Instal portal.

Membuat file konfigurasi

File konfigurasi berisi semua informasi yang diperlukan untuk menginstal Edge. Anda sering kali dapat menggunakan file konfigurasi yang sama untuk menginstal semua komponen dalam penginstalan Edge.

Namun, Anda harus menggunakan file konfigurasi yang berbeda, atau mengubah file konfigurasi, jika:

  • Anda menginstal beberapa server SymasLDAP dan perlu mengonfigurasi replikasi sebagai bagian dari penginstalan 13 node. Setiap file memerlukan nilai yang berbeda untuk LDAP_SID dan LDAP_PEER.
  • Anda membuat beberapa pusat data sebagai bagian dari penginstalan 12 node. Setiap pusat data memerlukan setelan yang berbeda untuk properti seperti ZK_CLIENT_HOSTS dan CASS_HOSTS.

Setiap topologi penginstalan yang dijelaskan di bawah menunjukkan contoh file konfigurasi untuk topologi tersebut. Untuk referensi lengkap tentang file konfigurasi, lihat Referensi File Konfigurasi Edge.

Persyaratan sistem pengujian tanpa menjalankan penginstalan

Edge untuk cloud pribadi mendukung properti ENABLE_SYSTEM_CHECK=y untuk memeriksa persyaratan CPU dan memori di mesin sebagai bagian dari penginstalan. Namun, dalam rilis Edge sebelumnya, pemeriksaan tersebut mengharuskan Anda untuk benar-benar melakukan penginstalan.

Sekarang Anda dapat menggunakan flag "-t" untuk melakukan pemeriksaan tersebut tanpa harus melakukan penginstalan. Misalnya, untuk memeriksa persyaratan sistem untuk penginstalan "aio" tanpa benar-benar melakukan penginstalan, gunakan perintah berikut:

/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile -t

Perintah ini menampilkan error apa pun terkait persyaratan sistem ke layar.

Lihat Persyaratan penginstalan untuk mengetahui daftar persyaratan sistem untuk semua komponen Edge.

File log penginstalan

Secara default, utilitas setup.sh menulis informasi log tentang penginstalan ke:

/opt/apigee/var/log/apigee-setup/setup.log

Jika pengguna yang menjalankan utilitas setup.sh tidak memiliki akses ke direktori tersebut, utilitas akan menulis log ke direktori /tmp sebagai file bernama setup_username.log.

Jika pengguna tidak memiliki akses ke /tmp, utilitas setup.sh akan gagal.

Menginstal komponen Edge

Bagian ini menjelaskan cara menginstal komponen Edge untuk topologi yang berbeda. Urutan penginstalan komponen didasarkan pada topologi yang Anda inginkan.

Semua contoh penginstalan yang ditampilkan di bawah mengasumsikan bahwa Anda menginstal:

  • Dengan autentikasi Cassandra dinonaktifkan (default). Lihat Mengaktifkan autentikasi Cassandra untuk mengetahui informasi selengkapnya.
  • Dengan replikasi master-standby Postgres dinonaktifkan (default). Lihat Menyiapkan replikasi master-standby untuk Postgres untuk mengetahui informasi selengkapnya.
  • Message Processor dan Router di node yang sama. Jika Anda menginstal Message Processor dan Router di node yang berbeda, instal semua Message Processor terlebih dahulu, lalu semua Router.

Prasyarat

Sebelum dapat menginstal komponen Edge, Anda harus:

  • Periksa Persyaratan penginstalan untuk mengetahui prasyarat dan daftar file yang diperlukan sebelum melanjutkan penginstalan. Pastikan Anda telah meninjau persyaratan sebelum memulai proses penginstalan.
  • Nonaktifkan SELinux atau setel ke mode permisif. Lihat Menginstal utilitas apigee-setup Edge untuk mengetahui informasi selengkapnya.

Penginstalan lengkap

  1. Instal semua komponen pada satu node menggunakan perintah: 
    /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. Mulai ulang komponen UI Edge Baru setelah penginstalan selesai: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  3. Uji penginstalan seperti yang dijelaskan di Menguji penginstalan.
  4. Lakukan orientasi organisasi Anda seperti yang dijelaskan di Melakukan orientasi organisasi.

Lihat video penginstalan Edge all-in-one di sini.

Di bawah ini adalah file konfigurasi senyap untuk topologi ini. Untuk referensi lengkap tentang file konfigurasi, lihat Referensi File Konfigurasi Edge.

# With SMTP
IP1=IP_or_DNS_name_of_Node_1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
# Admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

Penginstalan mandiri 2 node

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan jumlah node.

  1. Menginstal Gateway Mandiri dan node 1 
    /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile
  2. Instal Analytics di node 2: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  3. Mulai ulang komponen UI Edge Baru di node 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  4. Uji penginstalan seperti yang dijelaskan di Menguji penginstalan.
  5. Lakukan aktivasi organisasi Anda seperti yang dijelaskan di Mengaktifkan organisasi.

Berikut adalah file konfigurasi otomatis untuk topologi ini. Untuk referensi lengkap tentang file konfigurasi, lihat Referensi File Konfigurasi Edge.

# With SMTP
IP1=IP_of_Node_1
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1"
ZK_CLIENT_HOSTS="$IP1"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

Penginstalan 5 node

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.

  1. Instal cluster Datastore di node 1, 2, dan 3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Instal Server Pengelolaan di node 1: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Instal Router dan Message Processor di node 2 dan 3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Instal Analytics di node 4 dan 5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile
  5. Mulai ulang komponen UI Edge Baru di node 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  6. Uji penginstalan seperti yang dijelaskan di Menguji penginstalan.
  7. Lakukan aktivasi organisasi Anda seperti yang dijelaskan di Mengaktifkan organisasi.

Di bawah ini adalah file konfigurasi senyap untuk topologi ini. Untuk referensi lengkap tentang file konfigurasi, lihat Referensi File Konfigurasi Edge.

# With SMTP
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1 $IP2 $IP3"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP4
PG_STANDBY=$IP5
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

Penginstalan berkluster 9 node

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan nomor node.

  1. Instal Node Cluster Datastore di node 1, 2, dan 3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Instal Server Pengelolaan Apigee di node 1: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Instal Router dan Message Processor di node 4 dan 5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Instal Server Qpid Apigee Analytics di node 6 dan 7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Instal Server Postgres Apigee Analytics di node 8 dan 9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Mulai ulang komponen UI Edge Baru di node 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  7. Uji penginstalan seperti yang dijelaskan di Menguji penginstalan.
  8. Lakukan orientasi organisasi Anda seperti yang dijelaskan di Melakukan orientasi organisasi.

Berikut adalah file konfigurasi otomatis untuk topologi ini. Untuk referensi lengkap tentang file konfigurasi, lihat Referensi File Konfigurasi Edge.

# With SMTP
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=1
APIGEE_LDAPPW=LDAP_PASSWORD
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1 $IP2 $IP3"
# Default is postgres
PG_PWD=postgres
SKIP_SMTP=n
PG_MASTER=$IP8
PG_STANDBY=$IP9
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234

Penginstalan cluster 13 node

Bagian ini menjelaskan urutan penginstalan untuk cluster 13 node. Untuk mengetahui daftar topologi dan jumlah node Edge, lihat Topologi penginstalan.

Urutan penginstalan untuk cluster 13 node adalah sebagai berikut:

  1. Instal Node Cluster Datastore di node 1, 2, dan 3: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Instal SymasLDAP di node 4 dan 5: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile
  3. Instal Apigee Management Server di node 6 dan 7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  4. Instal Server Postgres Apigee Analytics di node 8 dan 9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  5. Instal Router dan Message Processor di node 10 dan 11: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  6. Instal Server Qpid Apigee Analytics di node 12 dan 13: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  7. Mulai ulang komponen New Edge UI di node 6 dan 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  8. Uji penginstalan seperti yang dijelaskan di Menguji penginstalan.
  9. Lakukan aktivasi organisasi Anda seperti yang dijelaskan di Mengaktifkan organisasi.

Berikut adalah contoh file konfigurasi otomatis untuk topologi ini. Untuk referensi lengkap tentang file konfigurasi, lihat Referensi File Konfigurasi Edge.

# For all nodes except IP4 and IP5
# (which are the SymasLDAP nodes)
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
# Management Server on IP6 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=y
LDAP_HOST=$IP4
LDAP_PORT=10389
# Management Server on IP7 only
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=y
# LDAP_HOST=$IP5
# LDAP_PORT=10389
# Use the same password for both SymasLDAP nodes
APIGEE_LDAPPW=LDAP_PASSWORD 
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1 $IP2 $IP3"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP8
PG_STANDBY=$IP9
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234
 
# For SymasLDAP nodes only (IP4 and IP5)
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP4=IP_of_Node_4
IP5=IP_of_Node_5
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
HOSTIP=$(hostname -i)
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD

# For the SymasLDAP Server on IP4 only
MSIP=$IP6
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP5

# For the SymasLDAP Server on IP5 only
# MSIP=$IP7
# USE_LDAP_REMOTE_HOST=n
# LDAP_TYPE=2
# LDAP_SID=2
# LDAP_PEER=$IP4
# Set same password for both SymasLDAPs.
APIGEE_LDAPPW=LDAP_PASSWORD

Penginstalan berkluster 12 node

Sebelum menginstal Edge pada topologi cluster 12 node (dua pusat data), Anda harus memahami cara menetapkan properti ZooKeeper dan Cassandra dalam file konfigurasi otomatis.

  • 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 mana pun dengan pengubah :observer. Node tanpa pengubah :observer disebut "pemilih". Anda harus memiliki jumlah "pemilih" ganjil dalam konfigurasi Anda.

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

    Untuk properti ZK_CLIENT_HOSTS bagi setiap pusat data, tentukan alamat IP atau nama DNS hanya untuk node ZooKeeper di pusat data, dalam urutan yang sama, untuk semua node ZooKeeper di pusat data. Dalam contoh file konfigurasi yang ditunjukkan di bawah, node 9 diberi tag dengan pengubah :observer sehingga Anda memiliki lima pemilih: Node 1, 2, 3, 7, dan 8.

  • Cassandra

    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 seed.

    Dalam model deployment ini, penyiapan Cassandra akan terlihat seperti berikut:

Lihat Topologi penginstalan untuk mengetahui daftar topologi Edge dan jumlah node.

  1. Instal Datastore Cluster Node di node 1, 2, 3, 7, 8, dan 9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
  2. Instal Server Pengelolaan Apigee dengan replikasi SymasLDAP di node 1 dan 7: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
  3. Instal Router dan Message Processor di node 2, 3, 8, dan 9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile
  4. Instal Server Qpid Apigee Analytics di node 4, 5, 10, dan 11: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  5. Instal Server Postgres Apigee Analytics di node 6 dan 12: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Mulai ulang komponen UI Edge Baru di node 1 dan 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
  7. Uji penginstalan seperti yang dijelaskan di Menguji penginstalan.
  8. Lakukan orientasi organisasi Anda seperti yang dijelaskan di Melakukan orientasi organisasi.

Berikut adalah file konfigurasi otomatis untuk topologi ini. Untuk referensi lengkap tentang file konfigurasi, lihat Referensi File Konfigurasi Edge.

  • Mengonfigurasi SymasLDAP dengan replikasi di dua node SymasLDAP.
  • Menentukan pengubah :observer pada satu node ZooKeeper. Dalam penginstalan pusat data tunggal, hapus pengubah tersebut.
# Datacenter 1
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
IP12=IP_of_Node_12
HOSTIP=$(hostname -i)
MSIP=$IP1
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=1
LDAP_PEER=$IP7
APIGEE_LDAPPW=LDAP_PASSWORD
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.
# Optionally use Cassandra racks
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234
 
# Datacenter 2
IP1=IP_of_Node_1
IP2=IP_of_Node_2
IP3=IP_of_Node_3
IP6=IP_of_Node_6
IP7=IP_of_Node_7
IP8=IP_of_Node_8
IP9=IP_of_Node_9
IP12=IP_of_Node_12
HOSTIP=$(hostname -i)
MSIP=$IP7
ENABLE_SYSTEM_CHECK=y
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=ADMIN_PASSWORD
LICENSE_FILE=/tmp/license.txt
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=2
LDAP_SID=2
LDAP_PEER=$IP1
APIGEE_LDAPPW=LDAP_PASSWORD
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.
# Optionally use Cassandra racks
CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1"
# Default is postgres
PG_PWD=postgres
PG_MASTER=$IP6
PG_STANDBY=$IP12
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
# omit for no username
SMTPPASSWORD=SMTP_PASSWORD
# omit for no password
SMTPSSL=n
SMTPPORT=25
SMTPMAILFROM="My Company <myco@company.com>"
# Set up username and password to access Qpid broker's management console
QPID_MGMT_USERNAME=qpid
QPID_MGMT_PASSWORD=QPIDPass1234