Í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

• Interesse em instalar/atualizar o ambiente de acordo com o Guia de instalação da plataforma ou o Guia de atualização da plataforma, respectivamente.
• Servidores respeitando o Modelo de dimensionamento.
• Plataforma de acordo com os padrões da Matriz de portabilidade.
• Conferir outras Especificações Técnicas necessárias.

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:

• A opção Administrador precisa estar marcada.

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

• 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

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.

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.

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

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)