diff --git a/docs/solr.rst b/docs/solr.rst index 4c82ab68d..d5da6d889 100644 --- a/docs/solr.rst +++ b/docs/solr.rst @@ -1,27 +1,58 @@ -**ESTAS INSTRUÇÕES ESTÃO DEFASADAS. EM BREVE IREMOS DISPONIBILIZAR UM TUTORIAL MAIS ATUALIZADO DE COMO INTEGRAR O SOLR AO SAPL** - ================================ 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. +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) -Adicione ao arquivo ``.env`` o seguinte atributo: +8) Enquanto o Solr realiza a indexação da base de dados do SAPL, inicie em uma outra tela o SAPL; -``SOLR_URL = 'http://127.0.0.1:8983/solr'`` +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. -Dentro do diretório principal siga os seguintes passos:: +**Observações:** - curl -LO https://archive.apache.org/dist/lucene/solr/4.10.2/solr-4.10.2.tgz - tar xvzf solr-4.10.2.tgz - cd solr-4.10.2 - cd example - java -jar start.jar - ./manage.py build_solr_schema --filename solr-4.10.2/example/solr/collection1/conf/schema.xml +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). -Após isso, deve-se parar o servidor do Solr e restartar com ``java -jar start.jar`` -**OBS: Toda vez que o código da pesquisa textual for modificado, os comandos de build_solr_schema e start.jar devem ser rodados, nessa mesma ordem.**