Árvore de páginas

Versões comparadas

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 será utilizado cluster, ou quando a quantidade de documentos é consideravelmente grande, é aconselhado a utilização de um servidor exclusivo para indexação.

Segue as instruções para a instalação e configuração deste:

 dedicado para indexação, podendo inclusive ser configurado um cluster com dois ou mais servidores para garantir a disponibilidade 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 seguir:

...

 

Instalando o Fluig Indexer Server

...

 

Fluig Indexer Server sem acesso ao repositório

Caso o servidor onde o Indexer Server for instalado não possuir acesso ao repositório de documentos, inclua o parâmetro solrRemote no arquivo <fluig-server>/repository/wcmdir/config/configuration.properties (outras formas de configuração).

Isto fará com que o fluig envie os documentos para extração e indexação neste servidor. Lembramos apenas que neste modo, este processo é mais lento do que o acesso direto via repositório.

 

Bloco de código
languagexml
firstline45
linenumberstrue
totvs/solrURL=/fluig/solr
totvs/solrURL=http://<Fluig Indexer Host>:8983/solr
totvs/solrRemote=true
totvs/solrCloud=false

 

Configurando o Fluig Indexer Server

...

da atualização correspondente:

Deck of Cards
idIndexerConfig
Card
defaulttrue
id1
labelA 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).