Évitez les délais d'expiration de verrouillage de fichiers ownCloud grâce au bon backend

Lorsqu'ownCloud signale un délai d'expiration de verrouillage de fichier, ne supprimez pas immédiatement les lignes de verrouillage de la base de données et ne désactivez pas le verrouillage. Déterminez d'abord si le message fait référence à un verrouillage transactionnel lors d'une opération sur un fichier ou à un verrou WebDAV créé par l'utilisateur avec une date d'expiration. En cas de délais d'expiration récurrents liés aux verrouillages transactionnels, le déplacement du cache de verrouillage de la base de données vers Redis est généralement la solution la plus pratique pour les serveurs à forte charge ; pour les installations à faible trafic, il est possible de conserver la base de données si celle-ci fonctionne correctement.

Identifiez le verrou qui expire.

Le verrouillage transactionnel des fichiers les protège pendant le traitement des chargements, synchronisations, déplacements et autres modifications par ownCloud. Activé par défaut, il stocke les verrous dans la base de données, sauf si un cache de verrouillage est configuré. Une base de données lente ou surchargée peut donc entraîner des retards dans les opérations sur les fichiers. La documentation d'ownCloud Server 10.16 recommande l'utilisation de Redis pour le verrouillage transactionnel externe afin de réduire la charge sur la base de données.

Le verrouillage manuel de fichiers est différent : un utilisateur verrouille volontairement un fichier pour empêcher d’autres utilisateurs de le modifier, tandis que la fonctionnalité de verrouillage WebDAV applique une durée d’expiration. Dans ownCloud Server 10.16, un administrateur peut définir les délais d’expiration par défaut et maximum, ainsi que des groupes de déverrouillage. Action : avant d’appliquer une solution, utilisez le message du journal, les fichiers concernés et la présence ou non d’un indicateur de verrouillage pour identifier le mécanisme.

Un message tel que « Délai d'attente de verrouillage dépassé » pour MySQL peut indiquer qu'une transaction de base de données est en attente d'une autre transaction, et non qu'un verrou utilisateur a expiré. De même, « Redis a disparu » signale un problème de connexion à Redis, et non un fichier obsolète. Action : examinez les journaux ownCloud et de la base de données/Redis au même horodatage ; ne considérez pas toutes les erreurs de verrouillage comme un seul et même problème.

Choisissez le backend adapté au serveur

SituationChoix pratiqueCompromis
Serveur domestique privé à faible traficMaintenez le verrouillage de la base de données pendant l'analyse de son état.Moins de services à gérer, mais l'activité de verrouillage augmente la charge de travail de la base de données.
Serveur unique occupéConfigurez Redis pour le verrouillage ; utilisez APCu pour le cache local si disponible.Cela réduit la charge de verrouillage sur la base de données, mais Redis et son extension PHP doivent rester disponibles.
Plusieurs serveurs d'applicationsUtilisez un point de terminaison Redis partagé accessible par chaque nœud web.Prend en charge un cache de verrouillage commun ; l’accès réseau, l’authentification et la disponibilité de Redis deviennent des dépendances opérationnelles.

La documentation ownCloud indique que Memcached ne prend pas en charge le verrouillage durable nécessaire au verrouillage transactionnel des fichiers ; par conséquent, ne configurez pas memcache.lockingMemcached. Redis est la solution recommandée pour ce rôle. Action : si vous utilisez déjà Memcached pour la mise en cache distribuée, conservez cette fonction séparée et configurez Redis spécifiquement pour les verrous.

Vérifiez Redis avant de modifier ownCloud

Vérifiez que Redis est installé, en cours d'exécution, accessible depuis les web workers PHP et protégé conformément à votre architecture réseau. L'extension PHP Redis doit également être disponible pour l'environnement d'exécution web ; la simple vérification de la ligne de commande PHP ne garantit pas qu'Apache ou PHP-FPM utilisent la même extension. Pour une instance Redis locale, la documentation d'ownCloud prend en charge les protocoles TCP et les sockets Unix. Dans un cluster, tous les nœuds de l'application doivent pointer vers le même service de verrouillage Redis, et non vers des bases de données Redis locales distinctes.

Avant toute modification, sauvegardez config/config.phpet notez les paramètres de cache locaux et distribués existants. Ne videz pas la totalité de la base de données Redis en premier lieu : cela pourrait effacer des données ou des sessions mises en cache sans rapport avec la configuration, selon le mode de partage de Redis. Action : identifiez l’index de la base de données Redis et vérifiez si d’autres applications utilisent cette instance avant toute maintenance.

Configurer le verrouillage transactionnel avec Redis

Ajoutez ou fusionnez les entrées suivantes config/config.php. Ne créez pas de clés de tableau PHP en double ; mettez plutôt à jour les entrées existantes. Cet exemple utilise Redis sur TCP sur le même hôte :

'filelocking.enabled' => true,
'memcache.locking' => '\OC\Memcache\Redis',
'redis' => [
    'host' => '127.0.0.1',
    'port' => 6379,
    'timeout' => 0,
    'password' => 'replace-with-your-redis-secret',
    'dbindex' => 0,
],

Utilisez l'hôte, le port, le mot de passe, l'index de la base de données et le chemin du socket Redis correspondant à votre déploiement. Limitez l'accès à Redis aux clients de confiance sur un réseau local ou privé, et ne l'exposez pas publiquement. Pour un socket Unix, l'exemple d'ownCloud utilise le chemin du socket et hostle définit portsur 0. L'utilisateur du serveur web doit disposer des autorisations nécessaires pour accéder à ce socket.

Redémarrez ou rechargez les services PHP/web concernés uniquement si la configuration de votre installation l'exige. Consultez ensuite la vue d'ensemble de l'administration et le journal ownCloud pour détecter d'éventuelles exceptions de cache ou de verrouillage. Action : effectuez un petit test (téléversement, renommage et synchronisation) avec un compte de test avant de considérer la modification comme terminée.

Lorsque le problème est un délai d'expiration du verrouillage manuel

Si un verrouillage créé par l'utilisateur persiste trop longtemps, consultez les paramètres de verrouillage manuel des fichiers dans Paramètres > Administration > Général . ownCloud 10.16 fournit des occexemples pour définir les durées de vie par défaut et maximales des verrouillages WebDAV :

sudo -u www-data ./occ config:app:set files lock_timeout_default --value 1800
sudo -u www-data ./occ config:app:set files lock_timeout_max --value 86400

Ces valeurs sont exprimées en secondes. Les valeurs par défaut de l'exemple ne sont pas obligatoires pour toutes les stratégies ; choisissez une durée correspondant à la durée pendant laquelle les utilisateurs ont raisonnablement besoin de conserver un verrou. Pour un verrou réellement abandonné, son propriétaire peut le déverrouiller depuis la vue des détails du fichier. Un administrateur peut également configurer un groupe de déverrouillage. Action : privilégiez l'interface utilisateur/API ou la méthode de récupération par groupe plutôt que de modifier directement les enregistrements de verrouillage WebDAV.

Vérifiez la correction et évitez les raccourcis risqués.

Après la modification, vérifiez que les chargements et les synchronisations sont terminés, que les modifications simultanées n'entraînent pas de corruption de fichiers et que les journaux ne signalent plus d'expirations de délai d'attente récurrentes du système de verrouillage. Si le journal signale désormais des échecs de connexion à Redis, corrigez la disponibilité de Redis, les identifiants, le chargement des extensions ou les permissions des sockets ; alterner entre les deux sans comprendre la cause de l'échec peut masquer l'origine du problème.

Ne désactivez pas le verrouillage transactionnel pour faire disparaître les délais d'attente. Ce verrouillage protège les opérations sur les fichiers et sa suppression peut engendrer des problèmes d'intégrité en cas d'activité simultanée. Ne supprimez pas les lignes de la base de données des tables de verrouillage et ne videz pas une base de données Redis partagée, sauf si la documentation d'assistance ownCloud relative à l'erreur en question vous y invite. Action : si le problème persiste après vérification de la configuration et de l'état du backend, capturez les journaux ownCloud et du backend horodatés et examinez les requêtes de base de données lentes ou les conflits de verrouillage avec votre administrateur.

Références officielles

Laisser un commentaire

Évitez les délais d'expiration de verrouillage de fichiers ownCloud grâce au bon backend

Distinguez les conflits de verrouillage de base de données des verrous WebDAV expirés, puis choisissez et configurez le correctif ownCloud 10 approprié.

Que vérifier lorsque ownCloud Web s'ouvre sur une page blanche

Que vérifier lorsque ownCloud Web s'ouvre sur une page blanche

Identifiez les causes d'un écran web ownCloud vide grâce à des vérifications ciblées : cache du navigateur, ressources web manquantes, erreurs de service ou paramètres d'URL du proxy inverse.

Effacer l'avertissement de mémoire PHP ownCloud dans le contexte d'exécution approprié

Définissez la limite de mémoire PHP web d'ownCloud, redémarrez le service correspondant et vérifiez la valeur active sans la confondre avec les paramètres de l'interface de ligne de commande ou les limites de téléchargement.

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.