Apigee-Server verschieben

Edge for Private Cloud Version 4.17.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

  1. Bearbeiten Sie /opt/apigee/customer/application/cassandra.properties auf dem System, das geändert werden soll. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
  2. Ä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 (damit Cassandra Thrift auf allen Schnittstellen überwachen kann).
  3. Öffnen Sie /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties in einem Editor. Die alte IP-Adresse und Standardeinstellung sollten im folgenden Format angezeigt werden:
    192.168.56.101=dc-1:ra-1
    default=dc-1:ra-1


    Speichern Sie diese Informationen.
  4. 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

  5. Starten Sie Cassandra neu:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra neu starten
  6. 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)

  1. Wenn der zu ändernde Knoten ein Startknoten 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.
  2. Bearbeiten Sie /opt/apigee/customer/application/cassandra.properties auf 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 entweder die neue IP-Adresse oder 0.0.0.0 fest (damit Cassandra Thrift auf allen Schnittstellen überwachen kann).
  3. Ö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
    ra default=dc-1

  4. Bearbeiten Sie /opt/apigee/customer/application/cassandra.properties, um die alte IP-Adresse, die in der neuen IP-Adresse angegeben wurde, in die neue IP-Adresse zu ändern:
    /opt/apigee/customer/application/cassandra.properties

  5. 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 neu gestartet
  6. 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 -h localhost-ring
  7. Führen Sie auf dem geänderten Knoten nodetool Reparatur 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
  8. Reparieren Sie bei Bedarf ZooKeeper (siehe unten) und starten Sie dann jede Apigee-Plattformkomponente neu, beginnend mit Management Server

Datenspeicherregistrierungen aktualisieren

  1. 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&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 der Installation eines einzelnen Rechenzentrums ist der Wert in der Regel dc-1.
  2. 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 folgende Parameter REGION bezieht sich auf das Rechenzentrum, in dem sich der Cluster befindet. Für Hochverfügbarkeit würden Sie in der Regel einen Cluster in dc-1 (Dater Center 1) und einen Cluster in dc-2 (Rechenzentrum 2) haben. 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-url-codiert'
    • 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=${NEW-content}" www.google.com
    • 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-url-encoded' -d
  3. 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)

  1. Ö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.58.3=192.168.58.10

    Speichern Sie diese Informationen.
  2. Bearbeiten Sie auf jedem ZooKeeper-Knoten die Datei /opt/apigee/customer/application/zookeeper.properties, um die Eigenschaft 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:3888nserver.2=192.168.56.102:2888:3888nserver.3=192.168.56.104:2888:3888n
  3. Suchen Sie mit dem folgenden Befehl nach dem Leader des ZooKeeper-Ensembles. Ersetzen Sie dabei <node> durch die IP-Adresse des Zookeeper-Computers:
    echo srvr | nc <node> 2181

    Die Mode-Zeile in der Ausgabe sollte „leader“ lauten.
  4. 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-Neustart
  5. Prüfen Sie mit dem oben beschriebenen Befehl echo jeden ZooKeeper-Knoten.

Apigee-Knoten über die geänderte Konfiguration informieren

  1. Bearbeiten Sie auf jedem Routerknoten die Datei /opt/apigee/customer/application/router.properties wie folgt. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
    • Ändern Sie den Parameter conf_zookeeper_connection.string, sodass er die neue IP-Adresse enthält.
    • Ändern Sie den Parameter conf_zookeeper_zk1.host so, dass er die neue IP-Adresse enthält.
  2. Bearbeiten Sie auf jedem Message Processor-Knoten die Datei /opt/apigee/customer/application/message-processor.properties wie folgt. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
    • Ändern Sie den Parameter conf_zookeeper_connection.string, sodass er die neue IP-Adresse enthält.
    • Ändern Sie den Parameter conf_zookeeper_zk1.host, sodass er die neue IP-Adresse enthält.
  3. Bearbeiten Sie auf dem Verwaltungsserver-Knoten die Datei /opt/apigee/customer/application/management-server.properties wie folgt. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
    • Ändern Sie den Parameter conf_zookeeper_connection.string, sodass er die neue IP-Adresse enthält.
    • Ändern Sie den Parameter conf_zookeeper_zk1.host, sodass er die neue IP-Adresse enthält.
  4. Starten Sie alle Apigee-Plattformkomponenten neu. Führen Sie dazu auf jedem Knoten den folgenden Befehl aus:
    /opt/apigee/apigee-service/bin/apigee-all Neustart

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

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

  1. Bearbeiten Sie auf dem Verwaltungsserver-Knoten die Datei /opt/apigee/customer/application/management-server.properties. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
  2. Legen Sie in der Datei management-server.properties den Parameter conf_security_ldap.server.host auf die neue IP-Adresse fest.
  3. Starten Sie den Verwaltungsserver neu:
    > /opt/apigee/apigee-service/bin/apigee-service-Edge-management-server-Neustart

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):

  1. 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

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