================================
Instruções para instalar o Solr
================================

Solr é a ferramenta utilizada pelo SAPL 3.1 para indexar documentos para que possa ser feita
a Pesquisa Textual. Se a execução for mediante containers Docker então use o arquivo docker-compose.yml disponível em
*https://github.com/interlegis/sapl/blob/3.1.x/solr/docker-compose.yml* (verifique os mapeamentos de volume, e realize o
backup de seu BD antes de qualquer tentativa de substituição do arquivo docker-compose.yml em uso corrente).

1) Faça o download da distribuição _binária_ do Apache Solr do site oficial do projeto *http://lucene.apache.org/solr* ;

As instalações Solr suportadas até o momento vão da 7.4 à 8;

2) Descompacte o arquivo em uma pasta do diretório (referenciada neste tutorial como $SOLR_HOME)

3) Inicie o Solr com o comando:

    **$SOLR_HOME/bin/solr start -c** ;

4) Por meio do browser, acesse a URL **http://localhost:8983** (ou informe o endereço da máquina onde o Solr foi instalado)

5) Pare o servidor do SAPL;

6) Edite o arquivo .env adicionando as seguintes linhas:



    USE_SOLR = True


    SOLR_COLLECTION = sapl


    SOLR_URL = http://localhost:8983




(o valor do campo SOLR_URL deve corresponder à URL acessada no item 3)

7) Entre no diretório raiz do SAPL e digite o comando: **python3 solr_api.py -c sapl -u http://localhost:8983`**

(a URL informada acima deve ser a mesma dos itens 3 e 6)

8) Enquanto o Solr realiza a indexação da base de dados do SAPL, inicie em uma outra tela o SAPL;

9) Após realizados os passos com sucesso, nas telas de busca de Matéria Legislativa e Normas deverá aparecer um botão
de 'Busca Textual' próximo ao botão de busca tradicional.

**Observações:**

a) Para parar o Solr execute o comando **$SOLR_HOME/bin/solr stop**

b) Para reindexar os dados do SAPL execute o comando `python3 manage.py rebuild_index` (isso irá apagar todos os dados
do Solr e indexar tudo novamente).