نصب TestRail (یونیکس/لینوکس) – نسخه ۸.۰.۱.۱۰۲۹

برای نصب برنامه TestRail روی سرور Unix خود، فایل آرشیو نصب TestRail را در وب‌سرور آپلود و extract کنید، سپس فایل‌ها را در دایرکتوری www وب‌سرور کپی کنید؛ برای مثال در Ubuntu مسیر آن /var/www/html/testrail است. بعضی سیستم‌های Unix به‌صورت پیش‌فرض از دستور unzip پشتیبانی نمی‌کنند، بنابراین شاید لازم باشد ابتدا آن را نصب کنید. نمونه زیر برای Ubuntu/Debian است:

$ sudo apt-get install unzip

سپس در مرورگر خود به دایرکتوری جدید TestRail روی وب‌سرور بروید تا TestRail Installation Wizard اجرا شود؛ برای مثال http://<server>/testrail/ و دستورالعمل‌ها را دنبال کنید:

1. برای ادامه، شرایط license را بررسی و قبول کنید

   

2. تنظیمات Database

    

   این راهنما مقادیر زیر را فرض می‌کند:

   • Driver: درایور MySQL مناسب برای database خود را انتخاب کنید. در این مستند، از منوی کشویی Driver گزینه «MySQL (۵.x and higher)» را انتخاب می‌کنیم
   • Server: localhost (hostname)
   • Database: testRail (نام DB که در MySQL ایجاد کردیم)
   • User: testrail
   • Password: رمز عبوری که هنگام ساخت Login با نام «testrail» استفاده شد

   

3. تنظیمات Cassandra

    

   Installer از شما می‌خواهد اطلاعات Cassandra را وارد کنید. این اطلاعات به مقادیری بستگی دارد که هنگام نصب وارد کرده‌اید.

   مقادیر پیش‌فرض عبارت‌اند از:

   • Server: localhost
   • Port: 9042 
   • Keyspace: testrail یا نامی که هنگام ایجاد Keyspace وارد کرده‌اید
   • Username: cassandra یا کاربری که برای TestRail ایجاد کرده‌اید و به آن مجوز داده‌اید
   • Password: cassandra یا رمز عبوری که برای کاربر ایجادشده تعیین کرده‌اید

   

4. تنظیمات RabbitMQ

    

     #

   برای نصب RabbitMQ روی سیستم‌عامل خود، به مستندات رسمی RabbitMQ در آدرس زیر مراجعه کنید:

   https://www.rabbitmq.com/download.html

   استفاده از RabbitMQ اختیاری است. اگر می‌خواهید از بخشی از قابلیت‌های Webhooksاستفاده کنید، باید RabbitMQ را پیکربندی کنید.

   از آن‌جا که برای ادامه نصب، تکمیل هیچ‌یک از این فیلدها الزامی نیست، در صورت تمایل می‌توانید به مرحله بعد بروید.

   مقادیر پیش‌فرض استفاده‌شده در این مستند به شرح زیر است:

   • سرور صف پیام: نام میزبان سرور RabbitMQ
   • پورت صف پیام: پورت RabbitMQ (به‌طور پیش‌فرض ۵۶۷۲)
   • کاربر صف پیام: کاربر RabbitMQ مربوط به TestRail. این کاربر باید مجوز مدیریت صف‌ها (ایجاد/حذف) را داشته باشد.
   • رمز عبور صف پیام: رمز عبور کاربر RabbitMQ مربوط به TestRail که در بالا وارد شده است
   • استفاده از TLS: [فعال/غیرفعال]
   • گواهی CA صف پیام: گواهی CA برای اتصال به سرور RabbitMQ، در صورت استفاده از TLS
   • گواهی client صف پیام: گواهی client برای اتصال به سرور RabbitMQ، در صورت استفاده از TLS
   • کلید خصوصی صف پیام: کلید خصوصی client (PK) برای اتصال به سرور RabbitMQ، در صورت استفاده از TLS

   

5. تنظیمات برنامه

   • نام نصب: نام این نصب TestRail. نام نصب در صفحه ورود و dashboard نمایش داده می‌شود. 
   • آدرس وب: آدرس وب نصب TestRail شما. این آدرس، از جمله، برای لینک‌های داخل اعلان‌های ایمیلی استفاده می‌شود. «http://localhost/testrail/» مقداری است که در این مستندات استفاده شده است.
   • زبان پیش‌فرض: زبان پیش‌فرض رابط کاربری را تعیین می‌کند. کاربران می‌توانند زبان خود را از بخش My Settings تغییر دهند.
   • Locale پیش‌فرض: نحوه قالب‌بندی پیش‌فرض تاریخ‌ها و اعداد را تعیین می‌کند. کاربران می‌توانند locale خود را از بخش My Settings تغییر دهند.
   • منطقه زمانی پیش‌فرض: منطقه زمانی پیش‌فرض را برای تاریخ‌ها و ساعت‌ها تعیین می‌کند.
   • دایرکتوری پیوست‌ها: دایرکتوری روی web server که فایل‌های پیوست آپلودشده در آن ذخیره می‌شوند. این دایرکتوری باید برای TestRail قابل نوشتن باشد و نباید مستقیماً از طریق web browser در دسترس باشد. در این سند از «/opt/testrail/attachments/» استفاده می‌کنیم (باید این دایرکتوری را به‌صورت دستی ایجاد کنید).
   • دایرکتوری گزارش‌ها: دایرکتوری روی web server که گزارش‌های ایجادشده در آن ذخیره می‌شوند. این دایرکتوری باید برای TestRail قابل نوشتن باشد و نباید مستقیماً از طریق web browser در دسترس باشد. در این سند از «/opt/testrail/reports/» استفاده می‌کنیم (باید این دایرکتوری را به‌صورت دستی ایجاد کنید).
   • دایرکتوری logها: «/opt/testrail/logs/» (باید این دایرکتوری را به‌صورت دستی ایجاد کنید).
   • دایرکتوری audit: به‌طور پیش‌فرض «/opt/testrail/audit/» (باید این دایرکتوری را به‌صورت دستی ایجاد کنید).

   

    

   نصب‌کننده همچنین از شما می‌خواهد دایرکتوری‌هایی را برای ذخیره پیوست‌ها، گزارش‌ها و فایل‌های log مشخص کنید. این دایرکتوری‌ها را ایجاد کنید و مطمئن شوید web server امکان نوشتن در آن‌ها را دارد. برای دایرکتوری‌های پیوست و گزارش، به دلایل امنیتی مطمئن شوید که مستقیماً از طریق web browser در دسترس نیستند؛ بنابراین دایرکتوری‌ای خارج از دایرکتوری 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/

6. تنظیمات ایمیل

    

   این تنظیمات نیز اختیاری هستند. تنظیمات سرور برای اعلان‌های ایمیلی و قابلیت «Forgot Password» استفاده می‌شوند.

   • سرور: hostname و port ماشینی که برای ارسال ایمیل استفاده می‌شود. اگر port عددی غیر از ۲۵ است، آن را به این شکل اضافه کنید: ‘mail.example.com:۵۰’.
   • رمزگذاری ایمیل: [استفاده از SSL / استفاده از TLS / بدون رمزگذاری] اگر سرور SMTP ایمیل شما از اتصال امن (SSL/TLS) استفاده می‌کند و به آن نیاز دارد، این گزینه را فعال کنید.
   • فرستنده: آدرس ایمیلی که برای ارسال ایمیل‌ها استفاده می‌شود.
   • کاربر: اگر سرور ایمیل به احراز هویت نیاز ندارد، این فیلد را خالی بگذارید.
   • رمز عبور: اگر سرور ایمیل به احراز هویت نیاز ندارد، این فیلد را خالی بگذارید.
   • فعال کردن اعلان‌های ایمیلی: [فعال/غیرفعال] اعلان‌های ایمیلی برای تغییرات test و نتایج test ارسال می‌شوند. همچنین هر کاربر می‌تواند آن‌ها را از بخش «My Settings» غیرفعال کند.

   

7.  حساب Administrator

   اولین حساب کاربری خود را ایجاد کنید و license key مربوط به TestRail را وارد کنید.

   • نام کامل: برای مثال، John Doe یا Jane Doe
   • آدرس ایمیل: برای مثال، john.doe@email.com یا jane.doe@email.com
   • رمز عبور/تأیید رمز عبور: رمز عبور را وارد و تأیید کنید.
   • License Key: license key آزمایشی یا کامل خود را جای‌گذاری کنید.

   

8. تأیید پیکربندی

    

   تنظیمات خود را بررسی کنید و روی Install کلیک کنید تا نصب TestRail کامل شود.

   

پس از پایان مراحل، در انتها این صفحه موفقیت را می‌بینید.

ممکن است لازم باشد با استفاده از محتوای کادر زرد، یک فایل config.php ایجاد کنید و آن را در پوشه wwwroot نمونه خود ذخیره کنید. در این سند، از مسیر ‘/var/www/html/testrail/’ استفاده کرده‌ایم.

برای شروع استفاده از برنامه، می‌توانید روی Log in to TestRail  کلیک کنید یا آن را از طریق مرورگر وب خود باز کنید؛ برای مثال:

http://<server>/testrail