BaaS-Installation mit 7 oder 10 Hosts

Edge for Private Cloud v. 4.16.05

Load Balancer verwenden

Bei einer Produktionsinstallation von API BaaS wird ein Load Balancer zwischen dem API BaaS-Portalknoten und den API BaaS-Stack-Knoten verwendet. Bei der Konfiguration des Portals geben Sie die IP-Adresse oder den DNS-Namen des Load Balancers an, nicht die der Stack-Knoten.

Als Alternative zu einem Load Balancer können Sie Round-Robin-DNS verwenden. In diesem Szenario erstellen Sie einen DNS-Eintrag mit mehreren A-Einträgen, die den IP-Adressen des BaaS-Stacks entsprechen. Bei einer DNS-Suche gibt der DNS-Server automatisch A-Eintragswerte im Round-Robin-Verfahren zurück.

Verbindung zu Cassandra herstellen

Bei der Installation von BaaS können Sie BaaS und Edge mit demselben Cassandra-Cluster verbinden oder einen separaten Cassandra-Cluster für BaaS erstellen. Kleinere BaaS-Installationen, d. h. solche mit geringerem Traffic-Volumen, teilen sich häufig einen Cassandra-Cluster mit Edge.

Für einen hohen Durchsatz und eine hohe Verfügbarkeit oder um Cassandra-Cluster in verschiedene Netzwerkzonen aufzuteilen, empfiehlt Apigee die Verwendung separater Cassandra-Cluster. Separate Cluster maximieren die Leistung, wenn Sie hohe Traffic-Lasten auf BaaS haben.

Datumssynchronisierung

Datum und Uhrzeit müssen auf allen Servern synchronisiert sein. Falls noch nicht konfiguriert, kann das Dienstprogramm „ntpdate“ verwendet werden, um zu prüfen, ob die Server zeitsynchronisiert sind. Sie können das Dienstprogramm mit „yum install ntp“ installieren.

Tomcat-Sicherheit

Das API BaaS-Installationsprogramm installiert auch den Apache Tomcat-Server auf allen API BaaS-Stack-Knoten, einschließlich der Tomcat-Administrator-UI. Das Installationsprogramm lässt die Standard-Administratoranmeldedaten unverändert bei admin:admin.

Bei Bedarf können Sie diese Anmeldedaten im Rahmen der Absicherung von Tomcat ändern. Weitere Informationen finden Sie unter:

• https://tomcat.apache.org/tomcat-7.0-doc/manager-howto.html
• https://www.owasp.org/index.php/Securing_tomcat

Installation

Nachdem Sie das Edge-Dienstprogramm apigee-setup auf einem Knoten installiert haben, verwenden Sie dieses Dienstprogramm, um eine oder mehrere BaaS-Komponenten auf dem Knoten zu installieren. Das Dienstprogramm apigee-setup hat folgendes Format:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

Übergeben Sie eine Konfigurationsdatei an das Dienstprogramm apigee-setup, die die Informationen zur Installation enthält. Wenn in der Konfigurationsdatei erforderliche Informationen fehlen, werden Sie vom Dienstprogramm apigee-setup aufgefordert, diese in der Befehlszeile einzugeben.

Die einzige Anforderung ist, dass die Konfigurationsdatei für den Nutzer „apigee“ zugänglich oder lesbar sein muss. Legen Sie die Datei beispielsweise im Verzeichnis „/tmp“ auf dem Knoten ab.

Verwenden Sie beispielsweise den folgenden Befehl, um den API BaaS-Stack zu installieren:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p b -f myConfig

Das Apigee-Dienstprogramm setup.sh unterstützt mehrere Optionen für die Installation von API BaaS-Komponenten. In der folgenden Anleitung werden die eigenständigen Optionen (c, e, b und p) verwendet. Sie können jedoch je nach Knotenkonfiguration andere Optionen verwenden:

Konfigurationsdatei für die unbeaufsichtigte Installation erstellen

Hier sehen Sie eine Beispielkonfigurationsdatei für die unbeaufsichtigte Installation einer API BaaS-Installation mit 10 Knoten. Bearbeiten Sie diese Datei nach Bedarf für Ihre Konfiguration. Verwenden Sie die Option „-f“ für setup.sh, um diese Datei einzubinden.

# Specify IP address or DNS name of node.
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 (shared with Edge or standalone)
IP9=192.168.1.9   # Cassandra (shared with Edge or standalone)
IP10=192.168.1.10  # Cassandra (shared with Edge or standalone)

# 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=stackAdminPWrod

# Only if you are installing Cassandra.
# Specify Cassandra configuration information.
# Must use IP addresses for CASS_HOSTS, not DNS names.
# CASS_HOSTS="$IP8:1,1 $IP9:1,1 $IP10:1,1"

# If connecting to existing Cassandra nodes, 
# specify Cassandra IPs.
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP8 $IP9 $IP10"

# 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.
BAAS_CASS_LOCALDC=dc-1    # Default is dc-1.

# Replication is in the form "dataCenterName:#CassandraNodes". 
# For example, for dc-1 with three Cassandra nodes, it is dc-1:3.
BAAS_CASS_REPLICATION=dc-1:3

# ElasticSearch IPs or DNS names, separated by spaces.
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

Die folgende Tabelle enthält zusätzliche Informationen zu diesen Attributen:

Optional – Cassandra installieren: Maschine 8, 9 und 10

Sie können API BaaS zwar mit demselben Cassandra-Cluster verbinden, der auch von Edge verwendet wird, Apigee empfiehlt jedoch, separate Cluster zu verwenden.

Der Cassandra-Cluster kann die Authentifizierung verwenden oder die Cassandra-Authentifizierung kann deaktiviert sein. Weitere Informationen finden Sie unter Cassandra-Authentifizierung aktivieren.

1. Installieren Sie das Edge-Dienstprogramm apigee-setup auf dem Knoten. Verwenden Sie dazu das Internet- oder Nicht-Internet-Verfahren. Weitere Informationen finden Sie unter Edge-Dienstprogramm „apigee-setup“ installieren.
2. Führen Sie in der Eingabeaufforderung das Setupscript aus:
   > /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
   
   Mit der Option „-p c“ wird Cassandra installiert.
   Die Konfigurationsdatei muss für den Nutzer „apigee“ zugänglich oder lesbar sein. Legen Sie die Datei beispielsweise im Verzeichnis „/tmp“ auf dem Knoten ab.

Die Konfiguration schließt die Datenspeicher-Einrichtung auf dem Knoten ab.

Beachten Sie, dass JMX für Cassandra standardmäßig aktiviert ist. Für den JMX-Remotezugriff auf Cassandra ist kein Passwort erforderlich. Sie können Cassandra so konfigurieren, dass die Authentifizierung für JMX verwendet wird. Weitere Informationen finden Sie unter Monitoring.

Cassandra-Cronjob einrichten

Richten Sie einen Cronjob ein, der nodetool verwendet, um jede Stunde auf jedem Cassandra-Knoten nach Sperren zu suchen.

Wenn Sie mehrere Cassandra-Knoten haben, versetzen Sie den Cronjob auf jedem Server um fünf Minuten, damit nicht alle Knoten gleichzeitig geleert werden.

Der Cronjob muss den folgenden Befehl ausführen:

/opt/apigee/apigee-cassandra/bin/nodetool -h IP_address flush Apigee_Baas_Locks

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

Elasticsearch installieren: Maschine 1, 2 und 3

So installieren Sie ElasticSearch:

1. Installieren Sie das Edge-Dienstprogramm „apigee-setup“ auf dem Knoten mit dem Internet- oder Nicht-Internet-Verfahren. Weitere Informationen finden Sie unter Edge-Dienstprogramm „apigee-setup“ installieren.
2. Führen Sie an der Eingabeaufforderung das Setupscript aus:
   > /opt/apigee/apigee-setup/bin/setup.sh -p e -f configFile
   
   Mit der Option „-p e“ wird ElasticSearch installiert.
   Die Konfigurationsdatei muss für den Nutzer „apigee“ zugänglich oder lesbar sein. Legen Sie die Datei beispielsweise im Verzeichnis „/tmp“ auf dem Knoten ab.
3. (Optional) Wenn Sie ElasticSearch auf einem eigenständigen Knoten installieren, d. h. nicht mit dem API BaaS-Stack, passen Sie die Standard-Arbeitsspeicheroption an, um den für ElasticSearch zugewiesenen Arbeitsspeicher von 4 GB auf 6 GB zu erhöhen:
   1. Öffnen Sie /opt/apigee/customer/application/elasticsearch.properties in einem Editor. Wenn diese Datei nicht vorhanden ist, erstellen Sie sie.
   2. Legen Sie das Attribut setenv_elasticsearch_max_mem_size auf 6g fest (der Standardwert ist 4g):
      setenv_elasticsearch_max_mem_size=6g
   3. Speichern Sie die Datei.
   4. Führen Sie den folgenden Befehl aus:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-elasticsearch restart

Die Konfiguration schließt die Einrichtung auf dem Knoten erfolgreich ab.

API BaaS-Stack installieren: Maschine 4, 5 und 6

So installieren Sie den API BaaS-Stack:

1. Installieren Sie das Edge-Dienstprogramm „apigee-setup“ auf dem Knoten mit dem Internet- oder Nicht-Internet-Verfahren. Weitere Informationen finden Sie unter Edge-Dienstprogramm „apigee-setup“ installieren.
2. Führen Sie an der Eingabeaufforderung das Setupscript aus:
   > /opt/apigee/apigee-setup/bin/setup.sh -p b -f configFile
   
   Die Option „-p b“ gibt an, dass der API BaaS-Stack installiert werden soll.
   Die Konfigurationsdatei muss für den Nutzer „apigee“ zugänglich oder lesbar sein. Legen Sie die Datei beispielsweise im Verzeichnis „/tmp“ auf dem Knoten ab.

Nachdem das Installationsprogramm die richtigen Administrator-Anmeldedaten abgerufen hat, installiert es Tomcat, erstellt API BaaS-Schlüsselbereiche und richtet den API BaaS-Stack auf dem Server ein. SMTP ist außerdem so konfiguriert, dass die Benutzeroberfläche E-Mails zur Passwortbestätigung senden kann.

API BaaS-Portal installieren: Maschine 7

So installieren Sie das API BaaS-Portal:

1. Installieren Sie das Edge-Dienstprogramm „apigee-setup“ auf dem Knoten mit dem Internet- oder Nicht-Internet-Verfahren. Weitere Informationen finden Sie unter Edge-Dienstprogramm „apigee-setup“ installieren.
2. Führen Sie an der Eingabeaufforderung das Setupscript aus:
   > /opt/apigee/setup/bin/setup.sh -p p -f configFile
   
   Mit der Option „-p p“ wird das API BaaS-Portal installiert.
   Die Konfigurationsdatei muss für den Nutzer „apigee“ zugänglich oder lesbar sein. Legen Sie die Datei beispielsweise im Verzeichnis „/tmp“ auf dem Knoten ab.

Das Installationsprogramm startet den Nginx-Webserver und schließt dann die Konfiguration des API BaaS-Portals ab.

Notieren Sie sich die URL des API BaaS-Portals. Dies ist die URL, die Sie in einen Browser eingeben, um auf die Benutzeroberfläche des API BaaS-Portals zuzugreifen.

API BaaS-Knoten für einen Stack- oder Portal-Load-Balancer konfigurieren

Wenn Sie einen Load Balancer vor den Stack- oder Portal-Knoten einfügen, müssen Sie die Knoten mit der richtigen URL des Load Balancers konfigurieren. Die Stack-Knoten benötigen diese Informationen beispielsweise in folgenden Fällen:

• Eine URL in Antworten in BaaS API-Anfragen einfügen.
• Links in E-Mail-Vorlagen hinzufügen, wenn ein Passwort zurückgesetzt oder andere Benachrichtigungen gesendet werden.
• Weiterleitung von Nutzern auf bestimmte Portalseiten.

Wenn Sie einen Load Balancer vor den Stack-Knoten verwenden, legen Sie die folgenden Attribute in /opt/apigee/customer/application/usergrid.properties fest:

usergrid-deployment_swagger.basepath=http://localhost:8080
usergrid-deployment_usergrid.organization.activation.url=http://localhost:8080/management/organizations/%s/activate
usergrid-deployment_usergrid.admin.activation.url=http://localhost:8080/management/users/%s/activate
usergrid-deployment_usergrid.admin.resetpw.url=http://localhost:8080/management/users/%s/resetpw
usergrid-deployment_usergrid.admin.confirmation.url=http://localhost:8080/management/users/%s/confirm
usergrid-deployment_usergrid.user.activation.url=http://localhost:8080/%s/%s/users/%s/activate
usergrid-deployment_usergrid.user.confirmation.url=http://localhost:8080/%s/%s/users/%s/confirm
usergrid-deployment_usergrid.user.resetpw.url=http://localhost:8080/%s/%s/users/%s/resetpw

Ersetzen Sie http://localhost:8080 durch die URL des Load Balancers. Wenn der Load Balancer für die Verwendung von TLS konfiguriert ist, verwenden Sie das HTTPS-Protokoll. Sie müssen den Port nur angeben, wenn Sie einen nicht standardmäßigen Port verwenden, also einen anderen Port als Port 80 für HTTP und Port 443 für HTTPS.

Wenn Sie einen Load Balancer vor den Stack-Knoten verwenden, müssen Sie außerdem das folgende Attribut in /opt/apigee/customer/application/portal.properties festlegen:

baas.portal.config.overrideUrl=http://localhost:8080

Ersetzen Sie http://localhost:8080 durch die URL des Load Balancers für den Stack.

Wenn Sie einen Load Balancer vor dem Portal-Knoten verwenden, legen Sie die folgenden Attribute in usergrid.properties fest:

usergrid-deployment_usergrid.view.management.organizations.organization.activate=http://localhost:9000
usergrid-deployment_usergrid.view.management.organizations.organization.confirm=http://localhost:9000
usergrid-deployment_usergrid.view.management.users.user.activate=http://localhost:9000
usergrid-deployment_usergrid.view.management.users.user.confirm=http://localhost:9000

Ersetzen Sie http://localhost:9000 durch die URL des Load Balancers. Wenn der Load Balancer für die Verwendung von TLS konfiguriert ist, verwenden Sie das HTTPS-Protokoll. Sie müssen den Port nur angeben, wenn Sie einen nicht standardmäßigen Port verwenden, also einen anderen Port als Port 80 für HTTP und Port 443 für HTTPS.

Nachdem Sie usergrid.properties und portal.properties bearbeitet haben:

1. Konfigurieren Sie den Stack-Knoten:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid configure
2. Stellen Sie die Änderungen in Tomcat bereit:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid deploy
3. Starten Sie den BaaS-Stack neu:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid restart
4. Wenn Sie portal.properties geändert haben, konfigurieren Sie den Portalknoten:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portal configure
5. Stellen Sie die Änderungen bereit:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portal deploy
6. Starten Sie das BaaS-Portal neu:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portal restart

Onboarding einer neuen Organisation

Beim Onboarding werden eine Organisation und ein Administrator der Organisation erstellt. Nachdem Sie die Organisation und den Administrator der Organisation erstellt haben, können Sie sich in der API BaaS-Portal-UI anmelden und Anfragen an die API BaaS REST API senden.

Wenn Sie eine Organisation erstellen, gilt für die E-Mail-Adresse des Organisationsadministrators Folgendes:

• Muss sich von der E-Mail-Adresse des Systemadministrators unterscheiden.
• Muss unter allen anderen Organisationen eindeutig sein. Das heißt, Sie können nicht zwei Organisationen mit derselben E-Mail-Adresse für den Administrator der Organisation erstellen. Nachdem Sie die Organisation erstellt haben, können Sie jedoch zusätzliche Administratoren hinzufügen, die in mehreren Organisationen dupliziert werden können.

Verwenden Sie für das Onboarding das Python-Script create_org_and_user.py. Wenn Sie dieses Script ohne Befehlszeilenargumente aufrufen, werden Sie aufgefordert, alle Informationen anzugeben:

> python create_org_and_user.py

Alternativ können Sie eine oder alle Optionen als Befehlszeilenargument übergeben. Sie werden zur Eingabe aller Informationen aufgefordert, die Sie in der Befehlszeile weggelassen haben:

> python create_org_and_user.py -o '<org name>'
> python create_org_and_user.py -o '<org name>' -a '<new admin email>' -p '<new admin password>'

So erstellen Sie eine Organisation:

1. Wechseln Sie in das Verzeichnis opt/apigee/baas-usergrid/bin.
2. Rufen Sie das Python-Script create_org_and_user.py auf.
   Sie werden aufgefordert, den Nutzernamen und das Passwort des BaaS-Systemadministrators einzugeben, damit nur ein Systemadministrator das Skript ausführen kann.
3. Melden Sie sich in einem Webbrowser im API BaaS-Portal mit der URL an, die Sie am Ende der Installation der API BaaS-Portal-URL notiert haben. Geben Sie für den Zugriff auf das Portal die URL des API BaaS-Portals im folgenden Format ein:
   http://{portalExternalIP}:9000/
   
   Hinweis: Die IP-Adresse ist die externe IP-Adresse/der Hostname des Portalcomputers. Achten Sie darauf, dass dieser Port geöffnet ist.
4. Wenn der Anmeldebildschirm des Portals angezeigt wird, haben Sie folgende Möglichkeiten:
   • Melden Sie sich mit dem Nutzernamen und dem Passwort des Administrators der Organisation an.
   • Melden Sie sich mit dem Nutzernamen und dem Passwort des Systemadministrators an.

Auf die API BaaS REST API zugreifen

Verwenden Sie für den Zugriff auf die API BaaS REST API eine URL im folgenden Format:

https://{loadBalancerIP}:8080/{your-org}/{your-app}

In einer Entwicklungsumgebung können Sie alle API BaaS-Komponenten auf einem einzelnen Knoten installieren. Das bedeutet, dass Sie einen einzelnen API BaaS-Stack haben. Oder Sie haben eine kleine Umgebung mit einem einzelnen API BaaS-Stack-Knoten und ohne Load Balancer. In diesen Umgebungen können Sie API-Aufrufe direkt an den API BaaS-Stack-Knoten senden:

curl -v "http://portalExternalIP:8080/status"

Weitere Informationen zu den ersten Schritten mit dem API BaaS-Portal finden Sie in der Apigee-Dokumentation unter: http://apigee.com/docs/content/build-apps-home.