Índice
Í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.
Preparando ambiente
Antes de começar a instalação, é preciso estar com o ambiente preparado. Faça o seguinte:
...
...
Considerações iniciais
...
- O serviço de indexação (Solr) precisa ser único e é compartilhado por todas as instâncias, 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/jboss[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;
- É preciso manter afinidade de sessão, ou seja, uma vez que o usuário logou acessando em uma instância, sempre será direcionado para a mesma instância.
- Todas as instâncias devem estar atualizadas com a mesma versão do fluigTOTVS Fluig.
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:
Nota |
---|
|
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.
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. 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.
|
- Instale o banco de dados e crie uma instância.
|
Card |
---|
|
- 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 |
---|
| Nas versões anteriores a 1.6.0, deverá também ser criada a pasta "wcmdir" dentro da GLOBAL_DATA_DIR |
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 |
---|
| 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 |
---|
| 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 |
---|
| set SVCNAME=fluig_RealTime2
set SVCDISP=fluig_RealTime2
set SVCDESC=fluig Realtime2
set NOPAUSE=Y | Em seguida, salve o arquivo |
Card |
---|
| Abra o prompt de comando do Windows e insira os comandos abaixo, um após o outro: Bloco de código |
---|
| 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 |
---|
| 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 |
---|
| É 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 |
---|
| <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 |
---|
| 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 |
|
- Escolha uma pasta em um servidor (chamaremos aqui de VOLUME_DIR) e torne-a acessível para todas as máquinas. Será usada para salvar os volumes das empresas.
|
|
Configuração
...
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. Card |
---|
|
|
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.
Card |
---|
|
Inicie o Fluig na ordem recomendada: Fluig_Indexer, Fluig_RealTime e FLUIG.
Pronto! A segunda instância está instalada e configurada.