Dépannage ONLYOFFICE Docs sous Linux

Avant de contacter le service d'assistance: recueillir des informations de diagnostic

Si vous rencontrez un problème qui n'est pas abordé ci-dessous, veuillez rassembler les informations suivantes avant de contacter le service d'assistance d'ONLYOFFICE:

Répertoire des journaux: /var/log/onlyoffice/documentserver/
Version du paquet: dpkg -l | grep onlyoffice (Debian/Ubuntu) ou rpm -qa | grep onlyoffice (CentOS)
Version du système d'exploitation: cat /etc/os-release

Problèmes de compilation

Q:J'ai cloné le code mais je ne trouve que des dossiers vides, il n'y a pas de code source.

R:e référentiel comprend des sous-modules. Il est recommandé de cloner le référentiel en exécutant la commande suivante:

git clone --recursive https://github.com/ONLYOFFICE/DocumentServer.git

Si vous avez cloné le référentiel à l'aide de la commande:

git clone https://github.com/ONLYOFFICE/DocumentServer.git

vous pouvez mettre à jour les sous-modules de la manière suivante:

Accédez au référentiel DocumentServer:
```
cd DocumentServer
```
Exécutez la commande suivante:
```
git submodule update --init --recursive
```

Problèmes d'utilisation

Q:Une perte de données s'est produite lors de l'arrêt de ONLYOFFICE Docs. Comment éviter la perte de données?

R:En raison de la caractéristique opérationnelle, ONLYOFFICE Docs n'enregistre un document qu'une fois que le document a été fermé par tous les utilisateurs qui l'ont modifié. Pour éviter la perte de données, il vous faut forcer la déconnexion des utilisateurs ONLYOFFICE Docs lorsque vous avez besoin d'arrêter ONLYOFFICE Docs en cas de mise à jour de l'application, de redémarrage du serveur, etc. Pour ce faire, exécutez le script suivant sur le serveur sur lequel ONLYOFFICE Docs est installé:

sudo documentserver-prepare4shutdown.sh

L'exécution du script peut prendre un certain temps (jusqu'à 5 minutes), car il attend que tous les utilisateurs se déconnectent.

Q: J'ai ajouté un thème d'interface personnalisé ou j'ai mis à jour les fichiers de langue de mon éditeur (correction de certaines traductions) mais le serveur affiche toujours les valeurs précédentes au lieu des correctes. Comment réinitialiser le cache pour tous les utilisateurs en même temps?

R: Veuillez suivre les étapes ci-dessous pour réinitialiser le cache:

Trouvez les fichiers /etc/nginx/includes/ds-docservice.conf et /etc/nginx/includes/ds-spellchecker.conf. Il doit y avoir la valeur de date et d'heure de construction. Remplacez ces valeurs par d'autres (n'importe quelle valeur fera l'affaire, mais l'essentiel est qu'elle soit la même à tous les endroits), et redémarrez NGINX:

sudo service nginx reload

Le cache doit être réinitialisé pour tous les utilisateurs du serveur.

Q: Les services ONLYOFFICE Docs ne parviennent pas à démarrer. Que dois-je faire?

R: Vérifiez l'état des services et examinez les messages d'erreur éventuels:

sudo systemctl status ds-docservice sudo systemctl status ds-converter

Si l'un des services s'est arrêté, essayez de le redémarrer:

sudo systemctl restart ds-docservice

Les causes courantes incluent:

Mémoire insuffisante (au moins 4 Go de RAM sont recommandés).
Le port 80 est déjà utilisé par une autre application. Identifiez le processus en conflit avec sudo ss -tlnp | grep :80 et arrêtez-le, ou reconfigurez ONLYOFFICE Docs pour utiliser un port différent.
Consultez les journaux pour obtenir des messages d'erreur plus spécifiques : /var/log/onlyoffice/documentserver/

Q:L'authentification JWT échoue après l'intégration ONLYOFFICE Docs à ma plateforme. Comment puis-je résoudre ce problème?

R:Vérifiez que la clé secrète JWT configurée dans ONLYOFFICE Docs correspond exactement à celle configurée dans les paramètres du connecteur de votre plateforme. Vérifiez également que le nom de l'en-tête JWT correspond (la valeur par défaut est « Autorisation »). Pour vérifier votre clé secrète actuelle, consultez directement le fichier de configuration:

cat /etc/onlyoffice/documentserver/local.json

Recherchez la valeur de services.CoAuthoring.secret.session.string. Erreurs courantes:

Des espaces au début ou à la fin de la valeur secrète.
Utilisation du secret aléatoire par défaut au lieu d'en définir un personnalisé.

Q:Conversion des documents échouée (par ex., une erreur s'affiche lors de l'ouverture des fichiers DOC, XLS ou PPT). Que puis-je faire?

A:Vérifiez si le journal du convertisseur contient des erreurs:

cat /var/log/onlyoffice/documentserver/converter/out.log

Parmi les causes courantes, on peut citer un espace disque insuffisant et des polices manquantes.

Q: L'utilisation élevée de la mémoire par ONLYOFFICE Docs. Est-ce normal?

R:La consommation de mémoire évolue en fonction du nombre de documents ouverts et d'utilisateurs simultanés. Pour un serveur avec quelques dizaines d'utilisateurs actifs, une utilisation de 2 à 4 Go de RAM est normale. Si la consommation de mémoire est anormalement élevée, vérifiez la présence de documents bloqués ou oubliés dans /var/lib/onlyoffice/documentserver/App_Data/cache/files/forgotten/.

Problèmes avec Édition Entreprise et Édition Développeur

Q: L'avertissement de l'expiration de licence s'affiche. Que dois-je faire?

R:Votre fichier de licence license.lic a expiré. Contactez sales@onlyoffice.com pour renouveler votre licence. Une fois le nouveau fichier reçu, remplacez l'ancien fichier license.lic dans le répertoire data et redémarrez ONLYOFFICE Docs.

Q: Je n'arrive pas à accéder au Panneau de configuration. Que dois-je faire?

R:Si vous n'avez pas encore configuré le Panneau de configuration, suivez le Guide de configuration du panneau e configuration. Si vous avez oublié votre mot de passe administrateur, supprimez passwordHash dans le fichier runtime.json et redémarrez : un nouveau code de démarrage sera généré.