Neue Edge-Benutzeroberfläche konfigurieren

In diesem Dokument wird beschrieben, wie Sie die neue Edge-Benutzeroberfläche für Apigee Edge for Private Cloud installieren und konfigurieren. In Version 4.54.00 besteht die neue Edge-Benutzeroberfläche aus zwei RPM-Komponenten:

  • edge-management-ui: Der Backend-Server der neuen Edge-Benutzeroberfläche.
  • edge-management-ui-static: Die statischen Web-Assets für das Front-End der neuen Edge-Benutzeroberfläche.

Die neue Edge-Benutzeroberfläche wird standardmäßig installiert, wenn Sie setup.sh mit dem aio (All-in-one), sa (Standalone) oder ms (Management Server) Profil ausführen. Sie kann auch unabhängig auf einem Knoten mit dem ue Profil installiert werden.

Vorbereitung

Bevor Sie die neue Edge-Benutzeroberfläche in einer Apigee Edge for Private Cloud-Installation installieren oder konfigurieren, prüfen Sie, ob der Knoten die folgenden Anforderungen erfüllt:

  • Hardware- und Betriebssystemanforderungen:
  • Authentifizierung:
    • Basisauthentifizierung (Standard): Standardmäßig aktiviert (AUTH_MODE=basic). Verwendet die Anmeldedaten des Edge Management Server und von SymasLDAP, ohne dass ein externer Identitätsanbieter (IDP) erforderlich ist.
    • SSO / externer IDP (optional): Sie können optional Apigee SSO oder einen externen IDP (z. B. SAML oder OIDC) konfigurieren. Wenn Sie über TLS eine Verbindung zu einem externen IDP herstellen, muss Ihr IDP TLS v1.2 oder höher unterstützen.

Weitere Informationen zu den Funktionen der neuen Edge-Benutzeroberfläche finden Sie unter Die neue Edge-Benutzeroberfläche für Private Cloud.

Übersicht über Installation und Konfiguration

Im Allgemeinen sieht der Prozess zum Installieren oder Neukonfigurieren der neuen Edge-Benutzeroberfläche mit dem ue Profil so aus:

  • Prüfen Sie, ob das Dienstprogramm apigee-setup auf dem Knoten installiert ist.
  • Erstellen Sie eine Konfigurationsdatei für die unbeaufsichtigte Installation und ändern Sie sie mit Ihren Einstellungen.
  • Führen Sie /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile aus. Dadurch werden sowohl edge-management-ui als auch edge-management-ui-static installiert und konfiguriert.
  • Melden Sie sich unter http://new_edge_UI_IP:3001 an und testen Sie die neue Edge-Benutzeroberfläche.

Wenn sich Ihr Management Server und der Server der neuen Edge-Benutzeroberfläche hinter einem Load-Balancer befinden, bei dem TLS-Offloading auf dem Load-Balancer erfolgt, müssen die Konfigurationseinstellungen die Eigenschaften widerspiegeln, die unter Die neue Edge-Benutzeroberfläche konfigurieren, wenn TLS-Terminierung auf dem Load-Balancer erfolgt beschrieben sind.

Konfigurationsdatei der neuen Edge-Benutzeroberfläche

Das folgende Beispiel zeigt eine Konfigurationsdatei zum Installieren und Konfigurieren der neuen Edge-Benutzeroberfläche mit der Standard-Basisauthentifizierung.

Konfiguration der Basisauthentifizierung (Standard)

# IP of the Edge Management Server.
IP1=management_server_IP

# IP of the New Edge UI node (can be the same as IP1 or a separate node).
IP2=new_edge_UI_server_IP

# Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password    # If omitted, you are prompted for it.

# Edge Management Server information.
APIGEE_PORT_HTTP_MS=8080
MSIP=$IP1
MS_SCHEME=http

#
# New Edge UI configuration.
#
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_IP=$IP2
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_SCHEME=http
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

# Authentication mode (basic is default)
AUTH_MODE=basic

## SMTP Configuration
SKIP_SMTP=n       # Skip now and configure later by specifying "y".
SMTPHOST=smtp.example.com
SMTPUSER=your@email.com
SMTPPASSWORD=your_email_password
SMTPSSL=y
SMTPPORT=465      # If no SSL, use a different port, such as 25.
SMTPMAILFROM="My Company <myco@company.com>"

Neue Edge-Benutzeroberfläche installieren oder konfigurieren

So installieren oder konfigurieren Sie die neue Edge-Benutzeroberfläche mit dem Profil ue:

  1. Melden Sie sich als Administrator auf dem Zielknoten an.
  2. Installieren Sie die Version 4.54.00 des Dienstprogramms apigee-setup auf dem Knoten, wie unter Das Edge-Dienstprogramm „apigee-setup“ installieren beschrieben.
  3. Löschen Sie alle im Cache gespeicherten Informationen mit Yum, indem Sie den folgenden Befehl ausführen: 
    sudo yum clean all
  4. Erstellen Sie die Konfigurationsdatei wie unter Neue Edge UI-Konfigurationsdatei beschrieben und prüfen Sie, ob sie dem Nutzer „apigee“ gehört: 
    chown apigee:apigee configFile
  5. Führen Sie auf dem Knoten den folgenden Befehl aus: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile

    Das apigee-setup Dienstprogramm installiert und konfiguriert edge-management-ui und edge-management-ui-static.

  6. Melden Sie sich in der neuen Edge-Benutzeroberfläche an, indem Sie die folgende URL in einem Browser öffnen: 
    http://new_edge_UI_IP:3001

    Dabei ist new_edge_UI_IP die IP-Adresse oder der Hostname des Knotens, auf dem die neue Edge Benutzeroberfläche gehostet wird.

  7. Geben Sie Ihre Anmeldedaten ein.

    Die neue Edge-Benutzeroberfläche wird angezeigt. Informationen zur Verwendung der neuen Edge-Benutzeroberfläche finden Sie unter Die neue Edge-Benutzeroberfläche für Private Cloud.

    Wenn die neue Edge-Benutzeroberfläche nicht angezeigt wird, prüfen Sie, ob Port 3001 für Verbindungen geöffnet ist.

Optional: Wenn Sie Apigee SSO für die Authentifizierung konfigurieren möchten, folgen Sie der Anleitung unter Apigee SSO installieren und konfigurieren und Externen IDP auf der neuen Edge-Benutzeroberfläche aktivieren.

Neue Edge-Benutzeroberfläche deinstallieren

Wenn Sie die neue Edge-Benutzeroberfläche von einem Knoten deinstallieren möchten, deinstallieren Sie sowohl die edge-management-ui als auch die edge-management-ui-static Komponenten.

So deinstallieren Sie die Komponenten der neuen Edge-Benutzeroberfläche:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static uninstall

So entfernen Sie alle Edge-Komponenten vom Knoten:

  1. Beenden Sie alle Edge-Dienste, die auf dem Computer ausgeführt werden: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  2. Leeren Sie den Yum-Cache: 
    sudo yum clean all
  3. Entfernen Sie alle Apigee-RPMs: 
    sudo rpm -e $(rpm -qa | egrep "(apigee-|edge-)")
  4. Entfernen Sie das Installationsstammverzeichnis: 
    sudo rm -rf /opt/apigee