نصب پایگاه داده NoSQL Cassandra

در این مقاله، مراحل نصب پایگاه داده NoSQL Cassandra روی سرور Windows توضیح داده می‌شود؛ همان سروری که می‌خواهید TestRail Server ۷.۴ یا نسخه‌های جدیدتر را روی آن نصب کنید.

پیش‌نیازها

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

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

   توجه: درایور PHP Cassandra یک component متن‌باز است که DataStax آن را توسعه داده و تحت Apache License, Version ۲.۰ منتشر شده است. برای اطلاعات بیشتر، ببینید: https://github.com/datastax/php-driver

۱. نصب JDK ۸

installer را از لینک مناسب دانلود کنید: 

• https://openjdk.java.net/install/
• https://www.oracle.com/java/technologies/downloads/ 

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

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

openjdk version "1.8.0_312"
OpenJDK Runtime Environment (Temurin)(build 1.8.0_312-b07)
OpenJDK 64-Bit Server VM (Temurin)(build 25.312-b07, mixed mode)

سپس مسیر JDK ۸ را به Environment Variables سیستم اضافه کنید. 

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

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

نام متغیر را JAVA_HOME بگذارید و دایرکتوری محل نصب JDK را انتخاب کنید. این مسیر معمولاً به این شکل است: C:\\Program Files\\Java\\jdk1.۸.0_251

۲. نصب Python ۲.۷ 

installer مربوط به Python ۲.۷ را از طریق این لینک دانلود کنید:

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

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

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

 

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

درایور را دانلود کنید اینجا بر اساس نسخه PHP خود (TS یا NTS). می‌توانید نسخه نصب‌شده را با اجرای php -v در cmd بررسی کنید.

درایور را در پوشه ext مربوط به PHP کپی کنید (معمولاً C:\Program Files (x86)\PHPv7.۳\ext یا مسیری مشابه). سپس با افزودن خط زیر به فایل PHP.ini، extension را فعال کنید. فایل PHP.ini معمولاً در پوشه نصب PHP قرار دارد (مثلاً C:\Program Files (x86)\PHP7.۳ یا مسیری مشابه):

extension=php_cassandra.dll

نصب Cassandra

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

3. environment variableهای Cassandra را تنظیم کنید.

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

5. مسیر پوشه bin مربوط به Cassandra engine را به PATH اضافه کنید. روی system variable موجود با نام Path دوبار کلیک کنید.

6. گزینه New و سپس Browse  را برای انتخاب مسیر کامل پوشه bin داخل پوشه Apache Cassandra بزنید. برای مثال: C:\Cassandra\apache-cassandra-۳.۱۱.۱۱\bin. سپس روی OK  کلیک کنید تا کار تمام شود.

7. مطمئن شوید فایل cassandra-lucene-index-plugin-*.jar در پوشه lib داخل Cassandra Home قرار دارد (معمولاً \apache-cassandra-۳.۱۱.۱۱\lib). اگر این فایل را ندارید، می‌توانید فایل .jar را از repository رسمی 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.11 | CQL spec 3.4.4 | Native protocol v4]
 Use HELP for help.
 cqlsh>

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

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

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

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

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

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

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

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

با نام کاربری و رمز عبور پیش‌فرض به Cassandra وصل شوید:

cqlsh -u cassandra -p cassandra

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

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

همه دسترسی‌ها را به user مربوط به TestRail بدهید.

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

سپس می‌توانید از Cassandra خارج شوید.