Apigee sunucularını taşıma

Edge for Private Cloud 4.18.05 sürümü

Apigee bileşenleri birbirleriyle iletişim kurmak için IP adreslerini kullanır. Bileşenlerin bir makineden diğerine taşınması yapılandırma uyuşmazlığına neden olabilir. Yapılandırma uyuşmazlıklarını düzeltmek için aşağıdaki ilgili talimatları uygulayın.

Cassandra Düğümü'nün IP Adresini Değiştirme

Bir Cassandra düğümünün IP adresini değiştirmek için aşağıdaki adımları uygulayın:

Tek Cassandra düğümü olan yapılandırmalar için

  1. Değiştirilen sistemde /opt/apigee/customer/application/cassandra.properties öğesini düzenleyin. Dosya yoksa oluşturun.
  2. Aşağıdaki parametreleri değiştirin:
    • Sistemin yeni IP adresini belirtmek için conf_cassandra_seeds ve conf_cassandra_listen_address parametrelerini ayarlayın.
    • conf_cassandra_rpc_address özelliğini, yeni IP adresini veya 0.0.0.0 (Cassandra Thrift'in tüm arayüzlerde dinlemesine olanak tanır) kullanacak şekilde değiştirin.
  3. /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties dosyasını bir düzenleyicide açın. Eski IP adresini ve varsayılan ayarı şu biçimde görürsünüz: 
    192.168.56.101=dc-1:ra-1
default=dc-1:ra-1

    Bu bilgileri kaydedin.

  4. /opt/apigee/customer/application/cassandra.properties alanını düzenleyerek yeni IP adresi olarak belirtilen eski IP adresini değiştirin: 
    conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n

    IP adresinden sonra "\n" eklediğinizden ve yukarıdaki 3. Adım'da gördüğünüz varsayılan ayarları belirttiğinizden emin olun.

  5. Cassandra'yı yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. ZooKeeper'ın onarılması gerekiyorsa (aşağıya bakın) yoksa Management Server'dan başlayarak tüm Apigee platform bileşenlerini yeniden başlatın.

Birden fazla Cassandra düğümü (halka) olan yapılandırmalar için

  1. Değiştirilen düğüm bir çekirdek düğümse halkadaki her sistemde /opt/apigee/customer/application/cassandra.properties dosyasını düzenleyin ve conf_cassandra_seeds parametresini değiştirilen sistemin yeni IP'sini içerecek şekilde değiştirin. cassandra.properties dosyası yoksa bu dosyayı oluşturun.
  2. Değiştirilen sistemde /opt/apigee/customer/application/cassandra.properties öğesini düzenleyin ve şu parametreleri değiştirin:
    • Yeni IP adresini kullanmak için conf_cassandra_listen_address adresini ayarlayın.
    • conf_cassandra_rpc_address hizmetini yeni IP adresini veya "0.0.0.0"ı (Cassandra Thrift'in tüm arayüzlerde dinlemesini sağlar) kullanacak şekilde ayarlayın.
  3. /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties dosyasını bir düzenleyicide açın. Tüm Cassandra IP adreslerini ve varsayılan ayarı şu biçimde görürsünüz: 
    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

    Bu bilgileri kaydedin.

  4. /opt/apigee/customer/application/cassandra.properties alanını düzenleyerek yeni IP adresi olarak belirtilen eski IP adresini değiştirin: 
    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

    Her IP adresinden sonra "\n" eklediğinizden ve yukarıdaki 3. Adım'da kaydettiğiniz varsayılan ayarları kullandığınızdan emin olun.

  5. Değiştirilen sistemde Cassandra'yı yeniden başlatın. Değiştirilen sistem bir çekirdek düğümse, değiştirilmiş çekirdek düğümü kullanan her sistemi de yeniden başlatın. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Halkanın tamamlandığından emin olmak için değiştirilen düğümde nodetool ring komutunu çalıştırın. Yardımcı programı /opt/apigee/apigee-cassandra/bin adresinde bulabilirsiniz. 
    nodetool -h localhost ring
  7. Değiştirilen düğümde nodetool repair komutunu çalıştırın. Bu işlemin biraz zaman alabileceğini unutmayın. Bu nedenle, API trafiğinin yoğun olduğu saatlerde bu işlemin yapılmaması önemle tavsiye edilir. 
    nodetool -h localhost repair
  8. Gerekirse ZooKeeper'ı onarın (aşağıya bakın) ve ardından Management Server'dan başlayarak tüm Apigee platform bileşenlerini yeniden başlatın.

Veri deposu kayıtlarını güncelle

  1. Aşağıdaki komutları kullanarak eski IP adresini belirten veri deposu kayıtlarının UUID'lerini bulun. "type" ve "UUID" parametrelerini not edin: 
    • 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]'

      Burada DC, veri merkezi adıdır. Tek bir veri merkezi kurulumunda değer genellikle "dc-1"dir.

  2. Aşağıdaki komutlardan birini kullanarak yeni IP adreslerini kaydedin. Gereken komut, değiştirilen düğümün türüne bağlıdır.
    • type="application-datastore" için: 
      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
    • type="kms-datastore" için: 
      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
    • type="reportcrud-datastore" için: 
      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. IP adresinin değiştirildiği sistemin UUID'si için eski kayıtları silin. Bu UUID sorunlarının her biri için: 
    curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers/OLD_UUID" -X DELETE

ZooKeeper düğümünün IP adresini değiştirme

ZooKeeper düğümünün IP adresini değiştirmek için aşağıdaki adımları uygulayın:

IP Adresini değiştirin ve ZooKeeper topluluğunu yeniden başlatın (yalnızca çok düğümlü topluluk yapılandırmaları için)

  1. /opt/apigee/apigee-zookeeper/conf/zoo.cfg dosyasını bir düzenleyicide aç. Tüm ZooKeeper IP adreslerini ve varsayılan ayarı şu biçimde görmeniz gerekir: 
    server.1=192.168.56.101:2888:3888
server.2=192.168.56.102:2888:3888
server.3=192.168.56.103:2888:3888

    Bu bilgileri kaydedin.

  2. Her ZooKeeper düğümünde /opt/apigee/customer/application/zookeeper.properties dosyasını düzenleyerek conf_zoo_quorum özelliğini doğru IP adreslerine ayarlayın. Dosya yoksa oluşturun. 
    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

    Her IP adresinden sonra "\n" eklediğinizden ve girişlerin her düğümde aynı sırada olduğundan emin olun.

  3. Aşağıdaki komutu kullanarak ZooKeeper topluluğunun liderini bulun (node öğesinin yerine Zookeeper makinesinin IP adresini yazın): 
    echo srvr | nc node 2181

    Çıkıştaki Mod satırında "leader" (lider) yazmalıdır.

  4. Bir ZooKeeper'ı, bir öncüyle başlayıp IP adresinin değiştirildiği düğümle sona erdirerek diğerini yeniden başlatın. Birden fazla hayvan bakıcı düğümü IP adreslerini değiştirdiyse tüm düğümleri yeniden başlatmak gerekebilir. 
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
  5. Tüm ZooKeeper düğümlerini doğrulamak için yukarıda açıklanan echo komutunu kullanın.

Değiştirilen yapılandırmayla ilgili Apigee düğümlerini bilgilendirin

  1. Her bir Yönlendirici düğümünde /opt/apigee/customer/application/router.properties dosyasını aşağıdaki gibi düzenleyin. Dosya yoksa oluşturun.
    • conf_zookeeper_connection.string parametresini yeni IP adresini içerecek şekilde değiştirin
    • conf_zookeeper_zk1.host parametresini yeni IP adresini içerecek şekilde değiştirin
  2. Her Mesaj İşleyici düğümünde /opt/apigee/customer/application/message-processor.properties dosyasını aşağıdaki gibi düzenleyin. Dosya yoksa oluşturun.
    • conf_zookeeper_connection.string parametresini yeni IP adresini içerecek şekilde değiştirin
    • conf_zookeeper_zk1.host parametresini yeni IP adresini içerecek şekilde değiştirin
  3. Yönetim Sunucusu düğümünde /opt/apigee/customer/application/management-server.properties dosyasını aşağıdaki gibi düzenleyin. Dosya yoksa oluşturun.
    • conf_zookeeper_connection.string parametresini yeni IP adresini içerecek şekilde değiştirin
    • conf_zookeeper_zk1.host parametresini yeni IP adresini içerecek şekilde değiştirin
  4. Her düğümde aşağıdaki komutu çalıştırarak tüm Apigee platform bileşenlerini yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-all restart

LDAP sunucusunun IP adresini değiştirme (OpenLDAP)

Bir OpenLDAP düğümünün IP adresini değiştirmek için aşağıdakileri yapın:

  1. Yönetim Sunucusu düğümünde /opt/apigee/customer/application/management-server.properties dosyasını düzenleyin. Dosya yoksa oluşturun.
  2. management-server.properties dosyasında, conf_security_ldap.server.host parametresini yeni IP adresine ayarlayın.
  3. Yönetim Sunucusu'nu yeniden başlatın: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Diğer Apigee düğüm türlerinin IP adresini değiştirme

Bu düğüm türlerinden (Yönlendirici, İleti İşleyici, Postgres Sunucusu (postgresql değil) ve Qpid Sunucusu (qpidd değil)) herhangi birinin IP adresini değiştirmek için:

  1. Yeni dahili ve harici IP adresini kaydetmek için aşağıdaki curl komutunu kullanın: 
    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

    Burada uuid, düğümün UUID'sidir.

Düğümün UUID'sini bilmiyorsanız görüntülemek için aşağıdaki komutu kullanabilirsiniz:

  • Yönlendirici: 
    curl http://router_IP:8081/v1/servers/self
  • İleti İşleyici: 
    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