نصب TestRail (یونیکس/لینوکس) – نسخه ۸.۰.۴.۷۰۳۶

برای نصب برنامه TestRail روی سرور Unix، فایل آرشیو نصب TestRail را در web server خود آپلود و 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 خود را انتخاب کنید. در این سند، گزینه «MySQL (۵.x and higher)» را از منوی Driver انتخاب می‌کنیم
   • Server: localhost (نام میزبان)
   • Database: testRail (نام database که در MySQL ایجاد کردیم)
   • User: testrail
   • Password: (رمز عبوری که هنگام ایجاد Login مربوط به «testrail» استفاده شد)

   

3. تنظیمات Cassandra

    

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

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

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

   

4. تنظیمات 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 قابل نوشتن باشد و نباید مستقیماً با مرورگر وب در دسترس باشد. در این سند، از «/opt/testrail/attachments/» استفاده می‌کنیم (باید این دایرکتوری را به‌صورت دستی ایجاد کنید).
   • دایرکتوری گزارش‌ها: دایرکتوری روی web server که گزارش‌های تولیدشده در آن ذخیره می‌شوند. این دایرکتوری باید برای TestRail قابل نوشتن باشد و نباید مستقیماً با مرورگر وب در دسترس باشد. در این سند، از «/opt/testrail/reports/» استفاده می‌کنیم (باید این دایرکتوری را به‌صورت دستی ایجاد کنید).
   • دایرکتوری log: «/opt/testrail/logs/» (باید این دایرکتوری را به‌صورت دستی ایجاد کنید).
   • دایرکتوری audit: «/opt/testrail/audit/» به‌صورت پیش‌فرض (باید این دایرکتوری را به‌صورت دستی ایجاد کنید).

   

    

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

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

   

7.  حساب مدیر

   اولین حساب کاربری خود را بسازید و 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 مربوط به instance خود ذخیره کنید. در این سند از مسیر ‘/var/www/html/testrail/’ استفاده کرده‌ایم.

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

http://<server>/testrail