Apigee sunucularını taşıma

Edge for Private Cloud 4.19.01 sürümü

Bileşenlerin bir makineden diğerine taşınması, bileşen yapılandırma dosyalarınızdaki IP adreslerini senkronize tutmazsanız yapılandırma uyuşmazlığına neden olabilir.

Bu bölümde, yapılandırma uyuşmazlıklarının nasıl teşhis edileceği ve düzeltileceği açıklanmaktadır.

IP adresleri ve ana makine adları

Bileşen yapılandırma dosyalarınızda ana makine adları yerine IP adreslerini kullanmanız gerekir.

Bazı bileşen yapılandırma dosyaları IP adresleri yerine ana makine adlarını kullanmanıza izin verir ancak ana makine adlarının kullanılması sorun gidermeyi karmaşık hale getirebilir. Örneğin, ana makine adları DNS sunucusu bağlantısı, arama hataları ve senkronizasyonla ilgili sorunların kaynağı olabilir.

Sonuç olarak Apigee, tüm bileşen yapılandırmaları için IP adreslerinin kullanılmasını önemle tavsiye eder. Cassandra'da olduğu gibi bazı durumlarda IP adreslerini kullanmanız gerekir ancak ana makine adlarını kullanamazsınız. Belgelerdeki çoğu örnekte, bileşen yapılandırması için IP adresleri kullanılır.

Ana makine adları ve IP adresleri için Apigee sunucularını taşırken aşağıdaki senaryoların sonuçlarını göz önünde bulundurun:

Senaryo Taşıma sunucuları üzerindeki etki
IP adresi değişikliği Orijinal IP adresine referans veren tüm ilgili dosyaları güncelleyin.
IP adresinde değişiklik olmadan ana makine adı değişikliği Etkili olmadı
IP adresinde değişiklik ile ana makine adı değişikliği IP adresindeki bir değişiklikle aynı

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 [-u username -pw password] -h localhost ring

    Kullanıcı adınızı ve şifrenizi yalnızca Cassandra için JMX kimlik doğrulamasını etkinleştirdiyseniz iletmeniz gerekir.

  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 [-u username -pw password] -h localhost repair -pr
  8. Gerekirse ZooKeeper'ı onarın (aşağıya bakın) ve ardından Yönetim Sunucusu'ndan başlayarak her Apigee platform bileşenini 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.

Bir bileşenin UUID'sini alma hakkında bilgi için UUID'ler alma bölümüne bakın.