Ragioni per aggiornare e avvertenze

Davanti alle tante novità introdotte da questa nuova versione di Umbraco, sarebbe triste rimanere intrappolati in una qualunque delle versioni precedenti, perché le cose diventano davvero molto interessanti.

Vi consiglio tuttavia di frenare gli entusiasmi e di leggere - o almeno sorvolare - questo articolo prima di buttarvi in questa operazione che, se non eseguita a regola d'arte, può darvi un bel po' di mal di pancia.

Mi sono deciso a scrivere questa guida dopo avere riscontrato grosse difficoltà e aver ottenuto i seguenti risultati su un paio di installazioni ospitate su server virtuale Windows 2003.

Alcuni dei problemi riscontrati dopo l'upgrade:

1. Sembra andare tutto bene ma non funziona più nessuna delle macro xslt
2. L'interfaccia di Umbraco (il back end) non ha più nessun css associato
3. I dati compaiono nel back-end ma non sono più modificabili

Quindi, credetemi, anche se state per fare l'upgrade di un sito minore, NON LAVORATE MAI SULLA VERSIONE LIVE ! Esistono guide fatte molto bene e  più esaustive sul sito ufficiale di Umbraco ma considerate questa come un punto di partenza.

La prima cosa che dovete sapere è il numero di versione della vostra installazione (trovate questa informazione nel file web.config della root del vostro sito).

<add key="umbracoConfigurationStatus" value="4.0.3" />

Se questo valore è inferiore a 4.5, non tentate di aggiornare direttamente alla versione 4.7, perché ci sono grosse modifiche da una release ad un'altra maggiore. Quindi, se per esempio avete la versione 3.xxx dovreste aggiornare all'ultima versione della serie 3 (3.0.6) che, per altro, non sono più riuscito a trovare online.

Personalmente, partendo da versioni talvolta molto vecchie ho dovuto seguire questo percorso per non riscontrare problemi:

3.0.6 > 4.0.3 > 4.5 > 4.7

Non sto a raccontarvi quali sono le modifiche da una versione all'altra, ma ecco alcune delle cose che cambiano in questo processo:

Si passa da ASP.NET 2.0 a ASP.NET 4.0 (quindi se .NET 4 non è installato sulla vostra macchina e non avete la possibilità di farlo, lasciate perdere)

Le password che, prima della versione 4.0.3 erano salvate in chiaro nel database sono ora crittografate, e questo può giocare brutti scherzi.

La struttura del documento xml (XSLT schema) cambia con la versione 4.5 e questo ha un impatto sulle macro xslt (esiste in ogni caso una modalità che ne preserva la compatibilità).

Vi consiglio quindi di effettuare l'aggiornamento da una versione all'altra, verificando ogni volta che tutto funzioni a dovere prima di passare all'aggiornamento successivo, fino ad arrivare alla versione 4.7.