Τρόπος λήψης και εγκατάστασης Cassandra on Windows

⚡ Έξυπνη Σύνοψη

Κατεβάστε και εγκαταστήστε Cassandra on Windows αποσυμπιέζοντας την επίσημη δυαδική διανομή Apache, καθώς το πρόγραμμα εγκατάστασης DataStax Community Edition που εμφανίζεται στα παλαιότερα στιγμιότυπα οθόνης αποσύρθηκε το 2017. Αυτή η σελίδα καλύπτει τις προϋποθέσεις, τόσο τις διαδρομές εγκατάστασης όσο και την επαλήθευση εκκίνησης.

  • ⚠️ Κατάσταση εγκαταστάτη: Το DataStax Community Edition MSI δεν διανέμεται πλέον, επομένως η τρέχουσα διαδρομή είναι το δυαδικό αρχείο Apache.
  • Java Απαιτείται: Πρέπει να εγκατασταθεί ένα υποστηριζόμενο JDK και να οριστεί το JAVA_HOME πριν Cassandra θα ξεκινήσει.
  • 🐍 Απαίτηση cqlsh: Το κέλυφος CQL είναι ένα Python σενάριο, άρα Python πρέπει να υπάρχει για την εκτέλεση ερωτημάτων από τη γραμμή εντολών.
  • 📂 Δυαδική εγκατάσταση: ExtracΗ εγκατάσταση ολοκληρώνεται με την εγκατάσταση του αρχείου και τη ρύθμιση του CASSANDRA_HOME. Δεν απαιτείται οδηγός εγκατάστασης.
  • 🐳 Επιλογή κοντέινερ: Μία μόνο εντολή Docker εκτελεί έναν λειτουργικό κόμβο και αποφεύγει Windows-εξ ολοκλήρου συγκεκριμένα ζητήματα.
  • Επαλήθευση: Η αναφορά κατάστασης του nodetool UN και μια προτροπή cqlsh για σύνδεση, επιβεβαιώνουν ότι ο κόμβος είναι υγιές.

Λήψη και εγκατάσταση Cassandra on Windows

Apache Cassandra Χρησιμοποιείται από μικρότερους οργανισμούς, ενώ το DataStax Enterprise χρησιμοποιείται από μεγαλύτερους οργανισμούς για την αποθήκευση τεράστιου όγκου δεδομένων.

Apache Cassandra διαχειρίζεται από το λογισμικό Apache Foundation.

Προϋπόθεση για Apache Cassandra Εγκατάσταση

Τρία στοιχεία πρέπει να είναι στη θέση τους πριν Cassandra θα ξεκινήσει στις Windows.

  • Apache Cassandra δυαδικά αρχεία. Μπορείς να κατεβάσετε Cassandra από την ιστοσελίδα του Apache. Πάρτε το δυαδικό αρχείο tarball για την τρέχουσα σταθερή έκδοση.
  • Ένα υποστηριζόμενο JDK. Java πρέπει να είναι εγκατεστημένο και η μεταβλητή περιβάλλοντος JAVA_HOME πρέπει να δείχνει στον φάκελο JDK. Cassandra Το 4.x εκτελείται Java 8 ή 11; Cassandra Το 5.x εκτελείται Java 11 ή 17.
  • Python. Ο client γραμμής εντολών cqlsh είναι ένας Python πρόγραμμα, άρα ένα Python 3 απαιτείται εγκατάσταση για να ανοίξει το κέλυφος CQL.

Ένα 64-bit Windows πλατφόρμα θεωρείται δεδομένη σε όλη την έκταση. Σημειώστε ότι Windows είναι μια ελαφρώς δοκιμασμένη πλατφόρμα για Cassandra, γι' αυτό και η διαδρομή μεταφοράς εμπορευματοκιβωτίων που περιγράφεται αργότερα είναι συχνά η πιο ομαλή επιλογή.

Τρόπος λήψης και εγκατάστασης Cassandra

Υπάρχουν δύο διαδρομές. Τα στιγμιότυπα οθόνης σε αυτήν την ενότητα προέρχονται από τον οδηγό DataStax Community Edition, τον οποίο περιγράφουν τα περισσότερα υπάρχοντα εκπαιδευτικά σεμινάρια. Αυτό το πρόγραμμα εγκατάστασης δεν δημοσιεύεται πλέον, επομένως η τρέχουσα δυαδική μέθοδος δίνεται πρώτη και ο οδηγός διατηρείται στη συνέχεια για τους αναγνώστες που εργάζονται με ένα αρχειοθετημένο αντίγραφο.

Μέθοδος 1: Εγκατάσταση από το δυαδικό αρχείο Apache (τρέχουσα μέθοδος)

Βήμα 1) Κατεβάστε το δυαδικό αρχείο tarball, για παράδειγμα apache-cassandra-xyz-bin.tar.gz, από τη σελίδα λήψης Apache που συνδέεται παραπάνω. Επαληθεύστε το αρχείο με το δημοσιευμένο άθροισμα ελέγχου στην ίδια σελίδα.

Βήμα 2) ExtracΜετακινήστε το αρχείο σε μια διαδρομή χωρίς κενά, όπως C:\cassandra. Τα κενά στη διαδρομή προκαλούν την αποτυχία των σεναρίων εκκίνησης.

Βήμα 3) Δημιουργήστε τις δύο μεταβλητές περιβάλλοντος Cassandra αναμένει και, στη συνέχεια, προσθέστε τον φάκελο bin στο PATH.

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

Βήμα 4) Ανοίξτε μια νέα γραμμή εντολών ώστε να τεθούν σε ισχύ οι μεταβλητές και, στη συνέχεια, ξεκινήστε τον κόμβο στο προσκήνιο.

cd C:\cassandra\bin
cassandra -f

Αφήστε αυτό το παράθυρο ανοιχτό. Το αρχείο καταγραφής εκκίνησης τελειώνει με μια γραμμή που δηλώνει ότι ο κόμβος ακούει για πελάτες CQL στη θύρα 9042.

Βήμα 5) Σε μια δεύτερη γραμμή εντολών, επιβεβαιώστε ότι ο κόμβος είναι ενεργός και, στη συνέχεια, ανοίξτε το κέλυφος.

nodetool status
cqlsh 127.0.0.1 9042

Μια γραμμή κατάστασης που ξεκινά με UN σημαίνει ότι ο κόμβος είναι ενεργός και κανονικός. Η προτροπή cqlsh επιβεβαιώνει ότι η εγκατάσταση έχει ολοκληρωθεί.

Μέθοδος 2: Οδηγός DataStax Community Edition (παλαιού τύπου)

Τα παρακάτω στιγμιότυπα οθόνης καταγράφουν το αποσυρμένο πρόγραμμα εγκατάστασης MSI. Παραμένουν χρήσιμα για τους αναγνώστες που κατέχουν ήδη ένα αντίγραφο και το κέλυφος που προκύπτει συμπεριφέρεται με τον ίδιο τρόπο.

Βήμα 1) Εκτελέστε την εγκατάσταση της έκδοσης κοινότητας DataStax. Μετά την εκτέλεση της εγκατάστασης, θα εμφανιστεί η ακόλουθη σελίδα. Εδώ στο στιγμιότυπο οθόνης εγκαθίσταται η έκδοση 64 bit. Μπορείτε επίσης να κατεβάσετε την έκδοση 32 bit ανάλογα με τις απαιτήσεις σας. Ωστόσο, συνιστάται η έκδοση 64 bit.

Λήψη και εγκατάσταση Cassandra

Αυτή η σελίδα σας παρέχει πληροφορίες σχετικά με το Cassandra έκδοση που πρόκειται να εγκαταστήσετε. Πατήστε το κουμπί «επόμενο».

Βήμα 2) Πατήστε το κουμπί «επόμενο». Αφού πατήσετε το κουμπί «επόμενο», θα εμφανιστεί η επόμενη σελίδα.

Λήψη και εγκατάσταση Cassandra

Αυτή η σελίδα αφορά τη συμφωνία άδειας χρήσης. Σημειώστε το πλαίσιο ελέγχου και πατήστε το κουμπί επόμενο.

Βήμα 3) Πατήστε το κουμπί «επόμενο». Θα εμφανιστεί η ακόλουθη σελίδα που θα σας ρωτάει για την τοποθεσία εγκατάστασης.

  1. Η προεπιλεγμένη τοποθεσία είναι C:\Program Files. Μπορείτε να αλλάξετε τη θέση εγκατάστασης εάν θέλετε να αλλάξετε. Συνιστάται να μην αλλάξετε θέση εγκατάστασης.
  2. Αφού ορίσετε τη θέση εγκατάστασης, πατήστε το κουμπί «επόμενο».

Λήψη και εγκατάσταση Cassandra

Βήμα 4) Αρχική Cassandra και OpsCenter. Αφού πατήσετε το κουμπί «επόμενο» στο παραπάνω βήμα, θα εμφανιστεί η ακόλουθη σελίδα. Αυτή η σελίδα σας ρωτάει αν θέλετε να ξεκινήσει αυτόματα Cassandra και OpsCenter.

  1. Σημειώστε τα πλαίσια ελέγχου εάν θέλετε να ξεκινήσει αυτόματα Cassandra και OpsCenter.
  2. Αφού δώσετε αυτές τις πληροφορίες, πατήστε το κουμπί «επόμενο».

Λήψη και εγκατάσταση Cassandra

Βήμα 5) Κάντε κλικ στο κουμπί εγκατάστασης. Το πρόγραμμα εγκατάστασης έχει συγκεντρώσει όλες τις απαραίτητες πληροφορίες και τώρα είναι έτοιμο για εγκατάσταση. Πατήστε το κουμπί εγκατάστασης.

Λήψη και εγκατάσταση Cassandra

Βήμα 6) Κάντε κλικ στο κουμπί Επόμενο. Αφού πατήσετε το κουμπί «εγκατάσταση», θα εμφανιστεί η ακόλουθη σελίδα.

Λήψη και εγκατάσταση Cassandra

Η έκδοση DataStax community εγκαθίσταται. Αφού ολοκληρωθεί η εγκατάσταση, κάντε κλικ στο κουμπί "Επόμενο". Όταν η εγκατάσταση ολοκληρωθεί με επιτυχία, πατήστε το κουμπί "Τέλος".

Λήψη και εγκατάσταση Cassandra

Μεταβείτε στα προγράμματα εκκίνησης των windows, αναζητήστε Cassandra CQL Shell και εκτελέστε το Cassandra Κέλυφος. Μετά το τρέξιμο Cassandra shell, θα δείτε την ακόλουθη γραμμή εντολών

Λήψη και εγκατάσταση Cassandra

Τώρα μπορείτε να δημιουργήσετε χώρο κλειδιών, πίνακες και να γράψετε ερωτήματα.

Τρέξιμο Cassandra στο Docker στο Windows

Και οι δύο παραπάνω μέθοδοι εκτελούνται Cassandra άμεσα Windows, η οποία είναι η λιγότερο δοκιμασμένη πλατφόρμα για το έργο. Ένα κοντέινερ αποφεύγει το Java προβλήματα διαδρομής, εγγραφής υπηρεσίας και δικαιωμάτων αρχείου που προκαλούν τα περισσότερα Windows αποτυχίες εγκατάστασης και στη συνέχεια αφαιρεί τον κόμβο καθαρά.

Με εγκατεστημένο το Docker Desktop, μία εντολή ξεκινά έναν λειτουργικό κόμβο.

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

Δώστε στον κόμβο περίπου ένα λεπτό για να εκκινήσει, στη συνέχεια ελέγξτε την κατάστασή του και ανοίξτε το κέλυφος μέσα στο κοντέινερ.

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

Τα δεδομένα που γράφονται με αυτόν τον τρόπο παραμένουν μέσα στο κοντέινερ και εξαφανίζονται όταν το κοντέινερ αφαιρεθεί. Για να τα διατηρήσετε, επισυνάψτε έναν τόμο στον κατάλογο δεδομένων:

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

Αυτή η διαδρομή είναι η πρακτική επιλογή για μάθηση και τοπική ανάπτυξη, επειδή ένας σπασμένος κόμβος απορρίπτεται και αναδημιουργείται σε δευτερόλεπτα.

Αντιμετώπιση προβλημάτων α Cassandra Εγκατάσταση στο Windows

Αποτυχίες εκκίνησης σε Windows εμπίπτουν σε έναν μικρό αριθμό επαναλαμβανόμενων αιτιών. Κάθε μία παράγει ένα ξεχωριστό μήνυμα στην κονσόλα.

Σύμπτωμα Αιτία και διόρθωση
«Το JAVA_HOME δεν έχει οριστεί» Η μεταβλητή λείπει ή δείχνει σε ένα JRE αντί για ένα JDK. Ορίστε την στον φάκελο JDK και ανοίξτε μια νέα γραμμή εντολών.
Η διεργασία τερματίζεται αμέσως χωρίς καταγραφή Η διαδρομή εγκατάστασης περιέχει ένα κενό. Μετακινήστε τον φάκελο σε μια διαδρομή όπως C:\cassandra.
«Δεν μπορώ να κουτσομπολέψω με συνομηλίκους μου» Μια προηγούμενη αποτυχημένη εκκίνηση άφησε παλιά δεδομένα. Διακόψτε τον κόμβο και διαγράψτε τους φακέλους δεδομένων και commitlog στον κατάλογο εγκατάστασης.
«Η διεύθυνση χρησιμοποιείται ήδη» Η θύρα 9042 ή 7000 καταλαμβάνεται από μια άλλη διεργασία, συχνά μια προηγούμενη Cassandra εκτελέστε. Κλείστε το ή αλλάξτε τις θύρες στο cassandra.yaml.
Το cqlsh αναφέρει «δεν υπάρχει ενότητα με όνομα cqlshlib» Python λείπει ή η λανθασμένη έκδοση είναι πρώτη στο PATH. Εγκατάσταση Python 3 και επιβεβαιώστε με python –version.

Μόλις ο κόμβος αναφέρει UN και το cqlsh συνδέεται, το επόμενο βήμα είναι η δημιουργία δομών αποθήκευσης, οι οποίες καλύπτονται στο Cassandra keyspace σεμινάριο, ακολουθούμενο από το Cassandra τραπέζι tutorial.

Συχνές Ερωτήσεις

Όχι. Η DataStax σταμάτησε να δημοσιεύει την Έκδοση Κοινότητας μετά το 2017 και το Windows Το MSI δεν είναι πλέον διαθέσιμο για λήψη. Χρησιμοποιήστε το δυαδικό αρχείο Apache ή μια εικόνα κοντέινερ.

Cassandra Υποστηρίζει το 4.x Java 8 και 11. Cassandra Υποστηρίζει το 5.x Java 11 και 17. Απαιτείται JDK αντί για JRE και το JAVA_HOME πρέπει να δείχνει προς αυτό.

Το πακέτο cassandra.bat δέχεται μια σημαία εγκατάστασης για την καταχώριση μιας υπηρεσίας, αλλά αυτή η διαδρομή υποβάλλεται σε ελάχιστες δοκιμές. Για οτιδήποτε πέρα ​​από τον πειραματισμό, εκτελέστε Cassandra σε Linux ή σε ένα κοντέινερ.

Επικόλληση της στοίβας system.log tracΗ σύνδεση σε έναν βοηθό τεχνητής νοημοσύνης συνήθως εντοπίζει την αιτία γρήγορα, επειδή τα σφάλματα εκκίνησης είναι καλά τεκμηριωμένα. Επαληθεύστε την προτεινόμενη επιδιόρθωση σε σχέση με το cassandra.yaml πριν την εφαρμόσετε.

Αντιμετωπίστε τα ως σημείο εκκίνησης. Το μέγεθος της στοίβας, οι ταυτόχρονες αναγνώσεις και η απόδοση συμπύκνωσης εξαρτώνται από το πραγματικό υλικό, επομένως κάθε τιμή που δημιουργείται θα πρέπει να δοκιμάζεται στον υπολογιστή-στόχο.

Συνοψίστε αυτήν την ανάρτηση με: