Nach der Installation

Nach einer erfolgreichen Edge-Installation gibt es einige gängige Aufgaben, die Sie möglicherweise ausführen möchten, um die Installation zu validieren, Ihre Einstellungen anzupassen und Ihre Konfiguration anzupassen. Diese Aufgaben umfassen Folgendes:

Dies sind nur einige der häufigsten Aufgaben, die Sie normalerweise nach der Installation von Edge ausführen. Weitere Informationen zu Vorgängen und Verwaltungsaufgaben finden Sie unter Edge konfigurieren und Vorgänge.

Befehle für Edge-Komponenten aufrufen

Edge installiert Verwaltungstools unter /opt/apigee/apigee-service/bin, mit denen Sie eine Edge-Installation verwalten können. Beispielsweise können Sie mit dem Dienstprogramm apigee-all alle Edge-Komponenten auf dem Knoten starten, beenden, neu starten oder ihren Status ermitteln:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

Verwenden Sie das Dienstprogramm apigee-service, um einzelne Komponenten zu steuern und zu konfigurieren. Das Dienstprogramm apigee-service hat folgendes Format:

/opt/apigee/apigee-service/bin/apigee-service component_name action

Dabei gibt component_name die Komponente an. Die Komponente muss sich auf dem Knoten befinden, auf dem Sie apigee-service ausführen. Je nach Konfiguration können die Werte von component_name Folgendes umfassen:

• apigee-cassandra (Cassandra)
• apigee-openldap (OpenLDAP)
• apigee-postgresql (PostgreSQL-Datenbank)
• apigee-qpidd (Qpidd)
• apigee-sso (Edge-SSO)
• apigee-zookeeper (ZooKeeper)
• edge-management-server (Verwaltungsserver)
• edge-management-ui (neue Edge-Benutzeroberfläche)
• edge-message-processor (Nachrichtenprozessor)
• edge-postgres-server (Postgres-Server)
• edge-qpid-server (Qpid-Server)
• edge-router (Edge-Router)
• edge-ui (klassische Benutzeroberfläche)

Zusätzlich zu diesen Komponenten können Sie je nach Konfiguration auch apigee-service für die Komponenten apigee-provision und apigee-validate aufrufen.

Führen Sie beispielsweise den folgenden Befehl aus, um den Edge-Router neu zu starten:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

Sie können die Liste der auf dem Knoten installierten Komponenten ermitteln, indem Sie das Verzeichnis /opt/apigee prüfen. Dieses Verzeichnis enthält ein Unterverzeichnis für jede auf dem Knoten installierte Edge-Komponente. Jedem Unterverzeichnis wird Folgendes vorangestellt:

• apigee: Eine von Edge verwendete Drittanbieterkomponente. Beispiel: apigee-cassandra.
• edge: Eine Edge-Komponente von Apigee. Beispiel: edge-management-server.
• edge-mint: Eine Monetarisierungskomponente. Beispiel: edge-mint-management-server.

Die vollständige Liste der Aktionen für eine Komponente hängt von der Komponente selbst ab. Alle Komponenten unterstützen jedoch die folgenden Aktionen:

• start, stop, restart
• status, version
• backup, restore
• install, uninstall

Edge-Komponenten konfigurieren

Zum Konfigurieren von Edge nach der Installation verwenden Sie eine Kombination aus .properties-Dateien und Edge-Dienstprogrammen. Wenn Sie beispielsweise TLS/SSL in der Edge-Benutzeroberfläche konfigurieren möchten, bearbeiten Sie .properties-Dateien, um die erforderlichen Attribute festzulegen. Wenn Sie Änderungen an .properties-Dateien vornehmen, müssen Sie die betroffene Edge-Komponente neu starten.

Die .properties-Dateien befinden sich im Verzeichnis /opt/apigee/customer/application. Jede Komponente hat in diesem Verzeichnis eine eigene .properties-Datei. Beispiel: router.properties und management-server.properties.

Wenn Sie ein Attribut für eine Komponente festlegen möchten, bearbeiten Sie die entsprechende .properties-Datei und starten Sie die Komponente dann neu:

/opt/apigee/apigee-service/bin/apigee-service component restart

Beispiel:

/opt/apigee/apigee-service/bin/apigee-service edge-router restart

Wenn Sie Edge aktualisieren, werden die .properties-Dateien im Verzeichnis /opt/apigee/customer/application gelesen. Das bedeutet, dass bei der Aktualisierung alle Attribute beibehalten werden, die Sie für die Komponente festgelegt haben.

Weitere Informationen zur Edge-Konfiguration finden Sie unter Edge konfigurieren.

apigee-monit auf dem Knoten installieren

Nachdem Sie die Komponenten auf einem Knoten installiert haben, können Sie optional das Dienstprogramm apigee-monit hinzufügen. apigee-monit überwacht die Komponenten auf dem Knoten und versucht, sie neu zu starten, wenn sie fehlschlagen. Weitere Informationen finden Sie unter Selbstheilung mit apigee-monit.

OpenLDAP-Server als schreibgeschützt konfigurieren

Wenn Ihre Edge-Installation einen OpenLDAP-Server enthält, auf den kein Traffic umgeleitet werden muss, empfehlen wir, den Server als schreibgeschützt zu konfigurieren. Anleitung:

1. Erstellen Sie auf dem Server eine Datei mark_readonly.ldif mit den folgenden Zeilen:

   dn: olcDatabase={2}bdb,cn=config
     changetype: modify
     replace: olcReadOnly
     olcReadOnly: TRUE

2. Führen Sie den folgenden Befehl auf dem Server aus, um ihn als schreibgeschützt zu markieren:

     ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_readonly.ldif

Wenn der primäre Server ausfällt, können Sie den Standby-Server wie folgt wieder als primären Server verwenden:

1. Erstellen Sie auf dem Standby-Server eine Datei mark_writable.ldif mit der folgenden Zeile:

     dn: olcDatabase={2}bdb,cn=config
     changetype: modify
     replace: olcReadOnly
     olcReadOnly: FALSE

2. Führen Sie den folgenden Befehl auf dem Standby-Server aus:

     ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif