Edge for Private Cloud v4.18.05
Apigee-Komponenten verwenden IP-Adressen, um miteinander zu kommunizieren. Das Verschieben von Komponenten von einer Maschine zu einer anderen kann zu einem Konfigurationskonflikt führen. Folgen Sie der entsprechenden Anleitung unten, um Abweichungen bei der Konfiguration zu beheben.
IP-Adresse eines Cassandra-Knotens ändern
Führen Sie die folgenden Schritte aus, um die IP-Adresse eines Cassandra-Knotens zu ändern:
Für Konfigurationen mit einem einzelnen Cassandra-Knoten
- Bearbeiten Sie
/opt/apigee/customer/application/cassandra.properties
auf dem System, das geändert wird. Wenn die Datei nicht vorhanden ist, erstellen Sie sie. - Ändern Sie die folgenden Parameter:
- Legen Sie die Parameter
conf_cassandra_seeds
undconf_cassandra_listen_address
fest, um die neue IP-Adresse des Systems anzugeben. - Ändern Sie
conf_cassandra_rpc_address
so, dass entweder die neue IP-Adresse oder 0.0.0.0 verwendet wird (damit Cassandra Thrift auf allen Schnittstellen überwachen kann).
- Legen Sie die Parameter
- Öffnen Sie
/opt/apigee/apigee-cassandra/conf/cassandra-topology.properties
in einem Editor. Sie sollten die alte IP-Adresse und die Standardeinstellung im folgenden Format sehen:192.168.56.101=dc-1:ra-1 default=dc-1:ra-1
Speichern Sie diese Informationen.
- Bearbeiten Sie
/opt/apigee/customer/application/cassandra.properties
, um die alte IP-Adresse in die neue IP-Adresse zu ändern:conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n
Fügen Sie nach der IP-Adresse „\n“ ein und legen Sie dieselben Standardeinstellungen wie oben in Schritt 3 fest.
- Starten Sie Cassandra neu:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- Reparatur bei Bedarf auch ZooKeeper (siehe unten). Starten Sie andernfalls jede Apigee-Plattformkomponente neu, beginnend mit Management Server.
Für Konfigurationen mit mehreren Cassandra-Knoten (Ring)
- Wenn der zu ändernde Knoten ein Startknoten ist, bearbeiten Sie die
/opt/apigee/customer/application/cassandra.properties
-Datei auf jedem System im Ring und ändern Sie denconf_cassandra_seeds
-Parameter so, dass er die neue IP-Adresse des geänderten Systems enthält. Wenn die Datei cassandra.properties nicht vorhanden ist, erstellen Sie sie. - Bearbeiten Sie
/opt/apigee/customer/application/cassandra.properties
in dem System, das geändert wird, und ändern Sie die folgenden Parameter:- Legen Sie für
conf_cassandra_listen_address
fest, dass die neue IP-Adresse verwendet wird. - Legen Sie für
conf_cassandra_rpc_address
fest, dass entweder die neue IP-Adresse oder „0.0.0.0“ verwendet wird (damit Cassandra Thrift auf allen Schnittstellen überwachen kann).
- Legen Sie für
- Öffnen Sie
/opt/apigee/apigee-cassandra/conf/cassandra-topology.properties
in einem Editor. Sie sollten alle Cassandra-IP-Adressen und Standardeinstellungen im folgenden Format sehen: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
Speichern Sie diese Informationen.
- Bearbeiten Sie
/opt/apigee/customer/application/cassandra.properties
, um die alte IP-Adresse in die neue IP-Adresse zu ändern: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
Fügen Sie nach jeder IP-Adresse „\n“ ein und verwenden Sie dieselben Standardeinstellungen, die Sie oben in Schritt 3 notiert haben.
- Starten Sie Cassandra auf dem geänderten System neu. Wenn das geänderte System ein Startknoten ist, starten Sie auch jedes System neu, das den geänderten Startknoten verwendet hat.
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- Führen Sie den Befehl
nodetool ring
auf dem geänderten Knoten aus, um zu prüfen, ob der Ring abgeschlossen ist. Das Dienstprogramm finden Sie unter/opt/apigee/apigee-cassandra/bin
.nodetool -h localhost ring
- Führen Sie
nodetool repair
auf dem geänderten Knoten aus. Hinweis: Dieser Vorgang kann einige Zeit in Anspruch nehmen. Daher wird dringend empfohlen, dies nicht während der Spitzenzeiten des API-Traffics zu tun.nodetool -h localhost repair
- Reparieren Sie bei Bedarf ZooKeeper (siehe unten) und starten Sie dann alle Apigee-Plattformkomponenten neu, beginnend mit Management Server.
Datenspeicherregistrierungen aktualisieren
- Suchen Sie mit den folgenden Befehlen nach den UUIDs der Datenspeicherregistrierungen, die die alte IP-Adresse angeben. Beachten Sie die Parameter „type“ und „UUID“:
-
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]'
Dabei ist DC der Name des Rechenzentrums. In der Installation eines einzelnen Rechenzentrums ist der Wert in der Regel "dc-1".
-
- Registrieren Sie die neuen IP-Adressen mit einem der folgenden Befehle. Der erforderliche Befehl hängt vom Typ des geänderten Knotens ab.
- Für type="application-datastore":
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
- Für type="kms-datastore":
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
- Für type="reportcrud-datastore":
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
- Für type="application-datastore":
- Löschen Sie alte Registrierungen für die UUID des Systems, auf dem die IP-Adresse geändert wurde. Für jedes dieser UUIDs-Probleme:
curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers/OLD_UUID" -X DELETE
IP-Adresse eines ZooKeeper-Knotens ändern
Führen Sie die folgenden Schritte aus, um die IP-Adresse eines ZooKeeper-Knotens zu ändern:
Ändern Sie die IP-Adresse und starten Sie das ZooKeeper-Ensemble neu (nur für Ensemble-Konfigurationen mit mehreren Knoten)
- Öffnen Sie
/opt/apigee/apigee-zookeeper/conf/zoo.cfg
in einem Editor. Sie sollten alle ZooKeeper-IP-Adressen und Standardeinstellungen im folgenden Format sehen:server.1=192.168.56.101:2888:3888 server.2=192.168.56.102:2888:3888 server.3=192.168.56.103:2888:3888
Speichern Sie diese Informationen.
- Bearbeiten Sie auf jedem ZooKeeper-Knoten die Datei
/opt/apigee/customer/application/zookeeper.properties
, um das Attributconf_zoo_quorum
auf die richtigen IP-Adressen festzulegen. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.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
Achten Sie darauf, nach jeder IP-Adresse „\n“ einzufügen und die Einträge auf jedem Knoten in derselben Reihenfolge zu finden.
- Führen Sie den folgenden Befehl aus (ersetzen Sie node durch die IP-Adresse des ZooKeeper-Computers):
echo srvr | nc node 2181
Die Zeile „Mode“ in der Ausgabe sollte „leader“ lauten.
- Starten Sie einen ZooKeeper nach dem anderen neu, beginnend mit dem Leader und enden mit dem Knoten, auf dem die IP-Adresse geändert wurde. Wenn mehr als ein Zookeeper-Knoten seine IP-Adressen geändert hat, müssen möglicherweise alle Knoten neu gestartet werden.
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
- Verwenden Sie den oben beschriebenen Befehl
echo
, um jeden ZooKeeper-Knoten zu prüfen.
Apigee-Knoten über die geänderte Konfiguration informieren
- Bearbeiten Sie auf jedem Routerknoten die Datei
/opt/apigee/customer/application/router.properties
so. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.- Ändern Sie den
conf_zookeeper_connection.string
-Parameter so, dass er die neue IP-Adresse enthält. - Ändern Sie den
conf_zookeeper_zk1.host
-Parameter so, dass er die neue IP-Adresse enthält.
- Ändern Sie den
- Bearbeiten Sie die Datei
/opt/apigee/customer/application/message-processor.properties
auf jedem Message Processor-Knoten wie folgt. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.- Ändern Sie den
conf_zookeeper_connection.string
-Parameter so, dass er die neue IP-Adresse enthält. - Ändern Sie den
conf_zookeeper_zk1.host
-Parameter so, dass er die neue IP-Adresse enthält.
- Ändern Sie den
- Bearbeiten Sie die Datei
/opt/apigee/customer/application/management-server.properties
im Knoten des Verwaltungsservers so. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.- Ändern Sie den
conf_zookeeper_connection.string
-Parameter so, dass er die neue IP-Adresse enthält. - Ändern Sie den
conf_zookeeper_zk1.host
-Parameter so, dass er die neue IP-Adresse enthält.
- Ändern Sie den
- Starten Sie alle Apigee-Plattformkomponenten neu. Führen Sie dazu auf jedem Knoten den folgenden Befehl aus:
/opt/apigee/apigee-service/bin/apigee-all restart
IP-Adresse eines LDAP-Servers (OpenLDAP) ändern
So ändern Sie die IP-Adresse eines OpenLDAP-Knotens:
- Bearbeiten Sie im Knoten des Verwaltungsservers die Datei
/opt/apigee/customer/application/management-server.properties
. Wenn die Datei nicht vorhanden ist, erstellen Sie sie. - Legen Sie in der Datei
management-server.properties
den Parameterconf_security_ldap.server.host
auf die neue IP-Adresse fest. - Starten Sie den Verwaltungsserver neu:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
IP-Adresse anderer Apigee-Knotentypen ändern
So ändern Sie die IP-Adresse eines dieser Knotentypen (Router, Message Processor, Postgres Server (nicht postgresql) und Qpid Server (nicht qpidd):
- Registrieren Sie mit dem folgenden
curl
-Befehl die neue interne und externe IP-Adresse: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
Dabei ist uuid die UUID des Knotens.
Wenn Sie die UUID des Knotens nicht kennen, können Sie sie mit dem folgenden Befehl anzeigen lassen:
- Router:
curl http://router_IP:8081/v1/servers/self
- Nachrichtenprozessor:
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