Upgrade del portale Servizi per gli sviluppatori

Edge per Private Cloud v4.18.01

Questa procedura descrive come eseguire l'upgrade di un canale Apigee Developer Channel Services esistente l'installazione in loco.

Determinare la procedura di aggiornamento corretta

La procedura utilizzata per aggiornare il portale si basa sulla tua installazione attuale:

• Se la tua installazione utilizza Nginx/Postgres, consulta Eseguire l'upgrade di un portale utilizzando le RPM di seguito.
• Se la tua installazione utilizza Apache/MySQL o Apache/MariaDB, consulta Convertire un portale basato su tar in un portale basato su RPM.

Determina il tipo di installazione attuale

Se hai dubbi sul tipo di installazione attuale, usa il comando seguente per determinare Questo:

• ls /opt

  Se utilizzi Nginx/Postgres, vedrai le seguenti directory: /opt/apigee e /opt/nginx.

  Se utilizzi Apache/MySQL o Apache/MariaDB, queste directory non devono essere presenti.

• /opt/apigee/apigee-service/bin/apigee-all status

  Se utilizzi Nginx/Postgres, l'output sarà il seguente:

  + apigee-service
  apigee-drupal-devportal status
  OK: apigee-drupal-devportal is up and running
  + apigee-service apigee-lb status
  apigee-service: apigee-lb: OK
  + apigee-service apigee-postgresql status
  apigee-service: apigee-postgresql: OK

• apachectl -S

  Se utilizzi Apache/MySQL o Apache/MariaDB, questo comando dovrebbe restituire la directory principale del portale web, nel seguente formato:

  *:80
  192.168.56.102 (/etc/httpd/conf/vhosts/devportal.conf:1)

Directory di installazione predefinita

La procedura di upgrade presuppone che il Portale per gli sviluppatori sia stato installato all'indirizzo:

• 4.17.05 e versioni successive: /opt/apigee/apigee-drupal/wwwroot
• Prima della versione 4/17/05: /opt/apigee/apigee-drupal (Nginx) o /var/www/html (Apache)

Se non hai installato il portale nella directory predefinita, modifica i percorsi nella procedura riportata di seguito per utilizzare la tua directory di installazione.

Versioni di upgrade supportate

Questa procedura di upgrade è supportata per le seguenti versioni del portale:

• OPDK-17-01.x
• OPDK-17-05.x
• OPDK-17-09.x

Per determinare la versione del tuo portale, apri il seguente URL in un browser:

http://yourportal.com/buildInfo

Prima dell'aggiornamento

Per le installazioni esistenti, se hai modificato del codice nel nucleo di Drupal o in moduli non personalizzati, le modifiche verranno sovrascritte. Sono incluse, tra le altre, eventuali modifiche apportate a .htaccess. Dovresti presumere che tutti gli elementi esterni alla directory /sites siano di proprietà di Drupal. Un'eccezione a questa regola è robots.txt; se questo file esiste nella home page del sito web, verrà conservato.

Prima di procedere con l'installazione, esegui un backup dell'intera directory radice web di Drupal . Dopo aver eseguito i passaggi di installazione descritti di seguito, puoi ripristinare le personalizzazioni dal backup.

Upgrade di un portale utilizzando gli RPM

Per aggiornare l'RPM del portale su un nodo:

1. Passa alla directory Drupal, /opt/apigee/apigee-drupal entro il giorno valore predefinito:

   cd /opt/apigee/apigee-drupal

2. Esegui il backup dell'istanza di database Drupal. Il comando pg_dump crea una copia database:

   pg_dump --dbname=devportal --host=192.168.56.101 --username=drupaladmin
     --password --format=c > /tmp/portal.dmp

   dove:

   • dbname specifica il nome del database come specificato dal Proprietà PG_NAME nel file di configurazione dell'installazione del portale.
   • host specifica l'indirizzo IP del nodo del portale.
   • username specifica il nome utente Postgres utilizzato dal portale per accedere al database come specificato dalla proprietà DRUPAL_PG_USER nel file di configurazione dell'installazione del portale.
   • Ti viene chiesta la password dell'utente Postgres come definito dalla proprietà DRUPAL_PG_PASS nel file di configurazione dell'installazione del portale.

   Se in un secondo momento devi eseguire il ripristino dal backup, utilizza il comando:

   pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp

3. Esegui un backup dell'intera directory root web di Drupal. La posizione di installazione predefinita è /opt/apigee/apigee-drupal, ma potresti averla modificata.

   Se non hai la certezza della posizione di questa directory, utilizza il comando drush status o la voce Configurazione > Media > File nel menu di Drupal per determinare la posizione del file system pubblico e del percorso del file system privato (per il passaggio successivo).

4. Esegui un backup dei file in /opt/apigee/data/apigee-drupal-devportal/private.
5. Imposta Drupal in modalità di manutenzione:
   1. Seleziona Configurazione nel menu Drupal.
   2. Nella pagina Configurazione, seleziona Manutenzione. in Sviluppo.
   3. Seleziona la casella Metti il sito in modalità di manutenzione.
   4. Inserisci un messaggio che gli utenti vedranno durante la manutenzione.
   5. Seleziona Salva configurazione.
6. Disabilita SELinux come descritto in Installa l'utilità apigee-setup Edge.
7. Passa alla directory /opt:

   > cd /opt

8. Per un upgrade su un server con una connessione a internet:
   1. Scarica il file bootstrap_4.18.01.sh di Edge 4.18.01 in /tmp/bootstrap_4.18.01.sh:

      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

   2. Installa l'utilità e le dipendenze apigee-service Edge 4.18.01:

      sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

      dove uName:pWord sono il nome utente e la password che hai ricevuto da Apigee. Se ometti pWord, ti verrà chiesto di inserirlo.

      Per impostazione predefinita, il programma di installazione verifica che sia installato Java 1.8. Puoi utilizzare l'opzione "C" per continuare senza installare Java.

9. Per eseguire l'upgrade su un server senza connessione a internet:
   1. Crea un repository locale 4.18.01 come descritto in "Creare un repository Apigee locale" in Installare l'utilità apigee-setup di Edge.
   2. Per installare apigee-service da un file .tar:
      1. Sul nodo con il repository locale, utilizza il comando seguente per pacchettizzare il repository locale repository in un singolo file .tar denominato /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:

          /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

      2. Copia il file .tar nel nodo in cui vuoi aggiornare Edge. Ad esempio, copialo alla directory /tmp sul nuovo nodo.
      3. Sul nuovo nodo, estrae il file nella directory /tmp:

         tar -xzf apigee-4.18.01.tar.gz

         Questo comando crea una nuova directory, denominata repository, nella directory contenente il file . Ad esempio /tmp/repos.

      4. Installa l'utilità apigee-service di Edge e le dipendenze da /tmp/repos:

         sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

         Nota che in questo comando viene incluso il percorso della directory dei repository.

   3. Per installare apigee-service utilizzando il server web Nginx:
      1. Configura il server web Nginx come descritto in "Eseguire l'installazione dal repository utilizzando server web NGINX alla pagina Installare Edge Utilità apigee-setup.
      2. Sul nodo remoto, scarica il file bootstrap_4.18.01.sh di Edge in /tmp/bootstrap_4.18.01.sh:

         /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh
           -o /tmp/bootstrap_4.18.01.sh

         dove uName:pWord sono il nome utente e la password impostati sopra per il repository e remoteRepo è l'indirizzo IP o il nome DNS del nodo del repository.

      3. Sul nodo remoto, installa l'utilità Edge apigee-service e dependencies:

         sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939
             apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

         dove uName:pWord sono il nome utente e la password del repository.

10. Utilizza apigee-service per aggiornare l'utilità apigee-setup:

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

11. Esegui l'utilità di aggiornamento sul nodo Postgre:

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    dove configFile è il file di configurazione che hai usato per installare il database Postgres. L'unico requisito per il file di configurazione è che deve essere accessibile o leggibile dall'utente "apigee".

12. Aggiorna il database Postgres:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

13. Esegui l'utilità di aggiornamento sul nodo per aggiornare il portale:

    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

    dove configFile è il file di configurazione che hai usato per installare nel portale. L'unico requisito per il file di configurazione è che deve essere accessibile o leggibile dall'utente "apigee".

14. Esegui lo script update.php di Drupal aprendo il seguente URL in una finestra del browser:

    http://portalIP_DNS:8079/update.php

15. Disattiva Drupal in modalità di manutenzione:
    1. Seleziona Configuration (Configurazione) nel menu Drupal.
    2. Nella pagina Configurazione, seleziona Modalità manutenzione in Sviluppo.
    3. Deseleziona la casella Attiva la modalità di manutenzione del sito.
    4. Seleziona Salva configurazione.

Tieni presente che la directory principale dopo l'aggiornamento è:

/opt/apigee/apigee-drupal/wwwroot

L'upgrade è ora completato.