برای نصب خود برنامه TestRail روی Windows Server، فایل آرشیو نصب TestRail را روی وب سرور آپلود و extract کنید، سپس فایلها را در پوشه wwwroot وب سرور کپی کنید؛ مثلا C:\inetpub\wwwroot. همچنین میتوانید در IIS یک virtual directory بسازید و فایلهای TestRail را در مسیر دیگری قرار دهید.
در مرحله بعد، در مرورگر خود آدرس پوشه جدید TestRail روی وب سرور را وارد کنید تا TestRail Installation Wizard اجرا شود؛ مثلا http://<server>/testrail/) و مراحل را دنبال کنید.
#
مشکل دسترسی (۴۰۱)؟ اگر هنگام باز کردن TestRail installer خطای ۴۰۱ گرفتید، مطمئن شوید IIS امکان خواندن و اجرای فایلهای PHP را دارد. برای این کار، در File 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 به پایگاه داده لازم باشد نام instance را هم بهعنوان بخشی از server name وارد کنید. یعنی در صفحه دوم Installation Wizard باید هم hostname و هم instance name را در فیلد Server وارد کنید. مثلا برای یک SQL Server Express محلی با instance name برابر با sqlexpress، مقدار localhost\sqlexpress را وارد کنید.
- برای ادامه، شرایط مجوز را مرور و قبول کنید.
-
تنظیمات پایگاه داده
درایور مناسب MS SQL را برای پایگاه داده خود انتخاب کنید. در این راهنما، از منوی Driver گزینه “MS SQL Server (۲۰۰۸, ۲۰۱۲, ۲۰۱۴, or ۲۰۱۶)” را انتخاب میکنیم. پیش از ادامه، مقدار همه فیلدهای اجباری این صفحه را وارد کنید.
در این بخش از مقادیر نمونه زیر استفاده شده است (در زمان نصب میتوانید مقادیر مورد نظر خودتان را وارد کنید):
- Server: localhost (hostname). در این مثال از PC Name استفاده شده و \SQLEXPRESS به آن اضافه شده است. این اطلاعات را میتوانید در SQL Server Management Studio هم ببینید (تصویر زیر). توجه کنید که مقادیر شما ممکن است متفاوت باشد.
- Database: TestRail (نام database که در SQL Server ساختهاید)
- User: testrail
- Password: رمز عبوری که هنگام ایجاد Login با نام «testrail» استفاده کردید
- Server: localhost (hostname). در این مثال از PC Name استفاده شده و \SQLEXPRESS به آن اضافه شده است. این اطلاعات را میتوانید در SQL Server Management Studio هم ببینید (تصویر زیر). توجه کنید که مقادیر شما ممکن است متفاوت باشد.
-
تنظیمات Cassandra
نصبکننده از شما میخواهد اطلاعات 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: [فعال/غیرفعال]
- Message Queue CA Certificate: گواهی CA برای اتصال به سرور RabbitMQ در صورت استفاده از TLS
- Message Queue Client Certificate: گواهی client برای اتصال به سرور RabbitMQ در صورت استفاده از TLS
-
Message Queue Private Key: کلید خصوصی کلاینت (PK) برای اتصال به سرور RabbitMQ در صورت استفاده از TLS
-
تنظیمات Application
- نام نصب: نام این نصب TestRail. نام نصب در صفحه ورود و dashboard نمایش داده میشود.
- آدرس وب: آدرس وب نصب TestRail شما. این آدرس، از جمله برای لینکهای داخل اعلانهای ایمیلی استفاده میشود. «http://localhost/testrail/» مقدار نمونهای است که در این مستندات استفاده شده است.
- زبان پیشفرض: زبان پیشفرض رابط کاربری را تعیین میکند. کاربران میتوانند زبان خود را از بخش My Settings تغییر دهند.
- Locale پیشفرض: تعیین میکند تاریخها و اعداد بهصورت پیشفرض چگونه قالببندی شوند. کاربران میتوانند locale خود را از بخش My Settings تغییر دهند.
- منطقه زمانی پیشفرض: منطقه زمانی پیشفرض برای تاریخها و زمانها را تعیین میکند.
- دایرکتوری پیوستها: دایرکتوری روی web server که پیوستهای آپلودشده در آن ذخیره میشوند. این دایرکتوری باید برای TestRail قابل نوشتن باشد و نباید مستقیماً از طریق web browser قابل دسترسی باشد. در این سند از «C:\testrail\attachments\» استفاده میکنیم (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
- دایرکتوری گزارشها: دایرکتوری روی web server که گزارشهای تولیدشده در آن ذخیره میشوند. این دایرکتوری باید برای TestRail قابل نوشتن باشد و نباید مستقیماً از طریق web browser قابل دسترسی باشد. در این سند از «C:\testrail\reports\» استفاده میکنیم (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
- دایرکتوری لاگها: بهصورت پیشفرض «C:\testrail\logs\» است (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
-
دایرکتوری audit: بهصورت پیشفرض «C:\testrail\audit\» است (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
installer همچنین از شما میخواهد دایرکتوریهایی را برای ذخیره پیوستها، گزارشها و فایلهای لاگ مشخص کنید. لطفاً این دایرکتوریها را ایجاد کنید و مطمئن شوید web server اجازه نوشتن در آنها را دارد. برای دایرکتوریهای پیوست و گزارش، به دلایل امنیتی باید مطمئن شوید که مستقیماً از طریق web browser قابل دسترسی نیستند. حتماً دایرکتوریای خارج از دایرکتوری 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: آدرس ایمیلی که برای ارسال ایمیلها استفاده میشود
- کاربر: اگر سرور ایمیل به احراز هویت نیاز ندارد، این فیلد را خالی بگذارید
- رمز عبور: اگر سرور ایمیل به احراز هویت نیاز ندارد، این فیلد را خالی بگذارید
-
فعال کردن اعلانهای ایمیلی: [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 نسخه آزمایشی یا کامل خود را paste کنید
-
تأیید پیکربندی
تنظیمات خود را بررسی کنید و روی Install کلیک کنید تا TestRail نصب شود.
#
باید background task مربوط به TestRail را فعال کنید. این background task از جمله مسئول ارسال email notification برای تغییرات test است، البته اگر این قابلیت را فعال کرده باشید. برای آشنایی با نحوه فعالسازی background task در TestRail، این بخش را ببینید.
بعد از کامل کردن مراحل، در پایان صفحه موفقیت را خواهید دید.
برای شروع استفاده از برنامه، روی Log in to TestRail کلیک کنید یا با مرورگر وب خود به آن دسترسی پیدا کنید؛ برای مثال:
http://<server>/testrail
