Dépannage

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

R:La dernière version du serveur de bureau en ligne basé sur Docker est disponible sur Docker Hub. Sélectionnez la solution que vous souhaitez installer : ONLYOFFICE Docs, ONLYOFFICE Workspace ou ONLYOFFICE Mail, puis suivez les instructions de la page correspondante.

Q:Après avoir créé et ouvert le portail, je vois un utilisateur inconnu portant le nom « fake user » dans le module Personnes. Un service OnlyofficeHealthCheck figure également dans la liste des services. À quoi cela correspond-il et dois-je faire quelque chose ?

R:Cet utilisateur et ce service font partie de la future fonctionnalité Health Check, qui sera proposée aux portails dans les prochaines versions. Elle n'est pas encore opérationnelle : vous pouvez donc la laisser telle quelle ou désactiver le service OnlyofficeHealthCheck et le retirer de la liste des services à démarrage automatique.

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

R:La configuration système requise est la suivante :

• Processeur
  double cœur à 2 GHz ou plus
• RAM
  4 Go ou plus
• Disque dur
  au moins 20 Go d'espace libre
• SWAP
  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
  distribution Linux amd64 avec la version de noyau 3.10 ou ultérieure
• Exigences supplémentaires
  • Docker : n'importe quelle version prise en charge par l'équipe Docker

Q:J'ai installé l'une des versions serveur à l'aide du service Docker, mais je rencontre des problèmes liés au serveur DNS ou à la résolution de mon propre nom. D'où cela peut-il venir ?

R:Docker indique les serveurs DNS de Google par défaut, et le serveur tente de les contacter chaque fois qu'il effectue des requêtes réseau. Si votre ONLYOFFICE Workspace, ONLYOFFICE Docs ou ONLYOFFICE Mail n'aura pas accès à Internet, nous vous recommandons de remplacer l'adresse DNS Docker par défaut par celle de votre serveur DNS local. Pour ce faire, ouvrez le 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"

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

Q:Les éditeurs de documents s'ouvrent et l'interface s'affiche, mais le document lui-même ne se charge pas et la progression du chargement reste affichée en permanence. Que faire ?

R:Cela peut venir du fait que l'ordinateur doit pouvoir s'adresser à lui-même via l'accès en boucle Internet, c'est-à-dire qu'il doit être accessible de l'extérieur pour lui-même. Vous pouvez le lui permettre en modifiant les iptables pour y ajouter des redirections comme celles-ci :

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_ip par les adresses IP réelles.

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

R:Suivez les étapes ci-dessous pour réinitialiser le cache :
Recherchez les fichiers /etc/nginx/includes/ds-docservice.conf et /etc/nginx/includes/ds-spellchecker.conf. Ils doivent contenir la valeur de la date et de l'heure de compilation. Remplacez ces valeurs par d'autres (n'importe quelle valeur convient, l'essentiel étant qu'elle soit identique partout), puis redémarrez NGINX :

sudo service nginx reload

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

Q:J'ai ajouté un certificat SSL auto-signé et j'obtiens désormais une erreur à l'ouverture de la page de métadonnées SSO, lors de l'utilisation de WebDAV et d'autres services node.js. Que faire pour y remédier ?

R:Si vous rencontrez un problème pour obtenir les métadonnées SSO, ou avec WebDAV et d'autres services node.js lors de l'utilisation de certificats SSL auto-signés, essayez l'une des solutions suivantes :

Option 1 : ajouter des paramètres au lancement du service.

1. Ouvrez le fichier onlyofficeSsoAuth.service (dans le conteneur CommunityServer) :

   nano /lib/systemd/system/onlyofficeSsoAuth.service

2. Ajoutez la chaîne suivante, qui indique le chemin d'accès au certificat racine, à la fin du bloc [Service] :

   Environment=NODE_EXTRA_CA_CERTS=/etc/rootCA.pem

3. Redémarrez les services :

   systemctl daemon-reload
   systemctl restart onlyofficeSsoAuth

Option 2 : utiliser l'ensemble de certificats du système.

1. Ouvrez le fichier onlyofficeSsoAuth.service (dans le conteneur CommunityServer) :

   nano /lib/systemd/system/onlyofficeSsoAuth.service

2. Recherchez la chaîne suivante dans le bloc [Service] :

   ExecStart=/usr/bin/node /var/www/onlyoffice/Services/ASC.SsoAuth/app.js UNIX.SERVER

   Remplacez-la par celle-ci :

   ExecStart=/usr/bin/node --use-openssl-ca /var/www/onlyoffice/Services/ASC.SsoAuth/app.js UNIX.SERVER

3. Sous CentOS, ajoutez également la chaîne suivante, qui indique le chemin d'accès à l'ensemble de certificats, à la fin du bloc [Service] :

   Environment=SSL_CERT_FILE=/etc/pki/tls/certs/ca-bundle.trust.crt

4. Redémarrez les services :

   systemctl daemon-reload
   systemctl restart onlyofficeSsoAuth

Q:J'ai redémarré le serveur sans arrêter le conteneur Docker avec la commande docker stop id, et j'obtiens maintenant l'erreur ERR_TOO_MANY_REDIRECTS sur mon serveur. Que faire pour y remédier ?

R:Modifiez le fichier /var/www/onlyoffice/WebStudio/web.appsettings.config en supprimant la toute dernière ligne :

<add key="web.warmup.type" value="basic" />

puis redémarrez monoserve à l'aide de la commande suivante :

sudo service monoserve restart

Q:J'utilise Fedora Linux et les processus ne démarrent pas dans le conteneur Docker. Existe-t-il une solution à ce problème ?

R:Les utilisateurs de Fedora et de RHEL/CentOS peuvent essayer de désactiver SELinux à l'aide de la commande setenforce 0. Si cela résout le problème, vous pouvez soit conserver SELinux désactivé, ce que Red Hat ne recommande pas, soit passer à Ubuntu.

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

R:En raison de son mode de fonctionnement, ONLYOFFICE Docs n'enregistre un document qu'une fois celui-ci fermé par tous les utilisateurs qui l'ont modifié. Pour éviter toute perte de données, vous devez déconnecter de force les utilisateurs d'ONLYOFFICE Docs lorsque vous avez besoin d'arrêter ONLYOFFICE Docs, par exemple en cas de mise à jour de l'application ou de redémarrage du serveur. Pour ce faire, exécutez le script suivant sur le serveur où ONLYOFFICE Docs est installé :

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh