O objetivo deste guia é apresentar quais os problemas mais comuns ao efetuar a atualização do TOTVS Fluig Plataforma e como resolvê-los.
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.
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.
03. Verificar se o usuário autenticado é realmente um usuário administrador:
Deck of Cards |
---|
|
Card |
---|
| - Buscar pelo o Painel de Controle do Windows.
![](/download/attachments/819058035/image-2024-1-10_15-12-27.png?version=1&modificationDate=1704910349050&api=v2)
|
Card |
---|
| - Acionar Contas de Usuário.
![](/download/attachments/819058035/image-2024-1-10_15-13-50.png?version=1&modificationDate=1704910431567&api=v2)
|
Card |
---|
| - Acionar Contas de Usuário novamente.
![](/download/attachments/819058035/image-2024-1-10_15-14-50.png?version=1&modificationDate=1704910491660&api=v2)
|
Card |
---|
| - Clicar em Gerenciar Contas de Usuários.
![](/download/attachments/819058035/image-2024-1-10_15-20-17.png?version=1&modificationDate=1704910818900&api=v2)
|
Card |
---|
| - Selecionar o usuário que está autenticado e clicar em Propriedades.
![](/download/attachments/819058035/image-2024-1-10_15-25-47.png?version=1&modificationDate=1704911148963&api=v2)
|
Card |
---|
| - A opção Administrador precisa estar marcada.
![](/download/attachments/819058035/image-2024-1-10_11-52-59.png?version=1&modificationDate=1704898379563&api=v2)
|
|
04. Em caráter de teste, tente iniciar o instalador por linha de comando:
Deck of Cards |
---|
|
Card |
---|
| - Abrir o prompt de comando através do botão direito do mouse e escolha a opção Executar como administrador, conforme a imagem abaixo:
![](/download/attachments/819058035/image-2024-1-10_15-39-55.png?version=1&modificationDate=1704911996683&api=v2)
|
Card |
---|
| - Se sua sessão não for de administrador, será necessário informar um login e senha antes de prosseguir;
- Com o prompt de comando aberto, navegue até a pasta descompactada onde contém a mídia do Fluig.
![](/download/attachments/819058035/image-2024-1-10_15-41-36.png?version=1&modificationDate=1704912097193&api=v2)
|
Card |
---|
| - Ao acessar a pasta do instalador, execute o fluig-installer.jar, através do comando: java -jar fluig-installer.jar.
- A tela do instalador/atualizador será exibida e o processo de atualização prosseguirá normalmente.
![](/download/attachments/819058035/image-2024-1-10_15-43-24.png?version=1&modificationDate=1704912205783&api=v2)
|
|
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 e, geralmente, está associado a interferências externas, seja de outra aplicação, servidor, etc.
Nesse cenário, apenas o serviço "fluig" apresenta esse comportamento, os demais serviços (fluig_Indexer e fluig_RealTime) funcionam corretamente.
![Parando.png](https://centraldeatendimento.fluig.com/hc/article_attachments/360042374693/Parando.png)
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:
01. 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:
- Realizar um teste desativando as outras aplicações e avaliar se ainda ocorre interferências ao finalizar o serviço "fluig".
- Verificar se há alguma outra aplicação Java na máquina. Caso tenha, conferir a documentação sobre as Portas e endereços que são utilizados pelo Fluig e descartar a possibilidade de conflitos.
03. Limpar os arquivos temporários do Windows, seguindo os passos abaixo:
Deck of Cards |
---|
|
Card |
---|
| - Fechar todas as aplicações abertas.
- Acionar Executar.
![](/download/attachments/819058035/image-2024-1-10_15-59-36.png?version=1&modificationDate=1704913177573&api=v2)
|
Card |
---|
| - Digitar o termo %tmp% ou %temp% (ambos são válidos).
- Clicar em Ok.
![](/download/attachments/819058035/image-2024-1-10_16-1-1.png?version=1&modificationDate=1704913262640&api=v2)
|
Card |
---|
| - Abrirá a pasta de arquivos temporários do Windows.
- Selecionar todos os arquivos (Ctrl + A).
![](/download/attachments/819058035/image-2024-1-10_16-3-33.png?version=1&modificationDate=1704913414647&api=v2)
|
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.
![](/download/attachments/819058035/image-2024-1-10_16-6-16.png?version=1&modificationDate=1704913578220&api=v2)
|
|
04. Encerrar todas as tarefas do OpenJDK Platform binary e do Node.js JavaScript Runtime no Gerenciador de Tarefas do Windows:
Informações |
---|
|
O Node.js JavaScript Runtime é um ambiente de execução do código JavaScript do lado servidor (server-side). Na prática, o Node.js gera a possibilidade de criar aplicações autossuficientes (standalone) em uma máquina servidora, sem a necessidade do navegador. Já o OpenJDK Platform binary é um serviço que executa o Servidor de Aplicação Java, que serve como base para a aplicação Fluig. A plataforma funciona tanto de forma reativa, quando os usuários a acessam; quanto proativa, quando se tratam de fluxos automáticos, agendamentos de processamentos e demais tarefas automatizadas que possam estar configuradas. Assim, mesmo sem usuários utilizando o ambiente, existem integrações ou agendamentos de tarefas que são executados em segundo plano pelo Fluig. |
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.
![](/download/attachments/819058035/image-2024-1-10_17-42-40.png?version=1&modificationDate=1704919361033&api=v2)
|
Card |
---|
| - Se certifique que está na aba Processos.
- Buscar em Processos em segundo plano pelos termos "OpenJDK Platform binary" e "Node.js JavaScript Runtime".
![](/download/attachments/819058035/image-2024-1-10_17-54-21.png?version=1&modificationDate=1704920061327&api=v2)
|
Card |
---|
| - Acionar o recurso Finalizar tarefa para cada processo em segundo plano relacionado ao "OpenJDK Platform binary" e ao "Node.js JavaScript Runtime".
![](/download/attachments/819058035/image-2024-1-10_17-57-7.png?version=1&modificationDate=1704920227483&api=v2)
|
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.
![](/download/attachments/819058035/image-2024-1-10_18-2-2.png?version=1&modificationDate=1704920523307&api=v2)
|
|
Ocorre algum evento de log no Windows? 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):
![](https://s2.glbimg.com/e4hsz0ydjU3gAzb2nwW2Q7A7fTo=/0x0:695x311/984x0/smart/filters:strip_icc()/i.s3.glbimg.com/v1/AUTH_08fbf48bc0524877943fe86e43087e7a/internal_photos/bs/2021/s/k/43D2kqROqEYqh0ykkU7w/2015-09-02-abra-o-monitor-de-recursos-do-windows.png)
![](https://s2.glbimg.com/n2hhATHxeM07nxMk_CgcNfVrvio=/0x0:695x364/984x0/smart/filters:strip_icc()/i.s3.glbimg.com/v1/AUTH_08fbf48bc0524877943fe86e43087e7a/internal_photos/bs/2021/T/A/8lKQg4SZATpV3mR4mHYA/2015-09-02-acesse-a-aba-cpu.png)
- Selecione a opção "java.exe":
![Exibindo image.png](https://chat.google.com/u/0/api/get_attachment_url?url_type=FIFE_URL&content_type=image%2Fpng&attachment_token=AMzByC0kcQP2ng8oMMdKjPodp%2BlTTXA7abOYVkJZPqUlYTQuEDCvYScSXJWYwiASE4IBeAm3m0UsGHaA5JC1JlXiq2Qv4xsG1BOmWZJQz3CZCVrHrmETuudcO5IZU7US%2BjBlUDg81yQqIiBiBOH4H3tLA033lqrAZtSi1dX4qLB9aZiKLvQAPVjrquRxy7nJ6G3pW%2BNmb1Z3PFGOFR8yS5elQLCCzNmfZPpo%2Bw%2BgX0OrOVsiIuqlc%2BnfVW4LHEYadktsdHEN2a9PqF4RBFsCpupkH95OEXA5mvbme8R%2BrcMjiC%2Bss3TJV58MW5O46bzO%2FnQoKh0yi6p%2BYDysrYAvcREnr6f8EWMykKcxiY9qofobhGcTGAE5UZQxAUEFqlpPMSliYzjAbrQoqDtA85oUCkXQIeXvIs7OtHIX1rwOppjwvwXIfhJbhEcTEWDpp%2BVQrtyRVZ74EqgEm%2FZfLWpPeV0Nl1Qm3hCeDeeddduvSn0yiL7wsdtLN3a9CKC1%2BoMHsUV6Ezx%2BgHsWb8gB0QiDh3j6qYMd1gexERFZWezcQhZ8mGUqI%2FGZ4M%2BIk4bGk9xd6EMMz8vBB6SUUMeqJBk%2Bi%2Bt%2Fpzdm%2BllGaxM%3D&sz=w1280-h847)
- Nos envie prints dessa tela mostrando os módulos associados.
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).
02. 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.
03. Ao ignorar os erros e prosseguir com a instalação, é possível finalizá-la. No entanto, ao tentar inicializar a plataforma, os serviços são encerrados logo em seguida.
04. Abaixo seguem alguns exemplos das mensagens que podem aparecer em tela:
Deck of Cards |
---|
|
Card |
---|
| ![](https://lh3.googleusercontent.com/FoV7B6XDaReUoIxKfBaNI7LdQg2Qrvby-HhOBuwQmDNXWL947618KGFn4kbZYTuNzLIZc71xzGcdcRBPLeBxd3z9dEUj4rcfOoG0rhc5cX1571TBaWNy4n6tACw8EHZ77GxyoIIm)
|
Card |
---|
| ![](https://lh4.googleusercontent.com/zb3_DT80ETi6DrV1lgmeYobxER-DoWCOvH-c_K4pcctQId7jJdJBQRLKGVE52cP2EL0oQ0CBtNpdzT_DkjfQvTiFanB_2KB0pqtcELnKurOqbC9-4PKYr438xNVtFzn_GumFYVR7)
|
Card |
---|
| ![](https://lh6.googleusercontent.com/tBAnHHPDhU-UDBe8iwrx4R4eTDN6M4TDFbWFId9R3TtEVPmjLSO8eruMHVXJmxGqgqFZauW_M4WI1dSb4M-4VnlMr2Yu_J96qoTRk8CKwSJrCe4vH1ZjgtLFWMkCgtFy6aEwIJLM)
|
Card |
---|
| ![](https://lh6.googleusercontent.com/trLExRqfOgRKY6cZ8IF0IPgfnpfeTfNOyCVmWXJE1NovsvAsrrAUhwckbDQw_tY5KLy6Pf2DpO8PDllkjUQlMHVzWeL7-iEFvzWO430FglkKZMesiNMo7pBtzUs_vfmQZv8IWr3a)
|
Card |
---|
| ![](https://lh6.googleusercontent.com/Rg82H8ODqW6FUKANSYlzOVsPAuidgj4NKP8TUM1HPSoXSwi7PxLtZd__sfZ9jNUlvOiDyfxo8zE91QraXHPdBBKCar08ZnsjtOYcfnaPD3aH-90D4yiRy920J4_lzWwJBzg7vwGi)
|
Card |
---|
| ![](https://lh6.googleusercontent.com/3LtMt7cTkEUXnwdNXdLVWtV9tjY0Q-kEbs-vXPqgJ3MC44ufWkakwf_txv6tWa18qckN-XdUSZy0PGALXahFCW4UJKLVME31mtPvYgkNLEkiOOAbRSOuA-djubeEJ-o4i_nbGy5q)
|
Card |
---|
| ![](https://lh5.googleusercontent.com/tbWA_fvLx3uTRtHnLU8FgTas6lZuOaNeTJ33-lrhONjC5IigkN_E0-RXFyIYatJsOFVakmCpXcbZt74kUCMDpq7lzZpJ-HLHCd9lIP-fOZHAG7372sBBAxuVHHV6y2wVbl3Raswb)
|
|
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.
02. Tente renomear a pasta de instalação da plataforma.
03. Se o Sistema Operacional não permitir que a pasta seja renomeada, significa que algum arquivo está aberto ou em execução.
01. Se não for possível renomear a pasta de instalação, siga os passos abaixo para executar a atualização/instalação:
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. ![](https://lh4.googleusercontent.com/YrTzhKtrImgyBecmxYeWnep2owGaJu4ZHc1haIqbMFrOeuuaOs0mhbLL25ZkasY09lA3oFRMKUSjVjP5N6cajR4RFz6_Rx1VyFed-l-tc54UXmYDOzhu2uLct7dWIAAE2j41EdQM)
|
Card |
---|
| b) Acessar as propriedades de um dos serviços. ![](https://lh5.googleusercontent.com/zt6a1P3LDWDYD_6K_7zH5LwOcdYFzLxBzLjqD0lNkixUgidHLswo2k2reXDiM_b4Sih7h3MIV74s1M0yKNGXf8_IRf9-kcrASxEjL1z4ojkF2Dy_PM6y_ctl3HUOTy867-Z9u_LT)
|
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. ![](https://lh3.googleusercontent.com/tUWdw3SJzEriQbmfsJcBZRW1-TtIvPmr_n4oK86ttjc4QATn0ecGJWdX5E1WiKu1Y5Ywdi7YtJvy6QQgpyxSobNw2-RMsQ42ijNj53eZkaI7-wS9-zdK5Elabx3M3niankO7Fjo1)
|
|
01. Realizar a limpeza dos arquivos temporários e pastas keys, conforme o passo a passo abaixo:
a) Parar a execução dos serviços do Fluig: (1) fluig, (2) fluig_Indexer e (3) fluig_RealTime.
b) Acessar o diretório: <diretório de instalação do Fluig>/appserver/domain.
c) Eliminar as pastas: data, log, servers e tmp.
Aviso |
---|
|
Nesse diretório existe a pasta configuration, que não deve ser excluída, pois se trata de uma pasta fundamental para o funcionamento da plataforma. As demais pastas são todas temporárias. Caso a plataforma não as encontre, ela automaticamente recria as pastas. |
Informações |
---|
|
Esse procedimento reiniciará a plataforma e limpará os arquivos de log do ambiente. |
d) Apagar as pastas keys disponíveis nos caminhos:
- <diretório de instalação do Fluig>\repository\wcmdir
- <volume do Fluig>\keys.
e) Verificar se existem arquivos que NÃO estejam nos formatos .war, .ear ou .jar dentro das pastas apps, core e system. Caso existam, é necessário remover esses arquivos fora do formato das pastas:
- <diretório de instalação do Fluig>\appserver\apps
- <diretório de instalação do Fluig>\appserver\core
- <diretório de instalação do Fluig>\appserver\system
Nota |
---|
|
Os arquivos temporários gerados nestas pastas são excluídos no momento da finalização dos serviços, porém, em casos de desligamentos forçados do ambiente estes arquivos podem não ser excluídos automaticamente. Assim, é necessário fazer a exclusão manualmente, geralmente, os arquivos temporários estão no formato .tmp ou são diretórios como o mesmo nome. |
01. Reiniciar o servidor.
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)