Verificando status dos serviços

Esta seção descreve o procedimento geral a seguir e os pontos a verificar ao solucionar problemas da plataforma Navixy. Cobre a resolução básica de problemas dos serviços Java, do servidor Web e do servidor de Banco de Dados. Saber como verificar e reiniciar os serviços ajudará a compreender a causa do problema e a solucioná-lo com mais precisão.

Recomenda-se que você primeiro revise as informações em Componentes do sistema página para estar ciente das localizações dos arquivos de configuração e de log dos serviços.

Verificação geral de integridade

Em instâncias Navixy On-premise atualizadas executando em Linux, foi implementado um script que realiza uma verificação rápida do status de todos os componentes principais da plataforma: banco de dados, site e serviços de backend. Para usá-lo, faça login como root e digite o seguinte comando na CLI do seu servidor:

check-navixy

A saída exibirá o tipo de instalação (baseada em systemd ou executando em Docker) e o status de cada um dos serviços. A saída deve ser a seguinte:

Se você vir que qualquer um dos serviços está inativo, isso é motivo para tomar medidas de emergência, pois nesse caso a plataforma não está totalmente funcional.

Dependendo de qual serviço apresenta o problema, é necessário consultar a seção apropriada no manual ou contatar o suporte técnico para restaurar sua operação.

O check-navixy o script está disponível apenas para instâncias baseadas em Linux. Para Windows, veja as instruções abaixo.

Serviços Java

Você pode verificar os serviços Java (backend Navixy) individualmente para obter mais detalhes sobre seu status atual e reiniciá-los, se necessário.

Linux

No Linux, o Navixy utiliza systemd, que está incluído nas distros Linux mais comuns, e é uma alternativa aos scripts init.d tradicionais. Anteriormente, runit era usado para o mesmo propósito, mas agora está obsoleto.

Para verificar os status dos serviços Java do Navixy, use os seguintes comandos:

Quando tudo funciona normalmente, a saída para cada comando deve mostrar o active (running) status, juntamente com o tempo de atividade atual, quantidade de memória utilizada e outras informações técnicas. Por exemplo, a saída normal do API-server se parece com isto:

Também mostrará as últimas entradas do log do serviço, que podem ser extremamente úteis para fins de solução de problemas.

Quando qualquer um dos serviços está inativo, o comando retornará inactive (dead) status. Exemplo:

Nesse caso, você precisa verificar os logs do serviço que não está funcionando. Por padrão, todos os logs estão localizados em /home/java/<service_name>/log/ .

Se um serviço falhar ao iniciar, geralmente haverá erros associados nos logs. Tente verificar as informações antes de Server stopped entrada ou quaisquer entradas recentes que comecem com WARN ou ERROR. Você também pode tentar reiniciar o serviço e verificar quais novas entradas aparecem usando o comando tail -f log.txt.

Para informações sobre reinício de serviços, verifique a página correspondente: Reiniciando instância - Linux.

Windows

No Windows, os serviços Java do Navixy são instalados como serviços regulares do Windows NT. Para acessar os serviços, abra o services.msc snap-in, e você encontrará três serviços Navixy na lista:

Verificando status de serviços - Windows

Os serviços devem ter o Running status. Se este não for o caso para qualquer um dos serviços, tente iniciá‑lo e veja se começa a funcionar corretamente. Se o serviço travar, a razão deve ser pesquisada nos logs. O local padrão dos logs é C:\java\<service_name>\log\. Se um serviço falhar ao iniciar, geralmente haverá erros associados nos logs. Tente verificar as informações antes de Server stopped entrada ou quaisquer entradas recentes que comecem com WARN ou ERROR. Recomenda-se usar editores de texto avançados como Notepad++ ou Sublime Text para revisar logs. O Bloco de Notas padrão geralmente não funciona bem com arquivos de texto grandes.

Para informações sobre reinício de serviços, verifique a página correspondente: Reiniciando instância - Windows.

Servidor Web

Se os serviços Java estiverem em execução, mas você ainda não conseguir acessar a interface, verifique se o servidor Web Nginx está em execução.

Linux

Na instância Linux, verifique o status do Nginx com o seguinte comando:

A saída deve mostrar o active (running) status, juntamente com o tempo de atividade atual, quantidade de memória utilizada, outras informações técnicas e as últimas entradas do log do Nginx.

Se o serviço apresentar um inactive (dead) status, tente iniciá‑lo com este comando:

Certifique‑se de que o Nginx foi iniciado e está em execução normalmente e, se não estiver, verifique possíveis erros em seu log.

Windows

No Windows, o Nginx não é um serviço, mas apenas um pequeno aplicativo executando em segundo plano. Para verificar se ele foi iniciado, abra o Gerenciador de Tarefas (aba Detalhes) e procure por nginx.exe processos - geralmente existem dois ou mais deles.

Verificando status do Nginx - Windows

Se você não conseguir encontrar nginx.exe na lista, tente executar seu arquivo executável a partir de C:\nginx manualmente ou com os seguintes comandos no CMD:

Se o Nginx estiver ativo, mas você ainda não conseguir acessar a plataforma, consulte painel de administração ou interface do usuário os respectivos guias de solução de problemas.

Banco de dados

Se você suspeitar de problemas de conexão com o banco de dados (ou tiver encontrado informações relevantes nos logs dos serviços), é necessário verificar seu estado. Navixy usa o SGBD MySQL, portanto, antes de tudo, certifique‑se de que o servidor MySQL está ativo e em execução. No Linux, use o seguinte comando:

No Windows, verifique se o MySQL possui um Running status no services.msc snap-in.

Se o SGBD estiver em execução mas você ainda tiver erros de conexão com o banco de dados nos logs, tente conectar‑se ao MySQL com a mesma conta usada pelos serviços Java. Por exemplo, abra o /home/java/api-server/conf/db.properties arquivo, obtenha o login e a senha do banco de dados a partir dele e use‑os para conectar‑se ao MySQL a partir do shell:

Certifique‑se de que outros serviços Java também possam se conectar.

Se seu banco de dados estiver hospedado em um servidor separado, certifique-se de que a conexão com ele esteja disponível na porta padrão do MySQL 3306 (ou em uma porta personalizada se a instalação foi feita dessa forma - verifique o db.properties arquivo de qualquer um dos serviços Java).

Se você vir erros nos logs que não estejam relacionados à acessibilidade do banco de dados, mas à execução de determinadas consultas SQL, por favor reporte ao suporte técnico. Esses problemas geralmente são complexos demais para serem resolvidos por conta própria.

Contactar o suporte técnico

As etapas mostradas acima são muito básicas para realizar a verificação da plataforma. Se você não conseguir resolver o problema, entre em contato conosco em [email protected], e descreva o problema em detalhe, fornecendo logs e todas as demais informações relevantes que possuir. Faremos o possível para ajudar.

Atualizado

Isto foi útil?