Portal installieren

Edge for Private Cloud v4.18.05

Bevor Sie das Apigee Developer Services-Portal (oder einfach das Portal) installieren, prüfen Sie Folgendes:

1. Sie installieren Postgres vor der Installation des Portals. Sie können Postgres entweder als Teil oder Postgres zur Verwendung durch das Portal installieren.
   • Wenn Sie die eigenständige Version von Postgres installieren, kann es sich auf demselben Knoten wie das Portal befinden.
   • Wenn Sie eine Verbindung zu Postgres herstellen, das als Teil von Edge installiert wurde, und Postgres konfiguriert ist Geben Sie im Master/Standby-Modus die IP-Adresse des Master-Postgres-Servers an.
2. Du führst die Installation mit der 64-Bit-Version einer unterstützten Version von Red Hat durch. Enterprise Linux, CentOS oder Oracle. Eine Liste der unterstützten Versionen finden Sie unter Unterstützte Software und unterstützte Versionen
3. Yum ist installiert.

Das Installationsprogramm enthält nur von Drupal bereitgestellte Module, die für die Apigee Developer Services-Portal (oder einfach das Portal). Informationen zum Installieren weiterer Module finden Sie unter Verlängerung von Drupal 7

Installation

Führen Sie die folgenden Schritte aus, um das Portal zu installieren. Jeder dieser Schritte wird im erfahren Sie in den folgenden Abschnitten.

1. Verbindung testen
2. PHP-Versionen vor 7.0 entfernen
3. Postgres installieren
4. Portal installieren
5. Prüfen, ob Update Manager aktiviert ist
6. (Optional) Apache Solr konfigurieren
7. SmartDocs installieren(optional)
8. (Optional) JQuery konfigurieren

Einstellung der Eigenschaft SMTPSSL

In früheren Releases hast du mit der Property SMTPSSL folgende Aktionen ausgeführt: Legen Sie das Protokoll fest, das vom mit dem Portal verbundenen SMTP-Server verwendet wird. Diese Eigenschaft wurde eingestellt.

Sie verwenden jetzt das Attribut SMTP_PROTOCOL, anstelle der Eigenschaft SMTPSSL, um die Protokoll, das vom mit dem Portal verbundenen SMTP-Server verwendet wird. Gültige Werte sind: "standard", „ssl“ oder „tls“.

Portalkonfigurationsdatei erstellen

Unten sehen Sie ein Beispiel für eine Konfigurationsdatei im Hintergrund für eine Portalinstallation. Diese Datei bearbeiten nach Bedarf für Ihre Konfiguration. Verwenden Sie die Option „-f“, um Folgendes einzuschließen: setup.sh -Datei.

IP1=IPorDNSnameOfNode

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Specify the name of the portal database in Postgres.
PG_NAME=devportal

# Specify the Postgres admin credentials.
# The portal connects to Postgres by using the 'apigee' user.
# If you changed the Postgres password from the default of 'postgres'
# then set PG_PWD accordingly.
# If connecting to a Postgres node installed with Edge,
# contact the Edge sys admin to get these credentials.
PG_USER=apigee
PG_PWD=postgres

# The IP address of the Postgres server.
# If it is installed on the same node as the portal, specify that IP.
# If connecting to a remote Postgres server,specify its IP address.
PG_HOST=$IP1

# The Postgres user credentials used by the portal
# to access the Postgres database,
# This account is created if it does not already exist.
DRUPAL_PG_USER=drupaladmin
DRUPAL_PG_PASS=portalSecret

# Specify 'postgres' as the database.
DEFAULT_DB=postgres

# Specify the Drupal admin account details.
# DO NOT set DEVPORTAL_ADMIN_USERNAME=admin.
# The installer creates this user on the portal.
DEVPORTAL_ADMIN_FIRSTNAME=firstName
DEVPORTAL_ADMIN_LASTNAME=lastName
DEVPORTAL_ADMIN_USERNAME=userName
DEVPORTAL_ADMIN_PWD=PORTAL_ADMIN_PASSWORD
DEVPORTAL_ADMIN_EMAIL=foo@bar.com

# Edge connection details.
# If omitted, you can set them in the portal UI.
# Specify the Edge organization associated with the portal.
EDGE_ORG=edgeOrgName

# Specify the URL of the Edge management API.
# For a Cloud based installation of Edge, the URL is:
# https://api.enterprise.apigee.com/v1
# For a Private Cloud installation, it is in the form:
# http://ms_IP_or_DNS:8080/v1 or
# https://ms_IP_or_DNS:TLSport/v1
MGMT_URL=https://api.enterprise.apigee.com/v1

# The org admin credentials for the Edge organization in the form
# of Edge emailAddress:pword.
# The portal uses this information to connect to Edge.
DEVADMIN_USER=orgAdmin@myCorp.com
DEVADMIN_PWD=ORG_ADMIN_PASSWORD

