Upgrade del portale Servizi per gli sviluppatori

Portale dei servizi per gli sviluppatori versione 4.17.09

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

di Gemini Advanced.

Stabilire la procedura di aggiornamento corretta

La procedura che utilizzi per aggiornare il portale si basa sull'installazione corrente:

Determinante 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 usi Apache/MySQL o Apache/MariaDB, questo comando dovrebbe restituire directory root del portale, nel formato:

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

Directory di installazione predefinita

Il processo 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 di seguito per utilizzare la 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

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

http://your_portal.com/buildInfo

Prima di eseguire l'aggiornamento

Per le installazioni esistenti, se hai modificato un qualsiasi codice nel core Drupal o in qualsiasi moduli, le modifiche verranno sovrascritte. Sono incluse, tra le altre cose, eventuali modifiche che potresti aver inviato a .htaccess. Dovresti presumere che tutti gli elementi esterni alla directory /sites siano di proprietà di Drupal. Un l'eccezione a questa regola è robots.txt; se il file esiste sul web verrà conservata per te.

Prima di procedere con l'installazione, esegui un backup dell'intera directory radice web di Drupal . Dopo aver eseguito la procedura di installazione descritta di seguito, puoi ripristinare personalizzazioni dal backup.

Upgrade di un portale utilizzando gli RPM

Usa la seguente procedura per aggiornare l'RPM del portale su un nodo:

  1. Passa alla directory Drupal. Ad esempio, /opt/apigee/apigee-drupal/wwwroot. 

    cd /opt/apigee/apigee-drupal/wwwroot

    Vedi Directory di installazione predefinita per la directory predefinita la versione del prodotto.

  2. Esegui il backup dell'istanza del 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 come specificato dalla proprietà DRUPAL_PG_USER in di configurazione dell'installazione del portale.
    • Ti viene chiesta la password utente di Postgres, come definito 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. Il percorso di installazione predefinito è /opt/apigee/apigee-drupal, ma tu potresti averlo modificato.
    Se non conosci con esattezza la posizione di questa directory, usa il comando drush status o Configurazione > Media > Voce del file nel menu Drupal per determinare la posizione del file system pubblico e il percorso del file system privato (per le passaggio).
  4. Esegui un backup dei file in /opt/apigee/data/apigee-drupal-devportal/private.
  5. Imposta Drupal in modalità di manutenzione:
    1. Seleziona Configuration (Configurazione) nel menu Drupal.
    2. Nella pagina Configurazione, seleziona Manutenzione. in Sviluppo.
    3. Seleziona la casella Attiva la modalità di manutenzione del sito.
    4. Inserisci un messaggio che gli utenti visualizzeranno 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 Edge 4.17.09 bootstrap_4.17.09.sh in /tmp/bootstrap_4.17.09.sh: 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    2. Installa l'utilità e le dipendenze Edge 4.17.09 apigee-service: 
      sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName
  apigeepassword=pWord

      dove uName:pWord sono il nome utente e la password che hai ricevuto 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 lo "C" per continuare senza installare Java.

  9. Per un upgrade su un server senza connessione a internet:
      .
    1. Crea un repository 4.17.09 locale come descritto in "Creare un repository Apigee locale" alle Installa Edge Utilità apigee-setup.
    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.17.09.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, sposta il file nella directory /tmp:
        tar -xzf apigee-4.17.09.tar.gz

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

      4. Installa l'utilità Edge apigee-service e delle dipendenze da /tmp/repos: 
        sudo bash /tmp/repos/bootstrap_4.17.09.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 Edge bootstrap_4.17.09.sh su /tmp/bootstrap_4.17.09.sh: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh
  -o /tmp/bootstrap_4.17.09.sh

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

      3. Sul nodo remoto, installa l'utilità Edge apigee-service e dependencies:code 
        sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939
  apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

  10. Usa 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 per aggiornare il database Postgres:
    /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 del file di configurazione è che il file deve essere accessibile o leggibile da "apigee" utente.

  12. Avvia Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  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 del file di configurazione è che deve essere accessibile o leggibile dall'"apigee" utente.

  14. Esegui lo script update.php di Drupal aprendo il seguente URL in una finestra del browser: 
    http://portalIP_DNS:8079/update.php
  15. Disabilita Drupal alla modalità di manutenzione:
    1. Seleziona Configuration (Configurazione) nel menu Drupal.
    2. Nella pagina Configurazione, seleziona Manutenzione. in Sviluppo.
    3. Deseleziona la casella Attiva la modalità di manutenzione del sito.
    4. Seleziona Salva configurazione.

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

/opt/apigee/apigee-drupal/wwwroot

L'upgrade è ora completato.