نصب TestRail (یونیکس/لینوکس)

برای نصب برنامه TestRail روی سرور Unix خود، آرشیو نصب TestRail را روی web server آپلود و استخراج کنید
و فایل‌ها را در دایرکتوری www مربوط به web server کپی کنید
(برای مثال، در Ubuntu مسیر آن /var/www/html/testrail است).

1. فایل `.htaccess` را در دایرکتوری root مربوط به TestRail ایجاد یا به‌روزرسانی کنید
   و محتوای زیر را در آن قرار دهید:

   <FilesMatch "\.(sql|ini)$">
   Require all denied
   </FilesMatch>
   

    

2. اگر در مرحله قبل یک فایل `.htaccess` جدید ایجاد کرده‌اید، مطمئن شوید
   permission آن درست است (معمولاً ۶۴۴):

   chmod 644 /var/www/testrail/.htaccess

بعضی از سیستم‌های Unix به‌صورت پیش‌فرض از دستور unzip پشتیبانی نمی‌کنند؛ بنابراین ممکن است
لازم باشد ابتدا آن را نصب کنید (این مثال برای Ubuntu/Debian است):

$ sudo apt-get install unzip

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

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

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

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

   

3. تنظیمات RabbitMQ
   
   

    
   #

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

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

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

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

   مقادیر پیش‌فرضی که در این مستند استفاده شده‌اند به این صورت هستند:

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

   

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

   

    

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

5. تنظیمات Email

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

   • Server:hostname و port دستگاهی که برای ارسال email استفاده می‌شود. اگر port با ۲۵ متفاوت است، آن را به این شکل اضافه کنید: ‘mail.example.com:۵۰’.
   • رمزگذاری Email:[Use SSL / Use TLS / No encryption] اگر email SMTP server شما از اتصال امن (SSL/TLS) استفاده می‌کند و به آن نیاز دارد، این گزینه را فعال کنید.
   • From:آدرس emailی که برای ارسال emailها استفاده می‌شود.
   • User:اگر email server به authentication نیاز ندارد، این بخش را خالی بگذارید.
   • Password:اگر email server به authentication نیاز ندارد، این بخش را خالی بگذارید.
   • فعال‌سازی email notificationها:[Enable/Disable] email notificationها برای تغییرات test و test resultها ارسال می‌شوند. همچنین هر کاربر می‌تواند آن‌ها را از بخش «My Settings» برای خودش غیرفعال کند.

   

6.  حساب Administrator

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

   • Full Name: برای مثال، John Doe یا Jane Doe
   • Email Address: برای مثال، john.doe@email.com یا jane.doe@email.com
   • Password/Confirm Password: password را وارد و تأیید کنید.
   • License Key: license key نسخه trial یا نسخه کامل خود را paste کنید.

   

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

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

   

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

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

به‌روزرسانی config.php
#

باید مسیر Chrome Headless Shell را در فایل config.php اضافه کنید:

define('TR_CHROME_PATH', 'C:\Program Files\ChromeHeadless');

ورود به TestRail
#

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

http://<server>/testrail