Como Instalar o Apache Solr no Debian 12

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 aplicativos. 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 mecanismos de busca e sistemas de recuperação de dados. O Solr é altamente escalável e otimizado para grandes volumes de dados, frequentemente usado em ambientes empresariais para tarefas como busca em sites, 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 precisam de funcionalidade de busca robusta.

Neste guia, mostraremos instruções passo a passo sobre como instalar o Apache Solr no servidor Debian 12. Você instalará o Apache Solr com o Java OpenJDK 17, o protegerá através do plugin BasicAuth e, em seguida, aprenderá como criar um índice Solr usando a linha de comando.

Pré-requisitos

Antes de prosseguir, verifique o seguinte:

• Um servidor Debian 12 com pelo menos 4GB de memória.
• Um usuário não-root com privilégios de administrador sudo.

Instalando o Java OpenJDK

O Apache Solr é uma plataforma de busca empresarial baseada no Apache Lucene e executada sobre o Java JRE (Java Runtime Environment). Neste momento, o Solr requer pelo menos a versão 11 do Java JRE (Java Runtime Environment), e você usará o OpenJDK 17 que pode ser instalado a partir do repositório Debian.

Antes de começar, execute o seguinte comando para atualizar e refrescar seu índice de pacotes Debian.

sudo apt update

Agora execute o seguinte comando para instalar o Java OpenJDK na sua máquina Debian. No Debian 12, o pacote default-jdk refere-se ao Java OpenJDK 17, que o Apache Solr pode usar.

sudo apt install default-jdk

Digite y para prosseguir com a instalação.

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

java --version

A seguinte saída confirma que o Java OpenJDK 17 está instalado.

Baixando e Instalando o Apache Solr

Após instalar o Java OpenJDK, você fará o download e instalará o Apache Solr na sua máquina através do script de instalação. Neste momento, a versão mais recente do Apache Solr é a versão 9.4. Visite a página oficial de download do Apache Solr para obter informações sobre a versão mais recente.

Antes de baixar o Apache Solr, instale algumas dependências executando o seguinte comando.

sudo apt install curl lsof bc

Agora execute o comando curl abaixo para baixar o pacote binário do Apache Solr. No momento da redação deste texto, a versão mais recente do Apache Solr é v9.4.0. Uma vez baixado, o pacote do Apache Solr estará disponível em solr-9.4.0.tgz.

curl -qO https://downloads.apache.org/solr/solr/9.4.0/solr-9.4.0.tgz

Depois disso, execute o seguinte comando para extrair o script de instalação do Apache Solr do arquivo solr-9.4.0.tgz. O script de instalação install_solr_service.sh será extraído do seu diretório de trabalho atual.

tar xzf solr-9.4.0.tgz solr-9.4.0/bin/install_solr_service.sh --strip-components=2

Em seguida, execute o seguinte comando para instalar o Apache Solr solr-9.4.0.tgz através do script de instalação install_solr_service.sh.

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

Durante o processo, você verá o seguinte:

Na imagem, você deve ver o status detalhado da sua instalação do Apache Solr:

• O diretório de instalação padrão do Apache Solr é /opt/solr com o diretório de dados /var/solr.
• Um novo usuário do sistema solr é criado automaticamente, que será usado para executar o processo do Apache Solr.
• Um novo script de serviço chamado solr.service também é criado, que pode ser gerenciado via systemctl e comando service.

Agora verifique o serviço solr usando o seguinte comando.

sudo service solr status

A seguinte saída será exibida, confirmando que o serviço solr está em execução em segundo plano e iniciado via script de serviço.

Você também pode usar o seguinte comando para reiniciar ou parar o serviço Solr.

sudo service solr restart  
sudo service solr stop

Configurando o Apache Solr

Agora que você instalou o Apache Solr. Na próxima etapa, você fará o seguinte:

• Configurando o Sistema Debian: Você ajustará sua máquina Debian aumentando shmmax, nr_hugepages e limites do sistema para ambos, processos máximos e arquivos abertos.
• Configurando o Solr: Você aumentará a memória máxima do heap para o Solr e configurará um endereço IP local específico como o host do Apache Solr.

Vamos começar.

Configurando o Sistema Debian

Para otimizar o Apache Solr, você deve aumentar os parâmetros do kernel shmmax, nr_hugepages, max processes e max open files na sua máquina Debian.

Execute o seguinte comando para aumentar os parâmetros do kernel shmmax e nr_hugepages na sua máquina Debian.

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

Em seguida, abra o arquivo /etc/security/limits.conf usando o seguinte comando do editor nano.

sudo nano /etc/security/limits.conf

Anexe a seguinte configuração ao final da linha. Isso definirá o processo máximo e arquivos abertos máximos para o usuário Solr como 65000.

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

Salve o arquivo e saia do editor quando terminar.

Por fim, verifique os ulimits (processo máximo e arquivos abertos máximos) para o usuário solr executando o seguinte comando.

sudo -H -u solr bash -c "ulimit -aH"

Se bem-sucedido, você deve agora ter o ulimit processo máximo e arquivos abertos máximos para o usuário solr configurados para 65000.

Configurando o Apache Solr

Após fazer alterações na sua máquina Debian, agora você modificará a configuração do Apache Solr para configurar a memória máxima do heap para 4 GB e executar o Solr em um endereço IP local específico 192.168.10.15.

Abra o arquivo de configuração padrão do Apache Solr /etc/default/solr.in.sh usando o comando do editor nano abaixo.

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

Ajuste a opção padrão SOLR_HEAP com sua memória máxima permitida. Neste exemplo, você permitirá que o Apache Solr execute e use uma memória máxima de 4GB.

SOLR_HEAP="4g"

Em seguida, descomente as opções SOLR_HOST e SOLR_JETTY_HOST e insira o endereço IP do seu servidor. Neste exemplo, você executará o Apache Solr no endereço IP local 192.168.10.15.

SOLR_HOST="192.168.10.15"  
SOLR_JETTY_HOST="192.168.10.15"

Salve e feche o arquivo quando terminar.

Em seguida, execute o seguinte comando para reiniciar o serviço solr e aplicar as alterações que você fez.

sudo service solr restart

Após executar o comando, seu Apache Solr estará em execução no endereço IP do seu servidor 192.168.10.15, e a memória máxima do heap será 4 GB.

Inicie seu navegador da web e visite o endereço IP do servidor seguido da porta 8983, como http://192.168.10.15:8983/. Você deve ver a página do painel do Apache Solr como a seguinte, se tudo estiver correto.

A partir daí, você pode ver que o diretório de instalação do Apache Solr /opt/solr está em execução com o Java OpenJDK 17.

Protegendo o Apache Solr com o Plugin BasicAuth

Nesta seção, você protegerá o Apache Solr adicionando a autenticação via plugin BasicAuth e criando um novo usuário Solr. Para alcançar isso, você deve criar uma configuração específica e, em seguida, definir o módulo de autenticação e o módulo de autorização para os usuários do Solr.

Crie um novo arquivo /var/solr/data/security.json usando o seguinte comando do editor nano. Neste exemplo, o diretório de dados padrão para o Apache Solr é /var/solr/data/.

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

Insira a seguinte configuração no arquivo.

{  
  "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 e feche o arquivo quando terminar.

Ao fazer isso, você estará protegendo o Apache Solr através do seguinte:

• BasicAuthPlugin para autenticação de usuário e criar um novo usuário solr com a senha solrRocks.
• RuleBasedAuthorizationPlugin para autorização e configurar o usuário solr como um administrador que pode acessar quaisquer índices dentro da sua instalação do Apache Solr.

Em seguida, execute o seguinte comando para reiniciar o serviço solr e aplicar as alterações que você fez.

sudo service solr restart

Agora volte ao seu navegador da web e recarregue a aba do Apache Solr. Se tudo for bem-sucedido, você deve ser redirecionado para a página de login do Solr como a seguinte.

Faça login com o usuário solr e a senha SolrRocks.

Se a tentativa de login for bem-sucedida, você deve ver o painel do Apache Solr na sua tela.

Criando o Primeiro Índice Apache Solr

Neste ponto, você concluiu a instalação do Apache Solr, agora pode criar seu primeiro índice Solr via linha de comando. Mas antes disso, você deve garantir que a autenticação padrão para o Solr esteja configurada.

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

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

Descomente as seguintes linhas para configurar a autenticação padrão do Solr via autenticação básica e insira o usuário solr e a senha SolrRocks que você criou.

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

Salve o arquivo e saia do editor quando terminar.

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

sudo service solr restart

Em seguida, execute o seguinte comando para criar seu primeiro índice Solr test_core.

su - solr -c "/opt/solr/bin/solr create -c test_core -n TestCore"

Uma vez que o índice é criado, você verá a saída esperada “ Criado novo core ‘test_core’ “ como esta:

Por fim, volte ao seu painel do Apache Solr. Então, selecione test_core na seção do menu suspenso Core Selector.

Após a conclusão, você deve ver informações detalhadas para o índice test_core como a seguinte:

Conclusão

Para concluir, você agora completou a instalação do Apache Solr no servidor Debian 12 passo a passo. Você instalou o Apache Solr com o Java OpenJDK 17 e protegeu a instalação do Apache Solr adicionando autenticação via plugin BasicAuth. Além disso, você também aprendeu como criar um índice Solr via linha de comando. A partir de agora, você pode aproveitar sua instalação do Solr criando um cluster Solr.