Edge-Dienstprogramm für Apigee-Setup installieren

Edge for Private Cloud v. 4.16.09

Wenn Sie Edge auf einem Knoten installieren möchten, müssen Sie zuerst das Edge-Dienstprogramm „apigee-setup“ installieren. Wenn Sie sich in einer Umgebung befinden, in der Ihre Knoten keine externe Internetverbindung haben, müssen Sie auch eine lokale Kopie des Apigee-Repositorys installieren.

Symlink von /opt/apigee erstellen

Edge installiert alle Dateien im Verzeichnis /opt/apigee. Sie können dieses Verzeichnis nicht ändern. Bei Bedarf können Sie jedoch einen symbolischen Link erstellen, um /opt/apigee einem anderen Speicherort zuzuordnen.

Bevor Sie den symbolischen Link erstellen, müssen Sie zuerst einen Nutzer und eine Gruppe mit dem Namen „apigee“ erstellen. Dies ist dieselbe Gruppe und derselbe Nutzer, die vom Edge-Installationsprogramm erstellt wurden.

Führen Sie die folgenden Schritte aus, bevor Sie die Datei bootstrap_4.16.09.sh herunterladen, um den symbolischen Link zu erstellen. Sie müssen alle diese Schritte als Root ausführen:

  1. Erstellen Sie den Nutzer und die Gruppe „apigee“:
    > groupadd -r apigee
    > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee
  2. Erstellen Sie einen Symlink von /opt/apigee zum gewünschten Installationsstammverzeichnis:
    > ln -Ts /srv/myInstallDir /opt/apigee
    Dabei ist /srv/myInstallDir der gewünschte Speicherort der Edge-Dateien.
  3. Ändern Sie die Eigentümerschaft des Installationsstammverzeichnisses und des Symlinks in den Nutzer „apigee“:
    > chown -h apigee:apigee /srv/myInstallDir /opt/apigee

Voraussetzung: SELinux deaktivieren

Sie müssen SELinux deaktivieren oder in den Modus „Permissive“ versetzen, bevor Sie das Edge-Dienstprogramm apigee-setup oder Edge-Komponenten installieren können. Nach der Installation von Edge können Sie SELinux bei Bedarf wieder aktivieren.

  • Führen Sie den folgenden Befehl aus, um SELinux vorübergehend auf den Modus „permissive“ festzulegen:
    1. Auf einem Linux 6.x-Betriebssystem:
      echo 0 > /selinux/enforce

      So aktivieren Sie SELinux nach der Installation von Edge wieder:
      echo 1 > /selinux/enforce
    2. Auf einem Linux 7.x-Betriebssystem:
      setenforce 0

      So aktivieren Sie SELinux nach der Installation von Edge wieder:
      setenforce 1
  • So deaktivieren Sie SELinux dauerhaft oder legen den Modus „Permissive“ fest:
    1. Öffnen Sie /etc/sysconfig/selinux in einem Editor.
    2. Legen Sie SELINUX=disabled oder SELINUX=permissive fest.
    3. Speichern Sie die Änderungen.
    4. Starten Sie den Knoten neu.
    5. Aktivieren Sie SELinux nach der Edge-Installation bei Bedarf wieder, indem Sie dieses Verfahren wiederholen, um SELINUX=enabled festzulegen.

Edge-Dienstprogramm „apigee-setup“ auf einem Knoten mit einer externen Internetverbindung installieren

So installieren Sie Edge auf einem Knoten mit einer externen Internetverbindung:

  1. Rufen Sie den Nutzernamen und das Passwort von Apigee ab, mit denen Sie auf das Apigee-Repository zugreifen. Wenn Sie bereits einen Nutzernamen und ein Passwort für die Apigee-FTP-Website haben, können Sie diese Anmeldedaten verwenden.
  2. Melden Sie sich als Root auf Ihrem Knoten an, um die Edge-RPMs zu installieren.
    Hinweis: Für die RPM-Installation ist Root-Zugriff erforderlich. Die Edge-Konfiguration können Sie jedoch ohne Root-Zugriff durchführen.
  3. Deaktivieren Sie SELinux wie oben beschrieben.
  4. Laden Sie die Edge-Datei bootstrap_4.16.09.sh in /tmp/bootstrap_4.16.09.sh herunter:
    > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  5. Installieren Sie das Edge-Dienstprogramm „apigee-service“ und die Abhängigkeiten:
    > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

    Dabei sind uName:pWord der Nutzername und das Passwort, die Sie von Apigee erhalten haben. Wenn Sie pWord weglassen, werden Sie aufgefordert, es einzugeben.

    Standardmäßig prüft das Installationsprogramm, ob Java 1.8 installiert ist. Andernfalls wird es für Sie installiert. Verwenden Sie die Option JAVA_FIX, um anzugeben, wie die Java-Installation gehandhabt werden soll. JAVA_FIX nimmt die folgenden Werte an:

    I = OpenJDK 1.8 installieren (Standard)
    C = Ohne Installation von Java fortfahren
    Q = Beenden. Bei dieser Option müssen Sie Java selbst installieren.

    Bei der Installation des apigee-service-Dienstprogramms wird die Datei /etc/yum.repos.d/apigee.repo erstellt, die das Apigee-Repository definiert. Verwenden Sie den folgenden Befehl, um die Definitionsdatei aufzurufen:
    > cat /etc/yum.repos.d/apigee.repo

    Verwenden Sie den folgenden Befehl, um den Inhalt des Repositorys aufzurufen:
    > sudo yum -v repolist 'apigee*'
  6. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu installieren:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. Verwenden Sie apigee-setup, um Edge-Komponenten auf dem Knoten zu installieren und zu konfigurieren. Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren.

Edge-Dienstprogramm „apigee-setup“ auf einem Knoten ohne externe Internetverbindung installieren

Wenn sich Ihre Edge-Knoten hinter einer Firewall befinden oder auf andere Weise nicht über das Internet auf das Apigee-Repository zugreifen können, müssen Sie ein lokales Repository oder einen Spiegel des Apigee-Repositorys erstellen. Dieser Spiegel muss dann für alle Knoten zugänglich sein. Nach der Erstellung können Knoten auf diesen lokalen Spiegel zugreifen, um Edge zu installieren.

Hinweis: Apigee hostet nicht alle Abhängigkeiten von Drittanbietern in unseren öffentlichen Repositories. Sie müssen diese Abhängigkeiten aus öffentlich zugänglichen Repositories herunterladen und installieren.

Nachdem Sie ein lokales Edge-Repository erstellt haben, müssen Sie es möglicherweise später mit den neuesten Edge-Release-Dateien aktualisieren. In den folgenden Abschnitten wird beschrieben, wie Sie ein lokales Repository erstellen und aktualisieren.

Lokales Apigee-Repository erstellen

So erstellen Sie ein lokales Apigee-Repository:

  1. Rufen Sie den Nutzernamen und das Passwort von Apigee ab, mit denen Sie auf das Apigee-Repository zugreifen. Wenn Sie bereits einen Nutzernamen und ein Passwort für die Apigee-FTP-Website haben, können Sie diese Anmeldedaten verwenden.
  2. Melden Sie sich als Root-Nutzer auf Ihrem RedHat- oder CentOS-Knoten an, um die Edge-RPMs zu installieren.
    Hinweis: Für die RPM-Installation ist Root-Zugriff erforderlich. Die Edge-Konfiguration kann jedoch ohne Root-Zugriff durchgeführt werden.
  3. Prüfen Sie, ob Sie die aktuelle Version von yum-utils haben:
    > sudo yum update yum-utils
  4. Deaktivieren Sie SELinux wie oben beschrieben.
  5. Laden Sie die Edge-Datei bootstrap_4.16.09.sh in /tmp/bootstrap_4.16.09.sh herunter:
    > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  6. Installieren Sie das Edge-Dienstprogramm apigee-service und die Abhängigkeiten:
    > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

    Dabei sind uName:pWord der Nutzername und das Passwort, die Sie von Apigee erhalten haben. Wenn Sie pWord weglassen, werden Sie aufgefordert, es einzugeben.
  7. Installieren Sie das Dienstprogramm apigee-mirror auf dem Knoten:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

    Hinweis: Wenn Sie ein vorhandenes Repository auf 4.16.09 aktualisieren, müssen Sie nur apigee-mirror aktualisieren:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  8. Verwenden Sie das Dienstprogramm apigee-mirror, um das Apigee-Repository mit dem Verzeichnis /opt/apigee/data/apigee-mirror/repos/ zu synchronisieren.

    Um die Größe des Repositorys zu minimieren, fügen Sie --only-new-rpms hinzu, um nur die neuesten RPMs herunterzuladen. Für den Download benötigen Sie etwa 1, 6 GB Speicherplatz:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Wenn Sie das gesamte Repository einschließlich älterer RPMs herunterladen möchten, lassen Sie --only-new-rpms weg. Für den vollständigen Download benötigen Sie etwa 6 GB Speicherplatz:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

    Sie haben jetzt eine lokale Kopie des Apigee-Repositorys. Im nächsten Abschnitt wird beschrieben, wie Sie das Edge-Dienstprogramm apigee-setup aus dem lokalen Repository installieren.
  9. (Optional) Wenn Sie Edge aus dem lokalen Repository auf demselben Knoten installieren möchten, auf dem das lokale Repository gehostet wird, müssen Sie zuerst die folgenden Befehle ausführen:
    1. Führen Sie bootstrap_4.16.09.sh aus dem lokalen Repository aus, um das Dienstprogramm apigee-service zu installieren:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
    2. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu installieren:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    3. Verwenden Sie apigee-setup, um Edge-Komponenten auf dem Knoten zu installieren und zu konfigurieren. Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren.

