Come appare il messaggio
Nextcloud or one of the apps require upgrade - only a limited number of operations are allowed
Updates between multiple major versions and downgrades are unsupported.
Update failedCause frequenti
- Hai provato a saltare una release major, ad esempio dalla versione N direttamente a N+2.
- Il codice è più vecchio dei dati: è stato ripristinato un backup dei file o un vecchio tag Docker, ma database e
config.phpappartengono a una versione più recente. - È attiva la cartella di codice sbagliata, ad esempio un symlink o il web root punta ancora a una vecchia copia dopo un aggiornamento.
- Un aggiornamento è stato interrotto a metà, quindi codice e database ora non coincidono.
Verifica
- Versione del codice su disco
grep OC_VersionString /var/www/nextcloud/version.php - Versione registrata da Nextcloud
grep "'version'" /var/www/nextcloud/config/config.php - Cosa dice la riga di comando?
- Dove punta il web root?
readlink -f /var/www/nextcloud
Soluzione
- Confronta le due versioni. Se il codice è più vecchio di quella registrata, rimetti il codice più recente corrispondente, oppure ripristina un backup del database fatto insieme a questo codice.
- Se hai saltato una major, installa prima l'ultima release della major successiva, esegui
sudo -u www-data php occ upgradee ripeti una major alla volta fino al traguardo. - Prima di ogni passo fai il backup di codice,
config.php, dati e database, e disattiva conocc app:disablele app che non supportano la versione successiva. - Non modificare
'version'inconfig.phpper superare il controllo. Può corrompere lo schema del database. - Dopo l'ultimo passo esci dalla modalità manutenzione con
occ maintenance:mode --offe controlla la panoramica admin.
Scenario tipico
Un setup Docker usa image: nextcloud:latest. Dopo mesi di inattività, docker compose pull avanza di due versioni maggiori in un colpo e il container si ferma all'avvio con Updates between multiple major versions and downgrades are unsupported. I dati sono intatti, solo il codice è troppo nuovo rispetto allo stato in config.php. Prima verifica: quale versione c'è in config.php e quale fornisce l'immagine?
Domande frequenti
Posso fare il downgrade di Nextcloud?
Non sostituendo il codice. Il downgrade è sicuro solo ripristinando un backup completo (codice, configurazione e database) dello stesso momento.
Come so quali major devo installare?
Leggi le note di rilascio e il percorso di aggiornamento della documentazione ufficiale per la tua versione di partenza, poi passa per ogni major in ordine, sempre con l'ultima release minor.
Perché non usare latest in Docker?
Con latest è il momento del pull a decidere la versione e possono accumularsi più versioni maggiori. Usa un tag fisso come nextcloud:28 e alzalo consapevolmente di una versione maggiore alla volta, con l'aggiornamento completato nel mezzo.
Posso saltare le versioni patch e minor?
All'interno della stessa versione maggiore sì, puoi passare direttamente all'ultima release di quella linea. È vietato solo saltare intere versioni maggiori. Da 26 a 28 si passa quindi dall'ultima release 27. Prima di ogni salto leggi le note di rilascio, perché alcune versioni maggiori richiedono una versione minima di PHP.
Che fare se l'immagine troppo nuova è già partita?
Fermala e usa l'immagine corrispondente alla versione in config.php, oppure la maggiore successiva. Il downgrade non è previsto. Se il database è già stato migrato in parte, serve ripristinare un backup di database e configurazione.