نصب TestRail روی Unix/Linux – نسخه ۸.۰.۶.۱۰۱۹

برای نصب 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. تنظیمات پایگاه داده

   در این راهنما از مقادیر زیر استفاده شده است:

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

   

3. تنظیمات Cassandra

   Installer از شما می‌خواهد اطلاعات 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 را پیکربندی کنید.

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

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

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

   

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

   

    

   installer از شما می‌خواهد دایرکتوری‌هایی را برای ذخیره attachmentها، reportها و log fileها مشخص کنید. این دایرکتوری‌ها را ایجاد کنید و مطمئن شوید web server امکان نوشتن در آن‌ها را دارد. برای دایرکتوری‌های attachment و report، به دلایل امنیتی مطمئن شوید مستقیماً از طریق 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 استفاده می‌شوند.

   • سرور: نام میزبان و پورت سیستمی که برای ارسال ایمیل‌ها استفاده می‌شود. اگر پورت چیزی غیر از ۲۵ است، آن را به این شکل اضافه کنید: ‘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