MoinMaster: AiutoSuAggiornamento

AiutoContenuti > AiutoSuAmministrazione > AiutoSuAggiornamento

Procedure generali

Scaricare e decomprimere l'archivio di MoinMoin

Scaricare il codice di MoinMoin della versione a cui si vuole aggiornare. Se non si è uno sviluppatore, la versione da scaricare è l'ultima versione stabile rilasciata.

Molto spesso è meglio (e più facile) installare l'ultimo rilascio dagli archivi piuttosto che usare la versione fornita dalla propria distribuzione Linux. Alcune persone usano moin come pacchetto, perché sperano in aggiornamenti più facili, ma molto spesso non c'è alcun aggiornamento o non sono facili da installare.

Leggere la documentazione

È molto utile leggere i file docs/CHANGES e docs/README.migration contenuti nell'archivio del programma per i dettagli su cosa è stato modificato e come eseguire l'aggiornamento.

I documenti possono contenere importanti suggerimenti per l'installazione, la compatibilità e l'aggiornamento non presenti in queste pagine.

Backup

Prima di aggiornare un wiki esistente, FARNE UNA COPIA DI BACKUP!

Siete stati avvisati, non è colpa nostra se poi vi ritrovate così:

Per fare un backup completo, senza perdere una sola revisione, è utile fermare il processo del wiki sul server.

Questo è tutto ciò di cui è utile eseguire il backup (i percorsi reali dipendono dalla proprio installazione):

• la directory contenente i file del codice di MoinMoin (/usr/lib/python*.*/site-packages/MoinMoin)

  • una volta fatto il backup di questa directory, è possibile cancellare la directory MoinMoin per evitare di avere vecchi file di codice che non vengono sovrascritti dal nuovo codice, ma con cui potrebbero interferire.

• la directory contenente i propri dati (/usr/share/moin/nomewiki/data, consultare l'opzione data_dir nella configurazione del wiki)

• il file moin.cgi (o moin.fcg o un altro file in base a cosa viene usato nel server)
• il file wikiconfig.py o farmconfig.py o qualsiasi altro file di configurazione
• i file di configurazione del server web

• è possibile anche eseguire un backup della underlay_data_dir (non dovrebbe contenere dati creati localmente, ma ma è comunque più facile ripristinare una versione precedente se si dispone di un backup)

Aggiornare il codice

Prima di tutto rimuovere il vecchio codice di MoinMoin (compresi i file *.pyc and *.pyo).

Se si sta eseguendo l'installazione dall'archivio originale, eseguire python setup.py install come root per installare la nuova versione

Se non si sta usando un pacchetto di una distribuzione Linux, leggere la documentazione presente.

Aggiornare anche il file moin.cgi (o moin.wsgi o altro). Potrebbe essere necessario modificarlo e sistemare i percorsi ed è necessario impostare anche la modalità, l'utente e il gruppo (consultare il vecchio file prima di rimuoverlo).

Aggiornare la configurazione

Una volta fatto l'aggiornamento, il nuovo wiki dovrebbe continuare a funzionare (l'obiettivo è quello di avere valori predefiniti utili e non troppo particolari, ma potrebbero esserci dei bug o anche delle modifiche che "rompono" la compatibilità).

Controllare accuratamente il file CHANGES per vedere le modifiche, solitamente le nuove caratteristiche sono nascoste a meno che non sia stato estesa la propria configurazione in wikiconfig.py.

Verificare di avere l'ultima versione del file "intermap.txt", se sono state fatte aggiunte a questo file, è possibile far puntare shared_intermap a un file caricato prima del file presente nella directory data che ha precedenza (per esempio, basta avere le voci globali nel file shared e quelle private nel file nella directory data).

Aggiornare gli oggetti statici

Con ogni aggiornamento è utile copiare il contenuto della directory wiki/htdocs fornita con quella presente nel server. Solitamente un nuovo rilascio contiene nuove immagini, nuovi CSS e Javascript.

È necessario anche modificare la configurazione del server o delle directory affinché corrisponda all'impostazione di url_prefix_static. Il valore predefinito è /moin_staticVVV (VVV è 170 per il rilascio 1.7.0 di moin) e verrà cambiato con ogni rilascio (moin 1.7.1 userà /moin_static171). Questo è fatto per poter avere una durata della cache degli oggetti statici molto lunga, consentendo al wiki di lavorare più velocemente e di causare meno carico.

Aggiornare le pagine wiki

Pagine di sistema e di aiuto

Le pagine di sistema e di aiuto sono separate nella directory underlay. Usare sempre la directory underlay fornita nell'archivio e cancellare quella vecchia (spostare quella vecchia nella directory di backup).

Le pagine più preziose

Consultare i file CHANGES e README.migration per i passi necessari per convertire data_dir ai nuovi valori.

Risoluzione problemi

Usare percorsi assoluti non relativi!

Assicurarsi di avere informazioni di registrazione (log) adeguate (consultare lo script del server e quello di configurazione della registrazione) e leggere le registrazioni!

Assicurarsi che Python possa trovare il codice di MoinMoin e i file di configurazione del wiki (sistemare sys.path nello script del server oppure la variabile d'ambiente PYTHONPATH).

Assicurarsi che MoinMoin possa trovare data_dir e data_underlay_dir (consultare wikiconfig.py).

Quando si modificano file Python (per esempio wikiconfig.py), assicurarsi di applicare i corretti rientri (usare quattro spazi, non la tabulazione) e prestare attenzione agli errori sintattici, Se si dispone di un file di configurazione funzionante è meglio non applicare troppe modifiche in una sola volta (ed è sempre meglio avere una copia di sicurezza della vecchia versione).

Controllare i permessi (il processo di moin necessita di accesso in scrittura/lettura su data_dir e data_underlay_dir e almeno accesso in lettura al codice di MoinMoin e alla configurazione).

In base alla propria installazione, è consigliato mantenere un alto livello di sicurezza. Solitamente ai file nella directory data viene assegnato l'utente con cui viene eseguito il server web e quindi usare le maschere 700 o 770 (consultare anche le impostazioni di config.umask).