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
- Değiştirilen sistemde
/opt/apigee/customer/application/cassandra.properties
öğesini düzenleyin. Dosya yoksa oluşturun. - Aşağıdaki parametreleri değiştirin:
- Sistemin yeni IP adresini belirtmek için
conf_cassandra_seeds
veconf_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.
- Sistemin yeni IP adresini belirtmek için
/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.
/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.
- Cassandra'yı yeniden başlatın:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- 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
- Değiştirilen düğüm bir çekirdek düğümse halkadaki her sistemde
/opt/apigee/customer/application/cassandra.properties
dosyasını düzenleyin veconf_cassandra_seeds
parametresini değiştirilen sistemin yeni IP'sini içerecek şekilde değiştirin. cassandra.properties dosyası yoksa bu dosyayı oluşturun. - 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.
- Yeni IP adresini kullanmak için
/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.
/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.
- 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
- 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.
- 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
- 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
- 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®ion=DC" | egrep -i '[type|internalip|uuid|region]'
-
curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=gateway®ion=DC" | egrep -i '[type|internalip|uuid|region]'
-
curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=analytics®ion=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.
-
- 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®ion=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®ion=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®ion=REGION&pod=analytics" \ -H 'content-type: application/x-www-form-urlencoded' -X POST
- type="application-datastore" için:
- 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)
/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.
- Her ZooKeeper düğümünde
/opt/apigee/customer/application/zookeeper.properties
dosyasını düzenleyerekconf_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.
- 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.
- 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
- 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
- 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ştirinconf_zookeeper_zk1.host
parametresini yeni IP adresini içerecek şekilde değiştirin
- 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ştirinconf_zookeeper_zk1.host
parametresini yeni IP adresini içerecek şekilde değiştirin
- 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ştirinconf_zookeeper_zk1.host
parametresini yeni IP adresini içerecek şekilde değiştirin
- 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:
- Yönetim Sunucusu düğümünde
/opt/apigee/customer/application/management-server.properties
dosyasını düzenleyin. Dosya yoksa oluşturun. management-server.properties
dosyasında,conf_security_ldap.server.host
parametresini yeni IP adresine ayarlayın.- 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:
- 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.