Résolution des problèmes de connexion MySQL à ownCloud 10

Lorsque ownCloud 10 affiche l'erreur « Échec de la connexion à la base de données », vérifiez d'abord si MySQL est inaccessible, s'il refuse le compte ou si un pilote PHP est manquant. Contrôlez le service de base de données ainsi que l'hôte, le nom de la base de données et le nom d'utilisateur exacts enregistrés dans les fichiers d'ownCloud config/config.php. Testez ensuite ces identifiants depuis le serveur ownCloud avant de modifier les autorisations ou de recréer quoi que ce soit. Ce guide concerne ownCloud Server 10.16 avec MySQL ou MariaDB. Les intitulés des menus et les commandes des paquets peuvent varier selon le système d'exploitation et la méthode d'installation.

Comprenez ce que le message d'erreur vous indique.

« Échec de la connexion à la base de données » est un message générique. L’erreur MySQL ou PHP plus spécifique, consignée dans les journaux d’ownCloud ou du serveur web, indique généralement la cause du problème. Une erreur de connexion telle que l’erreur MySQL 2002 ou 2003 signale généralement un service arrêté, un socket ou un port incorrect, un chemin réseau bloqué ou un serveur qui n’écoute pas à l’emplacement attendu par ownCloud. Un message « Accès refusé » signifie généralement que MySQL a bien reçu la connexion, mais n’a pas accepté le nom d’utilisateur, le mot de passe ou l’hôte client.

MySQL désigne le serveur de base de données ; MariaDB est une base de données compatible prise en charge par ownCloud. PDO MySQL est le pilote de base de données PHP qui permet à ownCloud de communiquer avec l'un ou l'autre. Action : notez le texte exact de l'erreur et son horodatage, puis comparez-les aux vérifications ci-dessous au lieu de considérer chaque échec de connexion comme un mot de passe incorrect.

Préparez-vous avant de modifier les paramètres

  • Vérifiez si ownCloud et MySQL s'exécutent sur la même machine, sur des machines différentes ou dans des conteneurs séparés.
  • Connaître le chemin d'installation d'ownCloud, l'hôte de la base de données, le port ou le socket, le nom de la base de données et le nom d'utilisateur dédié à la base de données.
  • Conservez une session d'administrateur ou un accès console. Sauvegardez vos données config/config.phpavant toute modification et ne communiquez jamais le mot de passe de la base de données dans une demande d'assistance.
  • N’exécutez les commandes en tant qu’administrateur que lorsque cela est nécessaire. Remplacez les noms et chemins d’accès d’exemple par les valeurs de votre installation.

Ne supprimez ni ne recréez la base de données lors d'une première étape de dépannage : les fichiers utilisateur et les métadonnées existants en dépendent. Action : effectuez une sauvegarde vérifiée du répertoire de données ownCloud et de la base de données avant toute modification de cette dernière.

Vérifiez le service de base de données et le chemin de connexion.

  1. Vérifiez que MySQL ou MariaDB est en cours d'exécution. Sur un hôte Linux utilisant systemd, examinez le service en utilisant le nom installé sur votre système :
sudo systemctl status mysql
sudo systemctl status mariadb

Il est possible qu'un nom de service soit absent de votre distribution. Si le service est arrêté, consultez son journal et le journal des erreurs de la base de données pour en déterminer la cause avant de le redémarrer. Action : résolvez les erreurs de démarrage, telles qu'un disque plein ou une configuration de base de données invalide, avant de tenter de résoudre les problèmes d'identifiants ownCloud.

  1. Vérifiez l'hôte et le port depuis la machine ownCloud. Testez la connectivité TCP avec l'hôte et le port de la base de données, généralement 3306. Pour une base de données distante, vérifiez la résolution de noms, les règles de pare-feu et assurez-vous que MySQL écoute sur une interface accessible depuis le serveur ownCloud. Ne laissez pas le port 3306 accessible sur Internet.
  2. Comprendre la différence avec le socket localhost. Sur les systèmes de type Unix, un client MySQL qui se connecte localhostutilise souvent un socket Unix local, 127.0.0.1imposant ainsi le protocole TCP. Cela a une incidence lorsque la base de données est locale mais que PHP et MySQL utilisent des chemins de socket différents. Action : comparez le chemin de socket et le paramètre d'hôte avec la configuration réelle du serveur de base de données, ou testez délibérément le protocole TCP si c'est le chemin attendu.

Testez la connexion au serveur ownCloud en utilisant le même nom d'utilisateur, le même hôte et le même nom de base de données que ceux utilisés par ownCloud :

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

Saisissez le mot de passe à l'invite ; ne l'insérez pas directement dans la commande, car il pourrait être enregistré dans l'historique du shell. Pour une connexion socket locale, testez plutôt l'hôte et le mode socket correspondant à votre configuration. Une connexion réussie prouve que MySQL accepte ce chemin de connexion et ce compte, mais ne prouve pas que PHP dispose de son pilote ni qu'ownCloud utilise les mêmes paramètres. Action : si cette commande échoue, utilisez l'erreur MySQL pour choisir la prochaine vérification.

Vérifiez les paramètres ownCloud, le pilote PHP et les privilèges.

L'assistant d'installation d'ownCloud enregistre le type de base de données, son nom, le nom d'utilisateur, le mot de passe, l'hôte et le préfixe des tables dans un fichier config/config.php. Vérifiez attentivement ces valeurs sans copier le mot de passe dans les journaux ou le chat. Ce fichier dbhostpeut inclure un hôte et un port ; si la mention « hôte » apparaît localhost, vérifiez que le socket attendu est bien accessible au processus PHP.

Si le client en ligne de commande fonctionne mais qu'ownCloud ne fonctionne toujours pas, vérifiez que l'environnement d'exécution PHP utilisé par le serveur web est pdo_mysqlinstallé et activé. Une commande shell, telle que ` php -mphp apt`, ne renvoie que les informations concernant l'environnement d'exécution PHP en ligne de commande, qui peut différer d'Apache ou de PHP-FPM. Action : examinez la configuration PHP active du serveur web et redémarrez le service web/PHP concerné après avoir activé l'extension.

En cas d'erreur « Accès refusé », vérifiez que MySQL possède un compte correspondant à la fois au nom d'utilisateur et à l'hôte client vus par la base de données. MySQL considère les comptes tels que « nom_utilisateur » 'oc_user'@'localhost'et «'oc_user'@'10.0.0.5' hôte_client » comme distincts. Si l'application ownCloud est exécutée dans un conteneur, la base de données peut voir une adresse de conteneur ou de pont plutôt que « nom_utilisateurlocalhost ». Action : demandez à l'administrateur de la base de données d'examiner le compte correspondant et les autorisations ; n'accordez l'accès que depuis l'hôte ou le réseau ownCloud qui en a besoin.

Vérifiez que la base de données existe et que le compte ownCloud peut y accéder. Évitez d'accorder des privilèges globaux ou d'utiliser le compte root MySQL dans ownCloud. Les permissions requises peuvent varier selon qu'il s'agit d'une installation initiale ou d'une instance existante. Action : suivez les instructions de configuration de la base de données d'ownCloud pour cette étape et ne modifiez ni la propriété ni les permissions des bases de données non concernées.

Appliquez une correction et vérifiez la correction.

Corrigez uniquement les paramètres identifiés par les tests : démarrez le service de base de données, utilisez un nom d’hôte et un port accessibles, corrigez une incompatibilité de socket, activez le pilote PHP, corrigez le mot de passe du compte ou ajustez les droits d’accès à la base de données spécifiques à l’hôte. Si vous effectuez des modifications config/config.php, veillez à conserver une syntaxe PHP valide et effectuez une sauvegarde au préalable. Ne modifiez pas le nom de la base de données, le préfixe des tables ni les identifiants sans les connaître.

