Installa il portale

Edge per Private Cloud v4.18.05

Prima di installare il portale Apigee Developer Services (o semplicemente il portale), assicurati che:

1. Devi installare Postgres prima di installare il portale. Puoi installare Postgres come parte sull'installazione di Edge o sull'installazione autonoma di Postgres per l'uso nel portale.
   • Se installi Postgres standalone, può trovarsi sullo stesso nodo del portale.
   • Se ti connetti a Postgres installato come parte di Edge e Postgres è configurato in modalità master/standby, specifica l'indirizzo IP del server Postgres master.
2. 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 all'indirizzo Software supportati e versioni supportate.
3. L'app Yum è installata.

Il programma di installazione include solo i moduli offerti da Drupal che sono richiesti dal Portale Apigee Developer Services (o semplicemente il portale). Per informazioni sull'installazione di altri moduli forniti, vedi Estensione di Drupal 7.

Panoramica dell'installazione

Per installare il portale, devi seguire questi passaggi. Ciascuno di questi passaggi è descritto in per saperne di più nelle sezioni successive.

1. Testare la connessione
2. Rimuovere le versioni precedenti alla 7.0 di PHP
3. Installa Postgres
4. Installa il portale
5. Verificare che sia abilitato Gestione aggiornamenti
6. (Facoltativo) Configurare Apache Solr
7. (Facoltativo) Installare SmartDocs
8. (Facoltativo) Configurare JQuery

Ritiro della proprietà SMTPSSL

Nelle release precedenti hai utilizzato la proprietà SMTPSSL per imposta il protocollo utilizzato dal server SMTP connesso al portale. La proprietà è stata ritirato.

Ora utilizzi la proprietà SMTP_PROTOCOL, anziché la proprietà SMTPSSL, per impostare utilizzato dal server SMTP connesso al portale. I valori validi sono: "standard", "ssl" o "tls".

Crea un file di configurazione del portale

Di seguito è riportato un esempio di file di configurazione invisibile per l'installazione di un portale. Modifica questo file in base alle esigenze della tua configurazione. Utilizza l'opzione -f per setup.sh per includerla .

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. Testare la tua connessione ad Apigee Edge

Verifica la connessione tra il server su cui installerai il portale e Edge del server di gestione eseguendo questo 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 del amministratore di ORGNAME.

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

In caso di 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. Rimozione delle versioni precedenti alla 7.0 di PHP

Lo script di installazione verifica la presenza di versioni precedenti alla 7.0 di PHP sul sistema prima di avviare dell'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 questo 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

3. Installa Postgres

È necessario che Postgres sia installato nel portale. Puoi installare Postgres durante l'installazione di Edge oppure installare Postgres standalone per l'utilizzo portale.

• Se ti connetti a Postgres installato come parte di Edge e Postgres è configurato modalità master/standby, specifica l'indirizzo IP del server Postgres master.
• Se installi Postgres standalone, può trovarsi sullo stesso nodo del portale.

Per informazioni sull'installazione di Postgres durante l'installazione di Edge, consulta: Installa i componenti Edge su un nodo.

Per installare la versione autonoma di Postgres:

1. Installa l'utilità Edge apigee-setup sul nodo utilizzando internet o una procedura non connessa a internet. Consulta Installa l'utilità apigee-setup di Edge per altro.
2. Crea un file di configurazione Postgres, come mostrato 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

3. 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 specifica di installare Postgre. Il file di configurazione deve essere accessibile o leggibile dall'"apigee" utente.

4. Installa il portale

Prima di poter installare il portale, assicurati di aver eseguito le seguenti operazioni, come descritto in 3. Installa Postgres:

1. Installa l'utilità Edge apigee-setup sul nodo del portale
2. Installa Postgres, autonomo o nell'ambito dell'installazione di Edge

Per installare il portale:

1. 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 in Crea un file di configurazione del portale.
   • -p dp indica allo script setup di installare il portale.

Per verificare che l'installazione del portale sia riuscita:

1. Vai alla home page del portale all'indirizzo http://localhost:8079 o al nome DNS del tuo portale.
2. Accedi al portale utilizzando le credenziali di amministratore che hai impostato nel portale di configurazione del deployment.
3. Seleziona Report > Report sullo stato nel menu Drupal per assicurarti di può vedere lo stato attuale del portale.
4. Assicurati che la connessione al server di gestione sia riuscita. In caso contrario:
   1. Vai alla pagina Configurazione connessione del portale (ad esempio, http://portal_IP:8079/admin/config/devconnect).
   2. Fai clic sul pulsante Test Connection (Verifica connessione). Se la connessione viene stabilita, hai finito. Se la connessione non riesce, continua.
   3. Controlla le impostazioni dell'endpoint e di autenticazione:
      • URL endpoint dell'API di gestione: verifica che il protocollo (HTTP o HTTPS), l'IP o il nome DNS e il numero di porta sono corretti; Ad esempio:

        http://10.10.10.10:8080/v1

      • Utente autenticato endpoint: l'amministratore dell'organizzazione. nome utente.
      • Password dell'utente autenticato: l'amministratore dell'organizzazione. password.

      I valori predefiniti riflettono le impostazioni nel file di configurazione del portale che creati durante il processo di installazione.

      Questi valori devono corrispondere ai valori ms_IP_or_DNS, email e password valori utilizzati nel passaggio 1. Testa la tua connessione ad Apigee Edge. Anche il nome utente e la password devono corrispondere ai valori dell'attributo USER_NAME e USER_PWD nel file di configurazione dell'onboarding, le credenziali di qualsiasi utente il cui ruolo è Amministratore dell'organizzazione.

   4. Dopo esserti connesso al server di gestione, fai clic sul pulsante Salva configurazione nella parte inferiore della pagina per salvare le modifiche.

5. Assicurati che il modulo Gestore aggiornamenti sia attivata

Per ricevere notifiche relative agli aggiornamenti di Drupal, assicurati che il modulo gestore degli aggiornamenti di Drupal sia in un bucket con il controllo delle versioni attivo. Dal menu Drupal, seleziona Moduli e scorri verso il basso fino Modulo Gestione aggiornamenti. Se non è abilitato, abilitalo.

Una volta attivati, puoi visualizzare gli aggiornamenti disponibili nella sezione Report > Disponibile Voce di menu Aggiornamenti. 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 prima cambiare la directory in /opt/apigee/apigee-drupal/wwwroot prima eseguendo il comando. Se non hai installato il portale nella directory predefinita, passa a nella directory di installazione.

Utilizza Report > Aggiornamenti disponibili > Impostazioni per configurare la voce al modulo di inviarti un'email quando sono disponibili aggiornamenti e di impostare la frequenza per la verifica aggiornamenti.

6. configura il motore di ricerca Apache Solr (Facoltativo)

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

Se decidi di utilizzare Solr come motore di ricerca, devi installarlo localmente sul tuo server e poi abilitare e configurare i moduli Drupal Solr sul portale.

Per abilitare i moduli Drupal Solr:

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

7. (Facoltativo) Installa SmartDocs

SmartDocumenti consente di documentare le API sul portale in modo da 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 Edge Cloud, SmartDocs è già installato e non sono necessarie ulteriori configurazioni.
• Se connetti il portale a un'installazione Edge per il cloud privato, devi assicurarti che SmartDocs è installato su Edge. Per ulteriori informazioni sull'installazione di Edge e SmartDocs, vedi Installa SmartDocumenti.

Devi anche attivare SmartDocs sul portale. Per ulteriori informazioni su SmartDocs, vedi Utilizzare SmartDocs per documentare per le API.

8. Configura il Modulo di aggiornamento JQuery per installazioni non internet (facoltativo)

Se installi e utilizzi il modulo di aggiornamento JQuery in un'installazione non internet, devi: configurare il modulo per utilizzare la versione locale di JQuery. Se configuri il modulo per utilizzare una rete CDN per un'installazione non internet, proverà ad accedere alla rete CDN e causerà ritardi con la pagina Caricamento in corso. Per ulteriori informazioni sul modulo di aggiornamento di JQuery, consulta https://www.drupal.org/project/jquery_update.

Per configurare il modulo di aggiornamento di JQuery in modo che utilizzi la versione locale di JQuery:

1. Accedi al tuo portale come utente con privilegi di amministratore o di creazione di contenuti.
2. Seleziona Configurazione > Sviluppo > Aggiornamento di JQuery nel menu Drupal.
3. Fai clic su Rendimento nel riquadro di navigazione a sinistra.
4. Nel menu a discesa CDN di JQuery e JQuery UI seleziona Nessuna.
5. Fai clic su Salva configurazione.

9. Passaggi successivi

Nella tabella seguente sono elencate alcune delle attività più comuni da eseguire dopo l'installazione. e include i link alla documentazione di Apigee, dove puoi trovare ulteriori informazioni: