در این مقاله، مراحل نصب پایگاه داده NoSQL Cassandra روی سرور Windows توضیح داده میشود؛ همان سروری که میخواهید TestRail Server ۷.۴ یا نسخههای جدیدتر را روی آن نصب کنید.
پیشنیازها #
برای نصب پایگاه داده Cassandra، باید چند مؤلفه موردنیاز را نصب کنید:
- Oracle JDK 8
- Python 2.7
-
درایور Cassandra برای TestRail
توجه: درایور PHP Cassandra یک component متنباز است که DataStax آن را توسعه داده و تحت Apache License, Version ۲.۰ منتشر شده است. برای اطلاعات بیشتر، ببینید: https://github.com/datastax/php-driver
۱. نصب JDK ۸ #
installer را از لینک مناسب دانلود کنید:
پس از نصب، با وارد کردن دستور java -version در cmd، نسخه Java نصبشده را بررسی کنید.
اگر خروجی java -version چیزی شبیه نمونه زیر باشد، یعنی JDK با موفقیت نصب شده است:
openjdk version "1.8.0_312"
OpenJDK Runtime Environment (Temurin)(build 1.8.0_312-b07)
OpenJDK 64-Bit Server VM (Temurin)(build 25.312-b07, mixed mode)
سپس مسیر JDK ۸ را به Environment Variables سیستم اضافه کنید.
به بخش Advanced system settings بروید و گزینه Environment Variables را انتخاب کنید.
در بخش System variables یک متغیر جدید ایجاد کنید.
نام متغیر را JAVA_HOME بگذارید و دایرکتوری محل نصب JDK را انتخاب کنید. این مسیر معمولاً به این شکل است: C:\\Program Files\\Java\\jdk1.۸.0_251
۲. نصب Python ۲.۷ #
installer مربوط به Python ۲.۷ را از طریق این لینک دانلود کنید:
installer را اجرا کنید و دستورالعملها را دنبال کنید.
بعد از کامل شدن نصب، مسیر Python را هم به PATH اضافه کنید. دوباره به صفحه Environment Variables بروید و روی متغیر سیستمی Path موجود دوبار کلیک کنید.
گزینه New و سپس Browse را انتخاب کنید و مسیر نصب Python را مشخص کنید. روی OK کلیک کنید تا کار تمام شود.
#
۳. درایور Cassandra برای TestRail #
درایور را دانلود کنید اینجا بر اساس نسخه PHP خود (TS یا NTS). میتوانید نسخه نصبشده را با اجرای php -v در cmd بررسی کنید.
درایور را در پوشه ext مربوط به PHP کپی کنید (معمولاً C:\Program Files (x86)\PHPv7.۳\ext یا مسیری مشابه). سپس با افزودن خط زیر به فایل PHP.ini، extension را فعال کنید. فایل PHP.ini معمولاً در پوشه نصب PHP قرار دارد (مثلاً C:\Program Files (x86)\PHP7.۳ یا مسیری مشابه):
extension=php_cassandra.dll
نصب Cassandra #
در حال حاضر، فقط Cassandra ۳.۱۱ برای نصبهای Server پشتیبانی میشود.
- Cassandra ۳.۱۱ را از این آدرس دانلود کنید: https://cassandra.apache.org/_/download.html
- فایل دانلودشده را در مسیر دلخواه خود از حالت فشرده خارج کنید.
-
environment variableهای Cassandra را تنظیم کنید.
-
یک system variable جدید با نام CASSANDRA_HOME بسازید و فیلد Variable Value را روی مسیر پوشه Apache Cassandra که از حالت فشرده خارج کردهاید قرار دهید. برای مثال: C:\Cassandra\apache-cassandra-۳.۱۱.۱۱
- مسیر پوشه bin مربوط به Cassandra engine را به PATH اضافه کنید. روی system variable موجود با نام Path دوبار کلیک کنید.
-
گزینه New و سپس Browse را برای انتخاب مسیر کامل پوشه bin داخل پوشه Apache Cassandra بزنید. برای مثال: C:\Cassandra\apache-cassandra-۳.۱۱.۱۱\bin. سپس روی OK کلیک کنید تا کار تمام شود.
- مطمئن شوید فایل cassandra-lucene-index-plugin-*.jar در پوشه lib داخل Cassandra Home قرار دارد (معمولاً \apache-cassandra-۳.۱۱.۱۱\lib). اگر این فایل را ندارید، میتوانید فایل .jar را از repository رسمی 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.11 | 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};
در این نصب Cassandra، نام کاربری cassandra و رمز عبور cassandra است. اگر میخواهید user جدیدی بسازید، باید فایل cassandra.yaml را که داخل پوشه conf قرار دارد (معمولاً \apache-cassandra-۳.۱۱.۱۱\conf) ویرایش کنید.
سپس فایل را ویرایش کنید و directiveهای authenticator و authorizer را تغییر دهید. خط authenticator: AllowAllAuthenticator را کامنت کنید و خط زیر را اضافه کنید تا به این شکل شود:
#authenticator: AllowAllAuthenticator
authenticator: org.apache.cassandra.auth.PasswordAuthenticator
بعد، خط authorizer: AllowAllAuthorizer را کامنت کنید و خط زیر را اضافه کنید تا به این شکل شود:
#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';
همه دسترسیها را به user مربوط به TestRail بدهید.
cassandra@cqlsh> GRANT ALL ON KEYSPACE testrail to 'testrail';
سپس میتوانید از Cassandra خارج شوید.

