apitdn/fluig_rag_docs/Plataforma Documentação técnica/Instalação e Atualização/Erros comuns ao instalaratualizar a plataforma.md

---
title: Erros comuns ao instalar/atualizar a plataforma
source: https://tdn.totvs.com/pages/viewpage.action?pageId=819058035
path: \Plataforma  Documentação técnica\Instalação e Atualização\Erros comuns ao instalaratualizar a plataforma.md
---

- [Objetivo](#Erroscomunsaoinstalar/atualizaraplataforma-Objetivo)
- [Pré-requisitos](#Erroscomunsaoinstalar/atualizaraplataforma-Pré-requisitos)
- [Sistema operacional Windows](#Erroscomunsaoinstalar/atualizaraplataforma-SistemaoperacionalWindows)
  - [Alterar o tipo de inicialização dos serviços para manual](#Erroscomunsaoinstalar/atualizaraplataforma-Alterarotipodeinicializaçãodosserviçosparamanual)
  - [Serviço "fluig" permanece com o status "stopping" (ou "parando")](#Erroscomunsaoinstalar/atualizaraplataforma-Serviço"fluig"permanececomostatus"stopping"(ou"parando"))
  - [Mensagens durante a instalação/atualização](#Erroscomunsaoinstalar/atualizaraplataforma-Mensagensduranteainstalação/atualização)
  - [Renomear o diretório de instalação (teste)](#Erroscomunsaoinstalar/atualizaraplataforma-Renomearodiretóriodeinstalação(teste))
  - [Verificar as permissões do usuário executor da mídia](#Erroscomunsaoinstalar/atualizaraplataforma-Verificaraspermissõesdousuárioexecutordamídia)
  - [Consultar o log de eventos do Windows](#Erroscomunsaoinstalar/atualizaraplataforma-ConsultarologdeeventosdoWindows)
  - [Monitor de recursos do Windows](#Erroscomunsaoinstalar/atualizaraplataforma-MonitorderecursosdoWindows)
  - [Limpeza de arquivos temporários e pastas keys](#Erroscomunsaoinstalar/atualizaraplataforma-Limpezadearquivostemporáriosepastaskeys)
  - [Nova tentativa de atualização](#Erroscomunsaoinstalar/atualizaraplataforma-Novatentativadeatualização)
- [Sistema operacional Linux](#Erroscomunsaoinstalar/atualizaraplataforma-SistemaoperacionalLinux)

# 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](Guia de instalação da plataforma.md) ou o [Guia de atualização da plataforma](Guia de atualização da plataforma.md), respectivamente.
- Servidores respeitando o [Modelo de dimensionamento](../Especificações Técnicas/Dimensionamento/Modelo de dimensionamento.md).
- Plataforma de acordo com os padrões da [Matriz de portabilidade](https://tdn.totvs.com/display/fluig/Matriz+de+portabilidade).
- Conferir outras [Especificações Técnicas](../Especificações Técnicas.md) 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.

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

Importante!

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

- Acessar a tela de **Serviços** do **Windows** e procure pelos serviços: (1) fluig, (2) fluig\_Indexer e (3) fluig\_RealTime.

![](..\..\images\YrTzhKtrImgyBecmxYeWnep2owGaJu4ZHc1haIqbMFrOeuuaOs0mhbLL25ZkasY09lA3oFRMKUSjVjP5N6cajR4RFz6_Rx1VyFed-l-tc54UXmYDOzhu2uLct7dWIAAE2j41EdQM)

- Acessar as **propriedades** dos serviços.

![](..\..\images\zt6a1P3LDWDYD_6K_7zH5LwOcdYFzLxBzLjqD0lNkixUgidHLswo2k2reXDiM_b4Sih7h3MIV74s1M0yKNGXf8_IRf9-kcrASxEjL1z4ojkF2Dy_PM6y_ctl3HUOTy867-Z9u_LT)

- Alterar o **Tipo de Inicialização** de Automático para **Manual**.
- Fazer isso para (1) fluig, (2) fluig\_Indexer e (3) fluig\_RealTime.

![](..\..\images\tUWdw3SJzEriQbmfsJcBZRW1-TtIvPmr_n4oK86ttjc4QATn0ecGJWdX5E1WiKu1Y5Ywdi7YtJvy6QQgpyxSobNw2-RMsQ42ijNj53eZkaI7-wS9-zdK5Elabx3M3niankO7Fjo1)

## 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 e, geralmente, está associado a interferências externas, seja de outra aplicação, servidor, etc. 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.

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

Recomendaçã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 se ainda ocorre interferências ao finalizar o **serviço "fluig"**.

**02.** Conferir a documentação de [Portas e endereços](../Especificações Técnicas/Portas e endereços.md) 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:

- Fechar **todas** as aplicações abertas.
- Acionar **Executar**.

![](..\..\images\image-2024-1-10_15-59-36.png)

- Digitar o termo **%tmp%** ou **%temp%** (ambos são válidos).

- Clicar em **Ok**.

![](..\..\images\image-2024-1-10_16-1-1.png)

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

![](..\..\images\image-2024-1-18_17-3-15.png)

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

![](..\..\images\image-2024-1-18_17-5-1.png)

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

Nota:

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.

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

![](..\..\images\image-2024-1-10_17-42-40.png)

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

![](..\..\images\image-2024-1-10_17-54-21.png)

- Acionar o recurso **Finalizar tarefa** para cada processo em segundo plano relacionado ao **"OpenJDK Platform binary"** e ao **"Node.js JavaScript Runtime"**.

![](..\..\images\image-2024-1-10_17-57-7.png)

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

![](..\..\images\image-2024-1-10_18-2-2.png)

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

Nota:

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.

Atenção!

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.

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

![](..\..\images\FoV7B6XDaReUoIxKfBaNI7LdQg2Qrvby-HhOBuwQmDNXWL947618KGFn4kbZYTuNzLIZc71xzGcdcRBPLeBxd3z9dEUj4rcfOoG0rhc5cX1571TBaWNy4n6tACw8EHZ77GxyoIIm)

![](..\..\images\zb3_DT80ETi6DrV1lgmeYobxER-DoWCOvH-c_K4pcctQId7jJdJBQRLKGVE52cP2EL0oQ0CBtNpdzT_DkjfQvTiFanB_2KB0pqtcELnKurOqbC9-4PKYr438xNVtFzn_GumFYVR7)

![](..\..\images\tBAnHHPDhU-UDBe8iwrx4R4eTDN6M4TDFbWFId9R3TtEVPmjLSO8eruMHVXJmxGqgqFZauW_M4WI1dSb4M-4VnlMr2Yu_J96qoTRk8CKwSJrCe4vH1ZjgtLFWMkCgtFy6aEwIJLM)

![](..\..\images\trLExRqfOgRKY6cZ8IF0IPgfnpfeTfNOyCVmWXJE1NovsvAsrrAUhwckbDQw_tY5KLy6Pf2DpO8PDllkjUQlMHVzWeL7-iEFvzWO430FglkKZMesiNMo7pBtzUs_vfmQZv8IWr3a)

![](..\..\images\Rg82H8ODqW6FUKANSYlzOVsPAuidgj4NKP8TUM1HPSoXSwi7PxLtZd__sfZ9jNUlvOiDyfxo8zE91QraXHPdBBKCar08ZnsjtOYcfnaPD3aH-90D4yiRy920J4_lzWwJBzg7vwGi)

![](..\..\images\3LtMt7cTkEUXnwdNXdLVWtV9tjY0Q-kEbs-vXPqgJ3MC44ufWkakwf_txv6tWa18qckN-XdUSZy0PGALXahFCW4UJKLVME31mtPvYgkNLEkiOOAbRSOuA-djubeEJ-o4i_nbGy5q)

![](..\..\images\tbWA_fvLx3uTRtHnLU8FgTas6lZuOaNeTJ33-lrhONjC5IigkN_E0-RXFyIYatJsOFVakmCpXcbZt74kUCMDpq7lzZpJ-HLHCd9lIP-fOZHAG7372sBBAxuVHHV6y2wVbl3Raswb)

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

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

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

- Buscar pelo o **Painel de Controle** do **Windows**.

![](..\..\images\image-2024-1-10_15-12-27.png)

- Acionar **Contas de Usuário**.

**![](..\..\images\image-2024-1-10_15-13-50.png)**

- Acionar **Contas de Usuário** novamente.

![](..\..\images\image-2024-1-10_15-14-50.png)

- Clicar em **Gerenciar Contas de Usuários**.

![](..\..\images\image-2024-1-18_17-8-13.png)

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

![](..\..\images\image-2024-1-18_17-10-41.png)

- A opção **Administrador** precisa estar marcada.

**![](..\..\images\image-2024-1-18_17-12-18.png)**

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

**![](..\..\images\image-2024-1-10_15-39-55.png)**

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

![](..\..\images\passso-2.png)

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

![](..\..\images\passo-3.png)

## 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:**

- Pesquisar pelo **Painel de Controle** no campo de busca do **Windows**.

![](..\..\images\image-2024-1-10_18-32-3.png)

- Acionar a opção **Sistema e Segurança**.

![](..\..\images\image-2024-1-10_18-34-29.png)

- Clicar em **Ferramentas do Windows**.

![](..\..\images\image-2024-1-10_18-35-30.png)

- Clicar em **Visualizador de Eventos****.**

![](..\..\images\image-2024-1-10_18-39-31.png)

- O **Visualizador de Eventos** mostra diversas informações a respeito do tipo de evento e qual aplicação fez o disparo.

![](..\..\images\image-2024-1-10_18-45-57.png)

## 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:**

- Pesquisar pelo **Painel de Controle** no campo de busca do **Windows**.

![](..\..\images\image-2024-1-10_18-32-3.png)

- Acionar a opção **Sistema e Segurança**.

![](..\..\images\image-2024-1-10_18-34-29.png)

- Clicar em **Ferramentas do Windows**.

![](..\..\images\image-2024-1-10_18-35-30.png)

- Clicar em **Monitor de Recursos****.**

![](..\..\images\image-2024-1-11_12-6-35.png)

- 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.png](..\..\images\get_attachment_url)

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

![](..\..\images\image-2024-1-11_13-45-5.png)

## 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\standalone\log** (a partir da **2.0**) ou **<diretório de instalação do Fluig>\appserver\domain\servers\fluig1\log** (**1.6 até 1.8.2**).

**c)** Eliminar as pastas: **data, log, servers** e **tmp**.

Atençã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.

Nota:

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**

Importante!

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.** 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 do cliente](https://suporte.totvs.com/), através da opção: **Abrir ticket** e anexe esses arquivos ao chamado. Essa ação agilizará todo o processo de atendimento:

- **<diretório de instalação do Fluig>\appserver\standalone\configuration\standalone.xml**
- **<diretório de instalação do Fluig>\appserver\bin\standalone.conf**
- **<diretório de instalação do Fluig>\appserver\standalone\log\server.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)**

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