Elasticsearch

Instalando o Elasticsearch

O Elasticsearch está disponivel para download no site https://www.elastic.co/downloads/elasticsearch. Deve ser utilizada a versão de Elasticsearch suportada pelo Lumis Portal de acordo com os requisitos de sistema. Para informações sobre instalação e configuração, veja o manual do Elasticsearch.

É importante observar que o Elasticsearch cria um cluster com outras instâncias que tenham o mesmo valor na configuração clusterName. É recomendado sempre alterar o valor do clusterName ao invés de deixar o valor padrão para evitar que outro Elasticsearch executado na mesma rede possa formar um cluster indesejado.

O Elasticsearch por padrão disponibiliza acesso pelas portas 9200 e 9300 e não há controle de acesso. Recomenda-se permitir os acessos às portas expostas pelo Elasticsearch apenas ao Lumis Portal.

O JVM utilizado para executar o Elasticsearch deve ser exatamente a mesma versão (incluindo número de update) da que está sendo utilizada para executar o Lumis Portal.

O Elasticsearch deve ser configurado para não criar os índices manipulados pelo portal automaticamente. Para isto, pode por exemplo, incluir no arquivo de configuração elasticsearch.yml a configuração action.auto_create_index: "-lumisportal-*,+*", se estiver usando no Lumis Portal a configuração de prefixo de índices "lumisportal", que é o padrão.

Instalando o ICU Analysis Plugin

O Lumis Portal requer que o Elasticsearch tenha o plugin ICU Analysis instalado em todos os nós de Elasticsearch que serão utilizados.

Para instalar este plugin, em cada nó do Elasticsearch, execute o comando elasticsearch-plugin install analysis-icu na pasta bin da instalação do Elasticsearch. Instruções mais detalhadas sobre a instalação deste plugin estão disponíveis no manual do mesmo.

Configurações

Para configurar qual repositório de Big Data o Lumis Portal utiliza, acesse Configurações > Configurações do Portal > Configurações do Ambiente.

Mapeamento da pasta de análise

A pasta <lumisdata>/shared/data/elasticsearch/lumis-analysis deve ser mapeada para <config>/lumis-analysis em cada servidor do Elasticsearch utilizado pelo portal (por exemplo, através de mount point ou link simbólico).

Por exemplo, supondo que o Lumis Portal esteja sendo usado no Windows e sua instalação esteja em C:\lumis\lumisportal e que esteja sendo utilizado um Elasticsearch local, que está em C:\lumis\elasticsearch, o mapeamento poderia ser feito utilizando um junction point da seguinte forma: mklink /J "C:\lumis\elasticsearch\config\lumis-analysis" "C:\lumis\lumisportal\lumisdata\shared\data\elasticsearch\lumis-analysis".

Criação de templates de índices para o uso com sinônimos

Caso a solução vá utilizar a funcionalidade de sinônimos e vá utilizar uma língua que não seja Português (código pt_BR), Inglês (código en_US) ou Espanhol (código es_ES), deverá ser criado um template de índice para a língua utilizada para criar os analisadores necessários para que os sinônimos sejam corretamente aplicados. Para maiores informações, veja a documentação técnica.