Installazione del portale Servizi per gli sviluppatori

Developer Services Portal v. 4.16.09

Prima di eseguire l'installazione, assicurati che:

• Stai eseguendo l'installazione sulla versione a 64 bit di una versione supportata di Red Hat Enterprise Linux, CentOS o Oracle. Consulta l'elenco delle versioni supportate qui.
• Yum è installato.
• Esegui il backup delle installazioni esistenti. Se hai modificato il codice nel core di Drupal o in moduli non personalizzati, le modifiche verranno sovrascritte. Sono incluse, tra le altre cose, eventuali modifiche apportate a .htaccess. Devi presumere che tutto ciò che si trova al di fuori della directory /sites sia di proprietà di Drupal. Un'eccezione a questa regola è il file robots.txt; se questo file esiste nella directory principale del web, verrà conservato. Prima di procedere con l'installazione, esegui un backup dell'intera directory root web di Drupal. La posizione di installazione predefinita è /var/www/html, ma potresti averla modificata al momento dell'installazione. Dopo aver eseguito i passaggi di installazione descritti di seguito, puoi ripristinare le personalizzazioni dal backup.

Segui questi passaggi per installare il portale dei servizi per i canali per sviluppatori.

1. Acquista il bundle Developer Channel Services

Vai su http://community.apigee.com/content/apigee-customer-support e seleziona Accedi al portale di assistenza per richiedere il file .tar dei servizi per i canali per sviluppatori in uno dei due modi seguenti:

• Richiedi l'accesso alla directory di download di Edge for Private Cloud.
• Richiedi un URL per il file .tar di Developer Channel Services.

2. Testa la connessione ad Apigee Edge

Testa la connessione al server di gestione Edge eseguendo il seguente comando cURL da un prompt dei comandi sul server del portale:
> curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}

Dove EMAIL e PASSWORD sono l'indirizzo email e la password dell'amministratore per ORGNAME.

Assicurati di specificare il nome host e il numero di porta specifici per la tua installazione di Edge. La porta 8080 è quella predefinita utilizzata da Edge. Se ti connetti a un'organizzazione nel cloud, l'URL della richiesta è: https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}

Se l'operazione va a buon fine, questo comando restituisce una risposta simile alla seguente:
{
"createdAt" : 1348689232699,
"createdBy" : "USERNAME",
"displayName" : "cg",
"environments" : [ "test", "prod" ],
"lastModifiedAt" : 1348689232699,
"lastModifiedBy" : "foo@bar.com",
"name" : "cg",
"properties" : {
"property" : [ ]
},
"type" : "trial"
}

3. Rimuovi le versioni di PHP precedenti alla 7.0

Lo script di installazione verifica la presenza di versioni di PHP precedenti alla 7.0 sul sistema prima di avviare l'installazione. Se esistono versioni di PHP precedenti alla 7.0, viene visualizzato il seguente messaggio di avviso:

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

Per CentOS e Red Hat Enterprise Linux (RHEL), rimuovi i pacchetti PHP utilizzando il seguente comando:

yum remove <package-name>

4. Installa i servizi del canale per gli sviluppatori utilizzando lo script di installazione automatica

Utilizza una delle seguenti procedure per installare il portale a seconda che l'installazione avvenga su un server con o senza connessione a internet.

Su un server con una connessione a internet:

Per installare Developer Channel Services su un server con una connessione a internet:

1. Accedi al server come utente root o super utente.
2. Crea una directory per i file di installazione, ad esempio portal.
3. Passa alla nuova directory portal e scarica il file DeveloperServices_x.y.z.tar di Developer Channel Services, dove x.y.z corrisponde al numero di versione del portale.
   
   Puoi scaricare un file dal link inviato da Apigee in un browser o copiandolo e aggiungendolo al seguente comando cURL:
   > curl -kOL <paste link here>
4. Estrai i contenuti del file .tar di Developer Channel Services utilizzando il comando:
   > tar -xvf <tar file>
5. Passa alla directory DeveloperServices-4.x.y.z.
6. Esegui lo script di installazione utilizzando il seguente comando:
   > ./networked-install.sh
7. Rispondi ai prompt.

Su un server senza connessione a internet:

Innanzitutto, crea uno script di installazione non collegato alla rete su un sistema con una connessione a internet:

1. Accedi a un sistema con una connessione a internet come utente root o super utente.
2. Crea una directory per i file di installazione, ad esempio portal_tar.
3. Passa alla directory portal_tar e scarica il file DeveloperServices_x.y.z.tar di Developer Channel Services, dove x.y.z corrisponde al numero di versione del portale.
4. Estrai i contenuti del file .tar di Developer Channel Services utilizzando il comando:
   > tar -xvf <tar file>
5. Passa alla directory DeveloperServices-4.x.y.z.
6. Crea il file .tar.gz del portale utilizzando il comando:
   > ./non-networked-install.sh

Viene creato un nuovo file .tar.gz per l'installazione non in rete.

1. Accedi al server come utente root o super utente.
2. Crea una directory per i file di installazione, ad esempio portal.
3. Passa alla directory portal.
4. Copia il file .tar.gz che hai creato per l'installazione non in rete (nella procedura precedente) nella directory portal.
5. Estrai i contenuti del file .tar.gz utilizzando il comando:
   > tar -xvf <tar file>
6. Passa alla directory creata dal comando tar.
7. Imposta le autorizzazioni per lo script install-from-rpm-bundle.sh:
   > chmod 755 install-from-rpm-bundle.sh
8. Esegui lo script install-from-rpm-bundle.sh utilizzando il comando:
   > ./install-from-rpm-bundle.sh
9. Rispondi ai prompt.

5. Configura il portale per sviluppatori

Gran parte della configurazione del portale viene eseguita senza richiedere la tua interazione, ad esempio l'installazione del modulo Drupal e la creazione di contenuti predefiniti. Ti verrà chiesto di configurare il database, l'endpoint Edge e di creare un nuovo utente amministratore.

Per configurare il portale per sviluppatori:

1. Vai all'URL del server in un browser, ad esempio:
   http://localhost. In alternativa, se hai configurato un IP o un DNS specifico, vai a http://IP_address o http://DNS_name.
   
   Viene visualizzata la pagina di configurazione del database del profilo Apigee.
   
   Nota: in genere, avrai già configurato un nome host e lo avrai registrato con il tuo server DNS in modo da non dover utilizzare http://localhost.
2. Configura la connessione al database. Se il database si trova su una macchina remota, espandi la sezione Opzioni avanzate e inserisci le informazioni di connessione alla macchina, quindi seleziona Salva e continua.
3. Configura la connessione all'endpoint Apigee inserendo le seguenti informazioni, quindi seleziona Salva.
   Per ulteriori informazioni su questi valori, consulta "Informazioni richieste prima di iniziare l'installazione" in Requisiti del portale Servizi per sviluppatori.
   1. Organizzazione API di gestione
   2. URL dell'endpoint dell'API di gestione
   3. Endpoint Authenticated User
   4. Password degli utenti autenticati
4. Configura l'utente amministratore inserendo le seguenti informazioni, quindi seleziona Salva. Tieni presente che Drupal crea un utente amministratore denominato "admin" per impostazione predefinita, quindi non utilizzare "admin" come nome utente.
   Se salti questo passaggio, puoi comunque utilizzare Drush per creare un amministratore come descritto di seguito al punto 4. Crea un utente amministratore.
   1. Nome e cognome dello sviluppatore
   2. Nome utente del portale per sviluppatori
   3. Password
   4. Indirizzo email
5. Al termine dell'installazione, imposta le autorizzazioni per il file settings.php:
   > chmod 640 /var/www/html/sites/default/settings.php
6. Vai alla home page del portale all'indirizzo http://localhost/ o al nome DNS del tuo portale.
7. Accedi al portale utilizzando le credenziali di amministratore.

6. Crea un utente amministratore (facoltativo)

Utilizza Drush per creare un utente amministrativo per l'installazione di Developer Channel Services. Drupal crea automaticamente un utente amministratore denominato "admin" per impostazione predefinita, quindi non utilizzare "admin" come nome utente.

1. Passa alla directory drupal_root/sites/default. La posizione standard della directory root di Drupal è /var/www/html:
   > cd <drupal_root>/sites/default
2. Assicurati di disporre delle autorizzazioni in scrittura sui file Drupal privati:
   > drush vget file_private_path
   
   Questo comando restituisce il percorso dei file Drupal privati, ad esempio:
   file_private_path: 'sites/default/private'
   
   Corrispondente a /var/www/html/sites/default/private/. Utilizza il seguente comando per assicurarti che questa directory sia scrivibile dal proprietario e dal gruppo:
   chmod -R g+w dirPathAndName
   chmod -R o+r dirPathAndName
3. Inserisci i seguenti comandi per creare un utente amministratore, sostituendo i comandi tra "< >" con i tuoi valori:
   > drush user-create <username> --mail="<email-address>" --password="<password>"
   > drush user-add-role Administrator <username>
4. Accedi al portale per sviluppatori come amministratore utilizzando il nome utente e la password specificati sopra.

5. Imposta la password root di MySQL

Se hai installato MySQL nell'ambito dell'installazione del portale, lo script di installazione lascia la password root di MySQL impostata sul valore predefinito, che è vuoto.

Utilizza il seguente comando per impostare la password root:

> mysqladmin -u root password NEWPASSWORD

Se hai già impostato la password root e vuoi modificarla, utilizza il seguente comando:

> mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD

Devi anche aggiornare la password nel file /var/www/html/sites/default/settings.php.

6. Assicurati che il modulo Update manager sia abilitato

Per ricevere notifiche sugli aggiornamenti di Drupal, assicurati che il modulo Drupal Update manager sia abilitato. Dal menu Drupal, seleziona Modules (Moduli) e scorri verso il basso fino al modulo Update manager (Gestore aggiornamenti). Se non è abilitata, abilitala.

Una volta abilitata, puoi visualizzare gli aggiornamenti disponibili utilizzando la voce di menu Report > Aggiornamenti disponibili. Puoi anche utilizzare il seguente comando Drush:

> drush pm-info update

Utilizza la voce di menu Report > Aggiornamenti disponibili > Impostazioni per configurare il modulo in modo che ti invii un'email quando sono disponibili aggiornamenti e per impostare la frequenza di controllo degli aggiornamenti.

7. (Facoltativo) Esegui il deployment su un server di produzione

Se esegui il deployment del portale su un server di produzione, devi eseguire ulteriori passaggi di sicurezza, tra cui:

1. Esegui il seguente script per proteggere l'installazione di MySQL:
   > /usr/bin/mysql_secure_installation
   
   Questo script imposta la password root e ti offre la possibilità di limitare l'accesso root solo a localhost e di rimuovere i database di test e l'utente anonimo creato per impostazione predefinita. L'esecuzione di questo script è vivamente consigliata per i server di produzione.
2. Se richiesto dalle policy aziendali, attiva e configura SELinux.

8. Configura il motore di ricerca Apache Solr (facoltativo)

Per impostazione predefinita, i moduli Drupal che si connettono al motore di ricerca Apache Solr sono disattivati quando installi il portale. La maggior parte dei portali utilizza il motore di ricerca interno di Drupal e pertanto non richiede i moduli Solr di Drupal.

Se decidi di utilizzare Solr come motore di ricerca, devi installare Solr localmente sul tuo server, quindi attivare e configurare i moduli Solr di Drupal sul portale.

Per attivare i moduli Drupal Solr:

1. Accedi al portale come utente con privilegi di amministratore o di creazione di contenuti.
2. Seleziona Moduli nel menu di Drupal.
3. Attiva il modulo Apache Solr Framework e il modulo Apache Solr Search.
4. Salva le modifiche.
5. Configura Solr come descritto all'indirizzo https://drupal.org/node/1999280.

9. Installa mod_ssl per supportare HTTPS (facoltativo)

Il modulo mod_ssl viene utilizzato dal server web Apache per pubblicare pagine web tramite HTTPS. Se vuoi utilizzare HTTPS, utilizza il seguente comando per installare mod_ssl:

> yum install mod_ssl

Per saperne di più sulla configurazione del portale per l'utilizzo di SSL, consulta http://apigee.com/docs/developer-services/content/using-ssl-portal.

10. Installa SmartDocs (facoltativo)

SmartDocs ti consente di documentare le tue API sul portale dei servizi per sviluppatori in modo da rendere la documentazione dell'API completamente interattiva. Tuttavia, per utilizzare SmartDocs con il portale, devi prima installare SmartDocs su Edge.

• Se stai connettendo il portale a un'installazione di Edge Cloud, SmartDocs è già installato e non è necessaria alcuna ulteriore configurazione.
• Se stai connettendo il portale a un'installazione di Edge for Private Cloud, devi assicurarti che SmartDocs sia installato su Edge. Per saperne di più sull'installazione di Edge e SmartDocs, consulta Installa SmartDocs.

Per saperne di più su SmartDocs, consulta Utilizzo di SmartDocs per documentare le API.

11. E adesso?

I passaggi successivi all'installazione del portale Developer Services consistono nella configurazione e nella personalizzazione in base ai tuoi requisiti specifici. La documentazione sul sito web di Apigee contiene tutte le informazioni sulla configurazione, sullo stile e sulla gestione di un portale. Accedi alla documentazione all'indirizzo http://apigee.com/docs/developer-services/content/what-developer-portal.

La tabella seguente elenca alcune delle attività più comuni che esegui dopo l'installazione e include link alla documentazione di Apigee dove puoi trovare ulteriori informazioni: