Usando Solr Com TYPO3 No Debian Wheezy

Versão 1.0
Autor: Falko Timme
Siga-me no Twitter

A extensão de busca padrão do TYPO3 chamada “Busca Indexada” é boa para sites pequenos, mas se o seu site for maior (> 500 páginas), ele fica muito lento. Felizmente, você pode substituí-la por uma extensão de busca que usa o servidor de busca ultra-rápido Apache Solr. Este tutorial explica como usar o Apache Solr com TYPO3 no Debian Wheezy.

Não dou nenhuma garantia de que isso funcionará para você!

1 Nota Preliminar

Neste tutorial, estou usando dois servidores:

server1.example.com (IP: 192.168.0.100): servidor web onde o pacote de introdução TYPO3 4.7 está instalado (no vhost www.example.com).
server2.example.com (IP: 192.168.0.101): servidor separado onde vou instalar o Apache Solr.

Claro, é possível instalar o Solr no mesmo sistema que o servidor web; no entanto, eu gostaria de separar os dois serviços para que não impactem o desempenho um do outro.

2 Instalando o Solr

server2.example.com:

Primeiro, instale o Java:

apt-get install openjdk-6-jdk openjdk-6-jre unzip

update-alternatives --config java  
update-alternatives --config javac

O projeto TYPO3 fornece um script de instalação do Solr que baixamos da seguinte forma:

wget http://forge.typo3.org/projects/extension-solr/repository/revisions/master/raw/resources/shell/install-solr.sh  
chmod 755 install-solr.sh

Em seguida, verifique qual é a versão atual do Apache Tomcat 6 visitando http://tomcat.apache.org/download-60.cgi. No momento da redação, era 6.0.37. Agora abra o install-solr.sh…

vi install-solr.sh

… e certifique-se de que a variável TOMCAT_VER contém o número da versão correto - se necessário, altere:

| [...] TOMCAT_VER=6.0.37 [...] |

Agora instalamos o Solr. Por padrão (se você não fornecer nenhum idioma como parâmetros), o Solr é instalado com suporte apenas para o idioma inglês; se você precisar de suporte para mais idiomas, basta adicioná-los ao comando, por exemplo, assim:

./install-solr.sh german english french

Isso instala um servidor Tomcat (onde o Solr é executado) e o Solr. Por padrão, o Tomcat escuta apenas em 127.0.0.1; como queremos acessar o Solr de um host remoto, devemos configurar o Tomcat para escutar em todas as interfaces, portanto, substituímos 127.0.0.1 por 0.0.0.0 em /opt/solr-tomcat/tomcat/conf/server.xml:

vi /opt/solr-tomcat/tomcat/conf/server.xml

| [...] [...] |

Reinicie o Tomcat:

/opt/solr-tomcat/tomcat/bin/shutdown.sh  
/opt/solr-tomcat/tomcat/bin/startup.sh

Em seguida, podemos configurar núcleos no Solr. Por padrão, um núcleo em inglês já está configurado; se você precisar de mais idiomas, pode adicioná-los a /opt/solr-tomcat/solr/solr.xml, por exemplo, assim:

vi /opt/solr-tomcat/solr/solr.xml

| |

Reinicie o Solr em seguida:

/opt/solr-tomcat/tomcat/bin/shutdown.sh  
/opt/solr-tomcat/tomcat/bin/startup.sh

Porque não queremos iniciar o Tomcat manualmente toda vez que o servidor for inicializado, podemos adicionar o comando de inicialização do Tomcat a /etc/rc.local:

vi /etc/rc.local

| [...] /opt/solr-tomcat/tomcat/bin/startup.sh [...] |

2.1 Adicionando Autenticação Ao Solr

Como o Solr está escutando em todas as interfaces, é uma boa ideia adicionar autenticação a ele. Agora vou configurar o usuário user1 com a senha secret para o núcleo em inglês.

Abra /opt/solr-tomcat/tomcat/conf/web.xml…

vi /opt/solr-tomcat/tomcat/conf/web.xml

… e adicione a seguinte seção em algum lugar dentro do contêiner :

| [...] Aplicação Solr autenticada /core_en/* role1 BASIC Proteção de Admin e Atualização [...] |

Como você vê, isso é válido apenas para o núcleo em inglês (/core_en/*), e eu configurei isso para o papel role1, então usuários válidos devem pertencer a esse papel. Para adicionar o usuário user1 com sua senha a esse papel, abra /opt/solr-tomcat/tomcat/conf/tomcat-users.xml…

vi /opt/solr-tomcat/tomcat/conf/tomcat-users.xml

… e adicione a seguinte seção dentro do contêiner :

| [...] [...] |

Reinicie o Tomcat em seguida:

/opt/solr-tomcat/tomcat/bin/shutdown.sh  
/opt/solr-tomcat/tomcat/bin/startup.sh

Agora você pode abrir um navegador e visitar o Solr em http://192.168.0.101:8080/solr onde você deve ver todos os núcleos configurados:

Quando você visita o núcleo em inglês (para o qual acabamos de configurar a autenticação), deve ser solicitado um nome de usuário e uma senha:

Após a autenticação bem-sucedida, você deve ver a seguinte página, o que significa que o Solr está funcionando com sucesso: