Dépannage ONLYOFFICE Docs sous Docker

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:

Journaux du conteneur:
```
sudo docker logs <CONTAINER_ID>
```

Version conteneur:

sudo docker inspect --format='{{.Config.Image}}' <CONTAINER_ID>

Liste des volumes montés:

sudo docker inspect --format='{{range .Mounts}}{{.Source}} -> {{.Destination}}{{"\n"}}{{end}}' <CONTAINER_ID>

Système d'exploitation hôte et vesion Docker:
```
uname -a && docker --version
```

Installation et configuration système minimale

Q:Je souhaite installer le serveur basé sur Docker sur mon serveur local. Comment puis je le faire?

R:Le dernier serveur de bureau en ligne basé sur Docker est disponible sur le hub Docker. Veuillez sélectionner ONLYOFFICE Docs et suivez les instructions d'installation.

Q:De quel système ai-je besoin pour installer la solution serveur et l'utiliser avec succès?

R:La configuration système requise est:

Processeur (CPU): double cœur à 2 GHz ou plus
RAM: 4 GB ou plus
HDD: disque dur au moins 20 Go d'espace disponible
SWAP: d'au moins 4 Go, mais cela dépend du système d'exploitation hôte. Plus il y en a, mieux c'est
Système d'exploitation: amd64/arm64 toute version prise en charge par Docker.

Réseaux et DNS

Q:J'ai installé l'un des serveurs à l'aide du service Docker, mais j'ai des problèmes au niveau du serveur DNS server ou des problèmes du serveur DNS ou des problèmes de résolution de noms DNS. Qu'est-ce qui ne va pas?

R:Docker spécifie les serveurs DNS de Google par défaut et le serveur essaie de les contacter chaque fois qu'il effectue des requêtes réseau. Si votre application ONLYOFFICE Docs restera sans accès à Internet, il est recommandé de remplacer l'adresse DNS de Docker par votre serveur DNS local. Pour ce faire, passez au fichier /etc/default/docker et remplacez l'adresse IP de la ligne suivante par l'adresse IP d'un serveur DNS de votre réseau local:

docker_OPTS="--dns 8.8.8.8"

Pour les systèmes d'exploitation basés sur RPM tels que CentOS, le fichier de configuration peut être disponible ici: /etc/docker/daemon.json

Q:Les éditeurs de documents s'ouvrent et l'interface apparaît, mais le document lui-même ne se charge pas, affichant en permanence la progression du chargement. Que puis-je faire?

R:La raison peut être que l'ordinateur doit pouvoir s'adresser à lui-même en utilisant l'accès de bouclage Internet, c'est-à-dire qu'il doit être accessible de l'extérieur pour lui-même. Pour activation, modifiez iptables pour inclure les redirections comme suit:

iptables -t nat -A PREROUTING -d <public_ip> -j DNAT --to-destination <local_ip> iptables -t nat -A POSTROUTING -s <local_ip> -j SNAT --to-source <public_ip>

N'oubliez pas de remplacer les adresses public_ip et local_ippar les adresses IP réeles.

Authentification et sécurité

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 »). 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é. Vérifiez votre votre clé secrète à l'aide de:

sudo docker exec <CONTAINER_ID> /var/www/onlyoffice/documentserver/npm/json -f /etc/onlyoffice/documentserver/local.json services.CoAuthoring.secret.session.string

Performances et utilisation des ressources

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/.

Q:Le conteneur redémarre sans arrêt. Que dois-je faire?

R:Vérifiez si le journal du conteneur contient des erreurs:

sudo docker logs <CONTAINER_ID>

Les causes courantes incluent:

Mémoire insuffisante (le conteneur nécessite au moins 4 Go de RAM).
Le port 80 est déjà utilisé par une autre application. Fermez l'autre application ou modifiez le port de ONLYOFFICE Docs.
Échec de l'initialisation de la base de données. Si vous utilisez une base de données externe, vérifiez que les paramètres de connexion sont corrects.

Gestion des documents

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?

R:Vérifiez si le journal du convertisseur contient des erreurs en exécutant la commande suivante:

sudo docker exec <CONTAINER_ID> cat /var/log/onlyoffice/documentserver/converter/out.log

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

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, vous devez déconnecter de force les utilisateurs ONLYOFFICE Docs lorsque vous devez 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 docker exec <CONTAINER> 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.

Mise en cache et personnalisation

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:Videz le cache en exécutant la commande suivante:

sudo docker exec <CONTAINER_ID> documentserver-flush-cache.sh

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

Veuillez noter que pour l'installation de Docker, toutes les actions doivent être effectuées dans le conteneur.

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é.