Instalando Apache Solr no Mac OSX Apache Solr é um plataforma de busca(search engine) de código livre construída sobre o Lucene. Solr é considerada a plataforma de busca para web sites mais popular que existe devido a sua proposição em indexar e buscar informações em várias fontes de informação ao mesmo tempo, além de retornar as recomendações existentes para o conteúdo relacionado baseado na consulta utilizada e em sua taxonomia. Solr pode trabalhar tanto com o protocolo HTTP quanto com XML. Além disso, oferece APIs de integração em JSON, Python e Ruby. De acordo com o site do projeto, Solr oferece alguns recursos que o tornam popular que incluem: Indexação em tempo real quase que automática; Replicação de índices automatizada; Estatísticas de log para o servidor; Processos de recuperação e failover automatizados; Indexação e análise de "documentos ricos", ou seja, arquivos como pdf, doc, rtf; Disponibilidade para índices de busca múltiplas; Possibilidade de utilização de cache extensível; Desenhado para ser utilizado com tráfego de alto volume; Escalabilidade, flexibilidade e extensibilidade; Full text searching avançado; Buscas geoespaciais; Consultas em load balance; Enquanto o Lucene e Solr são implementados em Java, o Solr é projetado para ser usado com várias linguagens de programação e até mesmo em linha de comando puro.
Configurando Solr no Tomcat em um ambiente Mac OS X Esta é um publicação didática de como configurar o Solr para funcionar com o Tomcat em um Mac OS X. Estou assumindo que este ambiente está configurado com o Homebrew instalado devido a facilidade que o Homebrew proporciona para instalar e configurar todos os recursos mais facilmente. Caso você não tenha o Homebrew instalado em seu ambiente, aconselho fortemente que você configure o Homebrew pois isto economizará muitas horas de trabalho para você. Instalando o Tomcat $ brew install tomcat Este comando irá instalar o Tomcat versão 7.0.42 em seu ambiente no diretório /usr/local/cellar/tomcat/7.0.42/ Após a instalação, vamos testar se o Tomcat está funcionando corretamente iniciando o servidor. $ catalina start Após o comando acima, as seguintes linhas serão impressas no console. Using CATALINA_BASE: /usr/local/cellar/tomcat/7.0.42/libexec Using CATALINA_HOME: /usr/local/cellar/tomcat/7.0.42/libexec Using CATALINA_TMPDIR: /usr/local/cellar/tomcat/7.0.42/libexec/temp Using JRE_HOME: /System/Library/Java/JavaVirtualMachines/1.6.0.jdk/Contents/Home Using CLASSPATH: /usr/local/cellar/tomcat/7.0.42/libexec/bin/bootstrap.jar:/usr/local/cellar/tomcat/7.0.42/libexec/ bin/tomcat juli.jar Após receber as mensagens acima descritas, acesse o servidor de qualquer navegador no endereço http://localhost:8080/ e vamos verificar se a tela abaixo é apresentada:
Gerenciador do Tomcat Se tudo estiver funcionando, precisamos ter certeza de que é possível acessar o aplicativo de gerenciamento do Tomcat. Para isso, edite o arquivo tomcat users.xml no diretório conf do Tomcat. $ vim tomcat users.xml E inclua a seguinte diretiva de acesso para permitir o gerenciamento. <?xml version='1.0' encoding='utf 8'?> <tomcat users> <role rolename="manager gui"/> <user username="tomcat" password="tomcat" roles="manager gui"/> </tomcat users> A regra manager gui informa que o usuário tomcat poderá acessar o gerenciador do Tomcat. Reinicie o Tomcat e após a reinicialização, será possível acessar as informações de estado do servidor e gerenciamento de aplicativos (Server Status / Manager App)
Se todas as telas acima forem exibidas em seu navegador, as configurações do Tomcat foram realizadas com sucesso
Instalando o Solr Instalar o Solr com o Homebrew é tão fácil como o Tomcat $ brew install solr No ambiente de testes o qual estamos realizando esta instalação, o Solr foi instalado em /usr/local/cellar/solr/4.4.0/ sem que fosse necessário qualquer configuração. Agora podemos executar o Solr com o Jetty e verificar se ele está operando normalmente. $ cd /usr/local/cellar/solr/4.4.0/libexec/example $ java jar start.jar Esta ação irá iniciar o servidor Jetty na porta 8983. No qual pode se testar no navegador no endereço http://localhost:8983/solr Homebrew faz com que tudo fique muito mais fácil! NO entanto, nosso servidor instalado não possui qualquer documento indexado. Nosso próximo passo é carregar alguns documentos. O Solr vêm com alguns documentos dentro do diretório exampledocs o qual não foram ainda carregados. Carregue os documentos para iniciar os testes. $ pwd
/usr/local/cellar/solr/4.4.0/libexec/example $ cd exampledocs $./post.sh *.xml O comando acima irá executar um script que preencherá a coleção exemplo. A partir deste momento, é possível usar a interface de administração para executar consultas básicas como por exemplo q = *: * apenas para se certificar que tudo está funcionando. Configurando o Solr para executar no Tomcat Uma vez que atestamos o funcionamento do Solr nos passos anteriores como um processo interno sobre o Jetty, é preciso configura lo agora para executar como um servi;co do Tomcat no porta 8075. Para isso, é preciso apenas indicar para o Tomcat onde o Solr está por meio da configuração de um arquivo XML. Este arquivo fica localizado em /usr/local/cellar/tomcat/7.0.42/libexec/conf/catalina/localhost/solr.xml. Edite o arquivo solr.xml e inclua as linhas descritas abaixo: $ vim /usr/local/cellar/tomcat/7.0.42/libexec/conf/catalina/localhost/solr.xml <?xml version="1.0" encoding="utf 8"?> <Context docbase="/usr/local/cellar/solr/4.4.0/libexec/example/webapps/solr.war"
debug="0" crosscontext="true"> <Environment name="solr/home" type="java.lang.string" value="/usr/local/cellar/solr/4.4.0/libexec/example/solr" override="true"/> </Context> Desde a versão 4.3.0 do Solr, houveram algumas modificações na integração do Solr com o Tomcat. Para que o Solr funcione corretamente, é necessário fazer uma cópia das bibliotecas do Solr para o diretório de bibliotecas do Tomcat $ cp /usr/local/cellar/solr/4.4.0/libexec/example/lib/ext/* /usr/local/cellar/tomcat/7.0.42/libexec/lib/ Observe que os números de versão utilizadas no exemplo deste tutorial podem ser diferentes no futuro. Mas tornam se insignificantes diante do uso do Homebrew. Em seguida, reinicie o Catalina. $ catalina stop $ catalina start Ao acessar a tela de administração de aplicativos do Tomcat, agora é possível ver a diretiva /solr listada como um aplicativo. Ao clicar no link /solr do Tomcat a tela de navegação do Solr será exibida. No exemplo abaixo, ele está sendo executado na porta 8075
Também é possível navegar na collection1 e ver os documentos que foram carregados previamente.
Resumo da instalação Instale o Tomcat Edit o arquivo tomcat users.xml para habilitar ao gerenciador do Tomcat Instale o Solr Carregue os documentos de exemplo. Edite o arquivo solr.xml para configure o caminho do Solr Copie as bibliotecas do Solr para o diretório de bibliotecas do Tomcat