PDB Help

Comment installer Cassandra DB sur Windows 11

📅
🕑 5 minutes de lecture

Installer Cassandra sur Windows 11 peut s’avérer fastidieux si l’on n’est pas préparé, notamment en raison de sa forte dépendance à Java et aux variables d’environnement. Parfois, même après une installation complète, la ligne de commande refuse de reconnaître les commandes Cassandra ou la connexion CQLSH est impossible. J’ai déjà rencontré ce problème : tout était configuré, mais rien ne fonctionnait jusqu’à ce que je comprenne certaines de ces particularités. Ces étapes devraient permettre d’éviter certains désagréments courants, comme la non-détection de Java ou le dysfonctionnement de Cassandra au démarrage. Une fois configuré, Cassandra s’utilise assez facilement sous Windows pour le développement ou les tests, mais Windows rend la tâche un peu moins intuitive que Linux, il faut l’avouer.

Comment résoudre les problèmes d’installation de Cassandra sous Windows 11

Vérifiez que Java est correctement installé et reconnu.

L’un des problèmes les plus fréquents est l’impossibilité de lancer Cassandra en raison d’une détection incorrecte de Java. Cassandra nécessite Java et dépend de variables d’environnement telles que JAVA_HOME. Si vous avez installé Java mais que votre invite de commandes ne le trouve pas, Cassandra ne démarrera pas ou CQLSH générera des erreurs. Pour résoudre ce problème, vérifiez que Java est bien présent dans votre variable d’environnement PATH et que JAVA_HOME pointe vers le bon répertoire.

  • Ouvrez le menu Démarrer et recherchez Afficher les paramètres système avancés ou cliquez avec le bouton droit sur Ce PC > Propriétés > Paramètres système avancés.
  • Cliquez sur Variables d’environnement.
  • Dans Variables système, recherchez ou créez JAVA_HOME.
  • Définissez sa valeur sur le chemin d’accès à votre installation Java, par exemple : C:\Program Files\Java\jdk-21.
  • Ajoutez %JAVA_HOME%\bin à votre variable Path — cliquez simplement sur Modifier, puis sur Nouveau, et collez ceci.

Cela permet à Windows d’indiquer à Cassandra l’emplacement de Java.Sur certaines configurations, la définition de la variable d’environnement JAVA_HOME ne suffit pas ; il faut également l’ajouter au chemin d’accès.

Configurez correctement CASSANDRA_HOME et PATH

Ensuite, il faut indiquer à Windows où se trouve Cassandra. Même procédure : variables d’environnement.

  • Créez une variable CASSANDRA_HOME pointant vers votre dossier Cassandra, par exemple : C:\Cassandra\apache-cassandra-5.0.
  • N’oubliez pas d’ajouter %CASSANDRA_HOME%\bin à votre variable d’environnement PATH pour pouvoir exécuter des commandes depuis n’importe quel emplacement. C’est un gain de temps considérable.

Après avoir configuré ces paramètres, redémarrez votre invite de commandes ou PowerShell pour que les variables d’environnement soient rechargées. Vérifiez avec ` echo %JAVA_HOME%ls` et `ls` echo %CASSANDRA_HOME%. Si les chemins d’accès sont corrects, tout est en ordre.

Installer Python pour CQLSH

Cette situation est souvent source de confusion, notamment parce que l’interface en ligne de commande de Cassandra, CQLSH, nécessite fréquemment Python. Sans Python, vous risquez d’obtenir des erreurs du type « Python introuvable » ou de voir le programme refuser de se lancer. Téléchargez Python depuis python.org, exécutez le programme d’installation et assurez-vous de cocher la case « Ajouter Python au PATH ».

Ouvrez l’invite de commandes et saisissez la commande python --version. Le numéro de version devrait s’afficher. Si ce n’est pas le cas, essayez de réinstaller le logiciel ; il arrive que la variable d’environnement PATH ne se mette pas à jour correctement après l’installation.

Démarrer Cassandra correctement

Une fois toutes les variables d’environnement configurées et Java et Python installés, ouvrez l’invite de commandes en tant qu’administrateur. Accédez au répertoire bin, par exemple :

cd C:\Cassandra\apache-cassandra-5.0\bin

Et courir :

cassandra

Cela lancera le serveur. Le chargement complet peut prendre une ou deux minutes, et les journaux défileront ; c’est normal. Si rien ne se passe au bout d’un moment, consultez les journaux dans \logsle dossier pour trouver des indices. Assurez-vous que le pare-feu Windows n’empêche pas l’accès aux ports (9042, 7000, 7199).Si des demandes d’autorisation s’affichent, autorisez l’accès.

Lancement de CQLSH et connexion

Une fois le serveur démarré, ouvrez une nouvelle invite de commandes, accédez à nouveau à l’emplacement indiqué \binet saisissez la commande cqlsh. Si tout est correctement configuré, vous verrez une invite similaire à :

Connected to Test Cluster at 127.0.0.1:9042

Cela signifie que Cassandra est opérationnel. Vous pouvez maintenant commencer à créer des espaces de clés et des tables, comme indiqué dans la documentation, par exemple :

CREATE KEYSPACE testdb WITH replication = { 'class': 'SimpleStrategy', 'replication_factor': 1 };

Et puis:

USE testdb;

En cas d’erreur de connexion, vérifiez généralement la configuration de votre environnement, ou recherchez d’éventuels conflits de ports ou problèmes de pare-feu. Parfois, un simple redémarrage de la machine après la configuration des variables d’environnement suffit à résoudre le problème.

Conseils supplémentaires tirés du terrain :

  • Exécutez l’invite de commandes en tant qu’administrateur — Cassandra a parfois besoin de privilèges plus élevés pour allouer les ports.
  • Utilisez des chemins d’accès simples C:\Cassandra— Windows peut générer des problèmes de chemin si vous utilisez des dossiers imbriqués trop complexes.
  • Si le démarrage de Cassandra génère des erreurs concernant la version de Java ou si celle-ci est introuvable, vérifiez le chemin d’accès dans JAVA_HOME.
  • Si CQLSH ne démarre pas, vérifiez l’installation de Python et ajoutez-le également au PATH.

Honnêtement, sur certaines configurations, il se peut que tout ne fonctionne pas parfaitement du premier coup. Il faudra peut-être redémarrer ou revérifier les variables d’environnement. Windows a la fâcheuse tendance à compliquer les choses, mais une fois la configuration terminée, Cassandra fonctionne généralement sans problème.

Résumé

  • Assurez-vous que Java est installé et que la variable d’environnement JAVA_HOME est correctement configurée.
  • Ajoutez les binaires Java et Cassandra à votre variable d’environnement PATH.
  • Assurez-vous que la variable d’environnement CASSANDRA_HOME pointe vers votre dossier extrait.
  • Installez Python si vous souhaitez utiliser CQLSH sans problème.
  • Exécutez Cassandra en ligne de commande en tant qu’administrateur.
  • Lancez CQLSH depuis une nouvelle invite de commandes pour vous connecter à votre cluster local.

Conclure

Configurer Cassandra pour Windows 11 peut sembler fastidieux, mais une fois les variables d’environnement corrigées et le serveur démarré, tout change. Suivez ces étapes, consultez les fichiers journaux et soyez patient pendant le démarrage. Voir Cassandra fonctionner sur votre machine Windows est très gratifiant, d’autant plus qu’il est généralement plus adapté aux environnements Linux. Espérons que cela vous évitera bien des tracas et des heures de dépannage. Attention aux chemins d’accès à l’environnement : Windows y est très sensible.