Memindahkan server Apigee

Memindahkan komponen dari satu mesin ke mesin lain dapat menyebabkan ketidakcocokan konfigurasi jika Anda tidak menyinkronkan alamat IP dalam file konfigurasi komponen.

Bagian ini menjelaskan cara mendiagnosis dan memperbaiki ketidakcocokan konfigurasi.

Alamat IP versus nama host

Anda harus menggunakan alamat IP, bukan nama host, dalam file konfigurasi komponen.

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 dengan Cassandra, Anda harus menggunakan alamat IP dan tidak dapat menggunakan nama host. 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 mereferensikan alamat IP asli
Perubahan nama host tanpa perubahan alamat IP Tidak ada dampak
Perubahan nama host 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

  1. Edit /opt/apigee/customer/application/cassandra.properties di sistem yang sedang diubah. Jika file tidak ada, buat file tersebut.
  2. Ubah parameter berikut:
    • Tetapkan parameter conf_cassandra_seeds dan conf_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 di semua antarmuka).
  3. Buka /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties di editor. Anda akan melihat alamat IP lama dan setelan default di 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 menyisipkan "\n" setelah alamat IP, dan tentukan setelan default yang sama seperti 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, 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)

  1. Jika node yang diubah adalah node awal, 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.
  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 di semua antarmuka).
  3. 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.

  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 menyisipkan "\n" setelah setiap alamat IP, dan menggunakan setelan default yang sama seperti yang Anda catat di atas pada Langkah 3.

  5. Mulai ulang Cassandra di sistem yang telah diubah.
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Untuk semua node lainnya, ulangi perubahan yang dilakukan pada langkah 3 dan 4 untuk memberi tahu mereka tentang posisi node ini dalam ring Cassandra. Selain itu, ubah IP node awal seperti yang dijelaskan di langkah 1.
  7. Mulai ulang setiap node Cassandra yang tersisa satu per satu.
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  8. Jalankan perintah nodetool ring pada node yang diubah untuk memastikan bahwa dering selesai. Utilitas ini dapat ditemukan di /opt/apigee/apigee-cassandra/bin.
    nodetool [-u username -pw password] -h localhost ring
  9. Jalankan nodetool repair pada node yang diubah. Perhatikan bahwa proses ini mungkin memerlukan waktu, jadi sebaiknya jangan dilakukan selama jam traffic API puncak.
    nodetool [-u username -pw password] -h localhost repair -pr
  10. Jika perlu, perbaiki ZooKeeper (lihat Mengubah alamat IP node ZooKeeper), lalu mulai ulang setiap komponen platform Apigee, dimulai dengan Management Server.

Memperbarui pendaftaran datastore

  1. 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&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 data. Dalam penginstalan pusat data tunggal, nilai biasanya adalah "dc-1".

  2. 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&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. 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 untuk mengubah alamat IP node ZooKeeper:

Ubah Alamat IP dan mulai ulang ansambel ZooKeeper (khusus untuk konfigurasi ansambel multi-node)

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

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

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

    Baris Mode dalam output harus bertuliskan "leader".

  4. 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
  5. Gunakan perintah echo yang dijelaskan di atas untuk memverifikasi setiap node ZooKeeper.

Memberi tahu node Apigee tentang perubahan konfigurasi

  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 alamat IP baru
    • Ubah parameter conf_zookeeper_zk1.host untuk menyertakan alamat IP baru
  2. 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
  3. 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
  4. 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 (SymasLDAP)

Untuk mengubah alamat IP node SymasLDAP, lakukan hal berikut:

  1. Di 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 jenis node Apigee lainnya

Untuk mengubah alamat IP dari salah satu jenis node ini (Router, Message Processor, Postgres Server (bukan postgresql) dan Qpid Server (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 tentang cara mendapatkan UUID komponen, lihat Mendapatkan UUID.