نصب 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: Driver مناسب MySQL را برای database خود انتخاب کنید. در این مستند، از منوی Driver گزینه «MySQL (۵.x and higher)» را انتخاب می‌کنیم
   • Server: localhost (hostname)
   • Database: testRail (نام DB که در MySQL ایجاد کردیم)
   • User: testrail
   • Password: (همان password که هنگام ایجاد login با نام «testrail» استفاده کردید)

   

3. تنظیمات Cassandra

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

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

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

   

4. تنظیمات RabbitMQ

     #

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

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

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

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

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

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

   

5. تنظیمات برنامه
   • نام نصب: نام این نصب TestRail. نام نصب در صفحه ورود و dashboard نمایش داده می‌شود. 
   • آدرس وب: آدرس وب نصب TestRail شما. این آدرس، از جمله برای لینک‌های داخل email notificationها استفاده می‌شود. «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 مشخص کنید. لطفاً این دایرکتوری‌ها را ایجاد کنید و مطمئن شوید که 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. تنظیمات ایمیل

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

   • سرور: نام میزبان و پورت ماشینی که برای ارسال ایمیل‌ها استفاده می‌شود. اگر پورت با ۲۵ متفاوت است، آن را به این شکل به آدرس اضافه کنید: ‘mail.example.com:۵۰’.
   • رمزگذاری ایمیل: [استفاده از SSL / استفاده از TLS / بدون رمزگذاری] اگر سرور SMTP ایمیل شما از اتصال امن (SSL/TLS) استفاده می‌کند و آن را الزامی می‌داند، این گزینه را فعال کنید.
   • فرستنده: آدرس ایمیلی که برای ارسال ایمیل‌ها استفاده می‌شود.
   • کاربر: اگر سرور ایمیل به احراز هویت نیاز ندارد، این قسمت را خالی بگذارید.
   • رمز عبور: اگر سرور ایمیل به احراز هویت نیاز ندارد، این قسمت را خالی بگذارید.
   • فعال کردن اعلان‌های ایمیلی: [فعال/غیرفعال] اعلان‌های ایمیلی برای تغییرات 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