Aller au contenu principal

Installer ONLYOFFICE Docs sous CentOS ou RHEL sur l'architecture de type ARM 64-bit

Introduction​

Ce guide vous explique comment installer ONLYOFFICE Docs Édition Communauté version Linux 7.1 et versions ultérieures sous CentOS Stream 9 et 10, ainsi que RHEL 8, 9 et 10 sur l'architecture arm64. Pour la liste complète des fonctionnalités disponibles, consultez la présentation des éditions d'ONLYOFFICE Docs. Si vous utilisez ONLYOFFICE Workspace, l'installation de Docs vous permettra également de partager des fichiers, de gérer les droits d'accès, d'intégrer des documents et de modifier des fichiers stockés dans les stockages cloud connectés.

Configuration requise​

  • Processeur : processeurs ARM 64 bits
  • RAM : au moins 2 Go, selon le système d'exploitation hôte. Plus est préférable
  • Disque dur : au moins 40 Go d'espace libre
  • SWAP : au moins 4 Go, selon le système d'exploitation hôte. Plus est préférable
  • Système d'exploitation : CentOS Stream 9 ou 10, RHEL 8, RHEL 9 ou RHEL 10 sur arm64
  • Prérequis supplémentaires
    • NGINX : version 1.30 ou ultérieure

Installation des dépendances​

Installer la version à jour du paquet NGINX​

Pour configurer le dépôt yum pour RHEL/CentOS, créez le fichier /etc/yum.repos.d/nginx.repo avec le contenu suivant :

[nginx-stable]
name=nginx stable repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=1
enabled=1
gpgkey=https://nginx.org/keys/nginx_signing.key
module_hotfixes=true

Installez NGINX :

sudo yum install nginx

Supprimez le fichier suivant :

sudo rm /etc/nginx/conf.d/default.conf

Instructions officielles

Modifiez ensuite le fichier de configuration NGINX /etc/nginx/nginx.conf pour qu'il corresponde au contenu suivant :

user                  nginx;
worker_processes      1;
error_log             /var/log/nginx/error.log warn;
pid                   /var/run/nginx.pid;
events {
  worker_connections  1024;
}
http {
  include             /etc/nginx/mime.types;
  default_type        application/octet-stream;
  log_format          main  '$remote_addr - $remote_user [$time_local] "$request" '
                            '$status $body_bytes_sent "$http_referer" '
                            '"$http_user_agent" "$http_x_forwarded_for"';
  access_log          /var/log/nginx/access.log  main;
  sendfile            on;
  #tcp_nopush         on;
  keepalive_timeout   65;
  #gzip               on;
  include             /etc/nginx/conf.d/*.conf;
}
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.

Installer le dépôt EPEL​

sudo yum install epel-release

Pour installer EPEL sur CentOS 9, utilisez les commandes suivantes :

sudo yum config-manager --set-enabled crb
sudo yum install epel-release epel-next-release

Pour installer EPEL sur RHEL, utilisez les commandes suivantes :

sudo subscription-manager repos --enable codeready-builder-for-rhel-$REV-$(arch)-rpms
sudo yum -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-$REV.noarch.rpm

Remplacez manuellement $REV par la version de votre système d'exploitation (8 pour les versions 8.x, 9 pour les versions 9.x, etc.).

Installer ONLYOFFICE Docs​

Ajout du dépôt ONLYOFFICE Docs​

Ajoutez le dépôt yum ONLYOFFICE Docs à l'aide de la commande suivante :

sudo yum install https://download.onlyoffice.com/repo/centos/main/noarch/onlyoffice-repo.noarch.rpm

Commandes d'installation d'ONLYOFFICE Docs​

Exécutez la commande suivante pour l'édition Communauté :

sudo yum install onlyoffice-documentserver

Démarrez le service nginx et activez son lancement au démarrage :

sudo service nginx start
sudo systemctl enable nginx

ONLYOFFICE Docs s'exécutera alors en tant que processus. Le paquet sera mis à jour comme tout autre paquet rpm.

Mettre à jour ONLYOFFICE Docs​

Pour mettre à jour ONLYOFFICE Docs, exécutez la commande suivante :

sudo yum update onlyoffice-documentserver
Important

Sur RHEL 8 et ses dérivés, l'exécution de yum update avec le dépôt ONLYOFFICE activé peut échouer en raison d'une erreur de dépendance.

Pour éviter cela, excluez ces paquets du dépôt ONLYOFFICE afin qu'ils soient pris en charge par le dépôt AppStream du système :

echo "excludepkgs=xorg-x11-server-Xvfb,xorg-x11-server-common" >> /etc/yum.repos.d/onlyoffice.repo

Il suffit d'exécuter cette commande une seule fois. Ensuite, yum update fonctionnera correctement.

Si vous avez installé ONLYOFFICE Docs via OneClick Install, cette exclusion est déjà appliquée automatiquement.

Modifier le port par défaut d'ONLYOFFICE Docs​

Par défaut, ONLYOFFICE Docs écoute les connexions entrantes sur le port 8083. À partir de la version 4.3, vous pouvez modifier le port d'ONLYOFFICE Docs si vous souhaitez en utiliser un autre.

remarque

Si vous modifiez le port par défaut, assurez-vous qu'il est ouvert pour les connexions entrantes et sortantes. Consultez la liste complète des ports utilisés par ONLYOFFICE Docs.

Pour ce faire, vous devez modifier la variable d'environnement DS_PORT en exécutant la commande suivante :

export DS_PORT=<PORT_NUMBER>

Remplacez <PORT_NUMBER> par le numéro de port souhaité 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 la version à jour du paquet NGINX.

Avertissement

Si vous souhaitez passer le protocole d'ONLYOFFICE Docs en HTTPS, ne modifiez pas le port en 443, mais suivez ces instructions.

Vous pouvez ensuite poursuivre la configuration d'ONLYOFFICE Docs.

Configurer ONLYOFFICE Docs​

Exécuter le script de configuration​

Exécutez le script documentserver-configure :

bash documentserver-configure

Ajouter une exception de pare-feu​

sudo firewall-cmd --zone=public --add-port=8083/tcp --permanent
sudo firewall-cmd --reload

Désactiver SELinux​

remarque

Obsolète depuis la v.5.0

Ouvrez le fichier /etc/selinux/config dans un éditeur de texte, remplacez la ligne SELINUX=enforcing ou SELINUX=permissive par SELINUX=disabled, puis enregistrez les modifications.

Redémarrez votre serveur pour que les modifications prennent effet.

Lancer ONLYOFFICE Docs dans un navigateur​

Une fois la configuration terminée, saisissez http://localhost:8083 dans la barre d'adresse de votre navigateur pour accéder à la page d'accueil d'ONLYOFFICE Docs, où vous trouverez des instructions supplémentaires sur la façon d'activer les exemples de documents ou d'intégrer les éditeurs en ligne dans votre application web à l'aide de l'API fournie.