Instalando ONLYOFFICE Workspace Enterprise usando parâmetros adicionais do script
Introdução
ONLYOFFICE Workspace Enterprise é uma versão paga de um sistema colaborativo desenvolvido para gerenciar documentos, projetos, relacionamento com clientes e correspondência de e-mail, tudo em um só lugar.
ONLYOFFICE Workspace Enterprise é fornecido como um script de instalação automática para sistemas operacionais Linux com Docker instalado. O script configurará contêineres Docker com todos os componentes necessários para o funcionamento correto do ONLYOFFICE Workspace Enterprise e é fácil de executar, gerenciar e atualizar.
Após baixar o script de instalação do ONLYOFFICE Workspace Enterprise, pode ser necessário executá-lo especificando alguns parâmetros adicionais, por exemplo, se você deseja instalar cada componente em uma máquina separada. Use o seguinte comando para exibir a lista de todos os parâmetros de script disponíveis:
bash workspace-enterprise-install.sh -h
Você pode encontrar uma breve descrição e alguns exemplos de uso desses parâmetros abaixo.
Nome da imagem
| Parâmetro | Descrição |
|---|---|
-ci, --communityimage | Nome da imagem do ONLYOFFICE Community Server ou caminho do arquivo .tar.gz |
-di, --documentimage | Nome da imagem do ONLYOFFICE Docs ou caminho do arquivo .tar.gz |
-mi, --mailimage | Nome da imagem do ONLYOFFICE Mail ou caminho do arquivo .tar.gz |
-cpi, --controlpanelimage | Nome da imagem do ONLYOFFICE Control Panel ou caminho do arquivo .tar.gz |
Esses parâmetros podem ser usados para especificar o nome da imagem a partir da qual um contêiner deve ser iniciado. A imagem especificada deve estar armazenada em nosso repositório público oficial no Docker Hub. Se você baixou um arquivo .tar.gz da página de Downloads, também pode especificar um caminho para esse arquivo .tar.gz armazenado em sua máquina.
Exemplo
bash workspace-enterprise-install.sh -ims false -di onlyoffice/documentserver-ee -ics true -icp true
Isso executará um contêiner a partir da imagem especificada do ONLYOFFICE Docs armazenada no repositório, bem como executará os contêineres do ONLYOFFICE Community Server e ONLYOFFICE Control Panel.
bash workspace-enterprise-install.sh -ims false -ics true -ci "/home/user/CommunityServer-12.5.2.tar.gz" -ids false -icp true
Isso executará um contêiner a partir do arquivo .tar.gz local especificado que contém a imagem do ONLYOFFICE Community Server, bem como executará um contêiner do ONLYOFFICE Control Panel a partir da imagem armazenada no repositório Docker Hub.
Versão do componente
| Parâmetro | Descrição |
|---|---|
-cv, --communityversion | Versão do ONLYOFFICE Community Server |
-dv, --documentversion | Versão do ONLYOFFICE Docs |
-mv, --mailversion | Versão do ONLYOFFICE Mail |
-cpv, --controlpanelversion | Versão do ONLYOFFICE Control Panel |
Esses parâmetros podem ser usados para instalar uma determinada versão do componente se você não quiser instalar a versão mais recente disponível no repositório. Por padrão, uma imagem marcada como latest é usada para executar cada contêiner de componente.
Exemplo
Abra o repositório Docker Hub em seu navegador, selecione o componente necessário e vá para a guia Tags para visualizar todas as tags disponíveis no repositório. Especifique a versão que deseja instalar para os componentes necessários:
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"
Isso instalará a versão 8.9.0.150 do ONLYOFFICE Community Server, a versão 1.6.0.52 do ONLYOFFICE Control Panel e a versão mais recente do ONLYOFFICE Mail, já que sua versão não foi especificada explicitamente.
IP do servidor
| Parâmetro | Descrição |
|---|---|
-dip, --documentserverip | Endereço IP do ONLYOFFICE Docs |
-mip, --mailserverip | Endereço IP do ONLYOFFICE Mail |
-mdbip, --mailserverdbip | Endereço IP do banco de dados do ONLYOFFICE Mail |
Esses parâmetros podem ser usados para conectar os componentes se você os instalar em máquinas separadas.
Exemplo
bash workspace-enterprise-install.sh -ics true -icp true -ids false -ims false -dip 192.168.3.202 -es false
Isso instalará o ONLYOFFICE Community Server com o ONLYOFFICE Control Panel e o conectará ao ONLYOFFICE Docs instalado em uma máquina diferente que possui o endereço IP 192.168.3.202.
Nome de domínio do ONLYOFFICE Mail
| Parâmetro | Descrição |
|---|---|
-md, --maildomain | Nome de domínio do ONLYOFFICE Mail |
Este parâmetro permite especificar seu próprio nome de domínio que será usado para o ONLYOFFICE Mail.
Exemplo
bash workspace-enterprise-install.sh -md "yourdomain.com"
Isso instalará todos os componentes do ONLYOFFICE Workspace Enterprise, incluindo o ONLYOFFICE Mail com o nome de domínio yourdomain.com especificado.
Seu domínio que será usado para manter a correspondência deve ser válido e configurado para esta máquina (ou seja, deve ter o registro A apropriado nas configurações de DNS que aponta o nome do seu domínio para o endereço IP da máquina onde o ONLYOFFICE Mail está instalado).
No comando acima, o parâmetro "yourdomain.com" deve ser entendido como um domínio de serviço para o ONLYOFFICE Mail. Geralmente, é especificado no registro MX do domínio que será usado para manter a correspondência. Como regra, o "yourdomain.com" se parece com mx1.onlyoffice.com
Atualização de componentes
| Parâmetro | Descrição | Valores | Padrão |
|---|---|---|---|
-u, --update | usar para atualizar componentes existentes | true|false | false |
Este parâmetro permite instalar as versões mais recentes dos componentes necessários se os componentes correspondentes instalados na sua máquina estiverem desatualizados.
Exemplo
bash workspace-enterprise-install.sh -u true
Isso irá parar os contêineres que precisam ser atualizados, removê-los e, em seguida, executar as versões mais recentes dos componentes correspondentes do ONLYOFFICE Workspace Enterprise. Se a versão atual do componente coincidir com a mais recente disponível, tal contêiner não será afetado. Se você tiver pulado alguns componentes durante a instalação anterior, eles também serão ignorados. Os dados do portal devem ser capturados automaticamente.
Credenciais
| Parâmetro | Descrição |
|---|---|
-un, --username | nome de usuário do dockerhub |
-p, --password | senha do dockerhub |
Esses parâmetros são usados caso forneçamos a você credenciais para acessar um repositório de teste, para que você possa executar contêineres a partir de imagens armazenadas nele.
Exemplo
bash workspace-enterprise-install.sh -md "yourdomain.com" -un username -p password
Instalação de componentes
| Parâmetro | Descrição | Valores | Padrão |
|---|---|---|---|
-ics, --installcommunityserver | instalar ONLYOFFICE Community Server | true|false|pull | true |
-ids, --installdocumentserver | instalar ONLYOFFICE Docs | true|false|pull | true |
-ims, --installmailserver | instalar ONLYOFFICE Mail | true|false|pull | true |
-icp, --installcontrolpanel | instalar ONLYOFFICE Control Panel | true|false|pull | true |
Esses parâmetros permitem especificar se você precisa instalar um determinado componente ou não. Eles podem ser usados se você quiser instalar cada componente em uma máquina separada.
- Use o valor
truepara instalar um componente. - Use o valor
falsepara pular a instalação de um componente. - Use o valor
pullpara baixar um componente sem instalá-lo.
Por favor, não pule a instalação do ONLYOFFICE Control Panel ao instalar o ONLYOFFICE Community Server, caso contrário, você não poderá inserir sua chave de licença após a conclusão da instalação e adicionar, por exemplo, o ONLYOFFICE Mail à sua instância do ONLYOFFICE Workspace Enterprise.
Exemplo
bash workspace-enterprise-install.sh -ims false
Isso instalará todos os componentes do ONLYOFFICE Workspace Enterprise sem o ONLYOFFICE Mail.
bash workspace-enterprise-install.sh -ics false -ids true -icp false -ims false -es true
Isso pulará a instalação do ONLYOFFICE Mail, ONLYOFFICE Community Server e ONLYOFFICE Control Panel e instalará apenas o ONLYOFFICE Docs.
Tipo de instalação
| Parâmetro | Descrição | Valores | Padrão |
|---|---|---|---|
-it, --installation_type | tipo de instalação | WORKSPACE|WORKSPACE_ENTERPRISE | WORKSPACE_ENTERPRISE |
Este parâmetro permite instalar a solução especificada: ONLYOFFICE Workspace Community ou ONLYOFFICE Workspace Enterprise.
Exemplo
bash workspace-enterprise-install.sh -it WORKSPACE
Isso instalará os componentes ONLYOFFICE Community Server e ONLYOFFICE Control Panel.
Usando um componente como servidor externo
| Parâmetro | Descrição | Valores | Padrão |
|---|---|---|---|
-es, --useasexternalserver | usar como servidor externo | true|false | false |
Este parâmetro é usado caso você instale componentes em máquinas separadas.
- Use o valor
trueao instalar ONLYOFFICE Docs e ONLYOFFICE Mail em máquinas separadas. - Use o valor
falseao instalar ONLYOFFICE Community Server junto com o ONLYOFFICE Control Panel em uma máquina separada.
Exemplo
bash workspace-enterprise-install.sh -ics false -ids false -icp false -ims true -md "yourdomain.com" -es true
Isso pulará a instalação do ONLYOFFICE Docs, ONLYOFFICE Community Server e ONLYOFFICE Control Panel e instalará apenas o ONLYOFFICE Mail.
bash workspace-enterprise-install.sh -ics true -icp true -ids false -ims false -dip 192.168.3.202 -es false
Isso instalará o ONLYOFFICE Community Server com o ONLYOFFICE Control Panel e o conectará com o ONLYOFFICE Docs instalado em uma máquina diferente.
Criação de arquivo de swap
| Parâmetro | Descrição | Valores | Padrão |
|---|---|---|---|
-ms, --makeswap | criar arquivo de swap | true|false | false |
Este parâmetro permite criar um arquivo de swap de 6 GB. Por padrão, o valor true é especificado, portanto, você não precisa especificar este parâmetro ao executar o script. O arquivo de swap será criado automaticamente.
Exemplo
bash workspace-enterprise-install.sh -ms false
Se você já criou um arquivo de swap anteriormente, pode usar este comando para não criar um arquivo de swap durante a instalação.
Se você executar o script novamente sem especificar o parâmetro -ms, ele verificará se o onlyoffice_swapfile está presente. Se o arquivo de swap já existir, o script não criará um arquivo de swap novamente.
Servidor MySQL
| Parâmetro | Descrição | Padrão |
|---|---|---|
-mysqlh, --mysqlhost | Host do servidor MySQL | localhost |
-mysqlprt, --mysqlport | Porta do servidor MySQL | 3306 |
-mysqlru, --mysqlrootuser | Usuário root do servidor MySQL | root |
-mysqlrp, --mysqlrootpassword | Senha do usuário root do servidor MySQL | my-secret-pw |
Se você não especificar explicitamente esses parâmetros, os valores padrão serão usados.
Exemplo
bash workspace-enterprise-install.sh -mysqlru root -mysqlrp new-secret-pw
Este comando permite definir sua própria senha para a conta root do MySQL durante a instalação do ONLYOFFICE Workspace Enterprise.
Banco de dados do ONLYOFFICE Community Server
| Parâmetro | Descrição | Padrão |
|---|---|---|
-mysqld, --mysqldatabase | Nome do banco de dados do ONLYOFFICE Community Server | onlyoffice |
-mysqlu, --mysqluser | Usuário do banco de dados do ONLYOFFICE Community Server | onlyoffice_user |
-mysqlp, --mysqlpassword | Senha do banco de dados do ONLYOFFICE Community Server | onlyoffice_pass |
Esses parâmetros permitem criar o banco de dados do ONLYOFFICE Community Server especificando um nome de banco de dados personalizado, bem como um nome de usuário e senha para a conta com permissões de superusuário no banco de dados criado. Se você não especificar explicitamente esses parâmetros, os valores padrão serão usados.
Exemplo
bash workspace-enterprise-install.sh -mysqld communitydatabase -mysqlu username -mysqlp password
Banco de dados do ONLYOFFICE Mail
| Parâmetro | Descrição | Padrão |
|---|---|---|
-mysqlmd, --mysqlmaildatabase | Nome do banco de dados do ONLYOFFICE Mail | onlyoffice_mailserver |
-mysqlmu, --mysqlmailuser | Usuário do banco de dados do ONLYOFFICE Mail | mail_admin |
-mysqlmp, --mysqlmailpassword | Senha do banco de dados do ONLYOFFICE Mail | Isadmin123 |
Esses parâmetros permitem criar o banco de dados do ONLYOFFICE Mail especificando um nome de banco de dados personalizado, bem como um nome de usuário e senha para a conta com permissões de superusuário no banco de dados criado. Se você não especificar explicitamente esses parâmetros, os valores padrão serão usados.
Exemplo
bash workspace-enterprise-install.sh -md "mx.yourdomain.com" -mysqlmd maildatabase -mysqlmu username -mysqlmp password
Porta do ONLYOFFICE Community Server
| Parâmetro | Descrição | Padrão |
|---|---|---|
-cp, --communityport | Porta do ONLYOFFICE Community Server | 80 |
Este parâmetro permite alterar a porta na qual o ONLYOFFICE Community Server será executado. Por padrão, a porta 80 é usada.
Exemplo
bash workspace-enterprise-install.sh -cp 8080
Configuração para core.machinekey
| Parâmetro | Descrição |
|---|---|
-mk, --machinekey | Configuração para a chave core.machinekey |
Este parâmetro permite especificar seu próprio machinekey ao instalar o ONLYOFFICE Workspace Enterprise.
Este parâmetro é gravado no arquivo de configuração /app/onlyoffice/CommunityServer/data/.private/machinekey.
Exemplo
bash workspace-enterprise-install.sh -mk yourmachinekey
Configuração para JWT secret
| Parâmetro | Descrição |
|---|---|
-jwt, --jwtsecret | Configuração para a chave secreta JWT |
Este parâmetro permite especificar sua própria chave secreta JWT ao instalar o ONLYOFFICE Workspace Enterprise. A chave secreta é usada para assinar o token web JSON e validar o token ao solicitar ao ONLYOFFICE Docs.
Este parâmetro é gravado nos seguintes arquivos de configuração (os caminhos são especificados dentro dos contêineres):
- Para o Community Server -
/var/www/onlyoffice/WebStudio/web.appsettings.config - Para o Document Server -
/etc/onlyoffice/documentserver/local.json
Exemplo
bash workspace-enterprise-install.sh -jwt yoursecret