Requisiti del portale Servizi per gli sviluppatori

Portale per i servizi per gli sviluppatori v. 4.16.09

Di seguito sono riportati i requisiti hardware e software per l'installazione.

Hardware

Requisito

Sistema operativo

Queste istruzioni di installazione e i file di installazione forniti sono stati testati sui sistemi operativi elencati qui: https://apigee.com/docs/api-services/reference/supported-software

RAM

1 GB

Disco rigido

10 GB

Interfaccia di rete

È necessaria una connessione a internet attiva.

Nell'ambito del processo di installazione, il programma di installazione scarica le risorse dal web. Se il tuo ambiente è configurato per eseguire il proxy per le richieste HTTP e HTTPS in uscita, il proxy deve essere configurato in modo da gestire correttamente le richieste reindirizzate che potrebbero verificarsi durante un download.

Ad esempio, una richiesta a https://drupal.org/ restituisce un codice di stato HTTP 301 e reindirizza a https://www.drupal.org/.

Il proxy deve essere configurato per restituire un codice di stato HTTP 200 con i contenuti richiesti dal reindirizzamento.

Per le installazioni SAP, se il tuo ambiente è configurato per eseguire il proxy delle richieste HTTPS in uscita, il proxy deve supportare TLSv1.0. OpenSSL 0.9.8 non supporta TLSv1.1 o TLSv1.2, solo TLSv1.0.

Requisiti del database MySQL

Se scegli di installare il server MySQL sulla stessa macchina di Developer Channel Services, per la topologia a macchina singola, il programma di installazione di Developer Channel Services ti chiede di inserire il nome del database e l'utente del database, quindi installa MySQL Server e crea lo schema del database per te. La versione installata è l'ultima disponibile per il tuo sistema operativo.

Se vuoi che il server MySQL sia installato su un sistema separato, devi aver già installato il server MySQL su quel sistema prima di avviare il programma di installazione di Developer Channel Services. Devi aver installato MySQL 5.0.15 o versioni successive.

Il programma di installazione di Developer Channel Services richiede che MySQL Server contenga un database con un schema vuoto. Il programma di installazione di Developer Channel Services ti chiede il nome host, il nome e l'utente del database. Il programma di installazione si connette quindi al database per creare i dati e le tabelle di database predefinite.

L'utente del database viene utilizzato da Developer Channel Services per connettersi al database e deve avere i seguenti privilegi: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES.

Ad esempio, per creare un database denominato devportal e un utente denominato devportal:

  1. Installa MySQL Server sul sistema.
  2. Accedi a MySQL come utente root utilizzando il comando:
    > mysql -u root -p
  3. Quando richiesto, inserisci la password di root.
  4. Al prompt mysql>, inserisci quanto segue per creare l'utente devportal:
    mysql>create user 'devportal'@'localhost' identified by 'devportal';
    mysql> grant all privileges on *.* to 'devportal'@'localhost';
    mysql> flush privileges;
    mysql> quit
  5. Al prompt del sistema, crea il database devportal:
    > mysqladmin -u devportal -p create devportal

    Inserisci la password di devportal.
  6. Accedi a MySQL e concedi l'accesso a devportal dall'IP del server del portale:
    mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';

    dove portalIP è l'indirizzo IP del server del portale e devportalPW è la password dell'utente devportal.
  7. Modifica /etc/my.cnf per impostare bind-address sull'indirizzo IP del server MySQL.
  8. Riavvia MySQL:
    > /etc/init.d/mysqld restart
  9. Assicurati che la porta 3306 sia aperta sul server MySQL. Questa procedura si basa sul tuo sistema operativo. Ad esempio, per Linux, utilizza il comando:
    > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT

Quando installi Developer Channel Services, specifica di non installare MySQL Server localmente. Ti verrà quindi chiesto di inserire l'indirizzo IP, il nome utente e il nome del database remoto.

Requisiti di Red Hat Enterprise Linux (RHEL)

RHEL ha requisiti aggiuntivi a causa di un abbonamento necessario per accedere ai download di software da Red Hat. Il server deve essere in grado di connettersi a internet per scaricare gli RPM tramite yum. Se utilizzi RHEL, il server deve essere registrato su Red Hat Network (RHN) e sul canale facoltativo del server.

