برای نصب خود برنامه TestRail روی Windows Server، آرشیو نصب TestRail را روی وبسرور آپلود و extract کنید، سپس فایلها را در دایرکتوری wwwroot وبسرور کپی کنید؛ برای مثال: C:\inetpub\wwwroot. همچنین میتوانید در IIS یک virtual directory بسازید و فایلهای TestRail را در مسیر دیگری قرار دهید.
بعد، در مرورگر خود آدرس دایرکتوری جدید TestRail روی وبسرور را وارد کنید تا TestRail Installation Wizard اجرا شود؛ مثلاً http://<server>/testrail/) و دستورالعملها را دنبال کنید.
#
مشکل permission (خطای ۴۰۱)؟ اگر هنگام دسترسی به installer TestRail خطای permission ۴۰۱ دریافت کردید، مطمئن شوید IIS اجازه خواندن و اجرای فایلهای PHP را دارد. برای این کار، روی دایرکتوری testrail در Explorer کلیک راست کنید و Properties را انتخاب کنید، سپس زبانه Security را باز کنید. اگر user مربوط به IIS در فهرست نبود، روی Add کلیک کنید، user مربوط به 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 یا edition دیگری از SQL Server را بهصورت named instance نصب کردهاید، ممکن است هنگام اتصال TestRail به database لازم باشد instance name را هم بهعنوان بخشی از server name وارد کنید. یعنی در صفحه دوم Installation Wizard باید هم hostname و هم instance name را در فیلد Server وارد کنید. برای مثال، برای یک instance محلی SQL Server Express با instance name برابر sqlexpress، مقدار localhost\sqlexpress را وارد کنید.
- برای ادامه، شرایط license را مرور و قبول کنید.
-
تنظیمات Database
درایور MS SQL مناسب database خود را انتخاب کنید. در این راهنما، از منوی کشویی Driver گزینه «MS SQL Server (۲۰۰۸، ۲۰۱۲، ۲۰۱۴ یا ۲۰۱۶)» را انتخاب میکنیم. قبل از ادامه، مقدار همه فیلدهای ضروری این صفحه را وارد کنید.
در این بخش از مقادیر نمونه زیر استفاده شده است؛ هنگام نصب میتوانید مقادیر مناسب محیط خودتان را وارد کنید:
- Server: localhost (hostname). در این مثال، از PC Name استفاده شده و \SQLEXPRESS به انتهای آن اضافه شده است. این اطلاعات در SQL Server Management Studio هم دیده میشود (تصویر زیر). توجه داشته باشید که اطلاعات شما ممکن است متفاوت باشد.
- Database: TestRail (نام database که در SQL Server ساختهاید)
- کاربر: testrail
- رمز عبور: رمز عبوری که هنگام ایجاد Login با نام testrail استفاده کردید
- Server: localhost (hostname). در این مثال، از PC Name استفاده شده و \SQLEXPRESS به انتهای آن اضافه شده است. این اطلاعات در SQL Server Management Studio هم دیده میشود (تصویر زیر). توجه داشته باشید که اطلاعات شما ممکن است متفاوت باشد.
-
تنظیمات Cassandra
نصبکننده از شما میخواهد اطلاعات Cassandra را وارد کنید. این اطلاعات به مقادیری بستگی دارد که هنگام نصب وارد کردهاید.
مقادیر پیشفرض عبارتاند از:- سرور: localhost
- پورت: 9042
- Keyspace: testrail یا نامی که هنگام ایجاد Keyspace وارد کردهاید
- نام کاربری: cassandra یا کاربری که برای TestRail ایجاد کردهاید و به آن مجوز دادهاید
-
رمز عبور: cassandra یا رمز عبوری که برای کاربر ایجادشده تعیین کردهاید
-
تنظیمات RabbitMQ
استفاده از RabbitMQ اختیاری است. اگر میخواهید از برخی قابلیتهای Webhooks استفاده کنید، باید RabbitMQ را پیکربندی کنید. از آنجا که هیچکدام از این فیلدها برای ادامه نصب الزامی نیستند، در صورت تمایل میتوانید به مرحله بعد بروید.
#
برای اطلاعات بیشتر درباره دانلود و نصب RabbitMQ روی سیستمعامل خود، به مستندات رسمی نصب مراجعه کنید.
اگر میخواهید RabbitMQ را پیکربندی کنید، مقادیر پیشفرض به صورت زیر هستند:
- سرور Message Queue: Host name سرور RabbitMQ
- پورت Message Queue: پورت RabbitMQ (به طور پیشفرض ۵۶۷۲)
- کاربر Message Queue: کاربر RabbitMQ مربوط به TestRail. این کاربر باید مجوز مدیریت صفها، از جمله ایجاد و حذف آنها، را داشته باشد
- رمز عبور Message Queue: رمز عبور کاربر RabbitMQ مربوط به TestRail که در بالا وارد شده است
- استفاده از TLS: [فعال/غیرفعال]
- گواهی CA برای Message Queue: گواهی CA برای اتصال به سرور RabbitMQ در صورت استفاده از TLS
- گواهی client برای Message Queue: گواهی client برای اتصال به سرور RabbitMQ در صورت استفاده از TLS
-
کلید خصوصی Message Queue: کلید خصوصی کلاینت (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\» استفاده میکنیم. این دایرکتوری را باید بهصورت دستی ایجاد کنید.
- دایرکتوری log: بهصورت پیشفرض «C:\testrail\logs\» است. این دایرکتوری را باید بهصورت دستی ایجاد کنید.
-
دایرکتوری audit: بهصورت پیشفرض «C:\testrail\audit\» است. این دایرکتوری را باید بهصورت دستی ایجاد کنید.
نصبکننده از شما میخواهد دایرکتوریهایی را برای ذخیره پیوستها، گزارشها و فایلهای 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 غیرفعال کرد.
-
حساب مدیر
اولین حساب کاربری خود را بسازید و license key مربوط به TestRail را وارد کنید.
- نام کامل: برای مثال، John Doe یا Jane Doe
- آدرس ایمیل: برای مثال: john.doe@email.com یا jane.doe@email.com
- رمز عبور / تأیید رمز عبور: رمز عبور را وارد و تأیید کنید
-
License Key: license key نسخه آزمایشی یا کامل خود را اینجا paste کنید
-
تأیید پیکربندی
تنظیمات خود را بررسی کنید و روی Install کلیک کنید تا نصب TestRail نهایی شود.
#
باید background task مربوط به TestRail را فعال کنید. این background task از جمله مسئول ارسال اعلانهای ایمیلی برای تغییرات test است، البته اگر این قابلیت را فعال کرده باشید. برای آشنایی با روش فعالسازی background task در TestRail، اینجا را ببینید.
بعد از کامل کردن مراحل، در پایان صفحه موفقیت را میبینید.
برای شروع استفاده از برنامه، میتوانید روی Log in to TestRail کلیک کنید یا آن را از طریق مرورگر وب خود باز کنید، برای مثال:
http://<server>/testrail
