Instalación de ONLYOFFICE Apps Enterprise con parámetros adicionales de script
Introducción
ONLYOFFICE Apps Enterprise es una versión de pago de un centro de documentos donde puedes conectar usuarios y documentos en un solo lugar para mejorar la colaboración.
ONLYOFFICE Apps Enterprise se distribuye como un script de instalación automática para sistemas operativos Linux con Docker instalado. El script configurará contenedores Docker con todos los componentes necesarios para el correcto funcionamiento de ONLYOFFICE Apps Enterprise y es fácil de ejecutar, gestionar y actualizar.
Después de descargar el script de instalación de ONLYOFFICE Apps Enterprise, es posible que necesites ejecutarlo especificando algunos parámetros adicionales, por ejemplo, si quieres instalar cada componente en una máquina distinta.
Usa el siguiente comando para mostrar la lista de todos los parámetros disponibles del script Docker:
bash apps-enterprise-install.sh docker -h
Usa el siguiente comando para mostrar la lista de todos los parámetros disponibles del script DEB/RPM:
bash apps-enterprise-install.sh package -h
A continuación puedes encontrar una breve descripción y algunos ejemplos de uso de estos parámetros.
Cuando ejecutes el script con parámetros, se te pedirá que selecciones la forma en que quieres instalar ONLYOFFICE Apps. Escribe Y y pulsa Enter para instalar ONLYOFFICE Apps usando Docker. Escribe N y pulsa Enter para instalar ONLYOFFICE Apps desde paquetes DEB/RPM.
Credenciales
| Parámetro | Descripción |
|---|---|
-reg, --registry | URL del registro de Docker (por ejemplo, https://myregistry.com:5000) |
-un, --username | inicio de sesión del registro de Docker |
-p, --password | contraseña del registro de Docker |
Estos parámetros se utilizan en caso de que te proporcionemos credenciales para acceder a un repositorio de prueba, de modo que puedas ejecutar contenedores a partir de las imágenes almacenadas en él.
Ejemplo
bash apps-enterprise-install.sh -reg URL -un username -p password
Tipo de instalación
| Parámetro | Descripción | Valores | Por defecto |
|---|---|---|---|
-it, --installationtype | tipo de instalación | community|developer|enterprise | enterprise |
Este parámetro te permite instalar la solución especificada: ONLYOFFICE Apps Community, ONLYOFFICE Apps Developer o ONLYOFFICE Apps Enterprise.
Ejemplo
bash apps-enterprise-install.sh -it community
Esto instalará la solución ONLYOFFICE Apps Community.
Verificación de hardware
| Parámetro | Descripción | Valores | Por defecto |
|---|---|---|---|
-skiphc, --skiphardwarecheck | usar para omitir la verificación de hardware | true|false | false |
Este parámetro te permite omitir la comprobación de si el sistema cumple con los requisitos mínimos de hardware.
Ejemplo
bash apps-enterprise-install.sh -skiphc true
Esto omitirá la verificación de hardware.
Actualización de componentes
| Parámetro | Descripción | Valores | Por defecto |
|---|---|---|---|
-u, --update | usar para actualizar los componentes existentes | true|false | false |
Este parámetro te permite instalar las últimas versiones de los componentes necesarios si los componentes correspondientes instalados en tu máquina están desactualizados.
Ejemplo
bash apps-enterprise-install.sh -u true
Esto detendrá consecutivamente los contenedores que necesiten actualizarse, los eliminará y luego ejecutará las últimas versiones de los componentes correspondientes de ONLYOFFICE Apps Enterprise. Si la versión actual del componente coincide con la última disponible, dicho contenedor no se verá afectado. Si omitiste algunos componentes durante la instalación anterior, también se omitirán. Los datos de ONLYOFFICE Apps deberían recogerse automáticamente.
Actualizar Docs solo a la versión 7.2.1.34 y omitir la actualización de todos los demás componentes:
bash apps-enterprise-install.sh -u true -docsi onlyoffice/documentserver-ee -docsv 7.2.1.34 -idocs true -ia false -irbt false -irds false
Actualizar ONLYOFFICE Apps solo a la versión 1.2.0 y omitir la actualización de todos los demás componentes:
bash apps-enterprise-install.sh -u true -asv v1.2.0 -idocs false -irbt false -irds false
Instalación de componentes
| Parámetro | Descripción | Valores | Por defecto |
|---|---|---|---|
-ia, --installapps | instalar ONLYOFFICE Apps | true|false | true |
-idocs, --installdocs | instalar ONLYOFFICE Docs | true|false | true |
-irbt, --installrabbitmq | instalar RabbitMQ | true|false | true |
-irds, --installredis | instalar Redis | true|false | true |
-imysql, --installmysql | instalar MySQL | true|false | true |
Estos parámetros te permiten especificar si necesitas instalar un determinado componente o no. Se pueden usar si quieres instalar cada componente en una máquina distinta.
- Usa el valor
truepara instalar un componente. - Usa el valor
falsepara omitir la instalación de un componente.
Ejemplo
bash apps-enterprise-install.sh -idocs false
Esto instalará todos los componentes de ONLYOFFICE Apps Enterprise sin ONLYOFFICE Docs.
bash apps-enterprise-install.sh -ia false -idocs true -imysql false -irbt false -irds false
Esto omitirá la instalación de ONLYOFFICE Apps, MySQL, RabbitMQ y Redis e instalará solo ONLYOFFICE Docs.
Versión del componente
| Parámetro | Descripción |
|---|---|
-asv, --appsversion | versión de ONLYOFFICE Apps |
-docsv, --docsversion | versión de ONLYOFFICE Docs |
Estos parámetros se pueden usar para instalar una determinada versión de ONLYOFFICE Apps o ONLYOFFICE Docs si por alguna razón no quieres instalar la última versión disponible en el repositorio. Por defecto, se utiliza una imagen etiquetada como latest para ejecutar el contenedor del componente.
Ejemplo
Abre el repositorio de Docker Hub en tu navegador, selecciona ONLYOFFICE Docs y ve a la pestaña Tags para ver todas las etiquetas disponibles en el repositorio. Especifica la versión que quieres instalar:
bash apps-enterprise-install.sh -docsv 7.2.1.34
Esto instalará ONLYOFFICE Apps con la versión 7.2.1.34 de ONLYOFFICE Docs.
Nombre de la imagen de ONLYOFFICE Docs
| Parámetro | Descripción |
|---|---|
-docsi, --docsimage | nombre de la imagen de ONLYOFFICE Docs |
Este parámetro se puede usar para especificar el nombre de la imagen de ONLYOFFICE Docs desde la que se debe iniciar un contenedor. La imagen especificada debe estar almacenada en nuestro repositorio público oficial en Docker Hub.
Ejemplo
bash apps-enterprise-install.sh -docsi onlyoffice/documentserver-ee
Esto ejecutará un contenedor a partir de la imagen de ONLYOFFICE Docs especificada almacenada en el repositorio.
Configuración para hosts
| Parámetro | Descripción |
|---|---|
-ash, --appshost | host de ONLYOFFICE Apps |
-esh, --elastichost | hosts de OpenSearch |
Estos parámetros se pueden usar para conectar los componentes si los instalas en máquinas distintas.
Ejemplo
bash apps-enterprise-install.sh -esh 192.168.3.202
Esto instalará ONLYOFFICE Apps y lo conectará con OpenSearch instalado en una máquina diferente que tiene la dirección IP 192.168.3.202.
Configuración para core.machinekey
| Parámetro | Descripción |
|---|---|
-mk, --machinekey | configuración de la clave core.machinekey |
Este parámetro te permite especificar tu propia machinekey al instalar ONLYOFFICE Apps Enterprise.
Este parámetro se escribe en el archivo de configuración /app/onlyoffice/config/appsettings.json (la ruta se especifica dentro del contenedor onlyoffice-studio).
Ejemplo
bash apps-enterprise-install.sh -mk yourmachinekey
Puerto externo de ONLYOFFICE Apps
| Parámetro | Descripción | Por defecto |
|---|---|---|
-ep, --externalport | puerto externo de ONLYOFFICE Apps | 80 |
Este parámetro te permite cambiar el puerto en el que se ejecutará ONLYOFFICE Apps. Por defecto, se utiliza el puerto 80.
Ejemplo
bash apps-enterprise-install.sh -ep 8080
Configuraciones para el encabezado y secreto JWT
| Parámetro | Descripción |
|---|---|
-jh, --jwtheader | configuración del encabezado JWT |
-js, --jwtsecret | configuración de la clave secreta JWT |
Estos parámetros te permiten especificar el encabezado JWT y tu propia clave secreta JWT al instalar ONLYOFFICE Apps Enterprise. El encabezado JWT define el encabezado http que se utilizará para enviar el JWT. La clave secreta se utiliza para firmar el token web JSON y validar el token en la solicitud a ONLYOFFICE Docs.
Estos parámetros se escriben en los siguientes archivos de configuración (las rutas se especifican dentro de los contenedores onlyoffice-studio y onlyoffice-document-server):
- Para ONLYOFFICE Apps -
/app/onlyoffice/config/appsettings.json - Para Document Server -
/etc/onlyoffice/documentserver/local.json
Ejemplo
bash apps-enterprise-install.sh -js yoursecret
Servidor MySQL
| Parámetro | Descripción | Por defecto |
|---|---|---|
-mysqlrp, --mysqlrootpassword | contraseña de root del servidor MySQL | generado automáticamente |
-mysqlh, --mysqlhost | host del servidor MySQL | localhost |
-mysqlport, --mysqlport | número de puerto del servidor MySQL | 3306 |
Si no especificas explícitamente el host y el puerto, se utilizan los valores por defecto. La contraseña de root se genera automáticamente si no la estableces.
Ejemplo
bash apps-enterprise-install.sh -mysqlrp new-secret-pw
Este comando te permite establecer tu propia contraseña para la cuenta root de MySQL durante la instalación de ONLYOFFICE Apps Enterprise.
Base de datos de ONLYOFFICE Apps
| Parámetro | Descripción | Por defecto |
|---|---|---|
-mysqld, --mysqldatabase | nombre de la base de datos de ONLYOFFICE Apps | onlyoffice_apps |
-mysqlu, --mysqluser | usuario de la base de datos de ONLYOFFICE Apps | - |
-mysqlp, --mysqlpassword | contraseña de la base de datos de ONLYOFFICE Apps | generado automáticamente |
Estos parámetros te permiten crear la base de datos de ONLYOFFICE Apps especificando un nombre de base de datos personalizado, así como un nombre de usuario y una contraseña para la cuenta con permisos de superusuario en la base de datos creada. Si no especificas explícitamente el nombre de la base de datos, se utiliza el valor por defecto. Si no estableces una contraseña, se genera automáticamente.
Ejemplo
bash apps-enterprise-install.sh -mysqld appsdatabase -mysqlu username -mysqlp password
Servidor RabbitMQ
| Parámetro | Descripción | Por defecto |
|---|---|---|
--rabbitmqprotocol | protocolo de conexión de RabbitMQ | amqp |
--rabbitmqhost | host del servidor RabbitMQ | localhost |
--rabbitmqport | número de puerto del servidor RabbitMQ | 5672 |
--rabbitmqusername | nombre de usuario de RabbitMQ | - |
--rabbitmqpassword | contraseña del usuario de RabbitMQ | - |
--rabbitmqvirtualhost | host virtual de RabbitMQ | / |
Usa estos parámetros para conectar ONLYOFFICE Apps a un servidor RabbitMQ que ya se está ejecutando en otra máquina. Omite la instalación de RabbitMQ con el parámetro -irbt false y luego especifica los parámetros de conexión de tu propio servidor. Si no especificas explícitamente el protocolo, el host, el puerto o el host virtual, se utilizan los valores por defecto.
Ejemplo
bash apps-enterprise-install.sh -irbt false --rabbitmqhost mq.example.com --rabbitmqusername username --rabbitmqpassword password
Esto instalará ONLYOFFICE Apps sin RabbitMQ y lo conectará al servidor RabbitMQ que se ejecuta en el host mq.example.com.
Servidor Redis
| Parámetro | Descripción | Por defecto |
|---|---|---|
--redishost | host del servidor Redis | localhost |
--redisport | número de puerto del servidor Redis | 6379 |
--redisusername | nombre de usuario de Redis, si el servidor requiere autorización | - |
--redispassword | contraseña del usuario de Redis, si el servidor requiere autorización | - |
Usa estos parámetros para conectar ONLYOFFICE Apps a un servidor Redis que ya se está ejecutando en otra máquina. Omite la instalación de Redis con el parámetro -irds false y luego especifica los parámetros de conexión de tu propio servidor. El nombre de usuario y la contraseña solo son necesarios si tu servidor Redis requiere autorización.
Ejemplo
bash apps-enterprise-install.sh -irds false --redishost redis.example.com --redispassword password
Esto instalará ONLYOFFICE Apps sin Redis y lo conectará al servidor Redis que se ejecuta en el host redis.example.com.
Servidor OpenSearch
| Parámetro | Descripción | Por defecto |
|---|---|---|
--elasticprotocol | protocolo de conexión de OpenSearch | http |
--elasticport | número de puerto del servidor OpenSearch | 9200 |
Usa estos parámetros junto con el parámetro -esh, --elastichost descrito en la sección Configuración para hosts anterior para conectar ONLYOFFICE Apps a un servidor OpenSearch que se ejecuta en otra máquina. Si no especificas explícitamente el protocolo y el puerto, se utilizan los valores por defecto.
Ejemplo
bash apps-enterprise-install.sh -esh search.example.com --elasticprotocol https --elasticport 9200
Esto conectará ONLYOFFICE Apps al servidor OpenSearch que se ejecuta en el host search.example.com mediante HTTPS.
Cambio a HTTPS
| Parámetro | Descripción |
|---|---|
-led, --letsencryptdomain | define el dominio para el certificado de Let's Encrypt |
-lem, --letsencryptmail | define la dirección de correo del administrador del dominio para el certificado de Let's Encrypt |
-cf, --certfile | ruta al archivo de certificado del dominio |
-ckf, --certkeyfile | ruta al archivo de clave privada del certificado |
Estos parámetros te permiten cambiar el espacio de trabajo a HTTPS. Solo se pueden usar para la versión de Docker.
Ejemplo
bash apps-enterprise-install.sh docker --letsencryptmail user@example.com --letsencryptdomain yourdomain.com
Esto creará e instalará automáticamente el certificado firmado por la CA de letsencrypt.org en tu servidor y reiniciará el servicio NGINX para que los cambios surtan efecto.
bash apps-enterprise-install.sh docker --certfile path --certkeyfile path
Esto aplicará tu propio certificado SSL.