Resolução de problemas

P:Quero instalar o servidor baseado em Docker no meu servidor local. Como posso fazer isso?

R:O servidor online mais recente baseado em Docker está disponível no Docker hub. Por favor, selecione qual você gostaria de instalar: ONLYOFFICE Docs, ONLYOFFICE Workspace ou ONLYOFFICE Mail e siga as instruções na página apropriada.

P:Após criar e entrar no portal, vejo um usuário desconhecido no módulo Pessoas com o nome 'usuário falso'. Também há algum serviço OnlyofficeHealthCheck na lista de serviços. Por que isso acontece e preciso fazer algo a respeito?

R:O usuário e o serviço fazem parte da futura funcionalidade de Verificação de Saúde que estará disponível para os portais em lançamentos futuros. No momento, não é funcional, então você pode deixá-lo como está ou desativar o serviço OnlyofficeHealthCheck e removê-lo da lista de inicialização automática de serviços.

P:Qual sistema eu preciso ter para instalar a solução de servidor e usá-la com sucesso?

R:Os requisitos do sistema são:

• CPU
  dual core 2 GHz ou melhor
• RAM
  4 GB ou mais
• HDD
  pelo menos 20 GB de espaço livre
• SWAP
  pelo menos 4 GB, mas depende do sistema operacional do host. Mais é melhor
• OS
  distribuição Linux amd64 com versão de kernel 3.10 ou posterior
• Requisitos adicionais
  • Docker: qualquer versão suportada pela equipe Docker

P:Instalei uma das versões do servidor usando o serviço Docker, mas tenho alguns problemas relacionados ao servidor DNS ou resolução de nome próprio. O que pode estar errado?

R:O Docker especifica os servidores DNS do Google por padrão e o servidor tenta contatá-los sempre que faz algumas solicitações de rede. Se o seu ONLYOFFICE Workspace, ONLYOFFICE Docs ou ONLYOFFICE Mail não tiver acesso à Internet, recomendamos que você altere o endereço DNS padrão do Docker para o endereço do seu servidor DNS local. Para fazer isso, vá para o arquivo /etc/default/docker e altere o endereço IP na seguinte linha para o endereço IP de um servidor DNS na sua rede local:

docker_OPTS="--dns 8.8.8.8"

Para sistemas operacionais baseados em RPM, como CentOS, o arquivo de configuração pode estar localizado aqui: /etc/docker/daemon.json

P:Os editores de documentos abrem e a interface aparece, mas o documento em si não carrega, mostrando continuamente o progresso de carregamento. O que pode ser feito?

R:A razão pode ser que o computador deve ser capaz de se endereçar usando o acesso de loopback da Internet, ou seja, deve ser acessível de fora para si mesmo. Você pode permitir isso editando o iptables para ter os redirecionamentos como este:

iptables -t nat -A PREROUTING -d <public_ip> -j DNAT --to-destination <local_ip>
iptables -t nat -A POSTROUTING -s <local_ip> -j SNAT --to-source <piblic_ip>

Não se esqueça de substituir os endereços public_ip e local_ip pelos endereços IP reais.

P:Adicionei um tema de interface personalizado ou atualizei meus arquivos de idioma do editor (corrigi algumas traduções), mas o servidor ainda mostra os valores anteriores em vez dos corretos. Como posso redefinir o cache para todos os usuários ao mesmo tempo?

R:Por favor, siga os passos para redefinir o cache:
Encontre os arquivos /etc/nginx/includes/ds-docservice.conf e /etc/nginx/includes/ds-spellchecker.conf. Deve haver o valor de data e hora de compilação. Altere esses valores para algum outro (qualquer valor serve, mas o principal é que deve ser o mesmo em todos os lugares) e reinicie o NGINX:

sudo service nginx reload

O cache deve ser redefinido para todos os usuários do servidor.

P:Adicionei um certificado SSL autoassinado e agora tenho um erro ao abrir a página de metadados SSO, ao trabalhar com WebDAV e outros serviços node.js. O que pode ser feito para corrigir isso?

R:Se você encontrar um problema ao obter os metadados SSO, WebDAV e outros serviços node.js ao usar certificados SSL autoassinados, você pode tentar uma das seguintes opções para resolver este problema:

Opção 1 - Adicionar parâmetros para o lançamento do serviço.

1. Abra o arquivo onlyofficeSsoAuth.service (dentro do contêiner CommunityServer):

   nano /lib/systemd/system/onlyofficeSsoAuth.service

2. Adicione a seguinte linha especificando o caminho para o certificado raiz no final do bloco [Service]:

   Environment=NODE_EXTRA_CA_CERTS=/etc/rootCA.pem

3. Reinicie os serviços:

   systemctl daemon-reload
   systemctl restart onlyofficeSsoAuth

Opção 2 - Use o pacote de certificados do sistema.

1. Abra o arquivo onlyofficeSsoAuth.service (dentro do contêiner CommunityServer):

   nano /lib/systemd/system/onlyofficeSsoAuth.service

2. Encontre a seguinte linha no bloco [Service]:

   ExecStart=/usr/bin/node /var/www/onlyoffice/Services/ASC.SsoAuth/app.js UNIX.SERVER

   Substitua por esta linha:

   ExecStart=/usr/bin/node --use-openssl-ca /var/www/onlyoffice/Services/ASC.SsoAuth/app.js UNIX.SERVER

3. Para o CentOS, adicione adicionalmente a seguinte linha especificando o caminho para o pacote de certificados no final do bloco [Service]:

   Environment=SSL_CERT_FILE=/etc/pki/tls/certs/ca-bundle.trust.crt

4. Reinicie os serviços:

   systemctl daemon-reload
   systemctl restart onlyofficeSsoAuth

P:Reiniciei o servidor sem parar o contêiner Docker com o comando docker stop id e agora estou com o erro ERR_TOO_MANY_REDIRECTS no meu servidor. O que pode ser feito para corrigir isso?

R:Por favor, edite o arquivo /var/www/onlyoffice/WebStudio/web.appsettings.config removendo a última linha:

<add key="web.warmup.type" value="basic" />

e reinicie o monoserve com o seguinte comando:

sudo service monoserve restart

P:Estou usando Fedora Linux e os processos falham ao iniciar dentro do contêiner Docker. Existe uma solução para o problema?

R:Usuários do Fedora e RHEL/CentOS devem tentar desabilitar o SELinux com o comando setenforce 0. Se isso resolver o problema, você pode optar por manter o SELinux desabilitado, o que não é recomendado pela RedHat, ou mudar para o uso do Ubuntu.

P:Ocorreu perda de dados ao parar o ONLYOFFICE Docs. Como evitar a perda de dados?

R:Devido à característica operacional, o ONLYOFFICE Docs salva um documento apenas após ele ter sido fechado por todos os usuários que o editaram. Para evitar perda de dados, você deve desconectar forçadamente os usuários do ONLYOFFICE Docs quando precisar parar o ONLYOFFICE Docs em casos de atualização do aplicativo, reinicialização do servidor, etc. Para isso, execute o seguinte script no servidor onde o ONLYOFFICE Docs está instalado:

sudo docker exec <CONTAINER> documentserver-prepare4shutdown.sh