برای نصب خود برنامه TestRail روی Windows Server، فایل آرشیو نصب TestRail را روی web server آپلود و extract کنید، سپس فایلها را در پوشه wwwroot وبسرور کپی کنید؛ برای مثال: C:\inetpub\wwwroot. همچنین میتوانید در IIS یک virtual directory بسازید و فایلهای TestRail را در مسیر دیگری نصب کنید.
سپس در مرورگر وب، مسیر جدید TestRail روی web server را باز کنید تا TestRail Installation Wizard اجرا شود؛ برای مثال: http://<server>/testrail/ و دستورالعملها را دنبال کنید.
#
مشکل دسترسی (۴۰۱)؟ اگر هنگام دسترسی به installer TestRail خطای دسترسی ۴۰۱ دریافت کردید، مطمئن شوید IIS میتواند فایلهای PHP را بخواند و اجرا کند. برای این کار، در Explorer روی پوشه testrail راستکلیک کنید، Properties را انتخاب کنید و سپس به تب Security بروید. اگر کاربر IIS در فهرست نبود، روی Add کلیک کنید، کاربر IIS را وارد کنید (در Windows ۲۰۰۸ و نسخههای بعدی IUSR، و در Windows ۲۰۰۳ کاربر IUSR_<hostname> است)، و با OK تأیید کنید. سپس مجوزهای Read، & Execute، List Folder Contents و Read را فعال کنید. نکته مهم دیگر: روی دکمه Advanced کلیک کنید و گزینه Replace permission entries on all child objects with entries shown here that apply to child objects را فعال کنید. همه پنجرهها را با کلیک روی OK ببندید.
#
SQL Server Express / named instance؟ اگر SQL Server Express یا نسخه دیگری از SQL Server را بهصورت named instance نصب کردهاید، ممکن است هنگام اتصال TestRail به database لازم باشد نام instance را هم بهعنوان بخشی از نام server وارد کنید. یعنی در صفحه دوم installation wizard باید هم hostname و هم نام instance را در فیلد Server وارد کنید. برای مثال، برای یک instance محلی SQL Server Express با نام sqlexpress، مقدار localhost\sqlexpress را وارد کنید.
-
برای ادامه، شرایط license را بررسی و قبول کنید.
-
Database Settings
درایور MS SQL مناسب database خود را انتخاب کنید. در این راهنما، از منوی Driver گزینه MS SQL Server (۲۰۰۸, ۲۰۱۲, ۲۰۱۴, or ۲۰۱۶) را انتخاب میکنیم. قبل از ادامه، مقدار همه فیلدهای الزامی این صفحه را وارد کنید.
در اینجا از مقادیر نمونه زیر استفاده شده است؛ هنگام نصب میتوانید مقادیر مناسب محیط خودتان را وارد کنید:
-
Server: localhost (hostname). در این حالت از PC Name استفاده میشود و \SQLEXPRESS به انتهای آن اضافه میشود. این اطلاعات در SQL Server Management Studio شما هم نمایش داده میشود (تصویر زیر). توجه داشته باشید که اطلاعات شما ممکن است متفاوت باشد.
- Database: TestRail (نام DB که در SQL Server ایجاد کردهاید)
- User: testrail
-
Password: رمز عبوری که هنگام ساخت Login با نام «testrail» استفاده کردید
-
Server: localhost (hostname). در این حالت از PC Name استفاده میشود و \SQLEXPRESS به انتهای آن اضافه میشود. این اطلاعات در SQL Server Management Studio شما هم نمایش داده میشود (تصویر زیر). توجه داشته باشید که اطلاعات شما ممکن است متفاوت باشد.
-
تنظیمات Cassandra
installer از شما میخواهد اطلاعات Cassandra را وارد کنید. این اطلاعات به مقادیری بستگی دارد که هنگام نصب وارد کردهاید.
مقادیر پیشفرض عبارتاند از:
- Server: localhost
- Port: 9042
- Keyspace: testrail یا نامی که هنگام ساخت Keyspace وارد کردهاید
- Username: cassandra یا کاربری که برای TestRail ساختهاید و به آن دسترسی دادهاید
-
Password: cassandra یا رمز عبوری که برای کاربر ساختهشده تعیین کردهاید
-
تنظیمات RabbitMQ
استفاده از RabbitMQ اختیاری است. اگر میخواهید از بخشی از قابلیتهای Webhooks استفاده کنید، باید RabbitMQ را پیکربندی کنید. از آنجا که هیچکدام از این فیلدها برای ادامه نصب الزامی نیستند، در صورت تمایل میتوانید به مرحله بعد بروید.
#
برای اطلاعات بیشتر درباره دانلود و نصب RabbitMQ روی سیستمعامل خود، به مستندات رسمی نصبمراجعه کنید.
اگر میخواهید RabbitMQ را پیکربندی کنید، مقادیر پیشفرض به این صورت است:
- Message Queue Server: نام Host سرور RabbitMQ
- Message Queue Port: پورت RabbitMQ (بهصورت پیشفرض ۵۶۷۲)
- Message Queue User: کاربر RabbitMQ مربوط به TestRail. این کاربر باید دسترسی مدیریت queueها (ایجاد/حذف) را داشته باشد.
- Message Queue Password: رمز عبور کاربر RabbitMQ مربوط به TestRail که در بالا وارد شده است
- Use TLS: [enabled/disabled]
- Message Queue CA Certificate: گواهی CA برای اتصال به سرور RabbitMQ در صورت استفاده از TLS
- Message Queue Client Certificate: گواهی client برای اتصال به سرور RabbitMQ در صورت استفاده از TLS
-
Message Queue Private Key: کلید خصوصی client (PK) برای اتصال به سرور RabbitMQ در صورت استفاده از TLS
-
تنظیمات برنامه
- نام نصب: نام این نصب TestRail. نام نصب در صفحه ورود و dashboard نمایش داده میشود.
- آدرس وب: آدرس وب نصب TestRail شما. این آدرس، از جمله برای لینکهای موجود در اعلانهای ایمیلی استفاده میشود. ‘http://localhost/testrail/’ مقدار نمونهای است که در این مستندات استفاده شده است.
- زبان پیشفرض: زبان پیشفرض رابط کاربری را تعیین میکند. کاربران میتوانند زبان خود را از بخش My Settings تغییر دهند.
- Locale پیشفرض: نحوه نمایش پیشفرض تاریخها و اعداد را تعیین میکند. کاربران میتوانند locale خود را از بخش My Settings تغییر دهند.
- منطقه زمانی پیشفرض: منطقه زمانی پیشفرض را برای تاریخها و زمانها تعیین میکند.
- دایرکتوری پیوستها: دایرکتوری روی web server که پیوستهای آپلودشده در آن ذخیره میشوند. این دایرکتوری باید برای TestRail قابل نوشتن باشد و نباید مستقیماً از طریق مرورگر وب در دسترس باشد. در این سند از ‘C:\testrail\attachments\’ استفاده میکنیم (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
- دایرکتوری گزارشها: دایرکتوری روی web server که گزارشهای تولیدشده در آن ذخیره میشوند. این دایرکتوری باید برای TestRail قابل نوشتن باشد و نباید مستقیماً از طریق مرورگر وب در دسترس باشد. در این سند از ‘C:\testrail\reports\’ استفاده میکنیم (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
- دایرکتوری لاگها: بهصورت پیشفرض ‘C:\testrail\logs\’ است (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
-
دایرکتوری audit: بهصورت پیشفرض ‘C:\testrail\audit\’ است (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
Installer همچنین از شما میخواهد دایرکتوریهایی را برای ذخیره پیوستها، گزارشها و فایلهای log مشخص کنید. لطفاً این دایرکتوریها را ایجاد کنید و مطمئن شوید که web server میتواند در آنها بنویسد. برای دایرکتوریهای پیوست و گزارش، به دلایل امنیتی باید مطمئن شوید که مستقیماً از طریق مرورگر وب در دسترس نیستند. حتماً دایرکتوریای خارج از پوشه wwwroot مشخص کنید (برای مثال، C:\TestRailAttachments). برای اینکه IIS بتواند در این دایرکتوریها بنویسد، کاربر IUSR را به تنظیمات امنیتی دایرکتوریها اضافه کنید و به این کاربر مجوز کامل بدهید (در سیستمهای Windows Server ۲۰۰۳، نام کاربر معمولاً IUSR_ است<hostname>). مطمئن شوید IUSRS مالک دایرکتوریها است:
-
تنظیمات ایمیل
این موارد نیز تنظیمات اختیاری هستند. تنظیمات سرور برای اعلانهای ایمیلی استفاده میشوند و همچنین برای قابلیت Forgot Password.
- سرور: hostname و port سیستمی که برای ارسال ایمیلها استفاده میشود. اگر port با ۲۵ متفاوت است، آن را به این شکل اضافه کنید: ‘mail.example.com:۵۰’
- رمزگذاری ایمیل: [Use SSL / Use TLS / No encryption] اگر سرور SMTP ایمیل شما از اتصال امن (SSL/TLS) استفاده میکند و به آن نیاز دارد، این گزینه را فعال کنید.
- From: آدرس ایمیلی که برای ارسال ایمیلها استفاده میشود
- کاربر: اگر سرور ایمیل به authentication نیاز ندارد، این قسمت را خالی بگذارید
- رمز عبور: اگر سرور ایمیل به authentication نیاز ندارد، این قسمت را خالی بگذارید
-
فعال کردن اعلانهای ایمیلی: [Enable/Disable] اعلانهای ایمیلی برای تغییرات test و نتایج test ارسال میشوند. همچنین میتوان آنها را برای هر کاربر بهصورت جداگانه از طریق My Settings غیرفعال کرد.
-
حساب Administrator
اولین حساب کاربری خود را بسازید و license key مربوط به TestRail را وارد کنید.
- نام کامل: برای مثال، John Doe یا Jane Doe
- آدرس ایمیل: برای مثال: john.doe@email.com یا jane.doe@email.com
- رمز عبور / تأیید رمز عبور: رمز عبور را وارد و تأیید کنید
-
License Key: license key نسخه آزمایشی یا کامل خود را جایگذاری کنید
-
تأیید پیکربندی
تنظیمات را مرور کنید و روی Install کلیک کنید تا نصب TestRail نهایی شود.
#
باید background task مربوط به TestRail را فعال کنید. این background task، از جمله، مسئول ارسال اعلانهای ایمیلی برای تغییرات test است؛ البته اگر این قابلیت را فعال کرده باشید. ببینید چطور میتوانید background task مربوط به TestRail را از اینجا فعال کنید.
پس از تکمیل مراحل، در پایان صفحه موفقیت را خواهید دید.
برای شروع استفاده از برنامه، میتوانید روی Log in to TestRail کلیک کنید یا از طریق مرورگر وب به آن دسترسی داشته باشید؛ برای مثال:
http://<server>/testrail
