نصب TestRail (Unix/Linux) – نسخه ۹.۱.۰.۱۰۲۵

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

$ sudo apt-get install unzip

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

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

   در این راهنما، مقادیر زیر در نظر گرفته شده‌اند:

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

   

3. تنظیمات Cassandra

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

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

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

   

4. تنظیمات RabbitMQ

     #

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

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

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

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

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

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

   

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

   

    

   نصب‌کننده همچنین از شما می‌خواهد دایرکتوری‌هایی را برای ذخیره attachmentها، reportها و فایل‌های log مشخص کنید. لطفاً این دایرکتوری‌ها را ایجاد کنید و مطمئن شوید که وب‌سرور می‌تواند در آن‌ها بنویسد. برای دایرکتوری‌های attachment و report، به دلایل امنیتی مطمئن شوید که مستقیم از طریق مرورگر وب در دسترس نیستند؛ بنابراین دایرکتوری‌ای خارج از دایرکتوری www خود مشخص کنید، مثلاً /opt/testrail/attachments. برای اینکه وب‌سرور بتواند در این دایرکتوری‌ها بنویسد، کافی است مالکیت آن‌ها را به کاربر وب‌سرور تغییر دهید. برای مثال، در سیستم‌های 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) و پورت سروری که برای ارسال ایمیل استفاده می‌شود. اگر پورت چیزی غیر از ۲۵ است، آن را به این شکل به انتهای آدرس اضافه کنید: ‘mail.example.com:۵۰’.
   • رمزگذاری ایمیل: [استفاده از SSL / استفاده از TLS / بدون رمزگذاری] اگر سرور SMTP ایمیل شما از اتصال امن (SSL/TLS) استفاده می‌کند و به آن نیاز دارد، این گزینه را فعال کنید.
   • فرستنده: آدرس ایمیلی که برای ارسال ایمیل‌ها استفاده می‌شود.
   • کاربر: اگر 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