Edge per Private Cloud v4.19.01
Prima di installare il portale Servizi per gli sviluppatori Apigee (o semplicemente, il portale), assicurati che:
- Devi installare Postgres prima di installare il portale. Puoi installare Postgres durante l'installazione di Edge o installare Postgres standalone per l'utilizzo da parte del portale.
- Se installi Postgres autonomo, può trovarsi sullo stesso nodo del portale.
- Se ti stai connettendo a Postgres installato come parte di Edge e Postgres è configurato in modalità master/standby, specifica l'indirizzo IP del server Postgres master.
- 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 in Software e versioni supportate.
- Yum è installato.
Il programma di installazione include solo i moduli forniti da Drupal richiesti dal portale Apigee Developer Services (o semplicemente, dal portale). Per informazioni sull'installazione di altri moduli forniti, consulta Estensione di Drupal 7.
Panoramica dell'installazione
Per installare il portale, segui questi passaggi. Ciascuno di questi passaggi è descritto in maggiore dettaglio nelle sezioni seguenti.
- Verificare la connessione
- Rimuovere le versioni di PHP precedenti alla 7.0
- Installare Postgres
- Installa il portale
- Assicurati che il gestore aggiornamenti sia abilitato
- (Facoltativo) Configurare Apache Solr
- (Facoltativo) Installare SmartDocumenti
- (Facoltativo) Configurare JQuery
Ritiro della proprietà SMTPSSL
Nelle release precedenti, utilizzavi la proprietà SMTPSSL
per
impostare il protocollo utilizzato dal server SMTP connesso al portale. Questa proprietà è stata
deprecata.
Ora puoi utilizzare la proprietà SMTP_PROTOCOL
,
anziché la proprietà SMTPSSL
, per impostare il
protocollo utilizzato dal server SMTP connesso al portale. I valori validi sono: "standard", "ssl" o "tls".
Crea un file di configurazione per il portale
Di seguito è mostrato un esempio di file di configurazione silenziosa per l'installazione di un portale. Modifica questo file in base alle esigenze della tua configurazione. Utilizza l'opzione -f per setup.sh
per includere questo
file.
IP1=IPorDNSnameOfNode # Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost. HOSTIP=$(hostname -i) # Specify the name of the portal database in Postgres. PG_NAME=devportal # Specify the Postgres admin credentials. # The portal connects to Postgres by using the 'apigee' user. # If you changed the Postgres password from the default of 'postgres' # then set PG_PWD accordingly. # If connecting to a Postgres node installed with Edge, # contact the Edge sys admin to get these credentials. PG_USER=apigee PG_PWD=postgres # The IP address of the Postgres server. # If it is installed on the same node as the portal, specify that IP. # If connecting to a remote Postgres server,specify its IP address. PG_HOST=$IP1 # The Postgres user credentials used by the portal # to access the Postgres database, # This account is created if it does not already exist. DRUPAL_PG_USER=drupaladmin DRUPAL_PG_PASS=portalSecret # Specify 'postgres' as the database. DEFAULT_DB=postgres # Specify the Drupal admin account details. # DO NOT set DEVPORTAL_ADMIN_USERNAME=admin. # The installer creates this user on the portal. DEVPORTAL_ADMIN_FIRSTNAME=firstName DEVPORTAL_ADMIN_LASTNAME=lastName DEVPORTAL_ADMIN_USERNAME=userName DEVPORTAL_ADMIN_PWD=PORTAL_ADMIN_PASSWORD DEVPORTAL_ADMIN_EMAIL=foo@bar.com # Edge connection details. # If omitted, you can set them in the portal UI. # Specify the Edge organization associated with the portal. EDGE_ORG=edgeOrgName # Specify the URL of the Edge management API. # For a Cloud based installation of Edge, the URL is: # https://api.enterprise.apigee.com/v1 # For a Private Cloud installation, it is in the form: # http://ms_IP_or_DNS:8080/v1 or # https://ms_IP_or_DNS:TLSport/v1 MGMT_URL=https://api.enterprise.apigee.com/v1 # The org admin credentials for the Edge organization in the form # of Edge emailAddress:pword. # The portal uses this information to connect to Edge. DEVADMIN_USER=orgAdmin@myCorp.com DEVADMIN_PWD=ORG_ADMIN_PASSWORD # The PHP port. # If omitted, it defaults to 8888. PHP_FPM_PORT=8888 # Optionally configure the SMTP server used by the portal. # If you do, the properties SMTPHOST and SMTPPORT are required. # The others are optional with a default value as notated below. # SMTP hostname. For example, for the Gmail server, use smtp.gmail.com. SMTPHOST=smtp.gmail.com # Set the SMTP protocol as "standard", "ssl", or "tls", # where "standard" corresponds to HTTP. # Note that in previous releases, this setting was controlled by the # SMTPSSL property. That property has been deprecated. SMTP_PROTOCOL="standard" # SMTP port (usually 25). # The value can be different based on the selected encryption protocol. # For example, for Gmail, the port is 465 when using SSL and 587 for TLS. SMTPPORT=25 # Username used for SMTP authentication, defaults is blank. SMTPUSER=your@email.com # Password used for SMTP authentication, default is blank. SMTPPASSWORD=YOUR_EMAIL_PASSWORD
1. Testa la connessione ad Apigee Edge
Verifica la connessione tra il server su cui intendi installare il portale e il server di gestione perimetrale eseguendo il seguente comando curl
sul server del portale:
curl -u EMAIL:PASSWORD http://ms_IP_or_DNS:8080/v1/organizations/ORGNAME
oppure:
curl -u EMAIL:PASSWORD https://ms_IP_or_DNS:TLSPort/v1/organizations/ORGNAME
Dove EMAIL e PASSWORD sono l'indirizzo email e la password dell'amministratore di ORGNAME.
Assicurati di specificare il nome host e il numero di porta specifici della tua installazione di Edge. La porta
8080 è quella predefinita utilizzata da Edge. Se ti stai connettendo a un'organizzazione nel cloud, l'URL della richiesta è: https://api.enterprise.apigee.com/v1/organizations/ORGNAME
.
Se l'operazione ha esito positivo, curl
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" }
2. 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 iniziare 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
Rimuovi i pacchetti PHP utilizzando il seguente comando:
yum remove package_name
Se non sei sicuro che PHP sia installato sul tuo server, utilizza il seguente comando:
rpm -qa | grep -i php
Tieni presente che il portale utilizza la versione PHP 4.18.01-0.0.49. Non è destinato a corrispondere al numero di versione di Apigee Edge per il cloud privato.
3. Installa Postgres
Per installare il portale è necessario installare Postgres. Puoi installare Postgres durante l'installazione di Edge o installare Postgres standalone per l'utilizzo da parte del portale.
- Se ti stai connettendo a Postgres installato come parte di Edge e Postgres è configurato in modalità master/standby, specifica l'indirizzo IP del server Postgres master.
- Se installi Postgres autonomo, può trovarsi sullo stesso nodo del portale.
Per informazioni sull'installazione di Postgres durante l'installazione di Edge, consulta Installare i componenti Edge su un nodo.
Per installare la versione autonoma di Postgres:
- Installa l'utilità Edge
apigee-setup
sul nodo utilizzando la procedura Internet o non internet. Per saperne di più, consulta Installare l'utilità apigee-setup di Edge. - Crea un file di configurazione Postgres, come illustrato nell'esempio seguente:
# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost HOSTIP=$(hostname -i) # The pod and region of Postgres. Use the default values shown below. MP_POD=gateway REGION=dc-1 # Set the Postgres password. The default value is 'postgres'. PG_PWD=postgres
- Al prompt dei comandi, esegui lo script di configurazione per installare Postgres:
/opt/apigee/apigee-setup/bin/setup.sh -p pdb -f postgres_config_file
L'opzione
-p pdb
consente di specificare l'installazione di Postgre. Il file di configurazione deve essere accessibile o leggibile dall'utente "apigee".
4. Installa il portale
Prima di poter installare il portale, assicurati di aver eseguito le seguenti operazioni, come descritto nella sezione 3. Installa Postgres:
- Installa l'utilità Edge
apigee-setup
sul nodo del portale - Installa Postgres, autonomo o come parte dell'installazione di Edge
Per installare il portale:
- Al prompt dei comandi, esegui lo script
setup
:/opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile
Dove:
- configFile è il file di configurazione del portale, come descritto nella sezione Creare un file di configurazione per il portale.
-p dp
indica allo scriptsetup
di installare il portale.
Per verificare che l'installazione del portale sia riuscita:
- Vai alla home page del portale all'indirizzo
http://localhost:8079
o al nome DNS del tuo portale. - Accedi al portale utilizzando le credenziali amministrative che hai impostato nel file di configurazione del portale.
- Seleziona Report > Report sullo stato nel menu Drupal per assicurarti di visualizzare lo stato attuale del portale.
- Assicurati che la connessione al server di gestione sia riuscita. In caso contrario:
- Vai alla pagina di configurazione della connessione del portale (ad esempio
http://portal_IP:8079/admin/config/devconnect
). - Fai clic sul pulsante Test Connection (Verifica connessione). Se la connessione viene stabilita, l'operazione è stata completata. Se la connessione non riesce, continua.
- Controlla le impostazioni dell'endpoint e di autenticazione:
- URL dell'endpoint dell'API di gestione: verifica che il protocollo (HTTP o HTTPS), il nome IP o DNS e il numero di porta siano corretti, ad esempio:
http://10.10.10.10:8080/v1
- Utente autenticato endpoint:il nome utente dell'amministratore dell'organizzazione.
- Password dell'utente autenticata: la password dell'amministratore dell'organizzazione.
I valori predefiniti riflettono le impostazioni del file di configurazione del portale che hai creato durante il processo di installazione.
Questi valori dovrebbero corrispondere ai valori ms_IP_or_DNS, email e password che hai utilizzato nel passaggio 1: testa la connessione ad Apigee Edge. Il nome utente e la password devono anche corrispondere ai valori delle proprietà
USER_NAME
eUSER_PWD
nel file di configurazione dell'onboarding o alle credenziali di qualsiasi utente il cui ruolo è Amministratore dell'organizzazione. - URL dell'endpoint dell'API di gestione: verifica che il protocollo (HTTP o HTTPS), il nome IP o DNS e il numero di porta siano corretti, ad esempio:
- Dopo aver effettuato la connessione al server di gestione, fai clic sul pulsante Salva configurazione in fondo alla pagina per salvare le modifiche.
- Vai alla pagina di configurazione della connessione del portale (ad esempio
5. Assicurati che il modulo Gestione aggiornamenti sia abilitato
Per ricevere notifiche sugli aggiornamenti di Drupal, assicurati che il modulo di gestione degli aggiornamenti di Drupal sia abilitato. Dal menu Drupal, seleziona Moduli e scorri verso il basso fino al modulo Gestione aggiornamenti. Se non è attivato, abilitalo.
Una volta attivati, puoi visualizzare gli aggiornamenti disponibili utilizzando la voce di menu Report > Aggiornamenti disponibili. Puoi anche utilizzare il seguente comando Drush:
drush pm-info update
Devi eseguire questo comando dalla directory principale del sito. Per impostazione predefinita, il portale è installato all'indirizzo /opt/apigee/apigee-drupal/wwwroot
. Pertanto,
devi cambiare la directory in /opt/apigee/apigee-drupal/wwwroot
prima
di eseguire il comando. Se non hai installato il portale nella directory predefinita, passa alla directory di installazione.
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.
6. (Facoltativo) Configura il motore di ricerca Apache Solr
Per impostazione predefinita, i moduli Drupal che si connettono al motore di ricerca Apache Solr vengono disabilitati quando installi il portale. La maggior parte dei portali utilizza il motore di ricerca interno Drupal, pertanto non richiede i moduli Drupal Solr.
Se decidi di utilizzare Solr come motore di ricerca, devi installare Solr localmente sul server e quindi abilitare e configurare i moduli di Drupal Solr sul portale.
Per abilitare i moduli Drupal Solr:
- Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
- Seleziona Moduli nel menu Drupal.
- Abilita i moduli Apache Solr Framework e Apache Solr Search.
- Salva le modifiche.
- Configura Solr come descritto all'indirizzo https://drupal.org/node/1999280.
7. Installa SmartDocumenti (facoltativo)
SmartDocumenti consente di documentare le API sul portale in modo da rendere la documentazione delle API completamente interattiva. Tuttavia, per utilizzare SmartDocumenti con il portale, devi prima installare SmartDocumenti su Edge.
- Se stai connettendo il portale a un'installazione Edge Cloud, SmartDocumenti è già installato e non sono necessarie ulteriori configurazioni.
- Se stai connettendo il portale a un'installazione Edge per cloud privato, devi assicurarti che SmartDocuments sia installato su Edge. Per ulteriori informazioni sull'installazione di Edge e SmartDocumenti, vedi Installare SmartDocumenti.
Devi anche attivare SmartDocumenti sul portale. Per maggiori informazioni su Smart Docs, consulta la pagina relativa all'utilizzo di SmartDocumenti per documentare le API.
8. (Facoltativo) Configura il modulo di aggiornamento di JQuery per le installazioni non internet
Se installi e utilizzi il modulo di aggiornamento di JQuery in un'installazione non Internet, devi configurare il modulo in modo che utilizzi la versione locale di JQuery. Se configuri il modulo in modo che utilizzi una CDN per un'installazione non internet, il modulo tenterà di accedere alla CDN e causerà ritardi con il caricamento delle pagine. Per maggiori informazioni sul modulo di aggiornamento JQuery, visita la pagina https://www.drupal.org/project/jquery_update.
Per configurare il modulo di aggiornamento di JQuery in modo che utilizzi la versione locale di JQuery:
- Accedi al portale come utente con privilegi di amministratore o per la creazione di contenuti.
- Seleziona Configuration > Development > JQuery Update (Configurazione > Sviluppo > Aggiornamento JQuery) nel menu Drupal.
- Fai clic su Rendimento nel riquadro di navigazione a sinistra.
- Nell'elenco a discesa CDN dell'interfaccia utente di JQuery e JQuery, seleziona Nessuno.
- Fai clic su Salva configurazione.
9. Passaggi successivi
La tabella seguente elenca alcune delle attività più comuni da eseguire dopo l'installazione e include i link alla documentazione di Apigee dove puoi trovare ulteriori informazioni:
Attività | Descrizione |
---|---|
Il tema definisce l'aspetto del portale, inclusi i colori, lo stile e altri aspetti visivi. |
|
La home page include il menu principale, il messaggio di benvenuto, l'intestazione, il piè di pagina e il titolo. |
|
Il processo di registrazione controlla il modo in cui i nuovi sviluppatori registrano un account sul portale. Ad esempio, i nuovi sviluppatori possono accedere immediatamente al portale o devono essere verificati da un amministratore? Questo processo controlla anche il modo in cui un amministratore del portale viene avvisato quando viene creato un nuovo account. |
|
Il portale invia email in risposta a determinati eventi. Ad esempio, quando un nuovo sviluppatore si registra sul portale e quando uno sviluppatore perde la password. |
|
Aggiungi una pagina Termini e condizioni che gli sviluppatori devono accettare prima di poter accedere al portale. |
|
Il portale implementa un modello di autorizzazione basato sui ruoli. Prima di consentire agli sviluppatori di registrarsi, definisci le autorizzazioni e i ruoli utilizzati dal portale. |
|
Il portale dispone di supporto integrato per blog e forum con conversazioni in thread. Definisci le autorizzazioni necessarie per visualizzare, aggiungere, modificare ed eliminare post di blog e forum. |
|
Assicurati di eseguire backup del database |
Assicurati di eseguire il backup del database Drupal. Tieni presente che, poiché ogni installazione è diversa, sta a te determinare il modo migliore per eseguire il backup del database. Vedi anche Come eseguire un backup. |
Configurare un nome host |
Se non configuri un nome host nel server DNS, puoi sempre accedere al sito tramite l'indirizzo IP del server. Se vuoi utilizzare un nome host, puoi configurare il DNS per il server, che dovrebbe funzionare correttamente senza alcuna altra configurazione su una configurazione di base. Se configuri un bilanciatore del carico o ricevi URL errati sul tuo sito per qualche altro motivo, puoi impostare
Tieni presente che in questo file puoi inserire qualsiasi altra impostazione da Per saperne di più sulla proprietà |
Sviluppo personalizzato | Puoi anche estendere le funzionalità del tuo portale con codice personalizzato al di fuori del tuo
tema. Per farlo, crea il tuo modulo Drupal come descritto negli argomenti di sviluppo del modulo di Drupal e inserisci il modulo nella directory /sites/all/modules . |