برای نصب برنامه TestRail روی سرور Unix، فایل آرشیو نصب TestRail را روی وبسرور آپلود و extract کنید، سپس فایلها را در دایرکتوری www وبسرور کپی کنید؛ برای مثال در Ubuntu مسیر آن معمولاً /var/www/html/testrail است.
-
فایل .htaccess را در دایرکتوری ریشه TestRail ایجاد یا بهروزرسانی کنید و محتوای زیر را در آن قرار دهید:
<FilesMatch "\.(sql|ini)$">
Require all denied
</FilesMatch> -
اگر در مرحله قبل یک فایل .htaccess جدید ایجاد کردهاید، مطمئن شوید permission آن درست است؛ معمولاً ۶۴۴:
chmod 644 /var/www/testrail/.htaccess
بعضی از سیستمهای Unix بهصورت پیشفرض از دستور unzip پشتیبانی نمیکنند؛ بنابراین ممکن است لازم باشد ابتدا آن را نصب کنید. مثال زیر برای Ubuntu/Debian است:
$ sudo apt-get install unzip
سپس برای اجرای TestRail Installation Wizard، آدرس دایرکتوری جدید TestRail روی وبسرور را در مرورگر باز کنید؛ برای مثال http://<server>/testrail/) و دستورالعملها را دنبال کنید:
-
برای ادامه، شرایط license را بررسی و قبول کنید
-
تنظیمات دیتابیس
در این راهنما فرض شده است از مقادیر زیر استفاده میکنید:
- Driver: driver مناسب MySQL را برای دیتابیس خود انتخاب کنید. در این سند، گزینه «MySQL (۵.x and higher)» را از Driver منوی کشویی انتخاب میکنیم
- Server: localhost (hostname)
- Database: testRail (نام دیتابیسی که در MySQL ایجاد کردیم)
- User: testrail
- Password: (پسوردی که هنگام ایجاد Login با نام «testrail» استفاده کردید)
-
تنظیمات Cassandra
نصاب از شما میخواهد اطلاعات Cassandra را وارد کنید. این اطلاعات به مقادیری بستگی دارد که هنگام نصب ارائه کردهاید.
مقادیر پیشفرض عبارتاند از:
- Server: localhost
- Port: 9042
- Keyspace: testrail یا نامی که هنگام ایجاد Keyspace وارد کردهاید
- Username: cassandra یا کاربری که برای TestRail ایجاد کرده و به آن permission دادهاید
- Password: cassandra یا پسوردی که برای کاربر ایجادشده تعیین کردهاید
-
تنظیمات RabbitMQ
#برای سیستمعامل خود، به مستندات رسمی نصب RabbitMQ در آدرس زیر مراجعه کنید:
استفاده از RabbitMQ اختیاری است. اگر میخواهید از بعضی از قابلیتهای Webhooks ، باید RabbitMQ را پیکربندی کنید.
از آنجا که هیچکدام از این فیلدها برای ادامه نصب الزامی نیستند، در صورت تمایل میتوانید به مرحله بعد بروید.
مقادیر پیشفرضی که در این مستندات استفاده شدهاند به این شکل هستند:
- سرور Message Queue: نام host سرور RabbitMQ
- پورت Message Queue: پورت RabbitMQ (بهصورت پیشفرض ۵۶۷۲)
- کاربر Message Queue: کاربر RabbitMQ برای TestRail. این کاربر باید مجوز مدیریت queueها، از جمله ایجاد و حذف آنها، را داشته باشد.
- رمز عبور Message Queue: رمز عبور کاربر RabbitMQ مربوط به TestRail که در بالا مشخص شده است
- استفاده از TLS: [فعال/غیرفعال]
- گواهی CA برای Message Queue: گواهی CA برای اتصال به سرور RabbitMQ در صورت استفاده از TLS
- گواهی client برای Message Queue: گواهی client برای اتصال به سرور RabbitMQ در صورت استفاده از TLS
- کلید private برای Message Queue: کلید private مربوط به client (PK) برای اتصال به سرور RabbitMQ در صورت استفاده از TLS
-
تنظیمات برنامه
- نام نصب: نام این نصب TestRail. این نام در صفحه ورود و dashboard نمایش داده میشود.
- آدرس وب: آدرس وب نصب TestRail شما. این آدرس، از جمله، برای لینکهای موجود در notificationهای ایمیلی استفاده میشود. «http://localhost/testrail/» مقداری است که در این مستندات استفاده شده است.
- زبان پیشفرض: زبان پیشفرض رابط کاربری را تعیین میکند. کاربران میتوانند زبان خود را از بخش My Settings تغییر دهند.
- Locale پیشفرض: مشخص میکند تاریخها و عددها بهصورت پیشفرض چگونه قالببندی شوند. کاربران میتوانند locale خود را از بخش My Settings تغییر دهند.
- منطقه زمانی پیشفرض: منطقه زمانی پیشفرض را برای تاریخها و زمانها تعیین میکند.
- دایرکتوری پیوستها: دایرکتوری روی web server که attachmentهای آپلودشده در آن ذخیره میشوند. این دایرکتوری باید برای TestRail قابل نوشتن باشد و نباید مستقیماً از طریق مرورگر وب در دسترس باشد. در این مستندات از «/opt/testrail/attachments/» استفاده میکنیم. این دایرکتوری را باید بهصورت دستی ایجاد کنید.
- دایرکتوری گزارشها: دایرکتوری روی web server که reportهای تولیدشده در آن ذخیره میشوند. این دایرکتوری باید برای TestRail قابل نوشتن باشد و نباید مستقیماً از طریق مرورگر وب در دسترس باشد. در این مستندات از «/opt/testrail/reports/» استفاده میکنیم. این دایرکتوری را باید بهصورت دستی ایجاد کنید.
- دایرکتوری لاگها: «/opt/testrail/logs/»؛ این دایرکتوری را باید بهصورت دستی ایجاد کنید.
- دایرکتوری audit: بهصورت پیشفرض «/opt/testrail/audit/»؛ این دایرکتوری را باید بهصورت دستی ایجاد کنید.
نصبکننده همچنین از شما میخواهد دایرکتوریهایی را برای ذخیره attachmentها، reportها و log fileها مشخص کنید. این دایرکتوریها را ایجاد کنید و مطمئن شوید web server بتواند در آنها بنویسد. برای دایرکتوریهای attachment و report، به دلایل امنیتی مطمئن شوید که مستقیماً از طریق مرورگر وب قابل دسترسی نیستند؛ بنابراین دایرکتوریای خارج از مسیر www انتخاب کنید، مثلاً /opt/testrail/attachments. برای اینکه web server بتواند در این دایرکتوریها بنویسد، کافی است مالکیت آنها را به کاربر web server تغییر دهید. برای مثال، در سیستمهای Ubuntu:
$ sudo chown www-data:www-data /var/www/html/testrail/logs/
$ sudo chown www-data:www-data /opt/testrail/attachments/
$ sudo chown www-data:www-data /opt/testrail/reports/ -
تنظیمات ایمیل
این تنظیمات نیز اختیاری هستند. تنظیمات سرور برای ارسال اعلانهای ایمیلی و قابلیت «فراموشی رمز عبور» استفاده میشوند.
- سرور:نام میزبان و پورت دستگاهی که برای ارسال ایمیلها استفاده میشود. اگر پورت با ۲۵ متفاوت است، آن را به این شکل اضافه کنید: ‘mail.example.com:۵۰’.
- رمزگذاری ایمیل:[استفاده از SSL / استفاده از TLS / بدون رمزگذاری] اگر SMTP server ایمیل شما از اتصال امن (SSL/TLS) استفاده میکند و به آن نیاز دارد، این گزینه را فعال کنید.
- فرستنده:آدرس ایمیلی که برای ارسال ایمیلها استفاده میشود.
- کاربر:اگر سرور ایمیل به احراز هویت نیاز ندارد، این قسمت را خالی بگذارید.
- رمز عبور:اگر سرور ایمیل به احراز هویت نیاز ندارد، این قسمت را خالی بگذارید.
- فعالسازی اعلانهای ایمیلی:[فعال/غیرفعال] اعلانهای ایمیلی برای تغییرات test و test resultها ارسال میشوند. هر کاربر نیز میتواند این اعلانها را از بخش «My Settings» برای حساب خود غیرفعال کند.
-
حساب مدیر
اولین حساب کاربری خود را ایجاد کنید و license key مربوط به TestRail را وارد کنید.
- نام کامل: برای مثال، John Doe یا Jane Doe
- آدرس ایمیل: برای مثال، john.doe@email.com یا jane.doe@email.com
- رمز عبور/تأیید رمز عبور: رمز عبور را وارد و تأیید کنید.
- License Key: trial license key یا full license key خود را جایگذاری کنید.
-
تأیید پیکربندی
تنظیمات خود را بررسی کنید و روی Install کلیک کنید تا نصب TestRail کامل شود.
#
باید background task مربوط به TestRail را فعال کنید. این background task، در کنار کارهای دیگر، مسئول ارسال اعلانهای ایمیلی برای تغییرات test است، البته در صورتی که این قابلیت را فعال کرده باشید. برای آشنایی با روش فعالسازی آن، به
مستندات background task.
پس از کامل کردن مراحل، در پایان صفحه موفقیت را مشاهده خواهید کرد.
ممکن است لازم باشد با استفاده از محتوای کادر زرد، یک فایل config.php ایجاد کنید و آن را در پوشه wwwroot مربوط به instance خود ذخیره کنید. در این سند از مسیر ‘/var/www/html/testrail/’ استفاده کردهایم.
بهروزرسانی config.php #
باید مسیر Chrome Headless Shell را در فایل config.php اضافه کنید:
define('TR_CHROME_PATH', 'C:\Program Files\ChromeHeadless');
ورود به TestRail #
میتوانید با کلیک روی Log in to TestRail یا با باز کردن آن در مرورگر وب خود، استفاده از برنامه را شروع کنید؛ برای مثال:
http://<server>/testrail
