PDB Hilfe

So installieren Sie eine Cassandra-Datenbank unter Windows 11

📅
🕑 5 Minuten Lesezeit

Die Installation von Cassandra unter Windows 11 kann etwas knifflig sein, wenn man nicht vorbereitet ist, insbesondere da sie stark von Java und Umgebungsvariablen abhängt. Manchmal, selbst nach vollständiger Installation, weigert sich die Kommandozeile einfach, Cassandra-Befehle zu erkennen, oder CQLSH kann keine Verbindung herstellen. Ich kenne das Problem – alles eingerichtet, aber nichts funktionierte, bis ich einige dieser Eigenheiten herausgefunden hatte. Hoffentlich helfen diese Schritte, einige der typischen Schwierigkeiten zu vermeiden, wie z. B.dass Java nicht erkannt wird oder Cassandra nicht ordnungsgemäß startet. Einmal konfiguriert, lässt sich Cassandra unter Windows für Entwicklung oder Tests eigentlich recht reibungslos ausführen, aber Windows macht es einem im Vergleich zu Linux natürlich etwas schwerer.

So beheben Sie Installationsprobleme mit Cassandra unter Windows 11

Stellen Sie sicher, dass Java ordnungsgemäß installiert und erkannt wird.

Eines der häufigsten Probleme ist, dass Cassandra nicht startet, weil Java nicht korrekt erkannt wird. Cassandra benötigt Java und ist von Umgebungsvariablen wie JAVA_HOME abhängig. Wenn Sie Java installiert haben, Ihre Eingabeaufforderung es aber nicht findet, startet Cassandra nicht oder CQLSH gibt Fehler aus. Um dies zu beheben, überprüfen Sie, ob Java im Systempfad (PATH) enthalten ist und ob JAVA_HOME auf den richtigen Ordner verweist.

  • Öffnen Sie das Startmenü und suchen Sie nach Erweiterte Systemeinstellungen anzeigen oder klicken Sie mit der rechten Maustaste auf Dieser PC > Eigenschaften > Erweiterte Systemeinstellungen.
  • Klicken Sie auf Umgebungsvariablen.
  • Suchen Sie in den Systemvariablen nach JAVA_HOME oder erstellen Sie eine solche Variable.
  • Setzen Sie den Wert auf Ihren Java-Installationspfad, z. B.: C:\Program Files\Java\jdk-21.
  • Fügen Sie %JAVA_HOME%\bin zu Ihrer Pfad-Variablen hinzu – klicken Sie einfach auf Bearbeiten, dann auf Neu und fügen Sie dies ein.

Dies hilft Windows dabei, Cassandra den Speicherort von Java mitzuteilen.Bei manchen Konfigurationen reicht es nicht aus, nur JAVA_HOME festzulegen – es muss auch zum Pfad hinzugefügt werden.

Konfigurieren Sie CASSANDRA_HOME und PATH korrekt.

Als Nächstes müssen Sie Windows mitteilen, wo sich Cassandra befindet. Das Vorgehen ist dasselbe: Umgebungsvariablen.

  • Erstellen Sie eine CASSANDRA_HOME- Variable, die auf Ihren Cassandra-Ordner verweist, z. B.: C:\Cassandra\apache-cassandra-5.0.
  • Vergessen Sie nicht, %CASSANDRA_HOME%\bin zu Ihrem Systempfad hinzuzufügen, damit Sie Befehle von überall ausführen können. Das spart enorm viel Zeit.

Nachdem Sie diese Einstellungen vorgenommen haben, starten Sie die Eingabeaufforderung oder PowerShell neu, um sicherzustellen, dass die Umgebungsvariablen neu geladen werden.Überprüfen Sie dies mit den Befehlen `npm run dev` echo %JAVA_HOME%und `npm echo %CASSANDRA_HOME%run dev`.Wenn diese die richtigen Pfade anzeigen, können Sie fortfahren.

Installieren Sie Python für CQLSH

Das bereitet vielen Nutzern Probleme, insbesondere weil die Kommandozeilenschnittstelle von Cassandra, CQLSH, oft Python benötigt. Ohne Python erhalten Sie möglicherweise Fehlermeldungen wie „Python nicht gefunden“ oder das Programm lässt sich einfach nicht starten. Laden Sie Python von python.org herunter, führen Sie das Installationsprogramm aus und stellen Sie sicher, dass Sie „Python zum PATH hinzufügen“ aktivieren.

Öffnen Sie die Kommandozeile und geben Sie den Befehl ein python --version. Die Versionsnummer sollte angezeigt werden. Falls nicht, versuchen Sie eine Neuinstallation – manchmal wird der Pfad nach der Installation nicht korrekt aktualisiert.

Cassandra richtig starten

Sobald alle Umgebungsvariablen gesetzt und Java sowie Python installiert sind, öffnen Sie die Eingabeaufforderung als Administrator. Navigieren Sie zum Verzeichnis „bin“, z. B.:

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

Und lauf:

cassandra

Dadurch wird der Server gestartet. Manchmal dauert es ein bis zwei Minuten, bis er vollständig geladen ist, und die Protokolldateien werden angezeigt – das ist normal. Wenn nach einer Weile nichts passiert, überprüfen Sie die Protokolldateien im \logsentsprechenden Ordner. Stellen Sie sicher, dass die Windows-Firewall die Ports 9042, 7000 und 7199 nicht blockiert. Erteilen Sie gegebenenfalls die erforderlichen Berechtigungen.

CQLSH starten und verbinden

Nachdem der Server läuft, öffnen Sie eine neue Eingabeaufforderung, navigieren Sie erneut zu \binund geben Sie ein cqlsh. Wenn alles korrekt konfiguriert ist, sehen Sie eine Eingabeaufforderung wie diese:

Connected to Test Cluster at 127.0.0.1:9042

Das bedeutet, Cassandra ist betriebsbereit. Jetzt können Sie Keyspaces und Tabellen erstellen, genau wie in der Dokumentation beschrieben, z. B.:

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

Und dann:

USE testdb;

Bei Verbindungsfehlern sollten Sie in der Regel die Umgebungseinstellungen überprüfen oder nach Portkonflikten und Firewall-Problemen suchen. Manchmal hilft es auch, den Rechner nach dem Festlegen der Umgebungsvariablen neu zu starten, damit alles erkannt wird.

Zusätzliche Tipps aus der Praxis:

  • Führen Sie die Eingabeaufforderung als Administrator aus – manchmal benötigt Cassandra höhere Berechtigungen, um Ports zuzuweisen.
  • Halten Sie sich an einfache Pfade wie C:\Cassandra– Windows kann Pfadprobleme verursachen, wenn Sie zu komplizierte verschachtelte Ordner verwenden.
  • Falls beim Starten von Cassandra Fehler bezüglich der Java-Version oder der Meldung „Java nicht gefunden“ auftreten, überprüfen Sie den Pfad in JAVA_HOME.
  • Falls CQLSH nicht startet, überprüfen Sie die Python-Installation und fügen Sie sie gegebenenfalls zum PATH hinzu.

Und ehrlich gesagt, bei manchen Konfigurationen läuft beim ersten Start vielleicht nicht alles reibungslos. Unter Umständen müssen Sie den Rechner neu starten oder die Umgebungsvariablen überprüfen. Windows macht die Dinge gerne kompliziert, aber sobald alles eingerichtet ist, läuft Cassandra ziemlich reibungslos.

Zusammenfassung

  • Stellen Sie sicher, dass Java installiert ist und JAVA_HOME korrekt eingerichtet ist.
  • Fügen Sie die Binärdateien von Java und Cassandra zu Ihrem Systempfad hinzu.
  • Stellen Sie sicher, dass CASSANDRA_HOME auf Ihren extrahierten Ordner verweist.
  • Installieren Sie Python, wenn Sie CQLSH problemlos nutzen möchten.
  • Führen Sie Cassandra über die Befehlszeile als Administrator aus.
  • Starten Sie CQLSH über eine neue Eingabeaufforderung, um eine Verbindung zu Ihrem lokalen Cluster herzustellen.

Zusammenfassung

Cassandra unter Windows 11 zum Laufen zu bringen, kann sich zunächst wie ein Kampf anfühlen, aber sobald die Umgebungsvariablen korrekt gesetzt sind und der Server hochgefahren ist, läuft alles wie am Schnürchen. Befolgen Sie diese Schritte, behalten Sie die Protokolldateien im Auge und haben Sie beim Start etwas Geduld. Es ist sehr befriedigend, Cassandra auf dem eigenen Windows-Rechner laufen zu sehen, insbesondere da es normalerweise besser für Linux-Umgebungen geeignet ist. Hoffentlich erspart dies jemandem viel Frust und stundenlange Fehlersuche. Achten Sie besonders auf die Umgebungsvariablen – Windows ist da sehr pingelig.