Aller au contenu principal

Installer ONLYOFFICE Docs Édition Entreprise sous Debian, Ubuntu et ses dérivés

Introduction​

Édition Entreprise vous permet d'installer ONLYOFFICE Docs sur votre serveur local et d'intégrer les éditeurs en ligne dans la plateforme collaborative ONLYOFFICE ou dans d'autres systèmes populaires (consultez la liste détaillée des fonctionnalités). Ce guide vous explique comment installer la version Linux d'ONLYOFFICE Docs Édition Entreprise sur votre ordinateur.

Configuration système minimale​

  • Processeur: double cœur à 2 GHz ou plus
  • Mémoire RAM: au moins 2 Go, mais cela dépend du système d'exploitation hôte. Plus il y en a, mieux c'est
  • HDD: d'au moins 40 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: Debian, Ubuntu édition 64 bits ou une autre version compatible basée sur le noyau 3.13 ou version ultérieure
  • Exigences supplémentaires
    • PostgreSQL: version 12.9 ou ultérieure
    • NGINX: version 1.3.13 ou version ultérieure
    • libstdc++6: version 4.8.4 ou version ultérieure
    • Redis: version 4 ou version ultérieure
    • RabbitMQ

Installer ONLYOFFICE Docs​

L'installation sur les distributions Debian requiert également la présence de libstdc++6, NGINX et PostgreSQL sur le système.

Toutes les instructions d'installation nécessaires pour ces composants et leurs dépendances sont disponibles sur leurs sites officiels.

Les dépendances suivantes sont installées avec ONLYOFFICE Docs :

  • libcurl3
  • libxml2
  • fonts-dejavu
  • fonts-liberation
  • ttf-mscorefonts-installer
  • fonts-crosextra-carlito
  • fonts-takao-gothic
  • fonts-opensymbol

Ces dépendances sont installées automatiquement sur Ubuntu 14.04 LTS ou version ultérieure. Les distributions plus anciennes peuvent nécessiter une installation manuelle.

Installer des dépendances​

ONLYOFFICE Docs utilise NGINX et PostgreSQL en tant que base de données. Les dépendances disponibles dans le dépôt du système seront installées automatiquement lors de l'installation d'ONLYOFFICE Docs à l'aide de la commande apt-get install.

Installer et configurer PostgreSQL​

Installez la version PostgreSQL incluse dans votre version d'Ubuntu :

sudo apt-get install postgresql
remarque

Si vous souhaitez installer une autre version PostgreSQL du dépôt PostgreSQL, veuillez consulter la documentation officielle PostgreSQL pour de plus amples renseignements.

Une fois PostgreSQL installé, créez la base de données et l'utilisateur PostgreSQL :

remarque

Le nom d'utilisateur de la base de données doit être onlyoffice. Vous pouvez indiquer n'importe quel mot de passe.

sudo -i -u postgres psql -c "CREATE USER onlyoffice WITH PASSWORD 'onlyoffice';"
sudo -i -u postgres psql -c "CREATE DATABASE onlyoffice OWNER onlyoffice;"

Installer Redis​

sudo apt-get install redis-server

Installer RabbitMQ​

sudo apt-get install rabbitmq-server

Installer NGINX​

sudo apt-get install nginx
remarque

Sur Ubuntu 18.04, installez plutôt le paquet nginx-extras : sudo apt-get install nginx-extras

Important

Si vous prévoyez d'exécuter ONLYOFFICE Docs sur le port 80, désactivez dès maintenant le site web NGINX par défaut. Sinon, ONLYOFFICE Docs risque de ne pas fonctionner correctement. Pour ce faire, exécutez les commandes suivantes :

sudo mv -f /etc/nginx/sites-enabled/default /etc/nginx/sites-available/default.disabled
sudo mv -f /etc/nginx/conf.d/default.conf /etc/nginx/conf.d/default.conf.disabled
sudo systemctl is-active --quiet nginx && sudo systemctl reload nginx || sudo systemctl start nginx

Selon la manière dont NGINX a été installé, l'une des deux premières commandes peut signaler que le fichier n'existe pas. Vous pouvez ignorer ce message.

remarque

Les versions des distributions Ubuntu inférieures à 14.04 LTS peuvent nécessiter l'installation d'autres dépendances.

Changer le port par défaut pour ONLYOFFICE Docs​

Par défaut, ONLYOFFICE Docs écoute les connexions entrantes sur le port 8083. À partir de la version 4.3, vous pouvez changer le port pour ONLYOFFICE Docs si vous prévoyez d'en utiliser un autre à la place de celui par défaut.

remarque

Si vous allez changer le port par défaut, vérifiez si le port permet la communication entrant/sortant. Consultez la liste complète des ports utilisés par ONLYOFFICE Docs.

Pour ce faire, il faut remplacer le port par défaut pour le système debconf en exécutant la commande :

echo onlyoffice-documentserver-ee onlyoffice/ds-port select <PORT_NUMBER> | sudo debconf-set-selections

Veuillez saisir le numéro du port au lieu de <PORT_NUMBER> dans la commande ci-dessus.

remarque

Si vous définissez le port sur 80, assurez-vous d'avoir désactivé le site web NGINX par défaut comme décrit dans la section Installer NGINX.

Avertissement

Si vous voulez passer ONLYOFFICE Docs à HTTPS, ne remplacez pas le port par 443, mais veuillez suivre ces instructions.

Vous pouvez utiliser les options supplémentaires pendant l'installation d'ONLYOFFICE Docs. Veuillez consulter cette section pour plus de renseignements.

Ensuite, vous pouvez poursuivre l'installation d'ONLYOFFICE Docs.

Installer ONLYOFFICE Docs​

Ajoutez la clé GPG :

mkdir -p -m 700 ~/.gnupg
curl -fsSL https://download.onlyoffice.com/GPG-KEY-ONLYOFFICE | gpg --no-default-keyring --keyring gnupg-ring:/tmp/onlyoffice.gpg --import
chmod 644 /tmp/onlyoffice.gpg
sudo chown root:root /tmp/onlyoffice.gpg
sudo mv /tmp/onlyoffice.gpg /usr/share/keyrings/onlyoffice.gpg

Ajoutez le dépôt ONLYOFFICE Docs :

echo "deb [signed-by=/usr/share/keyrings/onlyoffice.gpg] https://download.onlyoffice.com/repo/debian squeeze main" | sudo tee /etc/apt/sources.list.d/onlyoffice.list
remarque

Le paquet APT basé sur Debian Squeeze est compatible avec un certain nombre de dérivés Debian (y compris Ubuntu), ce qui signifie que vous pouvez utiliser le même dépôt pour toutes ces distributions.

Lors de l'installation d'ONLYOFFICE Docs sur Debian, ajoutez le composant contrib à /etc/apt/sources.list. Pour en savoir plus, veuillez consulter la documentation Debian.

Mettez à jour le cache du gestionnaire de paquets :

sudo apt-get update

Installez mscorefonts :

sudo apt-get install ttf-mscorefonts-installer

Installez ONLYOFFICE Docs :

sudo apt-get install onlyoffice-documentserver-ee
remarque

Pendant l'installation, il vous sera demandé de fournir le mot de passe de l'utilisateur PostgreSQL onlyoffice. Veuillez saisir le mot de passe onlyoffice que vous avez indiqué lors de la configuration PostgreSQL.

Ensuite, ONLYOFFICE Docs est lancé en tant que processus. Le paquet sera mis à jour comme tout autre paquet deb.

Maintenant, vous pouvez saisir http://localhost:8083 dans la barre d'adresse du navigateur pour ouvrir la page d'accueil ONLYOFFICE Docs où vous trouverez des instructions détaillées sur l'activation des exemples de documents ou l'intégration des éditeurs en ligne dans votre application web à l'aide de l'API fournie.

Lancer ONLYOFFICE Docs à l'aide de HTTPS​

Dans la plupart des cas, l'accès au portail via le protocole HTTPS est beaucoup plus sûr que via le protocole HTTP qui est utilisé par défaut. Vous pouvez facilement exécuter ONLYOFFICE Docs en établissant une connexion sécurisée. Veuillez trouver plus de détails sur cette opération ici.

Enregistrer votre version de l'édition Entreprise​

Si vous avez acheté l'édition Entreprise et on vous a envoyé le fichier license.lic, vous pouvez placer ce fichier dans votre installation pour obtenir une version complète du logiciel.

Si vous êtes un utilisateur de Linux Debian, le fichier license.lic sera installé vers le dossier suivant :

/var/www/onlyoffice/Data/license.lic

Maintenant, votre version de l'édition Entreprise est une version complète et enregistrée.

Informations supplémentaires : plus d'options d'installation ONLYOFFICE Docs​

L'installation d'ONLYOFFICE Docs permet d'utiliser plus d'options debconf qui peuvent être utiles lors de l'installation de plusieurs serveurs ou dans d'autres cas.

Ces options incluent :

  • Options de la base de données PostgreSQL

    • Indiquez l'adresse de la base de données hôte PostgreSQL (remplacez <DB_HOST> par l'adresse actuelle du serveur PostgreSQL installé) :

      echo onlyoffice-documentserver-ee onlyoffice/db-host string <DB_HOST> | sudo debconf-set-selections

    • Indiquez le nom d'utilisateur de la base de données PostgreSQL (remplacez <DB_USER> par le nom d'utilisateur actuel qui a les permissions d'accès appropriées à la base de données PostgreSQL) :

      echo onlyoffice-documentserver-ee onlyoffice/db-user string <DB_USER> | sudo debconf-set-selections

    • Créez le mot de passe de l'utilisateur de la base de données PostgreSQL (remplacez <DB_PASSWORD> par le mot de passe actuel d'utilisateur qui a les permissions d'accès appropriées à la base de données PostgreSQL) :

      echo onlyoffice-documentserver-ee onlyoffice/db-pwd password <DB_PASSWORD> | debconf-set-selections

    • Indiquez le nom de la base de données PostgreSQL (remplacez <DB_NAME> par le nom actuel de la base de données PostgreSQL) :

      echo onlyoffice-documentserver-ee onlyoffice/db-name string <DB_NAME> | sudo debconf-set-selections

  • Options Redis

    • Indiquez l'adresse de l'hôte Redis (remplacez <REDIS_HOST> par l'adresse actuelle du serveur Redis installé) :

      echo onlyoffice-documentserver-ee onlyoffice/redis-host string <REDIS_HOST> | sudo debconf-set-selections

  • Options RabbitMQ

    • Indiquez l'adresse de l'hôte RabbitMQ (remplacez <RABBITMQ_HOST> par l'adresse actuelle du serveur RabbitMQ installé) :

      echo onlyoffice-documentserver-ee onlyoffice/rabbitmq-host string <RABBITMQ_HOST> | sudo debconf-set-selections

    • Indiquez le nom d'utilisateur RabbitMQ (remplacez <RABBITMQ_USER> par le nom d'utilisateur actuel qui a les permissions d'accès appropriées RabbitMQ) :

      echo onlyoffice-documentserver-ee onlyoffice/rabbitmq-user string <RABBITMQ_USER> | sudo debconf-set-selections

    • Indiquez le mot de passe de l'utilisateur RabbitMQ (remplacez <RABBITMQ_PWD> par le mot de passe actuel de l'utilisateur qui a les permissions d'accès appropriées RabbitMQ) :

      echo onlyoffice-documentserver-ee onlyoffice/rabbitmq-pwd password <RABBITMQ_PWD> | sudo debconf-set-selections

  • Options JWT

    Vous pouvez utiliser debconf-set-selections pour désactiver le remplacement des valeurs personnalisées dans le fichier local.json après la mise à jour d'ONLYOFFICE Docs.

    • Activez les jetons JSON (JWT) :

      echo onlyoffice-documentserver-ee onlyoffice/jwt-enabled boolean true | sudo debconf-set-selections

    • Créez la clé secrète JWT en remplaçant <JWT_SECRET> par votre propre valeur :

      echo onlyoffice-documentserver-ee onlyoffice/jwt-secret password <JWT_SECRET> | sudo debconf-set-selections