Wymagania związane z portalem dla programistów

Developer Services Portal w wersji 4.16.09

Poniżej przedstawiono wymagania dotyczące sprzętu i oprogramowania do instalacji.

Sprzęt

Wymaganie

System operacyjny

Te instrukcje instalacji i dołączone pliki instalacyjne zostały przetestowane w systemach operacyjnych wymienionych na stronie https://apigee.com/docs/api-services/reference/supported-software.

RAM

1 GB

Dysk twardy

10 GB

Interfejs sieci

Wymagane jest aktywne połączenie z internetem.

Podczas instalacji instalator pobiera zasoby z internetu. Jeśli Twoje środowisko jest skonfigurowane pod kątem wysyłania żądań HTTP i HTTPS przez serwer proxy, musisz tak skonfigurować serwer proxy, by prawidłowo obsługiwał żądania przekierowania, które mogą występować podczas pobierania.

Na przykład żądanie do https://drupal.org/ zwraca kod stanu HTTP 301 i przekierowuje na stronę https://www.drupal.org/.

Serwer proxy powinien być skonfigurowany tak, aby zwracał kod stanu HTTP 200 z żądaną treścią z przekierowania.

W przypadku instalacji SAP, jeśli w Twoim środowisku skonfigurowano serwer proxy wobec wychodzących żądań HTTPS, serwer proxy musi obsługiwać protokół TLSv1.0. OpenSSL w wersji 0.9.8 nie obsługuje TLS 1.1 ani TLS 1.2 – tylko TLS 1.0.

Wymagania dotyczące bazy danych MySQL

Jeśli zdecydujesz się zainstalować serwer MySQL na tym samym komputerze, na którym znajdują się usługi kanału programisty, w topologii pojedynczej maszyny instalator usług kanału programisty poprosi o podanie nazwy bazy danych i użytkownika bazy danych, a następnie zainstaluje serwer MySQL i utworzy schemat bazy danych za Ciebie. Zainstalowana wersja to najnowsza wersja dostępna dla Twojego systemu operacyjnego.

Jeśli chcesz zainstalować serwer MySQL w osobnym systemie, musisz mieć w nim zainstalowany serwer MySQL, zanim uruchomisz instalator usług kanału dla programistów. Musisz mieć zainstalowaną MySQL w wersji 5.0.15 lub nowszej.

Instalator usług kanału programisty wymaga, aby serwer MySQL zawierał bazę danych z pustym schematem bazy danych. Instalator usług kanału programisty poprosi o podanie nazwy hosta i nazwy bazy danych oraz użytkownika bazy danych. Instalator łączy się następnie z bazą danych, aby utworzyć domyślne tabele i dane bazy danych.

Użytkownik bazy danych jest używany przez usługi kanału dewelopera do łączenia się z bazą danych i musi mieć te uprawnienia: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TYMPORARY TABLES, LOCK TABLES.

Aby na przykład utworzyć bazę danych o nazwie devportal i użytkownika devportal:

  1. Zainstaluj serwer MySQL w systemie.
  2. Zaloguj się w MySQL jako użytkownik root za pomocą polecenia:
    > mysql -u root -p
  3. Gdy pojawi się prośba, wpisz hasło roota.
  4. W oknie wiersza mysql> wpisz te informacje, aby utworzyć użytkownika devportal:
    mysql>create user 'devportal'@'localhost' agencji 'devportal';
    mysql> przyzna wszystkie uprawnienia dotyczące *.* to 'devportal'@'localhost';
    mysql> flush permissions;
    mysql> flushPoinformuj
  5. Po wyświetleniu monitu utwórz bazę danych devportal:
    > mysqladmin -u devportal -p create devportal

    Wpisz hasło do devportal.
  6. Zaloguj się w MySQL i przyznaj dostęp do devportal z adresu IP serwera portalu:
    mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';

    gdzie portalIP to adres IP serwera portalu, a devportalPW to hasło użytkownika devportal.
  7. Edytuj plik /etc/my.cnf, aby ustawić adres powiązania na adres IP serwera MySQL.
  8. Uruchom ponownie MySQL:
    > /etc/init.d/mysqld restart
  9. Upewnij się, że na serwerze MySQL jest otwarty port 3306. Ta procedura zależy od Twojego systemu operacyjnego. Na przykład w systemie Linux użyj polecenia:
    > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j AKCEPTUJ

Podczas instalowania usług kanału programisty zaznacz, aby nie instalować serwera MySQL lokalnie. Pojawi się prośba o wpisanie adresu IP, nazwy użytkownika i nazwy zdalnej bazy danych.

Wymagania dotyczące systemu Red Hat Enterprise Linux (RHEL)

RHEL ma dodatkowe wymagania ze względu na subskrypcję wymaganą do uzyskania dostępu do oprogramowania, które można pobrać z Red Hat. Serwer musi mieć połączenie z internetem, aby pobrać RPM przez yum. Jeśli korzystasz z RHEL, serwer musi być zarejestrowany w sieci Red Hat Network (RHN) i musi być zarejestrowany w opcjonalnym kanale serwera.

