วิธีดาวน์โหลดและติดตั้ง Cassandra on Windows

⚡ สรุปอย่างชาญฉลาด

ดาวน์โหลดและติดตั้ง Cassandra on Windows โดยการแตกไฟล์ไบนารีเวอร์ชันอย่างเป็นทางการของ Apache เนื่องจากตัวติดตั้ง DataStax Community Edition ที่แสดงในภาพหน้าจอเก่าถูกยกเลิกไปตั้งแต่ปี 2017 หน้านี้ครอบคลุมข้อกำหนดเบื้องต้น เส้นทางการติดตั้งทั้งสองแบบ และการตรวจสอบการเริ่มต้นระบบ

  • ⚠️ สถานะการติดตั้ง: ไฟล์ MSI ของ DataStax Community Edition ไม่ได้ถูกแจกจ่ายอีกต่อไปแล้ว ดังนั้นวิธีการปัจจุบันคือการดาวน์โหลดไฟล์ไบนารีของ Apache แทน
  • Java ต้องการ: ต้องติดตั้ง JDK ที่รองรับและตั้งค่า JAVA_HOME ก่อนจึงจะทำได้ Cassandra จะเริ่ม.
  • 🐍 ข้อกำหนด cqlsh: เชลล์ CQL คือ Python สคริปต์ ดังนั้น Python ต้องมีข้อมูลนี้เพื่อเรียกใช้คำสั่งค้นหาจากบรรทัดคำสั่ง
  • 📂 การติดตั้งแบบไบนารี: Extracการดาวน์โหลดไฟล์เก็บถาวรและการตั้งค่า CASSANDRA_HOME จะทำให้การติดตั้งเสร็จสมบูรณ์ ไม่จำเป็นต้องใช้ตัวช่วยติดตั้งใดๆ
  • 🐳 ตัวเลือกคอนเทนเนอร์: คำสั่ง Docker เพียงคำสั่งเดียวก็สามารถเรียกใช้งานโหนดที่ใช้งานได้ และหลีกเลี่ยงปัญหาต่างๆ Windows-ประเด็นเฉพาะเจาะจงโดยสิ้นเชิง
  • การตรวจสอบ: คำสั่ง `nodetool status reporting UN` และ `cqlsh prompt connecting` ยืนยันว่าโหนดอยู่ในสถานะปกติ

ดาวน์โหลดและติดตั้ง Cassandra on Windows

อาปาเช่ Cassandra DataStax เหมาะสำหรับองค์กรขนาดเล็ก ในขณะที่ DataStax Enterprise เหมาะสำหรับองค์กรขนาดใหญ่ที่ต้องการจัดเก็บข้อมูลจำนวนมหาศาล

Apache Cassandra บริหารจัดการโดย Apache Software Foundation.

ข้อกำหนดเบื้องต้นสำหรับ Apache Cassandra การติดตั้ง

ต้องมีองค์ประกอบสามอย่างครบถ้วนก่อน Cassandra จะเริ่ม Windows.

  • Apache Cassandra ไบนารี คุณสามารถ ดาวน์โหลด Cassandra จากเว็บไซต์ของ Apache ดาวน์โหลดไฟล์ไบนารีแบบ tarball สำหรับเวอร์ชันเสถียรล่าสุด
  • JDK ที่รองรับ Java ต้องติดตั้ง JDK และตัวแปรสภาพแวดล้อม JAVA_HOME ต้องชี้ไปยังโฟลเดอร์ JDK Cassandra 4.x ทำงานบน Java 8 หรือ 11; Cassandra 5.x ทำงานบน Java 11 หรือ 17
  • Python. ไคลเอนต์บรรทัดคำสั่ง cqlsh คือ Python โปรแกรม ดังนั้น Python จำเป็นต้องติดตั้งโปรแกรม 3 ตัวเพื่อเปิดใช้งาน CQL shell

64 บิต Windows ถือว่าแพลตฟอร์มนี้เป็นที่ยอมรับโดยทั่วไป โปรดทราบว่า Windows เป็นแพลตฟอร์มที่ผ่านการทดสอบเพียงเล็กน้อยสำหรับ Cassandraซึ่งเป็นเหตุผลว่าทำไมเส้นทางการขนส่งด้วยตู้คอนเทนเนอร์ที่อธิบายไว้ในภายหลังจึงมักเป็นตัวเลือกที่ราบรื่นกว่า

วิธีดาวน์โหลดและติดตั้ง Cassandra

มีสองวิธีในการติดตั้ง ภาพหน้าจอในส่วนนี้มาจากตัวช่วยติดตั้ง DataStax Community Edition ซึ่งเป็นวิธีที่บทช่วยสอนส่วนใหญ่กล่าวถึง ตัวติดตั้งนั้นไม่ได้เผยแพร่อีกต่อไปแล้ว ดังนั้นจึงแสดงวิธีการติดตั้งแบบไบนารีในปัจจุบันก่อน และจะยังคงแสดงตัวช่วยติดตั้งไว้สำหรับผู้อ่านที่ใช้งานเวอร์ชันที่เก็บไว้ในคลังข้อมูล

วิธีที่ 1: ติดตั้งจากไฟล์ไบนารีของ Apache (วิธีปัจจุบัน)

ขั้นตอน 1) ดาวน์โหลดไฟล์ไบนารีแบบ tarball เช่น apache-cassandra-xyz-bin.tar.gz จากหน้าดาวน์โหลดของ Apache ที่ลิงก์ไว้ด้านบน ตรวจสอบความถูกต้องของไฟล์โดยเทียบกับค่า checksum ที่แสดงอยู่ในหน้าเดียวกัน

ขั้นตอน 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) เปิดหน้าต่าง Command Prompt ใหม่เพื่อให้ตัวแปรมีผล จากนั้นเริ่มใช้งาน Node.js ในโหมดทำงานเบื้องหน้า

cd C:\cassandra\bin
cassandra -f

ปล่อยหน้าต่างนั้นเปิดทิ้งไว้ บันทึกการเริ่มต้นระบบจะจบลงด้วยบรรทัดที่ระบุว่าโหนดกำลังรอรับการเชื่อมต่อจากไคลเอ็นต์ CQL บนพอร์ต 9042

ขั้นตอน 5) ในหน้าต่าง Command Prompt อีกหน้าต่างหนึ่ง ให้ตรวจสอบว่าโหนดทำงานอยู่หรือไม่ จากนั้นเปิด Shell ขึ้นมา

nodetool status
cqlsh 127.0.0.1 9042

บรรทัดสถานะที่เริ่มต้นด้วย UN หมายความว่าโหนดทำงานและอยู่ในสถานะปกติ ข้อความแจ้งเตือน cqlsh ยืนยันว่าการติดตั้งเสร็จสมบูรณ์แล้ว

วิธีที่ 2: ตัวช่วยสร้าง DataStax Community Edition (แบบเดิม)

ภาพหน้าจอข้างล่างนี้แสดงรายละเอียดของโปรแกรมติดตั้ง MSI เวอร์ชันเก่าที่เลิกใช้งานแล้ว ภาพเหล่านี้ยังคงมีประโยชน์สำหรับผู้อ่านที่ยังมีโปรแกรมนี้อยู่ และหน้าต่างแสดงผลที่ได้ก็ทำงานเหมือนกันทุกประการ

ขั้นตอน 1) เรียกใช้โปรแกรมติดตั้ง DataStax รุ่น Community Edition หลังจากเรียกใช้โปรแกรมติดตั้งแล้ว หน้าจอต่อไปนี้จะปรากฏขึ้น ในภาพหน้าจอนี้แสดงการติดตั้งเวอร์ชัน 64 บิต คุณสามารถดาวน์โหลดเวอร์ชัน 32 บิตได้ตามความต้องการ แต่ขอแนะนำให้ใช้เวอร์ชัน 64 บิต

ดาวน์โหลดและติดตั้ง Cassandra

หน้านี้ให้ข้อมูลเกี่ยวกับ Cassandra เวอร์ชันที่คุณจะติดตั้ง กดปุ่ม 'ถัดไป'

ขั้นตอน 2) กดปุ่ม 'ถัดไป' หลังจากกดปุ่ม 'ถัดไป' แล้ว หน้าถัดไปจะปรากฏขึ้น

ดาวน์โหลดและติดตั้ง Cassandra

หน้านี้เป็นเรื่องของข้อตกลงอนุญาตสิทธิ์ ทำเครื่องหมายที่ช่องกาเครื่องหมายแล้วกดปุ่มถัดไป

ขั้นตอน 3) กดปุ่ม 'ถัดไป' หน้าถัดไปจะปรากฏขึ้นและถามเกี่ยวกับตำแหน่งที่จะติดตั้ง

  1. ตำแหน่งเริ่มต้นคือ C:\Program Files คุณสามารถเปลี่ยนตำแหน่งการติดตั้งได้หากต้องการเปลี่ยน แนะนำว่าอย่าเปลี่ยนตำแหน่งการติดตั้ง
  2. หลังจากตั้งค่าตำแหน่งการติดตั้งแล้ว ให้กดปุ่ม 'ถัดไป'

ดาวน์โหลดและติดตั้ง Cassandra

ขั้นตอน 4) เริ่มต้น Cassandra และ OpsCenter หลังจากกดปุ่ม 'ถัดไป' ในขั้นตอนข้างต้น หน้าต่อไปนี้จะปรากฏขึ้น หน้านี้จะถามว่าคุณต้องการเริ่มต้นโดยอัตโนมัติหรือไม่ Cassandra และ Ops Center

  1. ทำเครื่องหมายที่ช่องกาเครื่องหมายหากคุณต้องการเริ่มโดยอัตโนมัติ Cassandra และ Ops Center
  2. หลังจากให้ข้อมูลนี้แล้ว ให้กดปุ่ม 'ถัดไป'

ดาวน์โหลดและติดตั้ง Cassandra

ขั้นตอน 5) คลิกที่ปุ่มติดตั้ง โปรแกรมติดตั้งได้รวบรวมข้อมูลที่จำเป็นทั้งหมดแล้ว และพร้อมสำหรับการติดตั้ง กดปุ่มติดตั้งอีกครั้ง

ดาวน์โหลดและติดตั้ง Cassandra

ขั้นตอน 6) คลิกที่ ถัดไป หลังจากกดปุ่ม 'ติดตั้ง' หน้าต่อไปนี้จะปรากฏขึ้น

ดาวน์โหลดและติดตั้ง Cassandra

กำลังติดตั้ง DataStax รุ่น Community Edition เมื่อการติดตั้งเสร็จสมบูรณ์ ให้คลิกปุ่มถัดไป เมื่อการติดตั้งเสร็จสมบูรณ์แล้ว ให้กดปุ่ม 'เสร็จสิ้น'

ดาวน์โหลดและติดตั้ง Cassandra

ไปที่โปรแกรมเริ่มต้นของ Windows ค้นหา Cassandra CQL Shell และเรียกใช้ Cassandra เปลือก. หลังจากวิ่งแล้ว Cassandra เชลล์ คุณจะเห็นบรรทัดคำสั่งดังต่อไปนี้

ดาวน์โหลดและติดตั้ง 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 แล้วเปิดหน้าต่าง Command Prompt ใหม่
กระบวนการจะหยุดทำงานทันทีโดยไม่มีการบันทึกข้อมูลใดๆ เส้นทางการติดตั้งมีช่องว่างอยู่ โปรดย้ายโฟลเดอร์ไปยังเส้นทางอื่น เช่น C:\cassandra
“ไม่สามารถนินทากับเพื่อนร่วมงานได้” การเริ่มต้นที่ไม่สำเร็จก่อนหน้านี้ทำให้มีข้อมูลค้างอยู่ หยุดโหนดและล้างโฟลเดอร์ข้อมูลและโฟลเดอร์บันทึกการเปลี่ยนแปลงภายใต้ไดเร็กทอรีการติดตั้ง
“ที่อยู่ดังกล่าวมีผู้ใช้งานอยู่แล้ว” พอร์ต 9042 หรือ 7000 ถูกใช้งานโดยกระบวนการอื่นอยู่แล้ว ซึ่งมักจะเป็นกระบวนการก่อนหน้า Cassandra เรียกใช้งาน ปิดโปรแกรม หรือเปลี่ยนพอร์ตในไฟล์ cassandra.yaml
cqlsh รายงานว่า “ไม่มีโมดูลชื่อ cqlshlib” Python ไม่พบเวอร์ชันที่ถูกต้อง หรือเวอร์ชันแรกใน PATH ไม่ถูกต้อง โปรดติดตั้ง Python 3. และตรวจสอบด้วยคำสั่ง python –version

เมื่อโหนดรายงาน UN และ cqlsh เชื่อมต่อแล้ว ขั้นตอนต่อไปคือการสร้างโครงสร้างจัดเก็บข้อมูล ซึ่งจะกล่าวถึงในหัวข้อถัดไป Cassandra คีย์สเปซ กวดวิชาตามด้วย Cassandra ตาราง เกี่ยวกับการสอน

คำถามที่พบบ่อย

ไม่ DataStax หยุดเผยแพร่ Community Edition หลังจากปี 2017 แล้ว Windows ไฟล์ MSI ไม่สามารถดาวน์โหลดได้อีกต่อไปแล้ว โปรดใช้ไฟล์เก็บถาวรไบนารีของ Apache หรืออิมเมจคอนเทนเนอร์แทน

Cassandra 4.x รองรับ Java 8 และ 11 Cassandra 5.x รองรับ Java 11 และ 17. จำเป็นต้องใช้ JDK แทน JRE และ JAVA_HOME ต้องชี้ไปยัง JDK นั้น

ไฟล์ cassandra.bat ที่มาพร้อมกับแพ็กเกจนั้นรองรับแฟล็กการติดตั้งเพื่อลงทะเบียนบริการ แต่เส้นทางนี้ไม่ค่อยได้รับการทดสอบมากนัก สำหรับการใช้งานที่มากกว่าการทดลอง ให้ใช้คำสั่งต่อไปนี้ Cassandra บนระบบ Linux หรือในคอนเทนเนอร์

วางข้อความแสดงข้อผิดพลาดของไฟล์ system.log tracการป้อนคำสั่งลงในผู้ช่วย AI มักจะระบุสาเหตุได้อย่างรวดเร็ว เนื่องจากข้อผิดพลาดในการเริ่มต้นระบบมีการบันทึกไว้อย่างละเอียด ตรวจสอบวิธีแก้ไขที่แนะนำกับไฟล์ cassandra.yaml ก่อนนำไปใช้

ให้ถือว่าค่าเหล่านั้นเป็นเพียงจุดเริ่มต้น การกำหนดขนาดฮีป การอ่านพร้อมกัน และปริมาณงานการบีบอัดข้อมูลขึ้นอยู่กับฮาร์ดแวร์จริง ดังนั้นค่าที่ได้แต่ละค่าควรได้รับการทดสอบบนเครื่องเป้าหมาย

สรุปโพสต์นี้ด้วย: