Come installare Apache Solr su Debian 12

Apache Solr è una piattaforma di ricerca open-source costruita su Apache Lucene, progettata per creare potenti capacità di ricerca e indicizzazione delle applicazioni. Fornisce una ricerca full-text avanzata, ricerca per faccette, indicizzazione in tempo reale e ricerca distribuita, rendendola una scelta popolare per la creazione di motori di ricerca e sistemi di recupero dati. Solr è altamente scalabile e ottimizzato per grandi volumi di dati, spesso utilizzato in ambienti aziendali per compiti come la ricerca su siti web, e-commerce e analisi di big data. La sua API simile a REST consente un’integrazione facile con altri sistemi e supporta funzionalità come l’evidenziazione delle suggerimenti di ricerca e la ricerca geospaziale. La flessibilità, le prestazioni e il supporto della comunità di Solr lo hanno reso una soluzione leader per le organizzazioni che necessitano di funzionalità di ricerca robuste.

In questa guida, ti mostreremo istruzioni passo-passo su come installare Apache Solr sul server Debian 12. Installerai Apache Solr con Java OpenJDK 17, lo proteggerai tramite il plugin BasicAuth e poi imparerai a creare un indice Solr utilizzando la riga di comando.

Prerequisiti

Prima di procedere, controlla i seguenti requisiti:

• Un server Debian 12 con almeno 4 GB di memoria.
• Un utente non root con privilegi di amministratore sudo.

Installazione di Java OpenJDK

Apache Solr è una piattaforma di ricerca aziendale basata su Apache Lucene e in esecuzione su Java JRE (Java Runtime Environment). In questo momento, Solr richiede almeno la versione 11 di Java JRE (Java Runtime Environment), e utilizzerai OpenJDK 17 che può essere installato dal repository Debian.

Prima di iniziare, esegui il seguente comando per aggiornare e aggiornare l’indice dei pacchetti Debian.

sudo apt update

Ora esegui il seguente comando per installare Java OpenJDK sulla tua macchina Debian. In Debian 12, il pacchetto default-jdk si riferisce a Java OpenJDK 17, che Apache Solr può utilizzare.

sudo apt install default-jdk

Digita y per procedere con l’installazione.

Dopo che l’installazione è terminata, verifica la versione di Java eseguendo il seguente comando.

java --version

Il seguente output conferma che Java OpenJDK 17 è installato.

Download e installazione di Apache Solr

Dopo aver installato Java OpenJDK, scaricherai e installerai Apache Solr sulla tua macchina tramite lo script di installazione. In questo momento, l’ultima versione di Apache Solr è la versione 9.4. Visita la pagina ufficiale di download di Apache Solr per ottenere informazioni sull’ultima versione.

Prima di scaricare Apache Solr, installa alcune dipendenze eseguendo il seguente comando.

sudo apt install curl lsof bc

Ora esegui il comando curl qui sotto per scaricare il pacchetto binario di Apache Solr. Al momento della scrittura, l’ultima versione di Apache Solr è v9.4.0. Una volta scaricato, il pacchetto Apache Solr sarà disponibile in solr-9.4.0.tgz.

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

Dopo di che, esegui il seguente comando per estrarre lo script di installazione di Apache Solr dal file solr-9.4.0.tgz. Lo script di installazione install_solr_service.sh sarà estratto dalla tua directory di lavoro attuale.

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

Successivamente, esegui il seguente comando per installare Apache Solr solr-9.4.0.tgz tramite lo script di installazione install_solr_service.sh.

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

Durante il processo, vedrai quanto segue:

Dall’immagine, dovresti vedere lo stato dettagliato della tua installazione di Apache Solr:

• La directory di installazione predefinita di Apache Solr è /opt/solr con la directory dati /var/solr.
• Un nuovo utente di sistema solr viene creato automaticamente, che sarà utilizzato per eseguire il processo Apache Solr.
• Un nuovo script di servizio chiamato solr.service è anche creato, che può essere gestito tramite i comandi systemctl e service.

Ora verifica il servizio solr utilizzando il seguente comando.

sudo service solr status

Il seguente output verrà visualizzato, che conferma che il servizio solr è in esecuzione in background e avviato tramite lo script di servizio.

Puoi anche utilizzare il seguente comando per riavviare o fermare il servizio Solr.

sudo service solr restart  
sudo service solr stop

Configurazione di Apache Solr

Ora che hai installato Apache Solr. Nel passo successivo, farai quanto segue:

• Configurare il sistema Debian: Regolerai la tua macchina Debian aumentando shmmax, nr_hugepages e i limiti di sistema sia per i processi massimi che per i file aperti.
• Configurare Solr: Aumenterai la memoria heap massima per Solr e configurerai un indirizzo IP locale specifico come host Apache Solr.

Iniziamo.

Configurazione del sistema Debian

Per ottimizzare Apache Solr, devi aumentare shmmax, nr_hugepages, max processes e max open files sulla tua macchina Debian.

Esegui il seguente comando per aumentare i parametri del kernel shmmax e nr_hugepages sulla tua macchina Debian.

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

Quindi, apri il file /etc/security/limits.conf utilizzando il seguente comando dell’editor nano.

sudo nano /etc/security/limits.conf

Aggiungi la seguente configurazione in fondo alla linea. Questo imposterà il processo massimo e i file aperti massimi per l’utente Solr a 65000.

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

Salva il file ed esci dall’editor quando hai finito.

Infine, verifica i limiti (processo massimo e file aperti massimi) per l’utente solr eseguendo il seguente comando.

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

Se tutto è andato a buon fine, ora dovresti avere il limite processo massimo e file aperti massimi per l’utente solr configurato a 65000.

Configurazione di Apache Solr

Dopo aver apportato modifiche alla tua macchina Debian, ora modificherai la configurazione di Apache Solr per impostare la memoria heap massima a 4 GB e far eseguire Solr su un indirizzo IP locale specifico 192.168.10.15.

Apri la configurazione predefinita di Apache Solr /etc/default/solr.in.sh utilizzando il comando dell’editor nano qui sotto.

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

Regola l’opzione predefinita SOLR_HEAP con la tua memoria massima consentita. In questo esempio, permetterai ad Apache Solr di eseguire e utilizzare una memoria massima di 4GB.

SOLR_HEAP="4g"

Quindi, decommenta le opzioni SOLR_HOST e SOLR_JETTY_HOST e inserisci il tuo indirizzo IP del server. In questo esempio, eseguirai Apache Solr all’interno dell’indirizzo IP locale 192.168.10.15.

SOLR_HOST="192.168.10.15"  
SOLR_JETTY_HOST="192.168.10.15"

Salva e chiudi il file quando hai finito.

Successivamente, esegui il seguente comando per riavviare il servizio solr e applicare le modifiche che hai effettuato.

sudo service solr restart

Dopo aver eseguito il comando, il tuo Apache Solr sarà in esecuzione sull’indirizzo IP del server 192.168.10.15, e la memoria heap massima sarà 4 GB.

Avvia il tuo browser web e visita l’indirizzo IP del server seguito dalla porta 8983, come http://192.168.10.15:8983/. Dovresti vedere la pagina del dashboard di Apache Solr come la seguente se tutto è stato fatto correttamente.

Da lì, puoi vedere che la directory di installazione di Apache Solr /opt/solr è in esecuzione con Java OpenJDK 17.

Proteggere Apache Solr con il plugin BasicAuth

In questa sezione, proteggerai Apache Solr aggiungendo l’autenticazione tramite il plugin BasicAuth e creando un nuovo utente Solr. Per raggiungere questo obiettivo, devi creare una configurazione specifica e poi definire il modulo di autenticazione e il modulo di autorizzazione per gli utenti Solr.

Crea un nuovo file /var/solr/data/security.json utilizzando il seguente comando dell’editor nano. In questo esempio, la directory dati predefinita per Apache Solr è /var/solr/data/.

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

Inserisci la seguente configurazione nel file.

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

Salva e chiudi il file quando hai finito.

Facendo ciò, proteggerai Apache Solr tramite quanto segue:

• BasicAuthPlugin per l’autenticazione degli utenti e creare un nuovo utente solr con password solrRocks.
• RuleBasedAuthorizationPlugin per l’autorizzazione e configurare l’utente solr come amministratore che può accedere a qualsiasi indice all’interno della tua installazione di Apache Solr.

Successivamente, esegui il seguente comando per riavviare il servizio solr e applicare le modifiche che hai effettuato.

sudo service solr restart

Ora torna al tuo browser web e ricarica la scheda di Apache Solr. Se tutto è andato a buon fine, dovresti essere reindirizzato alla pagina di accesso di Solr come la seguente.

Accedi con l’utente solr e la password SolrRocks.

Se il tentativo di accesso ha successo, dovresti vedere il dashboard di Apache Solr sullo schermo.

Creazione del primo indice Apache Solr

A questo punto, hai completato l’installazione di Apache Solr, ora puoi creare il tuo primo indice Solr tramite la riga di comando. Ma prima di ciò, devi assicurarti che l’autenticazione predefinita per Solr sia configurata.

Apri il file di configurazione di Solr /etc/default/solr.in.sh utilizzando il seguente comando dell’editor nano.

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

Decommenta le seguenti righe per impostare l’autenticazione predefinita di Solr tramite autenticazione di base e inserisci l’utente solr e la password SolrRocks che hai creato.

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

Salva il file ed esci dall’editor quando hai finito.

Ora esegui il comando systemctl qui sotto per riavviare il servizio solr e applicare le modifiche.

sudo service solr restart

Successivamente, esegui il seguente comando per creare il tuo primo indice Solr test_core.

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

Una volta creato l’indice, vedrai l’output previsto “ Creato nuovo core ‘test_core’ “ come questo:

Infine, torna al tuo dashboard di Apache Solr. Quindi, seleziona test_core nel menu a discesa Core Selector.

Al termine, dovresti vedere informazioni dettagliate per l’indice test_core come la seguente:

Conclusione

Per concludere, hai ora completato l’installazione di Apache Solr sul server Debian 12 passo dopo passo. Hai installato Apache Solr con Java OpenJDK 17 e protetto l’installazione di Apache Solr aggiungendo l’autenticazione tramite il plugin BasicAuth. Inoltre, hai anche imparato a creare un indice Solr tramite la riga di comando. D’ora in poi, puoi sfruttare la tua installazione di Solr creando un cluster Solr.