Cassandra-Knoten hinzufügen

Edge for Private Cloud Version 4.19.01

In diesem Dokument wird beschrieben, wie Sie einem vorhandenen Edge für die Private Cloud-Installation drei neue Cassandra-Knoten hinzufügen.

Obwohl Sie einer vorhandenen Edge-Installation einen oder zwei Cassandra-Knoten hinzufügen können, empfiehlt Apigee, dass Sie jeweils drei Knoten hinzufügen.

Eine Liste der Systemanforderungen für einen Cassandra-Knoten finden Sie unter Installationsanforderungen.

Vorhandene Edge-Konfiguration

Alle unterstützten Edge-Topologien für ein Produktionssystem geben die Verwendung von drei Cassandra-Knoten an. Die drei Knoten werden für das Attribut CASS_HOSTS in der Konfigurationsdatei angegeben, wie unten dargestellt:

IP1=10.10.0.1
IP2=10.10.0.2
IP3=10.10.0.3
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com
APIGEE_ADMINPW=Secret123
LICENSE_FILE=/tmp/license.txt
MSIP=$IP1 
USE_LDAP_REMOTE_HOST=n
LDAP_TYPE=1
APIGEE_LDAPPW=secret
MP_POD=gateway
REGION=dc-1
ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1" 
SKIP_SMTP=n
SMTPHOST=smtp.example.com
SMTPUSER=smtp@example.com
SMTPPASSWORD=smtppwd

Beachten Sie, dass das Attribut REGION den Namen der Region als „dc-1“ angibt. Sie benötigen diese Informationen, wenn Sie die neuen Cassandra-Knoten hinzufügen.

Konfigurationsdatei ändern, um die drei neuen Cassandra-Knoten hinzuzufügen

In diesem Beispiel befinden sich die drei neuen Cassandra-Knoten unter den folgenden IP-Adressen:

  • 10.10.0.14
  • 10.10.0.15
  • 10.10.0.16

Sie müssen zuerst die Edge-Konfigurationsdatei aktualisieren, um die neuen Knoten hinzuzufügen:

IP1=10.10.0.1
IP2=10.10.0.2
IP3=10.10.0.3
# Add the new node IP addresses.
IP14=10.10.0.14
IP15=10.10.0.15
IP16=10.10.0.16
HOSTIP=$(hostname -i)
ADMIN_EMAIL=opdk@google.com
...
# Update CASS_HOSTS to add each new node after an existing nodes. 
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP14:1,1 $IP2:1,1 $IP15:1,1 $IP3:1,1 $IP16:1,1"

Dadurch wird sichergestellt, dass die vorhandenen Knoten ihre anfänglichen Tokeneinstellungen beibehalten und das erste Token jedes neuen Knotens zwischen den Tokenwerten der vorhandenen Knoten liegt.

Edge konfigurieren

Nach dem Bearbeiten der Konfigurationsdatei müssen Sie Folgendes tun:

  • Vorhandene Cassandra-Knoten neu konfigurieren
  • Cassandra auf den neuen Knoten installieren
  • Verwaltungsserver neu konfigurieren

Vorhandene Cassandra-Knoten neu konfigurieren

Auf den vorhandenen Cassandra-Knoten:

  1. Führen Sie „setup.sh“ mit dem Profil „-p c“ und der neuen Konfigurationsdatei noch einmal aus: 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile

Cassandra auf den neuen Knoten installieren

Führen Sie auf jedem neuen Cassandra-Knoten folgende Schritte aus:

  1. Installieren Sie Cassandra auf den drei Knoten:
    1. Installieren Sie apigee-setup auf dem ersten Knoten, wie unter Edge-Dienstprogramm für Apigee-Setup installieren beschrieben.
    2. Installieren Sie Cassandra auf dem ersten Knoten mithilfe der aktualisierten Konfigurationsdatei: 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
    3. Wiederholen Sie diese beiden Schritte für die verbleibenden neuen Cassandra-Knoten.
  2. Erstellen Sie die drei neuen Cassandra-Knoten neu. Geben Sie dabei den Regionsnamen an, der in der Konfigurationsdatei mit dem Attribut REGION festgelegt wurde. In diesem Beispiel ist das „dc-1“:
    1. Führen Sie auf dem ersten Knoten folgenden Befehl aus: 
      /opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h nodeIP rebuild dc-1

      Dabei ist nodeIP die IP-Adresse des Cassandra-Knotens.

      Sie müssen Ihren Nutzernamen und Ihr Passwort nur weitergeben, wenn Sie die JMX-Authentifizierung für Cassandra aktiviert haben.

    2. Wiederholen Sie diesen Schritt auf den verbleibenden neuen Cassandra-Knoten.

Verwaltungsserver neu konfigurieren

Auf einem Verwaltungsserverknoten

  1. Führen Sie „setup.sh“ noch einmal aus, um den Verwaltungsserver für die neu hinzugefügten Cassandra-Knoten zu aktualisieren: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ms -f updatedConfigFile

Alle Router und Message Processor neu starten

  1. Für alle Router: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  2. Auf allen Message Processorn: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Freier Speicherplatz auf vorhandenen Cassandra-Knoten

Nachdem Sie einen neuen Knoten hinzugefügt haben, können Sie auf den vorhandenen Knoten den Befehl nodetool cleanup verwenden, um Speicherplatz freizugeben. Dieser Befehl löscht Konfigurationstokens, die nicht mehr zum vorhandenen Cassandra-Knoten gehören.

Führen Sie den folgenden Befehl aus, um nach dem Hinzufügen eines neuen Knotens Speicherplatz auf vorhandenen Cassandra-Knoten freizugeben:

/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h cassandraIP cleanup

Sie müssen Ihren Nutzernamen und Ihr Passwort nur weitergeben, wenn Sie die JMX-Authentifizierung für Cassandra aktiviert haben.

Neuerstellung prüfen

Prüfen Sie mit den folgenden Befehlen, ob die Neuerstellung erfolgreich war:

nodetool [-u username -pw password] -h nodeIP netstats

Dieser Befehl sollte MODE: Normal anzeigen, wenn der Knoten aktiv ist und die Indexe erstellt werden.

nodetool [-u username -pw password] -h nodeIP statusthrift

Sollte anzeigen, dass der Secondhand-Server ausgeführt wird, damit Cassandra neue Clientanfragen akzeptieren kann.

nodetool [-u username -pw password] -h nodeIP statusbinary

Sollte anzeigen, dass der native Transport (oder das Binärprotokoll) ausgeführt wird.

nodetool describecluster

Sie sollten zeigen, dass neue Knoten dieselbe Schemaversion wie die älteren Knoten verwenden.

Weitere Informationen zur Verwendung von nodetool finden Sie in der Dokumentation zur Nodetool-Nutzung.