Edge for Private Cloud 4.17.01 sürümü
Apigee bileşenleri, birbirleriyle iletişim kurmak için IP adreslerini kullanır. Bileşenleri bir makineden diğerine taşımak 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 bir Cassandra düğümü içeren yapılandırmalar için
- Değiştirilen sistemde /opt/apigee/customer/application/cassandra.properties dosyasını düzenleyin. Dosya yoksa oluşturun.
- 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 değerini yeni IP adresini veya 0.0.0.0'ı (Cassandra Thrift'in tüm arayüzleri dinlemesine olanak tanır) kullanacak şekilde değiştirin.
- /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örmeniz gerekir:
192.168.56.101=dc-1:ra-1
default=dc-1:ra-1
Bu bilgileri kaydedin. - Belirtilen eski IP adresini yeni IP adresiyle değiştirmek için /opt/apigee/customer/application/cassandra.properties dosyasını düzenleyin:
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ımda bulduğunuz varsayılan ayarları belirttiğinizden emin olun. - Cassandra'yı yeniden başlatın:
> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart - Gerekirse ZooKeeper'ı da onarın (aşağıya bakın). Aksi takdirde, Yönetim Sunucusu'ndan başlayarak her Apigee platform bileşenini yeniden başlatın.
Birden fazla Cassandra düğümü (halka) içeren yapılandırmalar için
- Değiştirilen düğüm bir seed düğümüyse 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 oluşturun.
- 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 değerini yeni IP adresini kullanacak şekilde ayarlayın.
- conf_cassandra_rpc_address'i yeni IP adresini veya 0.0.0.0'ı (Cassandra Thrift'in tüm arayüzleri dinlemesine olanak tanır) kullanacak şekilde ayarlayın.
- /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örmeniz gerekir:
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. - Belirtilen eski IP adresini yeni IP adresiyle değiştirmek için /opt/apigee/customer/application/cassandra.properties dosyasını düzenleyin:
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ıda 3. adımda 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 tohum düğümse değiştirilen tohum 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 -h localhost ring - Değiştirilen düğümde nodetool repair komutunu çalıştırın. Bu işlemin biraz zaman alabileceğini unutmayın. Bu nedenle, işlemin API trafiğinin yoğun olduğu saatlerde yapılmaması önemle tavsiye edilir.
> nodetool -h localhost repair - Gerekirse ZooKeeper'ı onarın (aşağıya bakın), ardından Yönetim Sunucusu'ndan başlayarak her Apigee platform bileşenini yeniden başlatın.
Veri deposu kayıtlarını güncelleme
- 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 merkezinin adıdır. Tek bir veri merkezi kurulumunda değer genellikle "dc-1" olur.
- 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.
Not: Aşağıdaki REGION parametresi, kümenin bulunduğu veri merkezini ifade eder. Örneğin, yüksek kullanılabilirlik için genellikle dc-1'de (Veri Merkezi 1) bir kümeniz ve dc-2'de (Veri Merkezi 2) bir kümeniz olur. Bu parametre, yükleme sırasında tanımlanır. Varsayılan değer dc-1'dir.- 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'lerin her biri için şu komutu çalıştırın:
curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers/${OLD_UUID}" -X DELETE
ZooKeeper düğümünün IP adresini değiştirme
Bir ZooKeeper düğümünün IP adresini değiştirmek için aşağıdaki adımları uygulayın:
IP adresini değiştirme ve ZooKeeper topluluğunu yeniden başlatma (yalnızca çok düğümlü topluluk yapılandırmaları için)
- /opt/apigee/apigee-zookeeper/conf/zoo.cfg dosyasını bir düzenleyicide açın. 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üzenleyerek conf_zoo_quorum mülkünü 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> ifadesini Zookeeper makinesinin IP adresiyle değiştirin):
echo srvr | nc <node> 2181
Çıkıştaki Mode satırında "leader" yazmalıdır. - Liderden başlayıp IP adresinin değiştirildiği düğümle biten ZooKeeper'ları birbiri ardına yeniden başlatın. Birden fazla ZooKeeper düğümünün IP adresi değiştiyse tüm düğümleri yeniden başlatmanız gerekebilir.
> /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart - Her bir 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
- Her 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.
- 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.
- 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.
- 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 herhangi birinin (Yönlendirici, Mesaj İşlemcisi, Postgres Sunucusu (postgresql değil) ve Qpid Sunucusu (qpidd değil)) 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.
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
- Mesaj İşlemci: 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