Como Instalar o Apache Solr em um Servidor Ubuntu 24.04

Apache Solr é uma plataforma de busca de código aberto construída sobre o Apache Lucene, projetada para criar poderosas capacidades de busca e indexação de aplicações. Ela fornece busca avançada de texto completo, busca facetada, indexação em tempo real e busca distribuída, tornando-se uma escolha popular para a construção de motores de busca e sistemas de recuperação de dados.

O Solr é altamente escalável e otimizado para grandes volumes de dados, frequentemente utilizado em ambientes empresariais para tarefas como busca em websites, comércio eletrônico e análise de big data. Sua API semelhante ao REST permite fácil integração com outros sistemas, e suporta recursos como sugestões de consulta em destaque e busca geoespacial. A flexibilidade, desempenho e suporte da comunidade do Solr o tornaram uma solução líder para organizações que necessitam de funcionalidade robusta de busca.

Neste guia, você aprenderá como instalar o Apache Solr em um servidor Ubuntu 24.04. Além disso, você também aprenderá como proteger o Apache Solr com Autenticação Básica e criar a primeira coleção com a linha de comando do solr.

Pré-requisitos

Para começar com este guia, certifique-se de ter o seguinte:

• Um servidor Ubuntu 24.04
• Um usuário não-root com privilégios de administrador

Preparando o Servidor Ubuntu

Antes de instalar o Apache Solr, vamos preparar e configurar nosso sistema Ubuntu aumentando o shmmax e nr_hugepages no parâmetro do kernel, e então aumentando o número máximo padrão de arquivos abertos e processos.

Execute o comando abaixo para aumentar o shmmax e nr_hugepages no seu servidor Ubuntu.

sudo echo 4294967295 > /proc/sys/kernel/shmmax  
sudo echo 1536 > /proc/sys/vm/nr_hugepages

Agora execute o comando abaixo para modificar o arquivo /etc/security/limits.conf.

sudo nano /etc/security/limits.conf

Aumente o número máximo de arquivos abertos e processos para o usuário solr com a seguinte configuração.

solr soft nofile 65000  
solr hard nofile 65000  
solr soft nproc 65000  
solr hard nproc 65000

Salve o arquivo e saia do editor.

Instalando o Java OpenJDK

Agora que você configurou seu sistema, vamos instalar o Java OpenJDK em nosso sistema. O Apache Solr requer pelo menos o Java 11 instalado em seu sistema, e para este guia, usaremos o pacote default-jdk que oferece a versão estável mais recente do Java OpenJDK.

Primeiro, atualize o índice de pacotes do Ubuntu com o seguinte comando.

sudo apt update

Agora instale o pacote default-jdk usando o comando abaixo. Digite Y para confirmar a instalação.

sudo apt install default-jdk

Após a instalação ser concluída, verifique a versão do Java com o seguinte comando.

java --version

Você pode ver abaixo que o Java 21 está instalado.

Instalando o Apache Solr

Agora que seu sistema Ubuntu está configurado e o Java OpenJDK instalado, vamos iniciar a instalação do Apache Solr. Neste guia, você instalará o Apache Solr usando o script de instalação fornecido pelo pacote Solr.

Para começar, execute o comando abaixo para instalar ferramentas básicas como curl, lsof e bc.

sudo apt install curl lsof bc

Agora baixe o pacote binário do Apache Solr com o comando wget abaixo.

wget https://www.apache.org/dyn/closer.lua/solr/solr/9.7.0/solr-9.7.0.tgz?action=download

Renomeie o pacote do Apache Solr e extraia o script de instalação install_solr_service.sh usando o comando abaixo.

mv solr-9.7.0.tgz?action=download solr-9.7.0.tgz  
tar -xf tar xzf solr-9.7.0.tgz solr-9.7.0/bin/install_solr_service.sh --strip-components=2

Agora execute o script install_solr_service.sh para instalar o Apache Solr.

sudo bash ./install_solr_service.sh solr-9.7.0.tgz

Você pode ver abaixo a instalação detalhada do Apache Solr.

• O diretório de instalação padrão está localizado no diretório /opt/solr.
• O novo usuário solr é criado automaticamente.
• O novo arquivo de serviço solr.service é criado para gerenciar o serviço do Apache Solr.

Agora verifique o status do solr com o comando abaixo. Você pode ver solr com o status active(exited), o que significa que o serviço está em execução, mas o systemd não consegue encontrar arquivos para monitorar.

sudo systemctl status solr

Você também pode verificar as portas abertas em seu sistema usando o comando ss abaixo. O Apache Solr deve estar rodando na porta 8893.

ss -tulpn

Configurando o Apache Solr

Agora que o Apache Solr está instalado, vamos configurá-lo modificando os parâmetros do Apache Solr dentro do script /etc/default/solr.in.sh. Em seguida, aumente a memória heap máxima padrão e o endereço IP usado para executar o Apache Solr.

Abra o arquivo de configuração do Solr /etc/default/solr.in.sh usando o editor vim.

sudo vim /etc/default/solr.in.sh

Altere a opção padrão SOLR_HEAP com a alocação máxima de memória para o Apache Solr. Neste exemplo, usaremos 4GB de RAM.

SOLR_HEAP="4g"

Insira seu endereço IP nas opções SOLR_HOST e SOLR_JETTY_HOST. Neste exemplo, o Apache Solr será executado no endereço IP local 192.169.10.60.

SOLR_HOST="192.168.10.15"  
SOLR_JETTY_HOST="192.168.10.15"

Agora execute o comando systemctl abaixo para reiniciar o serviço do Apache Solr e aplicar suas alterações.

sudo systemctl restart solr

Você pode verificar a porta aberta e qual endereço IP está sendo usado pelo Apache Solr com o comando ss abaixo.

ss -tulpn

Protegendo o Apache Solr com Autenticação

Após configurar o Apache Solr, o próximo passo é proteger sua implantação. Neste exemplo, usaremos autenticação básica para proteger o Apache Solr. Isso pode ser feito criando um novo arquivo /var/solr/data/security.json.

Crie uma nova configuração /var/solr/data/security.json com o editor vim.

sudo vim /var/solr/data/security.json

Insira a configuração abaixo para configurar a autenticação para o Apache Solr e criar um novo usuário solr com a senha solrRocks.

{  
 "authentication":{  
 "blockUnknown": true,  
 "class":"solr.BasicAuthPlugin",  
 "credentials":{"solr":"IV0EHq1OnNrj6gvRCwvFwTrZ1+z1oBbnQdiVC3otuq0= Ndd7LKvVBAaZIF0QAVi1ekCfAJXr1GGfLtRUXhgrF8c="},  
 "realm":"Meus usuários Solr",  
 "forwardCredentials": false  
 },  
 "authorization":{  
 "class":"solr.RuleBasedAuthorizationPlugin",  
 "permissions":[{"name":"all", "role":"admin"}],  
 "user-role":{"solr":"admin"}  
 }  
}

Salve o arquivo e saia do editor.

Agora execute o comando systemctl abaixo para reiniciar o serviço solr e aplicar suas alterações.

sudo systemctl restart solr

Em seguida, abra seu navegador da web e visite sua instalação do Apache Solr http://192.168.10.60:8983/. Você será redirecionado para a página de login do Apache Solr.

Digite o usuário solr e a senha solrRocks e você verá o painel do Apache Solr.

Criando a Primeira Coleção no Apache Solr

Neste estágio, você configurou e protegeu o Apache Solr. Agora você criará a Primeira Coleção no Apache Solr a partir da linha de comando.

Abra novamente o arquivo /etc/default/solr.in.sh com o editor vim.

sudo vim /etc/default/solr.in.sh

Descomente as linhas SOLR_AUTH_TYPE e SOLR_AUTHENTICATION_OPTS, e deixe ambas como padrão.

SOLR_AUTH_TYPE="basic"  
SOLR_AUTHENTICATION_OPTS="-Dbasicauth=solr:SolrRocks"

Salve o arquivo e saia do editor.

Agora execute o seguinte comando para reiniciar o serviço do Apache Solr.

sudo systemctl restart solr

Em seguida, execute o comando abaixo para criar sua primeira coleção com o nome my_first_index.

su - solr -c "/opt/solr/bin/solr create -c my_first_index -n MyIndex"

Agora vá para o Painel do Apache Solr e você verá que a nova coleção my_first_index foi criada.

Conclusão

Parabéns! Você completou a instalação do Apache Solr no servidor Ubuntu 24.04. Você o instalou com o Java OpenJDK 21, configurou para rodar em um endereço IP local e o protegeu com Autenticação Básica. Por fim, você criou a primeira coleção usando a linha de comando do Solr.