Hai completato un aggiornamento di Nextcloud, ma tutti continuano a visualizzare la pagina di manutenzione. Oppure un aggiornamento è stato interrotto e il sito non è più tornato online. Il comando OCC per disabilitare la modalità di manutenzione è breve, ma eseguirlo prima di verificare lo stato dell'aggiornamento può rivelare un'installazione incompleta. Inizia verificando quale istanza di Nextcloud stai amministrando e se è ancora necessario un aggiornamento del database.
Esempio illustrativo: Immaginate un piccolo ufficio che utilizza Nextcloud su Ubuntu. Un aggiornamento programmato è stato interrotto dopo il deployment di nuovi file di codice e la pagina web continua a indicare che il server è in modalità di manutenzione. Questo esempio è ipotetico; serve a illustrare i controlli descritti di seguito, non a descrivere un incidente o un test reale.
La modalità di manutenzione di Nextcloud blocca il normale accesso degli utenti mentre un amministratore esegue operazioni come un aggiornamento o un backup. Si tratta di uno stato che interessa l'intero server, pertanto gli utenti potrebbero visualizzare un avviso di manutenzione anche quando il server web è in esecuzione. Il manuale di amministrazione di Nextcloud descrive il comando OCC per abilitare o disabilitare questa modalità e precisa che potrebbe essere necessario aggiornare il browser dopo la sua disattivazione.
Nell'esempio di ufficio, la sola pagina di manutenzione non indica all'amministratore se l'aggiornamento è terminato. È necessario interrogare direttamente Nextcloud prima di modificare la modalità.
Gli esempi di comando qui riportati si riferiscono a un'installazione convenzionale di Nextcloud basata su archivio su Ubuntu, con il codice in /var/www/nextcloude l'account del server web denominato www-data. Nextcloud documenta che occsi trova nella directory di installazione e deve essere eseguito come utente HTTP; su Debian e Ubuntu tale utente è normalmente www-data.
Per questa configurazione standard, accedere alla directory di installazione:
cd /var/www/nextcloudSe i file di Nextcloud si trovano in un'altra posizione, utilizzare il percorso effettivo. Snap, Docker, appliance e hosting gestito utilizzano wrapper di comando o strutture di filesystem differenti. Non eseguire il comando host su un'installazione containerizzata e non presumere che il percorso dell'archivio sia valido per tali implementazioni. Seguire le istruzioni di aggiornamento specifiche per il metodo di installazione utilizzato, come descritto nella guida ufficiale all'aggiornamento di Nextcloud .
Nell'esempio relativo all'ufficio, l'amministratore controlla le note di distribuzione e conferma che si tratta di un'installazione da archivio prima di eseguire OCC.
Eseguire OCC con l'account del server web in modo che i file e la configurazione mantengano i proprietari previsti:
sudo -E -u www-data php occ statusOsserva i campi maintenancee needsDbUpgrade. Le versioni attuali supportano anche un codice di uscita di stato:
sudo -E -u www-data php occ status -e
echo $?I codici di uscita documentati sono utili quando l'output viene controllato da uno script: 0indica il normale funzionamento, 1significa che la modalità di manutenzione è abilitata e 2significa occ upgradeche è richiesto. Anche l'output di stato semplice dovrebbe essere esaminato; non utilizzare il solo codice di uscita per decidere se riaprire il sito.
Per il server dell'ufficio ipotetico, se needsDbUpgradeè vero o status -erestituisce 2, il passo successivo corretto è completare l'aggiornamento, non semplicemente disattivare la modalità di manutenzione.
Se è stato intenzionalmente distribuito un aggiornamento del codice di Nextcloud e OCC segnala la necessità di aggiornare il database, prima di procedere, eseguire o verificare un backup aggiornato del database, della configurazione e dei dati. Quindi eseguire il comando documentato dalla directory di installazione:
sudo -E -u www-data php occ upgradeLeggi l'output del comando e attendi che termini. Non interromperlo perché la pagina web appare invariata durante l'esecuzione delle migrazioni. L'aggiornamento integrato potrebbe lasciare la modalità di manutenzione attiva in caso di occ upgradeerrore durante la sostituzione del codice. Se l'aggiornamento non ha completato la sostituzione del codice, consulta il relativo registro e riprendi il processo di aggiornamento appropriato per la tua installazione, anziché passare direttamente a . Le istruzioni dell'aggiornamento integratomaintenance:mode --off di Nextcloud spiegano le fasi di aggiornamento e identificano il registro dell'aggiornamento come risorsa diagnostica.
Nell'esempio, l'amministratore dell'ufficio eseguirà il comando solo occ upgradese lo stato indica che la migrazione del database è ancora in sospeso e che il nuovo codice previsto è presente. Se il comando segnala un errore, il server rimane non disponibile e si procede prima all'analisi dell'errore.
Una volta completato l'aggiornamento e quando lo stato non indica più la necessità di un aggiornamento del database, disabilita la modalità di manutenzione utilizzando il comando integrato di Nextcloud:
sudo -E -u www-data php occ maintenance:mode --offUn comando eseguito correttamente segnala che la modalità di manutenzione è stata disabilitata. Questo è il metodo supportato per modificare la modalità in un'installazione standard; inoltre, mantiene la modifica dello stato all'interno dell'interfaccia di comando di Nextcloud anziché basarsi su modifiche manuali config.php.
L'amministratore di sistema esegue questo comando solo al termine della migrazione. Se non era in corso alcun aggiornamento e lo stato indicava che l'installazione era pronta, lo stesso comando può rimuovere un flag di manutenzione rimasto attivo dopo la manutenzione pianificata.
Verifica nuovamente lo stato:
sudo -E -u www-data php occ status
sudo -E -u www-data php occ status -ePer un'installazione completa, aspettati maintenance: false, needsDbUpgrade: false, e un normale codice di uscita di 0. Quindi apri il sito da una nuova finestra del browser in modalità privata e accedi con un account amministratore. Chiedi a un utente normale di aggiornare il browser prima di presumere che la sua sessione sia ancora bloccata.
Nello scenario illustrativo, il successo si verifica quando sia lo stato dell'OCC che la pagina web concordano sul fatto che l'istanza è di nuovo online. L'esempio ipotetico non presuppone che sia stato effettivamente eseguito alcun comando o che un server reale sia stato riparato.
Verifica di aver eseguito OCC sulla stessa installazione che gestisce l'URL. Questo è importante in caso di implementazione con bilanciamento del carico, host Docker con più container o server con directory Nextcloud vecchie e nuove affiancate. Controlla il percorso effettivo della directory principale o del container ed esegui una query sull'istanza associata all'URL interessato. Se ogni nodo web ha una propria configurazione, verifica che tutti i nodi condividano la configurazione e il database previsti.
Se l'istanza corretta segnala che la manutenzione è disabilitata, confronta la pagina proveniente dal server di origine con l'URL pubblico. Un proxy inverso o una cache potrebbero fornire una risposta obsoleta. Cancella o ignora tale cache solo dopo aver verificato quale livello ha restituito la pagina di manutenzione.
Verifica che il comando utilizzi la versione di PHP CLI e le estensioni necessarie compatibili con l'installazione web. Nextcloud segnala che APCu è disabilitato per impostazione predefinita per PHP CLI e può causare errori OCC quando APCu è configurato come cache locale. Il manuale documenta come abilitarlo apc.enable_clinella configurazione di PHP CLI o aggiungerlo --define apc.enable_cli=1al comando PHP quando necessario.
sudo -E -u www-data php --define apc.enable_cli=1 occ statusUtilizzare questa soluzione solo se l'errore indica un problema con la CLI di APCu; non è una soluzione generica per tutti gli errori PHP. Verificare inoltre che il comando venga eseguito con l'utente web corretto e dalla directory di installazione corretta.
Non forzare la disattivazione del flag di manutenzione per nascondere questo stato. Ricontrolla l'output e i log dell'aggiornamento, verifica che sia installata la versione corretta del codice Nextcloud e completa la procedura di aggiornamento supportata per il tuo tipo di installazione. Consulta i documenti di riferimento ufficiali del sistema OCC e dei comandi di manutenzionemaintenance:mode , statuse l'aggiornamento da riga di comando.
Disabilitando la modalità di manutenzione, gli utenti possono nuovamente accedere all'istanza; pertanto, prima di procedere, verificare che l'aggiornamento del database e l'eventuale sostituzione del codice siano stati completati. Evitare di eliminare manualmente i file di aggiornamento o di modificare l'impostazione di manutenzione nel file di configurazione come prima soluzione; in questo modo, si rischia di mascherare il problema senza completare l'operazione che ha attivato la modalità.
Per l'ipotetico ufficio, la decisione più sicura è semplice: verificare la corretta installazione, controllare lo stato, completare eventuali aggiornamenti necessari, quindi eseguire maintenance:mode --offe verificare sia OCC che il browser. Se l'aggiornamento non può essere completato correttamente, lasciare attiva la modalità di manutenzione e risolvere i problemi consultando il registro di aggiornamento o la procedura di ripristino specifica dell'installazione.
Confronta sei server e collettori syslog gratuiti per Windows e Linux, inclusi strumenti con interfaccia grafica, opzioni open source, funzionalità di ricerca, avvisi e trasporto sicuro.
Scopri cosa fa Microsoft IIS, come funzionano la sua pipeline di richieste e i pool di applicazioni e quando Apache, NGINX o Caddy potrebbero essere più adatti alle tue esigenze di server web.
Diagnostica i picchi di utilizzo della CPU del browser Jitsi Meet e riduci il carico del client controllando i riquadri video, gli effetti della fotocamera, la grafica del browser e le impostazioni dell'host.
Monitora lo stato di salute, il carico della conferenza e il traffico di Jitsi Videobridge con il suo endpoint Prometheus integrato, quindi esplora e visualizza i dati in Grafana.
Configura un dominio personalizzato per Jitsi Meet Docker con DNS, URL pubblico, HTTPS, Let's Encrypt, porte del firewall, impostazioni NAT e verifica end-to-end.
Fix Zimbra Admin Console 404 errors after SSL renewal by checking the correct URL and port, proxy routing, service status, deployed certificates, and logs.
Scopri come diagnosticare e risolvere l'avviso di configurazione di PHP OPcache di Nextcloud controllando l'SAPI PHP attivo, i limiti di dimensionamento, i commenti e le impostazioni di riconvalida.
Risolvere i problemi di migrazione del database Kopano dopo un aggiornamento di MySQL o MariaDB verificando i backup, le versioni del server, le modalità SQL, il set di caratteri, lo stato dello schema e i log.
Collega Nextcloud a LDAP o Active Directory con trasporto sicuro, filtri per utenti e gruppi, attributi di accesso e un'implementazione collaudata.
Risolvi i problemi di notifiche di Element Android sui telefoni senza Google configurando UnifiedPush, le autorizzazioni Android, le impostazioni della batteria ed eseguendo test di verifica affidabili.
