Informações

title	Atenção

Esta página foi revisada para considerar as

novas

configurações de server

do fluig

para a atualização 1.6.3 ou superior.

Caso possua uma atualização entre 1.6.0 e 1.6.2, acesse: Como configurar load balance, alta disponibilidade e tolerância a falha na atualização 1.6 a 1.6.2?

Índice

maxLevel	4
outline	true
exclude	.*ndice
style	none

Objetivo

...

O objetivo deste guia é apresentar os procedimentos necessários para a criação de um ambiente fluig em cluster, onde é possível ter balanceamento TOTVS Fluig Plataforma com balanceamento de carga, afim de ter uma alta disponibilidade e tolerância a falha.

Considerações iniciais

...

O serviço de indexação (Solr) precisa ser único e é compartilhado por todas as instâncias;Um servidor de cache externo deve ser utilizado. Recomenda-se o Redis. TODO: Por link para configurar o Redis, podendo ser único ou em cluster;

O repositório de arquivos do Fluig da plataforma (Volume) deve estar em uma pasta compartilhada por todas as instâncias;

A pasta de aplicativos "(FLUIG_HOME[diretório_instalação]/appserver/apps" ) deve deve estar em uma pasta compartilhada um diretório compartilhado por todas as instâncias;

O banco de dados dever ser único para todas as instâncias;

Todas as instâncias devem estar atualizadas com a mesma versão do fluigTOTVS Fluig. Plataforma

Nota

title	Observação!

A partir da atualização Snowflake (1.6.3), o controle e sincronização do cache da plataforma é realizado através do banco de dados e é compartilhado entre todos os nós de um cluster.

Preparando ambiente

...

Antes de começar a instalação, é preciso estar com o ambiente preparado.

Acesse <FLUIG>\node\fluig.rt e localize o arquivo "package.json" para editá-lo.
Procure por “chatPort” e informe a mesma porta da propriedade “node.chat.url” do arquivo <NOVO_FLUIG>\repository\wcmdir\configuration\configuration.properties (edite ou crie o arquivo).
Procure por “realtimePort” e informe a mesma porta da propriedade “node.realtime.url” do arquivo <NOVO_FLUIG>\repository\wcmdir\configuration\configuration.properties (edite ou crie o arquivo).
Procure por “endPointPort”, caso a propriedade não exista no arquivo ela deve ser incluida junto com as propriedades citadas anteriormente. A porta padrão é a 8000. Exemplo: "endPointPort": 8000.
Em seguida, salve o arquivo.

Deck of Cards

effectDuration	0.5
history	false
id	samples
effectType	fade

Card

default	true
id	1
label	Passo1

Instale o banco de dados e crie uma instância.

Card

id	2
label	Passo 2

Instale e configure o servidor de cache externo (Redis) TODO: Link para instalação.

Card

id	3
label	Passo 3

Abra o prompt de comando do Windows e insira os comandos abaixo, um após o outro:

Bloco de código

language	xml

cd <NOVO_FLUIG>\appserver\bin\service <!-- Para acessar a pasta do fluig -->
service.bat install <!-- Para instalar os novos serviços -->
 
cd <NOVO_FLUIG> <!-- Para acessar a pasta raiz do fluig -->
nodeSetup.bat install <!-- Para instalar os novos serviços -->
 
cd <NOVO_FLUIG> <!-- Para acessar a pasta raiz do fluig -->
solrSetup.bat install <!-- Para instalar os novos serviços -->

Pronto! Os serviços foram criados.

Card

id	4
label	Passo 4

Agora é necessário alterar as portas da instalação manualmente.
Para isso, acesse <NOVO_FLUIG>\appserver\domain\configuration e localize o arquivo “host.xml” para editá-lo.

Nota

title	Importante!

É extremamente importante configurar o port offset dos servidores. O valor do port-offset deve ser um número que somado com o valor padrão das portas não gere conflito com as portas da outra instância. Exemplo: <socket-bindings port-offset="110" socket-binding-group="full-ha-sockets"/>

Caso não seja for alterado, ao tentar iniciar as duas instalações ocorrerá um conflito porque a porta já está sendo utilizada e um deles não funcionará.

O conteúdo apresentado a seguir se refere as linhas com as portas que devem ser alteradas. O conteúdo não é apresentado sequencialmente, este encontra-se disposto no decorrer do arquivo 'host.xml'.

host.xml

Bloco de código

language	xml

		<server auto-start="true" group="fluig" name="fluig1">
			<socket-bindings port-offset="110" socket-binding-group="full-ha-sockets"/>
			<jvm name="default">
				<heap max-size="4g" size="2g"/>
				<jvm-options>
					<option value="-Dfile.encoding=utf8"/>
					<option value="-Djsse.enableSNIExtension=false"/>
					<option value="-XX:MaxMetaspaceSize=512m"/>
					<option value="-Djavamelody.disabled=true"/>
					<option value="-Xdebug"/>
                        <option value="-Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n"/>
                </jvm-options>
			</jvm>
		</server>
		<server auto-start="false" group="fluig" name="fluig2">
			<socket-bindings port-offset="210" socket-binding-group="full-ha-sockets"/>
			<jvm name="default">
				<heap max-size="4g" size="2g"/>
				<jvm-options>
					<option value="-Dfile.encoding=utf8"/>
					<option value="-Djsse.enableSNIExtension=false"/>
					<option value="-XX:MaxMetaspaceSize=512m"/>
					<option value="-Djavamelody.disabled=true"/>
				</jvm-options>
			</jvm>
		</server>

Ao final das alterações, salve o arquivo.
Inclua também o arquivo <NOVO_FLUIG>\repository\wcmdir\configuration e edite ou crie o arquivo “configuration.properties”.

Bloco de código

language	bash

totvs/solrURL=http://10.80.81.59:8080/indexer
totvs/serverIPPort=8080
#Deve ser informada a mesma porta alterada no serviço
wcm/cacheServerAddress=localhost:11212
totvs/idp/acsURL=http://10.80.81.59:8080/portal/idp/ACS
webdesk/FTPPrivateFolderPort=8021
webdesk/OOoPort=15001,15002
node.chat.url=10.80.81.59:7777
node.realtime.url=10.80.81.59:8888

Card

id	5
label	Passo 5

Card

id	6
label	Passo 6

Inicie o Fluig na ordem recomendada: Fluig_Indexer, Fluig_RealTime e FLUIG.
Pronto! A segunda instância está instalada e configurada.

...

Escolha uma pasta em um servidor (chamaremos de GLOBAL_DATA_DIR) e torne-a acessível para todas as máquinas. Dentro dessa pasta compartilhada, crie uma nova pasta: "apps".

Aviso

title	Atenção!

Nas versões anteriores a 1.6.0, deverá também ser criada a pasta "wcmdir" dentro da GLOBAL_DATA_DIR.

Card

id	3
label	Passo 3

Escolha uma pasta em um servidor (chamaremos aqui de VOLUME_DIR)

...

e torne-a acessível para todas as máquinas

...

Tipos de configuração

. Será usada para salvar os volumes das empresas.

Configuração

...

Há dois modelos de configuração: apenas balanceamento de carga e alta disponibilidade com tolerância a falha.

...

Fluig em Load Balance com Apache mod_cluster em Linux

...

Plataforma em load balance com Microsoft NLB

Informações
Caso tiver dificuldades na Configuração do Fluig Realtime para execução em Load Balance clique no link para acesso a documentação.

Instruções para configuração de alta disponibilidade com tolerância a falha estão disponíveis aqui: Fluig em alta disponibilidade com tolerância a falha.

Passos para a Configuração

É possível configurar uma segunda instalação do Fluig em uma máquina na qual já existe uma instalação sendo executada. Para essa segunda instância é necessário criar novos serviços para serem executados pelo Windows e alterar todas as portas utilizadas pelo Fluig para não ocorrer qualquer conflito impedindo que as duas instalações sejam iniciadas ao mesmo tempo.

A seguir são apresentados os passos a serem executados para configurar a segunda instância:

Acesse <FLUIG>\node\fluig.rt e localize o arquivo "package.json" para editá-lo.
Procure por “chatPort” e informe a mesma porta da propriedade “node.chat.url” do arquivo <NOVO_FLUIG>\repository\wcmdir\configuration\configuration.properties (edite ou crie o arquivo).
Procure por “realtimePort” e informe a mesma porta da propriedade “node.realtime.url” do arquivo <NOVO_FLUIG>\repository\wcmdir\configuration\configuration.properties (edite ou crie o arquivo).
Procure por “endPointPort”, caso a propriedade não exista no arquivo ela deve ser incluida junto com as propriedades citadas anteriormente. A porta padrão é a 8000. Exemplo: "endPointPort": 8000.
Em seguida, salve o arquivo.

Inicie o Fluig na ordem recomendada: Fluig_Indexer, Fluig_RealTime e FLUIG.
Pronto! A segunda instância está instalada e configurada.

Deck of Cards

effectDuration	0.5
history	false
id	samples
effectType	fade

Card

default	true
id	1
label	Passo1

Realize a instalação da segunda instância do Fluig normalmente.
Informações
title Nota
Informações sobre a instalação podem ser obtidas no Guia de instalação fluig.
No final da instalação, o sistema tentará criar os serviços do Windows, porém, eles não serão criados porque já existem serviços com o nome padrão. Por isso, os serviços devem ser criados manualmente, conforme os próximos passos.

Card

id	2
label	Passo 2

Acesse o diretório <NOVO_FLUIG>\appserver\bin\service e localize o arquivo “service.bat” para editá-lo.

Procure pelo trecho de configuração abaixo e altere o nome dos serviços nas variáveis SHORTNAME, DISPLAYNAME, DESCRIPTION:
Bloco de código
language xml
set SHORTNAME=fluig2 set DISPLAYNAME="fluig2" set DESCRIPTION="fluig Application Server2"
Em seguida, salve o arquivo

Acesse o diretório <NOVO_FLUIG> e localize o arquivo “solrSetup.bat” para editá-lo.
- Procure pelo trecho de configuração abaixo e altere o nome dos serviços nas variáveis SVCNAME, SVCDISP, SVCDESC e NOPAUSE :
  Bloco de código
  language xml
  set SVCNAME=fluig_Indexer2 set SVCDISP=fluig_Indexer2 set SVCDESC=fluig Indexer2 set NOPAUSE=Y
- Em seguida, salve o arquivo.
Acesse o diretório <NOVO_FLUIG> e localize o arquivo “nodeSetup.bat” para editá-lo.
- Procure pelo trecho de configuração abaixo e altere o nome dos serviços nas variáveis SVCNAME, SVCDISP, SVCDESC e NOPAUSE :
  Bloco de código
  language xml
  set SVCNAME=fluig_RealTime2 set SVCDISP=fluig_RealTime2 set SVCDESC=fluig Realtime2 set NOPAUSE=Y
- Em seguida, salve o arquivo.

Card

id	3
label	Passo 3

Abra o prompt de comando do Windows e insira os comandos abaixo, um após o outro:

Bloco de código

language	xml

cd <NOVO_FLUIG>\appserver\bin\service <!-- Para acessar a pasta do fluig -->
service.bat install <!-- Para instalar os novos serviços -->
 
cd <NOVO_FLUIG> <!-- Para acessar a pasta raiz do fluig -->
nodeSetup.bat install <!-- Para instalar os novos serviços -->
 
cd <NOVO_FLUIG> <!-- Para acessar a pasta raiz do fluig -->
solrSetup.bat install <!-- Para instalar os novos serviços -->

Pronto! Os serviços foram criados.

Card

id	4
label	Passo 4

Agora é necessário alterar as portas da instalação manualmente.
Para isso, acesse <NOVO_FLUIG>\appserver\domain\configuration e localize o arquivo “host.xml” para editá-lo.

Nota

title	Importante!

É extremamente importante configurar o port offset dos servidores. O valor do port-offset deve ser um número que somado com o valor padrão das portas não gere conflito com as portas da outra instância. Exemplo: <socket-bindings port-offset="110" socket-binding-group="full-ha-sockets"/>

Caso não seja for alterado, ao tentar iniciar as duas instalações ocorrerá um conflito porque a porta já está sendo utilizada e um deles não funcionará.

O conteúdo apresentado a seguir se refere as linhas com as portas que devem ser alteradas. O conteúdo não é apresentado sequencialmente, este encontra-se disposto no decorrer do arquivo 'host.xml'.

host.xml

Bloco de código

language	xml

		<server auto-start="true" group="fluig" name="fluig1">
			<socket-bindings port-offset="110" socket-binding-group="full-ha-sockets"/>
			<jvm name="default">
				<heap max-size="4g" size="2g"/>
				<jvm-options>
					<option value="-Dfile.encoding=utf8"/>
					<option value="-Djsse.enableSNIExtension=false"/>
					<option value="-XX:MaxMetaspaceSize=512m"/>
					<option value="-Djavamelody.disabled=true"/>
					<option value="-Xdebug"/>
                        <option value="-Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n"/>
                </jvm-options>
			</jvm>
		</server>
		<server auto-start="false" group="fluig" name="fluig2">
			<socket-bindings port-offset="210" socket-binding-group="full-ha-sockets"/>
			<jvm name="default">
				<heap max-size="4g" size="2g"/>
				<jvm-options>
					<option value="-Dfile.encoding=utf8"/>
					<option value="-Djsse.enableSNIExtension=false"/>
					<option value="-XX:MaxMetaspaceSize=512m"/>
					<option value="-Djavamelody.disabled=true"/>
				</jvm-options>
			</jvm>
		</server>

Ao final das alterações, salve o arquivo.
Inclua também o arquivo <NOVO_FLUIG>\repository\wcmdir\configuration e edite ou crie o arquivo “configuration.properties”.

Bloco de código

language	bash

totvs/solrURL=http://10.80.81.59:8080/indexer
totvs/serverIPPort=8080
#Deve ser informada a mesma porta alterada no serviço
wcm/cacheServerAddress=localhost:11212
totvs/idp/acsURL=http://10.80.81.59:8080/portal/idp/ACS
webdesk/FTPPrivateFolderPort=8021
webdesk/OOoPort=15001,15002
node.chat.url=10.80.81.59:7777
node.realtime.url=10.80.81.59:8888

Card

id	5
label	Passo 5

Card

id	6
label	Passo 6

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 20

Nova versão Atual

Chave

Índice

Objetivo

Considerações iniciais

Preparando ambiente

Tipos de configuração

Configuração

Passos para a Configuração

Atalhos

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 20

Nova versão Atual

Chave

Índice

Objetivo

Considerações iniciais

Preparando ambiente

Tipos de configuração

Configuração

Passos para a Configuração