Aggiornamento dalla 4.5 alla 4.6.3

Questo è un semplice approccio passo dopo passo all'aggiornamento di un sito da Drupal 4.5 a Drupal 4.6.3

Occorre circa un'ora e mezza per completare l'operazione ed è importante seguire ogni passo attentamente per evitare anomalie o problemi nelle fasi successive.

Prima di cominciare

Se si sta utilizzando uno di questi moduli sul proprio sito Drupal 4.5 che si è deciso di aggiornare, bisogna leggere con attenzione le note in fondo a questa pagina:

Image.module, Forum.module, Event.module.

Bisogna effettuare un backup del database MYSQL di Drupal oltre al backup dei file e delle cartelle di Drupal sul server, nel caso la procedura di aggiornamento non dovesse andare a buon fine.

Aggiornamento passo-per-passo da Drupal 4.5 a 4.6.3

1. Bisogna accedere al proprio sito Drupal 4.5 effettuando il login come amministratore, andare in AMMINISTRA --> MODULI e disabilitare tutti i moduli extra aggiuntivi installati come non core di Drupal. Di seguito sono elencati i moduli core standard di Drupal:

   Moduli Drupal standard
   --------------------------
   aggregator.module
   archive.module
   block.module
   blog.module
   blogapi.module
   book.module
   comment.module
   drupal.module
   filter.module
   forum.module
   help.module
   legacy.module
   locale.module
   menu.module
   node.module
   page.module
   path.module
   ping.module
   poll.module
   profile.module
   queue.module
   search.module
   statistics.module
   story.module
   system.module
   taxonomy.module
   throttle.module
   tracker.module
   upload.module
   user.module
   watchdog.module
   =================

2. Andare in AMMINISTRA --> TEMI e scegliere BLUEMARINE come tema predefinito.
3. Andare nella root della cartella di Drupal e aprire il file chiamato CHANGELOG.txt . Bisogna inserire una nota del numero di versione e della data (importante!) nella prima riga in cima al file.
4. Andare nella tua cartella includes e creare una copia del file conf.php in locale sul tuo computer.
5. Cancellare tutti i file e le cartelle di Drupal dal tuo server utilizzando un client FTP o il pannello di controllo filemanager messo a disposizione dal tuo web host.
6. Scaricare Drupal 4.6.0 e caricare tutti i file sul tuo server.
7. Andare nella cartella sites/default e editare il file settings.php (potresti utilizzare il tuo vecchio file conf.php come riferimento).
8. Una volta editato il file settings.php andare sul tuo sito ed accedervi come amministratore.
9. Andare su http://www.iltuosito.com/update.php .
10. Dovrebbe essere visualizzato l'elenco delle istruzioni per l'aggiornamento. Cliccare sul collegamento per avviare lo script di aggiornamento; ti verrà chiesto da quale versione vuoi aggiornare. E' molto importante: torna alla nota inserita prima nel file CHANGELOG.txt .
11. Cliccare sul bottone "Update". Dovrebbe essere visualizzato un messaggio di operazione riuscita "OK" dopo ogni operazione di aggiornamento e infine un collegamento per andare alla pagina principale di amministrazione. Se invece viene visualizzato un messaggio d'errore in rosso significa che parte o l'intera operazione di aggiornamento è fallita.
12. In caso di aggiornamento effettuato correttamente, andare nella root della cartella di Drupal e inserire una nota del numero di versione e della data nella prima riga in cima al file CHANGELOG.txt (importante).
13. Andare nella cartella sites/default e creare una copia del file settings.php in locale sul tuo computer.
14. Cancellare tutti i file Drupal dal tuo install.
15. Scaricare Drupal 4.6.2 e caricare i file sul tuo server.
16. Andare sul tuo sito e accedervi come amministratore.
17. Andare su http://www.iltuosito.com/update.php (Cliccare sul pulsante di "Ricarica pagina corrente" del browser per un pò di volte in modo tale da essere sicuri che non stia caricando dalla cache il "vecchio" file update.php).
18. Cliccare sul collegamento per avviare lo script di aggiornamento. Selezionare il corretto numero di versione e la corretta data dal file CHANGELOG.txt creato in precedenza.
19. Cliccare sul pulsante "Update". Dovrebbe essere visualizzato un messaggio di operazione riuscita "OK" dopo ogni operazione di aggiornamento e infine un collegamento per andare alla pagina principale di amministrazione. Se invece viene visualizzato un messaggio d'errore in rosso significa che parte o l'intera operazione di aggiornamento è fallita.
20. Ripetere questo processo di nuovo per aggiornare Drupal 4.6.2 a Drupal 4.6.3
21. Una volta raggiunta una versione live della 4.6.3, sarà possibile scaricare i moduli aggiuntivi e i temi usati in precedenza nella versione 4.5 di Drupal. Quest'ultimi si integreranno bene nel core di Drupal tranne il modulo event.module che necessita di un attenzione extra quando si scarica una versione 4.6 dei moduli. Alcuni di questi moduli più complessi di solito avranno un unico file module-update.php incluso per semplificare il processo. Controllare il file readme.txt o il file install.txt nella cartella del modulo.

Concludendo l'aggiornamento

Ci sono poche differenze rilevanti tra Drupal 4.5 e 4.6.x che aiutano a finalizzare l'aggiornamento e per questo scopo bisogna eseguire le seguenti operazioni:

Ricostruire il Drupal Search Index

A causa del nuovo modulo search migliorato, il search index del sito avrà bisogno di essere ricostruito.

1. Andare in AMMINISTRA --> IMPOSTAZIONI --> CERCA. Verrà indicata la percentuale indicizzata del sito aggiornato.
2. Se il search index del sito non è al 100% bisogna lasciare lo script scrivendo nel proprio browser l'indirizzo http://www.iltuosito.com/cron.php .
3. Attendere per un minuto (anche di più se il sito è molto grande) e premere il pulsante BACK del browser per tornare indietro nella pagina IMPOSTAZIONI/CERCA.
4. Se il sito non è ancora indicizzato al 100% e/o si è ricevuto un messaggio di errore durante l'esecuzione del CRON.PHP bisogna sistemare i settaggi e scrivere nuovamente http://www.iltuosito.com/cron.php .
5. Ripetere il procedimento fino a indicizzare completamente il sito.

Blocchi

Nella versione 4.6 ci sono molti miglioramenti nella gestione dei blocchi. Se prima dell'aggiornamento si erano configurati dei blocchi nella pagina di amministrazione, bisogna riconfigurarli.

1. Andare in AMMINISTRA --> BLOCCHI
2. Cliccare sul link MODIFICA BLOCCO per ogni blocco configurato e modificarlo.

Permessi

Notare che in Drupal 4.6.x la sezione dei permessi è stata spostata in AMMINISTRA --> CONTROLLO DEGLI ACCESSI. Per essere sicuri di aver configurato i permessi nella stessa maniera della versione 4.5, seguire i seguenti passi:

1. Andare in AMMINISTRA --> CONTROLLO DEGLI ACCESSI
2. Controllare attentamente che i permessi sono corretti e cliccare su SALVA CONFIGURAZIONE.

Forum

Dopo l'aggiornamento bisogna riassociare i termini delle categorie usate in Drupal 4.5 al tipo di nodo FORUM TOPIC. Il motivo è nella nuova gestione dei forum che include la nuova sezione di configurazione FORUM che rende più semplice la procedura.

1. Andare in AMMINISTRA --> CATEGORIE
2. Cliccare su AGGIUNGI VOCABOLARIO per la categoria FORUM
3. Scrollare giù e assicurarsi che i tipi di nodo FORUM TOPIC sono associati con il Vocabolario.

Sembra esserci un problema (bug) nello script update.php legato ai forum perchè lo script registra come proprietario di tutti gli ultimi post di ogni categoria l'utente Anonimo.

Per qualsiasi altro problema non citato in questa guida, consultare anche il Forum dei problemi di aggiornamento.

Immagini

Aggiornare un sito con il modulo image già installato potrebbe dimostrarsi difficile. Anche in questo caso consultare anche il Forum dei problemi di aggiornamento.

Eventi

Aggiornare un sito con il modulo event già installato potrebbe dimostrarsi difficile.