Upgrade del portale Servizi per gli sviluppatori

Developer Services Portal v. 4.16.05

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

Directory di installazione predefinita

La procedura di upgrade presuppone che il portale per 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-4.24.216
  • pantheon-4.24.246
  • 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

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

http://yourportal.com/buildInfo

Upgrade dei servizi del canale per sviluppatori Apigee a una nuova release

  1. Backup dell'istanza MySQL di Drupal.
    Per saperne di più, 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 USERNAME -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, è necessario racchiuderla tra virgolette singole.

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

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

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

    Vai alla pagina http://community.apigee.com/content/apigee-customer-support e seleziona Login to your Support Portal (Accedi al tuo portale di assistenza) per richiedere il file .tar di upgrade dei servizi per i canali per sviluppatori. 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 una connessione a internet:
    1. Estrai il file di upgrade del portale:
      > tar -xvf <tar file>

      Questo comando di estrazione 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 dei file, potresti dover utilizzare sudo per eseguire questo comando o eseguirlo come amministratore.
    5. Per ricevere notifiche sugli aggiornamenti di Drupal, assicurati che il modulo Drupal Update manager sia abilitato. Dal menu di Drupal, seleziona Modules (Moduli) e scorri verso il basso fino al modulo Update manager (Gestore aggiornamenti). Se non è abilitata, abilitala.

      Una volta attivata, 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 di 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 dei servizi per gli sviluppatori, 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. Esegui lo script non-networked-update.sh:
      > ./non-networked-update.sh

      A seconda delle autorizzazioni dei file, potresti dover 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 di tua scelta.
    4. Copia devportal-update.tgz sul server di destinazione, quello su cui è in esecuzione il portale.
      Nota: Non copiare il file devportal-update.tgz nella directory principale 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 è stato completato.