Installation von Entwicklerdiensten im Portal

Entwicklerdienstportal Version 4.16.09

Prüfen Sie vor der Installation Folgendes:

  • Sie führen die Installation mit der 64-Bit-Version einer unterstützten Version von Red Hat Enterprise Linux, CentOS oder Oracle durch. Hier finden Sie eine Liste der unterstützten Versionen.
  • Yum ist installiert.
  • Sie sichern vorhandene Installationen. Wenn Sie Code im Drupal Core oder in einem nicht benutzerdefinierten Modul geändert haben, werden Ihre Änderungen überschrieben. Dazu gehören unter anderem alle Änderungen, die Sie an .htaccess vorgenommen haben. Sie sollten davon ausgehen, dass alle Inhalte außerhalb des Verzeichnisses /sites zu Drupal gehören. Eine Ausnahme von dieser Regel stellt robots.txt dar. Wenn diese Datei im Webstamm vorhanden ist, wird sie für dich beibehalten. Erstelle eine Sicherung deines gesamten Drupal-Webstammverzeichnisses, bevor du mit der Installation fortfährst. Der standardmäßige Installationspfad ist /var/www/html. Möglicherweise haben Sie ihn aber bereits bei der Installation geändert. Nachdem Sie die unten beschriebenen Installationsschritte ausgeführt haben, können Sie Ihre Anpassungen aus der Sicherung wiederherstellen.

Folgen Sie dieser Anleitung, um das Entwicklerportal für Channeldienste zu installieren.

1. Channel Services-Paket für Entwickler herunterladen

Rufen Sie http://community.apigee.com/content/apigee-customer-support auf und wählen Sie „Login to your Support Portal“ (Im Supportportal anmelden) aus, um die TAR-Datei für Developer Channel Services auf eine der folgenden beiden Arten anzufordern:

  • Zugriff auf das Downloadverzeichnis für Edge für Private Cloud anfordern.
  • Fordern Sie eine URL zur TAR-Datei der Channel Services-Entwicklerversion an.

2. Verbindung zu Apigee Edge testen

Testen Sie die Verbindung zum Edge-Management-Server. Führen Sie dazu den folgenden cURL-Befehl über eine Eingabeaufforderung auf dem Portalserver aus:
> curl -u {EMAIL}:{PASSWORT} https://{hostname}:8080/v1/organizations/{ORGNAME}

Dabei sind EMAIL für die E-Mail-Adresse und das Passwort der ORG-Organisation EMAIL für die E-Mail-Adresse des Administrators für die E-Mail-Adresse und das Passwort für die Organisation EMAIL.

Geben Sie den Hostnamen und die Portnummer für Ihre Edge-Installation an. Port 8080 ist der von Edge verwendete Standardport. Wenn Sie eine Verbindung zu einer Organisation in der Cloud herstellen, lautet die Anfrage-URL: https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}

