برای نصب TestRail روی سرور Unix، فایل آرشیو نصب TestRail را روی وبسرور آپلود و extract کنید، سپس فایلها را در دایرکتوری www وبسرور کپی کنید؛ برای مثال در Ubuntu مسیر آن معمولاً `/var/www/html/testrail` است.
- فایل `.htaccess` را در دایرکتوری root مربوط به 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 را بررسی و قبول کنید
-
تنظیمات Database
این راهنما مقدارهای زیر را فرض میکند:
- Driver: Driver مناسب MySQL را برای database خود انتخاب کنید. در این راهنما، گزینه «MySQL (۵.x and higher)» را از منوی Driver انتخاب میکنیم
- Server: localhost (hostname)
- Database: testRail (نام database که در MySQL ایجاد کردیم)
- User: testrail
- Password: (همان password که هنگام ایجاد Login با نام `testrail` استفاده کردید)
-
تنظیمات Cassandra
installer از شما میخواهد اطلاعات Cassandra را وارد کنید. این اطلاعات به مقادیری بستگی دارد که هنگام نصب تعیین کردهاید.
مقادیر پیشفرض عبارتاند از:
- Server: localhost
- Port: 9042
- Keyspace: testrail یا نامی که هنگام ایجاد Keyspace وارد کردهاید
- Username: cassandra یا کاربری که برای TestRail ایجاد کردهاید و به آن permission دادهاید
- Password: cassandra یا password کاربری که ایجاد کردهاید
-
تنظیمات RabbitMQ
#
برای نصب RabbitMQ روی سیستمعامل خود، به مستندات رسمی RabbitMQ در آدرس زیر مراجعه کنید:
استفاده از RabbitMQ اختیاری است. اگر میخواهید از برخی قابلیتهای Webhooks استفاده کنید ، باید RabbitMQ پیکربندی شود.
از آنجا که هیچیک از این فیلدها برای ادامه نصب الزامی نیست، در صورت تمایل میتوانید به مرحله بعد بروید.
مقادیر پیشفرضی که در این مستندات استفاده شدهاند به شرح زیر است:
- سرور Message Queue: نام میزبان سرور 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
- کلید خصوصی Message Queue: کلید خصوصی client (PK) برای اتصال به سرور RabbitMQ، در صورت استفاده از TLS
-
تنظیمات برنامه
- نام نصب: نام این نصب TestRail. این نام در صفحه ورود و dashboard نمایش داده میشود.
- آدرس وب: آدرس وب نصب TestRail شما. از این آدرس، از جمله برای لینکهای موجود در اعلانهای ایمیلی استفاده میشود. «http://localhost/testrail/» مقداری است که در این مستندات استفاده شده است.
- زبان پیشفرض: زبان پیشفرض رابط کاربری را تعیین میکند. کاربران میتوانند زبان خود را از بخش My Settings تغییر دهند.
- Locale پیشفرض: نحوه نمایش پیشفرض تاریخها و عددها را تعیین میکند. کاربران میتوانند locale خود را از بخش My Settings تغییر دهند.
- منطقه زمانی پیشفرض: منطقه زمانی پیشفرض را برای تاریخها و زمانها تعیین میکند.
- دایرکتوری پیوستها: دایرکتوری روی web server که فایلهای پیوست آپلودشده در آن ذخیره میشوند. این دایرکتوری باید برای TestRail قابل نوشتن باشد و نباید مستقیماً از طریق مرورگر وب در دسترس باشد. در این سند از «/opt/testrail/attachments/» استفاده میکنیم (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
- دایرکتوری گزارشها: دایرکتوری روی web server که گزارشهای تولیدشده در آن ذخیره میشوند. این دایرکتوری باید برای TestRail قابل نوشتن باشد و نباید مستقیماً از طریق مرورگر وب در دسترس باشد. در این سند از «/opt/testrail/reports/» استفاده میکنیم (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
- دایرکتوری logها: «/opt/testrail/logs/» (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
- دایرکتوری audit: بهطور پیشفرض «/opt/testrail/audit/» (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
installer همچنین از شما میخواهد دایرکتوریهایی را برای ذخیره 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/ -
تنظیمات ایمیل
این تنظیمات نیز اختیاری هستند. تنظیمات سرور برای اعلانهای ایمیلی و قابلیت «Forgot Password» استفاده میشوند.
- Server: hostname و port دستگاهی که برای ارسال ایمیل استفاده میشود. اگر port عددی غیر از ۲۵ است، آن را به این شکل اضافه کنید: ‘mail.example.com:۵۰’.
- رمزنگاری ایمیل: [Use SSL / Use TLS / No encryption] اگر SMTP server ایمیل شما از اتصال امن (SSL/TLS) استفاده میکند و به آن نیاز دارد، این گزینه را فعال کنید.
- From: آدرس ایمیلی که برای ارسال ایمیلها استفاده میشود.
- User: اگر email server به authentication نیاز ندارد، این قسمت را خالی بگذارید.
- Password: اگر email server به authentication نیاز ندارد، این قسمت را خالی بگذارید.
- فعالسازی اعلانهای ایمیلی: [Enable/Disable] اعلانهای ایمیلی برای تغییرات test و نتایج test ارسال میشوند. این اعلانها را میتوان برای هر کاربر بهصورت جداگانه از طریق «My Settings» نیز غیرفعال کرد.
-
حساب administrator
اولین حساب کاربری خود را ایجاد کنید و license key مربوط به TestRail را وارد کنید.
- نام کامل: برای مثال، John Doe یا Jane Doe
- آدرس ایمیل: برای مثال، john.doe@email.com یا jane.doe@email.com
- Password/Confirm Password: password را وارد و تأیید کنید
- License Key: license key آزمایشی یا کامل خود را paste کنید
-
تأیید پیکربندی
تنظیمات خود را بررسی کنید و روی Install کلیک کنید تا نصب TestRail کامل شود.
#
باید background task مربوط به TestRail را فعال کنید. این background task، از جمله، اگر این قابلیت را فعال کرده باشید، مسئول ارسال اعلانهای ایمیلی برای تغییرات test است. برای آشنایی با نحوه فعالسازی آن، به مستندات background task مراجعه کنید.
پس از انجام مراحل، در پایان صفحه موفقیت را مشاهده خواهید کرد.
ممکن است لازم باشد با استفاده از محتوای کادر زرد، یک فایل config.php بسازید و آن را در پوشه wwwroot مربوط به instance خود ذخیره کنید. در این سند از مسیر ‘/var/www/html/testrail/’ استفاده کردهایم.
میتوانید با کلیک روی Log in to TestRail یا با باز کردن آدرس آن در مرورگر وب، استفاده از برنامه را شروع کنید؛ برای مثال:
http://<server>/testrail
