TOTVS Fluig

Atalhos

Árvore de páginas

Versões comparadas

Versão antiga 6

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 exclusivo 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

 


Alta disponibilidade

Se desejar implementar servidores para o serviço de indexação na configuração Master/Slave, continue a instalaçã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.

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