Außerbetriebnahme eines Rechenzentrums

Manchmal müssen Sie ein Rechenzentrum außer Betrieb nehmen. Wenn Sie beispielsweise ein Betriebssystem aktualisieren, müssen Sie das neue Betriebssystem in einem neuen Rechenzentrum installieren und dann das alte Rechenzentrum außer Betrieb nehmen. In den folgenden Abschnitten wird ein Beispiel für die Deaktivierung eines Rechenzentrums mit zwei Rechenzentren (dc-1 und dc-2) in einer 12-Knoten-Clusterinstallation beschrieben:

  • dc-1 ist das Rechenzentrum, das außer Betrieb genommen werden soll.
  • dc-2 ist ein zweites Rechenzentrum, das bei der Deaktivierung verwendet wird.

Wenn Sie ein Upgrade Ihres Betriebssystems durchführen, könnte dc-2 das Rechenzentrum sein, in dem Sie die neue Version des Betriebssystems installiert haben. Für die Außerbetriebnahme eines Rechenzentrums ist jedoch keine Installation eines neuen Betriebssystems erforderlich.

Überlegungen vor der Außerbetriebnahme eines Rechenzentrums

Beachten Sie beim Ausmustern eines Rechenzentrums die folgenden Punkte:

  • Blockieren Sie den gesamten Laufzeit- und Verwaltungsverkehr zum stillgelegten Rechenzentrum und leiten Sie ihn an andere Rechenzentren weiter.
  • Nach der Deaktivierung des Rechenzentrums ist die Kapazität Ihres Apigee-Clusters reduziert. Sie können die Kapazität in den verbleibenden Rechenzentren erhöhen oder nach der Deaktivierung weitere Rechenzentren hinzufügen.
  • Während der Deaktivierung kann es je nach installierten Analysekomponenten im deaktivierten Rechenzentrum zu Datenverlusten kommen. Weitere Informationen finden Sie unter Qpid-Knoten hinzufügen oder entfernen.
  • Bevor Sie ein Rechenzentrum außer Betrieb nehmen, sollten Sie wissen, wie alle Komponenten in allen Rechenzentren konfiguriert sind, insbesondere die OpenLDAP-, ZooKeeper-, Cassandra- und Postgres-Server. Sie sollten auch Sicherungen aller Komponenten und ihrer Konfigurationen erstellen.

Vorbereitung

  • Verwaltungsserver: Alle Schritte zur Deaktivierung hängen stark vom Verwaltungsserver ab. Wenn Sie nur einen Verwaltungsserver verfügbar haben, sollten Sie vor der Deaktivierung des Verwaltungsservers in dc-1 eine neue Verwaltungsserverkomponente in einem anderen Rechenzentrum als dc-1 installieren. Achten Sie darauf, dass einer der Verwaltungsserver immer verfügbar ist.
  • Router:Bevor Sie einen Router außer Betrieb nehmen, deaktivieren Sie die Erreichbarkeit von Routern, indem Sie den Port 15999 blockieren. Achten Sie darauf, dass kein Laufzeit-Traffic an die außer Betrieb genommenen Router weitergeleitet wird.
  • Cassandra und ZooKeeper:In den folgenden Abschnitten wird beschrieben, wie Sie dc-1 in einer Zwei-Rechenzentrums-Umgebung außer Betrieb nehmen.

    Wenn Sie mehr als zwei Rechenzentren haben, entfernen Sie alle Verweise auf den außer Betrieb genommenen Knoten (in diesem Fall dc-1) aus allen Silent-Konfigurationsdateien in allen verbleibenden Rechenzentren. Entfernen Sie die Hosts der Cassandra-Knoten, die außer Betrieb genommen werden sollen, aus CASS_HOSTS. Die verbleibenden Cassandra-Knoten sollten in der ursprünglichen Reihenfolge von CASS_HOSTS bleiben.

  • Postgres:Wenn Sie den Postgres-Master außer Betrieb nehmen, müssen Sie einen der verfügbaren Standby-Knoten zum neuen Postgres-Master befördern. Der QPID-Server hält zwar einen Puffer in der Warteschlange, aber wenn der Postgres-Master für längere Zeit nicht verfügbar ist, besteht das Risiko, dass Analysedaten verloren gehen.

Vorbereitung

  • Bevor Sie eine Komponente außer Betrieb nehmen, empfehlen wir Ihnen, eine vollständige Sicherung aller Knoten durchzuführen. Führen Sie die Sicherung mit der Anleitung für Ihre aktuelle Version von Edge durch. Weitere Informationen zur Sicherung finden Sie unter Sicherungen und Wiederherstellung.

  • Prüfen Sie mit dem folgenden Befehl, ob Edge ausgeführt wird, bevor Sie die Deaktivierung vornehmen:
    /opt/apigee/apigee-service/bin/apigee-all status
  • Achten Sie darauf, dass derzeit kein Laufzeit-Traffic im Datacenter ankommt, das Sie außer Betrieb nehmen.

