Edge for Private Cloud v4.18.01
Komponen Apigee menggunakan alamat IP untuk berkomunikasi satu sama lain. Memindahkan komponen dari satu mesin ke mesin lain dapat menyebabkan ketidakcocokan konfigurasi. Untuk memperbaiki ketidakcocokan konfigurasi, ikuti petunjuk yang relevan di bawah.
Mengubah Alamat IP Node Cassandra
Untuk mengubah alamat IP node Cassandra, lakukan langkah-langkah berikut:
Untuk konfigurasi dengan satu node Cassandra
- Edit /opt/apigee/customer/application/cassandra.properties pada sistem yang sedang diubah. Jika file tidak ada, buat file tersebut.
- Ubah parameter berikut:
- Tetapkan parameter conf_cassandra_seeds dan conf_cassandra_listen_address untuk menentukan alamat IP baru sistem.
- Ubah conf_cassandra_rpc_address untuk menggunakan alamat IP baru atau 0.0.0.0 (yang memungkinkan Cassandra Thrift memproses semua antarmuka).
- Buka /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties
di editor. Anda akan melihat alamat IP lama dan setelan default dalam bentuk:
192.168.56.101=dc-1:ra-1
default=dc-1:ra-1
Simpan informasi tersebut. - Edit /opt/apigee/customer/application/cassandra.properties
untuk mengubah alamat IP lama yang ditentukan ke alamat IP baru:
conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n
Pastikan Anda menyisipkan “\n” setelah alamat IP, dan tentukan setelan default yang sama seperti yang Anda temukan di atas pada Langkah 3. - Mulai ulang Cassandra:
> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart - Jika perlu, perbaiki juga ZooKeeper (lihat di bawah), atau mulai ulang setiap komponen platform Apigee, dimulai dengan Server Pengelolaan.
Untuk konfigurasi dengan beberapa node Cassandra (ring)
- Jika node yang diubah adalah node seed, edit file /opt/apigee/customer/application/cassandra.properties di setiap sistem dalam ring, dan ubah parameter conf_cassandra_seeds untuk menyertakan IP baru sistem yang diubah. Jika file cassandra.properties tidak ada, buat file tersebut.
- Edit /opt/apigee/customer/application/cassandra.properties
pada sistem yang sedang diubah, dan ubah parameter berikut:
- Tetapkan conf_cassandra_listen_address untuk menggunakan alamat IP baru.
- Tetapkan conf_cassandra_rpc_address untuk menggunakan alamat IP baru atau 0.0.0.0 (yang memungkinkan Cassandra Thrift memproses semua antarmuka).
- Buka /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties
di editor. Anda akan melihat semua alamat IP Cassandra dan setelan default dalam
formulir:
192.168.56.101=dc-1:ra-1
192.168.56.102=dc-1:ra-1
192.168.56.103=dc-1:ra-1
default=dc-1:ra-1
Simpan informasi tersebut. - Edit /opt/apigee/customer/application/cassandra.properties
untuk mengubah alamat IP lama yang ditentukan ke alamat IP baru:
conf_cassandra-topology_topology=192.168.56.101=dc-1:ra-1\n192.168.56.102=dc-1:ra-1\n192.168.56.104=dc-1:ra-1\ndefault=dc-1:ra-1\n
Pastikan Anda menyisipkan "\n" setelah setiap alamat IP, dan gunakan setelan default yang sama seperti yang Anda catat di atas pada Langkah 3. - Mulai ulang Cassandra pada sistem yang dimodifikasi. Jika sistem yang diubah adalah node seed, mulai ulang juga setiap sistem yang menggunakan node seed yang diubah.
> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart - Jalankan perintah nodetool ring
pada node yang dimodifikasi untuk memastikan bahwa ring sudah lengkap. Utilitas ini dapat ditemukan di
opt/apigee/apigee-cassandra/bin.
> nodetool -h localhost ring - Jalankan nodetool repair pada node yang diubah. Perhatikan bahwa proses ini mungkin memerlukan waktu, jadi sangat disarankan
untuk tidak melakukannya selama jam traffic API puncak.
> nodetool -h localhost repair - Jika perlu, perbaiki ZooKeeper (lihat di bawah), lalu mulai ulang setiap komponen platform Apigee, dimulai dengan Server Pengelolaan
Memperbarui pendaftaran datastore
- Temukan UUID pendaftaran datastore yang menentukan alamat IP lama menggunakan perintah di bawah. Catat parameter "type" dan "UUID":
- curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=central®ion=DC" | egrep -i '(type|internalip|uuid|region)'
- curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=gateway®ion=DC" | egrep -i '(type|internalip|uuid|region)'
- curl -u $ADMINEMAIL:$PW
"http://$MSIP:$port/v1/servers?pod=analytics®ion=DC"
| egrep -i '(type|internalip|uuid|region)'
dengan DC adalah nama pusat data. Dalam penginstalan pusat data tunggal, nilainya biasanya "dc-1".
- Daftarkan alamat IP baru menggunakan salah satu perintah di bawah. Perintah yang diperlukan akan bergantung pada jenis node yang diubah.
Catatan: Parameter REGION di bawah mengacu pada pusat data tempat cluster berada. Misalnya, untuk ketersediaan tinggi, Anda biasanya akan memiliki cluster di dc-1 (Pusat Data 1) dan cluster di dc-2 (Pusat Data 2). Parameter ini ditentukan pada waktu penginstalan. Nilai defaultnya adalah dc-1.- Untuk type="application-datastore":
curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers -d "Type=application-datastore&Type=audit-datastore&InternalIP=${NEWIP}®ion=${REGION}&pod=central" -H 'content-type: application/x-www-form-urlencoded' -X POST - Untuk type="kms-datastore":
curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers -d "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore&Type=counter-datastore&Type=cache-datastore &InternalIP=${NEWIP}®ion=${REGION}&pod=${GATEWAY_POD}" -H 'content-type: application/x-www-form-urlencoded' -X POST - Untuk type="reportcrud-datastore":
curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers" -d "Type=reportcrud-datastore&InternalIP=${NEW_IP}®ion=${REGION}&pod=analytics" -H 'content-type: application/x-www-form-urlencoded' -X POST
- Untuk type="application-datastore":
- Hapus pendaftaran lama untuk UUID sistem yang alamat IP-nya diubah. Untuk setiap masalah UUID ini:
curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers/${OLD_UUID}" -X DELETE
Mengubah Alamat IP Node ZooKeeper
Ikuti langkah-langkah di bawah untuk mengubah alamat IP node ZooKeeper:
Mengubah Alamat IP dan memulai ulang ensemble ZooKeeper (khusus untuk konfigurasi ensemble multi-node)
- Buka /opt/apigee/apigee-zookeeper/conf/zoo.cfg
di editor. Anda akan melihat semua alamat IP ZooKeeper dan setelan default dalam
formulir:
server.1=192.168.56.101:2888:3888
server.2=192.168.56.102:2888:3888
server.3=192.168.56.103:2888:3888
Simpan informasi tersebut. - Di setiap node ZooKeeper, edit file /opt/apigee/customer/application/zookeeper.properties
untuk menetapkan properti conf_zoo_quorum
ke alamat IP yang benar. Jika file tidak ada, buat file tersebut.
conf_zoo_quorum=server.1=192.168.56.101:2888:3888\nserver.2=192.168.56.102:2888:3888\nserver.3=192.168.56.104:2888:3888\n
Pastikan Anda menyisipkan “\n” setelah setiap alamat IP dan entri berada dalam urutan yang sama di setiap node. - Temukan leader ensemble ZooKeeper menggunakan perintah berikut (ganti
<node> dengan alamat IP mesin Zookeeper):
echo srvr | nc <node> 2181
Baris Mode dalam output harus bertuliskan "leader". - Mulai ulang ZooKeeper satu per satu, dimulai dengan leader dan diakhiri dengan node yang alamat IP-nya diubah. Jika lebih dari satu node zookeeper mengubah alamat IP, Anda mungkin perlu memulai ulang semua node.
> /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart - Gunakan perintah echo yang dijelaskan di atas untuk memverifikasi setiap node ZooKeeper.
Memberi tahu node Apigee tentang perubahan konfigurasi
- Pada setiap node Router, edit file /opt/apigee/customer/application/router.properties
sebagai berikut. Jika file tidak ada, buat file tersebut.
- Ubah parameter string conf_zookeeper_connection untuk menyertakan alamat IP baru
- Ubah parameter conf_zookeeper_zk1.host untuk menyertakan alamat IP baru
- Di setiap node Message Processor, edit file /opt/apigee/customer/application/message-processor.properties
sebagai berikut. Jika file tidak ada, buat file tersebut.
- Ubah parameter conf_zookeeper_connection.string untuk menyertakan alamat IP baru
- Ubah parameter conf_zookeeper_zk1.host untuk menyertakan alamat IP baru
- Di node Server Pengelolaan, edit file /opt/apigee/customer/application/management-server.properties
sebagai berikut. Jika file tidak ada, buat file tersebut.
- Ubah parameter conf_zookeeper_connection.string untuk menyertakan alamat IP baru
- Ubah parameter conf_zookeeper_zk1.host untuk menyertakan alamat IP baru
- Mulai ulang semua komponen platform Apigee dengan menjalankan perintah berikut di setiap node:
/opt/apigee/apigee-service/bin/apigee-all restart
Mengubah Alamat IP Server LDAP (OpenLDAP)
Untuk mengubah alamat IP node OpenLDAP, lakukan hal berikut:
- Di node Server Pengelolaan, edit file /opt/apigee/customer/application/management-server.properties. Jika file tidak ada, buat file tersebut.
- Dalam file management-server.properties, tetapkan parameter conf_security_ldap.server.host ke alamat IP baru.
- Mulai ulang Server Pengelolaan:
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
Mengubah Alamat IP Jenis Node Apigee Lainnya
Untuk mengubah alamat IP salah satu jenis node ini (Router, Message Processor, Postgres Server (bukan postgresql), dan Qpid Server (bukan qpidd):
- Gunakan perintah cURL berikut untuk mendaftarkan alamat IP internal dan eksternal yang baru:
curl -u $ADMINEMAIL:$PW -X PUT http://$MSIP:8080/v1/servers/<uuid> -d ExternalIP=<ip>
curl -u $ADMINEMAIL:$PW -X PUT http://$MSIP:8080/v1/servers/<uuid> -d InternalIP=<ip>
dengan uuid adalah UUID node.
Jika Anda tidak mengetahui UUID node, Anda dapat menggunakan perintah berikut untuk menampilkannya:
- Router: curl http://<router_IP>:8081/v1/servers/self
- Message Processor: curl http://<mp_IP>:8082/v1/servers/self
- Qpid: curl http://<qp_IP>:8083/v1/servers/self
- Postgres: curl http://<pg_IP>:8084/v1/servers/self