...
Descrevemos abaixo algumas situações que podem impactar diretamente na instalação/atualização das mídias do TOTVS Fluig Plataforma no Sistema Operacional Windows.
Alterar o tipo de inicialização dos serviços para manual
...
01. Alterar o tipo de inicialização dos serviços do Fluig para "manual" é importante para evitar que o serviço inicialize e impeça a atualização da plataforma.
Nota |
---|
|
Essa configuração será utilizada apenas para reiniciar o servidor e fazer a atualização. Depois o serviço poderá ser configurado novamente para inicialização automática. |
Deck of Cards |
---|
|
Card |
---|
| - Acessar a tela de Serviços do Windows e procure pelos serviços: (1) fluig, (2) fluig_Indexer e (3) fluig_RealTime.
Image Added
|
Card |
---|
| - Acessar as propriedades dos serviços.
Image Added
|
Card |
---|
| - Alterar o Tipo de Inicialização de Automático para Manual.
- Fazer isso para (1) fluig, (2) fluig_Indexer e (3) fluig_RealTime.
Image Added
|
|
Serviço "fluig" permanece com o status "stopping" (ou "parando")
...
Não é incomum que, ao encerrar o serviço "fluig", o status permaneça em "stopping" e não finalize a ação. Esse comportamento não é do Fluig em si específico da plataforma e, geralmente, está associado a interferências externas, seja de outra aplicação, servidor, etc.Nesse cenário, apenas o A maior parte dos relatos estão relacionados ao serviço "fluig"apresenta esse comportamento, os demais serviços (fluig_Indexer e fluig_RealTime) funcionam corretamente.
Image Removed nunca apresentaram tal eventualidade.
Informações |
---|
title | Os motivos mais comuns para a situação ocorrer são: |
---|
|
- Aplicação de backup sendo executada nas pastas e no mesmo servidor da plataforma, de forma que, o serviço não consiga fazer os procedimentos necessários para parar.
- Antivírus ativado, ou funcionando no mesmo servidor, sem ter o Fluig configurado como exceção. Isso pode impedir a plataforma de apagar pastas temporárias, que é um procedimento padrão no desligamento.
|
Preparamos algumas recomendações e procedimentos a serem feitos para que a instalação/atualização possa prosseguir:
...
Informações |
---|
|
O ideal é que o |
...
servidor seja dedicado à plataforma, sem que haja outros sistemas operando em conjunto. |
02. Caso seu servidor não seja dedicado à plataforma:
...
Preparamos alguns procedimentos a serem feitos para que a instalação/atualização possa prosseguir:
01. Desativar outras aplicações Java e avaliar se ainda ocorre interferências ao finalizar o serviço "fluig".
...
02. Conferir a documentação de Portas e endereços
...
utilizados pelo Fluig e descartar a possibilidade de conflitos nas portas pela utilização de outras aplicações.
03. Recortar os arquivos da pasta apps para outro local, fora do diretório de instalação do Fluig: <diretório de instalação do Fluig>\appserver\apps
04. Limpar os arquivos temporários do Windows, seguindo os passos abaixo:
Deck of Cards |
---|
|
Card |
---|
| - Fechar todas as aplicações abertas.
- Acionar Executar.
Image Modified
|
Card |
---|
| - Digitar o termo %tmp% ou %temp% (ambos são válidos).
Image Modified
|
Card |
---|
| - Abrirá a pasta de arquivos temporários do Windows.
- Selecionar todos os arquivos (Ctrl + A).
Image Removed Image Added
|
Card |
---|
| - Clicar com o botão direito do mouse em cima dos arquivos selecionados e acionar Excluir.
- Confirme a exclusão dos arquivos.
- Também é possível realizar a exclusão com o botão Delete, no teclado.
Image Removed Image Added
|
|
0405. Encerrar todas as tarefas do OpenJDK Platform binary e do Node.js JavaScript Runtime no Gerenciador de Tarefas do Windows:
...
Deck of Cards |
---|
|
Card |
---|
| - Acionar o atalho Ctrl + Alt + Del no teclado e clicar em Gerenciador de Tarefas.
- Também é possível pesquisar por Gerenciador de Tarefas no campo de busca do Windows.
Image Modified
|
Card |
---|
| - Se certifique que está na aba Processos.
- Buscar em Processos em segundo plano pelos termos "OpenJDK Platform binary" e "Node.js JavaScript Runtime".
Image Modified
|
Card |
---|
| - Acionar o recurso Finalizar tarefa para cada processo em segundo plano relacionado ao "OpenJDK Platform binary" e ao "Node.js JavaScript Runtime".
Image Modified
|
Card |
---|
| - Após finalizar as tarefas, abra novamente a tela de Serviços do Windows. Todos os serviços deverão aparecer sem nenhuma informação na coluna Status.
Image Modified
|
|
Mensagens durante a instalação/atualização
...
01. Durante a instalação ou atualização da plataforma, podem surgir as seguintes mensagens de erro:
- O serviço Fluig está em execução. Finalize o serviço para continuar a atualização.
- Existe algum arquivo aberto ou em uso. Feche todas as aplicações que possam estar usando arquivos.
- O serviço do Solr está em execução. Finalize o serviço para continuar a atualização.
- The system cannot find the path specified.
- Mensagens em branco.
- Unable to evaluate expression using this context.
- [...]\dataset.author.csv (O dispositivo não está pronto).
Informações |
---|
|
O instalador da plataforma verifica se todos os serviços e arquivos da plataforma estão abertos ou em uso durante a instalação/atualização. Isso garante que o procedimento seja realizado com segurança. |
...
Deck of Cards |
---|
|
Card |
---|
| Image Modified
|
Card |
---|
| Image Modified
|
Card |
---|
| Image Modified
|
Card |
---|
| Image Modified
|
Card |
---|
| Image Modified
|
Card |
---|
| Image Modified
|
Card |
---|
| Image Modified
|
|
Renomear o diretório de instalação (teste)
...
01. Certifique-se de ter fechado todos os arquivos e finalizado os serviços do Fluig: (1) fluig, (2) fluig_Indexer e (3) fluig_RealTime.
...
03. Se o Sistema Operacional não permitir que a pasta seja renomeada, significa que algum arquivo está aberto ou em execução.
...
...
01. O usuário que está executando o instalador deve possuir permissão de administrador.
02. Iniciar a sessão no Sistema Operacional com um usuário que possua propriedades administrativas no servidor.
...
04. Em caráter de teste, tente iniciar o instalador por linha de comando:
...
Consultar o log de eventos do Windows
...
O Windows possui o Visualizador de Eventos como recurso nativo para consulta de logs de eventos. Essa ferramenta registra detalhes sobre erros no sistema, inclusive os que são causados por falha de hardware, como HD ou memória RAM.
Pode ser consultado em: Menu Iniciar (Windows) > Painel de Controle > Ferramentas Administrativas > Visualizador de eventos > Expanda "Logs do Windows" (no Painel Esquerdo). Caso ocorra, nos envie prints, por gentileza.
Monitoramento de recursos:
1. Pare os serviços do Fluig e remova os itens da pasta apps (<diretório de instalação do fluig>\appserver\apps) para outro local, fora do diretório de instalação do Fluig.
2. Reinicie os serviços, tente pará-los novamente para verificarmos se ainda se mantem o status de stopping.
3. Usando o Monitor de Recursos do Windows podemos tentar mapear o que está conectado ou utilizando o java.exe. Para isso:
- Abra a busca do Windows e procure pelo Monitor de Recursos do sistema. Para isso, digite “resmon.exe” (sem aspas):
Image Removed
Image Removed
- Selecione a opção "java.exe":
Image Removed
- Nos envie prints dessa tela mostrando os módulos associados.
Alterar o tipo de inicialização dos serviços para manual
01. Se não for possível renomear a pasta de instalação, siga os passos abaixo para executar a atualização/instalação:
Para consultar:
Deck of Cards |
---|
|
Card |
---|
| - Pesquisar pelo Painel de Controle no campo de busca do Windows.
Image Added
|
Card |
---|
| - Acionar a opção Sistema e Segurança.
Image Added
|
Card |
---|
| - Clicar em Ferramentas do Windows.
Image Added
|
Card |
---|
| - Clicar em Visualizador de Eventos.
Image Added
|
Card |
---|
| - O Visualizador de Eventos mostra diversas informações a respeito do tipo de evento e qual aplicação fez o disparo.
Image Added
|
|
Monitor de Recursos do Windows
...
01. O Monitor de Recursos é um recurso do Windows que pode auxiliar no mapeamento das aplicações que estão conectadas ou utilizando o Java.exe. Para acessá-la:
Deck of Cards |
---|
|
Card |
---|
| - Pesquisar pelo Painel de Controle no campo de busca do Windows.
Image Added
|
Card |
---|
| - Acionar a opção Sistema e Segurança.
Image Added
|
Card |
---|
| - Clicar em Ferramentas do Windows.
Image Added
|
Card |
---|
| - Clicar em Monitor de Recursos.
Image Added
|
Card |
---|
| - Ao abrir o Monitor de Recursos, aparecerá a aba “Visão Geral" com os recursos de hardware.
- Selecionar a aba CPU e buscar pelo java.exe.
Image Added
|
Card |
---|
| - Com o java.exe selecionado, é possível consultar, nas abas Identificadores Associados e Módulo Associados, todas as aplicações que estão utilizando o recurso.
Image Added
|
|
Deck of Cards |
---|
|
Card |
---|
| a) Acessar a tela de Serviços do Windows e procure pelos serviços: (1) fluig, (2) fluig_Indexer e (3) fluig_RealTime. Image Removed
|
Card |
---|
| b) Acessar as propriedades de um dos serviços. Image Removed
|
Card |
---|
| c) Alterar o Tipo de Inicialização de Automático para Manual. Essa configuração será utilizada apenas para reiniciar o servidor e fazer a atualização. Depois o serviço poderá ser configurado novamente para inicialização automática. Esse passo é importante para evitar que o serviço inicialize e seja preciso parar o serviço manualmente antes de executar a atualização. Image Removed
|
|
Limpeza de arquivos temporários e pastas keys
...
02. Tentar efetuar a atualização da plataforma novamente.
03. Caso consiga, lembre-se de voltar às instruções do título "Alterar o tipo de inicialização dos serviços para manual" e altere o Tipo de Inicialização para Automático.04. Iniciar novamente os serviços do Fluig: (1) fluig_Indexer, (2) fluig_RealTime e (3) fluig.
...
Em servidores Linux essas situações não costumam ocorrer, no entanto, caso ocorra alguma eventualidade, realize a abertura de um ticket na Central de Atendimento, através das opções: Nova Solicitação → Suporte Técnico e anexe esses arquivos ao chamado. Essa ação agilizará todo o processo de atendimento:
- <diretório de instalação do Fluig>\appserver\domain\configuration\domain.xml
- <diretório de instalação do Fluig>\appserver\domain\configuration\host.xml
- <diretório de instalação do Fluig>\appserver\domain\servers\fluig1\log\server.log
- <diretório de instalação do Fluig>\appserver\domain\log\host-controller.log
- <diretório de instalação do Fluig>\appserver\domain\log\process-controller.log
- <diretório de instalação do Fluig>\node\fluig.rt\package.json
- <diretório de instalação do Fluig>\node\fluig.rt\logs
- <diretório de instalação do Fluig>\install.log
- <fluig.conf> (Arquivo que fica dentro do servidor do Proxy Reverso)