این مقاله مراحل نصب پایگاه داده Cassandra NoSQL را روی سرور ویندوزی توضیح میدهد؛ سروری که قرار است TestRail Server ۸ یا نسخههای بالاتر را روی آن نصب کنید.
پیشنیازها #
برای نصب پایگاه داده Cassandra، باید چند component موردنیاز را نصب کنید:
۱. نصب JDK ۸ #
installer را از لینک مناسب دانلود کنید. بسیار مهم است که فقط از نسخه ۱.۸.0_202 استفاده کنید :
https://www.oracle.com/pl/java/technologies/javase/javase8-archive-downloads.html
بعد از نصب، برای بررسی نسخه Java نصبشده، دستور ‘java -version’ را در cmd وارد کنید.
اگر خروجی دستور ‘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 یک variable جدید بسازید.

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

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

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

۲. نصب Python ۲.۷ #
installer مربوط به Python ۲.۷ را از وبسایت رسمی Python دانلود کنید.
installer را اجرا کنید و مراحل نصب را طبق دستورالعملها ادامه دهید.
بعد از کامل شدن نصب، 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
#
در محتوای فایل INI، پیشوند ‘php_’ یا پسوند ‘.dll’ را وارد نکنید. درایور ‘uv.dll’ را در پوشه اصلی PHP کپی کنید (معمولاً C:\php یا مسیری مشابه)، اما لازم نیست ‘uv.dll’ را در فایل php.ini ثبت کنید.
Cassandra را نصب کنید #
#
در حال حاضر، Cassandra ۳.۱۱ تنها نسخه پشتیبانیشده Cassandra برای نصبهای Server است.
- Cassandra ۳.۱۱ را از مسیر زیر دانلود کنید: https://cassandra.apache.org/_/download.html
- فایل دانلودشده را در مسیر دلخواه خود extract کنید.
-
environment variableهای Cassandra را پیکربندی کنید.

-
یک system variable جدید با نام CASSANDRA_HOME ایجاد کنید و Variable Value را روی محل پوشه extractشده Apache Cassandra بگذارید. برای مثال: C:\Cassandra\apache-cassandra-۳.۱۱.۱۴

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

- مطمئن شوید فایل cassandra-lucene-index-plugin-*.jar در پوشه lib مربوط به Cassandra Home نصب شده باشد (معمولاً: C:\Cassandra\apache-cassandra-۳.۱۱.۱۴\lib). اگر این فایل را ندارید، میتوانید فایل .jar را از مخزن رسمی Maven دانلود کنید. پیشنهاد میکنیم برای Cassandra ۳.۱۱.۱۴ از cassandra-lucene-index-plugin-۳.۱۱.۱.۰.jar استفاده کنید و سپس فایل را در همان پوشه کپی کنید.
- فعالسازی Authentication و Authorization در Cassandra
- فایل پیکربندی Cassandra، یعنی cassandra.yaml، را باز کنید
- 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 ایجاد کنید. برای ایجاد آن، CQL query زیر را اجرا کنید:
CREATE KEYSPACE IF NOT EXISTS testrail WITH REPLICATION={'class': 'SimpleStrategy', 'replication_factor': 1};
در مرحله بعد، باید service مربوط به «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» در دو نسخه مختلف برای معماریهای مختلف ارائه شده است. نسخهای که در دایرکتوری سطح بالا قرار دارد، برای معماریهای ۳۲ بیتی (x86) است. دایرکتوریهای سطح پایینتر برای سیستمهای ۶۴ بیتی AMD/EMT هستند. فایل «prunsrv.exe» مناسب را در پوشه «\daemon» که تازه ایجاد کردهاید کپی کنید.
Command Prompt را باز کنید و به دایرکتوری «cassandra\bin» بروید. برای ایجاد service، دستور «cassandra.bat -install» را وارد کنید.
این دستور را اجرا کنید: services.msc و service مربوط به Cassandra را بهصورت دستی start کنید. اگر service شروع نشد، روی آن راستکلیک کنید و گزینه Properties را انتخاب کنید. در تب Log On، مقدار Log on as: را به «Local System account» تغییر دهید و روی OK کلیک کنید. سپس service را start کنید.

در این نصب Cassandra، نام کاربری «cassandra» و رمز عبور «cassandra» استفاده میشود. اگر نمیخواهید این credentials را تغییر دهید، service پایگاه داده Cassandra را restart کنید.
اگر میخواهید کاربر جدیدی ایجاد کنید، باید فایل 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 کنید.
با نام کاربری و رمز عبور پیشفرض به Cassandra وصل شوید:
cqlsh -u cassandra -p cassandra
سپس یک user و password مخصوص TestRail در Cassandra ایجاد کنید.
cassandra@cqlsh> create user 'username' with password 'password';
همه privileges را به user مربوط به TestRail بدهید.
cassandra@cqlsh> GRANT ALL ON KEYSPACE testrail to 'testrail';
بعد از آن میتوانید از Cassandra خارج شوید.




