Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Índice

Índice
excludeÍ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.

...

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. Inicie a sessão no Sistema Operacional com um usuário que possua propriedades administrativas no servidor.

03. Verificar que 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;
  • Clicar em Propriedades.

Image Removed

04. Iniciar o instalador por linha de comando, seguindo os passos abaixo:

  • Abra o prompt de comando através do botão direito do mouse e escolha a opção Executar como administrador, conforme a imagem abaixo:

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

01. Nesse caso, apenas o serviço "fluig" apresenta esse comportamento. Os demais serviços (fluig_Indexer e fluig_RealTime) funcionam corretamente.

Parando.pngImage Removed


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
titleImportante

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
ididentificar
Card
labelPasso 1
  • 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
labelPasso 2
  • Acessar as propriedades dos serviços.

Image Added

Card
labelPasso 3
  • 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 é específico da plataforma 02. Esse comportamento não é do Fluig em si e, geralmente, está associado a interferências externaexternas, seja de outra aplicação, servidor, etc. Os cenários A maior parte dos relatos estão relacionados ao serviço "fluig", os demais serviços (fluig_Indexer e fluig_RealTime) nunca apresentaram tal eventualidade.

Informações
titleOs 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.

...

Informações
titleRecomendação

O ideal é que o servidor seja dedicado à plataforma, sem que haja outros sistemas operando em conjunto.


Preparamos alguns procedimentos a serem feitos para que a instalação/atualização possa prosseguir:

01. Desativar outras aplicações Java e avaliar 04. Caso seu servidor tenha essas características, faça um teste desativando as aplicações e avalie 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
ididentificar
Card
labelPasso 1
  • Fechar todas as aplicações abertas.
  • Acionar Executar.

Image Added

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

Image Added

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

Image Added

Card
labelPasso 4
  • 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 Added

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

Informações
titleInformação

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
ididentificar
Card
labelPasso 1
  • 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 Added

Card
labelPasso 2
  • Se certifique que está na aba Processos.
  • Buscar em Processos em segundo plano pelos termos "OpenJDK Platform binary" e "Node.js JavaScript Runtime".

Image Added

Card
labelPasso 3
  • Acionar o recurso Finalizar tarefa para cada processo em segundo plano relacionado ao "OpenJDK Platform binary" e ao "Node.js JavaScript Runtime".

Image Added

Card
labelPasso 4
  • 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 Added


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

...

  • 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
titleInformação
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.

...

Aviso
titleAviso
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.


0402. Abaixo seguem alguns exemplos das mensagens que podem aparecer em tela:

Deck of Cards
ididentificar
Card
labelExemplo 1

Image Modified

Card
labelExemplo 2

Image Modified

Card
labelExemplo 3

Image Modified

Card
labelExemplo 4

Image Modified

Card
labelExemplo 5

Image Modified

Card
labelExemplo 6

Image Modified

Card
labelExemplo 7

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.

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:

...


Verificar as 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:

Deck of Cards
ididentificar
Card
labelPasso 1
  • Buscar pelo o Painel de Controle do Windows.

Image Added

Card
labelPasso 2
  • Acionar Contas de Usuário.

Image Added

Card
labelPasso 3
  • Acionar Contas de Usuário novamente.

Image Added

Card
labelPasso 4
  • Clicar em Gerenciar Contas de Usuários.

Image Added

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

Image Added

Card
labelPasso 6
  • A opção Administrador precisa estar marcada.

Image Added

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

Deck of Cards
ididentificar
Card
labelPasso 1
  • 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:

Image Added

Card
labelPasso 2
  • 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.

Image Added

Card
labelPasso 3
  • Ao acessar a pasta do instalador, execute o arquivo Fluig-Installer-64.exe.
  • A tela do instalador/atualizador será exibida e o processo de atualização prosseguirá normalmente.

Image Added


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. Para consultar:

Deck of Cards
ididentificar
Card
labelPasso 1
  • Pesquisar pelo Painel de Controle no campo de busca do Windows.

Image Added

Card
labelPasso 2
  • Acionar a opção Sistema e Segurança.

Image Added

Card
labelPasso 3
  • Clicar em Ferramentas do Windows.

Image Added

Card
labelPasso 4
  • Clicar em Visualizador de Eventos.

Image Added

Card
labelPasso 5
  • 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
ididentificar
Card
labelPasso 1
  • Pesquisar pelo Painel de Controle no campo de busca do Windows.

Image Added

Card
labelPasso 2
  • Acionar a opção Sistema e Segurança.

Image Added

Card
labelPasso 3
  • Clicar em Ferramentas do Windows.

Image Added

Card
labelPasso 4
  • Clicar em Monitor de Recursos.

Image Added

Card
labelPasso 5
  • 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.

Exibindo image.pngImage Added

Card
labelPasso 6
  • 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


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)