Upgrade del portale Servizi per gli sviluppatori

Portale di Servizi per gli sviluppatori versione 4.17.05

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 stato
    Se utilizzi Nginx/Postgres, l'output sarà il seguente:

    + apigee-service Stato apigee-drupal-devportal
    OK: apigee-drupal-devportal è attivo
    + stato apigee-service apigee-lb
    apigee-service: apigee-lb: OK
    + stato apigee-service apigee-postgresql
    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:

  • /opt/apigee/apigee-drupal (Nginx)
  • /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.

Se non conosci la directory di installazione, puoi determinarla come descritto in Comandi Drush comunemente utilizzati.

Nuovi directory di installazione predefinita dopo l’aggiornamento di Nginx/Postgres da un nuovo 4.17.01 installazione

Dopo l'aggiornamento di una nuova installazione di 4.17.01 che utilizza Nginx/Postgres, la directory radice cambiato da:

/opt/apigee/apigee-drupal

a:

/opt/apigee/apigee-drupal/wwwroot

Versioni di upgrade supportate

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

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • pantheon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x
  • OPDK-16-09.x
  • OPDK-17-01.x

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

http://yourportal.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 creato su .htaccess. Dovresti presumere che qualsiasi elemento esterno alla directory /sites sia 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 del portale tramite file .tar

  1. Esegui il backup dell'istanza MySQL/MariaDB in Drupal.
    Per ulteriori informazioni, visita http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/
    1. Opzione 1: usa Drush

      Il comando Drush sql-dump crea una copia del database. Dalla directory Drupal, /var/www/html per impostazione predefinita, esegui la comando:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      Usa drush help sql-dump per ulteriori informazioni.
    2. Opzione 2: utilizza MySQLdump
      Usa il comando mysqldump per creare una copia del database:
      mysqldump -u NOME UTENTE - p"PASSWORD" DATABASENAME > /path/to/backup_dir/database-backup.sql

      Non deve esserci spazio tra l'opzione -p e la password. Singola Se la password contiene caratteri speciali, sono necessarie le virgolette intorno alla password.

      Hai impostato USERNAME e DATABASENAME quando hai installato il portale. Per impostazione predefinita, sono entrambi devportal.
  2. Esegui un backup dell'intera directory root web di Drupal. Il percorso di installazione predefinito è /var/www/html, ma potresti al momento dell'installazione,
  3. Scarica il file di Servizi canale per gli sviluppatori DeveloperServices_x.y.z.tar file da ftp.apigee.com, dove x.y.z corrisponde al numero di versione del portale. Quando richiesto, inserisci le credenziali ricevute di Apigee.

    Puoi scaricare un file dal link inviato da Apigee in un browser oppure copiarlo e quindi aggiungilo al seguente comando cURL:
    &gt; curl -kOL <paste link here&gt;

    Nota: se il portale si trova su un server senza connessione a internet esterna, esegui questo passaggio su un server che dispone dell'accesso.

    Vai all'assistenza Apigee Edge e seleziona Accedi al Portale di assistenza per richiedere il Canale sviluppatore. File .tar di upgrade dei servizi. Se non hai un account sul Portale di assistenza, seleziona Accedi al portale di assistenza, quindi seleziona In una affrettati? Crea un ticket di assistenza qui.
  4. Per un upgrade su un server con una connessione a internet:
      .
    1. Estrai il file di upgrade del portale:
      &gt; tar -xvf <tar file&gt;

      L'estrazione di questo comando crea una nuova directory denominata DeveloperServices-4.x.y.z.
    2. Passa al file DeveloperServices-4.x.y.z .
    3. Scarica la versione più recente di Drupal utilizzando il seguente comando:
      &gt; drush dl drupal

      Questo comando crea una directory denominata drupal-x.y, dove x.y corrisponde all'interfaccia versione di Drupal.
    4. Esegui lo script networked-update.sh:
      > ./networked-update.sh

      A seconda delle autorizzazioni del file, potrebbe essere necessario utilizzare sudo per eseguire questo comando oppure eseguirlo come un amministratore.
    5. Per ricevere notifiche relative agli aggiornamenti di Drupal, assicurati che il responsabile degli aggiornamenti di Drupal è abilitato. Dal menu Drupal, seleziona Moduli e scorri verso il basso fino a il modulo Gestione aggiornamenti. Se non è abilitato, abilitalo.

      Una volta attivati, puoi visualizzare gli aggiornamenti disponibili nel menu Report > Disponibile Voce di menu Aggiornamenti.

      Utilizza Report > Aggiornamenti disponibili > Impostazioni su configurare il modulo in modo che ti invii un'email quando sono disponibili aggiornamenti e imposta la frequenza di la verifica della disponibilità di aggiornamenti.
  5. Per un upgrade su un server senza connessione a internet:
      .
    1. Sul server in cui hai scaricato il file DeveloperServices_x.y.z.tar di Developer Channel Services, estrai il file di upgrade del portale:
      > tar -xvf <tar file&gt;

      L'estrazione di questo comando crea una nuova directory denominata DeveloperServices-4.x.y.z.
    2. Passa al file DeveloperServices-4.x.y.z .
    3. Esegui lo script non-networked-update.sh:
      > ./non-networked-update.sh

      A seconda delle autorizzazioni del file, potrebbe essere necessario utilizzare sudo per eseguire questo comando oppure eseguirlo come un amministratore.

      Questo comando scarica tutti i file di aggiornamento necessari e li pacchettizza in un unico file. denominato devportal-update.tgz e scrive il file in una posizione di tua scelta.
    4. Copia devportal-update.tgz nella destinazione ovvero quello che esegue il portale.
      Nota: non copiare devportal-update.tgz nella directory radice web di il server di destinazione.
    5. Elimina il tar del file devportal-update.tgz nella directory attuale:
      > tar -xzf /path/to/devportal-update.tgz
    6. Passa alla directory developer-update.
    7. Esegui questo comando per installare l'aggiornamento:
      &gt; ./install-update.sh
    8. Rispondi alle richieste.

