diff --git a/docs/solr.rst b/docs/solr.rst index d5da6d889..ae8bbdb63 100644 --- a/docs/solr.rst +++ b/docs/solr.rst @@ -2,20 +2,24 @@ 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). +Solr é uma plataforma open source de indexação e busca textual utilizada pelo SAPL 3.1 para indexar documentos (normas jurídicas, matérias legislativas e documentos acessórios). -1) Faça o download da distribuição _binária_ do Apache Solr do site oficial do projeto *http://lucene.apache.org/solr* ; +Observação: Se a execução do SAPL 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 estão corretos, a verso do SAPL referenciada no arquivo docker-compose.yml, 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; -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** ; + **$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) @@ -23,8 +27,6 @@ As instalações Solr suportadas até o momento vão da 7.4 à 8; 6) Edite o arquivo .env adicionando as seguintes linhas: - - USE_SOLR = True @@ -34,13 +36,11 @@ As instalações Solr suportadas até o momento vão da 7.4 à 8; SOLR_URL = http://localhost:8983 - - -(o valor do campo SOLR_URL deve corresponder à URL acessada no item 3) + (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) + (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; @@ -49,10 +49,7 @@ 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** +* 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 +* 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). - - -