Diese Seite wurde von der Cloud Translation API übersetzt.

Installation mehrerer Rechenzentren für API BaaS

Edge for Private Cloud v4.18.01

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

Rechenzentrum hinzufügen, wenn der Cassandra-Cluster für Edge freigegeben ist

Alle Rechenzentren müssen die gleiche Anzahl von Cassandra-Knoten haben. Eine API-BaaS-Installation kann ihren 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 Verwaltungsserver im ursprünglichen Rechenzentrum aktualisieren, um ihn so zu konfigurieren, dass er die Cassandra-Knoten im neuen Rechenzentrum erkennt.

Vorhandenes Rechenzentrum aktualisieren

Wenn Sie ein neues BaaS-Rechenzentrum (Rechenzentrum 2) hinzufügen, müssen Sie nicht nur die Schritte zur Installation und Konfiguration des neuen Rechenzentrums ausführen, sondern auch das ursprüngliche BaaS-Rechenzentrum (Rechenzentrum 1) aktualisieren. Diese Änderungen sind erforderlich, weil:

Sie fügen dem neuen Rechenzentrum neue Cassandra-Knoten hinzu, auf die das vorhandene Rechenzentrum zugreifen muss.
Sie müssen die Replikationsinformationen konfigurieren, die von den BaaS-Stack-Knoten in Rechenzentrum 1 verwendet werden, um Informationen aus Rechenzentrum 2 zu enthalten. Diese Konfiguration ist erst möglich, wenn das Rechenzentrum 2 installiert ist.

Um diese Updates in Rechenzentrum 1 auszuführen, aktualisieren Sie die ursprüngliche Konfigurationsdatei, mit der Rechenzentrum 1 installiert wurde, und führen Sie dann apigee-setup noch einmal auf den Cassandra-Knoten von Rechenzentrum 1 aus. Wenn der Cassandra-Cluster für Rechenzentrum 1 mit einer Edge-Installation geteilt wird, müssen Sie auch den Verwaltungsserver aktualisieren.

Konfigurationsdateien erstellen

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

Im Folgenden sehen Sie die Konfigurationsdateien für Rechenzentrum 2. Diese Konfigurationsdatei geht davon aus, 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.

Die Konfigurationsdatei für Rechenzentrum 2 (dc-2) enthält Informationen zu Rechenzentrum 1 (dc-1):

# 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
SMTPMAILFROM="My Company <myco@company.com>"

BaaS-Rechenzentrum hinzufügen

Installieren Sie das erste Rechenzentrum wie unter API BaaS-Installation beschrieben. Dieses Dokument enthält die Konfigurationsdatei, mit der Sie Rechenzentrum 1 installieren.
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-Hilfsprogramm apigee-setup auf dem ersten Cassandra-Knoten von dc-2, Maschine 8, über das Internet oder ohne Internetverbindung. Weitere Informationen finden Sie unter Installieren Sie das Hilfsprogramm für das Edge-Apigee-Setup.
2. Führen Sie an der Eingabeaufforderung das Einrichtungsskript 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 die Installation von Cassandra angegeben.
  
  Der Nutzer „apigee“ muss auf die Konfigurationsdatei zugreifen oder sie lesen können.
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. Berücksichtigen Sie dabei, wie Sie Cassandra installiert haben:

# dc-1-Knoten zuerst, dann dc-2,
# einschließlich Cassandra-Rechenzentrums- und 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 gemeinsam genutzt wird, fügen Sie die dc-2-Cassandra-Knoten der Konfigurationsdatei für den Verwaltungsserverknoten 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 beiden Rechenzentren ausführen:

Hinweis: Mit den folgenden Befehlen wird der Replikationsfaktor auf „3“ festgelegt, was drei Cassandra-Knoten im Cluster bedeutet. Ä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 Replikationsebenen 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. cqlsh beenden:
    cqlsh> exit
Führen Sie auf allen Cassandra-Knoten in dc-2 den Befehl zur Neuerstellung aus und geben Sie dabei den Namen der Region 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
BaaS in dc-2 installieren:
1. Bearbeiten Sie die Konfigurationsdatei so, dass nur die Cassandra-Knoten in dc-2 aufgeführt werden:
  # dc-2 Cassandra-Knoten auflisten, ohne Cassandra-Rechenzentrum und 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 Computer 7:
  > /opt/apigee/apigee-setup/bin/setup.sh -p p -f configFile
BaaS-Stack-Knoten im Rechenzentrum 1 aktualisieren:
1. Bearbeiten Sie auf dem ersten BaaS-Stack-Knoten im Rechenzentrum 1 /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 Eigenschaften hinzu:
  # Same value as BAAS_CLUSTER_SEEDS in the dc-2 config file,
  # without double quotes.
  usergrid-deployment_usergrid.cluster.seeds=dc-1:dc1StackIP1,dc-1:dc1StackIP2,dc-2:dc2StackIP1,dc-2:dc2StackIP2
  
  # Gleicher Wert wie BAAS_CASS_DC_LIST in der Konfigurationsdatei für dc-2.
  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 der Reihenfolge, in der sie in BAAS_CLUSTER_SEEDS aufgeführt sind. In BAAS_CLUSTER_SEEDS sind höchstens zwei der Stack-Knoten aufgeführt. Nachdem Sie die beiden Knoten der Reihe nach neu gestartet haben, können Sie die verbleibenden Knoten in beliebiger Reihenfolge neu starten.
  
  > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid neustart
Aktualisieren Sie die Werte des BaaS-Schlüsselbereichs. Diese Schlüsselbereiche 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.

?Diesen Schritt müssen Sie nur einmal auf einem beliebigen Cassandra-Server in einem der beiden Rechenzentren ausführen:
1. Starten Sie das Dienstprogramm Cassandra 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. Mit dem Befehl
    lassen sich die Schlüsselräume aufrufen:cqlsh> select * from system.schema_keyspaces;
  4. cqlsh beenden:
    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 prüfen:

Prüfen Sie den Status auf allen BaaS-Stack-Knoten:
> 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 auf dc-1 erstellt wurden.