Cách tải xuống và cài đặt Cassandra on Windows

⚡ Tóm tắt thông minh

Tải về và cài đặt Cassandra on Windows Bằng cách giải nén bản phân phối nhị phân chính thức của Apache, vì trình cài đặt DataStax Community Edition được hiển thị trong các ảnh chụp màn hình cũ đã bị ngừng hỗ trợ vào năm 2017. Trang này bao gồm các điều kiện tiên quyết, cả hai phương pháp cài đặt và xác minh khi khởi động.

  • ⚠️ Trạng thái cài đặt: Phiên bản MSI của DataStax Community Edition hiện không còn được phân phối nữa, vì vậy phương án hiện tại là sử dụng kho lưu trữ nhị phân của Apache.
  • Java Yêu cầu: Cần phải cài đặt JDK được hỗ trợ và thiết lập biến môi trường JAVA_HOME trước khi thực hiện. Cassandra sẽ bắt đầu.
  • 🐍 Yêu cầu cqlsh: CQL shell là một Python kịch bản, vậy nên Python Phải có mặt để chạy các truy vấn từ dòng lệnh.
  • 📂 Cài đặt nhị phân: ExtracViệc sao chép kho lưu trữ và thiết lập biến môi trường CASSANDRA_HOME sẽ hoàn tất quá trình cài đặt; không cần sử dụng trình hướng dẫn thiết lập.
  • 🐳 Tùy chọn container: Một lệnh Docker duy nhất chạy một node hoạt động và tránh được... Windows- Các vấn đề hoàn toàn cụ thể.
  • Xác minh: Lệnh nodetool status báo cáo trạng thái UN và lời nhắc cqlsh đang kết nối, xác nhận rằng nút đang hoạt động bình thường.

Tải về và cài đặt Cassandra on Windows

Apache Cassandra DataStax Enterprise được sử dụng bởi các tổ chức nhỏ hơn, trong khi DataStax Enterprise được các tổ chức lớn hơn sử dụng để lưu trữ lượng dữ liệu khổng lồ.

Apache Cassandra được quản lý bởi phần mềm Apache. Foundation.

Điều kiện tiên quyết cho Apache Cassandra Thi công

Ba điều kiện phải được đáp ứng trước khi Cassandra sẽ bắt đầu vào Windows.

  • Apache Cassandra nhị phân. Bạn có thể tải về Cassandra Tải từ trang web của Apache. Lấy file nén nhị phân (binary tarball) của phiên bản ổn định hiện tại.
  • Một JDK được hỗ trợ. Java JDK phải được cài đặt và biến môi trường JAVA_HOME phải trỏ đến thư mục chứa JDK. Cassandra 4.x chạy trên Java 8 hoặc 11; Cassandra 5.x chạy trên Java 11 hoặc 17.
  • Python. Công cụ dòng lệnh cqlsh là một Python chương trình, vì vậy Python Cần cài đặt bước 3 để mở trình shell CQL.

Một 64-bit Windows Nền tảng được giả định xuyên suốt. Lưu ý rằng Windows là một nền tảng được thử nghiệm sơ bộ cho CassandraĐó là lý do tại sao tuyến đường vận chuyển container được mô tả sau đây thường là lựa chọn thuận lợi hơn.

Cách tải xuống và cài đặt Cassandra

Có hai cách thực hiện. Các ảnh chụp màn hình trong phần này được lấy từ trình hướng dẫn của DataStax Community Edition, đây là cách mà hầu hết các hướng dẫn hiện có mô tả. Trình cài đặt đó hiện không còn được phát hành nữa, vì vậy phương pháp sử dụng tệp nhị phân hiện tại được trình bày trước và trình hướng dẫn được giữ lại sau đó cho những người đọc đang làm việc với bản sao lưu trữ.

Phương pháp 1: Cài đặt từ kho lưu trữ nhị phân Apache (phương pháp hiện tại)

Bước 1) Tải xuống tệp nén nhị phân, ví dụ: apache-cassandra-xyz-bin.tar.gz, từ trang tải xuống của Apache được liên kết ở trên. Kiểm tra tính hợp lệ của tệp bằng cách so sánh với mã kiểm tra (checksum) được công bố trên cùng trang đó.

Bước 2) ExtracHãy đặt đường dẫn lưu trữ vào một đường dẫn không có khoảng trắng, ví dụ như C:\cassandra. Khoảng trắng trong đường dẫn sẽ khiến các tập lệnh khởi động bị lỗi.

Bước 3) Tạo hai biến môi trường Cassandra Nếu bạn mong đợi điều đó, hãy thêm thư mục bin vào PATH.

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

Bước 4) Mở một cửa sổ dòng lệnh mới để các biến có hiệu lực, sau đó khởi chạy node ở chế độ nền trước.

cd C:\cassandra\bin
cassandra -f

Hãy để cửa sổ đó mở. Nhật ký khởi động kết thúc bằng một dòng cho biết nút đang lắng nghe các máy khách CQL trên cổng 9042.

Bước 5) Trong cửa sổ dòng lệnh thứ hai, xác nhận rằng nút đã hoạt động rồi mở shell.

nodetool status
cqlsh 127.0.0.1 9042

Dòng trạng thái bắt đầu bằng UN Điều này có nghĩa là nút mạng đang hoạt động bình thường. Dấu nhắc cqlsh xác nhận quá trình cài đặt đã hoàn tất.

Phương pháp 2: Trình hướng dẫn DataStax Community Edition (phiên bản cũ)

Các ảnh chụp màn hình bên dưới minh họa cho trình cài đặt MSI đã ngừng hoạt động. Chúng vẫn hữu ích cho những người đọc đã có sẵn bản sao và giao diện dòng lệnh sau khi cài đặt hoạt động hoàn toàn giống nhau.

Bước 1) Chạy chương trình cài đặt DataStax Community Edition. Sau khi chạy chương trình cài đặt, trang sau sẽ hiển thị. Trong ảnh chụp màn hình này, phiên bản 64 bit đang được cài đặt. Bạn cũng có thể tải xuống phiên bản 32 bit nếu cần. Tuy nhiên, phiên bản 64 bit được khuyến nghị.

Tải về và cài đặt Cassandra

Trang này cung cấp cho bạn thông tin về Cassandra phiên bản bạn định cài đặt. Nhấn nút 'tiếp theo'.

Bước 2) Nhấn nút 'tiếp theo'. Sau khi nhấn nút 'tiếp theo', trang tiếp theo sẽ được hiển thị.

Tải về và cài đặt Cassandra

Trang này nói về thỏa thuận cấp phép. Đánh dấu vào ô kiểm và nhấn nút tiếp theo.

Bước 3) Nhấn nút 'tiếp theo'. Trang tiếp theo sẽ hiển thị và yêu cầu bạn nhập vị trí cài đặt.

  1. Vị trí mặc định là C:\Program Files. Bạn có thể thay đổi vị trí cài đặt nếu muốn thay đổi. Khuyến cáo không nên thay đổi vị trí lắp đặt.
  2. Sau khi thiết lập vị trí cài đặt, nhấn nút 'tiếp theo'

Tải về và cài đặt Cassandra

Bước 4) Bắt đầu Cassandra và OpsCenter. Sau khi nhấn nút 'tiếp theo' ở bước trên, trang sau sẽ hiển thị. Trang này hỏi bạn có muốn tự động khởi động hay không. Cassandra và OpsCenter.

  1. Đánh dấu vào hộp kiểm nếu bạn muốn tự động bắt đầu Cassandra và OpsCenter.
  2. Sau khi cung cấp thông tin này, hãy nhấn nút 'tiếp theo'.

Tải về và cài đặt Cassandra

Bước 5) Nhấp vào nút cài đặt. Trình cài đặt đã thu thập tất cả thông tin cần thiết và giờ đã sẵn sàng để cài đặt. Nhấn nút cài đặt.

Tải về và cài đặt Cassandra

Bước 6) Nhấp vào Tiếp theo. Sau khi nhấn nút 'cài đặt', trang sau sẽ hiển thị.

Tải về và cài đặt Cassandra

Phiên bản cộng đồng DataStax đang được cài đặt. Sau khi quá trình cài đặt hoàn tất, hãy nhấp vào nút Tiếp theo. Khi quá trình cài đặt thành công, hãy nhấn nút 'Hoàn tất'.

Tải về và cài đặt Cassandra

Vào chương trình bắt đầu của windows, tìm kiếm Cassandra CQL Shell và chạy Cassandra Vỏ bọc. Sau khi chạy Cassandra shell, bạn sẽ thấy dòng lệnh sau

Tải về và cài đặt Cassandra

Bây giờ bạn có thể tạo không gian phím, bảng và viết truy vấn.

Chạy Cassandra trong Docker trên Windows

