كيفية التنزيل والتثبيت Cassandra on Windows

⚡ ملخص ذكي

تحميل وتثبيت Cassandra on Windows عن طريق فك ضغط توزيعة Apache الثنائية الرسمية، حيث تم إيقاف برنامج تثبيت DataStax Community Edition الموضح في لقطات الشاشة القديمة في عام 2017. تغطي هذه الصفحة المتطلبات الأساسية، وطرق التثبيت، والتحقق من بدء التشغيل.

  • ⚠️ حالة المُثبِّت: لم يعد يتم توزيع إصدار DataStax Community Edition MSI، لذا فإن المسار الحالي هو أرشيف Apache الثنائي.
  • ☕ Java المتطلبات: يجب تثبيت JDK مدعوم وتعيين JAVA_HOME قبل Cassandra ستبدأ.
  • 🐍 متطلبات cqlsh: CQL shell هو Python نص برمجي، لذلك Python يجب أن يكون موجودًا لتشغيل الاستعلامات من سطر الأوامر.
  • 📂 تثبيت الملفات الثنائية: Extracيؤدي تثبيت الأرشيف وتعيين CASSANDRA_HOME إلى إكمال عملية التثبيت؛ ولا يتطلب الأمر معالج إعداد.
  • 🐳 خيار الحاوية: يُشغّل أمر Docker واحد عقدة عاملة ويتجنب Windowsقضايا محددة تماماً.
  • ✅ التحقق: يؤكد الأمر nodetool status reporting UN، و cqlsh prompt connecting، أن العقدة سليمة.

  Cassandra on Windows

Apache Cassandra يستخدم من قبل المؤسسات الصغيرة بينما يستخدم DataStax Enterprise من قبل المؤسسات الكبيرة لتخزين كميات هائلة من البيانات.

Apache Cassandra تتم إدارتها بواسطة شركة أباتشي للبرمجيات Foundation.

شرط مسبق ل Apache Cassandra التركيب

يجب أن تكون ثلاثة عناصر جاهزة قبل Cassandra سوف تبدأ في Windows.

  • Apache Cassandra ثنائيات. يمكنك بإمكانك تحميله Cassandra من موقع أباتشي الإلكتروني. قم بتنزيل ملف tarball الثنائي للإصدار المستقر الحالي.
  • JDK مدعوم. Java يجب تثبيته، ويجب أن يشير متغير بيئة JAVA_HOME إلى مجلد JDK. Cassandra يعمل الإصدار 4.x على Java 8 أو 11 ؛ Cassandra يعمل الإصدار 5.x على Java 11 أو 17.
  • Python. عميل سطر الأوامر cqlsh هو Python برنامج، لذلك Python يلزم تثبيت 3 لفتح واجهة سطر الأوامر CQL.

64 بت Windows يُفترض استخدام المنصة طوال الوقت. لاحظ أن Windows هي منصة تم اختبارها بشكل طفيف لـ Cassandraولهذا السبب فإن مسار الحاويات الموصوف لاحقًا غالبًا ما يكون الخيار الأكثر سلاسة.

كيفية تنزيل وتثبيت Cassandra

هناك طريقتان. لقطات الشاشة في هذا القسم مأخوذة من معالج DataStax Community Edition، وهو الطريقة التي تشرحها معظم الدروس التعليمية المتوفرة. لم يعد هذا المثبّت متاحًا، لذا تُعرض طريقة التثبيت الثنائية الحالية أولًا، ثم يُحتفظ بالمعالج لاحقًا للقراء الذين يعملون بنسخة مؤرشفة.

الطريقة الأولى: التثبيت من أرشيف Apache الثنائي (الطريقة الحالية)

الخطوة 1) قم بتنزيل الملف المضغوط الثنائي، على سبيل المثال 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 اكتمال التثبيت.

الطريقة الثانية: معالج DataStax Community Edition (القديم)

تُظهر لقطات الشاشة أدناه برنامج التثبيت MSI القديم. وهي لا تزال مفيدة للقراء الذين يمتلكون نسخة منه بالفعل، وتعمل واجهة المستخدم الناتجة بنفس الطريقة.

الخطوة 1) قم بتشغيل برنامج تثبيت DataStax Community Edition. بعد تشغيل البرنامج، ستظهر لك الصفحة التالية. في لقطة الشاشة، يتم تثبيت إصدار 64 بت. يمكنك أيضًا تنزيل إصدار 32 بت حسب احتياجاتك، ولكن يُنصح باستخدام إصدار 64 بت.

  Cassandra

توفر لك هذه الصفحة معلومات حول Cassandra الإصدار الذي ستقوم بتثبيته. اضغط على الزر "التالي".

الخطوة 2) اضغط على زر "التالي". بعد الضغط على زر "التالي"، ستظهر الصفحة التالية.

  Cassandra

تتناول هذه الصفحة اتفاقية الترخيص. حدد مربع الاختيار واضغط على الزر التالي.

الخطوة 3) اضغط على زر "التالي". ستظهر الصفحة التالية التي تطلب منك تحديد موقع التثبيت.

  1. الموقع الافتراضي هو ملفات C:\Program. يمكنك تغيير موقع التثبيت إذا كنت تريد التغيير. يوصى بعدم تغيير موقع التثبيت.
  2. بعد تحديد موقع التثبيت، اضغط على زر "التالي".

  Cassandra

الخطوة 4) بالبداية Cassandra ومركز العمليات. بعد الضغط على زر "التالي" في الخطوة السابقة، ستظهر الصفحة التالية. تسألك هذه الصفحة عما إذا كنت ترغب في بدء التشغيل تلقائيًا Cassandra و أوبس سنتر.

  1. قم بتحديد مربعات الاختيار إذا كنت تريد البدء تلقائيًا Cassandra و أوبس سنتر.
  2. بعد تقديم هذه المعلومات، اضغط على زر "التالي".

  Cassandra

الخطوة 5) انقر على زر التثبيت. جمع برنامج التثبيت جميع المعلومات اللازمة، وهو الآن جاهز للتثبيت. اضغط على زر التثبيت.

  Cassandra

الخطوة 6) انقر على التالي. بعد الضغط على زر "تثبيت"، ستظهر الصفحة التالية.

  Cassandra

يجري تثبيت إصدار DataStax المجاني. بعد اكتمال التثبيت، انقر على زر "التالي". عند اكتمال التثبيت بنجاح، اضغط على زر "إنهاء".

  Cassandra

انتقل إلى برامج ابدأ في Windows، وابحث Cassandra CQL شل وقم بتشغيل 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.
"غير قادر على التحدث مع أي من أقرانه" تسبب فشل بدء التشغيل السابق في ترك بيانات قديمة. أوقف تشغيل العقدة وامسح مجلدي البيانات وسجل الالتزام الموجودين ضمن دليل التثبيت.
"العنوان قيد الاستخدام بالفعل" يتم استخدام المنفذ 9042 أو 7000 بواسطة عملية أخرى، وغالبًا ما تكون عملية سابقة. Cassandra قم بتشغيله. أغلقه أو غيّر المنافذ في ملف cassandra.yaml.
يُبلغ cqlsh عن "عدم وجود وحدة باسم cqlshlib" Python الملف مفقود أو الإصدار الخاطئ موجود أولاً في مسار النظام. قم بالتثبيت 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 إليه.

يقبل ملف cassandra.bat المرفق علامة تثبيت لتسجيل خدمة، ولكن هذا المسار لم يخضع لاختبارات كافية. لأي شيء يتجاوز التجربة، قم بتشغيل Cassandra على نظام لينكس أو في حاوية.

لصق سجل النظام (system.log) tracعادةً ما يُحدد مساعد الذكاء الاصطناعي السبب بسرعة، لأن أخطاء بدء التشغيل موثقة جيدًا. تحقق من الإصلاح المقترح في ملف cassandra.yaml قبل تطبيقه.

اعتبرها نقطة انطلاق. يعتمد حجم الذاكرة المخصصة، والقراءات المتزامنة، وإنتاجية الضغط على الأجهزة الفعلية، لذلك يجب اختبار كل قيمة مُولَّدة على الجهاز المستهدف.

تلخيص هذه التدوينة بـ: