Memindahkan komponen dari satu mesin ke mesin lainnya dapat menyebabkan ketidakcocokan konfigurasi jika Anda tidak menyimpan alamat IP di file konfigurasi komponen Anda secara sinkron.
Bagian ini menjelaskan cara mendiagnosis dan memperbaiki ketidakcocokan konfigurasi.
Alamat IP versus nama {i>host<i}
Anda harus menggunakan alamat IP, bukan nama host, di file konfigurasi komponen Anda.
Meskipun beberapa file konfigurasi komponen memungkinkan Anda menggunakan nama host, bukan alamat IP, penggunaan nama host dapat mempersulit pemecahan masalah. Misalnya, nama host dapat menjadi sumber masalah terkait konektivitas server DNS, kegagalan pencarian, dan sinkronisasi.
Oleh karena itu, Apigee sangat merekomendasikan penggunaan alamat IP untuk semua konfigurasi komponen. Dalam beberapa kasus, seperti pada Cassandra, Anda harus menggunakan alamat IP dan tidak boleh menggunakan nama host. Sebagian besar contoh dalam dokumentasi menggunakan alamat IP untuk konfigurasi komponen.
Untuk nama host dan alamat IP, pertimbangkan implikasi skenario berikut saat memindahkan server Apigee:
Skenario | Dampak terhadap server pindah |
---|---|
Perubahan alamat IP | Perbarui semua file terkait yang merujuk ke alamat IP asli |
Nama host diubah tanpa perubahan alamat IP | Tidak ada dampak |
Nama host berubah dengan perubahan alamat IP | Sama seperti perubahan alamat IP |
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
di sistem yang sedang diubah. Jika file tidak ada, buat file tersebut. - Ubah parameter berikut:
- Setel parameter
conf_cassandra_seeds
danconf_cassandra_listen_address
untuk menentukan alamat IP baru sistem. - Ubah
conf_cassandra_rpc_address
agar menggunakan alamat IP baru atau 0.0.0.0 (yang memungkinkan Cassandra Thrift memproses semua antarmuka).
- Setel parameter
- Buka
/opt/apigee/apigee-cassandra/conf/cassandra-topology.properties
di editor. Anda akan melihat alamat IP lama dan setelan default dalam formulir: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 memasukkan "\n" setelah alamat IP, dan menentukan setelan default yang sama seperti yang ditemukan di atas pada Langkah 3.
- Mulai ulang Cassandra:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- Jika perlu, perbaiki juga ZooKeeper (lihat Mengubah alamat IP node ZooKeeper). Jika tidak, 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
pada setiap sistem di ring, dan ubah parameterconf_cassandra_seeds
untuk menyertakan IP baru sistem yang dimodifikasi. Jika file cassandra.properties tidak ada, Anda dapat membuatnya. - Edit
/opt/apigee/customer/application/cassandra.properties
di sistem yang sedang diubah, dan ubah parameter berikut:- Tetapkan
conf_cassandra_listen_address
untuk menggunakan alamat IP baru. - Tetapkan
conf_cassandra_rpc_address
agar menggunakan alamat IP baru atau "0.0.0.0" (yang memungkinkan Cassandra Thrift untuk memproses semua antarmuka).
- Tetapkan
- Buka
/opt/apigee/apigee-cassandra/conf/cassandra-topology.properties
di editor. Anda akan melihat semua alamat IP Cassandra dan setelan default dalam bentuk: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 memasukkan "\n" setelah setiap alamat IP dan menggunakan setelan default yang sama, seperti yang dicatat di atas pada Langkah 3.
- Mulai ulang Cassandra di sistem yang diubah.
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- Untuk semua {i>node<i} lainnya, ulangi perubahan yang dibuat pada langkah 3 dan 4 untuk memberi tahu mereka tentang posisi {i>node<i} ini di cincin Cassandra. Selain itu, ubah IP node seed seperti yang dijelaskan di langkah 1.
- Mulai ulang setiap node Cassandra yang tersisa satu per satu.
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- Jalankan perintah
nodetool ring
pada node yang diubah untuk memastikan bahwa cincin telah selesai. Utilitas ini dapat ditemukan di/opt/apigee/apigee-cassandra/bin
.nodetool [-u username -pw password] -h localhost ring
- Jalankan
nodetool repair
pada node yang diubah. Perhatikan bahwa proses ini mungkin memerlukan waktu beberapa saat, jadi sebaiknya hal ini tidak dilakukan selama jam traffic API puncak.nodetool [-u username -pw password] -h localhost repair -pr
- Jika perlu, perbaiki ZooKeeper (lihat Mengubah alamat IP node ZooKeeper), 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 ini. 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 datanya. Dalam satu penginstalan pusat data, nilainya biasanya adalah "dc-1".
-
- Daftarkan alamat IP baru menggunakan salah satu perintah di bawah. Perintah yang diperlukan akan bergantung pada jenis node yang diubah.
- 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 tempat alamat IP
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 ini untuk mengubah alamat IP node ZooKeeper:
Mengubah Alamat IP dan memulai ulang ensemble ZooKeeper (hanya 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 format: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 properticonf_zoo_quorum
ke alamat IP yang benar. Jika file tidak ada, Anda bisa membuatnya.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 memasukkan "\n" setelah setiap alamat IP dan entri berada dalam urutan yang sama di setiap node.
- Temukan pemimpin ensemble ZooKeeper dengan menggunakan perintah berikut (ganti
node dengan alamat IP mesin Zookeeper):
echo srvr | nc node 2181
Baris Mode dalam output harus bertuliskan "leader".
- Mulai ulang satu ZooKeeper setelah yang lain dimulai dengan pemimpin dan diakhiri dengan node tempat alamat IP diubah. Jika ada lebih dari satu node Zookeeper yang 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 konfigurasi yang diubah
- Pada setiap node Router, edit file
/opt/apigee/customer/application/router.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
- Ubah parameter
- Di setiap node Pemroses Pesan, 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
- Ubah parameter
- Pada 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
- Ubah parameter
- 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:
- Pada node Management Server, edit file
/opt/apigee/customer/application/management-server.properties
. Jika file tidak ada, buat file tersebut. - Dalam file
management-server.properties
, tetapkan parameterconf_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 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.
Untuk mengetahui informasi cara mendapatkan UUID komponen, baca Mendapatkan UUID.