Esta página foi revisada para considerar as novas configurações de server do fluig para a atualização 1.6.

Índice

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 de carga, alta disponibilidade e tolerância a falha.

 

Tipos de configuração

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

Instruções para configuração de balanceamento de carga estão disponíveis aqui: Fluig em Load Balance com Apache mod_cluster em Linux.

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:

 

 

  • Realize a instalação da segunda instância do Fluig normalmente.

    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.

 

 

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

    1. Procure pelo trecho de configuração abaixo e altere o nome dos serviços nas variáveis SHORTNAME, DISPLAYNAME, DESCRIPTION:

      set SHORTNAME=fluig2
set DISPLAYNAME="fluig2"
set DESCRIPTION="fluig Application Server2"

    2. Em seguida, salve o arquivo
       

  2. Acesse o diretório <NOVO_FLUIG> e localize o arquivo “solrSetup.bat” para editá-lo.

    1. Procure pelo trecho de configuração abaixo e altere o nome dos serviços nas variáveis SVCNAME, SVCDISP, SVCDESC e NOPAUSE :

      set SVCNAME=fluig_Indexer2
set SVCDISP=fluig_Indexer2
set SVCDESC=fluig Indexer2
set NOPAUSE=Y

    2. Em seguida, salve o arquivo.
       

  3. Acesse o diretório <NOVO_FLUIG> e localize o arquivo “nodeSetup.bat” para editá-lo.

    1. Procure pelo trecho de configuração abaixo e altere o nome dos serviços nas variáveis SVCNAME, SVCDISP, SVCDESC e NOPAUSE :

      set SVCNAME=fluig_RealTime2
set SVCDISP=fluig_RealTime2
set SVCDESC=fluig Realtime2
set NOPAUSE=Y

    2. Em seguida, salve o arquivo.

 

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

    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.

 

 

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

 

É 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

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

 

 


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