Reihenfolge der Komponentenaußerbetriebnahme

Wenn Sie Edge for Private Cloud auf mehreren Knoten installieren, sollten Sie die Edge-Komponenten auf diesen Knoten in der folgenden Reihenfolge außer Betrieb setzen:

  1. Edge-UI (edge-ui)
  2. Verwaltungsserver (edge-management-server)
  3. OpenLDAP (apigee-openldap)
  4. Router (Edge-Router)
  5. Nachrichtenverarbeiter (edge-message-processor)
  6. Qpid-Server und Qpidd (edge-qpid-server und apigee-qpidd)
  7. Postgres und PostgreSQL-Datenbank (edge-postgres-server und apigee-postgresql)
  8. ZooKeeper (apigee-zookeeper)
  9. Cassandra (apigee-cassandra)

In den folgenden Abschnitten wird beschrieben, wie Sie die einzelnen Komponenten außer Betrieb setzen.

Edge-Benutzeroberfläche

Geben Sie die folgenden Befehle ein, um die Edge-UI-Komponente von dc-1 zu beenden und zu deinstallieren:

/opt/apigee/apigee-service/bin/apigee-service edge-ui stop
/opt/apigee/apigee-service/bin/apigee-service edge-ui uninstall

Verwaltungsserver

So stellen Sie den Verwaltungsserver auf dc-1 außer Betrieb:

  1. Stoppen Sie den Verwaltungsserver auf dc-1:
    apigee-service edge-management-server stop
  2. Ermitteln Sie die UUID des Verwaltungsservers, der in dc-1 registriert ist:
    curl -u <AdminEmailID>:'<AdminPassword>' -X GET “http://{MS_IP}:8080/v1/servers?pod=central&region=dc-1&type=management-server”
  3. Registrieren Sie den Servertyp nicht mehr:
    curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers -d "type=management-server&region=dc-1&pod=central&uuid=UUID&action=remove"
  4. Löschen Sie den Server. Hinweis:Wenn auf diesem Server auch andere Komponenten installiert sind, müssen Sie sie zuerst alle abmelden, bevor Sie die UUID löschen.
    curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/{UUID}
  5. Deinstallieren Sie die Verwaltungsserverkomponente auf dc-1:
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server uninstall

Open LDAP

In diesem Abschnitt wird erläutert, wie Sie OpenLDAP auf dc-1 außer Betrieb setzen.

Hinweis:Wenn Sie mehr als zwei Rechenzentren haben, lesen Sie unten den Abschnitt Einrichtungen mit mehr als zwei Rechenzentren.

So stellen Sie OpenLDAP auf dc-1 außer Betrieb:

  1. Sichern Sie den OpenLDAP-Knoten „dc-1“. Folgen Sie dazu der Anleitung unter Daten sichern.
  2. Unterbrechen Sie die Datenreplikation zwischen den beiden Rechenzentren „dc-1“ und „dc-2“, indem Sie die folgenden Schritte in beiden Rechenzentren ausführen.

    1. Prüfen Sie den aktuellen Status:
      ldapsearch -H ldap://{HOST}:{PORT} -LLL -x -b "cn=config" -D "cn=admin,cn=config" -w {credentials} -o ldif-wrap=no 'olcSyncRepl' | grep olcSyncrepl

      Die Ausgabe sollte in etwa so aussehen:

      olcSyncrepl: {0}rid=001 provider=ldap://{HOST}:{PORT}/ binddn="cn=manager,dc=apigee,dc=com" bindmethod=simple credentials={credentials} searchbase="dc=apigee,dc=com" attrs="*,+" type=refreshAndPersist retry="60 1 300 12 7200 +" timeout=1
    2. Erstellen Sie eine Datei break_repl.ldif mit den folgenden Befehlen:
      dn: olcDatabase={2}bdb,cn=config
      changetype: modify
      delete: olcSyncRepl
      
      dn: olcDatabase={2}bdb,cn=config
      changetype: modify
      delete: olcMirrorMode
    3. Führen Sie den Befehl ldapmodify aus:
      ldapmodify -x -w {credentials} -D "cn=admin,cn=config" -H "ldap://{HOST}:{PORT}/" -f path/to/file/break_repl.ldif

      Die Ausgabe sollte in etwa so aussehen:

      modifying entry "olcDatabase={2}bdb,cn=config"
      modifying entry "olcDatabase={2}bdb,cn=config"
  3. Sie können prüfen, ob dc-2 nicht mehr auf dc-1 repliziert wird, indem Sie einen Eintrag in dc-2 LDAP erstellen und prüfen, ob er nicht im LDAP von dc-1 angezeigt wird.

    Optional können Sie die folgenden Schritte ausführen, um einen lesenden Nutzer im OpenLDAP-Knoten „dc-2“ zu erstellen und dann zu prüfen, ob der Nutzer repliziert wird. Der Nutzer wird anschließend gelöscht.

    1. Erstellen Sie in dc-2 eine Datei readonly-user.ldif mit folgendem Inhalt:
      dn: uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com
      objectClass: organizationalPerson
      objectClass: person
      objectClass: inetOrgPerson
      objectClass: top
      cn: readonly-user
      sn: readonly-user
      userPassword: {testPassword}
    2. Fügen Sie den Nutzer mit dem Befehl „ldapadd“ in dc-2 hinzu:
      ldapadd -H ldap://{HOST}:{PORT} -w {credentials} -D "cn=manager,dc=apigee,dc=com" -f path/to/file/readonly-user.ldif

      Die Ausgabe sollte in etwa so aussehen:

      adding new entry "uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com"
    3. Suchen Sie in dc-1 nach dem Nutzer, um sicherzustellen, dass er nicht repliziert wird. Wenn der Nutzer nicht in dc-1 vorhanden ist, können Sie sicher sein, dass beide LDAPs nicht mehr repliziert werden:
      ldapsearch -H ldap://{HOST}:{PORT} -x -w {credentials} -D "cn=manager,dc=apigee,dc=com" -b uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com -LLL

      Die Ausgabe sollte in etwa so aussehen:

      No such object (32)
      Matched DN: ou=users,ou=global,dc=apigee,dc=com
    4. Entfernen Sie den zuvor hinzugefügten Nutzer mit Lesezugriff:
      ldapdelete -v -H ldap://{HOST}:{PORT} -w {credentials} -D "cn=manager,dc=apigee,dc=com" "uid=readonly-user,ou=users,ou=global,dc=apigee,dc=com"
  4. Beenden Sie OpenLDAP in dc-1:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop
  5. Deinstallieren Sie die OpenLDAP-Komponente auf dc-1:
    /opt/apigee/apigee-service/bin/apigee-service apigee-openldap uninstall

Router

In diesem Abschnitt wird beschrieben, wie Sie einen Router außer Betrieb setzen. Weitere Informationen zum Entfernen des Routers finden Sie unter Server entfernen.

Mit den folgenden Schritten wird der Router von dc-1 außer Betrieb genommen. Wenn in dc-1 mehrere Routerknoten konfiguriert sind, führen Sie die Schritte nacheinander auf allen Routerknoten aus.

Hinweis:Hier wird davon ausgegangen, dass der Port 15999 für die Systemdiagnose des Routers in Ihrem Load Balancer konfiguriert ist und dass der Router nicht erreichbar ist, wenn Port 15999 blockiert wird. Möglicherweise benötigen Sie Root-Zugriff, um den Anschluss zu blockieren.

