این مقاله مراحل نصب پایگاه داده Cassandra NoSQL را روی سرور ویندوزی توضیح میدهد که قرار است TestRail Server ۸ یا نسخههای جدیدتر را روی آن نصب کنید.
پیشنیازها #
برای نصب پایگاه داده Cassandra، باید چند مؤلفه مورد نیاز را نصب کنید:
۱. نصب 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 دانلود کنید.
نصبکننده را اجرا کنید و دستورالعملها را دنبال کنید.
بعد از کامل شدن نصب، مسیر Python را هم به PATH اضافه کنید. دوباره به بخش Environment Variables در صفحه بازشده، روی متغیر سیستمی PATH موجود دوبار کلیک کنید.
گزینه New و سپس Browse را انتخاب کنید و مسیر نصب Python را پیدا کنید. روی OK کلیک کنید تا کار تمام شود.
#
۳. درایور Cassandra برای TestRail #
فایلهای ‘php_cassandra.dll’ و ‘uv.dll’ را از اینجا دانلود کنید.
برای اجرای TestRail روی Windows دقیقاً به همین فایلها نیاز دارید. برای بررسی نسخه فعلی، دستور ‘php -v’ را در cmd اجرا کنید.
درایور ‘php_cassandra.dll’ را در دایرکتوری PHP خود کپی کنید (معمولاً C:\php\ext یا مسیری مشابه). سپس extension را با اضافه کردن خط زیر به فایل PHP.ini فعال کنید. فایل 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 نصب شده باشد (معمولاً :\Cassandra\apache-cassandra-۳.۱۱.۱۴\lib). اگر این فایل را ندارید، میتوانید فایل .jar را از مخزن رسمی Maven دانلود کنید. پیشنهاد میکنیم برای Cassandra ۳.۱۱.۱۴ از cassandra-lucene-index-plugin-۳.۱۱.۱.۰.jar استفاده کنید و سپس فایل را در همان دایرکتوری کپی کنید.
اکنون آمادهاید پایگاه داده Cassandra را برای اولین بار اجرا کنید. یک Windows Command Prompt باز کنید و دستور `cassandra` را وارد کنید.
بعد از اجرای Cassandra، یک Windows Command Prompt دیگر باز کنید و دستور زیر را وارد کنید:
cqlsh
باید خروجی زیر را ببینید:
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 باید یک Cassandra keyspace ایجاد کنید. برای این کار، query زیر را در CQL اجرا کنید:
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 و آنها را از حالت فشرده خارج کنید.
فایل اجرایی «prunsrv.exe» در دو نسخه مختلف برای معماریهای مختلف موجود است. نسخهای که در پوشه سطح اصلی قرار دارد، برای معماری ۳۲ بیتی (x86) است. پوشههای زیرمجموعه مربوط به سیستمهای ۶۴ بیتی AMD/EMT هستند. فایل مناسب «prunsrv.exe» را در پوشه تازه ایجادشده «\daemon» کپی کنید.
Command Prompt را اجرا کنید و به پوشه «cassandra\bin» بروید. برای ایجاد service، دستور «cassandra.bat -install» را وارد کنید.
این مورد را اجرا کنید: services.msc و service مربوط به Cassandra را بهصورت دستی start کنید. اگر service اجرا نشد، روی همان service راستکلیک کنید و روی Properties. در تب Log On، مقدار Log on as: را به «Local System account» تغییر دهید و روی OK. کلیک کنید. سپس service را start کنید.

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




