Installation von Entwicklerdiensten im Portal

Developer Services Portal Version 4.16.05

Führen Sie die folgenden Schritte aus, um das Developer Channel Services-Portal zu installieren.

Erstellen Sie vor der Installation eine Sicherung Ihres gesamten Drupal-Webstamms. -Verzeichnis. Der Standardspeicherort ist /var/www/html, dieser wurde aber möglicherweise geändert. zum Zeitpunkt der Installation. Nachdem Sie die unten beschriebenen Installationsschritte ausgeführt haben, können Sie Ihr aus dem Back-up.

1. Channel Services-Paket für Entwickler herunterladen

Gehen Sie zu http://community.apigee.com/content/apigee-customer-support und wählen Sie „Login to your Support Portal“ (Im Supportportal anmelden) aus, um die TAR-Datei für Developer Channel Services anzufordern in haben Sie zwei Möglichkeiten:

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

2. Achten Sie darauf, dass Ihr System dem System entspricht Anforderungen

Bevor Sie das Portal installieren, muss Ihr Server die folgenden Anforderungen erfüllen:

  1. Achten Sie darauf, dass Sie für die Installation die 64-Bit-Version einer unterstützten Version von Red Hat Enterprise Linux, CentOS oder Oracle. Hier finden Sie eine Liste der unterstützten Versionen.
  2. Yum muss installiert sein.
  3. (Für eine Installation auf einem Server ohne Internetverbindung): alle erforderlichen Dateien auf einen Server mit Internetverbindung TAR.GZ-Datei. Anschließend kopieren Sie diese TAR.GZ-Datei auf den Server ohne Internetverbindung, um die Installation durchzuführen.
    1. Melden Sie sich bei einem Server mit Internetverbindung als Root oder Superuser an.
    2. Erstellen Sie ein Verzeichnis für die Installationsdateien, z. B. portal_tar.
    3. CD in das neue Verzeichnis und laden Sie die Developer Channel Services DeveloperServices_x.y.z.tar herunter. -Datei, wobei x.y.z der Versionsnummer des Portals entspricht.
    4. Extrahieren Sie den Inhalt der TAR-Datei für Developer Channel Services mithilfe der Befehl:
      &gt; tar -xvf <tar file&gt;
    5. CD auf DeveloperServices-4.x.y.z.
    6. Erstellen Sie die Portaldatei .tar.gz mit dem folgenden Befehl:
      &gt; ./non-networked-install.sh

      Mit diesem Befehl werden alle erforderlichen Dateien in eine einzige TAR.GZ-Datei heruntergeladen. Ich Anschließend kopieren Sie diese TAR.GZ-Datei auf Ihren Server, bei dem keine Internetverbindung besteht, installieren.
  4. Testen Sie Ihre Verbindung zum Edge-Verwaltungsserver, indem Sie den folgenden cURL-Befehl ausführen über eine Eingabeaufforderung auf dem Portalserver:
    &gt; curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}

    Dabei steht EMAIL und PASSWORD für die E-Mail-Adresse. E-Mail-Adresse und Passwort des Administrators für ORGNAME.

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

    Wenn der Vorgang erfolgreich ist, wird mit diesem Befehl eine Antwort wie diese zurückgegeben:
    {
    "erstellt um" : 1348689232699,
    "createdBy" : "NUTZERNAME",
    &quot;displayName&quot; : "cg",
    "Umgebungen" : [ "test", "prod" ],
    "lastModifiedAt" : 1348689232699,
    „lastModifiedBy“ : „foo@bar.com“,
    „name“ : "cg",
    „Eigenschaften“ : {
    „Property“ : [ ]
    },
    „type“ : „Testzeitraum“
    }

3. Entwickler installieren Channel Services mit dem automatischen Installationsskript

Gehen Sie wie im Folgenden beschrieben vor, um das Portal mithilfe des automatisierten Installationsskripts zu installieren. Dieses funktioniert für Server mit und ohne externe Internetverbindung.

  1. Melden Sie sich beim Server als Root oder als Superuser an.
  2. Erstellen Sie ein Verzeichnis für die Installationsdateien, z. B. portal.
  3. Auf einem Server mit Internetverbindung: <ph type="x-smartling-placeholder">
      </ph>
    1. CD zum neuen Portal und laden Sie die Developer Channel Services DeveloperServices_x.y.z.tar herunter. -Datei, wobei x.y.z der Versionsnummer des Portals entspricht.

      Sie können eine Datei über den Link herunterladen, den Sie von Apigee erhalten haben, in einem Browser oder durch Kopieren der Datei Dann fügen Sie es dem folgenden cURL-Befehl hinzu:
      &gt; curl -kOL <Link einfügen here&gt;
    2. Extrahieren Sie den Inhalt der TAR-Datei für Developer Channel Services mithilfe der Befehl:
      &gt; tar -xvf <tar file&gt;
    3. CD auf DeveloperServices-4.x.y.z.
    4. Führen Sie das Installationsskript mit dem folgenden Befehl aus:
      &gt; ./networked-install.sh
  4. Auf einem Server ohne Internetverbindung: <ph type="x-smartling-placeholder">
      </ph>
    1. Kopieren Sie die TAR.GZ-Datei, die Sie oben im Abschnitt 2 erstellt haben. Achten Sie darauf, dass Ihr System Systemanforderungen.
    2. Extrahieren Sie den Inhalt der TAR.GZ-Datei mit dem folgenden Befehl:
      &gt; tar -xvf <tar file&gt;
    3. CD in das mit dem tar-Befehl erstellte Verzeichnis
    4. Legen Sie die Berechtigungen für das Skript install-from-rpm-bundle.sh fest:
      > CHMOD 755 install-from-rpm-bundle.sh
    5. Führen Sie das Skript install-from-rpm-bundle.sh mithilfe des folgenden Befehls:
      > ./install-from-rpm-bundle.sh
  5. Folgen Sie der Anleitung.
  6. Rufen Sie nach Abschluss der Installation die Server-URL in einem Browser wie als:
    http://localhost. Wenn Sie eine bestimmte IP-Adresse oder rufen Sie http://IP_address oder http://DNS_name auf.

    Sie werden zur Konfigurationsseite der Apigee-Profildatenbank weitergeleitet.

    Hinweis: Normalerweise haben Sie bereits einen Hostnamen konfiguriert und registriert. mit Ihrem DNS-Server, damit Sie http://localhost verwenden müssen.
  7. Konfigurieren Sie die Verbindung zu MySQL. Wenn sich MySQL auf einem Remote-Computer befindet, erweitern Sie den Erweiterte Optionen und geben Sie die Verbindungsinformationen zu diesem Computer ein. Wählen Sie dann Speichern und fortfahren aus.
  8. Konfigurieren Sie die Verbindung zum Apigee-Endpunkt, indem Sie die folgenden Informationen eingeben. Wählen Sie dann Speichern aus:
    Weitere Informationen zu diesen Werten finden Sie unter "Erforderliche Informationen vor Beginn der Installation". im Developer Services-Portal Anforderungen.
    1. Entwicklerportalorganisation
    2. Entwicklerportal-Endpunkt-URL
    3. Durch Endpunkt authentifizierter Nutzer
    4. Authentifizierte Nutzer Passwort
  9. Wenn Sie dazu aufgefordert werden, wählen Sie die Schaltfläche Install Sample SmartDocs WADL (Beispiel-SmartDocs-WADL installieren) aus, um die Installation zu starten. SmartDocs-Beispiel-WADL. Wenn Sie diesen Schritt überspringen, wird die Beispiel-SmartDocs API auf deinem Portal erscheinen.
    Hinweis: Wenn Ihr Portal eine Verbindung zu einer Installation von Apigee Edge for Private herstellt Cloud arbeiten und diese Installation von Edge keine externe Internetverbindung hat, müssen Sie Folgendes ausführen: zusätzliche Konfiguration des SmartDocs-Moduls vor der Verwendung von SmartDocs. Weitere Informationen Informationen zu SmartDocs finden Sie unter http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis.
  10. Konfigurieren Sie die SMTP-Servereinstellungen. Bei Apigee müssen Sie ein SMTP-Server zum Senden von E-Mail-Nachrichten aus dem Portal.
    Weitere Informationen finden Sie unter http://apigee.com/docs/developer-services/content/configuring-email.
  11. Konfigurieren Sie den Administratornutzer, indem Sie die folgenden Informationen eingeben, und wählen Sie dann Speichern. Beachten Sie, dass Drupal einen Administrator mit dem Namen "admin" erstellt. Verwenden Sie standardmäßig nicht „admin“. als den Nutzernamen.
    Wenn Sie diesen Schritt überspringen, können Sie trotzdem wie unten beschrieben mit Drush einen Administrator erstellen. in 4. Erstellen Sie einen Administrator.
    1. Vor- und Nachname des Entwicklers
    2. Nutzername des Entwicklerportals
    3. Passwort
    4. E-Mail-Adresse
  12. Legen Sie nach Abschluss der Installation die Berechtigungen für die Datei settings.php fest:
    > CHMOD 640 /var/www/html/sites/default/settings.php
  13. Gehen Sie zur Startseite des Portals unter http://localhost/ oder zum DNS-Namen von Ihr Portal.
  14. Melden Sie sich mit den Administratoranmeldedaten im Portal an.

4. Administrator erstellen

Erstellen Sie mithilfe von Drush einen Administrator für Ihre Developer Channel Services-Installation. Drupal erstellt automatisch einen Administrator mit dem Namen „admin“. Verwenden Sie standardmäßig nicht „admin“. als Nutzernamen.

  1. CD in das Verzeichnis drupal_root/sites/default. Der Standardspeicherort für den Drupal-Stamm Verzeichnis ist /var/www/html:
    &gt; cd &lt;drupal_root&gt;/sites/default
  2. Prüfe, ob du Schreibberechtigungen für die privaten Drupal-Dateien hast:
    &gt; 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/. Stellen Sie mit dem folgenden Befehl sicher, Das folgende Verzeichnis ist vom Inhaber und der Gruppe beschreibbar:
    chmod -R g+w dirPathAndName
    chmod -R o+r dirPathAndName
  3. Geben Sie die folgenden Befehle ein, um einen Administrator zu erstellen. Ersetzen Sie dabei die Befehle in „< >“ durch Ihre Werte:
    &gt; Drush von Nutzern <Nutzername> --mail=&quot;&lt;email-address&gt;&quot; --password=&quot;&lt;password&gt;&quot;
    &gt; drush user-add-role Administrator <username>
  4. Melden Sie sich mit dem angegebenen Nutzernamen und Passwort als Administrator im Entwicklerportal an. oben.

5. MySQL-Root-Passwort festlegen

Wenn Sie MySQL als Teil der Portalinstallation installiert haben, verlässt das Installationsskript das Das MySQL-Root-Passwort wurde auf den Standardwert festgelegt, der leer ist.

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

> mysqladmin -u root password NEWPASSWORD

Wenn Sie bereits das Root-Passwort festgelegt haben und es ändern möchten, verwenden Sie Folgendes: 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. -Datei.

6. Stellen Sie sicher, dass das Update-Manager-Modul aktiviert

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

Nach der Aktivierung können Sie die verfügbaren Updates über die Schaltfläche Berichte > Verfügbar Updates. Sie können auch den folgenden Drush-Befehl verwenden:

> drush pm-info update

Verwenden Sie den Tab Berichte > Verfügbare Updates > Menüpunkt für Einstellungen, der konfiguriert werden soll das Modul, um Sie per E-Mail zu informieren, wenn Updates verfügbar sind, und um festzulegen, wie oft nach Updates gesucht werden soll. Aktualisierungen.

7. Optional – In einer Produktion bereitstellen Server

Wenn Sie das Portal auf einem Produktionsserver bereitstellen, sollten Sie zusätzliche Sicherheitsmaßnahmen ergreifen Schritte, einschließlich:

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

    Dieses Skript legt das Root-Passwort fest und gibt Ihnen die Möglichkeit, den Root-Zugriff auf die localhost und zum Entfernen der standardmäßig erstellten Testdatenbanken und des anonymen Nutzers. Ausführen Skript wird für Produktionsserver dringend empfohlen.
  2. Falls dies gemäß Ihren Unternehmensrichtlinien erforderlich ist, aktivieren und konfigurieren Sie SELinux.

8. Optional – Apache Solr konfigurieren Suchmaschine

Standardmäßig sind die Drupal-Module, die eine Verbindung zur Apache Solr-Suchmaschine herstellen, deaktiviert, wenn installieren Sie das Portal. Die meisten Portale nutzen die interne Drupal-Suchmaschine und verwenden daher die Drupal Solr-Module benötigen.

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

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 Modules im Drupal-Menü aus.
  3. Modul Apache Solr Framework und Apache Solr aktivieren Search-Modul.
  4. Speichern Sie die Änderungen.
  5. Konfigurieren Sie Solr wie unter https://drupal.org/node/1999280 beschrieben.

9. Optional – Installieren Sie mod_ssl für die Unterstützung HTTPS

Das Modul mod_ssl wird vom Apache HTTP Server verwendet, um Webseiten über HTTPS bereitzustellen. Wenn Sie 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. Optional – SmartDocs installieren

Mit SmartDocs können Sie Ihre APIs im Developer Services-Portal so dokumentieren, dass das Die API-Dokumentation ist vollständig interaktiv. Wenn Sie SmartDocs mit dem Portal verwenden möchten, müssen Sie jedoch zuerst und installieren Sie SmartDocs in Edge.

  • Wenn Sie das Portal mit einer Edge Cloud-Installation verbinden, wird SmartDocs bereits installiert und es ist keine weitere Konfiguration erforderlich.
  • Wenn Sie das Portal mit einer Edge for Private Cloud-Installation verbinden, müssen Sie sicherstellen, 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 Verwenden von SmartDocs zur Dokumentation APIs

11. Nächster Schritt

Die nächsten Schritte nach der Installation des Developer Services-Portals sind die Konfiguration und Anpassung 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. und enthält Links zur Apigee-Dokumentation, in der Sie weitere Informationen finden:

Aufgabe

Beschreibung

Anpassen des Design

Das Design definiert das Aussehen des Portals, einschließlich Farben, Stilen und anderen visuelle Aspekte zu berücksichtigen.

Passen Sie die Aussehen

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

Hinzufügen und Nutzerkonten verwalten

Der Registrierungsprozess bestimmt, wie neue Entwickler ein Konto auf der Erhalten z. B. neue Entwickler sofortigen Zugriff auf das Portal oder geben sie müssen von einem Administrator überprüft werden. Dieser Prozess steuert auch, wie ein Portal -Administrator wird benachrichtigt, wenn ein neues Konto erstellt wird.

Konfigurieren E-Mail

Das Portal sendet E-Mails als Reaktion auf bestimmte Ereignisse. Wenn z. B. eine neue sich im Portal registriert und wenn ein Entwickler sein Passwort verliert.

Hinzufügen und Nutzerkonten verwalten

Bedingungen und hinzufügen Seite mit Bedingungen, die Entwickler akzeptieren müssen, bevor sie dürfen auf das Portal zugreifen können.

Hinzufügen und Nutzerkonten verwalten

Das Portal implementiert ein rollenbasiertes Autorisierungsmodell. Bevor Entwickler Registrieren Sie die vom Portal verwendeten Berechtigungen und Rollen.

Blog hinzufügen und Forenbeiträge

Das Portal unterstützt Blogs und Foren mit Threads. Berechtigungen definieren erforderlich, um Blog- und Forenbeiträge anzusehen, hinzuzufügen, zu bearbeiten und zu löschen.

Achten Sie darauf, dass Sie Datenbanksicherungen ausführen

Stellen Sie sicher, dass Sie die Drupal-Datenbank sichern. Da jedes die Installation unterschiedlich ist, müssen Sie selbst entscheiden, Datenbank.

Hostnamen einrichten

Wenn Sie keinen Hostnamen in Ihrem DNS-Server einrichten, können Sie die Website jederzeit über die IP-Adresse des Servers. Wenn Sie einen Hostnamen verwenden möchten, können Sie DNS für was ohne weitere Konfiguration in einer grundlegenden Konfiguration problemlos funktionieren sollte.

Wenn Sie ein Lastenausgleichsmodul einrichten oder für einige aus anderen Gründen können Sie $base_url in der Datei settings.php des Entwicklerportals festlegen. die sich standardmäßig im Verzeichnis /var/www/html/sites/default befindet. -Verzeichnis.