Installation OnlyOffice

Préambule

OnlyOffice Server est une suite bureautique en ligne comprenant des visionneuses et des éditeurs de textes, de tableurs et de présentations, entièrement compatible avec les formats Office Open XML (norme ISO/CEI 29500).

Cette suite permet de travailler dans MultiGest avec les fonctionnalités suivantes :

Editeur de document (type Word)
Editeur de feuilles de calcul (type Excel)
Editeur de présentations (type Powerpoint)

Elle permet également d’utiliser les dernières versions des navigateurs web pour éditer et enregistrer des documents : doc, docx, txt, odt, rtf, odp, epub, ods, xls, xlsx, csv, pptx, html.

Cette section indique la manière de procéder pour l’installation de l’application OnlyOffice et de ses prérequis sur le serveur MultiGest.

Préparation à l’installation

Création du répertoire onlyoffice

Aller dans le répertoire d’installation de la GED

Créer un répertoire OnlyOffice dans le répertoire APPLI

Installation des prérequis

La configuration requise générale préconisée est la suivante :

Système d’exploitation : Microsoft Windows Server 2012(R2) ; Microsoft Windows Server 2016; Microsoft Windows Server 2019.

Exigences supplémentaires :

Erlang : la version 19.1
RabbitMQ : version 3.5.4
Redis : version 3.2
PostgreSQL : version 9.6

Lors de l’installation d’OnlyOffice il sera proposé d’installer les applications suivantes si elles n’ont pas été installées auparavant :

Node.js
Visual C++ 2010 SP1 64-bits Redistributable

Procédure

Cette partie indique la manière de procéder pour l’installation de l’application OnlyOffice et de ses prérequis sur le serveur MultiGest.

Le package d’installation d’OnlyOffice contient les éléments suivants :

Le setup d‘installation de l’application OnlyOffice
Les prérequis pour l’application OnlyOffice
Deux répertoires contenant des fichiers pour la configuration en http et en https et pour l’application OnlyOffice

Les outils prérequis sont disponibles dans l’archive fourni par Efalia nommée «additional.requirements.zip».

Décompresser le fichier « additional.requirements.zip».

Aller dans le serveur de MultiGest en se connectant avec un profil Administrateur.

Installation d’Erlang

Cliquer avec le bouton droit de la souris sur le fichier « otp_win64_19.1.exe » puis « Exécuter en tant qu’administrateur ».

Modifier (Préconisé) le chemin d’installation de l’application, comme par exemple : D:\GED\APPLI\OnlyOffice\erl8.1 et faire « Next » ou « Install ».

L’écran suivant s’affiche lorsque l’installation s’est terminée.

Cliquer sur « Close »

Installation de RabbitMQ

Cliquer avec le bouton droit de la souris sur le fichier « rabbitmq-server-3.5.4.exe » puis « Exécuter en tant qu’administrateur ».

Modifier (Préconisé) le chemin d’installation de l’application, comme par exemple : D:\GED\APPLI\OnlyOffice\RabbitMQ Server et cliquer sur « Next » ou « Install ».

L’écran suivant s’affiche lorsque l’installation s’est terminée.

Cliquer sur « Finish

Installation de Redis

Cliquer avec le bouton droit de la souris sur le fichier « Redis-x64-3.2.100.msi » puis « Installer ».

Modifier (Préconisé) le chemin d’installation de l’application, comme par exemple : D:\GED\APPLI\OnlyOffice\Redis et cliquer sur « Next » ou « Install ».

Cocher la case « Add an exception… » pour créer une exception dans le Pare-Feu Windows pour le port 6379.

Cliquer sur « Next ».

Cliquer sur « Next ».

L’écran suivant s’affiche lorsque l’installation s’est terminée.

Cliquer sur « Finish

Installation de PostgreSQL

Cliquer avec le bouton droit de la souris sur le fichier « postgresql-12.3-1-windows-x64.exe » puis « Exécuter en tant qu’administrateur ».

Modifier (Préconisé) le chemin d’installation de l’application, comme par exemple : D:\GED\APPLI\OnlyOffice\PostgreSQL et cliquer sur « Suivant ».

Laisser cochées les options par défaut.

Laisser le chemin des données de la base de données par défaut et cliquer sur « Next ».

Fournir le mot de passe « root » lorsque l’écran suivant s’affiche (super utilisateur postgres). Utiliser le même mot de passe que celui utilisé pour la base de données MariaDB.

Il est possible également de saisir un autre mot de passe et de l’utiliser lors de la suite de la configuration. Noter le mot de passe enregistré pour une utilisation postérieure.

Conserver les options par défaut, notamment le numéro de port proposé.

L’écran suivant s’affiche lorsque l’installation s’est terminée.

Décocher la case « Stack Builder… » puis cliquer sur « Terminer ».

Installation de Node.js

Il existe deux méthodes pour l’installation de Node.js :

Installation par défaut avec l’installation d’OnlyOffice

Node.js est téléchargé et installé automatiquement lors de l’installation d’OnlyOffice. La version installée est la suivante : Node-v6.11.3-x64.msi. Il est nécessaire de disposer d’une connexion internet sur le serveur utilisé.

Information

Si le serveur n’a pas d’accès internet, Node.js peut être installé manuellement : il est fourni dans le package d’installation dans le fichier compressé (additional.requirements.zip).

Installation indépendante (Manuelle)

Cliquer avec le bouton droit de la souris sur le fichier Node- v6.11.3-x64.msi » puis « Exécuter en tant qu’administrateur ».

Information

Laisser la configuration par défaut.

Cliquer ensuite sur les boutons « Next » puis « Install ».

L’écran suivant s’affiche lorsque l’installation s’est terminée.

Cliquer sur le bouton « Finish »

Lorsque l’installation des prérequis est terminée il est possible de poursuivre l’installation d’OnlyOffice en créant une base de données dans PostgresSQL et en installant l’application dans le serveur Multigest.

Création de la base de données dans PostgresSQL

La création de la base de données PostgresSQL peut se réaliser selon deux méthodes différentes : en utilisant le script fourni dans le package d’installation ou en utilisant la console d’invite de commandes Windows.

Conseil

Il est souhaitable, lors de l’utilisation de la fonction copier-coller des lignes de commandes dans l’invite de commandes Windows de les copier au préalable dans un éditeur de texte du type bloc-notes ou Notepad++ et de les coller ensuite dans l’invite de commandes.

Création de la base en utilisant le script

Aller dans le répertoire contenant la livraison d’OnlyOffice fourni par Efalia.

Exécuter le script « Install_base_postgre.bat ».

Renseigner le chemin du répertoire d’installation de l’application PostgresSQL.

Saisir le mot de passe du compte root de PostgreSQL pour chaque ligne

Création de la base en utilisant l’invite des commandes (Windows)

Exécuter l’invite de commande en tant qu’administrateur.

Aller sur le répertoire d’installation de PostgreSQL en exécutant la commande suivante :

cd /[INSTALL_POSTGRESQL]\9.6\bin

Exécuter les commandes suivantes en utilisant le mot de passe superutilisateur fourni lors de l’installation de PostgreSQL.

psql -U postgres -c "CREATE DATABASE onlyoffice;"
-U postgres -c "CREATE USER onlyoffice WITH password 'onlyoffice';"
-U postgres -c "GRANT ALL privileges ON DATABASE onlyoffice TO onlyoffice;"

Le paramétrage de PostgreSQL est terminé

Installer Document Server

Par défaut, Document Server écoute les connections entrantes sur le port 80, pour utiliser MultiGest, il est nécessaire d’utiliser un autre port. Ce port doit être ouvert dans le Pare-feu Windows. Par convention il est préconisé d’utiliser le port « 8085 ».

Conseil

Il est nécessaire d’avoir une connexion internet sur le serveur utilisé pour pouvoir installer OnlyOffice.

Pour installer OnlyOffice il est nécessaire de lancer l’exécutable onlyoffice-
documentserver-integration.exe en utilisant l’invite de commandes
Windows:

Lancer l’invite de commandes entant qu’administrateur.
Se placer dans le répertoire contenant le fichier « onlyoffice-documentserver-integration.exe » fourni dans le dossier d’installation.

Copier la commande suivante et la coller dans la console :

onlyoffice-documentserver-integration.exe /DS_PORT=8085

Wizard DocumentServer Setup s’exécute et la fenêtre suivante s’affiche.

Cliquer sur le bouton « Next> » pour commencer la procédure d’installation.

Par défaut, l’exécutable propose d’installer l’application dans le dossier suivant :

C:\Program Files\ONLYOFFICE\DocumentServer\.

Si nécessaire, il est possible de changer le répertoire d’installation en cliquant sur le bouton « Browse » et en sélectionnant le répertoire souhaité.

Cliquer sur le bouton « Next > ».

Normalement, si les instructions de la partie Installation des prérequis ont été appliqués entièrement, aucun téléchargement ne sera nécessaire. Néanmoins si certains prérequis sont manquants sur le serveur, le setup d’installation procédera au téléchargement et installation.

Cliquer sur le bouton « Install » et attendre pendant que les composants manquants soient installés.

Cliquer sur le bouton « Oui ».

Spécifier les paramètres suivants dans la fenêtre de dialogue « Configuring PostgreSQL connection » :
- Host: localhost
- User: onlyoffice
- Password: onlyoffice
- Database: onlyoffice

Spécifier les paramètres suivants dans la fenêtre de dialogue « Configuring RabbitMQ connection »:
- Host: localhost
- User: guest
- Password: guest

Spécifier les paramètres suivants dans la fenêtre de dialogue Configuring Redis connection :
- Host: localhost

Une fois terminé le processus d’installation, cliquer sur le bouton « Finish » pour fermer la fenêtre en prenant soin de décocher la case « Open OnlyOffice DocumentServer welcome page ».

Configuration d’OnlyOffice

Licence OnlyOffice

Pour utiliser pleinement OnlyOffice il est nécessaire d’ajouter le fichier de licence dans le serveur OnlyOffice.

Ce fichier de licence sera fourni par Efalia lors de la première installation d’OnlyOffice.

Copier le fichier « license.lic » dans le serveur OnlyOffice dans le répertoire suivant :

« C:\ProgramData\ONLYOFFICE\Data\license.lic »

La version « Integration Edition » de OnlyOffice sera totalement opérationnelle.

Modification des fichiers de configuration

Les fichiers de configuration fournis dans le package d’Efalia contiennent tout le paramétrage pour que l’application fonctionne en mode TSL ou SSL. Les ports 8085 et 8443 sont définis dans la configuration.

Pour paramétrer OnlyOffice il est nécessaire de suivre les indications suivantes :

Copier le répertoire « DocumentServer » présent dans le répertoire « configuration » du package d’installation OnlyOffice.

Aller dans le répertoire d’installation d’OnlyOffice sur le serveur

Coller et fusionner les deux dossiers « DocumentServer » en remplaçant les documents.

Relancer les services

Il est possible de relancer les services de deux façons différentes :

A partir de l’interface Services de Windows

Ouvrir les services

Relancer les services suivants en cliquant avec le bouton droit de la souris et sélectionnant « Redémarrer »
- ONLYOFFICE DocumentServer Proxy
- ONLYOFFICE DocumentServer Converter
- ONLYOFFICE DocumentServer DocService
- ONLYOFFICE DocumentServer Spellchecker

En utilisant le script fourni dans le package

Configuration de MultiGest

Pour utiliser OnlyOffice dans Multigest il est nécessaire de modifier le paramétrage de MultiGest.

Aller dans le serveur de Multigest

Ouvrir le fichier [INSTALL_DIR]\Multigest\bin\webserveur.ini et ajouter les sections ci-dessous si elles n’existent pas.

Section PACKVISIO

[PACKVISIO]
PDF_HTML5=

Paramètre à prendre en compte lorsque Internent Explorer est utilisé pour la modification des documents.

Valeurs proposées :

0 : Visionneuse PDF-XChange Viewer – Utilisation des ActiveX du navigateur Uniquement Internet Explorer. (Valeur par défaut)
1 : Visionneuse PDFTron

PDF_BUILDIN_VIEWER=

Détermine la visionneuse à utiliser lorsque l’utilisateur ne possède pas le pack collaboratif.

0 : Visionneuse par défaut du navigateur
1 : Visionneuse intégrée à Multigest – pdfJS (Valeur par défaut)

PDF_DEFAULT_READONLY=

Détermine le mode d’ouverture par défaut de la visionneuse:

0 : Ouverture du document en mode modification (Mode Edition) activée
1 : Ouverture du document en mode modification désactivée par défaut pour tous les navigateurs [PDF_BUILDIN_VIEWER] (Valeur par défaut)
2 : Ouverture du document en mode modification désactivée si la visionneuse PDFTron est utilisée [PDF_HTML5]=1. Si la visionneuse utilisée est PDF-XChange Viewer est utilisée [PDF_HTML5]=0 ouverture du document en mode modification activée

OFFICE_HTML5= 0 ou 1

Paramètre à prendre en compte lorsque Internent Explorer est utilisé pour la modification des documents.

Valeurs proposées :

0 : Visionneuse PDF-XChange Viewer – Utilisation des ActiveX du navigateur Uniquement Internet Explorer

1 : Visionneuse OnlyOffice (valeur par défaut)

OFFICE_OCX_HTML= 0 ou 1

Paramètre à prendre en compte lorsque Internent Explorer est utilisé pour la modification des documents

0 : Ouverture du document bureautique bloquée si annulation du choix de remplacement du document office dans la visionneuse ActiveX.

1 (valeur par défaut) : Ouverture du document bureautique dans un nouvel onglet en mode téléchargement si annulation du choix de remplacement du document office dans la visionneuse ActiveX.

Section MGMULTIVIEWER

[MGMULTIVIEWER]
PDFTRON_STAMP_PATH=

Répertoire de stockage des tampons Ex : C:\Program Files\Multigest\stamps

PDFTRON_STAMP_EXT=

Extensions autorisées pour les tampons Ex : png;jpg;jpeg

ONLY_OFFICE_PROXY_REDIRECT=officeviewer

Nom du dossier url pour la redirection OnlyOffice (ex : officeviewer pour l’url http://localhost/officeviewer) pour une utilisation de la redirection en multi-domaine et/ou multi-port

Suite à la modification de la configuration le fichier webserveur.ini pourrait avoir le contenu suivant: