Edge for Private Cloud Version 4.18.01
Verwenden Sie den Befehl setup-org, um den Onboardingprozess durchzuführen. Sie müssen den Befehl auf dem Knoten des Verwaltungsservers ausführen.
Im Rahmen des Onboardingprozesses führt das Skript folgende Schritte aus:
- Die Organisation wird erstellt.
- Legt den angegebenen Nutzer als Organisationsadministrator fest.
- Dieser Nutzer muss sich vom Systemadministrator unterscheiden. Verwenden Sie also den Systemadministrator nicht als Organisationsadministrator.
- Sie können einen vorhandenen Nutzer als Organisationsadministrator angeben oder das Skript so konfigurieren, dass ein neuer Nutzer erstellt wird.
- Ordnet die Organisation einem Pod zu und ordnet sie standardmäßig dem Pod "gateway" zu.
- Erstellen Sie eine Umgebung.
- Erstellen Sie einen virtuellen Host für die Umgebung.
- Ordnen Sie die Umgebung allen Message Processor(en) zu.
- Aktiviert Analytics.
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“ einschließlich des Pfads zur Datei für die stille Konfiguration an:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
Die einzige Anforderung bei automatischen Installationen besteht darin, dass die Konfigurationsdatei für den „apigee“-Benutzer zugänglich oder lesbar sein muss.
Unten sehen Sie ein Beispiel für eine Konfigurationsdatei im Hintergrund. Bearbeiten Sie ihn 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 Hostalias und optional den Port an, z. B. „myapi.example.com“. Wenn Sie noch keinen DNS-Eintrag haben, können Sie die IP-Adresse des Routers verwenden.
Weitere Informationen zum Konfigurieren des virtuellen Hosts finden Sie unter Virtuellen Host einrichten. - Weitere Informationen zum Erstellen der JAR-Datei und zu anderen Aspekten der Konfiguration von TLS/SSL finden Sie unter Schlüsselspeicher und Truststores und TLS-Zugriff auf eine API für die Private Cloud konfigurieren.
- Weitere Informationen zum Konfigurieren von virtuellen Hosts finden Sie unter TLS-Zugriff auf eine API für die Private Cloud konfigurieren.
Einrichtung
- Installieren Sie apigee-provision auf dem Verwaltungsserverknoten:
> /opt/apigee/apigee-service/bin/apigee-service, apigee-provision-Installation, - 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 sein oder gelesen werden können.
Onboarding-Bestätigung
Prüfen Sie nach Abschluss des Onboardings den Status des Systems. Führen Sie dazu die folgenden CURL-Befehle auf dem Knoten des Verwaltungsservers aus.
- Prüfen Sie den Nutzer- und Organisationsstatus auf dem Management Server mit den folgenden CURL-Befehlen:
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations>/8080/v1/organizations>/8080/v1/organizations>/080/v1/organizations> - Wenn Sie Analytics aktiviert haben, verwenden Sie diesen Befehl:
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/accessibility/axstatus - Sie können auch den PostgreSQL-Datenbankstatus prüfen. Dazu führen Sie den folgenden Befehl auf Maschine 2 aus, 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 anzuzeigen:
apigee=# : . - Greifen Sie über einen Webbrowser auf die Apigee Edge-Benutzeroberfläche zu. Am Ende der Installation haben Sie die URL der Verwaltungskonsole bereits notiert.
- 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 gilt oder für die Maschine, auf der Sie die UI für alternative Konfigurationen installiert haben:
http://192.168.56.111:9000/login
9000 ist die von der UI verwendete Portnummer. Wenn Sie den Browser direkt auf dem Server starten, auf dem die Edge-UI 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. - Geben Sie auf der Anmeldeseite der Console den Nutzernamen/das Passwort des Apigee-Systemadministrators an.
Hinweis: Dies ist das globale Passwort des Systemadministrators, das Sie während der Installation festgelegt haben. Alternativ haben Sie folgende Möglichkeiten:
- 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 gilt oder für die Maschine, auf der Sie die UI für alternative Konfigurationen installiert haben:
- Registrieren Sie sich für ein neues Apigee-Nutzerkonto und verwenden Sie die neuen Nutzeranmeldedaten zur Anmeldung.
- Klicken Sie auf „Anmelden“. Der Browser leitet zu:
http://192.168.56.111:9000/platform/#/<orgname>/
und öffnet ein Dashboard, in dem Sie die zuvor erstellte Organisation konfigurieren können (sofern Sie mit Apigee-Administratoranmeldedaten angemeldet sind). - Wenn Sie Edge noch nicht kennen, 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 zu den beispielhaften RESTful APIs, die Sie in Ihren eigenen Tests zur API-Erstellung unter der Mock Target API verwenden können.
- Klicken Sie auf „Anmelden“. Der Browser leitet zu: