Índice

Objetivo

...

O objetivo deste guia é apresentar os procedimentos necessários para efetuar a atualização do fluigTOTVS Fluig Plataforma.

Para acompanhar informações sobre Atualização Programada e sobre o Ciclo de Atualização Obrigatório do fluig acesse Atualização fluig.

, acesse Atualização da plataforma.

Pré-requisitos

...

Gerais

• É imprescindível parar todos os serviços antes de atualizar

  o

  a plataforma: fluig

  : FLUIG

  , fluig_

  Memcached

  Indexer, fluig_Realtime,

  Prizm

  fluig_memCached ou redis (para ambientes de alta disponibilidade ou com servidores de cache configurados) e Prizm (esse serviço só existe se você utiliza o

  fluig Viewer localmente

  Fluig Viewer localmente).

  Nota
  title Importante!
  Lembramos que, para ambientes de alta disponibilidade, todos os serviços devem estar parados e nenhum arquivo ou pasta deve estar aberto (isso inclui mapeamento de pastas ou arquivos).

• Realizar o backup da instalação, conforme descrito no guia guia Backup da aplicação fluig.

...

Para efetuar a atualização do fluig, é necessário seguir os passos descritos a seguir:

...

• Se houver a necessidade de downgrade, a base deverá ser restaurada para o backup da versão.
  Sobre o downgrade: Caso o fluig for atualizado para a versão 1.3.6 e deseja-se retornar para a versão 1.3.5, por exemplo, será necessário restaurar o backup da versão 1.3.5, não contendo os dados adicionados na versão mais atual.
  

• Para atualização para o fluig 1.5 atente-se guia fluig 1.5 - Inicialização com LMS.

• .

• Antes de atualizar a plataforma no ambiente de produção, crie um ambiente de homologação e realize os testes necessários. 

• Recomendamos que seja realizado o download sempre da última versão do instalador no Portal do Cliente.

  Nota
  title Importante!
  Ressaltamos que não disponibilizamos o instalador para pacotes específicos que não estejam disponíveis no Portal do cliente. Sempre disponibilizamos no Portal o instalador para a última atualização disponível, que já contempla todas as correções e melhorias liberadas.

• Caso venha a ocorrer algum problema durante a instalação, antes de fazer o rollback, recomendamos salvar os arquivos server.log (localizado em [diretório_instalação]\appserver\domain\servers\fluig1\log) e install.log (localizado em [diretório_instalação]) e abrir chamado com essas evidências, para que o time de atendimento TOTVS Fluig possa analisar.

Atualização 1.8

...

Versão mínima do Fluig

A instalação da atualização 1.8.2 (Crystal Mist) exige que a plataforma esteja no mínimo na atualização 1.7.1 (Crystal Lake). 

• Caso seu ambiente esteja em uma release anterior, é necessário primeiramente atualizar para o pacote mais recente da 1.7.1, disponível para download no Portal de Clientes. Após a atualização, basta subir os serviços, iniciar a plataforma e, só então, atualizar para a versão 1.8.2.

• Caso seu ambiente esteja na release 1.7.1, é necessário primeiramente atualizar para o pacote mais recente da 1.7.1, disponível para download no Portal de Clientes, subir os serviços,  iniciar a plataforma e, só então, atualizar para a 1.8.2. 

• Caso seu ambiente esteja na release 1.8.0 é necessário primeiramente atualizar para o pacote mais recente da 1.8.0, disponível para download no Portal de Clientes, subir os serviços, iniciar a plataforma e, só então, atualizar para a 1.8.2.

• Caso seu ambiente esteja na release 1.8.1 é necessário primeiramente atualizar para o pacote mais recente da 1.8.1, disponível para download no Portal de Clientes, subir os serviços, iniciar a plataforma e, só então, atualizar para a 1.8.2.

Reindexação completa

Na release 1.8.2 (Crystal Mist) o Servidor de indexação (Solr) foi atualizado para a versão 9.4.1. Essa atualização impacta diretamente no recurso de buscas da plataforma. Por esse motivo, para que a busca continue funcionando corretamente após a atualização, é necessário realizar a reindexação completa (com a opção de recriar os índices) no ambiente. Esse procedimento simples irá evitar que o recurso apresente instabilidades, como resultados duplicados ou documentos não encontrados.

Atualização 1.7

• A atualização para a release 1.7.x deve ser efetuada apenas se a instalação atual estiver na release 1.6.5 (Liquid). Para baixar o pacote da 1.6.5, acesse o Portal do cliente.

• Após a atualização para a 1.7.1 (Crystal Lake), acesse o recurso de Indexação e faça uma reindexação completa dos conteúdos do repositório da plataforma, marcando inclusive a opção para Recriar o índice.