Wenn erfolgreich, gibt dieser Befehl eine Antwort wie die folgende zurück:
{
"createdAt" : 1348689232699,
"









3. Entfernen von früheren Versionen von PHP

Das Installationsskript prüft das System auf ältere Versionen von PHP, bevor es die Installation startet. Wenn ältere Versionen von PHP vorhanden sind, wird die folgende Warnmeldung angezeigt:

The following packages present on your system conflict with software we are
about to install. You will need to manually remove each one, then re-run this install script.
php
php-cli
php-common
php-gd
php-mbstring
php-mysql
php-pdo
php-pear
php-pecl-apc
php-process
php-xml

Entfernen Sie bei CentOS und Red Hat Enterprise Linux (RHEL) die PHP-Pakete mit dem folgenden Befehl:

yum remove <package-name>

4. Developer Channel Services mit dem automatischen Installationsskript installieren

Verwenden Sie eines der folgenden Verfahren, um das Portal zu installieren, je nachdem, ob Sie es auf einem Server mit oder ohne Internetverbindung installieren.

Auf einem Server mit einer Internetverbindung:

So installieren Sie Developer Channel Services auf einem Server mit einer Internetverbindung:

  1. Melden Sie sich auf dem Server als Root oder Superuser an.
  2. Erstellen Sie ein Verzeichnis für die Installationsdateien, z. B. portal.
  3. auf das neue Portal-Verzeichnis herunter und laden Sie die DeveloperService Channel Services-Datei DeveloperServices_x.y.z.tar herunter, wobei x.y.z der Versionsnummer des Portals entspricht.

    Sie können eine Datei über den Link herunterladen, den Sie von Apigee in einem Browser erhalten haben. Alternativ können Sie sie kopieren und dann dem folgenden cURL-Befehl hinzufügen:
    > curl -kOL <Link hier einfügen>
  4. Extrahieren Sie den Inhalt der TAR-Datei „Developer Channel Services“ mit dem folgenden Befehl:
    > tar -xvf <tar file>
  5. CD in DeveloperServices-4.x.y.z.
  6. Führen Sie das Installationsskript mit dem folgenden Befehl aus:
    > ./networked-install.sh
  7. Folgen Sie den Aufforderungen.

Auf einem Server ohne Internetverbindung:

Erstellen Sie zuerst ein nicht vernetztes Installationsskript auf einem System mit einer Internetverbindung:

  1. Melden Sie sich in einem System mit einer Internetverbindung als Root oder als Superuser an.
  2. Erstellen Sie ein Verzeichnis für die Installationsdateien, z. B. portal_tar.
  3. Erstellen Sie eine CD in das Verzeichnis portal_tar und laden Sie die Developer Channel Services-Datei DeveloperServices_x.y.z.tar herunter, wobei x.y.z der Versionsnummer des Portals entspricht.
  4. Extrahieren Sie den Inhalt der .tar-Datei der Developer Channel Services mit dem folgenden Befehl:
    > tar -xvf <tar file>
  5. CD in DeveloperServices-4.x.y.z.
  6. Erstellen Sie die Datei .tar.gz des Portals mit folgendem Befehl:
    > ./non-networked-install.sh

Eine neue .tar.gz-Datei für die Installation ohne Netzwerk wird erstellt.

So installieren Sie Developer Channel Services auf einem Server ohne Internetverbindung:

      1. Melden Sie sich auf dem Server als Root oder Superuser an.
      2. Erstellen Sie ein Verzeichnis für die Installationsdateien, z. B. portal.
      3. CD in das Portal-Verzeichnis.
      4. Kopieren Sie die Datei .tar.gz, die Sie für die Installation ohne Netzwerkverbindung (wie oben beschrieben) erstellt haben, in das Verzeichnis portal.
      5. Extrahieren Sie den Inhalt der Datei .tar.gz mit folgendem Befehl:
        > tar -xvf <tar file>
      6. in das mit dem Befehl „tar“ erstellte Verzeichnis ein.
      7. Legen Sie die Berechtigungen für das Skript install-from-rpm-bundle.sh fest:
        > chmod 755 install-from-rpm-bundle.sh
      8. Führen Sie das Skript install-from-rpm-bundle.sh mit folgendem Befehl aus:
        > ./install-from-rpm-bundle.sh
      9. Folgen Sie den Aufforderungen.

      5. Entwicklerportal konfigurieren

      Ein Großteil der Portalkonfiguration erfolgt ohne Interaktion von Ihnen, z. B. die Installation des Drupal-Moduls und die Erstellung von Standardinhalten. Sie werden aufgefordert, die Datenbank einzurichten, den Edge-Endpunkt zu konfigurieren und einen neuen Administrator zu erstellen.

      So konfigurieren Sie Ihr Entwicklerportal:

      1. Rufen Sie die Server-URL in einem Browser auf, z. B.
        http://localhost. Wenn Sie eine bestimmte IP-Adresse oder ein DNS konfiguriert haben, rufen Sie http://IP_address oder http://DNS_name auf.

        Sie werden zur Konfigurationsseite der Datenbank mit dem Apigee-Profil weitergeleitet.

        Hinweis: In der Regel haben Sie bereits einen Hostnamen konfiguriert und bei Ihrem DNS-Server registriert, sodass Sie http://localhost nicht verwenden müssen.
      2. Konfigurieren Sie die Verbindung zur Datenbank. Wenn sich die Datenbank auf einem Remote-Computer befindet, maximieren Sie den Abschnitt Erweiterte Optionen und geben Sie die Verbindungsinformationen zu diesem Computer ein. Wählen Sie dann Speichern und fortfahren aus.
      3. Konfigurieren Sie die Verbindung zum Apigee-Endpunkt, indem Sie die folgenden Informationen eingeben, und wählen Sie dann Speichern aus.
        Weitere Informationen zu diesen Werten finden Sie unter Voraussetzungen für das Entwicklerdienstportal unter „Erforderliche Informationen vor der Installation“.
        1. Management-API-Organisation
        2. URL des Management-API-Endpunkts
        3. Endpunkt authentifizierter Nutzer
        4. Passwort der authentifizierten Nutzer
      4. Konfigurieren Sie den Administrator, indem Sie die folgenden Informationen eingeben, und wählen Sie dann „Speichern“ aus. Beachten Sie, dass Drupal standardmäßig einen Administrator namens „admin“ erstellt. Verwenden Sie also nicht „admin“ als Nutzernamen.
        Wenn Sie diesen Schritt überspringen, können Sie trotzdem mit Drush einen Administrator erstellen, wie unten unter 4 beschrieben. Erstellen Sie einen Administrator.
        1. Vor- und Nachname des Entwicklers
        2. Nutzername des Entwicklerportals
        3. Passwort
        4. E-Mail-Adresse
      5. Legen Sie nach Abschluss der Installation die Berechtigungen für die Datei settings.php fest:
        > chmod 640 /var/www/html/sites/default/settings.php
      6. Gehen Sie zur Startseite des Portals unter http://localhost/ oder zum DNS-Namen Ihres Portals.
      7. Melden Sie sich mit den Administratoranmeldedaten im Portal an.

      6. Administrator erstellen (optional)

      Erstellen Sie mit Drush einen Nutzer mit Administratorzugriff für die Installation von Developer Channel Services. Drupal erstellt standardmäßig automatisch einen Administrator namens „admin“. Verwenden Sie also nicht „admin“ als Nutzernamen.

      1. CD in das Verzeichnis drupal_root/sites/default. Der Standardspeicherort für das Drupal-Stammverzeichnis ist /var/www/html:
        > cd <drupal_root>/sites/default
      2. Prüfen Sie, ob Sie Schreibberechtigungen für die privaten Drupal-Dateien haben:
        > drush vget file_private_path

        Dieser Befehl gibt den Pfad zu den privaten Drupal-Dateien zurück, z. B.:
        file_private_path: 'sites/default/private'

        Entspricht /var/www/html/sites/default/private/. Mit dem folgenden Befehl sorgen Sie dafür, dass der Inhaber und die Gruppe in dieses Verzeichnis schreiben können:
        chmod -R g+w dirPathAndName
        chmod -R o+r dirPathAndName
      3. Geben Sie die folgenden Befehle ein, um einen Administrator zu erstellen, und ersetzen Sie die Befehle in „< >“ durch Ihre Werte:
        > drush user-create <username> --mail="<email-address>" --password="<password>"
        > drush user-add-role Administrator <Nutzername>
      4. Melden Sie sich im Entwicklerportal als Administrator mit dem oben angegebenen Nutzernamen und Passwort an.

      5. MySQL-Root-Passwort festlegen

      Wenn Sie MySQL als Teil der Portalinstallation installiert haben, behält das Installationsskript den Standardwert für das MySQL-Root-Passwort bei, der leer ist.

      Verwenden Sie den folgenden Befehl, um das Root-Passwort festzulegen:

      > mysqladmin -u root password NEWPASSWORD
      

      Wenn Sie das Root-Passwort zuvor festgelegt haben und es ändern möchten, verwenden Sie den folgenden Befehl:

      > mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD
      

      Sie müssen auch das Passwort in der Datei /var/www/html/sites/default/settings.php aktualisieren.

      6. Das Update-Manager-Modul muss aktiviert sein

      Um Benachrichtigungen über Drupal-Updates zu erhalten, muss das Drupal-Update-Manager-Modul aktiviert sein. Wählen Sie im Drupal-Menü Module (Module) aus und scrollen Sie nach unten zum Modul Update Manager (Aktualisierungsmanager). Ist dies nicht der Fall, aktivieren Sie es.

      Nach der Aktivierung können Sie die verfügbaren Updates über den Menüpunkt Berichte > Verfügbare Updates aufrufen. Sie können auch den folgenden Drush-Befehl verwenden:

      > drush pm-info update
      

      Verwenden Sie den Menüpunkt Berichte > Verfügbare Updates > Einstellungen, um das Modul so zu konfigurieren, dass Sie per E-Mail benachrichtigt werden, wenn Updates verfügbar sind, und legen Sie die Häufigkeit der Suche nach Updates fest.

      7. Auf einem Produktionsserver bereitstellen (optional)

      Wenn Sie das Portal auf einem Produktionsserver bereitstellen, sollten Sie unter anderem die folgenden zusätzlichen Sicherheitsmaßnahmen ergreifen:

      1. Führen Sie das folgende Skript aus, um Ihre MySQL-Installation zu sichern:
        > /usr/bin/mysql_secure_installation

        Dieses Skript legt das Root-Passwort fest und bietet Ihnen die Möglichkeit, den Root-Zugriff auf den lokalen Host zu beschränken und die standardmäßig erstellten Testdatenbanken und den anonymen Nutzer zu entfernen. Für Produktionsserver wird dringend empfohlen, dieses Skript auszuführen.
      2. Aktivieren und konfigurieren Sie SELinux, falls dies gemäß Ihren Unternehmensrichtlinien erforderlich ist.

      8. Apache Solr-Suchmaschine konfigurieren (optional)

      Standardmäßig sind die Drupal-Module, die eine Verbindung zur Apache Solr-Suchmaschine herstellen, bei der Installation des Portals deaktiviert. Die meisten Portale verwenden die interne Drupal-Suchmaschine und benötigen daher die Drupal Solr-Module nicht.

      Wenn Sie Solr als Suchmaschine verwenden möchten, müssen Sie Solr lokal auf Ihrem Server installieren und dann die Drupal Solr-Module im Portal aktivieren und konfigurieren.

      So aktivieren Sie die Drupal Solr-Module:

      1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
      2. Wählen Sie im Drupal-Menü die Option Module (Module) aus.
      3. Aktivieren Sie die Module Apache Solr Framework und das Modul Apache Solr Search.
      4. Speichern Sie die Änderungen.
      5. Konfigurieren Sie Solr wie unter https://drupal.org/node/1999280 beschrieben.

      9. mod_ssl zur Unterstützung von HTTPS installieren (optional)

      Das Modul mod_ssl wird von Apache HTTP Server verwendet, um Webseiten über HTTPS bereitzustellen. Wenn Sie HTTPS verwenden möchten, installieren Sie mod_ssl mit dem folgenden Befehl:

      > yum install mod_ssl
      

      Weitere Informationen zum Konfigurieren des Portals für die Verwendung von SSL finden Sie unter http://apigee.com/docs/developer-services/content/using-ssl-portal.

      10. SmartDocs installieren (optional)

      Mit SmartDocs können Sie Ihre APIs auf dem Portal für Entwicklerdienste so dokumentieren, dass die API-Dokumentation vollständig interaktiv wird. Wenn Sie SmartDocs mit dem Portal verwenden möchten, müssen Sie jedoch zuerst SmartDocs in Edge installieren.

      • Wenn Sie das Portal mit einer Edge Cloud-Installation verbinden, ist SmartDocs bereits installiert und es ist keine weitere Konfiguration erforderlich.
      • Wenn Sie das Portal mit einer Edge für eine Private Cloud-Installation verbinden, müssen Sie dafür sorgen, dass SmartDocs in Edge installiert ist. Weitere Informationen zur Installation von Edge und SmartDocs finden Sie unter SmartDocs installieren.

      Weitere Informationen zu SmartDocs finden Sie unter SmartDocs zum Dokumentieren von APIs verwenden.

      11. Was kann ich jetzt für Sie tun?

      Nach der Installation des Portals für Entwicklerdienste müssen Sie es als Nächstes konfigurieren und an Ihre spezifischen Anforderungen anpassen. Die Dokumentation auf der Apigee-Website enthält alle Informationen zum Konfigurieren, Gestalten und Verwalten eines Portals. Greifen Sie auf die Dokumentation unter http://apigee.com/docs/developer-services/content/what-developer-portal zu.

      In der folgenden Tabelle sind einige der häufigsten Aufgaben aufgeführt, die Sie nach der Installation ausführen. Außerdem finden Sie Links zur Apigee-Dokumentation mit weiteren Informationen:

      Task (Aufgabe)

      Beschreibung

      Design anpassen

      Das Design definiert die Darstellung des Portals, einschließlich Farben, Stile und anderer visueller Aspekte.

      Darstellung anpassen

      Die Startseite enthält das Hauptmenü, die Willkommensnachricht, die Kopfzeile, die Fußzeile und den Titel.

      Nutzerkonten hinzufügen und verwalten

      Im Rahmen der Registrierung wird gesteuert, wie neue Entwickler ein Konto im Portal registrieren. Erhalten neue Entwickler beispielsweise sofort Zugriff auf das Portal oder müssen sie von einem Administrator bestätigt werden? Mit diesem Prozess wird auch gesteuert, wie ein Portaladministrator bei der Erstellung eines neuen Kontos benachrichtigt wird.

      E-Mails konfigurieren

      Das Portal sendet E-Mails als Reaktion auf bestimmte Ereignisse. Dies ist beispielsweise der Fall, wenn sich ein neuer Entwickler im Portal registriert und ein Entwickler sein Passwort verliert.

      Nutzerkonten hinzufügen und verwalten

      Füge eine Seite mit Nutzungsbedingungen hinzu, die Entwickler akzeptieren müssen, bevor sie auf das Portal zugreifen können.

      Nutzerkonten hinzufügen und verwalten

      Das Portal implementiert ein rollenbasiertes Autorisierungsmodell. Bevor Entwickler sich registrieren können, müssen Sie die vom Portal verwendeten Berechtigungen und Rollen definieren.

      Blog- und Forenbeiträge hinzufügen

      Das Portal verfügt über eine integrierte Unterstützung für Blogs und Foren mit Unterhaltungsthreads. Legen Sie die Berechtigungen fest, die zum Ansehen, Hinzufügen, Bearbeiten und Löschen von Blog- und Forumsbeiträgen erforderlich sind.

      Achten Sie darauf, dass Sie Datenbanksicherungen ausführen

      Stellen Sie sicher, dass Sie die Drupal-Datenbank sichern. Da jede Installation anders ist, müssen Sie selbst bestimmen, wie die Datenbank am besten gesichert werden soll.

      Hostnamen einrichten

      Wenn du auf deinem DNS-Server keinen Hostnamen einrichtest, kannst du jederzeit über die IP-Adresse des Servers auf die Website zugreifen. Wenn Sie einen Hostnamen verwenden möchten, können Sie das DNS für den Server konfigurieren. Dies sollte auch ohne weitere Konfiguration mit einer grundlegenden Einrichtung ordnungsgemäß funktionieren.

      Wenn Sie einen Load-Balancer eingerichtet haben oder aus einem anderen Grund falsche URLs auf Ihrer Website erhalten, können Sie $base_url in der Datei settings.php des Entwicklerportals festlegen. Diese befindet sich standardmäßig im Verzeichnis /var/www/html/sites/default.