Dépannage
Problèmes généraux
Q:Je souhaite installer la solution serveur sur mon serveur local. Où puis-je télécharger la dernière version ?
R:La dernière version de la solution serveur est disponible sur GitHub et SourceForge.
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 :
-
Processeurdouble cœur à 4 GHz ou plus
-
RAMau moins 8 Go, mais cela dépend du système d'exploitation hôte. Plus il y en a, mieux c'est
-
Disque durau moins 40 Go d'espace libre
-
Système d'exploitationMicrosoft Windows Server 2016 ou version ultérieure
Q:J'ai déjà installé la solution serveur sur mon serveur, mais je ne sais pas quelle version j'utilise. Comment le vérifier ?
R:Vous pouvez vérifier le numéro de version exact de la manière suivante :
- ouvrez le fichier
web.studio/web.appsettings.config - examinez le paramètre <add key="web.install-url" value="http://service.onlyoffice.com/install/email.ashx?v=77" />, et plus précisément le numéro qui suit v=
Q:J'ai installé Community Server avec le Panneau de configuration et Docs, puis j'ai désinstallé Docs, et le Panneau de configuration ne fonctionne plus.
R:Vous devez réinitialiser les chemins de connexion à Docs et redémarrer Community Server dans IIS. Procédez comme suit :
- Accédez au dossier
C:\Program Files (x86)\Ascensio System SIA\CommunityServer\WebStudio\et ouvrez le fichierweb.appsettings.configdans un éditeur de texte.Effacez les valeurs des clés suivantes et enregistrez les modifications.
<add key="files.docservice.url.public" value="" /> <add key="files.docservice.url.internal" value="" /> <add key="files.docservice.url.portal" value="" /> - Réinitialisez les paramètres de connexion de l'éditeur dans les paramètres du portail :
Accédez à la page
http://127.0.0.1/Management.aspx?type=17et appuyez sur le bouton Réinitialiser. - Redémarrez le site web ONLYOFFICE Server dans IIS :
Accédez à Démarrer > Outils d'administration Windows et lancez le Gestionnaire des services Internet (IIS). Dans le Gestionnaire IIS, développez la section Sites dans le panneau Connexions. Faites un clic droit sur le site web
ONLYOFFICE Serverdans la liste et sélectionnez l'option Gérer le site web > Redémarrer.
Problèmes d'installation
Q:J'ai besoin des instructions d'installation. Où puis-je les trouver ?
R:Les instructions d'installation se trouvent dans la section Installation de notre Centre d'aide.
Q:Je souhaite installer la solution serveur sous Windows Server 2012. Est-ce possible ?
R:Oui, vous pouvez installer la solution serveur sous Windows Server 2012, mais vous devrez modifier certains de ses paramètres pour la faire fonctionner :
- accédez à
C:\Windows\System32\inetsrv\config\applicationHost.config - recherchez la section <sectionGroup name="system.webServer">
- remplacez <section name="handlers" overrideModeDefault="Deny" /> par <section name="handlers" overrideModeDefault="Allow" />
- remplacez <section name="modules" overrideModeDefault="Deny" /> par <section name="modules" overrideModeDefault="Allow" />
Q:J'utilise une ancienne version de la solution serveur. Comment migrer vers la plus récente ?
R:Les instructions détaillées sur la mise à jour d'ONLYOFFICE Workspace vers la dernière version sont données dans cet article.
N'oubliez pas de sauvegarder les données de votre portail avant de démarrer le processus de migration.
Q:J'obtiens le message d'erreur suivant : "Server Error in ‘/’ Application. Index was out of range. Must be non-negative and less than the size of the collection". Comment résoudre ce problème ?
R:Essayez d'ajouter des caractères à la clé core.machinekey dans le fichier web.appsettings.config afin qu'elle en contienne au moins 8.
Q:J'obtiens le message d'erreur suivant : "{SQL_ERROR}: {SQL_STATE: HY000} Specified key was too long; max key length is 1000 bytes". Comment résoudre ce problème ?
R:Nous vous recommandons d'installer mysql-essential-5.1.58-win32 ou de modifier les paramètres de votre serveur de base de données afin qu'il autorise les clés longues.
Q:Je viens d'installer la solution serveur sur mon ordinateur, mais je ne trouve pas ses dossiers. Pourriez-vous m'indiquer où les trouver ?
R:Par défaut, les versions antérieures à 7.5 sont installées dans le répertoire suivant : C:\ProgramData\TeamLab, la version 7.5 est installée dans le répertoire C:\Program Files (x86)\TeamLab Server, la version 7.7 est installée dans le répertoire C:\Program Files\Ascensio System SIA\ONLYOFFICE.
Q:J'ai téléchargé le code source. Mais je ne sais pas comment commencer à l'utiliser avec Visual Studio 2010. Qu'est-ce que je fais de travers ?
R:La solution serveur se compose de plusieurs petits projets, et non d'un seul projet que l'on peut ouvrir dans Visual Studio. Ces projets sont compilés à l'aide du fichier .bat suivant : redistributable\asc\BuildAndDeploy.bat. Nous utilisons Visual Studio 2012.
Problèmes de configuration
Q:Lorsque j'essaie de lancer ONLYOFFICE Workspace pour la première fois, le localhost est indisponible et le site ONLYOFFICE ne démarre pas, renvoyant l'erreur The process cannot access the file because it's being used by another process. (Exception from HRESULT: 0x80070020). Comment y remédier ?
R:Cette erreur peut être corrigée de deux manières :
- basculez le site ONLYOFFICE sur un autre port dans le Gestionnaire des services Internet (IIS) ;
- ou supprimez tous les autres sites web (le cas échéant) du port 80 dans IIS.
Vous pouvez également essayer de désactiver Skype s'il est en cours d'exécution.
Q:Je souhaite faire passer mon portail de HTTP à HTTPS. Comment procéder ?
R:Placez votre certificat au format PEM sur l'ordinateur où la solution serveur est installée. Indiquez le chemin d'accès complet à ce fichier en utilisant la barre oblique (/) dans le fichier config.js de la solution serveur. Redémarrez ensuite le service OnlyOfficeRouter.
Q:Je souhaite changer le nom de domaine de mon portail. Comment procéder ?
R:Vous pouvez attribuer un nom de domaine soit dans le champ Paramètres DNS > Nom de domaine personnalisé de l'onglet Paramètres > Général, soit dans le champ mappeddomain de la table tenants_tenants.
Q:Je ne parviens pas à utiliser la recherche en texte intégral avec ONLYOFFICE Workspace. Comment la configurer ?
R:Pour configurer la recherche en texte intégral dans ONLYOFFICE Workspace, procédez comme suit :
- Téléchargez
sphinxversion 2.2.10 depuis le site officiel - Décompressez l'archive téléchargée dans un dossier, par exemple
C:\Program Files\Sphinx-2.2.10 - Ajoutez le chemin d'accès au répertoire
binde Sphinx (par exempleC:\Program Files\Sphinx-2.2.10\bin) à la variable d'environnement PATH du système (et NON de l'utilisateur).Voici comment procéder : accédez au Panneau de configuration > Système > Paramètres système avancés. Dans la fenêtre de dialogue qui s'ouvre, cliquez sur Variables d'environnement..., sélectionnez la variable PATH et cliquez sur Modifier. Sélectionnez Nouveau dans la fenêtre qui s'ouvre, saisissez le nom de la nouvelle variable (par exemple
sphinx) et recherchez son chemin d'accès à l'aide du bouton prévu. Enregistrez ensuite les résultats. - Faites passer le type de démarrage de OnlyofficeIndex de
disabledàautomaticet lancez le service.Accédez au Panneau de configuration > Outils d'administration > Services, recherchez le service OnlyofficeIndex, faites un clic droit dessus et sélectionnez Propriétés. Dans la fenêtre de dialogue qui s'ouvre, utilisez le menu déroulant pour sélectionner le type de démarrage Automatique, cliquez sur OK et démarrez le service.
L'installation automatique n'est pas prise en charge sous Windows en raison de restrictions de licence.
Q:J'ai un problème avec l'envoi des notifications par e-mail. Je reçois des messages portant le nom du serveur qui héberge la solution serveur (nom de l'ordinateur) au lieu du nom DNS personnalisé que j'ai ajouté. Comment résoudre ce problème ?
R:Ajoutez la chaîne <add key="web.host" value="<YOUR_DOMAIN>"/> au fichier web.appsettings.config.
Q:J'ai ajouté le domaine au fichier web.appsettings.config. Cela fonctionne si le site web utilise le port 80. Comment définir un autre port ?
R:Vous pouvez ajouter la chaîne suivante dans le fichier web.appsettings.config : <add key="web.host" value="http://<DOMAIN>:<PORT>"/>.
Q:J'ai configuré et testé les paramètres SMTP avec succès, mais les notifications par e-mail ne fonctionnent pas. Pourquoi ?
R:Vous avez probablement des problèmes de réseau. Pour le vérifier, accédez à Démarrer > Exécuter et saisissez la commande cmd. Saisissez ensuite ping notify.onlyoffice.com ou ping mail.onlyoffice.org dans la fenêtre de ligne de commande qui s'ouvre et appuyez sur la touche Entrée. Si votre adresse IP ne s'affiche pas, c'est que votre réseau présente un problème.
Q:Le module Chat ne fonctionne pas. Comment résoudre ce problème ?
R:Vérifiez que le service OnlyofficeJabber est en cours d'exécution et qu'il a été ajouté aux exceptions du pare-feu et de l'antivirus. Les ports 5222 et 5280 doivent être ouverts.
Q:Impossible de connecter une boîte mail au module Mail, ou aucun message n'est reçu dans la boîte mail connectée. Comment résoudre ce problème ?
R:Vérifiez que le service OnlyofficeMailAggregator est en cours d'exécution et qu'il a été ajouté aux exceptions du pare-feu et de l'antivirus. Vérifiez également que les ports suivants sont ouverts pour les requêtes sortantes :
SMTP: 25, 465IMAP: 143, 993POP3: 110, 995
Q:Les notifications relatives aux événements du portail ne sont pas reçues à l'adresse e-mail. Comment résoudre ce problème ?
R:Vérifiez que le service OnlyofficeNotify est en cours d'exécution et qu'il a été ajouté aux exceptions du pare-feu et de l'antivirus. Vérifiez que le port 25 est ouvert pour les requêtes sortantes.
Q:Le service OnlyofficeAutoreplay ne fonctionne pas. Comment résoudre ce problème ?
R:Vérifiez que le port 25 est ouvert pour les requêtes entrantes. Vérifiez également que votre enregistrement MX DNS est correctement défini.
Q:Je souhaite modifier le code de la solution serveur pour l'adapter à mes besoins. Il devrait exister un fichier solution permettant de voir un projet bien organisé. Où puis-je trouver ce fichier solution ?
R:Il n'existe pas de fichier solution, mais vous pouvez le créer vous-même et y ajouter les projets manuellement. L'ordre de compilation des projets est indiqué ici : _ci\projects\build.proj.
Problèmes d'utilisation
Q:Je dois sauvegarder les données de mon portail. Comment procéder ?
R:Vous pouvez créer une sauvegarde de la base de données au moyen de MySQL. Vous pouvez également créer manuellement une sauvegarde des données en copiant celles-ci depuis les répertoires suivants :
| Data\Files\ |
| Data\Mail\ |
| web.studio\addons\mail\Data |
| web.studio\data\ |
| web.studio\Products\Community\Modules\Blogs\Data\ |
| web.studio\Products\Community\Modules\Bookmarking\Data\ |
| web.studio\Products\Community\Modules\Forum\Data\ |
| web.studio\Products\Community\Modules\News\Data\ |
| web.studio\Products\Community\Modules\PhotoManager\Data\ |
| web.studio\Products\Community\Modules\Wiki\Data\ |
| web.studio\Products\CRM\Data\ |
| web.studio\Products\Projects\Data\ |
Q:J'ai essayé d'accéder au portail depuis mon téléphone Android, sans succès. Pourquoi ?
R:La solution serveur ne propose pas d'accès mobile : vous ne pouvez donc pas accéder à votre portail depuis un téléphone Android ou un appareil iOS, ce qui serait possible avec la solution SaaS.
Q:Le module Projets reste bloqué sur l'icône de chargement après la migration de la version 6.0 vers la version 6.5. Comment résoudre ce problème ?
R:Commencez par essayer de vider le cache de votre navigateur : certains scripts Java ont été mis à jour dans la version 6.5 et, si les scripts de la version précédente ont été conservés dans le cache, cela peut provoquer ce problème.
Q:J'ai rencontré, en utilisant la solution serveur, un problème qui n'est pas mentionné ici. Que dois-je faire ?
R:N'hésitez pas à consulter notre forum pour les développeurs pour trouver des réponses à toutes vos questions. Vous pouvez également décrire votre problème dans la section GitHub Issues, où les membres de la communauté essaieront de vous aider.