Memindahkan server Apigee

Memindahkan komponen dari satu komputer ke komputer 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 yang terkait dengan konektivitas server DNS, kegagalan pencarian, dan sinkronisasi.

Oleh karena itu, Apigee sangat merekomendasikan penggunaan alamat IP untuk semua komponen konfigurasi standar. Dalam beberapa kasus, seperti pada Cassandra, Anda harus menggunakan alamat IP dan tidak dapat menggunakan nama {i>host<i}. Sebagian besar contoh dalam dokumentasi menggunakan alamat IP untuk konfigurasi komponen.

Untuk nama host dan alamat IP, pertimbangkan implikasi dari skenario berikut saat memindahkan server Apigee:

Skenario Dampak pada pemindahan server
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:

Sebagai dengan satu node Cassandra

  1. Edit /opt/apigee/customer/application/cassandra.properties pada sistem yang diubah. Jika file tidak ada, buat file tersebut.
  2. Ubah parameter berikut:
    • Menyetel conf_cassandra_seeds dan conf_cassandra_listen_address parameter untuk menetapkan alamat IP baru sistem.
    • Ubah conf_cassandra_rpc_address yang akan digunakan baik alamat IP baru atau 0.0.0.0 (yang memungkinkan Cassandra Thrift untuk mendengarkan semua antarmuka).
  3. 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.

  4. 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 pengaturan {i>default<i} yang sama dengan yang Anda temukan di atas pada Langkah 3.

  5. Mulai ulang Cassandra: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Jika perlu juga perbaiki ZooKeeper (lihat di bawah), atau mulai ulang setiap platform Apigee yang dimulai dengan Server Pengelolaan.

Sebagai konfigurasi dengan beberapa node Cassandra (ring)

  1. Jika node yang diubah adalah node seed, edit /opt/apigee/customer/application/cassandra.properties di setiap sistem di dalam ring, dan ubah parameter conf_cassandra_seeds untuk menyertakan IP baru dari sistem yang dimodifikasi. Jika file cassandra.properties tidak ada, buat anotasi.
  2. Edit /opt/apigee/customer/application/cassandra.properties pada sistem yang 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).
  3. Buka /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties di editor. Anda akan melihat semua alamat IP Cassandra dan pengaturan {i>default<i} di 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.

  4. 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 gunakan pengaturan {i>default<i} yang sama dengan yang dicatat di atas pada Langkah 3.

  5. Mulai ulang Cassandra di sistem yang diubah. Jika sistem yang dimodifikasi adalah simpul inti, juga memulai ulang setiap sistem yang menggunakan {i> seed node<i} yang dimodifikasi. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Jalankan perintah nodetool ring pada node yang diubah untuk memastikan bahwa cincin telah selesai. Alat tersebut dapat ditemukan di /opt/apigee/apigee-cassandra/bin. 
    nodetool [-u username -pw password] -h localhost ring

    Anda hanya perlu memasukkan nama pengguna dan {i>password<i} jika Anda mengaktifkan autentikasi JMX untuk Cassandra.

  7. Jalankan nodetool repair di node yang dimodifikasi. Perhatikan bahwa proses ini mungkin memerlukan waktu beberapa saat, jadi sebaiknya jangan dilakukan selama jam sibuk traffic API. 
    nodetool [-u username -pw password] -h localhost repair -pr
  8. Jika perlu, perbaiki ZooKeeper (lihat di bawah), lalu mulai ulang setiap komponen platform Apigee, dimulai dengan Server Pengelolaan.

Mengupdate datastore pendaftaran

  1. Temukan UUID pendaftaran datastore yang menentukan alamat IP lama dengan menggunakan perintah di bawah ini. Perhatikan "jenis" dan "UUID" parameter: 
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=central&region=DC" | egrep -i '[type|internalip|uuid|region]'
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=gateway&region=DC" | egrep -i '[type|internalip|uuid|region]'
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=analytics&region=DC" | egrep -i '[type|internalip|uuid|region]'

      Dengan DC adalah nama pusat datanya. Dalam satu instalasi pusat data, nilainya biasanya "dc-1".

  2. Daftarkan alamat IP baru menggunakan salah satu perintah di bawah. Perintah yang dibutuhkan 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&region=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&region=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&region=REGION&pod=analytics" \
  -H 'content-type: application/x-www-form-urlencoded' -X POST
  3. Menghapus pendaftaran lama untuk UUID sistem tempat alamat IP berada ubah. 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 (untuk konfigurasi ensemble multi-node saja)

  1. Buka /opt/apigee/apigee-zookeeper/conf/zoo.cfg di editor. Anda akan melihat semua alamat IP ZooKeeper dan setelan default dalam bentuk: 
    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.

  2. Edit file /opt/apigee/customer/application/zookeeper.properties di setiap node ZooKeeper untuk menetapkan properti conf_zoo_quorum ke alamat IP yang benar. Jika file tidak ada, buatlah. 
    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 itu berada dalam urutan yang sama di ke setiap node.

  3. Temukan pemimpin ansambel ZooKeeper dengan menggunakan perintah berikut (ganti node dengan alamat IP komputer Zookeeper): 
    echo srvr | nc node 2181

    Baris Mode dalam output harus bertuliskan "leader".

  4. Mulai ulang satu ZooKeeper setelah yang lain dimulai dengan pemimpin dan diakhiri dengan node tempat alamat IP diubah. Jika lebih dari satu {i>node<i} penjaga kebun binatang mengubah alamat IP, mungkin diperlukan untuk memulai ulang semua node. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
  5. Gunakan perintah echo yang dijelaskan di atas untuk memverifikasi setiap node ZooKeeper.

Memberi tahu node Apigee tentang konfigurasi yang diubah

  1. Di 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 IP baru Anda
    • Ubah parameter conf_zookeeper_zk1.host untuk menyertakan alamat IP baru
  2. Edit file /opt/apigee/customer/application/message-processor.properties di setiap node Pemroses Pesan sebagai berikut. Jika file tidak ada, buat file tersebut.
    • Ubah parameter conf_zookeeper_connection.string untuk menyertakan yang baru Alamat IP
    • Ubah parameter conf_zookeeper_zk1.host untuk menyertakan IP baru Anda
  3. 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 yang baru Alamat IP
    • Ubah parameter conf_zookeeper_zk1.host untuk menyertakan IP baru Anda
  4. Mulai ulang semua komponen platform Apigee dengan menjalankan perintah berikut pada 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:

  1. Pada node Server Pengelolaan, edit file /opt/apigee/customer/application/management-server.properties . Jika file tidak ada, buat file tersebut.
  2. Di file management-server.properties, tetapkan parameter conf_security_ldap.server.host ke alamat IP baru.
  3. Mulai ulang Server Pengelolaan: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Mengubah alamat IP node Apigee lain jenis

Untuk mengubah alamat IP salah satu jenis node ini (Router, Message Processor, Postgres Server (bukan postgresql) dan Server Qpid (bukan qpidd):

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