Wymagania związane z portalem dla programistów

Developer Services Portal w wersji 4.16.09

Poniżej znajdziesz wymagania dotyczące sprzętu i oprogramowania.

Sprzęt

Wymaganie

System operacyjny

Te instrukcje instalacji i dostarczone pliki instalacyjne zostały przetestowane w systemach operacyjnych wymienionych tutaj: https://apigee.com/docs/api-services/reference/supported-software

Pamięć RAM

1 GB

Dysk twardy

10 GB

Interfejs sieci

Wymagane jest aktywne połączenie z internetem.

Podczas procesu instalacji instalator pobiera zasoby z internetu. Jeśli Twoje środowisko jest skonfigurowane do przekazywania wychodzących żądań HTTP i HTTPS, serwer proxy musi być skonfigurowany tak, aby prawidłowo obsługiwał przekierowane żądania, które mogą wystąpić podczas pobierania.

Na przykład żądanie wysłane do https://drupal.org/ zwraca kod stanu HTTP 301 i przekierowuje do 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 środowisko jest skonfigurowane do przekazywania wychodzących żądań HTTPS przez serwer proxy, musi on obsługiwać protokół TLSv1.0. OpenSSL 0.9.8 nie obsługuje TLSv1.1 ani TLSv1.2, tylko TLSv1.0.

Wymagania dotyczące bazy danych MySQL

Jeśli zdecydujesz się zainstalować serwer MySQL na tym samym komputerze co usługi kanału dla programistów (topologia z jednym komputerem), instalator usług kanału dla programistów poprosi Cię o podanie nazwy bazy danych i użytkownika bazy danych, a następnie zainstaluje serwer MySQL i utworzy schemat bazy danych. Zainstalowana wersja jest najnowszą wersją dostępną dla Twojego systemu operacyjnego.

Jeśli chcesz zainstalować serwer MySQL w osobnym systemie, musisz zainstalować go w tym systemie przed uruchomieniem instalatora usług kanału dla programistów. Musisz mieć zainstalowaną bazę danych MySQL w wersji 5.0.15 lub nowszej.

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

Użytkownik bazy danych jest używany przez usługi kanału dla programistów do nawiązywania połączenia z bazą danych i musi mieć te uprawnienia: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES.

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

  1. Zainstaluj serwer MySQL w systemie.
  2. Zaloguj się w MySQL jako użytkownik root, używając polecenia:
    > mysql -u root -p
  3. Gdy pojawi się prośba, wpisz hasło roota.
  4. W wierszu polecenia mysql> wpisz te polecenia, aby utworzyć użytkownika devportal:
    mysql>create user 'devportal'@'localhost' identified by 'devportal';
    mysql> grant all privileges on *.* to 'devportal'@'localhost';
    mysql> flush privileges;
    mysql> quit
  5. W wierszu poleceń systemu utwórz bazę danych devportal:
    > mysqladmin -u devportal -p create devportal

    Wpisz hasło 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. Zmodyfikuj plik /etc/my.cnf, aby ustawić bind-address na adres IP serwera MySQL.
  8. Uruchom ponownie MySQL:
    > /etc/init.d/mysqld restart
  9. Upewnij się, że port 3306 jest otwarty na serwerze MySQL. Ta procedura zależy od systemu operacyjnego. Na przykład w systemie Linux użyj polecenia:
    > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT

Podczas instalowania usług kanału dla programistów określ, że nie chcesz instalować serwera MySQL lokalnie. Następnie pojawi się prośba o podanie adresu IP, nazwy użytkownika i nazwy bazy danych zdalnej bazy danych.

Wymagania dotyczące Red Hat Enterprise Linux (RHEL)

RHEL ma dodatkowe wymagania ze względu na subskrypcję potrzebną do uzyskania dostępu do oprogramowania do pobrania od Red Hat. Serwer musi mieć możliwość połączenia się z internetem, aby pobierać pakiety RPM za pomocą yum. Jeśli używasz RHEL, serwer musi być zarejestrowany w Red Hat Network (RHN) i zarejestrowany w opcjonalnym kanale serwera.

Wymagania Red Hat są sprawdzane podczas instalacji, a instalator portalu wyświetla prośbę, jeśli system RHEL nie jest jeszcze zarejestrowany. Jeśli masz już dane logowania 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 my_username i my_password swoimi danymi logowania do Red Hat.

Jeśli masz wersję próbną RHEL, możesz uzyskać 30-dniową licencję próbną. Więcej informacji można znaleźć na stronie https://access.redhat.com/solutions/32790.

Wymagania dotyczące SMTP

Domyślnie portal wysyła pocztę za pomocą funkcji PHP mail(). PHP próbuje wysłać e-maila za pomocą sendmaila w systemie lokalnym, który można skonfigurować w pliku php.ini PHP.

W środowisku produkcyjnym Apigee wymaga skonfigurowania serwera SMTP do wysyłania e-maili z portalu. Dlatego musisz upewnić się, że Drupal ma dostęp do wymaganego portu na serwerze SMTP. W przypadku SMTP bez TLS numer portu to zwykle 25. W przypadku protokołu SMTP z obsługą TLS jest to często 465, ale sprawdź to u dostawcy SMTP.

Dodatkowe wymagania

Aby przeprowadzić instalację, użytkownik instalujący oprogramowanie musi mieć dostęp na poziomie roota.

Wymagania dotyczące architektury wdrożenia

Usługi kanału dla deweloperów mają jeden interfejs z serwerem zarządzania Apigee przez interfejs API REST, który umożliwia przechowywanie i pobieranie informacji o aplikacjach użytkownika. Usługi kanału dla programistów muszą mieć możliwość połączenia się z serwerem zarządzania przez HTTP lub HTTPS, w zależności od instalacji.

Informacje wymagane przed rozpoczęciem instalacji

Zanim rozpoczniesz instalację, musisz mieć te informacje:

  1. Którą platformę konfigurujesz: Red Hat czy CentOS? Jeśli jest to instalacja Red Hat, komputer musi być zarejestrowany w sieci Red Hat, aby można było pobierać pakiety RPM.
  2. Czy planujesz zainstalować MySQL na komputerze lokalnym? Niektóre instalacje HA wymagają, aby MySQL znajdował się na innym komputerze niż ten, który obsługuje strony internetowe portalu. W takim przypadku nie instaluj MySQL lokalnie. Jeśli chcesz przeprowadzić prostą instalację, w której wszystkie elementy znajdują się na tym samym komputerze, zainstaluj MySQL lokalnie.
  3. Jeśli chcesz uzyskać dostęp do zdalnego serwera MySQL, musisz podać nazwę hosta, port, nazwę bazy danych, nazwę użytkownika i hasło do zdalnego serwera MySQL. Przed rozpoczęciem instalacji należy skonfigurować zdalny serwer MySQL.
  4. Jaka jest pełna i jednoznaczna nazwa domeny serwera WWW? (Te informacje zostaną dodane do pliku /etc/hosts). Powinien to być adres IP lub nazwa hosta, np. portalserver.example.com. Wartość domyślna to localhost.
  5. Czy chcesz użyć domyślnej konfiguracji Apigee dla hosta wirtualnego Apache? Zostanie utworzony 1 host wirtualny o nazwie hosta określonej w kroku 7 powyżej.
  6. Istnieją 3 informacje, które umożliwiają portalowi komunikację z serwerem zarządzania Apigee Edge. Są to:
    1. URL punktu końcowego interfejsu API zarządzania Apigee: będzie to nazwa hosta lub adres IP. Jest to punkt końcowy REST, do którego wykonywane są wszystkie wywołania w celu tworzenia aplikacji i rejestrowania deweloperów na potrzeby kluczy aplikacji. Domyślny punkt końcowy to https://api.enterprise.apigee.com/v1.

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

      lub:
      https://EdgeIp:SSLport/v1

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

      Ta nazwa użytkownika i hasło są przeznaczone dla administratora w 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 usunięty z Edge, portal nie będzie mógł się już połączyć z Edge. Dlatego utwórz administratora w organizacji tylko na potrzeby tego połączenia.

      Na przykład:
      dc_devportal+NAZWAORGANIZACJI@apigee.com:MojeH@sło