Edge untuk Private Cloud v4.19.01
Dokumen ini menjelaskan cara menambahkan tiga node Cassandra baru ke penginstalan Edge for Private Cloud yang ada.
Meskipun Anda dapat menambahkan satu atau dua node Cassandra ke penginstalan Edge yang ada, Apigee merekomendasikan agar Anda menambahkan tiga node sekaligus.
Untuk daftar persyaratan sistem untuk node Cassandra, lihat Persyaratan penginstalan.
Konfigurasi Edge yang ada
Semua topologi Edge yang didukung untuk sistem produksi menentukan untuk menggunakan tiga node Cassandra. Ketiga node tersebut ditentukan ke properti CASS_HOSTS
dalam file konfigurasi seperti yang ditunjukkan di bawah:
IP1=10.10.0.1 IP2=10.10.0.2 IP3=10.10.0.3 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=1 APIGEE_LDAPPW=secret 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:1,1 $IP2:1,1 $IP3:1,1" SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com SMTPPASSWORD=smtppwd
Perhatikan bahwa properti REGION
menentukan nama wilayah sebagai "dc-1". Anda memerlukan informasi tersebut saat menambahkan node Cassandra baru.
Memodifikasi file konfigurasi untuk menambahkan tiga node Cassandra baru
Dalam contoh ini, tiga node Cassandra baru berada di alamat IP berikut:
- 10.10.0.14
- 10.10.0.15
- 10.10.0.16
Anda harus memperbarui file konfigurasi Edge terlebih dahulu untuk menambahkan node baru:
IP1=10.10.0.1 IP2=10.10.0.2 IP3=10.10.0.3 # Add the new node IP addresses. IP14=10.10.0.14 IP15=10.10.0.15 IP16=10.10.0.16 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.com ... # Update CASS_HOSTS to add each new node after an existing nodes. # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1:1,1 $IP14:1,1 $IP2:1,1 $IP15:1,1 $IP3:1,1 $IP16:1,1"
Cara ini memastikan bahwa node yang ada mempertahankan setelan token awalnya, dan token awal setiap node baru berada di antara nilai token dari node yang ada.
Konfigurasi Edge
Setelah mengedit file konfigurasi, Anda harus:
- Mengonfigurasi ulang node Cassandra yang ada
- Instal Cassandra di node baru
- Mengonfigurasi Ulang Server Pengelolaan
Mengonfigurasi ulang node Cassandra yang ada
Di node Cassandra yang ada:
- Jalankan kembali setup.sh dengan profil "-p c" dan file konfigurasi baru:
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
Instal Cassandra di node baru
Pada setiap node Cassandra yang baru:
- Instal Cassandra di tiga node:
- Instal
apigee-setup
pada node pertama seperti yang dijelaskan dalam Menginstal utilitas penyiapan apigee Edge. - Instal Cassandra pada node pertama menggunakan file konfigurasi yang telah diupdate:
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
- Ulangi dua langkah ini untuk node Cassandra baru yang tersisa.
- Instal
- Build ulang tiga node Cassandra baru, dengan menentukan nama region yang ditetapkan dalam file konfigurasi berdasarkan properti
REGION
. Dalam contoh ini, "dc-1":- Pada node pertama, jalankan:
/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h nodeIP rebuild dc-1
Dengan nodeIP adalah alamat IP node Cassandra.
Anda hanya perlu meneruskan nama pengguna dan sandi jika mengaktifkan autentikasi JMX untuk Cassandra.
- Ulangi langkah ini pada node Cassandra baru yang tersisa.
- Pada node pertama, jalankan:
Mengonfigurasi Ulang Server Pengelolaan
Pada node Management-Server
- Jalankan kembali setup.sh untuk mengupdate Server Pengelolaan bagi node Cassandra yang baru ditambahkan:
/opt/apigee/apigee-setup/bin/setup.sh -p ms -f updatedConfigFile
Mulai ulang semua Router dan Pemroses Pesan
- Di semua Router:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- Pada semua Pemroses Pesan:
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
Mengosongkan ruang penyimpanan pada node Cassandra yang ada
Setelah menambahkan node baru, Anda dapat menggunakan perintah nodetool cleanup
pada node yang sudah ada untuk mengosongkan ruang disk. Perintah ini menghapus token konfigurasi yang tidak lagi dimiliki oleh node Cassandra yang sudah ada.
Untuk mengosongkan ruang disk pada node Cassandra yang sudah ada setelah menambahkan node baru, jalankan perintah berikut:
/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h cassandraIP cleanup
Anda hanya perlu meneruskan nama pengguna dan sandi jika mengaktifkan autentikasi JMX untuk Cassandra.
Memverifikasi pembuatan ulang
Gunakan perintah berikut untuk memverifikasi bahwa build ulang berhasil:
nodetool [-u username -pw password] -h nodeIP netstats
Perintah ini harus menunjukkan MODE: Normal
saat node aktif dan indeks
di-build.
nodetool [-u username -pw password] -h nodeIP statusthrift
Harus menunjukkan bahwa server barang bekas sedang berjalan, yang memungkinkan Cassandra menerima permintaan klien baru.
nodetool [-u username -pw password] -h nodeIP statusbinary
Harus menunjukkan bahwa transport native (atau protokol biner) sedang berjalan.
nodetool describecluster
Harus menunjukkan bahwa node baru menggunakan versi skema yang sama dengan node lama.
Untuk informasi selengkapnya mengenai penggunaan nodetool
, lihat
dokumentasi penggunaan nodetool.