Cả hai phương pháp trên đều chạy Cassandra trực tiếp trên Windows, đây là nền tảng ít được kiểm thử nhất cho dự án. Container giúp tránh được... Java Các vấn đề về đường dẫn, đăng ký dịch vụ và quyền truy cập tệp là nguyên nhân gây ra hầu hết các sự cố. Windows Nếu quá trình cài đặt thất bại, nó sẽ gỡ bỏ nút đó một cách sạch sẽ sau đó.

Sau khi cài đặt Docker Desktop, chỉ cần một lệnh là có thể khởi động một node duy nhất hoạt động.

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

Hãy đợi khoảng một phút để node khởi động, sau đó kiểm tra trạng thái của nó và mở shell bên trong container.

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

Dữ liệu được ghi theo cách này sẽ nằm bên trong vùng chứa và biến mất khi vùng chứa bị xóa. Để giữ lại dữ liệu, hãy gắn một volume vào thư mục dữ liệu:

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

Tuyến đường này là lựa chọn thiết thực cho việc học tập và phát triển địa phương, bởi vì một nút bị lỗi sẽ được loại bỏ và tạo lại trong vài giây.

Khắc phục sự cố Cassandra Cài đặt trên Windows

Thất bại của các công ty khởi nghiệp Windows Chúng rơi vào một số ít nguyên nhân lặp đi lặp lại. Mỗi nguyên nhân tạo ra một thông báo riêng biệt trong bảng điều khiển.

Triệu chứng Nguyên nhân và cách khắc phục
Biến môi trường JAVA_HOME chưa được thiết lập. Biến này bị thiếu hoặc trỏ đến JRE thay vì JDK. Hãy đặt nó thành thư mục JDK và mở một cửa sổ dòng lệnh mới.
Tiến trình kết thúc ngay lập tức mà không lưu nhật ký. Đường dẫn cài đặt có chứa dấu cách. Hãy di chuyển thư mục đến một đường dẫn khác, ví dụ như C:\cassandra.
“Không thể buôn chuyện với bất kỳ người cùng trang lứa nào” Lần khởi động không thành công trước đó đã để lại dữ liệu lỗi thời. Hãy dừng node và xóa các thư mục data và commitlog trong thư mục cài đặt.
“Địa chỉ này đã được sử dụng” Cổng 9042 hoặc 7000 đang được một tiến trình khác sử dụng, thường là tiến trình trước đó. Cassandra Chạy. Hãy đóng nó hoặc thay đổi cổng trong cassandra.yaml.
cqlsh báo lỗi “không tìm thấy mô-đun có tên cqlshlib” Python bị thiếu hoặc phiên bản sai nằm ở vị trí đầu tiên trong PATH. Cài đặt Python 3 và xác nhận bằng lệnh `python –version`.

Sau khi nút báo cáo UN và cqlsh kết nối, bước tiếp theo là tạo cấu trúc lưu trữ, được đề cập trong phần tiếp theo. Cassandra không gian phím hướng dẫn, tiếp theo là Cassandra bàn hướng dẫn.

Câu Hỏi Thường Gặp

Không. DataStax đã ngừng phát hành Community Edition sau năm 2017, và... Windows Tệp MSI hiện không còn tải xuống được nữa. Thay vào đó, hãy sử dụng tệp lưu trữ nhị phân Apache hoặc ảnh container.

Cassandra 4.x hỗ trợ Java 8 và 11. Cassandra 5.x hỗ trợ Java 11 và 17. Cần có JDK thay vì JRE, và biến môi trường JAVA_HOME phải trỏ đến nó.

Tệp cassandra.bat đi kèm chấp nhận một cờ cài đặt để đăng ký dịch vụ, nhưng phương pháp này ít được kiểm tra. Để thực hiện bất kỳ thao tác nào ngoài việc thử nghiệm, hãy chạy lệnh sau: Cassandra trên Linux hoặc trong container.

Dán nội dung ngăn xếp của tệp system.log. tracViệc chuyển thông tin lỗi sang trợ lý AI thường giúp xác định nguyên nhân nhanh chóng, vì các lỗi khởi động thường được ghi chép đầy đủ. Hãy kiểm tra lại giải pháp được đề xuất so với tệp cassandra.yaml trước khi áp dụng.

Hãy coi chúng như điểm khởi đầu. Kích thước heap, số lần đọc đồng thời và thông lượng nén phụ thuộc vào phần cứng thực tế, vì vậy mọi giá trị được tạo ra đều cần được kiểm tra trên máy mục tiêu.

Tóm tắt bài viết này với: