Comment installer Apache Solr sur Debian 12

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 fournit une recherche en texte intégral avancée, une recherche par facettes, une indexation 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, nous vous montrerons des instructions étape par étape sur la façon d’installer Apache Solr sur le serveur Debian 12. Vous installerez Apache Solr avec Java OpenJDK 17, le sécuriserez via le plugin BasicAuth, puis apprendrez à créer un index Solr en utilisant la ligne de commande.

Prérequis

Avant de commencer, cochez les éléments suivants :

• Un serveur Debian 12 avec au moins 4 Go de mémoire.
• Un utilisateur non-root avec des privilèges d’administrateur sudo.

Installation de Java OpenJDK

Apache Solr est une plateforme de recherche d’entreprise basée sur Apache Lucene et fonctionnant sur Java JRE (Java Runtime Environment). À ce jour, Solr nécessite au moins la version 11 de Java JRE (Java Runtime Environment), et vous utiliserez OpenJDK 17 qui peut être installé à partir du dépôt Debian.

Avant de commencer, exécutez la commande suivante pour mettre à jour et rafraîchir votre index de paquets Debian.

sudo apt update

Maintenant, exécutez la commande suivante pour installer Java OpenJDK sur votre machine Debian. Dans Debian 12, le paquet default-jdk fait référence à Java OpenJDK 17, que Apache Solr peut utiliser.

sudo apt install default-jdk

Tapez y pour continuer l’installation.

Après la fin de l’installation, vérifiez la version de Java en exécutant la commande suivante.

java --version

La sortie suivante confirme que Java OpenJDK 17 est installé.

Téléchargement et installation d’Apache Solr

Après avoir installé Java OpenJDK, vous téléchargerez et installerez Apache Solr sur votre machine via le script d’installation. À ce jour, la dernière version d’Apache Solr est la version 9.4. Visitez la page de téléchargement officielle d’Apache Solr pour obtenir des informations sur la dernière version.

Avant de télécharger Apache Solr, installez quelques dépendances en exécutant la commande suivante.

sudo apt install curl lsof bc

Maintenant, exécutez la commande curl ci-dessous pour télécharger le paquet binaire d’Apache Solr. Au moment de la rédaction de cet article, la dernière version d’Apache Solr est v9.4.0. Une fois téléchargé, le paquet Apache Solr sera disponible sous solr-9.4.0.tgz.

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

Après cela, exécutez la commande suivante pour extraire le script d’installation d’Apache Solr du fichier solr-9.4.0.tgz. Le script d’installation install_solr_service.sh sera extrait de votre répertoire de travail actuel.

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

Ensuite, exécutez la commande suivante pour installer Apache Solr solr-9.4.0.tgz via le script d’installation install_solr_service.sh.

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

Au cours du processus, vous verrez ce qui suit :

Sur l’image, vous devriez voir le statut détaillé de votre installation d’Apache Solr :

• Le répertoire d’installation par défaut d’Apache Solr est /opt/solr avec le répertoire de données /var/solr.
• Un nouvel utilisateur système solr est créé automatiquement, qui sera utilisé pour exécuter le processus Apache Solr.
• Un nouveau script de service appelé solr.service est également créé, qui peut être géré via les commandes systemctl et service.

Maintenant, vérifiez le service solr en utilisant la commande suivante.

sudo service solr status

La sortie suivante sera affichée, ce qui confirme que le service solr fonctionne en arrière-plan et a été démarré via le script de service.

Vous pouvez également utiliser la commande suivante pour redémarrer ou arrêter le service Solr.

sudo service solr restart  
sudo service solr stop

Configuration d’Apache Solr

Maintenant que vous avez installé Apache Solr. Dans l’étape suivante, vous ferez ce qui suit :

• Configurer le système Debian : Vous ajusterez votre machine Debian en augmentant shmmax, nr_hugepages et les limites système pour les processus max et les fichiers ouverts.
• Configurer Solr : Vous augmenterez la mémoire maximale du tas pour Solr et configurerez une adresse IP locale spécifique comme hôte Apache Solr.

Commençons.

Configuration du système Debian

Pour optimiser Apache Solr, vous devez augmenter les shmmax, nr_hugepages, max processes et max open files sur votre machine Debian.

Exécutez la commande suivante pour augmenter les paramètres du noyau shmmax et nr_hugepages sur votre machine Debian.

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

Ensuite, ouvrez le fichier /etc/security/limits.conf en utilisant la commande de l’éditeur nano suivante.

sudo nano /etc/security/limits.conf

Ajoutez la configuration suivante à la fin de la ligne. Cela définira le maximum process et maximum open files pour l’utilisateur Solr à 65000.

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

Enregistrez le fichier et quittez l’éditeur une fois terminé.

Enfin, vérifiez les ulimits (processus max et fichiers ouverts max) pour l’utilisateur solr en exécutant la commande suivante.

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

Si cela réussit, vous devriez maintenant avoir le ulimit max process et max open files pour l’utilisateur solr configuré à 65000.

Configuration d’Apache Solr

Après avoir apporté des modifications à votre machine Debian, vous allez maintenant modifier la configuration d’Apache Solr pour définir la mémoire maximale du tas à 4 Go, et exécuter Solr sur une adresse IP locale spécifique 192.168.10.15.

Ouvrez la configuration par défaut d’Apache Solr /etc/default/solr.in.sh en utilisant la commande de l’éditeur nano ci-dessous.

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

Ajustez l’option par défaut SOLR_HEAP avec votre mémoire maximale autorisée. Dans cet exemple, vous permettrez à Apache Solr de fonctionner et d’utiliser une mémoire maximale de 4 Go.

SOLR_HEAP="4g"

Ensuite, décommentez les options SOLR_HOST et SOLR_JETTY_HOST et saisissez l’adresse IP de votre serveur. Dans cet exemple, vous exécuterez Apache Solr sur l’adresse IP locale 192.168.10.15.

SOLR_HOST="192.168.10.15"  
SOLR_JETTY_HOST="192.168.10.15"

Enregistrez et fermez le fichier lorsque vous avez terminé.

Ensuite, exécutez la commande suivante pour redémarrer le service solr et appliquer les modifications que vous avez apportées.

sudo service solr restart

Après avoir exécuté la commande, votre Apache Solr fonctionnera sur l’adresse IP de votre serveur 192.168.10.15, et la mémoire maximale du tas sera de 4 Go.

Lancez votre navigateur Web et visitez l’adresse IP du serveur suivie du port 8983, comme http://192.168.10.15:8983/. Vous devriez voir la page du tableau de bord d’Apache Solr comme suit si tout a été fait correctement.

À partir de là, vous pouvez voir que le répertoire d’installation d’Apache Solr /opt/solr fonctionne avec Java OpenJDK 17.

Sécuriser Apache Solr avec le plugin BasicAuth

Dans cette section, vous sécuriserez Apache Solr en ajoutant l’authentification via le plugin BasicAuth et en créant un nouvel utilisateur Solr. Pour ce faire, vous devez créer une configuration spécifique, puis définir le module d’authentification et le module d’autorisation pour les utilisateurs Solr.

Créez un nouveau fichier /var/solr/data/security.json en utilisant la commande de l’éditeur nano suivante. Dans cet exemple, le répertoire de données par défaut pour Apache Solr est /var/solr/data/.

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

Insérez la configuration suivante dans le fichier.

{  
  "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 et fermez le fichier lorsque vous avez terminé.

En procédant ainsi, vous sécuriserez Apache Solr via les éléments suivants :

• BasicAuthPlugin pour l’authentification des utilisateurs et création d’un nouvel utilisateur solr avec le mot de passe solrRocks.
• RuleBasedAuthorizationPlugin pour l’autorisation et configuration de l’utilisateur solr en tant qu’administrateur pouvant accéder à tous les index de votre installation Apache Solr.

Ensuite, exécutez la commande suivante pour redémarrer le service solr et appliquer les modifications que vous avez apportées.

sudo service solr restart

Maintenant, retournez à votre navigateur Web et rechargez l’onglet Apache Solr. Si tout est réussi, vous devriez être redirigé vers la page de connexion Solr comme suit.

Connectez-vous avec l’utilisateur solr et le mot de passe SolrRocks.

Si la tentative de connexion réussit, vous devriez voir le tableau de bord d’Apache Solr sur votre écran.

Création du premier index Apache Solr

À ce stade, vous avez terminé l’installation d’Apache Solr, vous pouvez maintenant créer votre premier index Solr via la ligne de commande. Mais avant cela, vous devez vous assurer que l’authentification par défaut pour Solr est configurée.

Ouvrez le fichier de configuration Solr /etc/default/solr.in.sh en utilisant la commande de l’éditeur nano suivante.

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

Décommentez les lignes suivantes pour configurer l’authentification par défaut de Solr via l’authentification de base et saisissez l’utilisateur solr et le mot de passe SolrRocks que vous avez créés.

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

Enregistrez le fichier et quittez l’éditeur lorsque vous avez terminé.

Maintenant, exécutez la commande systemctl ci-dessous pour redémarrer le service solr et appliquer les modifications.

sudo service solr restart

Ensuite, exécutez la commande suivante pour créer votre premier index Solr test_core.

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

Une fois l’index créé, vous verrez la sortie attendue “ Nouveau noyau ‘test_core’ créé “ comme ceci :

Enfin, retournez à votre tableau de bord Apache Solr. Ensuite, sélectionnez test_core dans la section du menu déroulant Sélecteur de noyau.

Une fois terminé, vous devriez voir des informations détaillées pour l’index test_core comme suit :

Conclusion

Pour conclure, vous avez maintenant terminé l’installation d’Apache Solr sur le serveur Debian 12 étape par étape. Vous avez installé Apache Solr avec Java OpenJDK 17 et sécurisé l’installation d’Apache Solr en ajoutant une authentification via le plugin BasicAuth. De plus, vous avez également appris à créer un index Solr via la ligne de commande. À partir de maintenant, vous pouvez tirer parti de votre installation Solr en créant un cluster Solr.