Árvore de páginas

Versões comparadas

Chave

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

Índice

Í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. Verificar se o usuário que está executando o instalador possui permissão de administrador.

02. Executar o instalador conforme o artigo: Como iniciar o instalador/atualizador com usuário administrador no Windows.


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

02. Esse comportamento não é do Fluig em si e, geralmente, está associado a interferências externa, seja de outra aplicação, servidor, etc. Os cenários 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.

03. A recomendação é que exista um servidor dedicado à plataforma, sem que haja outros sistemas operando em conjunto.

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 do Fluig.


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

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.

Aviso
titleAtenção
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
titleInformação
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
titleImportante
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:

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