apigee-setup auf einem Remote-Knoten aus dem lokalen Repository installieren

Sie haben zwei Möglichkeiten, Edge aus dem lokalen Repository zu installieren. Du hast folgende Möglichkeiten:

  • Erstellen Sie eine TAR-Datei des Repositorys, kopieren Sie die TAR-Datei auf einen Knoten und installieren Sie Edge dann aus der TAR-Datei.
  • Installieren Sie einen Webserver auf dem Knoten mit dem lokalen Repository, damit andere Knoten darauf zugreifen können. Apigee stellt den Nginx-Webserver zur Verfügung, den Sie verwenden können, oder Sie können Ihren eigenen Webserver verwenden.

Installieren Sie die TAR-Datei:

  1. Verwenden Sie auf dem Knoten mit dem lokalen Repository den folgenden Befehl, um das lokale Repository in einer einzelnen TAR-Datei mit dem Namen /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz zu verpacken:

    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. Kopieren Sie die TAR-Datei auf den Knoten, auf dem Sie Edge installieren möchten. Kopieren Sie sie beispielsweise in das Verzeichnis /tmp auf dem neuen Knoten.
  3. Deaktivieren Sie SELinux auf dem neuen Knoten, wie oben beschrieben.
  4. Entpacken Sie die Datei auf dem neuen Knoten in das Verzeichnis /tmp:
    > tar -xzf apigee-4.16.09.tar.gz

    Mit diesem Befehl wird ein neues Verzeichnis mit dem Namen „repos“ in dem Verzeichnis erstellt, das die TAR-Datei enthält. Beispiel: /tmp/repos.
  5. Installieren Sie das Edge-Dienstprogramm „apigee-service“ und die Abhängigkeiten aus /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Beachten Sie, dass Sie in diesem Befehl den Pfad zum Repository-Verzeichnis angeben.
  6. Verwenden Sie apigee-service, um das Dienstprogramm apigee-setup zu installieren:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  7. Verwenden Sie apigee-setup, um Edge-Komponenten auf dem Knoten zu installieren und zu konfigurieren. Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren.

Installieren Sie den Nginx-Webserver aus dem Repository:

  1. Installieren Sie den Nginx-Webserver auf dem Repo-Knoten:
    > opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
  2. Standardmäßig ist Nginx so konfiguriert, dass localhost als Servername und Port 3939 verwendet wird. So ändern Sie diese Werte:
    1. Öffnen Sie /opt/apigee/customer/application/mirror.properties in einem Editor. Erstellen Sie die Datei, falls sie noch nicht vorhanden ist.
    2. Legen Sie die folgenden Werte nach Bedarf fest:
      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost
    3. Starten Sie Nginx neu:
      > /opt/nginx/scripts/apigee-nginx restart
  3. Standardmäßig erfordert das Repository den Nutzernamen und das Passwort admin:admin. Wenn Sie diese Anmeldedaten ändern möchten, legen Sie die folgenden Umgebungsvariablen fest:
    MIRROR_USERNAME=uName
    MIRROR_PASSWORD=pWord
  4. Deaktivieren Sie SELinux auf dem neuen Knoten, wie oben beschrieben.
  5. Laden Sie auf dem Remote-Knoten die Edge-Datei bootstrap_4.16.09.sh in /tmp/bootstrap_4.16.09.sh herunter:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh

    Dabei sind uName:pWord der Nutzername und das Passwort, die Sie oben für das Repository festgelegt haben, und remoteRepo ist die IP-Adresse oder der DNS-Name des Repository-Knotens.
  6. Installieren Sie auf dem Remote-Knoten das Edge-Dienstprogramm „apigee-service“ und die Abhängigkeiten:
    > sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    Dabei sind uName:pWord der Nutzername und das Passwort des Repositorys.
  7. Verwenden Sie auf dem Remote-Knoten apigee-service, um das Dienstprogramm apigee-setup zu installieren:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. Verwenden Sie apigee-setup, um Edge-Komponenten auf dem Remote-Knoten zu installieren und zu konfigurieren. Weitere Informationen finden Sie unter Edge-Komponenten auf einem Knoten installieren.