I requisiti di Red Hat vengono controllati durante l'installazione e il programma di installazione del portale ti chiede se RHEL non è già registrato. Se disponi già delle credenziali di accesso a Red Hat, puoi utilizzare il seguente comando per registrare RHEL prima di iniziare il processo di installazione:

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

Sostituisci my_username e my_password con le tue credenziali Red Hat.

Se hai una versione di prova di RHEL, puoi ottenere una licenza di prova di 30 giorni. Per ulteriori informazioni, visita la pagina https://access.redhat.com/solutions/32790.

Requisiti SMTP

Per impostazione predefinita, il portale invia la posta utilizzando la funzione PHP mail(). PHP tenta di inviare email utilizzando sendmail sul sistema locale, che può essere configurato nel file php.ini di PHP.

In un ambiente di produzione, Apigee richiede la configurazione di un server SMTP per l'invio di messaggi email dal portale. Pertanto, devi assicurarti che Drupal possa accedere alla porta necessaria sul server SMTP. Per SMTP non TLS, il numero di porta è in genere 25. Per SMTP con TLS abilitato, spesso è 465, ma rivolgiti al tuo provider SMTP.

Requisiti aggiuntivi

Per eseguire l'installazione, l'utente che installa il software deve disporre dell'accesso come amministratore.

Requisiti dell'architettura di deployment

Developer Channel Services ha un'unica interfaccia con il server di gestione Apigee tramite un'API REST per archiviare e recuperare le informazioni sulle applicazioni di un utente. I servizi del canale sviluppatore dovranno essere in grado di connettersi al server di gestione tramite HTTP o HTTPS, a seconda dell'installazione.

Informazioni richieste prima di iniziare l'installazione

Prima di iniziare l'installazione, devi disporre delle seguenti informazioni:

  1. Quale piattaforma stai configurando: Red Hat o CentOS? Se si tratta di un'installazione Red Hat, la macchina deve essere registrata sulla Red Hat Network per scaricare gli RPM.
  2. Hai intenzione di installare MySQL sulla macchina locale? Alcune installazioni ad alta disponibilità richiedono che MySQL si trovi su una macchina diversa da quella che serve le pagine web del portale. In questo caso, non installare MySQL localmente. Se vuoi un'installazione semplice con tutto sulla stessa macchina, installa MySQL localmente.
  3. Se intendi accedere a un server MySQL remoto, il nome host, la porta, il nome del database, il nome utente e la password del server MySQL remoto. Il server MySQL remoto deve essere già configurato prima di avviare l'installazione.
  4. Qual è il nome di dominio completo del server web? Queste informazioni verranno aggiunte a /etc/hosts. Deve essere un indirizzo IP o un nome host, ad esempio portalserver.example.com. Il valore predefinito è localhost.
  5. Vuoi utilizzare la configurazione predefinita di Apigee per l'host virtuale di Apache? Viene creato un host virtuale con il nome host specificato sopra nel passaggio 7.
  6. Esistono tre informazioni che consentono al tuo portale di comunicare con il server di gestione Apigee Edge. Queste informazioni sono le seguenti:
    1. URL dell'endpoint dell'API Apigee Management: può essere un nome host o un indirizzo IP. Questo è l'endpoint REST a cui vengono effettuate tutte le chiamate per creare app e registrare gli sviluppatori per le chiavi delle app. L'endpoint predefinito è https://api.enterprise.apigee.com/v1.

      Per un'installazione di Edge per Private Cloud, l'URL è nel seguente formato:
      http://EdgeIp:8080/v1

      oppure:
      https://EdgeIp:SSLport/v1

      dove EdgeIp è l'indirizzo IP del server di gestione di Edge e SSLport è la porta SSL per l'API di gestione di Edge. Ad esempio, 8443.
    2. Nome organizzazione Apigee: esiste una relazione tra i portali e le organizzazioni Apigee Edge. L'organizzazione predefinita verrà configurata quando configurerai l'endpoint API di gestione. Il valore predefinito è my-org.
    3. Nome utente e password per l'endpoint dell'API di gestione: le chiamate dal portale a Edge devono essere eseguite da un amministratore della tua organizzazione.

      Questo nome utente e questa password sono destinati a un amministratore della tua organizzazione e devono essere utilizzati solo per connettersi a Edge dal portale. Ad esempio, se specifichi le credenziali di un utente e questo viene eliminato su Edge, il portale non potrà più collegarsi a Edge. Pertanto, crea un amministratore nella tua organizzazione solo per questa connessione.

      Ad esempio:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd