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

Installation mehrerer Rechenzentren für API BaaS

Edge for Private Cloud v. 4.17.01

Sie können API BaaS in mehreren Rechenzentren mit einer Aktiv/Aktiv-Konfiguration installieren. In diesem Dokument wird beschrieben, wie Sie ein BaaS-Rechenzentrum zu einem vorhandenen BaaS-Rechenzentrum hinzufügen.

Rechenzentrum hinzufügen, wenn der Cassandra-Cluster mit Edge geteilt wird

Alle Rechenzentren müssen dieselbe Anzahl von Cassandra-Knoten haben. Eine API BaaS-Installation kann einen eigenen Cassandra-Cluster verwenden oder einen Cassandra-Cluster mit Edge teilen.

Wenn die BaaS-Installation einen Cassandra-Cluster mit Edge gemeinsam nutzt, müssen Sie den Management Server im ursprünglichen Rechenzentrum aktualisieren, damit er die Cassandra-Knoten im neuen Rechenzentrum erkennt.

Aktualisierung des vorhandenen Rechenzentrums

Wenn Sie ein neues BaaS-Rechenzentrum (Rechenzentrum 2) hinzufügen, müssen Sie die Schritte zum Installieren und Konfigurieren des neuen Rechenzentrums ausführen. Außerdem müssen Sie das ursprüngliche BaaS-Rechenzentrum (Rechenzentrum 1) aktualisieren. Diese Änderungen sind aus folgenden Gründen erforderlich:

Sie fügen dem neuen Rechenzentrum neue Cassandra-Knoten hinzu, die vom vorhandenen Rechenzentrum aus zugänglich sein müssen.
Sie müssen die Replikationsinformationen, die von den BaaS-Stack-Knoten in Rechenzentrum 1 verwendet werden, so konfigurieren, dass sie Informationen aus Rechenzentrum 2 enthalten. Sie können diese Konfiguration erst vornehmen, wenn Rechenzentrum 2 installiert ist.

Wenn Sie diese Aktualisierungen im Rechenzentrum 1 vornehmen möchten, aktualisieren Sie die ursprüngliche Konfigurationsdatei, die für die Installation des Rechenzentrums 1 verwendet wurde, und führen Sie dann apigee-setup auf den Cassandra-Knoten des Rechenzentrums 1 noch einmal aus. Wenn der Cassandra-Cluster für Rechenzentrum 1 mit einer Edge-Installation geteilt wird, müssen Sie auch den Management Server aktualisieren.

Konfigurationsdateien erstellen

Verwenden Sie für die Installation von Rechenzentrum 1 die unter API BaaS-Installation gezeigte Konfiguration. Die Konfigurationsdatei muss keine Informationen zu Rechenzentrum 2 enthalten, wenn Sie Rechenzentrum 1 installieren.Sie fügen der Konfigurationsdatei Informationen hinzu, nachdem Sie Rechenzentrum 2 installiert haben.

Unten sehen Sie die Konfigurationsdateien für Rechenzentrum 2. In dieser Konfigurationsdatei wird davon ausgegangen, dass Sie dc-2 auf 10 Knoten installieren, wie unter Installationstopologien beschrieben. Ändern Sie diese Datei entsprechend, wenn Sie die Installation auf 7 Knoten durchführen.

Beachten Sie, dass die Konfigurationsdatei für Rechenzentrum 2 (dc-2) Informationen zu Rechenzentrum 1 (dc-1) enthält:

# Specify IP address or DNS name of node for dc-2.
IP1=192.168.1.1   # ElasticSearch
IP2=192.168.1.2   # ElasticSearch
IP3=192.168.1.3   # ElasticSearch
IP4=192.168.1.4   # API BaaS Stack
IP5=192.168.1.5   # API BaaS Stack
IP6=192.168.1.6   # API BaaS Stack
IP7=192.168.1.7   # API BaaS Portal
IP8=192.168.1.8   # Cassandra dc-2 (shared with Edge or standalone)
IP9=192.168.1.9   # Cassandra dc-2 (shared with Edge or standalone)
IP10=192.168.1.10  # Cassandra dc-2 (shared with Edge or standalone)

# Specify node information for dc-1
IP11=192.168.1.11   # Cassandra dc-1 (shared with Edge or standalone)
IP12=192.168.1.12   # Cassandra dc-1 (shared with Edge or standalone)
IP13=192.168.1.13   # Cassandra dc-1 (shared with Edge or standalone)
IP14=192.168.1.14   # API BaaS Stack
IP15=192.168.1.15   # API BaaS Stack

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Define the API BaaS administrator account.  
AS_ADMIN="superuser"    # User name - default is "superuser".
AS_ADMIN_EMAIL=stackAdmin@email.com
AS_PASSWD=stackAdminPWord

# Specify Cassandra data center and rack suffix.
# List dc-2 nodes first, then dc-1.
# Must use IP addresses for CASS_HOSTS, not DNS names.
# CASS_HOSTS="$IP8:2,1 $IP9:2,1 $IP10:2,1 $IP11:1,1 $IP12:1,1 $IP13:1,1"

# Specify the Cassandra region.
REGION=dc-2

# Cassandra uname/pword.
# Even if Cassandra authentication is disabled,
# you must still pass values for these properties.
CASS_USERNAME=cassandra    # Default value
CASS_PASSWORD=cassandra    # Default value

# Specify BaaS Cassandra connection information.
# Specify the data center name as dc-2.
BAAS_CASS_LOCALDC=dc-2    

# Specify both data centers.
BAAS_CASS_DC_LIST=dc-1,dc-2

# Replication is in the form "dataCenterName:#CassandraNodes". 
# Specify both data centers.
BAAS_CASS_REPLICATION=dc-1:3,dc-2:3

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes per data center.
# Specify both data centers. 
BAAS_CLUSTER_SEEDS="dc-1:$IP14,dc-1:$IP15,dc-2:$IP4,dc-2:$IP5"

# ElasticSearch IPs or DNS names, separated by spaces, for dc-2.
ES_HOSTS="$IP1 $IP2 $IP3"

# API BaaS Stack information.
# Default cluster name is "apigee_baas"
BAAS_USERGRID_CLUSTERNAME="apigee_baas" 

# URL and port of the load balancer for the API BaaS Stack nodes, 
# or IP/DNS and port 8080 of a single Stack node with no load balancer.
BAAS_USERGRID_URL=http://myloadbalancer:8443

# API BaaS Portal information.
# URL and port number of load balancer, if there is one in front of the Portal,
# or the URL and port of the Portal node.  
BAAS_PORTAL_URL="http://$IP7:9000"

# Portal port. Default value is 9000.
BAAS_PORTAL_LISTEN_PORT=9000 

# SMTP information. BaaS requires an SMTP server.
SMTPHOST=smtp.gmail.com
SMTPPORT=465
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y

BaaS-Rechenzentrum hinzufügen

Installieren Sie das erste Rechenzentrum, wie unter API BaaS-Installation beschrieben. Dieses Dokument enthält die Konfigurationsdatei, die Sie für die Installation von Rechenzentrum 1 verwenden.
Erstellen Sie die Konfigurationsdatei für dc-2 wie oben beschrieben.
Installieren Sie Cassandra entweder als Teil einer vorhandenen Edge-Installation oder als eigenständigen Cluster für BaaS:
1. Installieren Sie das Edge-Dienstprogramm apigee-setup auf dem ersten Cassandra-Knoten von dc-2, Maschine 8, mithilfe des Internet- oder Nicht-Internet-Verfahrens. Weitere Informationen finden Sie unter Edge-Dienstprogramm „apigee-setup“ installieren.
2. Führen Sie an der Eingabeaufforderung das Setupscript aus, um Cassandra auf dem ersten Knoten zu installieren:
  > /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
  
  Mit der Option „-p c“ wird angegeben, dass Cassandra installiert werden soll.
  
  Die Konfigurationsdatei muss für den Nutzer „apigee“ zugänglich oder lesbar sein.
3. Wiederholen Sie die Schritte 3 und 4 für die verbleibenden Cassandra-Knoten, die Maschinen 9 und 10, in dc-2.
Bearbeiten Sie auf den Cassandra-Knoten von dc-1 die Konfigurationsdatei, um die Cassandra-Knoten aus Rechenzentrum 2 hinzuzufügen, je nachdem, wie Sie Cassandra installiert haben:

# List dc-1 nodes first, then dc-2,
# including Cassandra data center and rack suffix
CASS_HOSTS="$IP11:1,1 $IP12:1,1 $IP13:1,1 $IP8:2,1 $IP9:2,1 $IP10:2,1"
Führen Sie auf dem ersten Cassandra-Knoten von dc-1 „setup.sh“ mit der neuen dc-1-Konfigurationsdatei aus, die die Cassandra-Knoten von dc-2 enthält:
> /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
Wiederholen Sie die Schritte 6 und 7 für die verbleibenden Cassandra-Knoten in dc-1.
Wenn Sie eine Verbindung zu einem Cassandra-Cluster für dc-1 herstellen, der mit Edge geteilt wird, fügen Sie die dc-2-Cassandra-Knoten der Konfigurationsdatei für den Management Server-Knoten von dc-1 hinzu und führen Sie setup.sh aus:
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile
Aktualisieren Sie die Cassandra-Schlüsselbereiche mit dem richtigen Replikationsfaktor für die beiden Rechenzentren. Sie müssen diesen Schritt nur einmal auf einem beliebigen Cassandra-Server in einem der Rechenzentren ausführen:

Hinweis: Mit den folgenden Befehlen wird der Replikationsfaktor auf „3“ gesetzt, was auf drei Cassandra-Knoten im Cluster hinweist. Ändern Sie diesen Wert nach Bedarf für Ihre Installation.
1. Starten Sie das Cassandra-Dienstprogramm „cqlsh“:
  > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
2. Führen Sie die folgenden CQL-Befehle an der Eingabeaufforderung „cqlsh>“ aus, um die Replikationsstufen für Cassandra-Schlüsselbereiche festzulegen:
  1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
  2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
  3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
  4. cqlsh> ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
  5. cqlsh> ALTER KEYSPACE "system_auth" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
  6. Rufen Sie die Schlüsselbereiche mit dem folgenden Befehl auf:
    cqlsh> select * from system.schema_keyspaces;
  7. Beenden Sie cqlsh:
    cqlsh> exit
Führen Sie auf allen Cassandra-Knoten in dc-2 den Befehl „rebuild“ aus und geben Sie den Regionsnamen von dc-1 an:
> /opt/apigee/apigee-cassandra/bin/nodetool -h cassandraIP rebuild dc-1
Führen Sie „nodetool status“ auf jedem Cassandra-Knoten aus und prüfen Sie, ob alle Cassandra-Knoten den Wert „100 %“ für „Owns“ haben:
> /opt/apigee/apigee-cassandra/bin/nodetool status
Installieren Sie BaaS in dc-2:
1. Bearbeiten Sie die Konfigurationsdatei, um nur die Cassandra-Knoten in dc-2 aufzulisten:
  # List dc-2 Cassandra nodes,
  # omitting Cassandra data center and rack suffix
  CASS_HOSTS="$IP8 $IP9 $IP10"
2. Installieren Sie Elasticsearch auf den Knoten 4, 5 und 6 von dc-2:
  > /opt/apigee/apigee-setup/bin/setup.sh -p e -f configFile
3. Installieren Sie den BaaS-Stack auf den Knoten 4, 5 und 6 von dc-2:
  > /opt/apigee/apigee-setup/bin/setup.sh -p b -f configFile
4. Installieren Sie das BaaS-Portal auf Maschine 7:
  > /opt/apigee/apigee-setup/bin/setup.sh -p p -f configFile
Aktualisieren Sie die BaaS-Stack-Knoten in Rechenzentrum 1:
1. Bearbeiten Sie auf dem ersten BaaS-Stack-Knoten in Rechenzentrum 1 die Datei /opt/apigee/customer/application/usergrid.properties in einem Editor. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
2. Fügen Sie usergrid.properties die folgenden Attribute hinzu:
  # Same value as BAAS_CLUSTER_SEEDS in the dc-2 Konfigurationsdatei,
  # without double quotes.
  usergrid-deployment_usergrid.cluster.seeds=dc-1:dc1StackIP1,dc-1:dc1StackIP2,dc-2:dc2StackIP1,dc-2:dc2StackIP2
  
  # Same value as BAAS_CASS_DC_LIST in the dc-2 config file.
  usergrid-deployment_usergrid.cluster.region.list=dc-1,dc-2
3. Wiederholen Sie die Schritte a und b auf den verbleibenden BaaS-Stack-Knoten.
4. Starten Sie alle BaaS-Stack-Knoten neu.
  
  Hinweis: Wenn Sie BaaS-Stack-Knoten neu starten, starten Sie sie in derselben Reihenfolge neu, in der sie in BAAS_CLUSTER_SEEDS aufgeführt sind. BAAS_CLUSTER_SEEDS listet höchstens zwei der Stack-Knoten auf. Nachdem Sie diese beiden Knoten nacheinander neu gestartet haben, können Sie die verbleibenden Knoten in beliebiger Reihenfolge neu starten.
  
  > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart
Aktualisieren Sie die BaaS-Keyspace-Werte. Diese Keyspaces müssen bei der Installation für die Replikation festgelegt werden, aber nicht zur Laufzeit. Durch das Entfernen der Replikation wird auch Cassandra-Speicherplatz gespart.

Sie müssen diesen Schritt nur einmal auf einem beliebigen Cassandra-Server in einem der beiden Rechenzentren ausführen:
1. Starten Sie das Cassandra-Dienstprogramm „cqlsh“:
  > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
2. Führen Sie die folgenden CQL-Befehle aus, um die Replikationsstufen für Cassandra-Schlüsselbereiche festzulegen:
  1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
  2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
  3. Rufen Sie die Schlüsselbereiche mit dem folgenden Befehl auf:
    cqlsh> select * from system.schema_keyspaces;
  4. Beenden Sie cqlsh:
    cqlsh> exit

Die Installation des zweiten Rechenzentrums ist jetzt abgeschlossen.

Nachdem Sie die Installation und Konfiguration der beiden Rechenzentren abgeschlossen haben, können Sie die Installation mit dem folgenden Verfahren validieren:

Prüfen Sie auf allen BaaS-Stack-Knoten den Status:
> curl 0:8080/status
Prüfen Sie, ob der API-Aufruf des Tokens funktioniert:
> curl -X POST "http://localhost:8080/management/token" -d '{"grant_type":"password", "username":"adminEmail","password":"pWord"}'
Versuchen Sie, sich im BaaS-Portal für dc-2 anzumelden. Prüfen Sie, ob alle Daten in dc-2 repliziert werden, z. B. Sammlungen, die in dc-1 erstellt wurden.