Upgrade del portale Servizi per gli sviluppatori

Portale di Servizi per gli sviluppatori v. 4.17.01

Questa procedura descrive come eseguire l'upgrade di un'installazione on-premise di Apigee Developer Channel Services.

Directory di installazione predefinita

Il processo di upgrade presuppone che il Portale per gli sviluppatori sia stato installato all'indirizzo /var/www/html. Se non hai installato il portale nella directory predefinita, modifica i percorsi nella procedura riportata di seguito per utilizzare la directory di installazione.

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

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

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

http://yourportal.com/buildInfo

Prima dell'installazione

Per le installazioni esistenti, se hai modificato un codice nel core Drupal o in moduli non personalizzati, le modifiche verranno sovrascritte. Sono incluse, tra le altre cose, le eventuali modifiche apportate a .file. Devi presumere che qualsiasi elemento al di fuori della directory /sites sia di proprietà di Drupal. Un'eccezione a questa regola è il file robots.txt; se il file esiste nella directory principale web, verrà conservato.

Prima di procedere con l'installazione, esegui un backup dell'intera directory root web di Drupal. Il percorso di installazione predefinito è /var/www/html, ma potresti averlo modificato al momento dell'installazione. Dopo aver eseguito la procedura di installazione descritta di seguito, puoi ripristinare le personalizzazioni dal backup.

Upgrade di Apigee Developer Channel Services a una nuova release

  1. Backup della tua istanza Drupal MySQL.
    Per ulteriori informazioni, visita http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/
    1. Opzione 1: utilizza Drush

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

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

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

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

    Puoi scaricare un file dal link che ti è stato inviato da Apigee in un browser oppure copiandolo e aggiungendolo al seguente comando cURL:
    > curl -kOL <paste link here>

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

    Vai a http://community.apigee.com/content/apigee-customer-support e seleziona Accedi al tuo portale di assistenza per richiedere il file .tar di Developer Channel Services. Se non hai un account sul portale di assistenza, seleziona Accedi al portale di assistenza, quindi nella pagina di accesso seleziona Hai fretta? Crea un ticket di assistenza qui.
  4. Per un upgrade su un server con connessione a internet:
    1. Estrai il file di upgrade del portale:
      > tar -xvf <tar file>

      Questo comando crea una nuova directory denominata DeveloperServices-4.x.y.z.
    2. Passa alla directory DeveloperServices-4.x.y.z.
    3. Scarica l'ultima versione di Drupal utilizzando il seguente comando:
      > drush dl drupal

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

      A seconda delle autorizzazioni del file, potresti dover utilizzare sudo per eseguire questo comando oppure eseguirlo come amministratore.
    5. Per ricevere notifiche sugli aggiornamenti di Drupal, assicurati che il modulo di gestione degli aggiornamenti di Drupal sia abilitato. Dal menu Drupal, seleziona Moduli e scorri verso il basso fino al modulo Gestione aggiornamenti. Se non è attivato, abilitalo.

      Una volta attivata la funzionalità, puoi visualizzare gli aggiornamenti disponibili utilizzando la voce di menu Report > Aggiornamenti disponibili.

      Utilizza la voce di menu Report > Aggiornamenti disponibili > Impostazioni per configurare il modulo in modo che ti invii un'email quando sono disponibili aggiornamenti e per impostare la frequenza del controllo degli 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>

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

      A seconda delle autorizzazioni del file, potresti dover utilizzare sudo per eseguire questo comando oppure eseguirlo in qualità di amministratore.

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

L'upgrade è stato completato.