PDB Hulp

Hoe installeer je Cassandra DB op Windows 11?

📅
🕑 5 minuten lezen

Het installeren van Cassandra op Windows 11 kan een behoorlijke uitdaging zijn als je er niet goed op voorbereid bent, vooral omdat het sterk afhankelijk is van Java en omgevingsvariabelen. Soms weigert de commandoregel, zelfs na de installatie, Cassandra-commando’s te herkennen of maakt CQLSH geen verbinding. Ik heb het zelf meegemaakt: alles ingesteld, maar niets werkte totdat ik een paar van deze eigenaardigheden had opgelost. Hopelijk kunnen deze stappen je helpen om een ​​aantal veelvoorkomende problemen te voorkomen, zoals Java dat niet wordt gedetecteerd of Cassandra dat niet goed opstart. Eenmaal geconfigureerd, is het eigenlijk vrij soepel om Cassandra op Windows te gebruiken voor ontwikkeling of testen, maar Windows maakt het natuurlijk wel iets minder eenvoudig dan Linux.

Hoe los je installatieproblemen met Cassandra op in Windows 11?

Zorg ervoor dat Java correct is geïnstalleerd en herkend.

Een van de meest voorkomende problemen is dat Cassandra niet opstart omdat Java niet correct wordt gedetecteerd. Cassandra heeft Java nodig en is afhankelijk van omgevingsvariabelen zoals JAVA_HOME. Als je Java hebt geïnstalleerd, maar je opdrachtprompt het niet kan vinden, start Cassandra niet of geeft CQLSH fouten. Om dit op te lossen, controleer of Java in je systeem-PATH staat en of JAVA_HOME naar de juiste map verwijst.

  • Open het Startmenu en zoek naar Geavanceerde systeeminstellingen bekijken of klik met de rechtermuisknop op Deze pc > Eigenschappen > Geavanceerde systeeminstellingen.
  • Klik op Omgevingsvariabelen.
  • Zoek in Systeemvariabelen naar JAVA_HOME of maak deze aan.
  • Stel de waarde in op het pad naar uw Java-installatie, bijvoorbeeld: C:\Program Files\Java\jdk-21.
  • Voeg %JAVA_HOME%\bin toe aan je Path-variabele — klik gewoon op Bewerken, vervolgens op Nieuw en plak dat.

Dit helpt Windows om Cassandra te laten weten waar Java zich bevindt.In sommige configuraties is het instellen van JAVA_HOME alleen niet voldoende; je moet het ook toevoegen aan het Path.

Configureer CASSANDRA_HOME en PATH correct.

Vervolgens moet je Windows laten weten waar Cassandra zich bevindt. Hetzelfde principe: omgevingsvariabelen.

  • Maak een variabele CASSANDRA_HOME aan die verwijst naar uw Cassandra-map, bijvoorbeeld: C:\Cassandra\apache-cassandra-5.0.
  • Vergeet niet om %CASSANDRA_HOME%\bin toe te voegen aan het Path van je systeem, zodat je commando’s overal kunt uitvoeren. Dat scheelt enorm veel tijd.

Nadat je deze instellingen hebt aangepast, start je de opdrachtprompt of PowerShell opnieuw op om ervoor te zorgen dat de omgevingsvariabelen opnieuw worden geladen. Controleer met `npm run -l` echo %JAVA_HOME%en `npm echo %CASSANDRA_HOME%run run -l`.Als deze de juiste paden weergeven, ben je klaar.

Installeer Python voor CQLSH

Dit is voor veel mensen een struikelblok, vooral omdat de commandoregelinterface van Cassandra, CQLSH, vaak Python vereist. Zonder Python kun je foutmeldingen krijgen zoals ‘Python niet gevonden’ of weigert het programma gewoon te starten. Download Python van python.org, voer het installatieprogramma uit en zorg ervoor dat je “Python toevoegen aan PATH” aanvinkt.

Open de opdrachtregel en typ python --version. Het zou het versienummer moeten weergeven. Zo niet, probeer dan opnieuw te installeren — soms wordt het PATH niet correct bijgewerkt na een installatie.

Start Cassandra op de juiste manier

Zodra alle omgevingsvariabelen zijn ingesteld en Java en Python zijn geïnstalleerd, opent u de opdrachtprompt als beheerder. Navigeer naar de bin-directory, bijvoorbeeld:

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

En ren:

cassandra

Dit zal de server opstarten. Soms duurt het een minuut of twee voordat de server volledig is geladen en zullen de logbestanden voorbij scrollen — dat is normaal. Als er na een tijdje niets gebeurt, controleer dan de logbestanden in \logsde map voor aanwijzingen. Zorg ervoor dat de Windows Firewall de poorten (9042, 7000, 7199) niet blokkeert. Als u om toestemming wordt gevraagd, geef dan toegang.

CQLSH lanceren en verbinding maken

Nadat de server is opgestart, opent u een nieuwe opdrachtprompt, navigeert u opnieuw naar de map \binen typt u cqlsh. Als alles correct is ingesteld, ziet u een prompt zoals:

Connected to Test Cluster at 127.0.0.1:9042

Dit betekent dat Cassandra operationeel is. Nu kunt u beginnen met het aanmaken van keyspaces en tabellen, net zoals in de documentatie, bijvoorbeeld:

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

En dan:

USE testdb;

Als je verbindingsproblemen krijgt, controleer dan meestal de omgevingsinstellingen of ga na of er poortconflicten of firewallproblemen zijn. Soms helpt het om de computer opnieuw op te starten nadat je de omgevingsvariabelen hebt ingesteld, zodat alles weer wordt herkend.

Extra tips uit de praktijk:

  • Voer de opdrachtprompt uit als beheerder; soms heeft Cassandra hogere machtigingen nodig om poorten toe te wijzen.
  • Houd het bij eenvoudige paden, zoals C:\Cassandra— Windows kan problemen met paden veroorzaken als je te complexe, geneste mappen gebruikt.
  • Als het opstarten van Cassandra fouten geeft over de Java-versie of als Java niet gevonden wordt, controleer dan het pad in JAVA_HOME nogmaals.
  • Als CQLSH niet start, controleer dan of Python correct is geïnstalleerd en voeg het ook toe aan het PATH.

En eerlijk gezegd, bij sommige configuraties werkt het misschien niet meteen perfect. Mogelijk moet je de computer opnieuw opstarten of de omgevingsvariabelen controleren. Windows maakt het nu eenmaal graag ingewikkeld, maar als alles eenmaal goed is ingesteld, draait Cassandra vrij soepel.

Samenvatting

  • Zorg ervoor dat Java is geïnstalleerd en dat JAVA_HOME correct is ingesteld.
  • Voeg de Java- en Cassandra-binaries toe aan het PATH van uw systeem.
  • Zorg ervoor dat CASSANDRA_HOME verwijst naar de map waarin je je bestanden hebt uitgepakt.
  • Installeer Python als je CQLSH probleemloos wilt gebruiken.
  • Start Cassandra als beheerder via de opdrachtregel.
  • Start CQLSH vanuit een nieuw promptvenster om verbinding te maken met uw lokale cluster.

Samenvatting

Cassandra aan de praat krijgen op Windows 11 kan aanvoelen als een eindeloze zoektocht, maar zodra de omgevingsvariabelen zijn ingesteld en de server is opgestart, is het een heel ander verhaal. Volg deze stappen, houd de logbestanden in de gaten en wees geduldig tijdens het opstarten. Het is erg bevredigend om Cassandra op je Windows-computer te zien draaien, vooral omdat het meestal beter geschikt is voor Linux-omgevingen. Hopelijk bespaart dit iemand een hoop frustratie of urenlang zoeken naar de juiste instellingen. Let wel goed op de omgevingspaden – Windows is daar erg gevoelig voor.