Installer ONLYOFFICE Workspace Enterprise en utilisant les paramètres supplémentaires de script

Introduction

ONLYOFFICE Workspace Entreprise est une version payante du système collaboratif conçu pour gérer des documents, des projets, des relations avec les clients et des courriels, tous réunis en un seul endroit.

ONLYOFFICE Workspace Entreprise est distribué sous la forme d'un script d'installation automatique pour les systèmes d'exploitation Linux disposant de Docker. Le script configure des conteneurs Docker avec tous les composants nécessaires au bon fonctionnement de ONLYOFFICE Workspace Entreprise et est facile à exécuter, à gérer et à mettre à jour.

Une fois le script d'installation de ONLYOFFICE Workspace Entreprise téléchargé, il peut être nécessaire de l'exécuter avec des paramètres supplémentaires, par exemple pour installer chaque composant sur un serveur distinct. Utilisez la commande suivante pour afficher la liste de tous les paramètres disponibles du script:

bash workspace-enterprise-install.sh -h

Vous trouverez ci-dessous une courte description et quelques exemples d'utilisation de ces paramètres.

Nom de l'image

ParamètreDescription
-ci, --communityimageNom de l'image ONLYOFFICE Serveur Communauté ou chemin d'accès au fichier .tar.gz
-di, --documentimageNom de l'image ONLYOFFICE Docs ou chemin d'accès au fichier .tar.gz
-mi, --mailimageNom de l'image ONLYOFFICE Mail ou chemin d'accès au fichier .tar.gz
-cpi, --controlpanelimageNom de l'image Panneau de configuration ONLYOFFICE ou chemin d'accès au fichier .tar.gz

Ces paramètres indiquent le nom de l'image à partir de laquelle un conteneur doit être démarré. L'image indiquée doit être disponible dans le dépôt public officiel sur Docker Hub. Si vous avez téléchargé l'archive au format .tar.gz sur la page Téléchargement, vous pouvez également indiquer le chemin d'accès à ce fichier .tar.gz stocké sur votre ordinateur.

Exemple
bash workspace-enterprise-install.sh -ims false -di onlyoffice/documentserver-ee -ics true -icp true

Cela démarrera un conteneur à partir de l'image ONLYOFFICE Docs indiquée, stockée dans le dépôt, ainsi que les conteneurs ONLYOFFICE Serveur Communauté et Panneau de configuration ONLYOFFICE.

bash workspace-enterprise-install.sh -ims false -ics true -ci "/home/user/CommunityServer-12.5.2.tar.gz" -ids false -icp true

Cela démarrera un conteneur à partir du fichier .tar.gz local contenant l'image ONLYOFFICE Serveur Communauté, ainsi que le conteneur Panneau de configuration ONLYOFFICE à partir de l'image stockée dans le dépôt Docker Hub.

Version des composants

ParamètreDescription
-cv, --communityversionVersion ONLYOFFICE Serveur Communauté
-dv, --documentversionVersion ONLYOFFICE Docs
-mv, --mailversionVersion ONLYOFFICE Mail
-cpv, --controlpanelversionVersion Panneau de configuration ONLYOFFICE

Ces paramètres permettent d'installer une version spécifique d'un composant si vous ne souhaitez pas utiliser la version la plus récente disponible dans le dépôt. Par défaut, une image portant l'étiquette latest est utilisée pour démarrer chaque conteneur de composant.

Exemple

Ouvrez le dépôt Docker Hub dans votre navigateur, sélectionnez le composant nécessaire et passez à l'onglet Tags pour afficher tous les tags disponibles dans le dépôt. Indiquez la version à installer pour les composants nécessaires:

bash workspace-enterprise-install.sh -ics true -cv 8.9.0.150 -ids false -icp true -cpv 1.6.0.52 -ims true -md "yourdomain.com"

Cela va installer la version 8.9.0.150 de ONLYOFFICE Serveur Communauté, la version 1.6.0.52 de Panneau de configuration ONLYOFFICE et la version la plus récente de ONLYOFFICE Mail, car la version n'est pas précisée.

IP du serveur

ParamètreDescription
-dip, --documentserveripAdresse IP ONLYOFFICE Docs
-mip, --mailserveripAdresse IP ONLYOFFICE Mail
-mdbip, --mailserverdbipAdresse IP de la base de données ONLYOFFICE Mail

Ces paramètres servent à connecter les composants lorsque vous les installez sur des ordinateurs distincts.

Exemple
bash workspace-enterprise-install.sh -ics true -icp true -ids false -ims false -dip 192.168.3.202 -es false

Cela va installer ONLYOFFICE Serveur Communauté avec Panneau de configuration ONLYOFFICE et les connecter avec ONLYOFFICE Docs installé sur un autre ordinateur avec l'adresse IP 192.168.3.202.

Nom du domaine ONLYOFFICE Mail

ParamètreDescription
-md, --maildomainLe nom du domaine ONLYOFFICE Mail

Ce paramètre permet de définir le nom de votre domaine qui sera utilisé pour ONLYOFFICE Mail.

Exemple
bash workspace-enterprise-install.sh -md "yourdomain.com"

Cela va installer tous les composants ONLYOFFICE Workspace Entreprise y compris ONLYOFFICE Mail avec le nom de domaine yourdomain.com.

Votre domaine sera utilisé pour assurer la correspondance, alors il doit être validé et configuré pour un certain ordinateur (c-à-d l'enregistrement A du DNS doit être utilisé pour indiquer que le nom de domaine correspond à l'adresse IP de l'ordinateur sur lequel ONLYOFFICE Mail est installé).
Dans la commande ci-dessus, le paramètre "yourdomain.com" doit être considéré comme le domaine de service pour ONLYOFFICE Mail. Il est généralement indiqué dans l'enregistrement MX du domaine qui sera utilisé pour assurer la correspondance. En règle générale, "yourdomain.com" apparaît comme mx1.onlyoffice.com

Mise à jour des composants

ParamètreDescriptionValeursDéfaut
-u, --updatesert à mettre à jour les composants existantstrue|falsefalse

Ce paramètre sert à installer les versions les plus récentes des composants obsolètes sur votre ordinateur.

Exemple
bash workspace-enterprise-install.sh -u true

Cela arrêtera les conteneurs à mettre à jour, les supprimera, puis démarrera les dernières versions des composants ONLYOFFICE Workspace Entreprise correspondants. Les conteneurs dont la version actuelle correspond à la dernière version disponible ne seront pas affectés. Les composants ignorés lors de l'installation précédente seront également ignorés. Les données du portail seront automatiquement préservées.

Informations d'identification

ParamètreDescription
-un, --usernamenom d'utilisateur dockerhub
-p, --passwordmot de passe dockerhub

Ces paramètres sont utilisés lorsque des identifiants vous sont fournis pour accéder à un dépôt de test, ce qui vous permet d'exécuter des conteneurs à partir des images qui y sont stockées.

Exemple
bash workspace-enterprise-install.sh -md "yourdomain.com" -un username -p password

Installation des composants

ParamètreDescriptionValeursDéfaut
-ics, --installcommunityserverinstaller ONLYOFFICE Serveur Communautétrue|false|pulltrue
-ids, --installdocumentserverinstaller ONLYOFFICE Docstrue|false|pulltrue
-ims, --installmailserverinstaller ONLYOFFICE Mailtrue|false|pulltrue
-icp, --installcontrolpanelinstaller Panneau de configuration ONLYOFFICEtrue|false|pulltrue

Ces paramètres permettent d'indiquer si un composant donné doit être installé. Ils permettent aussi d'installer chaque composant sur un serveur distinct.

  • Utilisez la valeur true pour installer un composant.
  • Utilisez la valeur false pour ignorer l'installation d'un composant.
  • Utilisez la valeur pull pour télécharger un composant sans l'installer.
Veuillez ne pas ignorer l'installation du Panneau de configuration ONLYOFFICE lors de l'installation de ONLYOFFICE Serveur Communauté ; sinon, vous ne pourrez pas saisir votre clé de licence une fois l'installation terminée, ni ajouter, par exemple, ONLYOFFICE Mail à votre instance ONLYOFFICE Workspace Entreprise.
Exemple
bash workspace-enterprise-install.sh -ims false 

Tous les composants de ONLYOFFICE Workspace Entreprise seront installés sauf ONLYOFFICE Mail.

bash workspace-enterprise-install.sh -ics false -ids true -icp false -ims false -es true 

C'est uniquement ONLYOFFICE Docs qui sera installé, ONLYOFFICE Mail, ONLYOFFICE Serveur Communauté et Panneau de configuration ONLYOFFICE seront ignorés.

Type d'installation

ParamètreDescriptionValeursDéfaut
-it, --installation_typetype d'installationWORKSPACE|WORKSPACE_ENTERPRISEWORKSPACE_ENTERPRISE

Ce paramètre sert à installer une solution spécifique: ONLYOFFICE Workspace Communauté ou ONLYOFFICE Workspace Entreprise.

Exemple
bash workspace-enterprise-install.sh -it WORKSPACE

Cela installera les composants ONLYOFFICE Serveur Communauté et Panneau de configuration ONLYOFFICE.

Utiliser un composant en tant que serveur externe

ParamètreDescriptionValeursDéfaut
-es, --useasexternalserverutiliser en tant que serveur externetrue|falsefalse

Ce paramètre est utilisé lors de l'installation des composants sur des ordinateurs distincts.

  • Utilisez la valeur true lors de l'installation de ONLYOFFICE Docs et ONLYOFFICE Mail sur des ordinateurs distincts.
  • Utilisez la valeur false lors de l'installation de ONLYOFFICE Serveur Communauté avec le Panneau de configuration ONLYOFFICE sur un ordinateur distinct.
Exemple
bash workspace-enterprise-install.sh -ics false -ids false -icp false -ims true -md "yourdomain.com" -es true

C'est uniquement ONLYOFFICE Mail qui sera installé, ONLYOFFICE Docs, ONLYOFFICE Serveur Communauté et Panneau de configuration ONLYOFFICE seront ignorés.

bash workspace-enterprise-install.sh -ics true -icp true -ids false -ims false -dip 192.168.3.202 -es false

Cela va installer ONLYOFFICE Serveur Communauté avec Panneau de configuration ONLYOFFICE et les connecter à ONLYOFFICE Docs installé sur un autre ordinateur.

Créer un fichier de pagination

ParamètreDescriptionValeursDéfaut
-ms, --makeswapgénérer un fichier de paginationtrue|falsefalse

Ce paramètre permet de créer un fichier de pagination de 6 Go. Par défaut, la valeur true est spécifiée : il n'est donc pas nécessaire d'indiquer ce paramètre lors de l'exécution du script. Le fichier de pagination sera créé automatiquement.

Exemple
bash workspace-enterprise-install.sh -ms false

Si vous avez déjà créé un fichier de pagination, vous pouvez utiliser cette commande pour empêcher la création automatique du fichier de pagination lors de l'installation.

Si vous démarrez le script encore une fois sans indiquer le paramètre -ms, il vérifie si le fichier onlyoffice_swapfile existe déjà. Si c'est le cas, le script ne créera pas de nouveau fichier de pagination.

Serveur MySQL

ParamètreDescriptionDéfaut
-mysqlh, --mysqlhostServeur hôte MySQLlocalhost
-mysqlprt, --mysqlportPort du serveur MySQL3306
-mysqlru, --mysqlrootuserUtilisateur root du serveur MySQLroot
-mysqlrp, --mysqlrootpasswordMot de passe root du serveur MySQLmy-secret-pw

Si vous ne définissez pas explicitement ces paramètres, les valeurs par défaut seront utilisées.

Exemple
bash workspace-enterprise-install.sh -mysqlru root -mysqlrp new-secret-pw

Cette commande permet de définir votre propre mot de passe pour le compte root MySQL lors de l'installation de ONLYOFFICE Workspace Entreprise.

Base de données ONLYOFFICE Serveur Communauté

ParamètreDescriptionDéfaut
-mysqld, --mysqldatabaseLe nom de la base de données ONLYOFFICE Serveur Communautéonlyoffice
-mysqlu, --mysqluserL'utilisateur de la base de données ONLYOFFICE Serveur Communautéonlyoffice_user
-mysqlp, --mysqlpasswordLe mot de passe de la base de données ONLYOFFICE Serveur Communautéonlyoffice_pass

Ces paramètres servent à créer une base de données ONLYOFFICE Serveur Communauté et définir le nom de la base de données, le nom d'utilisateur et le mot de passe pour un compte d'utilisateur qui possède tous les droits au niveau d'une base de données. Si vous ne définissez pas explicitement ces paramètres, les valeurs par défaut seront utilisées.

Exemple
bash workspace-enterprise-install.sh -mysqld communitydatabase -mysqlu username -mysqlp password

Base de données ONLYOFFICE Mail

ParamètreDescriptionDéfaut
-mysqlmd, --mysqlmaildatabaseLe nom de la base de données ONLYOFFICE Mailonlyoffice_mailserver
-mysqlmu, --mysqlmailuserL'utilisateur de la base de données ONLYOFFICE Mailmail_admin
-mysqlmp, --mysqlmailpasswordLe mot de passe de la base de données ONLYOFFICE MailIsadmin123

Ces paramètres servent à créer une base de données ONLYOFFICE Mail et définir le nom de la base de données, le nom d'utilisateur et le mot de passe pour un compte d'utilisateur qui possède tous les droits au niveau d'une base de données. Si vous ne définissez pas explicitement ces paramètres, les valeurs par défaut seront utilisées.

Exemple
bash workspace-enterprise-install.sh -md "mx.yourdomain.com" -mysqlmd maildatabase -mysqlmu username -mysqlmp password

Port pour ONLYOFFICE Serveur Communauté

ParamètreDescriptionDéfaut
-cp, --communityportPort pour ONLYOFFICE Serveur Communauté80

Ce paramètre sert à modifier le port à utiliser pour démarrer ONLYOFFICE Serveur Communauté. Par défaut, le port 80 est utilisé.

Exemple
bash workspace-enterprise-install.sh -cp 8080

Configuration pour core.machinekey

ParamètreDescription
-mk, --machinekeyLa configuration pour la clé core.machinekey

Ce paramètre permet d'indiquer votre propre machinekey lors de l'installation de ONLYOFFICE Workspace Entreprise.

Ce paramètre est inclus dans le fichier de configuration /app/onlyoffice/CommunityServer/data/.private/machinekey.
Exemple
bash workspace-enterprise-install.sh -mk yourmachinekey

Configuration pour la clé secrète JWT

ParamètreDescription
-jwt, --jwtsecretLa configuration pour la clé secrète du JWT

Ce paramètre permet d'indiquer votre propre clé secrète JWT lors de l'installation de ONLYOFFICE Workspace Entreprise. La clé secrète est utilisée pour signer le jeton JSON Web (JWT) et valider ce jeton lors des requêtes adressées à ONLYOFFICE Docs.

Ce paramètre est inscrit dans les fichiers de configuration suivants (les chemins sont indiqués pour les conteneurs):
  • Pour le Serveur Communauté - /var/www/onlyoffice/WebStudio/web.appsettings.config
  • Pour ONLYOFFICE Docs - /etc/onlyoffice/documentserver/local.json
Exemple
bash workspace-enterprise-install.sh -jwt yoursecret
Articles avec le tag :
Parcourir tous les tags