Edge Microgateway installieren

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation
weitere Informationen

Edge Microgateway Version 2.3.x

Zielgruppe

Verwenden Sie diese Anleitung, wenn Sie Edge Microgateway installieren oder deinstallieren müssen.

Voraussetzungen

  • Auf Ihrem System muss Node.js Version 4.5 LTS oder höher installiert sein. Weitere Node.js-Anleitungen finden Sie unten.
  • Für Windows muss OpenSSL installiert und dem PATH hinzugefügt werden.
  • Wenn Sie Apigee Edge Private Cloud für die Konfiguration mit Edge Microgateway verwenden, müssen Sie Private Cloud Version 4.15.07 oder höher ausführen.

Node.js installieren

Auf Ihrem System muss Node.js Version 4.5 oder höher installiert sein. Dies können Sie so prüfen:

node -v

Es gibt viele Möglichkeiten, Node.js abzurufen oder zu aktualisieren. Sie können beispielsweise HomeBrew oder yum verwenden oder sie direkt von der Node.js-Website herunterladen: https://nodejs.org/download.

Edge Microgateway installieren, wenn eine Internetverbindung besteht

In diesem Abschnitt wird erläutert, wie Sie Edge Microgateway installieren und eine Standardkonfiguration initialisieren.

  1. Installieren Sie mit dem folgenden Befehl die neueste Version von Edge Microgateway mit npm. Mit diesem Befehl wird die Software installiert und die ausführbare edgemicro-Datei in Ihren Pfad eingefügt. Informationen dazu, wo genau Edge Microgateway durch den folgenden Befehl installiert wird, finden Sie unter Wo ist Edge Microgateway installiert?.
    npm install edgemicro -g
    

    Wenn Sie eine bestimmte Version von Edge Microgateway installieren, müssen Sie im Installationsbefehl die Versionsnummer angeben. Wenn Sie keine Versionsnummer angeben, wird die neueste Version installiert. Verwenden Sie beispielsweise den folgenden Befehl, um Version 2.3.1 zu installieren.

    npm install edgemicro@2.3.1 -g
    
  2. Prüfen Sie die Versionsnummer. Wenn Sie beispielsweise Version 2.3.5 installiert haben:
    edgemicro --version
    current nodejs version is v6.1.0
    current edgemicro version is 2.3.5
    
  3. Führen Sie diesen Befehl aus, um eine Standardkonfigurationsdatei im Basisverzeichnis zu erstellen.
    edgemicro init
    
  4. (Optional) Eine Konfigurationsdatei namens default.yaml wurde in Ihrem Basisverzeichnis in einem Unterverzeichnis namens .edgemicro abgelegt. Prüfen Sie jetzt, ob diese Datei vorhanden ist:
    ls ~/.edgemicro
    default.yaml
    

    Hinweis: In der Edge Microgateway-Dokumentation beziehen wir uns mit der Tilde (~) auf das Basisverzeichnis. Dies ist ein UNIX-Tastenkürzel. Wenn Sie unter Windows eine Shell ausführen, die die Tilde nicht unterstützt, müssen Sie in Befehlen, die auf das Basisverzeichnis verweisen, die entsprechende Umgebungsvariable für die Tilde ersetzen. Beispiel: %USERPROFILE%/.edgemicro.

  5. Führen Sie die Schritte unter Edge Microgateway installieren aus.

Edge Microgateway unter Windows als Dienst ausführen

Sie können Edge Microgateway unter Windows als Dienst ausführen. Weitere Informationen finden Sie in der Apigee-Community unter Best Practices for Operational Management of Microgateway (edgemicro) on Windows (Best Practices für die operative Verwaltung von Microgateway (edgemicro) unter Windows).

Kann ich Edge Microgateway ohne Internetverbindung installieren?

Auf Websites, die keinen geeigneten Internetzugang haben, kann ein Administrator eine private npm-Registry in Ihrem internen Netzwerk installieren und verwalten. Eine Anleitung zum Einrichten einer privaten npm-Registry wird in diesem Leitfaden nicht behandelt. Sie können aber nach hilfreichen Anleitungen suchen. Wenn eine private npm-Registry installiert ist, können Sie der oben angegebenen Installationsanleitung folgen.

Erste Schritte

Wenn Sie Edge Microgateway noch nicht kennen, empfehlen wir Ihnen, nach der Installation mit Edge Microgateway installieren zu beginnen. Die Einrichtungs- und Konfigurationsanleitung deckt alle Schritte ab, die Sie zum Installieren, Konfigurieren, Starten und Verwenden einer Instanz von Edge Microgateway ausführen müssen.

Wo wird Edge Microgateway installiert?

Wenn Sie npm mit der globalen Option (npm install -g edgemicro) verwenden, wird die Software in [prefix]/lib/node_modules/edgemicro installiert. Mit dem folgenden Befehl ermitteln Sie den Wert von [prefix]:

npm config get prefix

Der Wert von [prefix] ist konfigurierbar. Weitere Informationen finden Sie unter npm-folders.

Edge Microgateway deinstallieren

Wenn Sie Edge Microgateway entfernen müssen:

  1. Löschen oder archivieren Sie das Installationsverzeichnis [prefix]/lib/node_modules/edgemicro, wobei [Präfix] das npm-Präfix ist, wie unter Wo wird Edge Microgateway installiert erläutert?
  2. Löschen oder archivieren Sie die Protokolldateien. Standardmäßig befinden sich edgemicro-*.log-Dateien in /var/tmp/, aber dieser Speicherort ist konfigurierbar. Prüfen Sie im Zweifelsfall die Konfigurationsdatei, wie unter Logdateien verwalten erläutert.
  3. Löschen oder archivieren Sie die Laufzeitkonfigurationsdatei und speichern Sie die Konfigurationsdateien im Cache:
    ~/.edgemicro/*.yaml