Lokales Apigee-Repository aktualisieren

Wenn Sie das Repository aktualisieren möchten, müssen Sie die aktuelle Datei bootstrap_4.16.09.sh herunterladen und dann eine neue Synchronisierung durchführen:

  1. Laden Sie die Edge-Datei „bootstrap_4.16.09.sh“ in /tmp/bootstrap_4.16.09.sh herunter:
    > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
  2. Führen Sie die Edge-Datei bootstrap_4.16.09.sh aus:
    > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

    Dabei sind uName:pWord der Nutzername und das Passwort, die Sie von Apigee erhalten haben. Wenn Sie pWord weglassen, werden Sie aufgefordert, es einzugeben.
  3. Aktualisieren Sie apigee-mirror:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
  4. Führen Sie die Synchronisierung durch:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
  5. Wenn Sie das gesamte Repository herunterladen möchten:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

Lokales Apigee-Repository bereinigen

Durch das Bereinigen des lokalen Repositorys werden /opt/apigee/data/apigee-mirror und /var/tmp/yum-apigee-* gelöscht.

Verwenden Sie Folgendes, um das lokale Repository zu bereinigen:

> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean

Edge 4.16.01/4.16.05 in einem 4.16.09-Repository hinzufügen oder aktualisieren

Wenn Sie Installationen für Edge 4.16.01 und 4.16.05 in einem 4.16.09-Repository verwalten müssen, können Sie ein Repository verwalten, das alle Versionen enthält. Über dieses Repository können Sie dann eine beliebige Version von Edge installieren.

So fügen Sie 4.16.01/4.16.05 zu einem 4.16.09-Repository hinzu:

  1. Prüfen Sie, ob Sie die Version 4.16.09 des Dienstprogramms apigee-mirror installiert haben:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    Sie sollten ein Ergebnis im folgenden Format sehen, wobei xyz die Build-Nummer ist:
    apigee-mirror-4.16.09-0.0.xyz
  2. Verwenden Sie das Dienstprogramm apigee-mirror, um Edge 4.16.01 oder 4.16.05 in Ihr Repository herunterzuladen. Beachten Sie, dass Sie dem Befehl das Präfix apigeereleasever=4.16.01 oder apigeereleasever=4.16.05 voranstellen:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    Verwenden Sie denselben Befehl, um das Repository 4.16.01/4.16.05 später zu aktualisieren.
  3. Prüfen Sie das Verzeichnis /opt/apigee/data/apigee-mirror/repos, um die Dateistruktur zu sehen:
    > ls /opt/apigee/data/apigee-mirror/repos

    Sie sollten die folgenden Dateien und Verzeichnisse sehen:
    apigee apigee-repo-1.0-6.x86_64.rpm bootstrap_4.16.01.sh bootstrap_4.16.05.sh bootstrap_4.16.09.sh thirdparty

    Beachten Sie, dass Sie für alle Versionen von Edge eine Bootstrap-Datei haben. Das Verzeichnis apigee enthält außerdem separate Verzeichnisse für jede Edge-Version.
  4. Verwenden Sie den folgenden Befehl, um das Repository in eine TAR-Datei zu packen:
    > apigeereleasever=4.16.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    Mit diesem Befehl werden sowohl das Repository 4.16.09 als auch das Repository 4.16.01 in dieselbe TAR-Datei gepackt. Sie können nicht nur einen Teil des Repositorys verpacken.

Wenn Sie Edge aus dem lokalen Repository oder der TAR-Datei installieren möchten, müssen Sie die richtige Bootstrap-Datei mit einem der folgenden Befehle ausführen:

  • Wenn Sie die Installation aus einer TAR-Datei durchführen, führen Sie die richtige Bootstrap-Datei aus dem Repository aus:
    > sudo bash /tmp/repos/bootstrap_4.16.0X.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    Führen Sie die verbleibenden Schritte unter „Aus der TAR-Datei installieren“ oben aus, um die Installation abzuschließen.
  • Wenn Sie die Installation mit dem Nginx-Webserver durchführen, laden Sie die richtige Bootstrap-Datei aus dem Repository herunter und führen Sie sie aus:
    > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.0X.sh -o /tmp/bootstrap_4.16.0X.sh
    > sudo bash /tmp/bootstrap_4.16.0X.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    Führen Sie die restlichen Schritte unter „Über das Repository mit dem Nginx-Webserver installieren“ aus, um die Installation abzuschließen.