Edge per il cloud privato v4.18.01
Prima dell'installazione, assicurati che:
- Installa Postgres prima di installare il portale. Puoi installare Postgres come parte dell'installazione di Edge oppure installare Postgres in modo indipendente per l'utilizzo da parte del portale.
- Se installi Postgres in modo 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 alla pagina Software supportati e versioni supportate.
- Yum installato.
Il programma di installazione include solo i moduli forniti da Drupal, che sono richiesti dal portale Apigee Developer Services (o semplicemente dal portale). Per informazioni sull'installazione di altri moduli forniti, consulta Extending Drupal 7.
Panoramica dell'installazione
Dopo aver installato l'utilità Edge sull'utilità apigee-setup
su un nodo, utilizza l'utilità per installare il portale sul nodo. L'utilità apigee-setup
ha il formato:
sudo /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
Passa un file di configurazione all'utilità apigee-setup
che contiene le informazioni sull'installazione. Se nel file di configurazione mancano le informazioni richieste, l'utilità apigee-setup
chiede di inserirle nella riga di comando.
L'unico requisito è che il file di configurazione sia accessibile o leggibile dall'utente "Apigee".
Ad esempio, usa il comando seguente per installare il portale:
sudo /opt/apigee/apigee-setup/bin/setup.sh -p dp -f myConfig
Per ulteriori informazioni, consulta la pagina Installare l'utilità di configurazione perimetrale di Apigee.
Ritiro della proprietà SMTPSSL
Nelle release precedenti, utilizzavi la proprietà SMTPSSL
per impostare il protocollo utilizzato dal server SMTP collegato al portale. La proprietà è stata deprecata.
Ora utilizzi la proprietà SMTP_PROTOCOL
, anziché la proprietà SMTPSSL
, per impostare il protocollo utilizzato dal server SMTP collegato al portale. I valori validi sono: "standard", "ssl" o "tls".
Creazione di un file di configurazione
Di seguito è riportato un file di configurazione silenziosa di esempio per l'installazione di un portale. Modifica questo file in base alle tue esigenze. 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=pWord 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=pWord # 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=yourEmailPassword
1. Testa la tua connessione ad Apigee Edge
Verifica la tua connessione al server di gestione perimetrale eseguendo il seguente comando cURL da un prompt dei comandi 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 per l'installazione di Edge. La porta 8080 è la porta 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 ha esito positivo, 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" }
2. Rimuovi le versioni di PHP precedenti alla 7.0
Lo script di installazione controlla le versioni precedenti alla 7.0 di PHP sul sistema prima di iniziare l'installazione. Se esistono versioni precedenti alla 7.0 di PHP, 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 comando seguente:
yum remove package-name
3. Installa Postgres
Per poter installare il portale è necessario installare Postgres. Puoi installare Postgres come parte dell'installazione di Edge oppure installare Postgres in modo indipendente per l'uso 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 in modo autonomo, può trovarsi sullo stesso nodo del portale.
Per informazioni sull'installazione di Postgres durante l'installazione di Edge, consulta Installare i componenti di Edge su un nodo.
Per installare Postgres autonomo:
- Installa l'utilità Edge
apigee-setup
sul nodo utilizzando la procedura Internet o non Internet. Per ulteriori informazioni, consulta Installare l'utilità di configurazione perimetrale di Apigee. - Crea un file di configurazione per Postgres, come mostrato di seguito:
# 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 configFile
L'opzione
-p pdb
consente di specificare Postgre. Il file di configurazione deve essere accessibile o leggibile dall'utente "Apigee".
4. Installa il portale
Per installare il portale:
- Installa l'utilità Edge
apigee-setup
sul nodo utilizzando la procedura Internet o non Internet. Per ulteriori informazioni, consulta Installare l'utilità di configurazione Edge apigee. - Assicurati di aver installato Postgres in versione autonoma o come parte dell'installazione di Edge.
- Al prompt dei comandi, esegui lo script di configurazione:
/opt/apigee/apigee-setup/bin/setup.sh -p dp -f configFile
L'opzione
-p dp
consente di specificare il portale.Il file di configurazione deve essere accessibile o leggibile dall'utente "Apigee".
- Vai alla home page del portale all'indirizzo
http://localhost:8079
o al nome DNS del tuo portale. - Accedi al portale utilizzando le credenziali di amministratore che hai impostato nel file di configurazione per assicurarti che il portale funzioni correttamente.
- Seleziona Report > Report di stato nel menu Drupal per poter visualizzare lo stato attuale del portale.
5. Assicurati che il modulo Aggiorna gestore sia abilitato
Per ricevere notifiche sugli aggiornamenti di Drupal, assicuratevi che il modulo di gestione di Drupal Update sia abilitato. Nel menu Drupal, seleziona Moduli e scorri verso il basso fino al modulo Update manager. Se non è abilitata, abilitala.
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 per gli sviluppatori è installato all'indirizzo /opt/apigee/apigee-drupal/wwwroot
. Pertanto, devi prima modificare 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 gli aggiornamenti e per impostare la frequenza di controllo degli aggiornamenti.
6. (Facoltativo) Configurare 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 richiedono i moduli Drupal Solr.
Se decidi di utilizzare Solr come motore di ricerca, devi installare Solr in locale sul server, quindi abilitare e configurare i moduli Drupal Solr sul portale.
Per abilitare i moduli Drupal Solr:
- Accedi al tuo portale come utente con privilegi di amministratore o di creazione dei contenuti.
- Seleziona Moduli nel menu Drupal.
- Abilita il modulo Apache Solr Framework e il modulo Apache Solr Search.
- Salva le modifiche.
- Configura Solr come descritto all'indirizzo https://drupal.org/node/1999280.
7. Installare SmartDocumenti (facoltativo)
SmartDocumenti ti consente di documentare le tue API sul portale Servizi per gli sviluppatori in modo da rendere la documentazione dell'API completamente interattiva. Tuttavia, per utilizzare SmartDocumenti con il portale, devi prima installare SmartDocumenti su Edge.
- Se stai collegando il portale a un'installazione di Edge Cloud, SmartDocumenti è già installato e non è necessaria alcuna configurazione.
- Se stai connettendo il portale a un'installazione Edge per il cloud privato, devi assicurarti che SmartDocumenti sia installato su Edge. Per saperne di più sull'installazione di Edge e SmartDocumenti, consulta la pagina Installare SmartDocumenti.
Devi inoltre abilitare SmartDocumenti sul portale. Per ulteriori informazioni su SmartDocumenti, consulta la pagina relativa all'utilizzo di Documenti intelligenti per documentare le API.
8. Configura il modulo JQuery Update per le installazioni non Internet (facoltativo)
Se installi e utilizzi il modulo JQuery Update in un'installazione non Internet, devi configurare il modulo per utilizzare la versione locale di JQuery. Se configuri il modulo per l'utilizzo di una CDN per l'installazione non in Internet, quest'ultimo tenterà di accedere alla CDN e provocherà ritardi nel caricamento della pagina. Per maggiori informazioni sul modulo JQuery Update, consulta https://www.drupal.org/project/jquery_update.
Per configurare il modulo JQuery Update in modo che utilizzi la versione locale di JQuery:
- Accedi al tuo portale come utente con privilegi di amministratore o di creazione dei contenuti.
- Seleziona Configurazione > Sviluppo > Aggiornamento JQuery nel menu Drupal.
- Nel riquadro di navigazione a sinistra, fai clic su Rendimento.
- Nel menu a discesa CDN di JQuery e JQuery, seleziona Nessuno.
- Fai clic su Salva configurazione.
9. E adesso?
I passaggi successivi all'installazione del portale Servizi per gli sviluppatori prevedono la configurazione e la personalizzazione in base alle tue esigenze specifiche. La documentazione sul sito web Apigee contiene tutte le informazioni su configurazione, stile e 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:
Attività | Descrizione |
---|---|
Il tema definisce l'aspetto del portale, inclusi colori, 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 hanno accesso immediato al portale, oppure devono essere verificati da un amministratore. Questo processo controlla anche la modalità di notifica per un amministratore del portale quando viene creato un nuovo account. |
|
Il portale invia le email in risposta a determinati eventi. Ad esempio, quando un nuovo sviluppatore si registra sul portale e quando uno sviluppatore perde la propria 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 offre supporto integrato per blog e forum con conversazioni in thread. Definisci le autorizzazioni necessarie per visualizzare, aggiungere, modificare ed eliminare i post di blog e forum. |
|
Assicurati di eseguire i backup dei database |
Assicurati di eseguire il backup del database Drupal. Tieni presente che, poiché ogni installazione è diversa, spetta a te determinare come eseguire il backup del database. Nota: il modulo Backup e migrazione non è compatibile con i database Postgres. 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 altre configurazioni in una configurazione di base. Se configuri un bilanciatore del carico o ricevi URL errati sul sito per qualche altro motivo, puoi configurare
Tieni presente che puoi inserire altre impostazioni di Per ulteriori informazioni sulla proprietà |
Sviluppo personalizzato | Potresti anche estendere le funzionalità del tuo portale con codice personalizzato al di fuori del tuo tema. A questo scopo, crea il tuo modulo Drupal come descritto negli argomenti
Sviluppo del modulo di Drupal e inseriscilo nella directory
/sites/all/modules . |