L'upgrade è ora completato.

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, /opt/apigee/apigee-drupal di predefinita:
    &gt; cd /opt/apigee/apigee-drupal
  2. Esegui il backup dell'istanza del database Drupal. Il comando pg_dump crea una copia dei dati 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 dalla proprietà PG_NAME nel portale di configurazione dell'installazione.
    • host specifica l'IP del nodo del portale.
    • username specifica il nome utente Postgres utilizzato dal portale per accedere al database come specificato DRUPAL_PG_USER nella di configurazione dell'installazione del portale.
    • Viene richiesta la password utente Postgres, come definita dalla proprietà DRUPAL_PG_PASS nella 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 sei sicuro della posizione di questa directory, utilizza il comando drush status o il Configurazione > Media > Voce File nel menu Drupal per determinare la posizione del file system pubblico e il percorso del file system privato (per le passaggio).
  4. Crea un backup dei file in /opt/apigee/data/apigee-drupal-devportal/private.
  5. Disabilita SELinux come descritto in Installare l'utilità apigee-setup di Edge.
  6. Per un upgrade su un server con una connessione a internet:
      .
    1. Scarica il file Edge 4.17.05 bootstrap_4.17.05.sh in /tmp/bootstrap_4.17.05.sh:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
    2. Installare l'utilità Edge 4.17.05 apigee-service e dipendenze:
      > sudo bash /tmp/bootstrap_4.17.05.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.
  7. Per un upgrade su un server senza connessione a internet:
      .
    1. Crea un repository 4.17.05 locale come descritto in "Creare un repository Apigee locale" alle Installare apigee-setup un'utilità.
      Nota: se hai già un repository 4.17.01 esistente, puoi aggiungere 4.17.05 come descritto in "Aggiornare un repository Apigee locale" su Installa l'utilità apigee-setup 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.17.05.tar.gz:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror
      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:
        &gt; tar -xzf apigee-4.17.05.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.05.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.05.sh su /tmp/bootstrap_4.17.05.sh:
        > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh

        dove uName:pWord sono il nome utente e la password che hai impostato sopra per il repository, mentre remoteRepo è l'indirizzo IP o il nome DNS il nodo repository.
      3. Sul nodo remoto, installa l'utilità Edge apigee-service e dipendenze:
        > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        dove uName:pWord sono il nome utente e la password del repository.
  8. Usa apigee-service per aggiorna apigee-setup utilità:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup aggiornamento
  9. Esegui l'utilità di aggiornamento sul nodo per aggiornare il database Postgres:
    &gt; /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.
  10. Avvia Postgres:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. Esegui l'utilità di aggiornamento sul nodo per aggiornare il portale:
    &gt; /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.

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

/opt/apigee/apigee-drupal/wwwroot

L'upgrade è ora completato.