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 adresinde değişiklik 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:

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

  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'ı onarın (aşağıya bakın). Aksi takdirde tüm Apigee platformlarını yeniden başlatın bileşenine geçelim.

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

  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ı yoksa dosyayı oluşturun.
  2. Değiştirilen sistemde /opt/apigee/customer/application/cassandra.properties dosyasını düzenleyin 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

    Her IP adresinin ardından "\n" eklediğinizden ve yukarıdaki 3. adımda kaydettiğiniz varsayılan ayarlarla aynı ayarları kullandığınızdan emin olun.

  5. Değiştirilmiş sistemde Cassandra'yı yeniden başlatın. Değiştirilen sistem bir çekirdek düğümse kullanan her sistemi yeniden başlatmamız gerekir.
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. Halkanın şurada olduğundan emin olmak için değiştirilen düğümde nodetool ring komutunu çalıştırın: belirir. Bu yardımcı programı şu adreste bulabilirsiniz: /opt/apigee/apigee-cassandra/bin
    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ştirdiğinizden emin olun.

  7. nodetool repair komutunu şu cihazda çalıştırın: düğüm. Bu işlem biraz zaman alabileceği için önemle tavsiye edilir. bu işlem API trafiğinin yoğun olduğu saatlerde yapılmamalıdır.
    nodetool [-u username -pw password] -h localhost repair -pr
  8. Gerekirse ZooKeeper'ı onarın (aşağıya bakın) ve ardından tüm Apigee platform bileşenlerini yeniden başlatın. birini ele alalım.

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'lerin 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. Tüm ZooKeeper IP adreslerini ve varsayılan ayarlarını şu biçimde görürsünüz:
    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 ZooKeeper düğümünü doğrulamak için yukarıda açıklanan echo komutunu kullanın.

Apigee düğümlerini değiştirilen yapılandırma hakkında bilgilendirme

  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.