Guida all'aggiornamento

Introduzione

Questo documento spiega i tre metodi di aggiornamento:

  • Aggiornamento tramite setup.py
  • Aggiornamento tramite pacchetto DEB
  • Aggiornamento utilizzando il pacchetto RPM

La sezione Istruzioni per versioni specifiche descrive le modifiche necessarie da una versione all'altra. Queste modifiche si applicano a tutti i metodi di aggiornamento.

È necessario utilizzare la stessa tecnica di aggiornamento dell'installazione iniziale! Per esempio, se hai usato setup.py per installare Weewx, allora dovresti usare setup.py per aggiornare. Se hai utilizzato un pacchetto DEB o RPM per l'installazione, devi eseguire l'aggiornamento utilizzando lo stesso tipo di pacchetto.

Aggiornamento tramite setup.py

Se usi la vecchia versione Python 2 e prevedi di passare a Python 3, assicurati di aver installato tutti i prerequisiti richiesti. Puoi trovarli nella guida all'installazione .

Quindi seguire la procedura di installazione standard:

Decomprimi l'archivio:

tar xvfz weewx-X.Y.Z.tar.gz

Cambia directory in esso:

cd weewx-X.Y.Z 

Costruisci la distribuzione, usando qualunque versione di Python prevedi di usare. Ad esempio, per Python 3:

python3 ./setup.py build

Prima di eseguire il passaggio successivo, assicurati che home nel file setup.cfg sia impostato sulla posizione della precedente installazione di Weewx.

Dopo aver controllato setup.cfg , installa la tua nuova versione di Weewx, sempre usando la versione di Python che intendi usare:

sudo python3 ./setup.py install

Il processo di installazione eseguirà quanto segue:

  • Installa la nuova versione nella directory bin , conservando eventuali estensioni utente nella directory bin/user
  • Salva una copia del vecchio weewx.conf come weewx.conf.YYYYMMDDHHMMSS
  • Aggiorna la tua copia di weewx.conf , riflettendo tutte le modifiche richieste dall'ultima versione di Weewx. Questa versione aggiornata viene quindi installata.
  • Installa una directory delle skin se non ne esiste già una.

Infine, riavvia Weewx.

Aggiornamento tramite pacchetto DEB

Se hai specificato il repository apt di Weewx in /etc/apt/sources.list.d/weewx.list , aggiorna all'ultima versione in questo modo:

sudo apt-get update
sudo apt-get install weewx

Altrimenti, scarica l'ultimo pacchetto X.Y.Z DEB dalla pagina Download su weewx.com, quindi aggiorna in questo modo:

sudo dpkg -i weewx_X.Y.Z-R.deb

Il processo di aggiornamento non modificherà i database di Weewx.

I file non modificati verranno aggiornati. Se sono state apportate modifiche alla configurazione di Weewx, ti verrà chiesto se vuoi mantenere la configurazione esistente o accettare la nuova configurazione. In ogni caso, verrà salvata una copia dell'opzione che non hai scelto.

Ad esempio, se /etc/weewx/weewx.conf è stato modificato, verrà visualizzato un messaggio simile a questo:

Configuration file `/etc/weewx/weewx.conf'
  ==> Modified (by you or by a script) since installation.
  ==> Package distributor has shipped an updated version.
  What would you like to do about it ?  Your options are:
            Y or I  : install the package maintainer's version
            N or O  : keep your currently-installed version
              D     : show the differences between the versions
              Z     : start a shell to examine the situation
         The default action is to keep your current version.
  *** weewx.conf (Y/I/N/O/D/Z) [default=N] ?

Scegliendo Y o I (installa la nuova versione) posizionerai la tua vecchia configurazione in /etc/weewx/weewx.conf.dpkg-old , dove può essere confrontata con la nuova versione in /etc/weewx/weewx.conf .

Scegliendo N o O (mantieni la versione corrente) la nuova configurazione verrà posizionata in /etc/weewx/weewx.conf.XYZ , dove XYZ è il nuovo numero di versione. Può quindi essere confrontato con la tua vecchia versione che sarà in /etc/weewx/weewx.conf .

La stragrande maggioranza delle volte vorrai scegliere N (il valore predefinito).

Aggiornamento utilizzando il pacchetto RPM

Se hai specificato il repository yum di Weewx in /etc/yum.repos.d/weewx.repo , aggiorna all'ultima versione in questo modo:

sudo yum update weewx

Altrimenti, scarica l'ultimo pacchetto X.Y.Z RPM dalla pagina Download su weewx.com, quindi aggiorna in questo modo:

sudo rpm -U weewx-X.Y.Z-R.rpm

Il processo di aggiornamento non modificherà i database di Weewx.

I file non modificati verranno aggiornati. Se sono state apportate modifiche alla configurazione, rpm visualizzerà un messaggio su eventuali differenze tra le modifiche e la nuova configurazione. Eventuali nuove modifiche dall'aggiornamento verranno annotate come file con estensione .rpmnew e i file modificati rimarranno inalterati.

Ad esempio, se /etc/weewx/weewx.conf è stato modificato, rpm presenterà un messaggio simile a questo:

warning: /etc/weewx/weewx.conf created as /etc/weewx/weewx.conf.rpmnew
Aggiornamento del file di configurazione di Weewx

Non succede molto spesso, ma occasionalmente un nuovo rilascio richiede modifiche al file di configurazione di Weewx. Quando ciò accade, il programma di installazione, che sia setup.py o un programma di installazione di pacchetti, si occupa dell'aggiornamento del file e non devi preoccuparti di ciò.

Tuttavia, ci sono alcune occasioni in cui potrebbe essere necessario aggiornare il file da soli. In particolare, ciò accade quando si eseguono diverse istanze di weewxd sulla stessa macchina, ciascuna con il proprio file di configurazione. Il file di configurazione denominato weewx.conf verrà aggiornato, ma per quanto riguarda gli altri?

Usa wee_config per aggiornare ogni file di configurazione. Vedere la sezione su wee_config --upgrade nella Guida alle utilità per sapere come farlo.

Istruzioni per specifiche versioni

Consultare la guida originale per vedere le istruzioni aggiornate per ogni versione.

Autore: Tom Keffer