Menginstal komponen Edge pada node

Setelah 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 adalah komponen Edge yang akan diinstal, dan configFile adalah file konfigurasi senyap 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 tempat lain 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 dengan menggunakan properti dalam file konfigurasi senyap. Atau, Anda dapat mengaktifkan replikasi master-standby setelah penginstalan. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan replikasi master-standby untuk Postgres.

Pertimbangan symasldap 2.6.7 untuk RHEL 9.X/Rocky 9.X/Oracle 9.X

Penginstalan di tempat memerlukan SymasLDAP 2.6.7, yang disertakan dalam repo apigee-thirdparty-opdk. Untuk memudahkan penginstalan, 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 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. Hal 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 keberhasilan penginstalan.

Menginstal UI Edge baru

Setelah menyelesaikan penginstalan awal, Apigee merekomendasikan agar Anda menginstal UI Edge baru, yang merupakan antarmuka pengguna yang ditingkatkan untuk developer dan administrator Apigee Edge untuk Private Cloud. (UI Klasik diinstal secara default.)

Perhatikan bahwa UI Edge mengharuskan Anda menonaktifkan Autentikasi dasar dan menggunakan IDP seperti SAML atau LDAP.

Untuk mengetahui informasi selengkapnya, lihat Menginstal 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 mana yang akan diinstal di node:

Komponen Deskripsi

c

Instal Cassandra saja.
zk menginstal ZooKeeper saja.

ds

Instal ZooKeeper dan Cassandra.

ld

Instal SymasLDAP saja.

mt

Instal Edge Management Server, yang juga menginstal SymasLDAP.

Jika Anda menetapkan USE_LDAP_REMOTE_HOST=y dalam file config, penginstalan SymasLDAP akan dilewati dan Server Pengelolaan akan menggunakan SymasLDAP yang diinstal di node lain.

ms

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

Jika Anda menetapkan USE_LDAP_REMOTE_HOST=y dalam file config, penginstalan SymasLDAP akan dilewati dan Server Pengelolaan akan menggunakan SymasLDAP yang diinstal di node lain.

r

Hanya menginstal Edge Router.

mp

Instal hanya Edge Message Processor.

rmp

Instal Edge Router dan Message Processor.

ui

Instal UI Edge.

qs

Instal Qpid Server saja.

ps

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

sax

Instal komponen analisis, yaitu Qpid dan Postgres.

Gunakan opsi ini hanya untuk pengembangan dan pengujian, bukan untuk produksi.
sso Instal modul Apigee SSO.

mo

Instal Monetisasi.

sa

Instal Edge secara mandiri, yang berarti Cassandra, ZooKeeper, Management Server, SymasLDAP, Edge UI, 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 Private Cloud mendukung properti ENABLE_SYSTEM_CHECK=y untuk memeriksa persyaratan CPU dan memori di mesin sebagai bagian dari penginstalan. Namun, pada rilis Edge sebelumnya, pemeriksaan tersebut mengharuskan Anda benar-benar melakukan penginstalan.

Sekarang Anda dapat menggunakan tanda "-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 Pemroses Pesan dan Router di node yang berbeda, instal semua Pemroses Pesan terlebih dahulu, lalu semua Router.

Prasyarat

Sebelum dapat menginstal komponen Edge, Anda harus:

  • Periksa Persyaratan penginstalan untuk prasyarat dan daftar file yang diperlukan untuk didapatkan 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.

Pemasangan lengkap

  1. Instal semua komponen di satu node menggunakan perintah: 
    /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
  2. Mulai ulang komponen UI Klasik setelah penginstalan selesai: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Hal ini berlaku untuk UI Klasik, bukan UI Edge baru yang nama komponennya adalah edge-management-ui.

  3. Uji penginstalan seperti yang dijelaskan di Menguji penginstalan.
  4. Lakukan aktivasi organisasi Anda seperti yang dijelaskan di Mengaktifkan organisasi.

Lihat video penginstalan all-in-one Edge 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. Instal Standalone Gateway 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 Klasik di node 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Hal ini berlaku untuk UI Klasik, bukan UI Edge baru yang nama komponennya adalah edge-management-ui.

  4. Uji penginstalan seperti yang dijelaskan di Menguji penginstalan.
  5. 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
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 jumlah 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 Klasik di node 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Hal ini berlaku untuk UI Klasik, bukan UI Edge baru yang nama komponennya adalah edge-management-ui.

  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 jumlah 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 Apigee Management Server 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 Apigee Analytics Postgres Server di node 8 dan 9: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Mulai ulang komponen UI Klasik di node 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Hal ini berlaku untuk UI Klasik, bukan UI Edge baru, yang nama komponennya adalah edge-management-ui.

  7. Uji penginstalan seperti yang dijelaskan di Menguji penginstalan.
  8. 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
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 bercluster 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 Apigee Analytics Postgres Server 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 UI Klasik di node 6 dan 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Hal ini berlaku untuk UI Klasik, bukan UI Edge baru yang nama komponennya adalah edge-management-ui.

  8. Uji penginstalan seperti yang dijelaskan di Menguji penginstalan.
  9. Lakukan aktivasi organisasi Anda seperti yang dijelaskan di Mengaktifkan organisasi.

Di bawah ini adalah contoh file konfigurasi senyap untuk topologi ini. Untuk referensi lengkap pada 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 bercluster 12 node

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

  • 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 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 untuk 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. 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 untuk 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 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 Apigee Management Server 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 Apigee Analytics Postgres Server di node 6 dan 12: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
  6. Mulai ulang komponen UI Klasik di node 1 dan 7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    Hal ini berlaku untuk UI Klasik, bukan UI Edge baru yang nama komponennya adalah edge-management-ui.

  7. Uji penginstalan seperti yang dijelaskan di Menguji penginstalan.
  8. 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.

  • Mengonfigurasi SymasLDAP dengan replikasi di dua node SymasLDAP.
  • Menentukan pengubah :observer pada satu node ZooKeeper. Dalam penginstalan satu pusat data, 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