Aggiornamenti

Il pannello migliora nel tempo: ogni nuova versione porta funzioni nuove, miglioramenti e correzioni. Anche il sistema operativo del server (Ubuntu, AlmaLinux o Rocky Linux) riceve aggiornamenti, soprattutto di sicurezza. Gli amministratori li gestiscono entrambi dalla pagina Aggiornamenti.

Quale versione sto usando?

La versione è scritta in basso nel menu laterale (per esempio v0.7.0); dal telefono la trovi sotto Altro. Toccandola apri la pagina Novità.

La pagina Novità

In Novità trovi tutte le versioni, dalla più recente, con le modifiche spiegate in parole semplici e un'etichetta per ogni modifica:

• Nuovo: una funzione che prima non c'era;
• Migliorato: qualcosa che funziona meglio o è più comodo;
• Corretto: un problema risolto;
• Sicurezza: una protezione in più.

Quando arriva una versione che non hai ancora visto, accanto a Novità compare un pallino. Sparisce quando apri la pagina. Le novità sono mostrate nella tua lingua.

Aggiornare il pannello (amministratori)

La pagina Aggiornamenti mostra la versione installata, l'ultima disponibile con le sue novità, l'ora dell'ultimo controllo e lo storico degli aggiornamenti.

Quando c'è una versione più recente, ogni pagina degli amministratori mostra in alto un banner: «KoaPanel X.Y.Z è disponibile», con Novità (le versioni dalla tua, nella tua lingua) e Aggiorna ora. Puoi nasconderlo con la ×: ricompare con la versione successiva. Se tra le versioni che ti mancano ci sono correzioni di sicurezza o importanti, il banner dice Aggiornamento importante, usa i colori di avviso e, se lo nascondi, ricompare il giorno dopo. Gli amministratori ricevono anche un'email per ogni nuova versione (e il messaggio nelle chat collegate in Chiavi API › Webhook, se ci sono).

In Installa gli aggiornamenti automaticamente scegli:

• Solo avviso: il pannello controlla ogni 6 ore e avvisa gli amministratori (banner, email, chat); installi tu con Aggiorna ora. È la scelta dei pannelli installati prima della versione 0.40.11, finché non la cambi;
• Solo aggiornamenti importanti: il pannello installa da solo solo le versioni con correzioni di sicurezza o importanti, e per le altre ti avvisa. È la scelta delle nuove installazioni;
• Tutti gli aggiornamenti stabili: il pannello installa da solo ogni nuova versione stabile;
• Nessun controllo: nessun controllo automatico e nessun avviso; puoi sempre premere Verifica ora.

Con le due scelte automatiche imposti anche la fascia oraria (per esempio dalle 03:00 alle 05:00, ora del server) e i giorni (ogni giorno, oppure per esempio solo sabato e domenica; una fascia che passa la mezzanotte appartiene al giorno in cui inizia). L'aggiornamento automatico è prudente:

• prima di installare controlla lo spazio su disco e lo stato del pannello;
• non parte mai mentre sono in corso backup, migrazioni, spostamenti di account o altre operazioni: aspetta un momento successivo della fascia;
• se la nuova versione non riparte correttamente, il pannello torna da solo alla versione precedente;
• fa un solo tentativo per versione: se non riesce non riprova da solo, avvisa gli amministratori e decidi tu con Aggiorna ora.

Dopo ogni aggiornamento automatico gli amministratori ricevono un'email (e un messaggio nelle chat) con la versione e il risultato, e il Registro lo annota.

Gli aggiornamenti arrivano dal canale stabile della console KoaPanel (https://console.koapanel.app/updates/stable.json), già impostato: ogni versione è firmata e il pannello controlla la firma prima di installarla. Puoi indicare un altro canale solo se te lo comunichiamo noi.

Prima di aggiornare

Quando c'è una nuova versione la pagina mostra la versione installata e quella nuova, le novità (le prime quattro, con Mostra tutte per le altre), la durata stimata, quanti megabyte verranno scaricati e il pulsante Aggiorna ora, che chiede una conferma.

Cosa succede quando premi «Aggiorna ora»

1. Il pannello scarica la nuova versione e ne controlla firma digitale e impronta: se qualcosa non torna, l'aggiornamento viene rifiutato e non cambia nulla.
2. Salva una copia della versione attuale e installa quella nuova. Se ci sono operazioni in corso (backup, migrazioni, analisi antimalware) aspetta che finiscano; con Aggiorna senza aspettare le interrompe e si riavvia subito.
3. Si riavvia in pochi secondi. I siti, i database e i file non vengono toccati.
4. Se la nuova versione non risponde entro un minuto da quando la precedente si è fermata, il pannello torna da solo alla versione precedente e te lo segnala.

La schermata di avanzamento

Dopo la conferma si apre una schermata dedicata che mostra in tempo reale:

• la percentuale nel cerchio e la fase in corso (Controllo, Download, Verifica firma e integrità, Prova della nuova versione, Salvataggio della versione attuale, Installazione, Riavvio del pannello, Controllo di salute);
• cosa sta facendo in questo momento, per esempio «Scarico la versione 0.8.1 · 4,2 di 11,8 MB · 3,1 MB/s»;
• il tempo rimanente («circa 2 minuti», «meno di un minuto») e il tempo trascorso. La stima si basa sulla velocità misurata e sulla durata degli aggiornamenti precedenti del tuo server, quindi diventa più precisa con il tempo;
• l'elenco delle fasi, con la durata di quelle già completate.

Durante il riavvio il pannello per qualche secondo non risponde: la pagina mostra «Il pannello si sta riavviando…» con un contatore, si ricollega da sola appena il pannello torna disponibile e ti mostra l'esito. Non serve ricaricare né accedere di nuovo. Puoi anche chiudere la pagina: l'aggiornamento continua lo stesso.

Alla fine vedi «Aggiornato alla …» con il pulsante per scoprire le novità, oppure, se qualcosa non è andato, una spiegazione in parole semplici: se la nuova versione non ha superato il controllo finale, la pagina conferma che la versione precedente è di nuovo in funzione. Il riquadro Dettagli tecnici, chiuso all'inizio, contiene il registro completo da inoltrare all'assistenza.

Mentre un aggiornamento è in corso, nel menu laterale (dal telefono in alto) compare un piccolo indicatore con la percentuale: toccandolo riapri la schermata di avanzamento da qualsiasi pagina.

Gli amministratori ricevono un'email con l'esito e, subito dopo, quella con le novità della versione. Il pannello non installa mai una versione più vecchia di quella in uso; una versione non riuscita non viene ritentata in automatico.

Aggiornamenti del server

Nella seconda parte della pagina vedi:

• quanti aggiornamenti del sistema sono in attesa e quanti sono di sicurezza;
• se serve un riavvio del server (per esempio dopo un aggiornamento del kernel);
• quando è stato fatto l'ultimo controllo (il pannello controlla da solo due volte al giorno).

Dopo un controllo, il riquadro Aggiornamenti in attesa riassume quanti pacchetti ci sono, quanti di sicurezza, quanto c'è da scaricare e la durata stimata; avvisa se al termine servirà probabilmente un riavvio e quali servizi (per esempio nginx, PHP-FPM, MariaDB) verranno riavviati per un istante. Sotto trovi l'elenco dei pacchetti con la versione attuale e quella nuova, con una ricerca e un filtro per quelli di sicurezza.

I pulsanti:

• Aggiorna ora: dopo una conferma installa tutti gli aggiornamenti mantenendo i file di configurazione esistenti e apre la schermata di avanzamento. Le fasi sono: aggiornamento dell'elenco dei pacchetti, calcolo, download (con velocità) e installazione e configurazione, pulizia. L'elenco dei pacchetti si aggiorna mentre lavora (in attesa, scaricato, installato) con il conteggio «12 di 24». Alla fine la pagina ti dice se serve un riavvio e ti offre il pulsante per farlo;
• Verifica ora: aggiorna l'elenco dei pacchetti, con una piccola barra di avanzamento;
• Riavvia server: da usare quando la pagina indica «Riavvio richiesto». Per uno o due minuti siti e pannello non sono raggiungibili: scegli un momento con poche visite.

Aggiornamenti di sicurezza automatici

Con Aggiornamenti di sicurezza automatici attivo (consigliato, e attivo dopo l'installazione) il sistema installa ogni giorno, da solo, solo gli aggiornamenti di sicurezza (su Ubuntu con unattended-upgrades, su AlmaLinux e Rocky Linux con dnf-automatic). Puoi anche permettere il riavvio automatico quando serve, all'orario che scegli: di solito è disattivato, perché è meglio decidere tu quando riavviare.

Sorgenti dei pacchetti che non funzionano

Se una sorgente di terze parti aggiunta al server (un PPA o il repository di un fornitore) non esiste più, ha perso la chiave di firma o non risponde, il controllo va avanti con le altre sorgenti e il riquadro Sorgenti dei pacchetti che non funzionano indica l'indirizzo, il file in cui è configurata (/etc/apt/sources.list.d/…) e il motivo. Se non ti serve più premi Disattiva questa sorgente: la riga viene commentata (o la sorgente deb822 riceve Enabled: no) e il file resta, così puoi riattivarla. Le sorgenti di Ubuntu e del pannello non si disattivano: se sono loro a non rispondere il controllo non riesce e conviene riprovare più tardi.

Storico degli aggiornamenti

In fondo alla pagina lo Storico degli aggiornamenti elenca gli aggiornamenti del pannello e del server, dal più recente, con data, durata ed esito. Toccando una riga riapri la sua schermata di avanzamento con fasi e dettagli tecnici.