Developer Services Portal Version 4.16.09
Im Folgenden sind die Hardware- und Softwareanforderungen für die Installation aufgeführt.
Hardware |
Anforderung |
Betriebssystem |
Diese Installationsanleitung und die bereitgestellten Installationsdateien wurden auf den Betriebssystemen getestet, die hier aufgeführt sind: https://apigee.com/docs/api-services/reference/supported-software |
RAM |
1 GB |
Festplatte |
10 GB |
Netzwerkschnittstelle |
Es ist eine aktive Internetverbindung erforderlich. Im Rahmen des Installationsvorgangs lädt das Installationsprogramm Ressourcen aus dem Web herunter. Wenn Ihre Umgebung für ausgehende HTTP- und HTTPS-Anfragen über den Proxy eingerichtet ist, muss der Proxy so konfiguriert sein, dass weitergeleitete Anfragen während eines Downloads korrekt verarbeitet werden. Eine Anfrage an https://drupal.org/ gibt beispielsweise einen Statuscode für HTTP 301 zurück und leitet zu https://www.drupal.org/ weiter. Ihr Proxy sollte so konfiguriert sein, dass er einen HTTP 200-Statuscode mit dem angeforderten Inhalt von der Weiterleitung zurückgibt. Wenn Ihre Umgebung für SAP-Installationen für ausgehende HTTPS-Anforderungen des Proxy eingerichtet ist, muss Ihr Proxy TLSv1.0 unterstützen. OpenSSL 0.9.8 unterstützt keine TLSv1.1 oder TLSv1.2, nur TLSv1.0. |
Anforderungen an die MySQL-Datenbank
Wenn Sie den MySQL-Server auf demselben Computer wie die Developer Channel Services installieren, also die Topologie mit einem einzelnen Computer, werden Sie vom Installationsprogramm der Developer Channel Services aufgefordert, den Datenbanknamen und den Datenbanknutzer einzugeben. Anschließend wird der MySQL-Server installiert und das Datenbankschema für Sie erstellt. Die installierte Version ist die neueste Version, die für Ihr Betriebssystem verfügbar ist.
Wenn der MySQL-Server auf einem separaten System installiert werden soll, müssen Sie MySQL Server bereits auf diesem System installiert haben, bevor Sie den Installationsprogramm für die Entwicklerkanaldienste starten. Sie müssen MySQL 5.0.15 oder höher installiert haben.
Für die Installation der Developer Channel Services muss der MySQL-Server eine Datenbank mit einem leeren Datenbankschema enthalten. Das Installationsprogramm für Developer Channel Services fordert Sie auf, den Hostnamen, den Namen der Datenbank und den Datenbanknutzer anzugeben. Das Installationsprogramm stellt dann eine Verbindung zur Datenbank her, um die Standarddatenbanktabellen und -daten zu erstellen.
Der Datenbanknutzer wird von Developer Channel Services verwendet, um eine Verbindung zur Datenbank herzustellen. Er muss die folgenden Berechtigungen haben: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES.
So erstellen Sie beispielsweise eine Datenbank mit dem Namen devportal und einen Nutzer namens devportal:
- Installieren Sie MySQL Server auf dem System.
- Melden Sie sich mit dem Befehl als Root-Nutzer in MySQL an:
> mysql -u root -p - Geben Sie das Root-Passwort ein, wenn Sie dazu aufgefordert werden.
- Geben Sie an der mysql>-Eingabeaufforderung Folgendes ein, um den Nutzer „devportal“ zu erstellen:
mysql>create user 'devportal'@'localhost' identified by 'devportal';
mysql> grant all privileges on *.* to 'devportal'@'localhost';
mysql> flush privileges;
mysql> quit - Erstellen Sie in der Systemaufforderung die Datenbank devportal:
> sqladmin -u devportal -p create devportal
Geben Sie das Passwort für devportal ein. - Melden Sie sich in MySQL an und gewähren Sie über die IP-Adresse des Portalservers Zugriff auf devportal:
mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';
, wobei portalIP die IP-Adresse des Portalservers und devportalPW das Passwort des devportal-Nutzers ist. - Bearbeiten Sie /etc/my.cnf und legen Sie „bind-address“ auf die IP-Adresse des MySQL-Servers fest.
- Starten Sie MySQL neu:
> /etc/init.d/mysqld restart - Achten Sie darauf, dass Port 3306 auf dem MySQL-Server geöffnet ist. Dieses Verfahren hängt von Ihrem Betriebssystem ab. Unter Linux können Sie beispielsweise den Befehl verwenden:
> /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT
Geben Sie bei der Installation von Developer Channel Services an, dass MySQL Server nicht lokal installiert werden soll. Sie werden dann aufgefordert, die IP-Adresse, den Nutzernamen und den Datenbanknamen der Remote-Datenbank einzugeben.
Anforderungen für Red Hat Enterprise Linux (RHEL)
Für RHEL gelten zusätzliche Anforderungen, da für den Zugriff auf Softwaredownloads von Red Hat ein Abo erforderlich ist. Der Server muss eine Verbindung zum Internet herstellen können, um RPMs über yum herunterzuladen. Bei Verwendung von RHEL muss der Server im Red Hat Network (RHN) und im optionalen Server-Kanal registriert sein.
Die Red Hat-Anforderungen werden während der Installation geprüft und Sie werden vom Portal-Installationsprogramm gefragt, ob RHEL noch nicht registriert ist. Wenn Sie bereits über Anmeldeinformationen für Red Hat verfügen, können Sie RHEL vor dem Beginn des Installationsvorgangs mit dem folgenden Befehl registrieren:
> subscription-manager register --username=my_username --password=my_password --auto-attach
Ersetzen Sie my_username und my_password durch Ihre Red Hat-Anmeldeinformationen.
Wenn Sie eine Testversion von RHEL haben, können Sie eine 30-Tage-Testlizenz erwerben. Weitere Informationen finden Sie unter https://access.redhat.com/solutions/32790.
SMTP-Anforderungen
Standardmäßig sendet das Portal E-Mails mithilfe der PHP-Funktion mail(). PHP versucht, E-Mails über Sendmail auf dem lokalen System zu senden. Dies kann in der Datei php.ini von PHP konfiguriert werden.
In einer Produktionsumgebung müssen Sie in Apigee einen SMTP-Server für das Senden von E-Mail-Nachrichten aus dem Portal konfigurieren. Daher müssen Sie dafür sorgen, dass Drupal auf den erforderlichen Port auf dem SMTP-Server zugreifen kann. Für Nicht-TLS-SMTP lautet die Portnummer normalerweise 25. Für TLS-fähiges SMTP ist dies häufig 465, wenden Sie sich an Ihren SMTP-Anbieter.
Zusätzliche Anforderungen
Um die Installation ausführen zu können, muss der Nutzer, der die Software installiert, Root-Zugriff haben.
Anforderungen an die Bereitstellungsarchitektur
Developer Channel Services haben über eine REST API eine einzige Schnittstelle mit dem Apigee Management Server, um Informationen zu den Anwendungen eines Nutzers zu speichern und abzurufen. Entwickler-Channel-Dienste müssen abhängig von Ihrer Installation über HTTP oder HTTPS eine Verbindung zum Management Server herstellen können.
Erforderliche Informationen vor Beginn der Installation
Bevor Sie mit der Installation beginnen, müssen Sie die folgenden Informationen zur Verfügung haben:
- Welche Plattform konfigurieren Sie: Red Hat oder CentOS? Wenn dies eine Red Hat-Installation ist, muss der Computer beim Red Hat Network registriert sein, um RPMs herunterladen zu können.
- Planen Sie die Installation von MySQL auf dem lokalen Computer? Bei einigen HA-Installationen muss MySQL auf einem anderen Computer als dem laufen, auf dem die Portal-Webseiten bereitgestellt werden. In diesem Fall sollten Sie MySQL nicht lokal installieren. Wenn Sie eine einfache Installation mit allem auf derselben Maschine wünschen, installieren Sie MySQL lokal.
- Wenn Sie auf einen MySQL-Remoteserver zugreifen möchten: Hostname, Port, Datenbankname, Nutzername und Passwort des MySQL-Remoteservers. Der Remote-MySQL-Server sollte bereits vor dem Start der Installation konfiguriert sein.
- Wie lautet der voll qualifizierte Domainname des Webservers? (Diese Informationen werden zu /etc/hosts hinzugefügt.) Dies sollte eine IP-Adresse oder ein Hostname sein, z. B. portalserver.beispiel.de. Der Standardwert ist localhost.
- Möchten Sie die Standardkonfiguration von Apigee für den virtuellen Host von Apache verwenden? Es wird ein virtueller Host mit dem Hostnamen erstellt, den Sie oben in Schritt 7 angegeben haben.
- Es gibt drei Informationen, die es Ihrem Portal ermöglichen, mit dem Apigee Edge-Verwaltungsserver zu kommunizieren. Diese Informationen lauten wie folgt:
- URL des Apigee Management API-Endpunkts: Dies ist entweder ein Hostname oder eine IP-Adresse. Dies ist der REST-Endpunkt, an den alle Aufrufe gerichtet werden, um Apps zu erstellen und Entwickler für App-Schlüssel zu registrieren. Der Standardendpunkt ist https://api.enterprise.apigee.com/v1.
Bei einer Edge for Private Cloud-Installation hat die URL folgende Form:
http://EdgeIp:8080/v1
oder:
https://EdgeIp:SSLport/v1
Dabei ist EdgeIp die IP-Adresse des Edge-Verwaltungsservers und SSLport der SSL-Port für die Edge-Verwaltungs-API. Beispiel: 8443. - Name der Apigee-Organisation: Zwischen Portalen und Apigee Edge-Organisationen besteht eine Beziehung. Sie richten die Standardorganisation ein, wenn Sie den Verwaltungs-API-Endpunkt einrichten. Der Standardwert ist „my-org“.
- Benutzername und Kennwort für den Verwaltungs-API-Endpunkt: Die Aufrufe des Portals an Edge müssen von einem Administrator für Ihre Organisation ausgeführt werden.
Dieser Benutzername/dieses Kennwort ist für einen Administrator in Ihrer Organisation bestimmt und sollte nur für die Verbindung mit Edge vom Portal aus verwendet werden. Wenn Sie beispielsweise die Anmeldeinformationen eines Benutzers angeben und dieser Benutzer jemals in Edge gelöscht wird, kann das Portal keine Verbindung mehr zu Edge herstellen. Erstellen Sie daher für Ihre Verbindung einen Administrator in Ihrer Organisation.
Beispiel:
dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd
- URL des Apigee Management API-Endpunkts: Dies ist entweder ein Hostname oder eine IP-Adresse. Dies ist der REST-Endpunkt, an den alle Aufrufe gerichtet werden, um Apps zu erstellen und Entwickler für App-Schlüssel zu registrieren. Der Standardendpunkt ist https://api.enterprise.apigee.com/v1.