Questa soluzione è un’alternativa manuale all'aggiornamento automatico che bypassa il problema di Blank Page (pagina bianca) lato front-end e back-end che spesso si verifica al termine della procedura di upgrade.

1. Joomla!: come eseguire l’aggiornamento dalla versione
2.5.x alla versione 3.3.3
Carlo Marenzi
www.techsolma.com – Joomla! Upgrade dalla versione 2.5.x alla 3.3.3

2. www.techsolma.com – Joomla! Upgrade dalla versione 2.5.x alla 3.3.3
Prima di creare Techsolma ho lavorato vent'anni a
Milano e Pavia nel settore delle Tlc, per multinazionali
come Telecom Italia, Vodafone ed Ericsson.
Adesso mi occupo di consulenza tecnologica, sviluppo
siti web e web marketing.
• LinkedIn: http://it.linkedin.com/in/carlomarenzi
• Twitter: https://twitter.com/CarloMarenzi
• Facebook: https://www.facebook.com/techsolma?ref=hl&ref_type=bookmark
• Facebook: https://www.facebook.com/pages/Vallestafforainfo/551523494955323?ref=hl&ref_type=bookmark
• Web: http://www.techsolma.com
• Web: http://www.vallestaffora.info

3. Come noto, il supporto alla versione 2.5 di Joomla! terminerà il 31 dicembre 2014
(http://docs.joomla.org/What_version_of_Joomla!_should_you_use%3F) e,
anche se si tratta di una versione molto stabile e collaudata che può essere
utilizzata ancora a lungo, per ragioni prettamente legate alla sicurezza dei sistemi
di produzione vale la pena iniziare a programmare l’upgrade ad una versione LTS
(Long Term Support) più recente.
Io ho provato con la nuova versione 3.3.3, in attesa della 3.5 che, da settembre,
dovrebbe essere LTS a tutti gli effetti.
www.techsolma.com – Joomla! Upgrade dalla versione 2.5.x alla 3.3.3

4. www.techsolma.com – Joomla! Upgrade dalla versione 2.5.x alla 3.3.3

5. Un articolo utile allo scopo che illustra dettagliatamente gli steps necessari ad
eseguire l’aggiornamento in modo molto preciso ed esaustivo è quello di
Alessandro Rossi (AlexRed) (http://www.joomla.it/notizie/7485-guida-all-
aggiornamento-dalla-versione-2-5-alla-3-di-joomla.html ).
La soluzione da me proposta è, invece, un’alternativa che bypassa il problema
di Blank Page (pagina bianca) lato front end e back end che spesso si verifica
al termine della procedura di upgrade.
Nell’articolo su Bamboo Blog (http://www.joomlabamboo.com/blog/how-to-
joomla/how-to-fix-a-blank-screen-after-upgrading-to-joomla-3-2 ) vengono
riportati alcuni passi per fissare lo spiacevole inconveniente attraverso la
momentanea disabilitazione del file remeber.xml
(/plugins/system/remember), così da poter investigare sulle cause d’errore
nell’installazione di Joomla!
Tuttavia, anche questo metodo nel mio caso non è stato sufficiente a risolvere
i problemi riscontrati, quindi ho sviluppato una procedura manuale alternativa
che vado ad illustrare di seguito.
www.techsolma.com – Joomla! Upgrade dalla versione 2.5.x alla 3.3.3

6. VERIFICHE PRE UPGRADE
Prima di iniziare l’aggiornamento occorre eseguire alcune verifiche preliminari
e apportare le dovute correzioni:
www.techsolma.com – Joomla! Upgrade dalla versione 2.5.x alla 3.3.3

7. 1. Aggiornare il sito con Joomla 2.5 all’ultima versione disponibile (esempio
2.5.24). Dal menu Componenti -> Aggiornamento di Joomla!
2. Dal menu Sito -> Informazioni di sistema verificare che la versione di PHP
utilizzata dal server che ospita il nostro sito sia superiore alla 5.3.10:
- PHP ver. > 5.3.10: procedere pure con l’aggiornamento alla versione
3.3.x;
- PHP ver. < 5.3.10: NON è possibile eseguire l’upgrade alla versione
3.3.x;
3. Dal menu Estensioni -> Gestione estensioni -> Esplora verificare la
presenza di estensioni che non sono state installate attraverso il normale
processo di installazione. Nel caso, procedere con la correzione.
4. Qualora fosse attiva la cache (menu Sito -> Pannello di Controllo ->
Configurazione globale -> Sistema), disattivarla e svuotarla: menu Sito ->
Manutenzione -> Pulisci cache
5. Verificare che la struttura del database sia allineata (menu Estensioni ->
Gestione estensioni -> Database): di norma dovrebbe esserlo; in caso
contrario, è possibile allinearla alla versione attuale.
www.techsolma.com – Joomla! Upgrade dalla versione 2.5.x alla 3.3.3

8. BACKUP
Come noto, è buona prassi eseguire sempre un backup completo del database e del
sito prima di procedere con qualsiasi modifica, in modo di avere una versione
funzionante sempre a disposizione e di provvedere ad un veloce ripristino nel caso in
cui le cose andassero storte. Io, in genere, li eseguo manualmente con phpMyAdmin e
FileZilla ma l’attività può essere automatizzata con ottimi moduli o estensioni, come
Akeeba Backup (https://www.akeebabackup.com/download.html ) .
Una volta conclusa l’operazione, si consiglia di eseguire la procedura in un ambiente di
test offline e, solo successivamente, caricare il database e i files di Joomla aggiornati
nel sistema di produzione online, avendo cura di apportare le dovute modifiche al file
configuration.php.
IL TEMPLATE
Siccome i templates compatibili con la versione 3.x sono realizzati con specifiche
differenti rispetto a quelli delle distribuzioni precedenti, occorre verificare se della
nostra versione in 2.5.24 ne esiste uno compatibile con la major release superiore.
Nel mio caso, usando il free template Zenith di Themexpert
(http://demo.themexpert.com/joomla/zenith/ ), ho potuto scaricare facilmente il
pacchetto compatibile con la versione 3.x.
www.techsolma.com – Joomla! Upgrade dalla versione 2.5.x alla 3.3.3

9. ESECUZIONE DELL’UPGRADE
In ambiente locale di test (esempio Xampp) eseguire i seguenti passaggi:
1. Installare l’ultima versione di Joomla!: la 3.3.3
2. Installare il template compatibile con la versione 3.x
3. Installare le versioni compatibili con Joomla 3.x dei moduli, delle estensioni e dei
plugin già presenti sulla versione 2.5.24
4. Da phpMyAdmin rimuovere il database aggiornato alla versione 3.x dopo averne
fatta una copia locale per eventuali ripristini.
5. Sempre da phpMyAdmin, installare la versione del database in 2.5.24.
A questo punto ci troviamo il nostro sito aggiornato alla versione di Joomla! 3.3.3,
completo di tutti i moduli e le estensioni, che utilizza un database in versione 2.5.24.
www.techsolma.com – Joomla! Upgrade dalla versione 2.5.x alla 3.3.3

10. 6. Da phpMyAdmin eseguire manualmente l’aggiornamento del database partendo
dal file .sql meno recente (3.0.0.sql) al più recente. I files si trovano in
ROOT/administrator/components/com_admin/sql/updates : scegliere gli scripts .sql
a seconda del database utilizzato.
www.techsolma.com – Joomla! Upgrade dalla versione 2.5.x alla 3.3.3

11. Ogni file deve essere opportunamente modificato con un editor (trova/sostituisci) in
modo di non avere problemi nel momento in cui viene eseguito con PhpMyAdmin. Nel
dettaglio, la stringa “#__”va sostituita con il dbprefix che stiamo già utilizzando (nel
mio caso “J25upg_”). Di seguito un esempio pratico:
prima: ALTER TABLE `#__update_sites` ADD COLUMN `extra_query` VARCHAR(1000)
DEFAULT '';
dopo: ALTER TABLE ` J25upg_update_sites` ADD COLUMN `extra_query`
VARCHAR(1000) DEFAULT '‘;
www.techsolma.com – Joomla! Upgrade dalla versione 2.5.x alla 3.3.3

12. Ora la situazione dovrebbe essere allineata: il sito e il database sono in Joomla! 3.3.3.
E’ sempre possibile verificare l’allineamento del database attraverso il metodo
illustrato in precedenza (menu Estensioni -> Gestione estensioni -> Database). Se la
procedura è andata a buon fine, il sito dovrebbe essere aggiornato alla nuova release e
si può passare alla fase di test.
Successivamente, possiamo sostituire il vecchio database con il nuovo e caricare tutti i
files della nuova versione su server tramite FTP.
Prima, però, non dimentichiamoci di modificare nel file configuration.php i principali
parametri necessari alla connessione al database e il gioco è fatto:
public $dbtype = 'mysqli';
public $host = 'xxx.xxx.xxx.xxx';
public $user = 'xxxxxxxxx';
public $password = 'xxxxxxxxx';
public $db = 'xxxxxxx';
public $dbprefix = 'xxxxx_';
www.techsolma.com – Joomla! Upgrade dalla versione 2.5.x alla 3.3.3

13. Ora la situazione dovrebbe essere allineata: il sito e il database sono in Joomla 3.3.3. E’
sempre possibile verificare l’allineamento del database attraverso il metodo illustrato
in precedenza (menu Estensioni -> Gestione estensioni -> Database). Se la procedura è
andata a buon fine, il sito dovrebbe essere aggiornato alla nuova release e si può
passare alla fase di test.
Successivamente, possiamo caricare tutti i files della nuova versione su server tramite
FTP e sostituire il vecchio database con il nuovo.
Prima, però, non dimentichiamoci di modificare nel file configuration.php i principali
parametri necessari alla connessione al database e il gioco è fatto:
public $dbtype = 'mysqli';
public $host = 'xxx.xxx.xxx.xxx';
public $user = 'xxxxxxxxx';
public $password = 'xxxxxxxxx';
public $db = 'xxxxxxx';
public $dbprefix = 'xxxxx_';
www.techsolma.com – Joomla! Upgrade dalla versione 2.5.x alla 3.3.3