Aggiornamenti e versioni

Novità

La pagina Novità elenca tutte le versioni con la data e cosa cambia, per te e per i clienti. Lo stesso elenco è su koavm.com/novita. I numeri seguono la regola x.y.z: cambia la z per le correzioni e le aggiunte piccole, la y per le funzioni nuove, la x per i cambiamenti grandi. Dalla 1.0 l'API v1, i moduli per WHMCS e KoaBilling e i comandi koavm restano compatibili in tutte le 1.x: quello che non è compatibile arriva solo con una 2.0, annunciato prima.

Aggiornare dal pannello

Ogni 6 ore il pannello controlla se c'è una versione nuova sul canale stabile (https://koavm.com/releases/stable.json). Quando c'è, in Novità trovi la versione, le novità e il pulsante Aggiorna ora. Premuto:

1. il pannello scarica la versione e ne controlla la firma (solo le versioni firmate da Prime Software vengono accettate) e lo SHA-256;
2. il servizio di sistema koavm-update rifà gli stessi controlli, fa una copia del database (/var/lib/koavm/koavm-prima-VERSIONE.db) e sostituisce il binario tenendo il precedente;
3. il pannello si riavvia (qualche secondo senza interfaccia; le VPS continuano a funzionare);
4. se la versione nuova non parte entro 90 secondi, torna da sola quella di prima.

La pagina si ricarica da sola alla fine. Torna alla versione precedente rimette la versione di prima (il database resta quello di adesso; la copia fatta prima dell'aggiornamento resta nella cartella dei dati).

Il controllo automatico si può spegnere nella stessa pagina.

Da riga di comando

sudo koavm update --check      # dice se c'è una versione nuova e cosa cambia
sudo koavm update              # aggiorna (stessi controlli e stessa copia del database)
sudo koavm update --rollback   # torna alla versione precedente

Copia del pannello e ripristino

Se il server del pannello si perde (disco rotto, server cancellato), con lui si perdono clienti, VPS, piani, IP, il certificato che i nodi riconoscono, la chiave SSH del pannello e le chiavi degli archivi dei backup incrementali. Le VPS continuano a girare sui nodi, ma senza pannello non si gestiscono. Per questo il pannello fa una copia di sé ogni notte.

In Backup › Copia del pannello:

1. Crea la chiave di ripristino. La vedi una volta sola: scaricala o copiala e conservala fuori dal server del pannello (gestore delle password, chiavetta, cassaforte). Il pannello tiene solo la parte pubblica: chi entra nella destinazione, o anche nel pannello, non legge le copie.
2. Scegli la destinazione (una delle destinazioni dei backup, non sullo stesso server del pannello) e quante copie tenere (14 di base).
3. Da lì in poi la copia parte ogni notte all'ora dei backup; Fai una copia adesso la fa subito. Se una copia non riesce arriva un avviso.

La copia contiene il database (senza lo storico dei grafici e le sessioni), il certificato e la chiave per i nodi, la chiave SSH del pannello, la chiave dei segreti della verifica in due passaggi (totp.key), i certificati HTTPS e le configurazioni delle VM migrate. È un file koavm-DATA-VERSIONE.tar.gz.age nella cartella koavm-pannello/copie/ della destinazione, cifrato con age: con la chiave si apre anche senza KoaVM (age -d -i chiave.txt copia.tar.gz.age | tar -xz).

Ripristinare su un server nuovo

1. Installa KoaVM sul server nuovo con lo stesso nome del pannello (vedi Installazione) e fai puntare il nome al server nuovo.
2. Copia sul server la copia del pannello (dalla pagina, finché il pannello vecchio c'è, o direttamente dalla destinazione) e il file della chiave.
3. Ripristina:

sudo systemctl stop koavm
sudo koavm panel-restore --file koavm-…tar.gz.age --key chiave.txt --force
sudo systemctl start koavm

Con --force i file del pannello appena installato vanno in /var/lib/koavm/prima-del-ripristino-…. Una copia di una versione più nuova del KoaVM installato non si ripristina: aggiorna prima. Si entra con gli account di prima.

I nodi riconoscono il pannello ripristinato (stesso certificato). La licenza invece risulta «usata da un altro pannello», perché il server è un altro: chiedi lo sblocco a chi te l'ha venduta (Prime Software o il tuo rivenditore), oppure si libera da sola dopo 15 giorni. Nel frattempo le VPS restano accese e valgono i limiti della prova per i nodi e le VPS nuovi.

Se il pannello è stato installato prima della 0.7.2

Il servizio koavm-update lo installa install.sh. Aggiorna una volta con lo script (vedi Installazione) o con sudo koavm update: da lì in poi gli aggiornamenti si fanno dal pannello.