Podczas instalacji sprawdzane są wymagania Red Hat, a instalator portalu wyświetla komunikat, jeśli usługa RHEL nie jest jeszcze zarejestrowana. Jeśli masz już dane logowania do Red Hat, przed rozpoczęciem procesu instalacji możesz zarejestrować RHEL za pomocą tego polecenia:

> subscription-manager register --username=my_username --password=my_password --auto-attach 

Zastąp wartości my_username i my_password swoimi danymi logowania do Red Hat.

Jeśli używasz wersji próbnej RHEL, możesz otrzymać 30-dniową licencję próbną. Więcej informacji znajdziesz na stronie https://access.redhat.com/solutions/32790.

Wymagania SMTP

Domyślnie portal wysyła pocztę przy użyciu funkcji PHP mail(). PHP próbuje wysyłać e-maile za pomocą funkcji sendmail w systemie lokalnym, którą można skonfigurować w pliku php.ini.

W środowisku produkcyjnym Apigee wymaga skonfigurowania serwera SMTP do wysyłania e-maili z portalu. Dlatego musisz się upewnić, że Drupal ma dostęp do niezbędnego portu na serwerze SMTP. W przypadku serwera SMTP bez szyfrowania TLS numer portu to zwykle 25. W przypadku SMTP z włączonym TLS jest to często 465, ale skontaktuj się z dostawcą SMTP.

Dodatkowe wymagania

Aby można było przeprowadzić instalację, użytkownik, który instaluje oprogramowanie, musi mieć dostęp na poziomie roota.

Wymagania dotyczące architektury wdrożenia

Usługi kanału dla programistów mają jeden interfejs z serwerem Apigee Management Server oparty na interfejsie API REST, który służy do przechowywania i pobierania informacji o aplikacjach użytkownika. W zależności od instalacji usługi kanału dewelopera muszą mieć możliwość połączenia się z serwerem zarządzania przez HTTP lub HTTPS.

Informacje wymagane przed rozpoczęciem instalacji

Przed rozpoczęciem instalacji przygotuj te informacje:

  1. Którą platformę konfigurujesz: Red Hat czy CentOS? W przypadku instalacji Red Hat urządzenie musi być zarejestrowane w sieci Red Hat Network, aby można było pobierać RPM.
  2. Czy planujesz zainstalować MySQL na komputerze lokalnym? Niektóre instalacje o wysokiej dostępności wymagają MySQL na innym komputerze niż ten, który obsługuje strony internetowe portalu. W takim przypadku nie instaluj MySQL lokalnie. Jeśli chcesz prostą instalację ze wszystkimi elementami na tym samym komputerze, zainstaluj MySQL lokalnie.
  3. Jeśli chcesz uzyskać dostęp do zdalnego serwera MySQL, podaj nazwę hosta, port, nazwę bazy danych, nazwę użytkownika i hasło zdalnego serwera MySQL. Przed rozpoczęciem instalacji musisz skonfigurować zdalny serwer MySQL.
  4. Jaka jest pełna i jednoznaczna nazwa domeny serwera WWW? (Te informacje zostaną dodane do katalogu /etc/hosts). Powinien to być adres IP lub nazwa hosta, na przykład portalserver.example.com. Wartość domyślna to localhost.
  5. Czy chcesz użyć domyślnej konfiguracji Apigee dla hosta wirtualnego Apache? Zostanie utworzony jeden host wirtualny o nazwie określonej powyżej w kroku 7.
  6. Istnieją 3 informacje, które umożliwiają portalowi komunikację z serwerem zarządzania brzegowym Apigee. Informacje te:
    1. URL punktu końcowego Apigee Management API: jest to nazwa hosta lub adres IP. To jest punkt końcowy REST, do którego są wysyłane wszystkie wywołania w celu tworzenia aplikacji i rejestrowania programistów dla kluczy aplikacji. Domyślny punkt końcowy to https://api.enterprise.apigee.com/v1.

      W przypadku instalacji Edge dla Private Cloud adres URL ma postać:
      http://EdgeIp:8080/v1

      lub:
      https://EdgeIp:SSLport/v1

      Gdzie EdgeIp to adres IP serwera Edge dla serwera Edge Na przykład: 8443.
    2. Nazwa organizacji Apigee: istnieje relacja między portalami a organizacjami Apigee Edge. Domyślna organizacja skonfigurujesz podczas konfigurowania punktu końcowego interfejsu Management API. Wartość domyślna to moja-organizacja.
    3. Nazwa użytkownika i hasło do punktu końcowego interfejsu API zarządzania: wywołania portalu do Edge muszą być wykonywane przez administratora Twojej organizacji.

      Ta nazwa użytkownika/hasło są przeznaczone dla administratora Twojej organizacji i powinny być używane tylko do łączenia się z Edge z poziomu portalu. Jeśli na przykład podasz dane logowania użytkownika, a ten użytkownik zostanie kiedykolwiek usunięty w Edge, portal nie będzie już mógł połączyć się z Edge. Dlatego utwórz administratora w organizacji tylko na potrzeby tego połączenia.

      Na przykład:
      dc_devportal+ORGNAME@apigee.com:MójP@ssw0rd