Comment installer Apache Solr sur un serveur Ubuntu 24.04

Apache Solr est une plateforme de recherche open-source construite sur Apache Lucene, conçue pour créer des capacités de recherche et d’indexation puissantes pour les applications. Elle offre une recherche en texte intégral avancée, une recherche facettée, un indexage en temps réel et une recherche distribuée, ce qui en fait un choix populaire pour la création de moteurs de recherche et de systèmes de récupération de données.

Solr est hautement évolutif et optimisé pour de grands volumes de données, souvent utilisé dans des environnements d’entreprise pour des tâches telles que la recherche sur les sites Web, le commerce électronique et l’analyse de big data. Son API de type REST permet une intégration facile avec d’autres systèmes, et elle prend en charge des fonctionnalités telles que la mise en surbrillance des suggestions de requêtes et la recherche géospatiale. La flexibilité, la performance et le soutien de la communauté de Solr en ont fait une solution de premier plan pour les organisations ayant besoin de fonctionnalités de recherche robustes.

Dans ce guide, vous apprendrez à installer Apache Solr sur un serveur Ubuntu 24.04. De plus, vous apprendrez également à sécuriser Apache Solr avec l’authentification de base et à créer la première collection avec la ligne de commande solr.

Prérequis

Pour commencer ce guide, assurez-vous d’avoir les éléments suivants :

• Un serveur Ubuntu 24.04
• Un utilisateur non-root avec des privilèges d’administrateur

Préparation du serveur Ubuntu

Avant d’installer Apache Solr, préparons et configurons notre système Ubuntu en augmentant le shmmax et le nr_hugepages dans le paramètre du noyau, puis en augmentant le nombre maximal de fichiers ouverts et de processus par défaut.

Exécutez la commande ci-dessous pour augmenter le shmmax et le nr_hugepages sur votre serveur Ubuntu.

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

Maintenant, exécutez la commande ci-dessous pour modifier le fichier /etc/security/limits.conf.

sudo nano /etc/security/limits.conf

Augmentez le nombre maximal de fichiers ouverts et de processus pour l’utilisateur solr avec la configuration suivante.

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

Enregistrez le fichier et quittez l’éditeur.

Installation de Java OpenJDK

Maintenant que vous avez configuré votre système, installons Java OpenJDK sur notre système. Apache Solr nécessite au moins Java 11 installé sur votre système, et pour ce guide, nous utiliserons le paquet default-jdk qui offre la dernière version stable de Java OpenJDK.

Tout d’abord, mettez à jour l’index des paquets Ubuntu avec ce qui suit.

sudo apt update

Maintenant, installez le paquet default-jdk en utilisant la commande ci-dessous. Entrez Y pour confirmer l’installation.

sudo apt install default-jdk

Après l’installation, vérifiez la version de Java avec la commande suivante.

java --version

Vous pouvez voir ci-dessous que Java 21 est installé.

Installation d’Apache Solr

Maintenant que votre système Ubuntu est configuré et que Java OpenJDK est installé, commençons l’installation d’Apache Solr. Dans ce guide, vous installerez Apache Solr en utilisant le script d’installation fourni par le paquet Solr.

Pour commencer, exécutez la commande ci-dessous pour installer des outils de base tels que curl, lsof et bc.

sudo apt install curl lsof bc

Téléchargez maintenant le paquet binaire d’Apache Solr avec la commande wget ci-dessous.

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

Renommez le paquet Apache Solr et extrayez le script d’installation install_solr_service.sh en utilisant la commande ci-dessous.

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

Exécutez maintenant le script install_solr_service.sh pour installer Apache Solr.

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

Vous pouvez voir ci-dessous le détail de l’installation d’Apache Solr.

• Le répertoire d’installation par défaut est situé dans le répertoire /opt/solr.
• Le nouvel utilisateur solr est créé automatiquement.
• Le nouveau fichier de service solr.service est créé pour gérer le service Apache Solr.

Vérifiez maintenant l’état de solr avec la commande ci-dessous. Vous pouvez voir solr avec le statut active(exited), ce qui signifie que le service fonctionne, mais que le systemd ne trouve aucun fichier à surveiller.

sudo systemctl status solr

Vous pouvez également vérifier les ports ouverts sur votre système en utilisant la commande ss ci-dessous. Apache Solr devrait fonctionner sur le port 8893.

ss -tulpn

Configuration d’Apache Solr

Maintenant qu’Apache Solr est installé, configurons-le en modifiant les paramètres d’Apache Solr dans le script /etc/default/solr.in.sh. Ensuite, augmentez le maximum de mémoire par défaut et l’adresse IP utilisée pour exécuter Apache Solr.

Ouvrez le fichier de configuration Solr /etc/default/solr.in.sh en utilisant l’éditeur vim.

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

Changez l’option par défaut SOLR_HEAP avec l’allocation de mémoire maximale pour Apache Solr. Dans cet exemple, nous utiliserons 4 Go de RAM.

SOLR_HEAP="4g"

Entrez votre adresse IP dans les options SOLR_HOST et SOLR_JETTY_HOST. Dans cet exemple, Apache Solr fonctionnera sur l’adresse IP locale 192.169.10.60.

SOLR_HOST="192.168.10.15"  
SOLR_JETTY_HOST="192.168.10.15"

Exécutez maintenant la commande systemctl ci-dessous pour redémarrer le service Apache Solr et appliquer vos modifications.

sudo systemctl restart solr

Vous pouvez vérifier le port ouvert et quelle adresse IP est utilisée par Apache Solr avec la commande ss ci-dessous.

ss -tulpn

Sécurisation d’Apache Solr avec l’authentification

Après avoir configuré Apache Solr, l’étape suivante consiste à sécuriser votre déploiement. Dans cet exemple, nous utiliserons l’authentification de base pour sécuriser Apache Solr. Cela peut être fait en créant un nouveau fichier /var/solr/data/security.json.

Créez une nouvelle configuration /var/solr/data/security.json avec l’éditeur vim.

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

Insérez la configuration ci-dessous pour configurer l’authentification pour Apache Solr et créer un nouvel utilisateur solr avec le mot de passe solrRocks.

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

Enregistrez le fichier et quittez l’éditeur.

Exécutez maintenant la commande systemctl ci-dessous pour redémarrer le service solr et appliquer vos modifications.

sudo systemctl restart solr

Ensuite, ouvrez votre navigateur Web et visitez votre installation d’Apache Solr http://192.168.10.60:8983/. Vous serez redirigé vers la page de connexion d’Apache Solr.

Entrez l’utilisateur solr et le mot de passe solrRocks et vous obtiendrez le tableau de bord d’Apache Solr.

Création de la première collection dans Apache Solr

À ce stade, vous avez configuré et sécurisé Apache Solr. Maintenant, vous allez créer la première collection dans Apache Solr depuis la ligne de commande.

Ouvrez à nouveau le fichier /etc/default/solr.in.sh avec l’éditeur vim.

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

Décommentez les lignes SOLR_AUTH_TYPE et SOLR_AUTHENTICATION_OPTS, et laissez les deux par défaut.

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

Enregistrez le fichier et quittez l’éditeur.

Exécutez maintenant la commande suivante pour redémarrer le service Apache Solr.

sudo systemctl restart solr

Ensuite, exécutez la commande ci-dessous pour créer votre première collection avec le nom my_first_index.

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

Maintenant, allez sur le tableau de bord d’Apache Solr et vous verrez que la nouvelle collection my_first_index a été créée.

Conclusion

Félicitations ! Vous avez terminé l’installation d’Apache Solr sur le serveur Ubuntu 24.04. Vous l’avez installé avec Java OpenJDK 21, configuré pour fonctionner sur une adresse IP locale et sécurisé avec l’authentification de base. Enfin, vous avez créé la première collection en utilisant la ligne de commande Solr.