Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Apigee-Server verschieben

Edge for Private Cloud v. 4.17.01

Apigee-Komponenten verwenden IP-Adressen, um miteinander zu kommunizieren. Das Verschieben von Komponenten von einer Maschine auf eine andere kann zu einer Konfigurationsabweichung führen. Folgen Sie der Anleitung unten, um Konfigurationsabweichungen 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 zu ändernden System. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
Ändern Sie die folgenden Parameter:
- Legen Sie die Parameter conf_cassandra_seeds und conf_cassandra_listen_address fest, um die neue IP-Adresse des Systems anzugeben.
- Ändern Sie conf_cassandra_rpc_address, um entweder die neue IP-Adresse oder 0.0.0.0 zu verwenden (wodurch Cassandra Thrift auf allen Schnittstellen überwacht werden kann).
Ö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 angegebene 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 geben Sie die gleichen Standardeinstellungen wie oben in Schritt 3 an.
Starten Sie Cassandra neu:
> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
Reparieren Sie bei Bedarf auch ZooKeeper (siehe unten). Starten Sie andernfalls alle Apigee-Plattformkomponenten neu, beginnend mit dem Management Server.

Für Konfigurationen mit mehreren Cassandra-Knoten (Ring)

Wenn der geänderte Knoten ein Seed-Knoten ist, bearbeiten Sie die Datei /opt/apigee/customer/application/cassandra.properties auf jedem System im Ring und ändern Sie den Parameter conf_cassandra_seeds 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 auf dem zu ändernden System und ändern Sie die folgenden Parameter:
- Legen Sie für „conf_cassandra_listen_address“ die neue IP-Adresse fest.
- Legen Sie für „conf_cassandra_rpc_address“ entweder die neue IP-Adresse oder 0.0.0.0 fest (wodurch Cassandra Thrift auf allen Schnittstellen auf Ereignisse warten kann).
Öffnen Sie /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties in einem Editor. Sie sollten alle Cassandra-IP-Adressen und die Standardeinstellung 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 angegebene 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

Achten Sie darauf, dass Sie nach jeder IP-Adresse „\n“ einfügen und die gleichen Standardeinstellungen wie oben in Schritt 3 verwenden.
Starten Sie Cassandra auf dem geänderten System neu. Wenn das geänderte System ein Seed-Knoten ist, starten Sie auch jedes System neu, das den geänderten Seed-Knoten 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 sicherzustellen, dass der Ring vollständig 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. Dieser Vorgang kann einige Zeit dauern. Es wird daher dringend empfohlen, ihn nicht während der Spitzenzeiten des API-Traffics auszuführen.
> nodetool -h localhost repair
Reparieren Sie ZooKeeper bei Bedarf (siehe unten) und starten Sie dann alle Apigee-Plattformkomponenten neu, beginnend mit dem Management Server.

Datenspeicherregistrierungen aktualisieren

Suchen Sie mit den folgenden Befehlen nach den UUIDs von Datenspeicherregistrierungen, die die alte IP-Adresse angeben. Notieren Sie sich die Parameter „type“ und „UUID“:
- 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)'
  
  Dabei ist DC der Name des Rechenzentrums. In einer Installation mit einem einzelnen Rechenzentrum lautet der Wert normalerweise „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.

Hinweis: Der Parameter REGION unten bezieht sich auf das Rechenzentrum, in dem sich der Cluster befindet. Für Hochverfügbarkeit haben Sie beispielsweise in der Regel einen Cluster in dc-1 (Rechenzentrum 1) und einen Cluster in dc-2 (Rechenzentrum 2). Dieser Parameter wird bei der Installation definiert. Der Standardwert ist dc-1.
- Für type="application-datastore":
  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
- 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}&region=${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}&region=${REGION}&pod=analytics" -H 'content-type: application/x-www-form-urlencoded' -X POST
Löschen Sie alte Registrierungen für die UUID des Systems, auf dem die IP-Adresse geändert wurde. Geben Sie für jede dieser UUIDs Folgendes ein:
curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers/${OLD_UUID}" -X DELETE

IP-Adresse eines ZooKeeper-Knotens ändern

So ändern Sie die IP-Adresse eines ZooKeeper-Knotens:

IP-Adresse ändern und ZooKeeper-Ensemble neu starten (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 die Standardeinstellung 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 Attribut conf_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, dass Sie nach jeder IP-Adresse „\n“ einfügen und dass die Einträge auf jedem Knoten in derselben Reihenfolge sind.
Suchen Sie den Leader des ZooKeeper-Ensembles mit dem folgenden Befehl (ersetzen Sie <node> durch die IP-Adresse des ZooKeeper-Computers):
echo srvr | nc <node> 2181

In der Zeile „Mode“ in der Ausgabe sollte „leader“ stehen.
Starten Sie einen ZooKeeper nach dem anderen neu. Beginnen Sie mit dem Leader und enden Sie mit dem Knoten, auf dem die IP-Adresse geändert wurde. Wenn mehr als ein ZooKeeper-Knoten die IP-Adresse 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 Stringparameter conf_zookeeper_connection so, dass er die neue IP-Adresse enthält.
- Ändern Sie den Parameter conf_zookeeper_zk1.host so, dass er die neue IP-Adresse enthält.
Bearbeiten Sie auf jedem Message Processor-Knoten die Datei /opt/apigee/customer/application/message-processor.properties so: Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
- Ändern Sie den Parameter conf_zookeeper_connection.string so, dass er die neue IP-Adresse enthält.
- Ändern Sie den Parameter conf_zookeeper_zk1.host so, dass er die neue IP-Adresse enthält.
Bearbeiten Sie auf dem Management Server-Knoten die Datei /opt/apigee/customer/application/management-server.properties so: Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
- Ändern Sie den Parameter conf_zookeeper_connection.string so, dass er die neue IP-Adresse enthält.
- Ändern Sie den Parameter conf_zookeeper_zk1.host so, dass er die neue IP-Adresse enthält.
Starten Sie alle Apigee-Plattformkomponenten neu, indem Sie auf jedem Knoten den folgenden Befehl ausführen:
/opt/apigee/apigee-service/bin/apigee-all restart

IP-Adresse eines LDAP-Servers ändern (OpenLDAP)

So ändern Sie die IP-Adresse eines OpenLDAP-Knotens:

Bearbeiten Sie auf dem Management Server-Knoten 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 Parameter conf_security_ldap.server.host auf die neue IP-Adresse fest.
Starten Sie den Management Server 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):

Verwenden Sie den folgenden cURL-Befehl, um die neue interne und externe IP-Adresse zu registrieren:
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
Message Processor: 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