Comment télécharger et installer Cassandra on Windows
David Carter
⚡ Résumé intelligent
Téléchargez et installez Cassandra on Windows en décompressant la distribution binaire officielle d'Apache, car l'installateur de DataStax Community Edition présenté dans les anciennes captures d'écran a été retiré en 2017. Cette page couvre les prérequis, les deux méthodes d'installation et la vérification au démarrage.
Apache Cassandra DataStax Enterprise est utilisé par les petites organisations pour stocker d'énormes quantités de données, tandis que DataStax Enterprise est utilisé par les grandes organisations.
Apache Cassandra est géré par le logiciel Apache Foundation.
Condition préalable pour Apache Cassandra Installation
Trois éléments doivent être en place avant Cassandra va commencer le Windows.
- Apache Cassandra binaires. Vous pouvez download Cassandra Téléchargez l'archive binaire (tar.gz) de la version stable actuelle depuis le site web d'Apache.
- Un JDK pris en charge. Java doit être installé et la variable d'environnement JAVA_HOME doit pointer vers le dossier JDK. Cassandra La version 4.x fonctionne sur Java 8 ou 11 ; Cassandra La version 5.x fonctionne sur Java 11 ou 17.
- python. Le client en ligne de commande cqlsh est un Python programme, donc un Python 3. L'installation est nécessaire pour ouvrir le shell CQL.
Un 64 bits Windows La plateforme est supposée telle quelle tout au long du texte. Notez que Windows est une plateforme légèrement testée pour CassandraC’est pourquoi la solution par conteneur décrite plus loin est souvent l’option la plus simple.
Comment télécharger et installer Cassandra
Deux méthodes existent. Les captures d'écran de cette section proviennent de l'assistant de DataStax Community Edition, la méthode décrite dans la plupart des tutoriels existants. Ce programme d'installation n'étant plus publié, la méthode binaire actuelle est présentée en premier, et l'assistant est conservé ensuite pour les lecteurs travaillant avec une copie archivée.
Méthode 1 : Installation à partir de l’archive binaire Apache (méthode actuelle)
Étape 1) Téléchargez l'archive binaire, par exemple apache-cassandra-xyz-bin.tar.gz, depuis la page de téléchargement d'Apache mentionnée ci-dessus. Vérifiez l'intégrité du fichier en le comparant à la somme de contrôle publiée sur cette même page.
Étape 2) ExtracCopiez l'archive dans un chemin sans espaces, tel que C:\cassandra. Les espaces dans le chemin empêchent l'exécution des scripts de démarrage.
Étape 3) Créez les deux variables d'environnement Cassandra Si nécessaire, ajoutez le dossier bin à la variable PATH.
setx CASSANDRA_HOME "C:\cassandra" setx JAVA_HOME "C:\Program Files\Java\jdk-17" setx PATH "%PATH%;C:\cassandra\bin"
Étape 4) Ouvrez une nouvelle invite de commandes pour que les variables soient prises en compte, puis démarrez le nœud au premier plan.
cd C:\cassandra\bin cassandra -f
Laissez cette fenêtre ouverte. Le journal de démarrage se termine par une ligne indiquant que le nœud écoute les clients CQL sur le port 9042.
Étape 5) Dans une seconde invite de commandes, vérifiez que le nœud est opérationnel, puis ouvrez le shell.
nodetool status cqlsh 127.0.0.1 9042
Une ligne d'état commençant par UN Cela signifie que le nœud est opérationnel et fonctionne normalement. L'invite cqlsh confirme que l'installation est terminée.
Méthode 2 : Assistant DataStax Community Edition (ancienne version)
Les captures d'écran ci-dessous illustrent l'ancien programme d'installation MSI. Elles restent utiles pour les utilisateurs qui en possèdent déjà une copie, et l'interface utilisateur qui en résulte se comporte de manière identique.
Étape 1) Lancez le programme d'installation de DataStax Community Edition. Une fois l'installation terminée, la page suivante s'affichera. La capture d'écran montre l'installation de la version 64 bits. Vous pouvez également télécharger la version 32 bits selon vos besoins, mais la version 64 bits est recommandée.
Cette page vous donne des informations sur Cassandra version que vous allez installer. Appuyez sur le bouton « suivant ».
Étape 2) Appuyez sur le bouton « Suivant ». La page suivante s'affichera.
Cette page concerne le contrat de licence. Cochez la case et appuyez sur le bouton suivant.
Étape 3) Appuyez sur le bouton « Suivant ». La page suivante s'affichera et vous demandera l'emplacement d'installation.
- L'emplacement par défaut est C:\Program Files. Vous pouvez modifier l'emplacement d'installation si vous souhaitez modifier. Il est recommandé de ne pas modifier l'emplacement d'installation.
- Après avoir défini l'emplacement d'installation, appuyez sur le bouton « suivant »
Étape 4) Commencer Cassandra et OpsCenter. Après avoir cliqué sur le bouton « Suivant » à l’étape précédente, la page suivante s’affichera. Cette page vous demandera si vous souhaitez démarrer automatiquement. Cassandra et OpsCenter.
- Cochez les cases si vous souhaitez démarrer automatiquement Cassandra et OpsCenter.
- Après avoir fourni ces informations, appuyez sur le bouton « suivant ».
Étape 5) Cliquez sur le bouton Installer. Le programme d'installation a recueilli toutes les informations nécessaires et est maintenant prêt à installer le programme. Appuyez sur le bouton Installer.
Étape 6) Cliquez sur Suivant. Après avoir cliqué sur le bouton « Installer », la page suivante s'affichera.
L'édition communautaire de DataStax est en cours d'installation. Une fois l'installation terminée, cliquez sur le bouton « Suivant ». Lorsque l'installation est terminée, cliquez sur le bouton « Terminer ».
Accédez aux programmes de démarrage de Windows, recherchez Cassandra CQL Shell et exécutez le Cassandra Coquille. Après avoir couru Cassandra shell, vous verrez la ligne de commande suivante
Vous pouvez désormais créer un espace de clés, des tables et écrire des requêtes.
Fonctionnement Cassandra dans Docker sur Windows
Les deux méthodes ci-dessus fonctionnent Cassandra directement sur Windows, qui est la plateforme la moins testée pour ce projet. Un conteneur évite le Java Les problèmes de chemin d'accès, d'enregistrement de service et d'autorisation de fichiers sont les principales causes de la plupart des problèmes. Windows en cas d'échec d'installation, et il supprime ensuite proprement le nœud.
Avec Docker Desktop installé, une seule commande permet de démarrer un nœud unique et fonctionnel.
docker run --name cassandra-node -p 9042:9042 -d cassandra:latest
Laissez au nœud environ une minute pour s'initialiser, puis vérifiez son état et ouvrez le shell à l'intérieur du conteneur.
docker exec -it cassandra-node nodetool status docker exec -it cassandra-node cqlsh
Les données écrites de cette manière résident à l'intérieur du conteneur et disparaissent lorsque celui-ci est supprimé. Pour les conserver, attachez un volume au répertoire de données :
docker run --name cassandra-node -p 9042:9042 \ -v cassandra-data:/var/lib/cassandra -d cassandra:latest
Cette méthode est le choix pratique pour l'apprentissage et le développement local, car un nœud défectueux est supprimé et recréé en quelques secondes.
Dépannage a Cassandra Installation sur Windows
Échecs de démarrage sur Windows Elles se répartissent en un petit nombre de causes récurrentes. Chacune d'elles génère un message distinctif dans la console.
| Symptôme | Cause et solution |
|---|---|
| « JAVA_HOME n'est pas défini » | La variable est manquante ou pointe vers un JRE au lieu d'un JDK. Définissez-la sur le dossier du JDK et ouvrez une nouvelle invite de commandes. |
| Le processus s'arrête immédiatement sans journalisation. | Le chemin d'installation contient un espace. Déplacez le dossier vers un emplacement tel que C:\cassandra. |
| « Incapable de bavarder avec ses pairs » | Un démarrage précédent ayant échoué a laissé des données obsolètes. Arrêtez le nœud et supprimez les dossiers data et commitlog situés dans le répertoire d'installation. |
| « Adresse déjà utilisée » | Le port 9042 ou 7000 est utilisé par un autre processus, souvent un processus précédent. Cassandra Exécutez-le. Fermez-le ou modifiez les ports dans cassandra.yaml. |
| cqlsh signale « aucun module nommé cqlshlib » | Python Il manque une version ou la mauvaise version est en tête du PATH. Installer Python 3 et confirmer avec python --version. |
Une fois que le nœud signale les connexions UN et cqlsh, l'étape suivante consiste à créer les structures de stockage, comme expliqué dans la section suivante. Cassandra espace de clés tutoriel, suivi du Cassandra table tutoriel.
