Edge for Private Cloud v4.19.01
Bevor Sie das Apigee Developer Services-Portal (oder einfach das Portal) installieren, prüfen Sie Folgendes:
- 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.
- 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
- 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.
- Verbindung testen
- PHP-Versionen vor 7.0 entfernen
- Postgres installieren
- Portal installieren
- Prüfen, ob Update Manager aktiviert ist
- (Optional) Apache Solr konfigurieren
- SmartDocs installieren(optional)
- (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
Beachten Sie, dass das Portal die PHP-Version 4.18.01-0.0.49 verwendet. Dies entspricht nicht dem Versionsnummer von Apigee Edge für Private Cloud.
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:
- 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. - 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
- 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:
- Installieren Sie das Edge-Dienstprogramm
apigee-setup
auf dem Knoten des Portals - Postgres installieren, entweder eigenständig oder als Teil der Installation von Edge
So installieren Sie das Portal:
- 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 Skriptsetup
an, das Portal zu installieren.
So prüfen Sie, ob die Portalinstallation erfolgreich war:
- Gehen Sie zur Startseite des Portals unter
http://localhost:8079
oder zum DNS-Namen deines Portals. - Melden Sie sich mit den Administratoranmeldedaten, die Sie im Portal festgelegt haben, im Portal an. Konfigurationsdatei.
- Wählen Sie Berichte > Statusbericht im Drupal-Menü, um sicherzustellen, können Sie den aktuellen Status des Portals sehen.
- Prüfen Sie, ob die Verbindung zum Verwaltungsserver hergestellt wurde. Falls nicht:
<ph type="x-smartling-placeholder">
- </ph>
- Rufen Sie die Seite für die Konfiguration der Portalverbindung auf (z. B.
http://portal_IP:8079/admin/config/devconnect
. - 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.
- 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. undUSER_PWD
im Onboarding-Konfigurationsdatei oder den Anmeldedaten aller Nutzer mit der Rolle „Organization Administrator“. - Endpunkt-URL der Management API:Prüfen Sie, ob das Protokoll (HTTP oder
HTTPS), IP- oder DNS-Name und die Portnummer sind korrekt. Beispiel:
- 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.
- Rufen Sie die Seite für die Konfiguration der Portalverbindung auf (z. B.
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:
- Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
- Wählen Sie Modules im Drupal-Menü aus.
- Modul Apache Solr Framework und Apache Solr aktivieren Search-Modul.
- Speichern Sie die Änderungen.
- 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:
- Melden Sie sich in Ihrem Portal als Nutzer mit Administrator- oder Berechtigungen zum Erstellen von Inhalten an.
- Wählen Sie Konfiguration > Entwicklung > JQuery Update im Drupal-Menü.
- Klicken Sie im linken Navigationsbereich auf Leistung.
- Wählen Sie in der Drop-down-Liste „CDN“ der JQuery- und JQuery-UI die Option None aus.
- 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:
Aufgabe | Beschreibung |
---|---|
Das Design definiert das Aussehen des Portals, einschließlich Farben, Stilen und anderen visuelle Aspekte zu berücksichtigen. |
|
Die Startseite enthält das Hauptmenü, die Willkommensnachricht, die Kopf-, Fußzeile und den Titel. |
|
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. |
|
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. |
|
Bedingungen und hinzufügen Seite mit Bedingungen, die Entwickler akzeptieren müssen, bevor sie dürfen auf das Portal zugreifen können. |
|
Das Portal implementiert ein rollenbasiertes Autorisierungsmodell. Bevor Entwickler Registrieren Sie die vom Portal verwendeten Berechtigungen und Rollen. |
|
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. Weitere Informationen finden Sie unter Sicherungen durchführen. |
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 auf einem einfachen Server einrichten. Wenn Sie ein Lastenausgleichsmodul einrichten oder für einige
aus anderen Gründen können Sie
Sie können auch andere Weitere Informationen zum Attribut |
Benutzerdefinierte Entwicklung | Sie können die Funktionen Ihres Portals auch durch benutzerdefinierten Code außerhalb Ihres
aus. Erstellen Sie dazu Ihr eigenes Drupal-Modul, wie im
Modul
Themen für die Entwicklung und platzieren Sie das Modul im /sites/all/modules .
-Verzeichnis. |