Índice


Objetivo

O objetivo deste guia é apresentar quais os problemas mais comuns ao efetuar a atualização do TOTVS Fluig Plataforma e como resolvê-los.


Pré-requisitos


Sistema Operacional Windows

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.


Permissões do usuário executor da mídia

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:


  • Buscar pelo o Painel de Controle do Windows.

  • Acionar Contas de Usuário.

  • Acionar Contas de Usuário novamente.

  • Clicar em Gerenciar Contas de Usuários.

  • Selecionar o usuário que está autenticado e clicar em Propriedades.

  • A opção Administrador precisa estar marcada.

04. Em caráter de teste, tente iniciar o instalador por linha de comando:


  • 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:


  • Se sua sessão não for de administrador, será necessário informar um login e senha antes de prosseguir;
  • Com o prompt aberto, navegue até a pasta descompactada onde contém a mídia do fluig.

  • 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.


Serviço "fluig" com status "stopping" ao tentar finalizar

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

  • 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:

03. Limpar os arquivos temporários do Windows, seguindo os passos abaixo:


  • Fechar todas as aplicações abertas.
  • Acionar Executar.

  • Digitar o termo %tmp% ou %temp% (ambos são válidos).
  • Clicar em Ok.

  • Abrirá a pasta de arquivos temporários do Windows.
  • Selecionar todos os arquivos (Ctrl + A).

  • 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.

04. Encerrar todas as tarefas do OpenJDK Platform binary e do Node.js JavaScript Runtime no Gerenciador de Tarefas do Windows.


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 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 usuários a acessam; quanto proativa, quando se tratam de fluxos automáticos, agendamentos de processamentos e demais tarefas automatizadas que possam estar configuradas.

Dessa forma, mesmo sem usuários utilizando o ambiente, existem integrações ou agendamentos de tarefas que são executados em segundo plano pelo Fluig.



 

 



05. 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.

Mensagens durante a instalação/atualização

01. Durante a instalação ou atualização da plataforma, podem surgir as seguintes mensagens de erro:

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:



Renomear o diretório de instalação

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.


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:


a) Acessar a tela de Serviços do Windows e procure pelos serviços: (1) fluig, (2) fluig_Indexer e (3) fluig_RealTime.

b) Acessar as propriedades de um dos serviços.

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.


Limpeza de arquivos temporários e pastas keys

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.

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.
Esse procedimento reiniciará a plataforma e limpará os arquivos de log do ambiente.

d) Apagar as pastas keys disponíveis nos caminhos:

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:

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.


Nova tentativa de atualização

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.


Sistema Operacional Linux

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: