این مقاله مراحل نصب پایگاه داده NoSQL Cassandra را روی یک سرور ویندوزی توضیح میدهد؛ برای زمانی که میخواهید TestRail Server ۸ یا نسخههای بعدی را نصب کنید.
پیشنیازها #
برای نصب پایگاه داده Cassandra، باید چند مؤلفه موردنیاز را نصب کنید:
۱. نصب JDK ۸ #
فایل نصب را از لینک مناسب دانلود کنید. حتماً فقط از نسخه ۱.۸.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 ۸ را به System 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 ۲.۷ #
فایل نصب Python ۲.۷ را از وبسایت رسمی Python دانلود کنید.
فایل نصب را اجرا کنید و دستورالعملها را دنبال کنید.
پس از پایان نصب، مسیر Python را هم به PATH اضافه کنید. دوباره به بخش Environment Variables در صفحه بازشده، روی متغیر سیستمی موجود با نام PATH دوبار کلیک کنید.
گزینه New را انتخاب کنید و سپس Browse را برای مسیر نصب Python انتخاب کنید. روی OK کلیک کنید تا کار تمام شود.
#
۳. درایور Cassandra برای TestRail #
فایلهای ‘php_cassandra.dll’ و ‘uv.dll’ را از اینجا دانلود کنید.
برای اجرای TestRail روی ویندوز، دقیقاً به همین فایلها نیاز دارید. برای بررسی نسخه PHP نصبشده، دستور ‘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’ را در پوشه root مربوط به PHP کپی کنید (معمولاً C:\php یا مسیری مشابه)، اما لازم نیست ‘uv.dll’ را در فایل php.ini ثبت کنید.
نصب Cassandra #
#
در حال حاضر، Cassandra ۳.۱۱ تنها نسخه Cassandra است که برای نصبهای Server پشتیبانی میشود.
- Cassandra ۳.۱۱ را از لینک زیر دانلود کنید: https://cassandra.apache.org/_/download.html
- فایل دانلودشده را در مسیر دلخواه خود از حالت فشرده خارج کنید.
- متغیرهای محیطی Cassandra را پیکربندی کنید.

- یک متغیر سیستمی جدید با نام CASSANDRA_HOME بسازید و مقدار Variable Value را روی مسیر پوشه 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};
در مرحله بعد باید service مربوط به cassandra را ایجاد کنید. داخل directory کاساندرا، در مسیر \bin، یک زیرپوشه به نام \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 اصلی برای معماری ۳۲ بیتی (x86) است. directoryهای سطح پایینتر برای سیستمهای ۶۴ بیتی AMD/EMT هستند. فایل prunsrv.exe مناسب را در پوشه \daemon که تازه ساختهاید کپی کنید.
Command Prompt را باز کنید و مسیر فعلی را به directory cassandra\bin تغییر دهید. سپس با وارد کردن cassandra.bat -install، service را ایجاد کنید.
دستور زیر را اجرا کنید: 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 است، ویرایش کنید.
سپس فایل را ویرایش کنید و مقدارهای 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 یک user و password ایجاد کنید.
cassandra@cqlsh> create user 'username' with password 'password';
همه privileges را به user مربوط به TestRail بدهید.
cassandra@cqlsh> GRANT ALL ON KEYSPACE testrail to 'testrail';
بعد از آن میتوانید از Cassandra خارج شوید.