# The PHP port.
# If omitted, it defaults to 8888.
PHP_FPM_PORT=8888

# Optionally configure the SMTP server used by the portal.
# If you do, the properties SMTPHOST and SMTPPORT are required.
# The others are optional with a default value as notated below.
# SMTP hostname. For example, for the Gmail server, use smtp.gmail.com.
SMTPHOST=smtp.gmail.com

# Set the SMTP protocol as "standard", "ssl", or "tls",
# where "standard" corresponds to HTTP.
# Note that in previous releases, this setting was controlled by the
# SMTPSSL property. That property has been deprecated.
SMTP_PROTOCOL="standard"

# SMTP port (usually 25).
# The value can be different based on the selected encryption protocol.
# For example, for Gmail, the port is 465 when using SSL and 587 for TLS.
SMTPPORT=25

# Username used for SMTP authentication, defaults is blank.
SMTPUSER=your@email.com

# Password used for SMTP authentication, default is blank.
SMTPPASSWORD=YOUR_EMAIL_PASSWORD

1. Verbindung zu Apigee Edge testen

Testen Sie Ihre Verbindung zwischen dem Server, auf dem Sie das Portal installieren möchten, und dem Edge indem Sie den folgenden curl-Befehl auf dem Portalserver ausführen:

curl -u EMAIL:PASSWORD http://ms_IP_or_DNS:8080/v1/organizations/ORGNAME

oder

curl -u EMAIL:PASSWORD https://ms_IP_or_DNS:TLSPort/v1/organizations/ORGNAME

Dabei sind EMAIL und PASSWORD die E-Mail-Adresse und das Passwort der Administrator 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.

Bei Erfolg gibt curl eine Antwort ähnlich der folgenden zurück:

{
  "createdAt" : 1348689232699,
  "createdBy" : "USERNAME",
  "displayName" : "cg",
  "environments" : [ "test", "prod" ],
  "lastModifiedAt" : 1348689232699,
  "lastModifiedBy" : "foo@bar.com",
  "name" : "cg",
  "properties" : {
    "property" : [ ]
  },
  "type" : "trial"
}

2. Entfernen von PHP-Versionen vor 7.0

Das Installationsskript sucht auf dem System nach PHP-Versionen vor 7.0, bevor das Installation. Wenn ältere PHP-Versionen als 7.0 vorliegen, 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 die PHP-Pakete mit dem folgenden Befehl:

yum remove package_name

Wenn Sie nicht sicher sind, ob PHP auf Ihrem Server installiert ist, verwenden Sie den folgenden Befehl:

rpm -qa | grep -i php

3. Postgres installieren

Für das Portal muss Postgres installiert sein, bevor Sie das Portal installieren können. Sie haben folgende Möglichkeiten: Postgres im Rahmen der Installation von Edge installieren oder Postgres eigenständig zur Verwendung durch die

• Wenn Sie eine Verbindung zu Postgres herstellen, das als Teil von Edge installiert wurde, und Postgres in Master/Standby-Modus die IP-Adresse des Master-Postgres-Servers an.
• Wenn Sie die eigenständige Version von Postgres installieren, kann es sich auf demselben Knoten wie das Portal befinden.

Informationen zur Installation von Postgres im Rahmen der Installation von Edge finden Sie unter Edge-Komponenten auf einem Knoten installieren

So installieren Sie die eigenständige Postgres-App:

1. Installieren Sie das Edge apigee-setup-Dienstprogramm auf dem Knoten mithilfe der Verfahren außerhalb des Internets. Weitere Informationen finden Sie unter Installieren Sie das Edge-Apigee-Setup-Dienstprogramm, um weitere Informationen zu erhalten.
2. Erstellen Sie eine Postgres-Konfigurationsdatei, wie das folgende Beispiel zeigt:

   # Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost
   HOSTIP=$(hostname -i)
   
   # The pod and region of Postgres. Use the default values shown below.
   MP_POD=gateway
   REGION=dc-1
   
   # Set the Postgres password. The default value is 'postgres'.
   PG_PWD=postgres

3. Führen Sie in der Eingabeaufforderung das Setupskript aus, um Postgres zu installieren:

   /opt/apigee/apigee-setup/bin/setup.sh -p pdb -f postgres_config_file

   Die Option -p pdb gibt an, dass Postgre installiert werden soll. Die Konfigurationsdatei muss durch den „Apigee“-Code zugänglich oder lesbar sein, Nutzer.

4. Portal installieren

Bevor Sie das Portal installieren können, müssen Sie die folgenden Schritte ausgeführt haben: 3. Installieren Sie Postgres:

1. Installieren Sie das Edge-Dienstprogramm apigee-setup auf dem Knoten des Portals
2. Postgres installieren, entweder eigenständig oder als Teil der Installation von Edge

So installieren Sie das Portal:

1. Führen Sie in der Eingabeaufforderung das Skript setup aus:

   /opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile

   Wobei:

   • configFile ist die Portalkonfigurationsdatei, wie unter Erstellen Sie eine Portalkonfigurationsdatei.
   • -p dp weist das Skript setup an, das Portal zu installieren.

So prüfen Sie, ob die Portalinstallation erfolgreich war:

1. Gehen Sie zur Startseite des Portals unter http://localhost:8079 oder zum DNS-Namen deines Portals.
2. Melden Sie sich mit den Administratoranmeldedaten, die Sie im Portal festgelegt haben, im Portal an. Konfigurationsdatei.
3. Wählen Sie Berichte > Statusbericht im Drupal-Menü, um sicherzustellen, können Sie den aktuellen Status des Portals sehen.
4. Prüfen Sie, ob die Verbindung zum Verwaltungsserver hergestellt wurde. Falls nicht: <ph type="x-smartling-placeholder">
   </ph>
   1. Rufen Sie die Seite für die Konfiguration der Portalverbindung auf (z. B. http://portal_IP:8079/admin/config/devconnect.
   2. Klicken Sie auf die Schaltfläche Test Connection (Verbindung testen). Wenn die Verbindung hergestellt wurde, sind Sie fertig. Wenn die Verbindung fehlschlägt, fahren Sie fort.
   3. Prüfen Sie die Endpunkt- und Authentifizierungseinstellungen: <ph type="x-smartling-placeholder">
      </ph>
      • Endpunkt-URL der Management API:Prüfen Sie, ob das Protokoll (HTTP oder HTTPS), IP- oder DNS-Name und die Portnummer sind korrekt. Beispiel:

        http://10.10.10.10:8080/v1

      • Am Endpunkt authentifizierter Nutzer:Der Administrator der Organisation Nutzernamen.
      • Passwort des authentifizierten Nutzers: Passwort.

      Die Standardwerte spiegeln die Einstellungen in Ihrer Portalkonfigurationsdatei wider, die Sie die während der Installation erstellt wurden.

      Diese Werte sollten den Werten ms_IP_or_DNS, email und password Werte, die Sie in Schritt verwendet haben 1: Testen Sie Ihre Verbindung zu Apigee Edge. Nutzername und Passwort sollten auch mit den Werten von USER_NAME übereinstimmen. und USER_PWD im Onboarding-Konfigurationsdatei oder den Anmeldedaten aller Nutzer mit der Rolle „Organization Administrator“.

   4. Nachdem Sie eine Verbindung zum Verwaltungsserver hergestellt haben, klicken Sie auf die Schaltfläche Speichern Konfiguration unten auf der Seite, um Ihre Änderungen zu speichern.

5. 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

Sie müssen diesen Befehl vom Stammverzeichnis der Website ausführen. Standardmäßig enthält der Parameter Das Portal ist unter /opt/apigee/apigee-drupal/wwwroot installiert. Dementsprechend wird sollten Sie zuerst das Verzeichnis in /opt/apigee/apigee-drupal/wwwroot ändern, bevor und führen den Befehl aus. Wenn Sie das Portal nicht im Standardverzeichnis installiert haben, wechseln Sie zu Ihrem .

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.

6. Apache Solr-Suchmaschine konfigurieren Optional:

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.

7. SmartDocs installieren (optional)

Mit SmartDocs können Sie Ihre APIs im 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 Installieren Sie SmartDocs.

Außerdem müssen Sie SmartDocs im Portal aktivieren. Weitere Informationen zu SmartDocs finden Sie unter Mit SmartDocs APIs

8. Konfigurieren Sie die JQuery-Update-Modul für Installationen außerhalb des Internets (optional)

Wenn Sie das JQuery Update-Modul in einer Installation außerhalb des Internets installieren und verwenden, müssen Sie Konfigurieren Sie das Modul für die Verwendung der lokalen Version von JQuery. Wenn Sie das Modul für die Verwendung eines CDN konfigurieren Bei einer Installation außerhalb des Internets wird versucht, auf das CDN zuzugreifen, und es kommt zu Verzögerungen wird geladen. Weitere Informationen zum Modul „JQuery Update“ finden Sie unter https://www.drupal.org/project/jquery_update.

So konfigurieren Sie das JQuery Update-Modul für die Verwendung der lokalen Version von JQuery:

1. Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
2. Wählen Sie Konfiguration > Entwicklung > JQuery Update im Drupal-Menü.
3. Klicken Sie im linken Navigationsbereich auf Leistung.
4. Wählen Sie in der Drop-down-Liste „CDN“ der JQuery- und JQuery-UI die Option None aus.
5. Klicken Sie auf Save configuration (Konfiguration speichern).

9. Nächste Schritte

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: