Upgrade del portale Servizi per gli sviluppatori

Portale per i servizi per gli sviluppatori v. 4.16.09

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

Directory di installazione predefinita

Il processo di upgrade presuppone che il Portale per gli sviluppatori sia stato installato in /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

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

http://yourportal.com/buildInfo

Prima dell'installazione

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. Devi presumere che tutto ciò che si trova al di fuori della directory /sites sia di proprietà di Drupal. Un'eccezione a questa regola è il file robots.txt: se esiste nella directory principale del sito web, verrà conservato.

Prima di procedere con l'installazione, esegui il backup dell'intera directory principale del web Drupal. Il percorso di installazione predefinito è /var/www/html, ma potresti averlo modificato al momento dell'installazione. Dopo aver eseguito i passaggi di installazione descritti di seguito, puoi ripristinare le personalizzazioni dal backup.

Upgrade dei servizi Apigee Developer Channel a una nuova release

  1. Backup dell'istanza MySQL di Drupal.
    Per ulteriori informazioni, visita la pagina 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 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' NOMEDATABASE > /path/to/backup_dir/database-backup.sql

      Non deve essere presente spazio tra l'opzione -p e la password. Le virgolette singole intorno alla password sono obbligatorie se la password contiene caratteri speciali.

      Hai impostato USERNAME e DATABASENAME quando hai installato il portale. Per impostazione predefinita, entrambi sono devportal.
  2. Esegui il backup dell'intera directory principale del web di Drupal. La posizione di installazione predefinita è /var/www/html, ma potresti averla modificata al momento dell'installazione.
  3. Scarica il file DeveloperServices_x.y.z.tar di Developer Channel Services, dove x.y.z corrisponde al numero di versione del portale.

    Puoi scaricare un file dal link inviato da Apigee in un browser oppure copiarlo e poi aggiungerlo 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 che dispone dell'accesso.

    Vai alla pagina http://community.apigee.com/content/apigee-customer-support e seleziona Accedi al tuo portale di assistenza per richiedere il file .tar per l'upgrade dei servizi del Canale sviluppatori. Se non disponi di un account sul Portale di assistenza, seleziona Accedi al portale di assistenza, quindi seleziona Hai fretta? Invia un ticket di assistenza qui.
  4. Per eseguire l'upgrade su un server con una connessione a internet:
    1. Estrai il file di upgrade del portale:
      > tar -xvf <file tar>

      Questo comando estrae crea una nuova directory denominata DeveloperServices-4.x.y.z.
    2. Passa alla directory DeveloperServices-4.x.y.z.
    3. Scarica la versione più recente 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 dei file, potrebbe essere necessario utilizzare sudo per eseguire questo comando o eseguirlo come amministratore.
    5. Per ricevere notifiche relative agli aggiornamenti di Drupal, assicurati che il modulo gestore degli aggiornamenti di Drupal sia abilitato. Dal menu di Drupal, seleziona Moduli e scorri verso il basso fino al modulo Gestione aggiornamenti. Se non è abilitato, abilitalo.

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

      Utilizza il 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 di ricerca degli aggiornamenti.
  5. Per eseguire l'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 <file tar>

      Questo comando di estrazione 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 dei file, potrebbe essere necessario utilizzare sudo per eseguire questo comando o eseguirlo come 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 a tua scelta.
    4. Copia devportal-update.tgz sul server di destinazione, quello su cui è in esecuzione il portale.
      Nota: non copiare devportal-update.tgz nella directory principale del web del server di destinazione.
    5. Estrai 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 ai prompt.

L'upgrade è ora completato.