Apigee sunucularını taşıma

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

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ı karşılaştırması

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

Bazı bileşen yapılandırma dosyaları, Google Etiket Yöneticisi yerine daha karmaşık bir hale gelebilir. Örneğin, barındırıcı adları DNS sunucusu bağlantısı, arama hataları ve DNS sunucusu senkronize edilir.

Bu nedenle Apigee, tüm bileşenlerde IP adresi kullanılmasını yapılandırmanın üç yolu vardır. Cassandra'da olduğu gibi bazı durumlarda IP adresleri kullanmanız gerekir ve ana bilgisayar adlarıdır. Belgelerdeki çoğu örnekte bileşen yapılandırması için IP adresleri kullanılır.

Ana makine adları ve IP adresleri için aşağıdaki senaryoların sonuçlarını göz önünde bulundurun şunları yapmanız gerekir:

Senaryo Sunucuları taşımaya etkisi
IP adresi değişikliği Orijinal IP adresine referans veren ilgili tüm dosyaları güncelleyin
IP adresinde değişiklik olmadan ana makine adı değişikliği Etkili olmadı
IP adresi değişikliğiyle ana makine adı değişikliği IP adresindeki değişiklikle aynı

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

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

Örneğin, tek bir Cassandra düğümüne sahip yapılandırmalar

  1. /opt/apigee/customer/application/cassandra.properties öğesini düzenle kontrol edebilirsiniz. Dosya yoksa, oluşturun.
  2. Aşağıdaki parametreleri değiştirin:
    • conf_cassandra_seeds ve conf_cassandra_listen_address ayarlarını yapın parametrelerini kullanabilirsiniz.
    • Kullanılacak conf_cassandra_rpc_address ayarını değiştirin yeni IP adresi veya 0.0.0.0 (Cassandra Thrift'in arayüzleri).
  3. /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties uygulamasını aç kullanabilirsiniz. Eski IP adresi ve varsayılan ayar şu biçimde gösterilir:
    192.168.56.101=dc-1:ra-1
    default=dc-1:ra-1

    Bu bilgileri kaydedin.

  4. /opt/apigee/customer/application/cassandra.properties öğesini düzenle yeni IP adresiyle belirtilen eski IP adresini değiştirmek için:
    conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n

    "\n" eklediğinizden emin olun sonra ve şununla aynı varsayılan ayarları belirtin: (3. Adım'da bulduğunuz)

  5. Cassandra'yı yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Gerekirse ZooKeeper'ı da onarın (ZooKeeper düğümünün IP adresini değiştirme bölümüne bakın). Aksi takdirde, tüm Apigee platformu bileşenlerini Yönetim Sunucusu'ndan başlayarak yeniden başlatın.

Örneğin, birden fazla Cassandra düğümüne sahip yapılandırmalar (ring)

  1. Değiştirilen düğüm bir çekirdek düğümse /opt/apigee/customer/application/cassandra.properties öğesini düzenleyin. dosyasını çağırın ve conf_cassandra_seeds parametresini çemberdeki her sistemde sistemin yeni IP'sini kullanın. Cassandra.properties dosyası mevcut değilse somut olarak ortaya koyar.
  2. /opt/apigee/customer/application/cassandra.properties öğesini düzenle adresine gidin ve aşağıdaki parametreleri değiştirin:
    • conf_cassandra_listen_address öğesini yeni IP adresini kullanacak şekilde ayarlayın.
    • conf_cassandra_rpc_address öğesini, yeni IP adresini veya "0.0.0.0" öğesini kullanacak şekilde ayarlayın (Cassandra Thrift'in tüm arayüzleri dinlemesine olanak tanır).
  3. /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties uygulamasını aç kullanabilirsiniz. Şurada tüm Cassandra IP adreslerini ve varsayılan ayarı göreceksiniz: form:
    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 öğesini düzenle yeni IP adresiyle belirtilen eski IP adresini değiştirmek için:
    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

    "\n" eklediğinizden emin olun bulun ve sizinle aynı varsayılan ayarları kullanın konulu videomuzu izleyin.

  5. Değiştirilmiş sistemde Cassandra'yı yeniden başlatın.
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Diğer tüm düğümler için 3 ve 4. adımlarda yapılan değişiklikleri tekrarlayarak bu düğümün Cassandra halkasındaki konumu hakkında bilgi verin. Ayrıca, 1. adımda açıklanan şekilde başlangıç noktası düğüm IP'sini değiştirin.
  7. Kalan her Cassandra düğümünü tek tek yeniden başlatın.
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  8. Çalma işleminin 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
  9. Değiştirilen düğümde nodetool repair komutunu çalıştırın. Bu işlem biraz zaman alabilir. Bu nedenle, bu işlemin API trafiğinin yoğun olduğu saatlerde yapılmaması önemle tavsiye edilir.
    nodetool [-u username -pw password] -h localhost repair -pr
  10. Gerekirse ZooKeeper'ı onarın (ZooKeeper düğümünün IP adresini değiştirme sayfasına göz atın), ardından Yönetim Sunucusu'ndan başlayarak her Apigee platform bileşenini yeniden başlatın.

Veri deposunu güncelle kayıtlar

  1. Veri deposu kayıtlarının UUID'lerini bulmak için komutlarından birini tıklayın. "Tür"e dikkat edin ve "UUID" parametre:
    • 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 merkezinin adıdır. Tek bir veri merkezi kurulumunda, değer genellikle "dc-1" olur.

  2. Aşağıdaki komutlardan birini kullanarak yeni IP adreslerini kaydedin. Gerekli 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 bulunduğu sistemin UUID'sinin eski kayıtlarını silin değiştirildi. 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 (çok düğümlü topluluk yapılandırmaları için) )

  1. /opt/apigee/apigee-zookeeper/conf/zoo.cfg dosyasını bir düzenleyicide açın. Burada tüm ZooKeeper IP adresleri ve formdaki varsayılan ayar:
    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 bir ZooKeeper düğümünde /opt/apigee/customer/application/zookeeper.properties dosyasını düzenleyin dosyasını kullanarak conf_zoo_quorum özelliğini doğru IP adreslerine ayarlayın. Dosya mevcut değilse 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

    "\n" eklediğinizden emin olun arasında olup olmadığını kontrol edin ve girişlerin her düğümde.

  3. Aşağıdaki komutu kullanarak ZooKeeper topluluğunun liderini bulun ( Zookeeper makinesinin IP adresiyle node):
    echo srvr | nc node 2181

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

  4. Öncüyle başlayıp şurada düğümle biten bir ZooKeeper'ı diğerinden sonra yeniden başlat IP adresinin değiştiği. Birden fazla hayvan bakıcısı düğümü IP adresini değiştirdiyse tüm düğümleri yeniden başlatmak gerekir.
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
  5. Her bir ZooKeeper düğümünü doğrulamak için yukarıda açıklanan echo komutunu kullanın.

Apigee düğümlerine değiştirilen yapılandırma hakkında bilgi verme

  1. Her bir Yönlendirici düğümünde /opt/apigee/customer/application/router.properties dosyasını düzenleyin aşağıdaki gibi ekleyebilirsiniz. Dosya yoksa, oluşturun.
    • conf_zookeeper_connection.string parametresini yeni IP'yi içerecek şekilde değiştirin adres
    • conf_zookeeper_zk1.host parametresini yeni IP'yi içerecek şekilde değiştirin adres
  2. Her İleti İşleyici düğümünde /opt/apigee/customer/application/message-processor.properties dosyasını düzenleyin aşağıdaki gibi ekleyebilirsiniz. Dosya yoksa, oluşturun.
    • conf_zookeeper_connection.string parametresini, yeni IP adresi
    • conf_zookeeper_zk1.host parametresini yeni IP'yi içerecek şekilde değiştirin adres
  3. Yönetim Sunucusu düğümünde /opt/apigee/customer/application/management-server.properties dosyasını düzenleyin aşağıdaki gibi ekleyebilirsiniz. Dosya yoksa, oluşturun.
    • conf_zookeeper_connection.string parametresini, yeni IP adresi
    • conf_zookeeper_zk1.host parametresini yeni IP'yi içerecek şekilde değiştirin adres
  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 dosyası olarak kaydedebilirsiniz. Dosya yoksa, oluşturun.
  2. management-server.properties dosyasında conf_security_ldap.server.host parametresini yeni IP adresine ekleyin.
  3. Yönetim sunucusunu yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

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

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

  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 edinmek için UUID'leri alma konusuna bakın.