Organisation einrichten

Edge for Private Cloud v. 4.16.09

Führen Sie das Onboarding mit dem Befehl setup-org durch. Sie müssen den Befehl auf dem Management Server-Knoten ausführen.

Im Rahmen des Onboarding-Prozesses führt das Script Folgendes aus:

  • Erstellt die Organisation.
  • Legt den angegebenen Nutzer als Organisationsadministrator fest.
    • Dieser Nutzer muss sich vom Systemadministrator unterscheiden. Verwenden Sie also nicht den SysAdmin-Nutzer als Admin der Organisation.
    • Sie können einen vorhandenen Nutzer als Organisationsadministrator angeben oder das Script so konfigurieren, dass ein neuer Nutzer erstellt wird.
  • Verknüpft die Organisation mit einem Pod. Standardmäßig wird sie mit dem „Gateway“-Pod verknüpft.
  • Erstellen Sie eine Umgebung.
  • Erstellen Sie einen virtuellen Host für die Umgebung.
  • Verknüpfen Sie die Umgebung mit allen Message Processors.
  • Aktiviert Analysen.

Konfigurationsdatei für das Onboarding

Übergeben Sie eine Konfigurationsdatei an den Befehl setup-org. Rufen Sie den Befehl setup-org auf und geben Sie die Option „-f“ an, einschließlich des Pfads zur Konfigurationsdatei für die unbeaufsichtigte Installation:

> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

Die einzige Anforderung an automatische Installationen ist, dass die Konfigurationsdatei für den Nutzer „apigee“ zugänglich oder lesbar sein muss.

Hier sehen Sie eine Beispielkonfigurationsdatei für die unbeaufsichtigte Installation. Bearbeiten Sie sie nach Bedarf:

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge sys admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=adminPassword     # If omitted, you are prompted for it.

# Specify organization name.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

# Specify the organization administrator user.
# Either specify an existing user, or specify the information
# necessary to create a new user.
# Do not use the sys admin as the organization administrator.
#
# Create a new user for the organization administrator. 
NEW_USER="y"
# New user information if NEW_USER="y".
USER_NAME=new@user.com
FIRST_NAME=new
LAST_NAME=user
USER_PWD="newUserPword"
ORG_ADMIN=new@user.com
#
# Or, specify an existing user as the organization admin,
# omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD.
# NEW_USER="n"
# ORG_ADMIN=existing@user.com

# Specify environment name. 
ENV_NAME=prod

# Specify virtual host information.
VHOST_PORT=9001
VHOST_NAME=default

# If you have a DNS entry for the virtual host.
VHOST_ALIAS=myorg-test.apigee.net

# If you do not have a DNS entry for the virtual host, 
# specify the IP and port of each router as a space-separated list:
# VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001" 

# Optionally configure TLS/SSL for virtual host.
# VHOST_SSL=y     # Set to "y" to enable TLS/SSL on the virtual host.
# KEYSTORE_JAR=   # JAR file containing the cert and private key.
# KEYSTORE_NAME=  # Name of the keystore. 
# KEYSTORE_ALIAS= # The key alias.
# KEY_PASSWORD=   # The key password, if it has one. 

# Specify the analytics group. 
# AXGROUP=axgroup-001 # Default name is axgroup-001.

Hinweise:

  • Wenn Sie für VHOST_ALIAS bereits einen DNS-Eintrag haben, den Sie für den Zugriff auf den virtuellen Host verwenden, geben Sie den Host-Alias und optional den Port an, z. B. „myapi.example.com“.

    Wenn Sie noch keinen DNS-Eintrag haben, finden Sie weitere Informationen unter Virtuellen Host einrichten.
  • Weitere Informationen zur TLS/SSL-Konfiguration finden Sie unter Schlüsselspeicher und Truststores und TLS-Zugriff auf eine API für die Private Cloud konfigurieren. Dort finden Sie weitere Informationen zum Erstellen der JAR-Datei und zu anderen Aspekten der TLS/SSL-Konfiguration.

Onboarding

  1. Installieren Sie apigee-provision auf dem Management Server-Knoten:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Führen Sie den Befehl auf dem Management Server-Knoten aus:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    Die Konfigurationsdatei muss für den Nutzer „apigee“ zugänglich oder lesbar sein.

Onboarding-Überprüfung

Prüfen Sie nach Abschluss des Onboardings den Status des Systems, indem Sie die folgenden CURL-Befehle auf dem Management Server-Knoten ausführen.

  1. Prüfen Sie den Nutzer- und Organisationsstatus auf dem Management Server, indem Sie die folgenden CURL-Befehle ausführen:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/deployments
  2. Wenn Sie Analytics aktiviert haben, verwenden Sie diesen Befehl:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus
  3. Sie können den PostgreSQL-Datenbankstatus auch prüfen, indem Sie den folgenden Befehl auf Maschine 2 ausführen, um psql zu starten:
    > psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    Geben Sie an der Eingabeaufforderung den folgenden Befehl ein, um die Analysetabelle für Ihre Organisation aufzurufen:
    apigee=# : \d analytics."<orgname>.prod.fact"

    Verwenden Sie den folgenden Befehl, um psql zu beenden:
    apigee=# \q
  4. Greifen Sie über einen Webbrowser auf die Apigee Edge-Benutzeroberfläche zu. Denken Sie daran, dass Sie die URL der Verwaltungskonsole am Ende der Installation bereits notiert haben.
    1. Starten Sie Ihren bevorzugten Browser und geben Sie die URL der Edge-Benutzeroberfläche ein. Sie sieht in etwa so aus, wobei die IP-Adresse für Maschine 1 oder für die Maschine gilt, auf der Sie die Benutzeroberfläche für alternative Konfigurationen installiert haben:
      http://192.168.56.111:9000/login

      9000 ist die Portnummer, die von der Benutzeroberfläche verwendet wird. Wenn Sie den Browser direkt auf dem Server starten, auf dem die Edge-Benutzeroberfläche gehostet wird, können Sie eine URL im folgenden Format verwenden:
      http://localhost:9000/login

      Hinweis: Achten Sie darauf, dass Port 9000 geöffnet ist.
    2. Geben Sie auf der Anmeldeseite der Konsole den Nutzernamen und das Passwort des Apigee-Systemadministrators an.
      Hinweis: Dies ist das globale Systemadministratorpasswort, das Sie während der Installation festgelegt haben. Alternativ können Sie Folgendes tun:
  5. Registrieren Sie sich für ein neues Apigee-Nutzerkonto und melden Sie sich mit den neuen Nutzeranmeldedaten an.
    1. Klicken Sie auf „Anmelden“. Der Browser leitet Sie zu folgender Seite weiter:
      http://192.168.56.111:9000/platform/#/<orgname>/

      und öffnet ein Dashboard, in dem Sie die zuvor erstellte Organisation konfigurieren können (wenn Sie mit Apigee-Administratoranmeldedaten angemeldet sind).
    2. Wenn Sie neu bei Edge sind, können Sie jetzt Ihren ersten API-Proxy erstellen. Weitere Informationen finden Sie unter Ersten API-Proxy erstellen.

      Sehen Sie sich auch die Abschnitte zu Beispielen an, einschließlich der Beispielliste und der RESTful APIs für simulierte Ziele, die Sie in Ihren eigenen API-Erstellungsexperimenten unter Mock Target API verwenden können.