TOTVS Fluig

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 8

changes.mady.by.user Vanei Anderson Heidemann

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Denise De Deus

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

 

Índice

Índice
maxLevel4
outlinetrue
exclude.*ndice
stylenone

 


Introdução

...

Em ambientes onde a quantidade de documentos é consideravelmente grande, é aconselhado a utilização de um servidor dedicado para indexação, podendo inclusive ser necessário criar configurado um cluster com dois ou mais servidores para dividir garantir a cargadisponibilidade do serviço.


Considerações iniciais

...

O

...

acesso ao repositório de documentos do Fluig (Volume) pelo Servidor de indexação executando em servidor separado,

...

é opcional. Porém, é importante notar que a performance de extração é

...

superior quando o servidor de indexação tem acesso ao repositório.

...

Se este for o caso, todas as instâncias do servidor de indexação deverão ter acesso compartilhado ao repositório.

Também é fundamental que esta pasta compartilhada esteja localizada no endereço informado nas configurações da empresa do Fluig.


Preparando o

 

...

ambiente

...

Antes de começar a instalaçãoconfiguração, siga os passos a seguirda atualização correspondente:

Deck of Cards
idPreEnvIndexerConfig
Card
defaulttrue
id1
labelPasso 1

Instale o Fluig Server.

Card
id2
labelPasso 2

Remova ou desabilite o serviço fluig_Indexer, seguindo os procedimentos normais do Sistema Operacional onde o fluig foi instalado.

Card
id3
labelPasso 3

Baixe o arquivo {Fluig-Indexer-1.6.zip}  FluigIndexer-1.5.zip. TODO:

 

Instalando o Fluig Indexer Server

Deck of Cards
idInstallSolr
Card
defaulttrue
id1
labelPasso 1

Descompacte o arquivo Fluig-Indexer-1.6.zip para um diretório do servidor de indexação. Ex: c:\FluigIndexer, /opt/FluigIndexer.

Card
id2
labelPasso 2

Certifique-se que exista um Java 8 instalado na máquina. Se não houver instalado, copie a pasta jdk-64 da instalação do fluig para dentro da pasta de instalação do Fluig Indexer.

 

Configurando o Fluig Indexer Server

As configurações do Solr devem ser feitas no arquivo <fluigIndexer>/solr/bin/solr.in.sh (no Linux) ou <fluigIndexer>/solr/bin/solr.in.cmd (no Windows).

A partir da 1.6.1
Card
id2
label1.6.0 ou anteriores


Configurações do Servidor de indexação

...

O arquivo onde as configurações do Servidor de indexação devem ser realizadas dependem da forma como é feita a inicialização do serviço de indexação.

Por padrão, estes valores já vem preenchidos na instalação. Porém, dependendo do dimensionamento do ambiente, será necessário alterar estas configurações.

Sistema operacionalArquivo de configuraçãoLocalização
Linuxfluig_Indexer.in.sh/etc/default/
Windowssolr.in.cmd[Instalação fluig Indexer]/solr/bin/

No arquivo de configuração do Solr devem ser efetuados os seguintes ajustes:

...

Deck of Cards
idSolrConfig
Card
defaulttrue
id1
labelMemória

Definindo a quantidade de memória disponível para o Solr

A configuração padrão do Solr reserva

...

512 MB de memória, o que pode ser pouco para a maioria dos casos. Para aumentar a memória disponível,

...

remova a marcação de comentário (#) e altere os valores das propriedades SOLR_HEAP (Linux) e/ou SOLR_JAVA_MEM (Linux / Windows).

Bloco de código
languagebash
titleNo Linux
SOLR_HEAP="512m"
#SOLR_JAVA_MEM="-Xms512m -

...

Xmx1024m"
Bloco de código
languagebash
titleNo Windows
set SOLR_JAVA_MEM=-Xms512m -

...

Xmx1024m
Nota
titleImportante!

O estouro na memória do Solr pode ocasionar inconsistências no TOTVS Fluig Plataforma, como erros na busca ou em algumas APIs de documento. No entanto, não é possível estabelecer previamente o valor de memória a ser reservado, pois o uso de memória no ambiente muda devido ao número de documentos, extensão dos arquivos e utilização. Por exemplo um arquivo XLS e um CSV serão processados de forma diferente, e o mesmo ocorre com um PDF e um DOC.

Por esse motivo, recomendamos acompanhar o consumo de memória durante os horários de maior utilização da plataforma e realizar o dimensionamento adicionando entre 25 a 50% acima. É uma boa prática reanalisar periodicamente os logs ou monitorar com relatórios de métricas para ver se o uso de memória mudou e a memória deve ser aumentada. Para mais detalhes, consulte a documentação do Solr.

Card
id2
labelJava

Definindo o caminho do Java

Se o executável Java não estiver

...

configurado na variável de ambiente Path do sistema operacional, configure o caminho do executável

...

através do arquivo de configuração,

...

 

removendo a marcação de comentário (#) e alterando a variável SOLR_JAVA_HOME.

...

Exemplo: "C:\[fluig Indexer]\jdk-64\bin\java.exe".

Bloco de código
languagebash
titleNo Linux
#SOLR_JAVA_HOME=""
Bloco de código
languagebash
titleNo Windows
REM set SOLR_JAVA_HOME=
Card
id3
labelEndereço

...

Definindo o IP do Servidor de

...

indexação - (Opcional)

Caso queira fixar o IP do servidor no qual o Solr ouve as conexões,

...

remova a marcação de comentário (# ou REM) e altere a variável SOLR_HOST.

 

Bloco de código
languagebash
titleNo Linux
#SOLR_HOST="192.168.1.1"
Bloco de código
languagebash
titleNo Windows
REM set SOLR_HOST=192.168.1.1
Card
id4
labelPorta

...

Alteração da porta [Default: 8983] - (Opcional)

Caso queira alterar a porta na qual o Solr ouve as conexões,

...

remova a marcação de comentário (# ou REM) e altere a variável SOLR_PORT.

 

Bloco de código
languagebash
titleNo Linux
#SOLR_PORT=8983
Bloco de código
languagebash
titleNo Windows
REM set SOLR_PORT=8983


 

Servidor isolado ou cluster

Alta disponibilidade

Se desejar configurar um único servidor Fluig Indexerimplementar servidores para o serviço de indexação na configuração Master/Slave, continue a instalação em Fluig Indexer em um único servidor dedicado.

Se desejar configurar um cluster de servidores Fluig Indexer, continue a instalação em Fluig Indexer em um cluster de servidores dedicados.

 

Configurando o Fluig Server para usar o Fluig Indexer

No servidor onde está instalado o Fluig Server, acesse o diretório <fluig-server>/repository/wcmdir/config/

 

Edite ou crie o arquivo configuration.properties e localize a seguinte linha (outras formas de configuração):

Bloco de código
languagehtml/xml
totvs/solrURL=http://<Fluig Indexer Host>:8080/solr

 

E modifique para o <IP>:<Porta> onde está executando o Fluig Indexer. Deverá ser informado o IP ou HostName do servidor onde está instalado o serviço de indexação.

Bloco de código
languagehtml/xml
totvs/solrURL=http://<Fluig Indexer Host>:<Fluig Indexer Port>/solr

 

Executando o Fluig Indexer

Basta executar o arquivo <fluigIndexer>/solr/startStandalone.sh ou <fluigIndexer>/solr/startStandalone.bat que o processo irá iniciar. Para interromper, execute o arquivo <fluigIndexer>/solr/stopStandalone.sh ou <fluigIndexer>/solr/stopStandalone.bat.

Obs: É importante que o Fluig Indexer seja iniciado antes do Fluig, caso contrário este irá considerar que não há Serviço de Indexação disponível.

 

Registrando o Fluig Indexer como Serviço no Windows/Linux

Para registrar Fluig Indexer como serviço, utilize os procedimentos padrões do Sistema Operacional em questão.

 

Atualizando o Fluig Indexer

Sempre que houver uma atualização do Fluig Indexer, é necessário seguir o procedimento de descompactar o arquivo zip. Mas antes faça um backup dos arquivos que eventualmente tenha alterado (como por exemplo os scripts de inicialização ou configuração).

conforme os procedimentos descritos na documentação Servidor de indexação em alta disponibilidade.


Atualizando o Servidor de indexação

...

A atualização do Servidor de indexação deve ser realizada conforme o Guia de atualização da plataforma atentando-se para o item Atualização com balanceamento de carga, alta disponibilidade e tolerância à falha - Cluster.

Após a atualização, inicie o serviço do servidor de indexação dedicado.