برای نصب خود برنامه 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 را بخواند و اجرا کند. برای این کار، پوشه testrail را در File Explorer راستکلیک کنید و Properties را باز کنید؛ سپس تب Security را انتخاب کنید. اگر کاربر IIS در فهرست نبود، روی Add کلیک کنید، کاربر IIS را وارد کنید (IUSR در Windows ۲۰۰۸ و نسخههای بعدی، و IUSR_<hostname> در Windows ۲۰۰۳)، سپس با 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
Driver مناسب MS SQL را برای database خود انتخاب کنید. در این راهنما، گزینه «MS SQL Server (۲۰۰۸، ۲۰۱۲، ۲۰۱۴ یا ۲۰۱۶)» را از منوی کشویی Driver انتخاب میکنیم. قبل از ادامه، مقدار همه فیلدهای الزامی این صفحه را وارد کنید.
در این مثال از مقادیر زیر استفاده شده است (در زمان نصب میتوانید مقادیر موردنظر خودتان را وارد کنید):
- 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 Server: نام host سرور RabbitMQ
- Message Queue Port: پورت RabbitMQ که بهصورت پیشفرض ۵۶۷۲ است
- Message Queue User: کاربر RabbitMQ مربوط به TestRail. این کاربر برای مدیریت queueها، از جمله ایجاد و حذف آنها، به مجوز نیاز دارد.
- Message Queue Password: رمز عبوری که برای کاربر RabbitMQ مربوط به TestRail در بالا استفاده شده است
- استفاده از TLS: [فعال/غیرفعال]
- 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\» استفاده میکنیم. شما باید این دایرکتوری را بهصورت دستی ایجاد کنید.
- دایرکتوری log: بهصورت پیشفرض «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: آدرس ایمیلی که برای ارسال ایمیلها استفاده میشود
- User: اگر سرور ایمیل به authentication نیاز ندارد، این قسمت را خالی بگذارید
- Password: اگر سرور ایمیل به authentication نیاز ندارد، این قسمت را خالی بگذارید
-
فعالسازی اعلانهای ایمیلی: [Enable/Disable] اعلانهای ایمیلی برای تغییرات test و نتایج test ارسال میشوند. این اعلانها را میتوان برای هر کاربر نیز از طریق My Settings غیرفعال کرد.
-
حساب مدیر
اولین حساب کاربری خود را بسازید و کلید لایسنس TestRail را وارد کنید.
- نام کامل: برای مثال، John Doe یا Jane Doe
- آدرس ایمیل: برای مثال: john.doe@email.com یا jane.doe@email.com
- رمز عبور / تأیید رمز عبور: رمز عبور را وارد و تأیید کنید
-
کلید لایسنس: کلید لایسنس آزمایشی یا کامل خود را جایگذاری کنید
-
تأیید پیکربندی
تنظیمات را بررسی کنید و روی Install کلیک کنید تا نصب TestRail تکمیل شود.
#
باید background task مربوط به TestRail را فعال کنید. این background task، در کنار کارهای دیگر، اگر این قابلیت فعال باشد، اعلانهای ایمیلی مربوط به تغییرات تستها را ارسال میکند. برای یادگیری نحوه فعالسازی background task TestRail، اینجا را ببینید.
پس از انجام مراحل، در پایان صفحهای با پیام موفقیت میبینید.
میتوانید استفاده از برنامه را با کلیک روی Log in to TestRail یا با باز کردن آن در مرورگر وب شروع کنید؛ برای مثال:
http://<server>/testrail