Ajuste de processos e arquivos abertos para Fluig Indexer (Solr) em sistemas operacionais Linux

Starting Node server ... done
*** [WARN] *** Your open file limit is currently 1024. 
It should be set to 65000 to avoid operational disruption. 
If you no longer wish to see this warning, set SOLR_ULIMIT_CHECKS to false in your profile or solr.in.sh
*** [WARN] *** Your Max Processes Limit is currently 62191. 
It should be set to 65000 to avoid operational disruption. 
If you no longer wish to see this warning, set SOLR_ULIMIT_CHECKS to false in your profile or solr.in.sh
Waiting up to 180 seconds to see Solr running on port 8983 [\] 
Started Solr server on port 8983 (pid=54541). Happy searching!

Trata-se de variáveis de ambiente Linux utilizadas para definir um limite de arquivos abertos e um número máximo de processos rodando.

Os valores default no Linux para estas variáveis não são os ideais para alta performance do Fluig Indexer (Solr), por isso são sugeridos os valores desejáveis nestas mensagens.

Para realizar essa configuração, é necessário editar o arquivo /etc/security/limits.conf, e ao final dele inserir os seguintes valores:

solr             soft    nofile          65000

solr             hard    nofile          65000

solr             soft    nproc           65000

solr             hard    nproc           65000

Após a configuração e o reinício do servidor a mensagem não será mais exibida no log da plataforma.

Atualização 1.6

• A atualização para a release 1.6.x deve ser efetuada apenas se a instalação atual estiver na release 1.5.13. Para baixar o pacote da 1.5.13, acesse o Portal do cliente.
  

• As bibliotecas JavaScript da plataforma foram atualizadas, portanto é preciso realizar novos testes com os formulários já cadastrados para garantir que não ocorram conflitos com versões mais antigas destas mesmas bibliotecas.

• Os desenvolvimentos sob a plataforma com dependências diretas do Java deverão ser recompilados com a versão Java 1.8. 

• Os componentes da TOTVS Store devem ser atualizados para nova versão compatível com a release 1.6.
  

• Após a atualização, acesse o recurso de Indexação e faça uma reindexação completa dos conteúdos do repositório da plataforma, marcando inclusive a opção para Recriar o índice.

• A estrutura de pastas e arquivos no diretório de instalação da plataforma foram alteradas. As principais diferenças podem ser consultadas em Localização dos arquivos na pasta de instalação da release 1.6. 
  

• Caso utilize autenticação LDAP, siga os procedimentos descritos aqui.

Atualização 1.5

• Para atualização da plataforma para a release 1.5, consulte o guia Fluig 1.5 - Inicialização com LMS.

Atualização 1.2.8

• Clientes que estiverem utilizando a plataforma

...

• abaixo da atualização 1.2.8 devem entrar em contato

...

• com o Suporte TOTVS Fluig antes de executar a atualização.

Procedimentos para efetuar a atualização

Âncora
atualização atualização

...

Para efetuar a atualização do TOTVS Fluig Plataforma, é necessário seguir os passos descritos a seguir:

<simple name="java:global/wcm/globalDataDir" value="GLOBAL_DATA_DIR/wcmdir"/>

...

...

...

Atualização em ambiente

...

Windows - Modo caractere

...

As instruções para realizar o atualização do TOTVS Fluig Plataforma e dos módulos separadamente estão informados abaixo:

java -cp fluig-installer.jar com.fluig.wcm.update.FluigUpdate <diretório de instalação>

java -cp fluig-installer.jar com.fluig.wcm.update.FluigUpdate solr <diretório de instalação>

java -cp fluig-installer.jar com.fluig.wcm.update.FluigUpdate nodejs <diretório de instalação>

Atualização em ambiente Linux - Modo caractere

...

As instruções para realizar o atualização do TOTVS Fluig Plataforma e dos módulos separadamente estão informados abaixo:

...

...

...

• Descompacte o instalador do fluig.

./jdk-64/bin/java -cp fluig-installer.jar com.fluig.wcm.update.FluigUpdate <diretório de instalação>

...

...

./jdk-64/bin/java -cp fluig-installer.jar com.fluig.wcm.update.FluigUpdate solr <diretório de instalação>

...

./jdk-64/bin/java -cp fluig-installer.jar com.fluig.wcm.update.FluigUpdate nodejs <diretório de instalação>

Atualização com balanceamento de carga, alta disponibilidade e tolerância à falha - Cluster

<script>
	$("b:contains('oculto')").parent().parent().hide();
</script>