این مقاله مراحل نصب پایگاه داده Cassandra NoSQL را روی سرور ویندوزی توضیح میدهد که قرار است TestRail Server ۸ یا نسخههای بالاتر را روی آن نصب کنید.
پیشنیازها #
برای نصب پایگاه داده Cassandra، باید چند کامپوننت موردنیاز را نصب کنید:
۱. نصب JDK ۸ #
Installer را از لینک مناسب دانلود کنید. بسیار مهم است که فقط از نسخه ۱.۸.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\bin است. آن را انتخاب کنید و روی 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 یا مسیری مشابه). سپس با اضافه کردن خط زیر به فایل PHP.ini، extension را فعال کنید. فایل 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 کنید.
- متغیرهای محیطی Cassandra را پیکربندی کنید.

- یک متغیر سیستمی جدید با نام 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 زیر را اجرا کنید:
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 و از حالت فشرده خارج کنید.
فایل اجرایی «prunsrv.exe» در دو نسخه مختلف برای معماریهای متفاوت ارائه شده است. نسخه موجود در دایرکتوری اصلی برای معماری ۳۲-bit (x86) است. دایرکتوریهای سطح پایینتر برای سیستمهای AMD/EMT ۶۴-bit هستند. فایل «prunsrv.exe» مناسب را در پوشه «\daemon» که تازه ایجاد کردهاید کپی کنید.
Command Prompt را اجرا کنید و به دایرکتوری «cassandra\bin» بروید. سرویس را با وارد کردن دستور «cassandra.bat -install» ایجاد کنید.
دستور زیر را اجرا کنید: services.msc و سرویس Cassandra را بهصورت دستی start کنید. اگر سرویس start نشد، روی سرویس راستکلیک کنید و گزینه Properties را انتخاب کنید. در تب Log On، مقدار Log on as: را به «Local System account» تغییر دهید و روی OK کلیک کنید. سپس سرویس را start کنید.

در این نصب Cassandra، مقدار «cassandra» بهعنوان نام کاربری و «cassandra» بهعنوان password استفاده میشود. اگر نمیخواهید این credentials را تغییر دهید، سرویس پایگاه داده Cassandra را restart کنید.
اگر میخواهید کاربر جدیدی ایجاد کنید، باید فایل cassandra.yaml را که داخل پوشه conf قرار دارد ویرایش کنید (معمولاً C:\Cassandra\apache-cassandra-۳.۱۱.۱۴\conf).
سپس فایل را ویرایش کنید و مقدارهای مربوط به 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
سپس برای TestRail در Cassandra یک user و password ایجاد کنید.
cassandra@cqlsh> create user 'username' with password 'password';
همه privileges را به user مربوط به TestRail بدهید.
cassandra@cqlsh> GRANT ALL ON KEYSPACE testrail to 'testrail';
سپس میتوانید از Cassandra خارج شوید.




