Risoluzione dei problemi di connessione MySQL di ownCloud 10

Quando ownCloud 10 segnala "Impossibile connettersi al database", innanzitutto verifica se MySQL non è raggiungibile, rifiuta l'account o se manca un driver PHP. Controlla il servizio di database e l'host, il nome del database e il nome utente esatti salvati in ownCloud config/config.php; quindi, verifica queste credenziali dal server ownCloud prima di modificare le autorizzazioni o ricreare qualsiasi cosa. Questa guida è pensata per ownCloud Server 10.16 con MySQL o MariaDB. Le etichette dei menu e i comandi dei pacchetti possono variare a seconda del sistema operativo e del metodo di installazione.

Comprendi cosa ti sta dicendo l'errore

"Connessione al database non riuscita" è un messaggio generico. L'errore più specifico di MySQL o PHP nel log di ownCloud o nel log del server web di solito indica la causa. Un errore di connessione come l'errore MySQL 2002 o 2003 indica generalmente un servizio arrestato, un socket o una porta errati, un percorso di rete bloccato o un server che non è in ascolto nella posizione prevista da ownCloud. Un messaggio di "Accesso negato" in genere significa che MySQL ha ricevuto la connessione ma non ha accettato il nome utente, la password o l'host client.

MySQL si riferisce al server di database; MariaDB è un'opzione di database compatibile supportata da ownCloud. PDO MySQL è il driver di database PHP che consente a ownCloud di comunicare con entrambi. Azione: annota il testo esatto dell'errore e il timestamp, quindi confrontalo con i controlli seguenti anziché considerare ogni errore di connessione come una password errata.

Prepararsi prima di modificare le impostazioni

  • Verifica se ownCloud e MySQL sono in esecuzione sulla stessa macchina, su macchine diverse o in container separati.
  • È necessario conoscere il percorso di installazione di ownCloud, l'host del database, la porta o il socket, il nome del database e il nome utente dedicato al database.
  • Assicurati di avere sempre a disposizione una sessione amministrativa o l'accesso alla console. Esegui un backup config/config.phpprima di modificarlo e non pubblicare mai la password del database in una richiesta di supporto.
  • Eseguire i comandi come amministratore solo quando necessario. Sostituire i nomi e i percorsi di esempio con i valori della propria installazione.

Non eliminare o ricreare il database come primo passaggio per la risoluzione dei problemi: i file utente e i metadati esistenti dipendono da esso. Azione: eseguire un backup verificato sia della directory dei dati di ownCloud che del database prima di apportare qualsiasi modifica a livello di database.

Verificare il servizio del database e il percorso di connessione.

  1. Verifica che MySQL o MariaDB siano in esecuzione. Su un host Linux con systemd, controlla il servizio utilizzando il nome con cui è installato sul tuo sistema:
sudo systemctl status mysql
sudo systemctl status mariadb

Potrebbe non esistere un nome di servizio nella tua distribuzione. Se il servizio è arrestato, controlla il suo registro e il registro degli errori del database per individuarne la causa prima di riavviarlo. Azione: risolvi gli errori di avvio, come un disco pieno o una configurazione del database non valida, prima di risolvere i problemi relativi alle credenziali di ownCloud.

  1. Verifica l'host e la porta dalla macchina ownCloud. Testa la connettività TCP all'host e alla porta del database, solitamente la 3306. Per un database remoto, verifica la risoluzione dei nomi, le regole del firewall e che MySQL sia in ascolto su un'interfaccia raggiungibile dal server ownCloud. Non esporre la porta 3306 a Internet.
  2. Comprendere la differenza tra i socket localhost. Sui sistemi Unix-like, un client MySQL che si connette localhostspesso utilizza un socket Unix locale, 127.0.0.1forzando l'uso di TCP. Questo è importante quando il database è locale ma PHP e MySQL utilizzano percorsi socket diversi. Azione: confrontare il percorso socket e l'impostazione host con la configurazione effettiva del server di database, oppure testare deliberatamente TCP se questo è il percorso previsto.

Prova ad accedere dal server ownCloud utilizzando lo stesso nome utente, host e nome del database utilizzati da ownCloud:

mysql --protocol=TCP -h db.example.net -P 3306 -u oc_user -p owncloud

Inserisci la password quando richiesto; non inserirla direttamente nel comando, dove potrebbe essere salvata nella cronologia della shell. Per una connessione tramite socket locale, verifica invece l'host e la modalità socket che corrispondono alla tua configurazione. Un accesso riuscito dimostra che MySQL accetta quel percorso di connessione e quell'account, ma non dimostra che PHP abbia il suo driver o che ownCloud stia leggendo le stesse impostazioni. Azione: se questo comando fallisce, usa l'errore di MySQL per scegliere il controllo successivo.

Verifica le impostazioni di ownCloud, il driver PHP e i privilegi.

La procedura guidata di installazione di ownCloud scrive il tipo di database, il nome del database, il nome utente, la password, l'host e il prefisso della tabella in config/config.php. Esamina attentamente i valori senza copiare la password nei log o nella chat. Il file dbhostpuò includere un host e una porta; se indica localhost, verifica se il socket previsto è disponibile per il processo PHP.

Se il client da riga di comando funziona correttamente ma ownCloud continua a non funzionare, verificare che il runtime PHP utilizzato dal server web sia pdo_mysqlinstallato e abilitato. Un comando shell come questo php -mriporta solo il runtime PHP CLI, che potrebbe essere diverso da Apache o PHP-FPM. Azione: esaminare la configurazione PHP web attiva e riavviare il servizio web/PHP pertinente dopo aver abilitato l'estensione.

Per "Accesso negato", verificare che MySQL disponga di un account corrispondente sia al nome utente che all'host client visualizzato dal database. MySQL considera account come 'oc_user'@'localhost'e 'oc_user'@'10.0.0.5'come distinti. Se l'app ownCloud si trova in un container, il database potrebbe visualizzare un indirizzo del container o del bridge anziché localhost. Azione: chiedere all'amministratore del database di esaminare l'account corrispondente e le autorizzazioni; concedere l'accesso solo dall'host o dalla rete ownCloud che ne ha bisogno.

Verifica che il database esista e che l'account ownCloud abbia i permessi per accedervi. Evita di concedere privilegi globali o di utilizzare l'account root di MySQL in ownCloud. I permessi richiesti possono variare a seconda che si tratti di un'installazione iniziale o di un'istanza esistente. Azione: segui le istruzioni di ownCloud per la configurazione del database relative alla fase specifica e non modificare la proprietà o i permessi di accesso su database non correlati.

Applica una correzione e verifica la correzione

Correggi solo le impostazioni identificate dai test: avvia il servizio di database, utilizza il nome host e la porta raggiungibili, correggi un'eventuale incompatibilità del socket, abilita il driver PHP, correggi la password dell'account o modifica un'autorizzazione di accesso al database specifica dell'host. Se modifichi il file config/config.php, mantieni la sintassi PHP valida ed esegui prima un backup. Non modificare il nome del database, il prefisso della tabella o le credenziali a caso.

Dopo la modifica, ricarica ownCloud e verifica che la pagina si carichi senza l'avviso di connessione al database. Controlla il log di ownCloud per verificare che la richiesta sia andata a buon fine e assicurati che gli utenti possano visualizzare i file esistenti. Se MySQL segnala "server non disponibile" anziché un rifiuto della connessione, si tratta di un problema diverso che riguarda una connessione interrotta o scaduta o le dimensioni dei pacchetti; ownCloud documenta le impostazioni di timeout e dimensioni dei pacchetti di MySQL per questo caso. Azione: utilizza la guida alla risoluzione dei problemi del database corrispondente e modifica i limiti del server solo se i log confermano tale diagnosi.

La documentazione attuale di ownCloud Server 10.16 raccomanda la procedura guidata di installazione per la configurazione standard del database e specifica pdo_mysqlche il percorso del socket MySQL deve essere verificato. I nomi esatti dei pacchetti, le versioni di PHP e i nomi dei servizi dipendono dall'host. Azione: terminare ripetendo il test di connessione dal server ownCloud e verificando che l'applicazione sia in grado di leggere i dati esistenti.

Riferimenti ufficiali

Lascia un commento

Risoluzione dei problemi di connessione MySQL di ownCloud 10

Scopri se MySQL, PHP, le impostazioni dei socket o i permessi del database stanno bloccando ownCloud 10, quindi verifica una soluzione sicura.

Imposta un limite di scadenza preciso per i link pubblici di ownCloud.

Imposta un limite di scadenza preciso per i link pubblici di ownCloud.

Rendi obbligatoria la scadenza dei link pubblici in ownCloud Classic, imposta una durata massima e verifica le condivisioni esistenti che potrebbero richiedere una pulizia separata.

Aggiungi l'autenticazione a due fattori TOTP a ownCloud Infinite Scale con Keycloak

Aggiungi l'autenticazione a due fattori TOTP a ownCloud Infinite Scale con Keycloak

Abilita TOTP tramite Keycloak, registra gli utenti in modo sicuro e scopri quando si applicano le impostazioni MFA a livello di percorso di Infinite Scale.

Ripristina la sincronizzazione di ownCloud abbinando il client al tuo server

Verifica se il problema è dovuto a un'incompatibilità tra OC10 e 7.x o a un journal CSync danneggiato, quindi applica la soluzione corretta senza eliminare i file sincronizzati.

Metti ownCloud su HTTPS con Let's Encrypt e Nginx

Metti ownCloud su HTTPS con Let's Encrypt e Nginx

Scegli HTTP-01 o DNS-01, configura un proxy inverso ownCloud e verifica che Certbot rinnovi automaticamente i certificati HTTPS.

Collega ownCloud Infinite Scale a LDAP per l'accesso degli utenti.

Configura l'accesso LDAP di oCIS, allinea le ricerche di utenti e gruppi e verifica le impostazioni TLS e dello schema prima del rilascio.

Collega un bucket S3 a ownCloud 10 come spazio di archiviazione esterno.

Collega un bucket S3 a ownCloud 10 come spazio di archiviazione esterno.

Aggiungi un bucket Amazon S3 a ownCloud 10, prepara credenziali ed endpoint compatibili e verifica l'accesso senza confondere un punto di montaggio con lo storage primario.

Automatizza i dump del database di ownCloud con un'attività Cron notturna sicura.

Automatizza i dump del database di ownCloud con un'attività Cron notturna sicura.

Pianifica i dump protetti di MariaDB per ownCloud Server, gestisci la modalità di manutenzione in modo sicuro e verifica ogni backup prima di utilizzarlo.

Passare da ownCloud Classic a oCIS con una migrazione supportata

Pianifica una migrazione da ownCloud 10 a oCIS utilizzando l'app supportata, i comandi ordinati, i controlli di identità e un elenco chiaro dei dati che richiedono una gestione separata.

Brand ownCloud Classic 10 con un'app tema e CSS

Sostituisci i loghi di ownCloud Classic 10 e personalizza i colori dell'interfaccia web con un'app per temi, evitando al contempo problemi di aggiornamento e di verifica dell'integrità.