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:
|
04. Em caráter de teste, tente iniciar o instalador por linha de comando:
|
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
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:
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.
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:
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:
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.
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. |
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:
