Das Verschieben von Komponenten von einem Computer auf einen anderen kann zu einer nicht übereinstimmenden Konfiguration führen, wenn werden die IP-Adressen in den Komponentenkonfigurationsdateien nicht synchronisiert.
In diesem Abschnitt wird beschrieben, wie Sie Konfigurationsabweichungen diagnostizieren und beheben können.
IP-Adressen im Vergleich zu Hostnamen
Sie sollten in Ihren Komponentenkonfigurationsdateien IP-Adressen anstelle von Hostnamen verwenden.
Bei einigen Komponentenkonfigurationsdateien können Sie statt der als IP-Adressen, kann die Verwendung von Hostnamen die Fehlerbehebung erschweren. Zum Beispiel Hostnamen kann die Ursache für Probleme im Zusammenhang mit der DNS-Serververbindung, Lookup-Fehlern Synchronisierung.
Daher empfiehlt Apigee dringend, IP-Adressen für alle Komponenten zu verwenden Konfigurationen. In einigen Fällen, z. B. bei Cassandra, müssen Sie IP-Adressen verwenden. Hostnamen. In den meisten Beispielen in der Dokumentation werden IP-Adressen für die Komponentenkonfiguration verwendet.
Berücksichtigen Sie für Hostnamen und IP-Adressen die Auswirkungen der folgenden Szenarien wenn Sie Apigee-Server verschieben:
Szenario | Auswirkungen auf das Verschieben von Servern |
---|---|
Änderung der IP-Adresse | Alle zugehörigen Dateien aktualisieren, die auf die ursprüngliche IP-Adresse verweisen |
Änderung des Hostnamens ohne Änderung der IP-Adresse | Keine Auswirkungen |
Änderung des Hostnamens bei Änderung der IP-Adresse | Entspricht einer Änderung der IP-Adresse |
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
/opt/apigee/customer/application/cassandra.properties
bearbeiten auf dem System, das geändert wird. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.- Ändern Sie die folgenden Parameter:
<ph type="x-smartling-placeholder">
- </ph>
- Legen Sie
conf_cassandra_seeds
undconf_cassandra_listen_address
fest. um die neue IP-Adresse des Systems anzugeben. - Zu verwendenden
conf_cassandra_rpc_address
ändern entweder die neue IP-Adresse oder 0.0.0.0, wodurch Cassandra Thrift alle Schnittstellen).
- Legen Sie
/opt/apigee/apigee-cassandra/conf/cassandra-topology.properties
öffnen in einem Editor. Die alte IP-Adresse und die Standardeinstellung sollten im folgenden Format angezeigt werden:192.168.56.101=dc-1:ra-1 default=dc-1:ra-1
Speichern Sie diese Informationen.
/opt/apigee/customer/application/cassandra.properties
bearbeiten , 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
Achten Sie darauf, dass Sie „\n“ einfügen hinter der IP-Adresse ein und legen Sie dieselben Standardeinstellungen fest wie die Sie oben in Schritt 3 gefunden haben.
- Starten Sie Cassandra neu:
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- Falls erforderlich, reparieren Sie auch ZooKeeper (siehe IP-Adresse eines ZooKeeper-Knotens ändern). Andernfalls starten Sie alle Apigee-Plattformkomponenten neu, beginnend mit dem Verwaltungsserver.
Für Konfigurationen mit mehreren Cassandra-Knoten (Ring)
- Wenn der zu ändernde Knoten ein Startknoten ist, bearbeiten Sie
/opt/apigee/customer/application/cassandra.properties
in jedem System im Ring und ändern Sie den Parameterconf_cassandra_seeds
so, dass die neue IP-Adresse des geänderten Systems. Wenn die Datei cassandra.properties nicht vorhanden ist, erstellen Sie . /opt/apigee/customer/application/cassandra.properties
bearbeiten auf dem zu ändernden System und ändern Sie die folgenden Parameter: <ph type="x-smartling-placeholder">- </ph>
- Legen Sie für
conf_cassandra_listen_address
fest, dass die neue IP-Adresse verwendet wird. - Legen Sie fest, dass
conf_cassandra_rpc_address
entweder die neue IP-Adresse oder „0.0.0.0“ verwendet Dadurch kann Cassandra Thrift alle Schnittstellen überwachen.
- Legen Sie für
/opt/apigee/apigee-cassandra/conf/cassandra-topology.properties
öffnen in einem Editor. Es sollten alle Cassandra-IP-Adressen und die Standardeinstellungen im Formular: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.
/opt/apigee/customer/application/cassandra.properties
bearbeiten , 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
Achten Sie darauf, dass Sie „\n“ einfügen nach jeder IP-Adresse ein und verwenden Sie dieselben Standardeinstellungen wie wie oben in Schritt 3 beschrieben.
- Starten Sie Cassandra auf dem geänderten System neu.
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
- Wiederholen Sie für alle anderen Knoten die in den Schritten 3 und 4 vorgenommenen Änderungen, um sie über die Position dieses Knotens im Cassandra-Ring zu informieren. Ändern Sie außerdem die IP-Adresse des Startknotens, wie in Schritt 1 beschrieben.
- Starten Sie jeden verbleibenden Cassandra-Knoten einzeln neu.
/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 abgeschlossen ist. Das Dienstprogramm finden Sie unter/opt/apigee/apigee-cassandra/bin
.nodetool [-u username -pw password] -h localhost ring
- Führen Sie
nodetool repair
auf dem geänderten Knoten aus. Beachten Sie, dass dieser Vorgang einige Zeit dauern kann. Daher wird dringend empfohlen, dies nicht während Spitzenzeiten für den API-Traffic durchzuführen.nodetool [-u username -pw password] -h localhost repair -pr
- Reparieren Sie bei Bedarf ZooKeeper (siehe IP-Adresse eines ZooKeeper-Knotens ändern) und starten Sie dann jede Apigee-Plattformkomponente neu, beginnend mit dem Management Server.
Datenspeicher aktualisieren Registrierungen
- Suchen Sie die UUIDs der Datenspeicherregistrierungen, die die alte IP-Adresse angeben, indem Sie den
. Notieren Sie sich den Typ und „UUID“ Parameter:
<ph type="x-smartling-placeholder">
- </ph>
-
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 einer einzelnen Rechenzentrumsinstallation ist typischerweise "dc-1".
-
- Registrieren Sie die neuen IP-Adressen mit einem der folgenden Befehle. Der erforderliche Befehl
hängen 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. Führen Sie für jedes dieser UUIDs-Probleme folgende Schritte aus:
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 (für Ensemble-Konfigurationen mit mehreren Knoten). )
- Öffnen Sie
/opt/apigee/apigee-zookeeper/conf/zoo.cfg
in einem Editor. Sie sollten Folgendes sehen: alle ZooKeeper-IP-Adressen und Standardeinstellungen im Format: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 die Datei
/opt/apigee/customer/application/zookeeper.properties
auf jedem ZooKeeper-Knoten. -Datei, 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, dass Sie „\n“ einfügen nach jeder IP-Adresse einfügen und dass die Einträge auf auf jedem Knoten.
- Suchen Sie den Leader des ZooKeeper-Ensembles mit dem folgenden Befehl (
node durch die IP-Adresse des Zookeeper-Computers):
echo srvr | nc node 2181
Die Mode-Zeile in der Ausgabe sollte „leader“ lauten.
- Starten Sie einen ZooKeeper nach dem anderen neu, beginnend mit dem Leader und mit dem Knoten auf
in dem die IP-Adresse geändert wurde. Wenn mehrere Zookeeper-Knoten IP-Adressen geändert haben,
um alle Knoten neu zu starten.
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
- Überprüfen Sie jeden ZooKeeper-Knoten mit dem oben beschriebenen
echo
-Befehl.
Apigee-Knoten über die geänderte Konfiguration informieren
- Bearbeiten Sie auf jedem Routerknoten die Datei
/opt/apigee/customer/application/router.properties
. wie im Folgenden beschrieben. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.- Ändern Sie den Parameter
conf_zookeeper_connection.string
so, dass die neue IP-Adresse enthalten ist. Adresse - Ändern Sie den Parameter
conf_zookeeper_zk1.host
so, dass die neue IP-Adresse enthalten ist. Adresse
- Ändern Sie den Parameter
- Bearbeiten Sie auf jedem Message Processor-Knoten die Datei
/opt/apigee/customer/application/message-processor.properties
. wie im Folgenden beschrieben. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.- Ändern Sie den Parameter
conf_zookeeper_connection.string
so, dass er das neue IP-Adresse - Ändern Sie den Parameter
conf_zookeeper_zk1.host
so, dass die neue IP-Adresse enthalten ist. Adresse
- Ändern Sie den Parameter
- Bearbeiten Sie auf dem Knoten des Verwaltungsservers die Datei
/opt/apigee/customer/application/management-server.properties
. wie im Folgenden beschrieben. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.- Ändern Sie den Parameter
conf_zookeeper_connection.string
so, dass er das neue IP-Adresse - Ändern Sie den Parameter
conf_zookeeper_zk1.host
so, dass die neue IP-Adresse enthalten ist. Adresse
- Ändern Sie den Parameter
- 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 Knoten des Verwaltungsservers die Datei
/opt/apigee/customer/application/management-server.properties
. -Datei. Wenn die Datei nicht vorhanden ist, erstellen Sie sie. - Legen Sie in der Datei
management-server.properties
conf_security_ldap.server.host
in die neue IP-Adresse. - Starten Sie den Verwaltungsserver neu:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
IP-Adresse eines anderen Apigee-Knotens ändern Typen
Um die IP-Adresse eines dieser Knotentypen (Router, Message Processor, Postgres) zu ändern 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.
Weitere Informationen zum Abrufen der UUID einer Komponente finden Sie unter UUIDs abrufen.