این مقاله مراحل نصب پایگاه داده Cassandra NoSQL را روی یک سرور ویندوز توضیح می‌دهد؛ همان سروری که می‌خواهید 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، variable با نام Path را انتخاب کنید و روی Edit کلیک کنید.
روی New کلیک کنید تا directory مربوط به ‘\bin’ در محل نصب JDK را به variable سیستم PATH اضافه کنید. این مسیر معمولاً C:\Program Files\Java\jdk1.۸.0_202 است. آن را انتخاب کنید و روی OK کلیک کنید.
۲. نصب Python ۲.۷
installer مربوط به Python ۲.۷ را از وب‌سایت رسمی Python دانلود کنید.
installer را اجرا کنید و دستورالعمل‌ها را دنبال کنید.
پس از کامل شدن نصب، PATH را برای Python هم به‌روزرسانی کنید. دوباره به بخش Environment Variables در صفحه بازشده، روی متغیر سیستم PATH موجود دوبار کلیک کنید.
گزینه New و سپس Browse را انتخاب کنید و مسیر نصب Python را پیدا کنید. روی OK کلیک کنید تا کار تمام شود.
۳. درایور Cassandra برای TestRail
فایل‌های ‘php_cassandra.dll’ و ‘uv.dll’ را از اینجا دانلود کنید.
برای اجرای TestRail روی Windows دقیقاً به همین فایل‌ها نیاز دارید. می‌توانید نسخه PHP نصب‌شده را با اجرای دستور ‘php -v’ در cmd بررسی کنید.
درایور ‘php_cassandra.dll’ را در پوشه extensionهای 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 را روی محل پوشه Apache Cassandra که از حالت فشرده خارج کرده‌اید قرار دهید. برای مثال: C:\Cassandra\apache-cassandra-۳.۱۱.۱۴
- مسیر PATH را با اضافه کردن پوشه bin موتور Cassandra گسترش دهید. روی متغیر سیستم 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://downloads.apache.org/commons/daemon/binaries/windows/commons-daemon-1.3.3-bin-windows.zip و آن‌ها را extract کنید.
فایل اجرایی «prunsrv.exe» برای معماری‌های مختلف در ۲ نسخه ارائه شده است. نسخه‌ای که در دایرکتوری اصلی قرار دارد برای معماری ۳۲ بیتی (x86) است. دایرکتوری‌های سطح پایین‌تر برای سیستم‌های ۶۴ بیتی AMD/EMT هستند. فایل «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» استفاده می‌شود. اگر نمی‌خواهید این credentials را تغییر دهید، سرویس پایگاه داده Cassandra را restart کنید.
اگر می‌خواهید کاربر جدیدی ایجاد کنید، باید فایل cassandra.yaml را که داخل پوشه 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 خارج شوید.