نصب پایگاه داده NoSQL Cassandra روی ویندوز – نسخه ۸.۰.۴.۷۰۳۶

این مقاله روند نصب پایگاه داده Cassandra NoSQL را روی سرور ویندوزی توضیح می‌دهد که قرار است TestRail Server ۸ یا نسخه‌های جدیدتر را روی آن نصب کنید.

پیش‌نیازها

برای نصب پایگاه داده Cassandra، باید چند مؤلفه مورد نیاز را نصب کنید:

1. Oracle JDK 8
2. Python 2.7
3. درایور Cassandra برای TestRail

۱. نصب JDK ۸

نصب‌کننده را از لینک مناسب دانلود کنید. بسیار مهم است که فقط از نسخه ۱.۸.0_202 استفاده کنید : 

https://www.oracle.com/pl/java/technologies/javase/javase8-archive-downloads.html

پس از نصب، با وارد کردن دستور ‘java -version’ در cmd، نسخه Java نصب‌شده را بررسی کنید.

اگر خروجی دستور ‘java -version’ چیزی شبیه نمونه زیر باشد، یعنی JDK با موفقیت نصب شده است:

java version "1.8.0_202"
Java(TM) SE Runtime Environment (build 1.8.0_202-b08)
Java HotSpot(TM) 64-Bit Server VM (build 25.202-b08, mixed mode)

در مرحله بعد، مسیر JDK ۸ را به Environment Variables سیستم اضافه کنید. 

به Advanced system settings بروید و گزینه Environment Variables را انتخاب کنید.

 

در بخش System variables یک متغیر جدید ایجاد کنید.

 

نام متغیر را (JAVA_HOME) وارد کنید و دایرکتوری محل نصب JDK را انتخاب کنید. این مسیر معمولاً C:\\Program Files\\Java\\jdk1.۸.0_202 است، سپس روی OK کلیک کنید.

 

سپس در بخش System Variables، متغیر Path را انتخاب کنید و روی Edit کلیک کنید.

 

روی New کلیک کنید تا دایرکتوری ‘\bin’ مربوط به محل نصب JDK را به متغیر System PATH اضافه کنید. این مسیر معمولاً C:\Program Files\Java\jdk1.۸.0_202 است. آن را انتخاب کنید و روی OK کلیک کنید.

 

۲. نصب Python ۲.۷ 

نصب‌کننده Python ۲.۷ را از وب‌سایت رسمی Python دانلود کنید.

نصب‌کننده را اجرا کنید و دستورالعمل‌ها را دنبال کنید. 

پس از کامل شدن نصب، PATH را برای Python هم به‌روزرسانی کنید. دوباره به بخش Environment Variables در صفحه بازشده، روی متغیر سیستم PATH موجود دوبار کلیک کنید.

گزینه New  و سپس Browse  را برای انتخاب مسیر نصب Python بزنید. روی OK کلیک کنید تا کار تمام شود.

 

۳. درایور Cassandra برای TestRail 

فایل‌های ‘php_cassandra.dll’ و ‘uv.dll’ را از اینجا دانلود کنید.
برای اجرای TestRail در ویندوز، دقیقاً به همین فایل‌ها نیاز دارید. برای بررسی نسخه نصب‌شده، دستور ‘php -v’ را در cmd اجرا کنید.

درایور ‘php_cassandra.dll’ را در دایرکتوری PHP کپی کنید (معمولاً C:\php\ext یا مسیری مشابه). سپس extension را با اضافه کردن خط زیر به فایل PHP.ini فعال کنید. فایل PHP.ini را می‌توانید در دایرکتوری نصب PHP پیدا کنید (معمولاً C:\php\ext یا مسیری مشابه).

extension=cassandra.dll

Cassandra را نصب کنید

1. Cassandra ۳.۱۱ را از آدرس زیر دانلود کنید https://cassandra.apache.org/_/download.html
2. فایل دانلودشده را در مسیر دلخواه خود extract کنید. 
3. متغیرهای محیطی Cassandra را تنظیم کنید.

   

4. یک متغیر سیستم جدید با نام CASSANDRA_HOME بسازید و مقدار Variable Value را روی محل پوشه extract شده Apache Cassandra قرار دهید. برای مثال: C:\Cassandra\apache-cassandra-۳.۱۱.۱۴

   

5. برای پوشه bin موتور Cassandra، مقدار PATH را گسترش دهید. روی متغیر سیستم PATH موجود دوبار کلیک کنید.
6. روی New کلیک کنید و دایرکتوری ‘\bin’ مربوط به نصب Cassandra را به متغیر System PATH اضافه کنید. برای مثال: C:\Cassandra\apache-cassandra-۳.۱۱.۱۴\bin. سپس روی OK کلیک کنید تا کار تمام شود.

   

7. مطمئن شوید فایل cassandra-lucene-index-plugin-*.jar در دایرکتوری lib داخل Cassandra Home نصب شده باشد (معمولاً: C:\Cassandra\apache-cassandra-۳.۱۱.۱۴\lib). اگر این فایل را ندارید، می‌توانید فایل .jar را از مخزن رسمی Maven دانلود کنید. پیشنهاد می‌کنیم برای Cassandra ۳.۱۱.۱۴ از cassandra-lucene-index-plugin-۳.۱۱.۱.۰.jar استفاده کنید و سپس فایل را در همان دایرکتوری کپی کنید.
8. فعال کردن Authentication و Authorization در Cassandra
   1. فایل پیکربندی Cassandra با نام cassandra.yaml را باز کنید
   2. AllowAllAuthenticator را با PasswordAuthenticator و AllowAllAuthorizer را با CassandraAuthorizer جایگزین کنید

اکنون آماده‌اید که پایگاه داده Cassandra را برای اولین بار اجرا کنید. یک Windows Command Prompt باز کنید و دستور `cassandra` را وارد کنید.

بعد از اجرای Cassandra، یک Windows Command Prompt دیگر باز کنید و دستور زیر را وارد کنید:

cqlsh <host> -u <user> -p <password>

باید خروجی زیر را ببینید:

Connected to Test Cluster at 127.0.0.1:9042.
[cqlsh 5.0.1 | Cassandra 3.11.14 | CQL spec 3.4.4 | Native protocol v4]
 Use HELP for help.
 cqlsh>

برای نصب TestRail باید یک keyspace در Cassandra بسازید. برای این کار، query زیر را در CQL اجرا کنید:

CREATE KEYSPACE IF NOT EXISTS testrail WITH REPLICATION={'class': 'SimpleStrategy', 'replication_factor': 1};

در مرحله بعد باید سرویس «cassandra» را ایجاد کنید. داخل دایرکتوری «\bin» مربوط به Cassandra، یک زیردایرکتوری با نام «\daemon» بسازید (معمولاً C:\Cassandra\apache-cassandra-۳.۱۱.۱۴\bin\).

فایل‌ها را از آدرس زیر دانلود کنید: https://archive.apache.org/dist/commons/daemon/binaries/windows/commons-daemon-1.3.3-bin-windows.zip سپس آن‌ها را extract کنید.

فایل اجرایی «prunsrv.exe» در ۲ نسخه برای architectureهای مختلف ارائه شده است. نسخه‌ای که در دایرکتوری اصلی قرار دارد برای architectureهای ۳۲-bit (x86) است. دایرکتوری‌های سطح پایین‌تر برای سیستم‌های AMD/EMT ۶۴-bit هستند. فایل «prunsrv.exe» مناسب را در پوشه «\daemon» که تازه ساخته‌اید کپی کنید.

Command Prompt را اجرا کنید و به دایرکتوری «cassandra\bin» بروید. برای ایجاد service، دستور «cassandra.bat -install» را وارد کنید.

دستور زیر را اجرا کنید: services.msc و سرویس cassandra را به‌صورت دستی start کنید. اگر service شروع نشد، روی آن راست‌کلیک کنید و روی Properties کلیک کنید. در تب Log On، مقدار Log on as: را به «Local System account» تغییر دهید و روی OK کلیک کنید. سپس service را start کنید.

در این نصب Cassandra، نام کاربری «cassandra» و password نیز «cassandra» است. اگر نمی‌خواهید این credentials را تغییر دهید، سرویس دیتابیس Cassandra را restart کنید. 

اگر می‌خواهید یک user جدید بسازید، باید فایل cassandra.yaml را که داخل پوشه conf قرار دارد ویرایش کنید (معمولاً C:\Cassandra\apache-cassandra-۳.۱۱.۱۴\conf).

سپس فایل را ویرایش کنید و directiveهای authenticator و authorizer را تغییر دهید. خط authenticator: AllowAllAuthenticator را comment کنید و خط زیر را اضافه کنید تا به این شکل شود:

#authenticator: AllowAllAuthenticator
authenticator: org.apache.cassandra.auth.PasswordAuthenticator

در مرحله بعد، خط authorizer: AllowAllAuthorizer را comment کنید و خط زیر را اضافه کنید تا به این شکل شود:

#authorizer: AllowAllAuthorizer
authorizer: org.apache.cassandra.auth.CassandraAuthorizer

در پایان، Cassandra را restart کنید.

با username و password پیش‌فرض به Cassandra وصل شوید:

cqlsh -u cassandra -p cassandra

سپس یک user و password مخصوص Cassandra برای TestRail بسازید.

cassandra@cqlsh> create user 'username' with password 'password';

همه privilegeها را به user مربوط به TestRail بدهید.

cassandra@cqlsh> GRANT ALL ON KEYSPACE testrail to 'testrail';

بعد از آن می‌توانید از Cassandra خارج شوید.