Herunterladen und Installieren Cassandra on Windows

โšก Intelligente Zusammenfassung

Laden Sie Cassandra on Windows durch Entpacken der offiziellen Apache-Binรคrdistribution, da der in den รคlteren Screenshots gezeigte DataStax Community Edition-Installer im Jahr 2017 eingestellt wurde. Diese Seite behandelt die Voraussetzungen, beide Installationswege und die Startprรผfung.

  • โš ๏ธ Installationsstatus: Die DataStax Community Edition MSI wird nicht mehr vertrieben, daher ist der aktuelle Weg das Apache-Binรคrarchiv.
  • โ˜• Java Voraussetzung: Ein unterstรผtztes JDK muss installiert und JAVA_HOME gesetzt sein, bevor Cassandra wird beginnen.
  • ๐Ÿ cqlsh-Anforderung: Die CQL-Shell ist eine Python Skript, also Python muss vorhanden sein, um Abfragen รผber die Befehlszeile auszufรผhren.
  • ๐Ÿ“‚ Binรคrinstallation: ExtracDas Herunterladen des Archivs und das Festlegen von CASSANDRA_HOME ist die Installation abgeschlossen; ein Installationsassistent ist nicht erforderlich.
  • ๐Ÿณ Container-Option: Ein einzelner Docker-Befehl startet einen funktionierenden Knoten und vermeidet Windows-ganz spezifische Probleme.
  • โœ… รœberprรผfung: Die Meldung โ€žnodetool status reporting UNโ€œ und eine cqlsh-Eingabeaufforderung verbinden bestรคtigen, dass der Knoten fehlerfrei funktioniert.

Lade und installiere Cassandra on Windows

Apache Cassandra wird von kleineren Organisationen genutzt, wรคhrend DataStax Enterprise von grรถรŸeren Organisationen zur Speicherung riesiger Datenmengen eingesetzt wird.

Apache Cassandra wird von der Apache Software verwaltet Foundation.

Voraussetzung fรผr Apache Cassandra Installation

Drei Punkte mรผssen erfรผllt sein, bevor Cassandra beginnt am Windows.

  • Apache Cassandra Binรคrdateien. Nutze einfach das herunterladen Cassandra Von der Apache-Website. Laden Sie das Binรคrarchiv (Tarball) der aktuellen stabilen Version herunter.
  • Ein unterstรผtztes JDK. Java muss installiert sein, und die Umgebungsvariable JAVA_HOME muss auf den JDK-Ordner verweisen. Cassandra 4.x lรคuft auf Java 8 oder 11; Cassandra 5.x lรคuft auf Java 11 oder 17.
  • Python. Der cqlsh-Befehlszeilenclient ist ein Python Programm, also ein Python Zur ร–ffnung der CQL-Shell ist die Installation von 3 erforderlich.

Ein 64-Bit Windows Die Plattform wird im gesamten Text vorausgesetzt. Beachten Sie, dass Windows ist eine wenig getestete Plattform fรผr CassandraAus diesem Grund ist die spรคter beschriebene Containerroute oft die reibungslosere Option.

Herunterladen und Installieren Cassandra

Es gibt zwei Wege. Die Screenshots in diesem Abschnitt stammen vom Installationsassistenten der DataStax Community Edition, der in den meisten bestehenden Anleitungen beschrieben wird. Da dieses Installationsprogramm nicht mehr verรถffentlicht wird, wird zunรคchst die aktuelle Installationsmethode mit Binรคrdateien vorgestellt. Der Installationsassistent wird anschlieรŸend fรผr Leser beibehalten, die mit einer archivierten Version arbeiten.

Methode 1: Installation aus dem Apache-Binรคrarchiv (aktuelle Methode)

Schritt 1) Laden Sie das Binรคrarchiv (z. B. apache-cassandra-xyz-bin.tar.gz) von der oben verlinkten Apache-Downloadseite herunter. รœberprรผfen Sie die Datei anhand der auf derselben Seite verรถffentlichten Prรผfsumme.

Schritt 2) ExtracDas Archiv muss in einen Pfad ohne Leerzeichen verschoben werden, z. B. C:\cassandra. Leerzeichen im Pfad fรผhren dazu, dass die Startskripte fehlschlagen.

Schritt 3) Erstellen Sie die beiden Umgebungsvariablen Cassandra Erwartet wird, dann wird der Bin-Ordner zum PATH hinzugefรผgt.

setx CASSANDRA_HOME "C:\cassandra"
setx JAVA_HOME "C:\Program Files\Java\jdk-17"
setx PATH "%PATH%;C:\cassandra\bin"

Schritt 4) ร–ffnen Sie eine neue Eingabeaufforderung, damit die Variablen wirksam werden, und starten Sie dann den Knoten im Vordergrund.

cd C:\cassandra\bin
cassandra -f

Lassen Sie dieses Fenster geรถffnet. Das Startprotokoll endet mit einer Zeile, die besagt, dass der Knoten auf Port 9042 auf CQL-Clients wartet.

Schritt 5) รœberprรผfen Sie in einer zweiten Eingabeaufforderung, ob der Knoten betriebsbereit ist, und รถffnen Sie dann die Shell.

nodetool status
cqlsh 127.0.0.1 9042

Eine Statuszeile, die beginnt mit UN Das bedeutet, dass der Knoten betriebsbereit und normal funktioniert. Die cqlsh-Eingabeaufforderung bestรคtigt den Abschluss der Installation.

Methode 2: DataStax Community Edition-Assistent (รคltere Version)

Die folgenden Screenshots dokumentieren den nicht mehr existierenden MSI-Installer. Sie sind weiterhin nรผtzlich fรผr Leser, die bereits eine Kopie besitzen, und die resultierende Shell verhรคlt sich identisch.

Schritt 1) Fรผhren Sie das Setup der DataStax Community Edition aus. Nach der Installation wird die folgende Seite angezeigt. Im Screenshot ist die Installation der 64-Bit-Version zu sehen. Sie kรถnnen je nach Bedarf auch die 32-Bit-Version herunterladen. Die 64-Bit-Version wird jedoch empfohlen.

Lade und installiere Cassandra

Auf dieser Seite finden Sie Informationen zum Cassandra welche Version Sie installieren mรถchten. Klicken Sie auf die Schaltflรคche โ€žWeiterโ€œ.

Schritt 2) Drรผcken Sie die Schaltflรคche โ€žWeiterโ€œ. Nach dem Drรผcken der Schaltflรคche โ€žWeiterโ€œ wird die nรคchste Seite angezeigt.

Lade und installiere Cassandra

Auf dieser Seite geht es um die Lizenzvereinbarung. Markieren Sie das Kontrollkรคstchen und klicken Sie auf die Schaltflรคche Weiter.

Schritt 3) Drรผcken Sie die Schaltflรคche โ€žWeiterโ€œ. Auf der folgenden Seite werden Sie nach dem Installationsort gefragt.

  1. Der Standardspeicherort ist C:\Programme. Sie kรถnnen den Installationsort รคndern, wenn Sie eine ร„nderung wรผnschen. Es wird empfohlen, den Installationsort nicht zu รคndern.
  2. Nachdem Sie den Installationsort festgelegt haben, klicken Sie auf die Schaltflรคche โ€žWeiterโ€œ.

Lade und installiere Cassandra

Schritt 4) Start Cassandra und OpsCenter. Nach dem Klicken auf โ€žWeiterโ€œ im vorherigen Schritt wird die folgende Seite angezeigt. Auf dieser Seite werden Sie gefragt, ob Sie automatisch starten mรถchten. Cassandra und OpsCenter.

  1. Aktivieren Sie die Kontrollkรคstchen, wenn Sie automatisch starten mรถchten Cassandra und OpsCenter.
  2. Nachdem Sie diese Informationen eingegeben haben, klicken Sie auf die Schaltflรคche โ€žWeiterโ€œ.

Lade und installiere Cassandra

Schritt 5) Klicken Sie auf die Schaltflรคche โ€žInstallierenโ€œ. Das Setup hat alle notwendigen Informationen gesammelt und ist nun bereit zur Installation. Klicken Sie auf โ€žInstallierenโ€œ.

Lade und installiere Cassandra

Schritt 6) Klicken Sie auf Weiter. Nach dem Klicken auf die Schaltflรคche โ€žInstallierenโ€œ wird die folgende Seite angezeigt.

Lade und installiere Cassandra

Die DataStax Community Edition wird installiert. Klicken Sie nach Abschluss der Installation auf โ€žWeiterโ€œ. Wenn die Installation erfolgreich abgeschlossen wurde, klicken Sie auf โ€žFertigstellenโ€œ.

Lade und installiere Cassandra

Gehen Sie zu Windows Start Programme, suchen Cassandra CQL Shell und fรผhren Sie die aus Cassandra Hรผlse. Nach dem Rennen Cassandra Shell sehen Sie die folgende Befehlszeile

Lade und installiere Cassandra

Jetzt kรถnnen Sie einen Schlรผsselraum und Tabellen erstellen und Abfragen schreiben.

Laufen Cassandra in Docker auf Windows

Beide oben genannten Methoden laufen Cassandra direkt auf Windows, welche die am wenigsten getestete Plattform fรผr das Projekt ist. Ein Container vermeidet das Java Pfad-, Dienstregistrierungs- und Dateiberechtigungsprobleme, die die meisten Windows Installationsfehler werden behoben, und der Knoten wird anschlieรŸend sauber entfernt.

Mit installiertem Docker Desktop genรผgt ein einziger Befehl, um einen funktionierenden einzelnen Knoten zu starten.

docker run --name cassandra-node -p 9042:9042 -d cassandra:latest

Geben Sie dem Knoten etwa eine Minute Zeit zum Starten, รผberprรผfen Sie dann seinen Zustand und รถffnen Sie die Shell innerhalb des Containers.

docker exec -it cassandra-node nodetool status
docker exec -it cassandra-node cqlsh

Auf diese Weise geschriebene Daten befinden sich innerhalb des Containers und gehen verloren, wenn der Container entfernt wird. Um sie zu behalten, muss dem Datenverzeichnis ein Volume zugewiesen werden:

docker run --name cassandra-node -p 9042:9042 \
  -v cassandra-data:/var/lib/cassandra -d cassandra:latest

Dieser Weg ist die praktische Wahl fรผr Lernprozesse und die lokale Entwicklung, da ein defekter Knoten verworfen und innerhalb von Sekunden neu erstellt wird.

Fehlerbehebung a Cassandra Installation auf Windows

Startup-Pleiten Windows Sie lassen sich in wenige wiederkehrende Ursachen einteilen. Jede dieser Ursachen erzeugt eine eigene Meldung in der Konsole.

Symptom Ursache und Lรถsung
โ€žJAVA_HOME ist nicht gesetztโ€œ Die Variable fehlt oder verweist auf eine JRE anstatt auf ein JDK. Setzen Sie sie auf den JDK-Ordner und รถffnen Sie eine neue Eingabeaufforderung.
Der Prozess wird ohne Protokollierung sofort beendet. Der Installationspfad enthรคlt ein Leerzeichen. Verschieben Sie den Ordner in einen Pfad wie z. B. C:\cassandra.
โ€žKann mit Gleichaltrigen nicht tratschenโ€œ Ein zuvor fehlgeschlagener Start hat veraltete Daten hinterlassen. Stoppen Sie den Knoten und lรถschen Sie die Ordner โ€ždataโ€œ und โ€žcommitlogโ€œ im Installationsverzeichnis.
โ€žAdresse wird bereits verwendetโ€œ Port 9042 oder 7000 wird von einem anderen Prozess belegt, oft von einem vorherigen Cassandra Fรผhren Sie das Programm aus. SchlieรŸen Sie es oder รคndern Sie die Ports in der Datei cassandra.yaml.
cqlsh meldet โ€žKein Modul namens cqlshlib gefundenโ€œ Python Die falsche Version fehlt oder sie steht an erster Stelle im PATH. Installieren Python 3 und รผberprรผfen Sie dies mit python --version.

Sobald der Knoten UN- und cqlsh-Verbindungen meldet, besteht der nรคchste Schritt in der Erstellung von Speicherstrukturen, die im Abschnitt [Abschnittsnummer einfรผgen] beschrieben werden. Cassandra Schlรผsselraum Tutorial, gefolgt von der Cassandra Tabelle Tutorial.

Hรคufig gestellte Fragen

Nein. DataStax hat die Verรถffentlichung der Community Edition nach 2017 eingestellt, und die Windows MSI-Dateien kรถnnen nicht mehr heruntergeladen werden. Verwenden Sie stattdessen das Apache-Binรคrarchiv oder ein Container-Image.

Cassandra 4.x unterstรผtzt Java 8 und 11. Cassandra 5.x unterstรผtzt Java 11 und 17. Es wird ein JDK anstelle einer JRE benรถtigt, und JAVA_HOME muss darauf verweisen.

Die mitgelieferte Datei cassandra.bat akzeptiert einen Installationsparameter zur Registrierung eines Dienstes, dieser Pfad wurde jedoch kaum getestet. Fรผr alles, was รผber Experimente hinausgeht, fรผhren Sie Folgendes aus: Cassandra auf Linux oder in einem Container.

Einfรผgen des system.log-Stacks tracDie Verwendung eines KI-Assistenten zur Fehlerbehebung identifiziert die Ursache in der Regel schnell, da Startfehler gut dokumentiert sind. รœberprรผfen Sie die vorgeschlagene Lรถsung anhand der Datei cassandra.yaml, bevor Sie sie anwenden.

Betrachten Sie sie als Ausgangspunkt. Heap-GrรถรŸe, gleichzeitige Lesevorgรคnge und Komprimierungsdurchsatz hรคngen von der tatsรคchlichen Hardware ab, daher sollte jeder generierte Wert auf dem Zielrechner getestet werden.

Fassen Sie diesen Beitrag mit folgenden Worten zusammen: