Upgrade della versione Drupal di un'installazione di Private Cloud

Edge per Private Cloud v. 4.17.09

In un'installazione di Edge per il cloud privato del portale Servizi per sviluppatori, potresti ricevere una notifica che ti informa che è disponibile una nuova versione di Drupal. Una nuova versione può indicare una release di funzionalità di Drupal, una patch, un aggiornamento della sicurezza o un altro tipo di aggiornamento di Drupal. In caso di aggiornamento della sicurezza, è consigliabile eseguire l'upgrade dell'installazione di Drupal il prima possibile per garantire la sicurezza del sito.

La procedura riportata di seguito descrive come aggiornare un'installazione Private Cloud di Drupal 7.x.y a un'altra versione minore (ad esempio da Drupal 7.54 a 7.56).

Tieni presente quanto segue:

  • Questa procedura aggiorna solo l'installazione di Drupal. Non aggiorna il software Apigee fornito nell'ambito del portale. Per informazioni sull'upgrade del software del portale Apigee, consulta Aggiornamento del portale Servizi per gli sviluppatori.

  • Devi eseguire i comandi Drush dalla directory principale del sito del portale. Per impostazione predefinita, il Portale per gli sviluppatori è installato all'indirizzo:
    • /opt/apigee/apigee-drupal/wwwroot (Nginx)
    • /var/www/html (Apache)
    La procedura riportata di seguito presuppone un'installazione del server Nginx nella posizione predefinita indicata sopra.

Determinare la versione corrente di Drupal

Prima di avviare l'aggiornamento di Drupal, puoi determinare la versione corrente di Drupal eseguendo il seguente comando dalla cartella di installazione di Drupal. Per impostazione predefinita, Drupal è installato in /opt/apigee/apigee-drupal/wwwroot:

> cd /opt/apigee/apigee-drupal/wwwroot
> drush status | grep 'Drupal version'

Dovresti vedere l'output nel seguente formato:

Drupal version                  :  7.54  

Se hai installato Drupal in una directory diversa da /opt/apigee/apigee-drupal/wwwroot, assicurati di passare a quella directory prima di eseguire il comando drush.

Aggiornamento della versione di Drupal

Questa sezione descrive come utilizzare Drush (Drupal Shell) da una riga di comando per aggiornare la versione di Drupal. Consulta anche Aggiornamento di Drupal utilizzando Drush nella documentazione di Drupal.

Per aggiornare l'installazione di Drupal:

  1. Passa alla directory /opt/apigee/apigee-drupal/wwwroot, o alla directory in cui hai installato il portale.
  2. Esegui un backup completo di tutti i file, le directory e i database. Salva il backup in una posizione al di fuori dell'installazione di Drupal. Per le istruzioni complete, vedi Eseguire il backup del portale.

    Se hai apportato modifiche a file come .htaccess, robots.txt o defaults.settings.php (nella directory sites), dovrai applicare nuovamente le modifiche dopo l'aggiornamento. Dovrai anche applicare nuovamente le personalizzazioni apportate nella directory sites/all.

  3. Metti il sito in modalità di manutenzione:
    > drush vset --exact maintenance_mode 1 
    > drush cache-clear all
    
  4. Installa la versione di Drupal che preferisci utilizzando il seguente comando:

    > drush pm-update drupal-7.56

    Nota: sostituisci 7.56 con la versione che preferisci.
    In alternativa, puoi eseguire drush pm-update drupal per eseguire l'aggiornamento alla versione principale di Drupal più recente. Puoi eseguire drush pm-updatestatus per elencare gli aggiornamenti minori disponibili per i progetti Drupal core e contrib.
  5. Riapplica le modifiche apportate a .htaccess, robots.txt o defaults.settings.php (nella directory sites).
  6. Applica di nuovo le modifiche apportate alla directory sites/all .
  7. Rimuovi il sito dalla modalità di manutenzione:
    > drush vset --exact maintenance_mode 0 
    > drush cache-clear all
    

Che cosa succede se riscontro un problema durante l'aggiornamento?

Ripristina il sito allo stato precedente utilizzando i file di backup che hai creato. Contatta il tuo rappresentante dell'assistenza Apigee e fornisci eventuali messaggi di errore segnalati durante l'aggiornamento.