DokuWiki: upgrade dell’installazione

DokuWiki è l’ennesimo software in grado di mettere in piedi uno spazio dove poter salvare testo, immagini e allegati da rendere pubblici e magari modificabili da persone interessate a mandare avanti vostri lavori, idee, spunti di riflessione. Viene usato nei modi più disparati (anche come blog, ndr) ma personalmente lo preferisco per ciò che si prefigge di fare dalla nascita:

DokuWiki is a standards compliant, simple to use Wiki, mainly aimed at creating documentation of any kind. It is targeted at developer teams, workgroups and small companies. It has a simple but powerful syntax which makes sure the datafiles remain readable outside the Wiki and eases the creation of structured texts. All data is stored in plain text files – no database is required.

Liberamente scaricabile dal sito web dell’autore (splitbrain.org/projects/dokuwiki), vanta un’installazione sufficientemente semplice (occhio a modificare i permessi delle cartelle e sottocartelle in 0777, qui la lista di ciò che va toccato: public.gfsolone.com/wiki/doku.php?id=wiki:permessi_installazione) e una configurazione che può essere un pelo più complessa se si decide di mettere mano ben oltre quello che il software propone di default. In ogni caso l’abbondante documentazione a vostra disposizione vi aiuterà nello scopo. Potete vedere un’installazione funzionante sullo spazio pubblico di gfsolone.Com all’indirizzo public.gfsolone.com/wiki (che andrà a sostituire l’ormai abbandonata installazione su GxWare).

Ma parliamo dell’argomento principale dell’articolo: l’aggiornamento.

Sempre sulla PubWiki ho creato una sezione “Diff” dedicata a tutti coloro che hanno un’installazione su hosting condiviso e necessitano di fare l’aggiornamento alle nuove versioni. Attraverso un documento del supporto si può imparare ad individuare facilmente ciò che realmente cambia da una release ad un’altra: dokuwiki.org/install:diffupgrade. Per farlo è necessario avere accesso ad un terminale Linux (o equivalente) ed eseguire dei semplici comandi che serviranno a scompattare i file, quindi confrontare il loro contenuto (i file che compongono il software).

Prima di partire

Ricordate sempre di effettuare un backup della vostra configurazione e dei vostri contenuti (date un’occhiata in documentazione o consultate questo mio articolo a riguardo), quindi di aprire in modifica il file di configurazione e impostare il tema di default per evitare sgradite sorprese post-upgrade. Se vi state chiedendo perché sappiate che il sottoscritto ha “bruciato” un’installazione in produzione, rifatta quasi da capo recuperando parzialmente i dati dal backup, per poi capire che il tema custom non permetteva di far funzionare in modo corretto Adora Belle.

Si, potete insultarmi per questo.

Diff & Patch

Dato che odio dover ricaricare tutto ogni volta, preferisco seguire questo metodo, individuare i file modificati da una release all’altra ed eseguire così l’aggiornamento:

Per ciascuna nuova release (entro qualche giorno al massimo, portate pazienza) creerò un pacchetto “diff” contenente i file modificati da una release all’altra, avendo cura di rimuovere anche il file install.php che non va più tenuto nella cartella ftp di DokuWiki dopo aver già effettuato la prima installazione.

Per fare ciò che ho fatto io basterà scaricare i due file corrispondenti alla release attuale di DokuWiki e quella subito precedente, quindi estrarli e confrontarli tramite questo comando:

diff -rs dokuwiki-2012-01-25b dokuwiki-2012-09-10 | awk '/identical/{print $4}' | xargs rm -v

Dove “dokuwiki-2012-01-25b” e “dokuwiki-2012-09-10” ovviamente andranno modificati di volta in volta con i nuovi numeri di versione. Lo stesso comando (per il quale ringrazio il buon Paolo) si occuperà di cancellare tutti i file non modificati da una release all’altra, permettendo così di tenere solo lo stretto indispensabile, connettersi in SFTP alla macchina, recuperare la cartella intera e preparare un file compresso con il risultato :-)

Ecco quindi ciò che ho ottenuto dal rilascio “Adora Belle“: public.gfsolone.com/wiki/doku.php?id=wiki:dokuwiki_diff:adorabelle

Il pacchetto compresso un è 7z (7zip.org) ed è disponibile per il download qui: public.gfsolone.com/wiki/lib/exe/fetch.php?media=wiki:dokuwiki_diff:dokuwiki-2012-09-10-diff.7z

Chiunque voglia collaborare o suggerire altri metodi per gestire gli aggiornamenti di DokuWiki su hosting condiviso è il benvenuto, idem chi vorrebbe provare a creare i diff da caricare poi sul Wiki. Ho anche provato ad utilizzare il plugin consigliato in documentazione ufficiale ma sfortunatamente WebPerTe (dove conservo gfsolone.com) impone alcune restrizioni che non permettono la modifica dinamica dei permessi sui file (quindi la sovrascrittura).