این مقاله مراحل نصب پایگاه داده Cassandra NoSQL را روی یک Windows server توضیح میدهد؛ سروری که قرار است TestRail Server ۸ یا نسخههای بعدی روی آن نصب شود.
پیشنیازها #
برای نصب پایگاه داده Cassandra، باید چند component مورد نیاز را نصب کنید:
۱. نصب 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 یک variable جدید بسازید.

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

در این نصب Cassandra، مقدار username برابر «cassandra» و مقدار password هم برابر «cassandra» است. اگر نمیخواهید این credentials را تغییر دهید، service پایگاه داده Cassandra را restart کنید.
اگر میخواهید user جدیدی ایجاد کنید، باید فایل cassandra.yaml را که داخل folder به نام 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
سپس برای 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 خارج شوید.




