Edge Microgateway installieren

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zuApigee X wechseln. info

Edge Microgateway, Version 2.4.x

Zielgruppe

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

Vorbereitung

  • Auf Ihrem System muss Node.js Version 4.5 LTS oder höher installiert sein. Weitere Informationen zu Node.js finden Sie unten.
  • Unter Windows muss OpenSSL installiert und dem PATH hinzugefügt werden.
  • Wenn Sie Apigee Edge for Private Cloud verwenden, um Edge Microgateway zu konfigurieren, muss die Private Cloud-Version 4.16.01 oder höher ausgeführt werden.

Node.js installieren

Auf Ihrem System muss Node.js Version 4.5 oder höher installiert sein. Sie können dies mit dem folgenden Befehl prüfen:

node -v

Es gibt viele Möglichkeiten, Node.js zu beziehen oder zu aktualisieren. Sie können beispielsweise HomeBrew oder yum verwenden oder es 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 Standard Konfiguration initialisieren.

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

    Wenn Sie eine bestimmte Version von Edge Microgateway installieren möchten, müssen Sie die Versionsnummer im Installationsbefehls angeben. Wenn Sie die Versionsnummer nicht 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. Beispiel: Wenn Sie 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 in Ihrem Basisverzeichnis zu erstellen. 
    edgemicro init
  4. (Optional) Eine Konfigurationsdatei mit dem Namen default.yaml wurde in Ihrem Basisverzeichnis in einem Unterverzeichnis mit dem Namen .edgemicro platziert. Prüfen Sie jetzt, ob diese Datei vorhanden ist: 
    ls ~/.edgemicro
default.yaml

    Hinweis : In der Edge Microgateway-Dokumentation wird das Basisverzeichnis mit der Tilde (~) bezeichnet. Das ist eine UNIX-Kurzform. Wenn Sie Windows verwenden und eine Shell ausführen, die die Tilde nicht unterstützt, müssen Sie die entsprechende Umgebungsvariable für die Tilde in Befehlen verwenden, die auf das Basisverzeichnis verweisen. Beispiel: %USERPROFILE%/.edgemicro.

  5. Folgen Sie der Anleitung unter Setting up and configuring Edge Microgateway.

Edge Microgateway unter Windows als Dienst ausführen

Sie können Edge Microgateway unter Windows als Dienst ausführen. Weitere Informationen finden Sie im Apigee-Community-Beitrag Best practices for operational management of Microgateway (edgemicro) on Windows.

Kann ich Edge Microgateway auch ohne Internetverbindung installieren?

An Standorten ohne direkten Internetzugang kann ein Administrator eine private `npm` -Registrierung in Ihrem internen Netzwerk installieren und verwalten. Eine Anleitung zum Einrichten einer privaten npm Registrierung würde den Rahmen dieser Anleitung sprengen. Sie können aber nach entsprechenden Anleitungen suchen. Wenn eine private npm Registrierung installiert ist, können Sie der oben beschriebenen Installationsanleitung folgen.

Erste Schritte

Wenn Sie Edge Microgateway noch nicht kennen, ist die Anleitung Edge Microgateway einrichten und konfigurieren der beste Ort, um nach der Installation zu beginnen. Die Einrichtungs- und Konfigurationsanleitung enthält alle Schritte, die Sie ausführen müssen, um eine Instanz von Edge Microgateway zu installieren, zu konfigurieren, zu starten und zu verwenden.

Wo ist 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. Sie können den Wert von [prefix] mit diesem Befehl ermitteln:

npm config get prefix

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

Edge Microgateway deinstallieren

So entfernen Sie Edge Microgateway:

  1. Löschen oder archivieren Sie das Installations verzeichnis [prefix]/lib/node_modules/edgemicro. Dabei ist [prefix] das `npm`-Präfix, wie unter Wo ist Edge Microgateway installiert? erläutert.
  2. Löschen oder archivieren Sie die Logdateien. Standardmäßig befinden sich die Dateien edgemicro-*.log in /var/tmp/. Dieser Speicherort ist jedoch konfigurierbar. Prüfen Sie im Zweifelsfall die Konfigurationsdatei, wie unter "Logdateien verwalten beschrieben."
  3. Löschen oder archivieren Sie die Konfigurationsdateien für die Laufzeit und den Cache: 
    ~/.edgemicro/*.yaml