Memindahkan Server Apigee

Edge untuk Private Cloud v. 4.17.05

Komponen Apigee menggunakan alamat IP untuk berkomunikasi satu sama lain. Memindahkan komponen dari satu komputer ke mesin lainnya dapat menyebabkan ketidakcocokan konfigurasi. Untuk memperbaiki ketidakcocokan konfigurasi, ikuti petunjuk yang relevan di bawah ini.

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 pada sistem yang diubah. Jika file tidak ada, buat file tersebut.
  2. Ubah parameter berikut:
    • Setel 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 memantau 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 ditetapkan 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" ke setelan default yang sama seperti di langkah sebelumnya.
  5. Mulai ulang Cassandra:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra mulai ulang
  6. Jika perlu, perbaiki juga ZooKeeper (lihat di bawah), atau mulai ulang setiap komponen platform Apigee yang dimulai dengan Server Pengelolaan.

Untuk konfigurasi dengan beberapa node Cassandra (cincin)

  1. Jika node yang diubah adalah node seed, edit file /opt/apigee/customer/application/cassandra.properties pada setiap sistem dalam ring, dan ubah parameter conf_cassandra_seeds untuk menyertakan IP baru dari sistem yang dimodifikasi. Jika file cassandra.properties tidak ada, buatlah 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.
    • Setel conf_cassandra_rpc_address agar menggunakan alamat IP baru atau 0.0.0.0 (agar Cassandra Thrift dapat memantau 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 format:
    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
    default=dc
  4. Edit /opt/apigee/customer/application/cassandra.properties untuk mengubah alamat IP lama yang ditentukan ke alamat IP baru:
    /opt/apigee/customer/application/cassandra.properties

  5. Mulai ulang Cassandra pada sistem yang dimodifikasi. Jika sistem yang dimodifikasi adalah node seed, mulai ulang juga setiap sistem yang menggunakan node seed yang dimodifikasi.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra mulai ulang
  6. Jalankan perintah nodetool ring pada node yang diubah untuk memastikan bahwa ring tersebut sudah lengkap. Utilitas ini dapat ditemukan di opt/apigee/apigee-cassandra/bin.
    > dering nodetool -h localhost
  7. Jalankan perbaikan nodetool pada node yang diubah. Perhatikan bahwa proses ini mungkin memerlukan waktu beberapa saat, jadi sebaiknya jangan lakukan selama jam traffic API puncak.
    > perbaikan nodetool -h localhost
  8. Jika perlu, perbaiki ZooKeeper (lihat di bawah), lalu mulai ulang setiap komponen platform Apigee yang dimulai dengan Server Pengelolaan

Mengupdate pendaftaran datastore

  1. Temukan UUID pendaftaran datastore yang menentukan alamat IP lama menggunakan perintah di bawah. Perhatikan 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 satu pusat data, nilainya 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.

    Catatan: Parameter REGION di bawah merujuk pada pusat data tempat cluster berada. Misalnya, untuk ketersediaan tinggi, Anda biasanya akan memiliki cluster di dc-1 (Dater Center 1) dan cluster di dc-2 (Pusat Data 2). Parameter ini ditetapkan saat 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}&region=${REGION}&pod=central" -H 'content-type: application/x-www-form-url 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=https
    • 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-url POSTencoding
  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 ini untuk mengubah alamat IP node ZooKeeper:

Mengubah Alamat IP dan memulai ulang ansambel ZooKeeper (hanya untuk konfigurasi ansambel multi-node)

  1. Buka /opt/apigee/apigee-zookeeper/conf/zoo.cfg di editor. Anda akan melihat semua alamat IP dan setelan default ZooKeeper dalam formulir:
    server.1=192.168.56.101:2888:3888
    server.2=192.168.56.102:2888:3888
    server.3=192.168.56.10


  2. Pada 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:3888nserver.2=192.168.56.102:2888:3888nserver.3=192.168.56.104:2888:3888n
  3. Temukan pemimpin ansambel ZooKeeper menggunakan perintah berikut (ganti <node> dengan alamat IP mesin Zookeeper):
    echo srvr | nc <node> 2181

    Baris Mode di output harus bertuliskan "leader".
  4. Mulai ulang satu ZooKeeper demi satu, dimulai dengan pemimpin dan diakhiri dengan node dengan alamat IP yang telah diubah. Jika lebih dari satu node penjaga kebun binatang mengubah alamat IP, semua node mungkin perlu dimulai ulang.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper mulai ulang
  5. Gunakan perintah echo yang dijelaskan di atas untuk memverifikasi setiap node ZooKeeper.

Beri tahu node Apigee terkait konfigurasi yang diubah

  1. 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
  2. Pada 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. Pada node Management Server, 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 (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. Pada 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 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 yang baru:
    curl -u $ADMINEMAIL:$PW -X PUT http://$MSIP:8080/v1/servers/<uuid> -d ExternalIP=<ip>
    curl -u $ADMINEMAIL:$PW -X PUTs1 http://$MSIP:8080/v1/servers/<uuid> -d ExternalIP=<ip>
    curl -u $ADMINEMAIL:$PW -X PUTs

Jika tidak mengetahui UUID node, Anda dapat menggunakan perintah berikut untuk menampilkannya:

  • Router: curl http://<router_IP>:8081/v1/servers/self
  • Pemroses Pesan: 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