Après la modification, rechargez ownCloud et vérifiez que la page se charge sans l'avertissement de connexion à la base de données. Consultez le journal ownCloud pour vérifier la réussite de la requête et assurez-vous que les utilisateurs peuvent parcourir les fichiers existants. Si MySQL signale « serveur indisponible » au lieu d'un refus de connexion, il s'agit d'un problème différent lié à une interruption de connexion, un délai d'attente dépassé ou une taille de paquet insuffisante ; la documentation ownCloud décrit les paramètres de délai d'attente et de taille de paquet MySQL pour ce cas. Action : suivez les instructions de dépannage de la base de données correspondante et ne modifiez les limites du serveur que si les journaux confirment ce diagnostic.

La documentation actuelle du serveur ownCloud 10.16 recommande l'assistant d'installation pour la configuration standard de la base de données et mentionne spécifiquement pdo_mysqlle chemin du socket MySQL comme point de contrôle. Les noms exacts des paquets, les versions de PHP et les noms des services dépendent de l'hôte. Action : terminez en répétant le test de connexion depuis le serveur ownCloud et en vérifiant que l'application peut lire ses données existantes.

Références officielles

Laisser un commentaire

Résolution des problèmes de connexion MySQL à ownCloud 10

Découvrez si MySQL, PHP, les paramètres de socket ou les autorisations de base de données bloquent ownCloud 10, puis vérifiez une solution sûre.

Définissez une date d'expiration précise pour les liens publics ownCloud

Définissez une date d'expiration précise pour les liens publics ownCloud

Rendez obligatoire l'expiration des liens publics dans ownCloud Classic, définissez une durée de vie maximale et vérifiez les partages existants qui pourraient nécessiter un nettoyage séparé.

Ajoutez l'authentification à deux facteurs TOTP à ownCloud Infinite Scale avec Keycloak

Ajoutez l'authentification à deux facteurs TOTP à ownCloud Infinite Scale avec Keycloak

Activez le protocole TOTP via Keycloak, inscrivez les utilisateurs en toute sécurité et comprenez quand les paramètres MFA au niveau du routage d'Infinite Scale s'appliquent.

Rétablissez la synchronisation ownCloud en associant le client à votre serveur.

Vérifiez si le problème provient d'une incompatibilité entre OC10 et 7.x ou d'un journal CSync endommagé, puis appliquez le correctif approprié sans supprimer les fichiers synchronisés.

Sécurisez ownCloud avec HTTPS grâce à Let's Encrypt et Nginx.

Sécurisez ownCloud avec HTTPS grâce à Let's Encrypt et Nginx.

Choisissez HTTP-01 ou DNS-01, configurez un proxy inverse ownCloud et vérifiez que Certbot renouvelle automatiquement les certificats HTTPS.

Connectez ownCloud Infinite Scale à LDAP pour l'authentification des utilisateurs

Configurez la connexion LDAP oCIS, alignez les recherches d'utilisateurs et de groupes et vérifiez les paramètres TLS et de schéma avant le déploiement.

Connectez un compartiment S3 à ownCloud 10 en tant que stockage externe.

Connectez un compartiment S3 à ownCloud 10 en tant que stockage externe.

Ajoutez un compartiment Amazon S3 à ownCloud 10, préparez les identifiants et les points de terminaison compatibles, et vérifiez l'accès sans confondre un montage avec le stockage principal.

Automatisez les sauvegardes de votre base de données ownCloud grâce à une tâche cron nocturne sécurisée.

Automatisez les sauvegardes de votre base de données ownCloud grâce à une tâche cron nocturne sécurisée.

Planifiez des sauvegardes MariaDB protégées pour ownCloud Server, gérez le mode maintenance en toute sécurité et vérifiez chaque sauvegarde avant de vous y fier.

Migrez ownCloud Classic vers oCIS grâce à une migration prise en charge.

Planifiez une migration d'ownCloud 10 vers oCIS avec l'application prise en charge, les commandes ordonnées, les contrôles d'identité et une liste claire des données qui nécessitent un traitement séparé.

OwnCloud Classic 10 avec un thème et du CSS

Remplacez les logos ownCloud Classic 10 et personnalisez les couleurs de l'interface utilisateur Web grâce à une application de thème, tout en évitant les pièges liés à la mise à niveau et à la vérification d'intégrité.