So stellen Sie einen Router außer Betrieb:

  1. Deaktivieren Sie die Erreichbarkeit von Routern, indem Sie Port 15999, den Port für die Systemdiagnose, blockieren. Achten Sie darauf, dass der Laufzeit-Traffic in diesem Rechenzentrum blockiert ist:

    iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT
  2. Prüfen Sie, ob der Router erreichbar ist:

    curl -vvv -X GET http://{ROUTER_IP}:15999/v1/servers/self/reachable

    Die Ausgabe sollte in etwa so aussehen:

    About to connect() to 10.126.0.160 port 15999 (#0)
    Trying 10.126.0.160...
    Connection refused
    Failed connect to 10.126.0.160:15999; Connection refused
    Closing connection 0
    curl: (7) Failed connect to 10.126.0.160:15999; Connection refused
  3. Rufen Sie die UUID des Routers ab, wie unter UUIDs abrufen beschrieben.
  4. Router beenden:
    /opt/apigee/apigee-service/bin/apigee-service edge-router stop
  5. Mit dem folgenden Befehl können Sie die verfügbaren Gateway-Pods in der Organisation auflisten:
    curl -u  <AdminEmailID>:'<AdminPassword>' -X GET "http://{MS_IP}:8080/v1/organizations/{ORG}/pods"

    Weitere Informationen finden Sie unter Pods.

  6. Registrieren Sie den Servertyp ab:
    curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers -d "type=router&region=dc-1&pod=gateway-1&uuid=UUID&action=remove"
  7. So heben Sie die Registrierung des Servers auf:
    curl -u <AdminEmailID>:'<AdminPassword>’ -X DELETE http://{MS_IP}:8080/v1/servers/UUID
  8. So deinstallieren Sie edge-router:
    /opt/apigee/apigee-service/bin/apigee-service edge-router uninstall
    Weitere Informationen finden Sie unter Server entfernen.
  9. Löschen Sie die iptables-Regeln, um den blockierten Port 15999 zu aktivieren:
    iptables -F

Message Processor

In diesem Abschnitt wird beschrieben, wie Sie den Message Processor von dc-1 außer Betrieb setzen. Weitere Informationen zum Entfernen des Message Processors finden Sie unter Server entfernen.

Da wir davon ausgehen, dass dc-1 eine 12-Knoten-Clusterinstallation hat, sind in dc-1 zwei Message Processor-Knoten konfiguriert. Führen Sie die folgenden Befehle auf beiden Knoten aus.

  1. Rufen Sie die UUIDs der Nachrichtenverarbeiter ab, wie unter UUIDs abrufen beschrieben.
  2. Beenden Sie den Nachrichtenprozessor:
    apigee-service edge-message-processor stop
  3. Registrieren Sie den Servertyp ab:
    curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers -d "type=message-processor&region=dc-1&pod=gateway-1&uuid=UUID&action=remove"
  4. Eine Umgebung vom Message Processor trennen
    curl -H "Content-Type:application/x-www-form-urlencoded" <AdminEmailID>:'<AdminPassword>’  \
    -X POST http://{MS_IP}:8080/v1/organizations/{ORG}/environments/{ENV}/servers \
    -d "action=remove&uuid=UUID"
  5. Registrieren Sie den Servertyp ab:
    curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers -d "type=message-processor&region=dc-1&pod=gateway-1&uuid=UUID&action=remove"
  6. So deinstallieren Sie den Nachrichtenprozessor:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor uninstall
  7. So heben Sie die Registrierung des Servers auf:
    curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID

Qpid-Server und Qpidd

In diesem Abschnitt wird beschrieben, wie Sie den Qpid-Server (edge-qpid-server) und Qpidd (apigee-qpidd) außer Betrieb setzen. In dc-1 sind zwei Qpid-Knoten konfiguriert. Sie müssen die folgenden Schritte für beide Knoten ausführen:

  1. Rufen Sie die UUID für Qpidd ab, wie unter UUIDs abrufen beschrieben.
  2. Beenden Sie edge-qpid-server und apigee-qpidd:
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop
  3. So rufen Sie eine Liste der Analytics- und Zielgruppen ab:
    curl -u <AdminEmailID>:'<AdminPassword>' -X GET http://{MS_IP}:8080/v1/analytics/groups/ax
  4. Entfernen Sie Qpid aus der Zielgruppe:
    curl -u <AdminEmailID>:'<AdminPassword>' -H "Content-Type: application/json"  -X DELETE \ "http://{MS_IP}:8080/v1/analytics/groups/ax/{ax_group}/consumer-groups/{consumer_group}/consumers/{QPID_UUID}"
  5. Entfernen Sie Qpid aus der Analysegruppe:
    curl -v -u <AdminEmailID>:'<AdminPassword>' \
    -X DELETE "http://{MS_IP}:8080/v1/analytics/groups/ax/{ax_group}/servers?uuid={QPID_UUID}&type=qpid-server"
  6. Heben Sie die Registrierung des Qpid-Servers in der Edge-Installation auf:
    curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
    -d "type=qpid-server&region=dc-1&pod=central&uuid={QPID_UUID}&action=remove"
  7. Entfernen Sie den Qpid-Server aus der Edge-Installation:
    curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID
  8. Starten Sie alle edge-qpid-server-Komponenten auf allen Knoten neu, damit die Änderung von diesen Komponenten übernommen wird:
    $ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    $ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready
  9. Deinstallieren Sie edge-qpid-server und apigee-qpidd:
    $ /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall
    $ /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall

Postgres und Postgresql

Das Rechenzentrum, das Sie außer Betrieb nehmen, kann einen Postgres-Master oder einen Postgres-Standby haben. In den folgenden Abschnitten wird beschrieben, wie Sie sie außer Betrieb setzen:

Postgres-Master außer Betrieb nehmen

Hinweis:Wenn Sie den Postgres-Master außer Betrieb nehmen, müssen Sie einen der verfügbaren Standby-Knoten zum neuen Postgres-Master befördern. QPID puffert zwar Daten, aber wenn der Postgres-Master für längere Zeit nicht verfügbar ist, besteht das Risiko, dass Analysedaten verloren gehen.

So stellen Sie den Postgres-Master außer Betrieb:

  1. Sichern Sie den Postgres-Masterknoten dc-1. Folgen Sie dazu der Anleitung unter den folgenden Links:
  2. Rufen Sie die UUIDs der Postgres-Server ab, wie unter UUIDs abrufen beschrieben.
  3. Beenden Sie auf dc-1 edge-postgres-server und apigee-postgresql auf dem aktuellen Master:
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  4. Geben Sie auf dem Standbyknoten auf dc-2 den folgenden Befehl ein, um ihn zum Masterknoten zu machen:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql promote-standby-to-master <IP of OLD Progress master>

    Hinweis:Wenn Sie mehr als einen Standby-Postgres-Knoten haben, müssen Sie dem neuen Master Hosteinträge hinzufügen und die Replikationseinstellung für alle verfügbaren Postgres-Standby-Knoten aktualisieren.

    So fügen Sie dem neuen Postgres-Master Hosteinträge hinzu: Folgen Sie der Anleitung im entsprechenden Abschnitt unten:

    Wenn nur noch ein Standby-Knoten übrig ist

    Angenommen, vor der Deaktivierung waren drei Postgres-Knoten konfiguriert. Sie haben den vorhandenen Master außer Betrieb genommen und einen der verbleibenden postgres-Standby-Knoten zum Master befördert. Konfigurieren Sie den verbleibenden Standbyknoten mit den folgenden Schritten:

    1. Bearbeiten Sie auf dem neuen Master die Konfigurationsdatei, um Folgendes festzulegen:
      PG_MASTER=IP_or_DNS_of_new_PG_MASTER
      PG_STANDBY=IP_or_DNS_of_PG_STANDBY
    2. Aktivieren Sie die Replikation auf dem neuen Master:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFIle

    Wenn noch mehr als ein Standby-Knoten vorhanden ist

    1. Fügen Sie in /opt/apigee/customer/application/postgresql.properties die folgende Konfiguration hinzu:
      conf_pg_hba_replication.connection=host replication apigee standby_1_ip/32 trust \n host replication apigee standby_2_ip/32 trust
    2. Prüfen Sie, ob der Apigee-Nutzer Inhaber der Datei /opt/apigee/customer/application/postgresql.properties ist:
      chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
    3. Starten Sie apigee-postgresql neu:
      apigee-service apigee-postgresql restart
    4. So aktualisieren Sie die Replikationseinstellungen auf einem Standbyknoten:

      1. Ändern Sie die Konfigurationsdatei /opt/silent.conf und aktualisieren Sie das Feld PG_MASTER mit der IP-Adresse des neuen Postgres-Masters.
      2. Entfernen Sie alle alten Postgres-Daten mit dem folgenden Befehl:
        rm -rf /opt/apigee/data/apigee-postgresql/
      3. Richten Sie die Replikation auf dem Standby-Knoten ein:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    5. Prüfen Sie, ob der Postgres-Master richtig eingerichtet ist, indem Sie in dc-2 den folgenden Befehl eingeben:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
    6. Entfernen Sie Postgresql-Server aus der Analysegruppe und der Nutzergruppe und fügen Sie sie wieder hinzu.
      1. Entfernen Sie den alten Postgres-Server aus der Analysegruppe. Folgen Sie dazu der Anleitung unter Postgres-Server aus einer Analysegruppe entfernen.
      2. Fügen Sie der Analysegruppe einen neuen Postgres-Server hinzu. Folgen Sie dazu der Anleitung unter Bestehenden Postgres-Server einer Analysegruppe hinzufügen.
    7. Registrieren Sie den alten Postgres-Server von dc-1 ab:
      curl -u <AdminEmailID>:<AdminPassword> -X POST http://{MS_IP}:8080/v1/servers \
      -d "type=postgres-server®ion=dc-1&pod=analytics&uuid=UUID&action=remove"
            
    8. Löschen Sie den alten Postgres-Server von dc-1:
      curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID
    9. Der alte Postgres-Master kann jetzt außer Betrieb genommen werden. edge-postgres-server und apigee-postgresql deinstallieren:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server uninstall
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql uninstall

    Postgres-Standby-Konfiguration außer Betrieb nehmen

    Hinweis:In der Dokumentation für eine Clusterinstallation mit 12 Knoten wird der PostgreSQL-Knoten „dc-1“ als Master angezeigt. In diesem Abschnitt wird jedoch davon ausgegangen, dass der PostgreSQL-Knoten „dc-1“ als Standby und der PostgreSQL-Knoten „dc-2“ als Master dient.

    So stellen Sie den Postgres-Standby-Server außer Betrieb:

    1. Rufen Sie die UUIDs der Postgres-Server ab. Folgen Sie dazu der Anleitung unter UUIDs abrufen.
    2. Beenden Sie apigee-postgresql auf dem aktuellen Standby-Knoten in dc-1:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. Entfernen Sie Postgresql-Server aus der Analysegruppe und der Nutzergruppe und fügen Sie sie wieder hinzu.
      1. Entfernen Sie den alten Postgres-Server aus der Analysegruppe. Folgen Sie dazu der Anleitung unter Postgres-Server aus einer Analysegruppe entfernen.
      2. Fügen Sie der Analysegruppe einen neuen Postgres-Server hinzu. Folgen Sie dazu der Anleitung unter Bestehenden Postgres-Server einer Analysegruppe hinzufügen.
    4. Registrieren Sie den alten Postgres-Server von dc-1 ab:
      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://{MS_IP}:8080/v1/servers \
      -d "type=postgres-server&region=dc-1&pod=analytics&uuid=UUID&action=remove"
    5. Löschen Sie den alten Postgres-Server von dc-1:
      curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://{MS_IP}:8080/v1/servers/UUID
    6. Der alte Postgres-Master kann jetzt außer Betrieb genommen werden. edge-postgres-server und apigee-postgresql deinstallieren:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server uninstall
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql uninstall

    ZooKeeper und Cassandra

    In diesem Abschnitt wird beschrieben, wie Sie ZooKeeper- und Cassandra-Server in einer Zwei-Rechenzentrums-Umgebung außer Betrieb setzen.

    Wenn Sie mehr als zwei Rechenzentren haben, entfernen Sie alle Verweise auf den außer Betrieb genommenen Knoten (in diesem Fall dc-1) aus allen Silent-Konfigurationsdateien in allen verbleibenden Rechenzentren. Entfernen Sie die Hosts der Cassandra-Knoten, die außer Betrieb genommen werden sollen, aus CASS_HOSTS. Die verbleibenden Cassandra-Knoten sollten in der ursprünglichen Reihenfolge von CASS_HOSTS bleiben.

    Hinweis zu ZooKeeper:Sie müssen ein Quorum von Abstimmendenknoten beibehalten, während Sie die Eigenschaft ZK_HOST in der Konfigurationsdatei ändern, damit das ZooKeeper-Ensemble weiterhin funktioniert. Ihre Konfiguration muss eine ungerade Anzahl von Abstimmendenknoten enthalten. Weitere Informationen finden Sie unter Wartungsaufgaben für Apache ZooKeeper.

    So nehmen Sie ZooKeeper- und Cassandra-Server außer Betrieb:

    1. Sichern Sie die Cassandra- und ZooKeeper-Knoten von dc-1. Folgen Sie dazu der Anleitung unter den folgenden Links:
    2. Listen Sie die UUIDs der ZooKeeper- und Cassandra-Server im Rechenzentrum auf, in dem Cassandra-Knoten außer Betrieb genommen werden sollen.

      apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin <AdminEmailID> --pwd '<AdminPassword>' --host localhost
    3. Registrieren Sie den Servertyp ab:
      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://MS_IP:8080/v1/servers -d "type=cache-datastore&type=user-settings-datastore&type=scheduler-datastore&type=audit-datastore&type=apimodel-datastore&type=application-datastore&type=edgenotification-datastore&type=identityzone-datastore&type=user-settings-datastore&type=auth-datastore&region=dc-1&pod=central&uuid=UUID&action=remove"
    4. So heben Sie die Registrierung des Servers auf:
      curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MS_IP:8080/v1/servers/UUID
    5. Aktualisieren Sie die Konfigurationsdatei mit den IP-Adressen der stillgelegten Knoten, die aus ZK_HOSTS und CASS_HOSTS entfernt wurden.

      Beispiel: Angenommen, Sie haben die IP-Adressen $IP1 $IP2 $IP3 in dc-1 und $IP4 $IP5 $IP6 in dc-2 und stellen dc-1 außer Betrieb. Entfernen Sie dann die IP-Adressen $IP1 $IP2 $IP3 aus den Konfigurationsdateien.

      • Vorhandene Einträge in der Konfigurationsdatei:
        ZK_HOSTS="$IP1 $IP2 $IP3 $IP4 $IP5 $IP6"
        CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1, $IP4:2,1 $IP5:2,1 $IP6:2,1”
      • Neue Einträge in der Konfigurationsdatei:
        ZK_HOSTS="$IP4 $IP5 $IP6"
        CASS_HOSTS="$IP4:2,1 $IP5:2,1 $IP6:2,1"
    6. Aktualisieren Sie die Datei für die Silent-Installation (in Schritt e geändert) mit den IP-Adressen der entfernten, außer Betrieb gesetzten Knoten und führen Sie das Profil für den Verwaltungsserver auf allen Knoten aus, auf denen Verwaltungsserver gehostet werden:
      /opt/apigee/apigee-setup/bin/setup.sh -p ms -f updated_config_file
    7. Aktualisieren Sie die Konfigurationsdatei mit den IP-Adressen der entfernten, außer Betrieb gesetzten Knoten und führen Sie das MP/RMP-Profil auf allen Router- und Message Processor-Knoten aus:
      • Wenn Edge Router und Message Processor auf demselben Knoten konfiguriert sind, geben Sie Folgendes ein:
        /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f updated_config_file
      • Wenn Edge Router und Message Processor auf separaten Knoten konfiguriert sind, geben Sie Folgendes ein:

        Für den Router:

        /opt/apigee/apigee-setup/bin/setup.sh -p r -f updated_config_file

        Für den Nachrichtenverarbeiter:

        /opt/apigee/apigee-setup/bin/setup.sh -p mp -f updated_config_file
    8. Konfigurieren Sie alle Qpid-Knoten neu, wobei die IP-Adressen der außer Betrieb gesetzten Knoten aus der Antwortdatei entfernt werden:
      /opt/apigee/apigee-setup/bin/setup.sh -p qs -f updated_config_file
    9. Konfigurieren Sie alle Postgres-Knoten neu, wobei die IP-Adressen der stillgelegten Knoten aus der Antwortdatei entfernt werden:
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f updated_config_file
    10. Ändern Sie den Schlüsselbereich system_auth. Wenn Sie die Cassandra-Authentifizierung auf einem vorhandenen Cassandra-Knoten aktiviert haben, aktualisieren Sie den Replikationsfaktor des Schlüsselbereichs system_auth mit dem folgenden Befehl:
      ALTER KEYSPACE system_auth WITH replication = {'class': 'NetworkTopologyStrategy', 'dc-2': '3'};

      Mit diesem Befehl wird der Replikationsfaktor auf '3' festgelegt, was drei Cassandra-Knoten im Cluster bedeutet. Ändern Sie diesen Wert nach Bedarf.

      Nach Abschluss dieses Schritts sollte die Cassandra-Topologie in keinem der Schlüsselräume dc-1 enthalten.

    11. Nehmen Sie die Cassandra-Knoten auf dc-1 nacheinander außer Betrieb.

      Geben Sie den folgenden Befehl ein, um die Cassandra-Knoten außer Betrieb zu setzen:

      /opt/apigee/apigee-cassandra/bin/nodetool -h cassIP -u cassandra -pw '<AdminPassword>' decommission
    12. Prüfen Sie die Verbindung der Cassandra-Knoten von dc-1 mit einem der folgenden Befehle:
      /opt/apigee/apigee-cassandra/bin/cqlsh cassIP 9042 -u cassandra -p '<AdminPassword>'

      Oder sekundärer Befehl zur Bestätigung, der auf dem außer Betrieb gesetzten Knoten ausgeführt werden soll:

      /opt/apigee/apigee-cassandra/bin/nodetool netstats

      Der obige Befehl sollte Folgendes zurückgeben:

      Mode: DECOMMISSIONED
    13. Führen Sie das DS-Profil für alle Cassandra- und ZooKeeper-Knoten in dc-2 aus:
      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f updated_config_file
    14. Beenden Sie apigee-cassandra und apigee-zookeeper in dc-1:
      apigee-service apigee-cassandra stop
      apigee-service apigee-zookeeper stop
    15. Deinstallieren Sie apigee-cassandra und apigee-zookeeper in dc-1:
      apigee-service apigee-cassandra uninstall
      apigee-service apigee-zookeeper uninstall

    Löschen Sie die Bindungen von dc-1.

    So löschen Sie die Bindungen von dc-1:

    1. Löschen Sie die Bindungen von dc-1.
      1. Alle verfügbaren Pods der Organisation auflisten:
        curl -v -u  <AdminEmailID>:'<AdminPassword>' -X GET "http://MS_IP:8080/v1/o/ORG/pods"
      2. Um zu prüfen, ob alle Bindungen entfernt wurden, rufen Sie die UUIDs der mit den Pods verknüpften Server ab:
        curl -v -u  <AdminEmailID>:'<AdminPassword>' \
        -X GET "http://MS_IP:8080/v1/regions/dc-1/pods/gateway-1/servers"

        Wenn mit diesem Befehl keine UUIDs zurückgegeben werden, wurden in den vorherigen Schritten alle Bindungen entfernt und Sie können den nächsten Schritt überspringen. Andernfalls fahren Sie mit dem nächsten Schritt fort.

      3. Entfernen Sie alle Serverbindungen für die im vorherigen Schritt ermittelten UUIDs:
        curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MS_IP:8080/v1/servers/UUID
      4. Entfernen Sie die Verknüpfung der Organisation mit dem Pod:
        curl -v -u  <AdminEmailID>:'<AdminPassword>'  "http://MS_IP:8080/v1/o/ORG/pods" -d "action=remove&region=dc-1&pod=gateway-1" -H "Content-Type: application/x-www-form-urlencoded" -X POST
    2. Pods löschen:
      curl -v -u <AdminEmailID>:'<AdminPassword>' "http://MS_IP:8080/v1/regions/dc-1/pods/gateway-1" -X DELETE
    3. Löschen Sie die Region.
      curl -v -u <AdminEmailID>:'<AdminPassword>'  "http://MS_IP:8080/v1/regions/dc-1" -X DELETE

    An diesem Punkt haben Sie die Deaktivierung von dc-1 abgeschlossen.

    Anhang

    Fehlerbehebung

    Wenn nach Ausführung der vorherigen Schritte noch Server in einigen Pods vorhanden sind, führen Sie die folgenden Schritte aus, um die Server abzumelden und zu löschen. Hinweis:Ändern Sie die Typen und den Pod nach Bedarf.

    1. Rufen Sie die UUIDs mit dem folgenden Befehl ab:
      apigee-adminapi.sh servers list -r dc-1 -p POD -t  --admin <AdminEmailID> --pwd  '<AdminPassword>’ --host localhost
    2. Registrieren Sie den Servertyp nicht mehr:
      curl -u <AdminEmailID>:'<AdminPassword>' -X POST http://MP_IP:8080/v1/servers -d "type=TYPE=REGION=dc-1&pod=POD&uuid=UUID&action=remove"
    3. Löschen Sie die Server einzeln:
      curl -u <AdminEmailID>:'<AdminPassword>' -X DELETE http://MP_IP:8080/v1/servers/UUID

    Validierung

    Sie können die Deaktivierung mit den folgenden Befehlen prüfen.

    Verwaltungsserver

    1. Führen Sie die folgenden Befehle von den Verwaltungsservern in allen Regionen aus.
      curl -v -u  <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/servers?pod=central&region=dc-1
      curl -v -u  <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/servers?pod=gateway&region=dc-1
      curl -v -u  <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/servers?pod=analytics&region=dc-1
    2. Führen Sie den folgenden Befehl auf allen Komponenten aus, um die Portanforderungen für alle Verwaltungsports zu prüfen.
      curl -v http://MS_IP:8080/v1/servers/self
    3. Prüfen Sie die Analysegruppe.
      curl -v  -u  <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/o/ORG/e/ENV/provisioning/axstatus
      curl -v  -u  <AdminEmailID>:'<AdminPassword>' http://MS_IP:8080/v1/analytics/groups/ax
    4. Cassandra-/ZooKeeper-Knoten

      1. Geben Sie auf allen Cassandra-Knoten Folgendes ein:
        /opt/apigee/apigee-cassandra/bin/nodetool -h <host> statusthrift

        Dadurch wird der Status running oder not running für diesen bestimmten Knoten zurückgegeben.

      2. Geben Sie an einem Knoten Folgendes ein:
        /opt/apigee/apigee-cassandra/bin/nodetool -h <host> ring
        /opt/apigee/apigee-cassandra/bin/nodetool -h <host> status

        Die obigen Befehle geben Informationen zu aktiven Rechenzentren zurück.

      3. Geben Sie auf den ZooKeeper-Knoten zuerst Folgendes ein:
        echo ruok | nc <host> 2181
        

        Dieser Befehl gibt imok zurück.

        Geben Sie als Nächstes Folgendes ein:

        echo stat | nc <host> 2181 | grep Mode
        

        Der vom obigen Befehl zurückgegebene Wert für Mode ist einer der folgenden: observer, leader oder follower.

      4. Führen Sie auf einem ZooKeeper-Knoten folgenden Befehl aus:
        /opt/apigee/apigee-zookeeper/contrib/zk-tree.sh >> /tmp/zk-tree.out.txt
      5. Führen Sie auf dem Postgres-Masterknoten Folgendes aus:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        Prüfen Sie, ob in der Antwort angegeben ist, dass der Knoten der Master ist.

      6. Führen Sie auf dem Standby-Knoten Folgendes aus:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        Prüfen Sie, ob in der Antwort bestätigt wird, dass der Knoten der Standby-Knoten ist.

      7. Melden Sie sich mit dem folgenden Befehl in der PostgreSQL-Datenbank an:
        psql -h localhost -d apigee -U postgres

        Geben Sie bei Aufforderung das Passwort für den Nutzer postgres ein (Standard: postgres).

        Führen Sie dann die folgende Abfrage aus, um den maximalen Wert für client_received_start_timestamp zu prüfen:

        SELECT max(client_received_start_timestamp) FROM "analytics"."$org.$env.fact" LIMIT 1;

      Logs

      Prüfen Sie die Protokolle der Komponenten, um sicherzustellen, dass keine Fehler vorliegen.