برای نصب خودِ برنامه TestRail روی Windows Server، فایل آرشیو نصب TestRail را روی وب سرور بارگذاری و از حالت فشرده خارج کنید و فایلها را در پوشه wwwroot وب سرور کپی کنید (مثلاً C:\inetpub\wwwroot). همچنین میتوانید در IIS یک virtual directory بسازید و فایلهای TestRail را در مسیر دیگری قرار دهید.
بعد، در مرورگر خود آدرس پوشه جدید TestRail روی وب سرور را باز کنید تا TestRail Installation Wizard اجرا شود (مثلاً http://<server>/testrail/) و دستورالعملها را دنبال کنید.
#
مشکل دسترسی (۴۰۱)؟ اگر هنگام باز کردن installer TestRail خطای دسترسی ۴۰۱ دریافت کردید، مطمئن شوید IIS بتواند فایلهای PHP را بخواند و اجرا کند. برای این کار، روی پوشه testrail در Explorer راستکلیک کنید و گزینه 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 با نام instance برابر با sqlexpress، مقدار localhost\sqlexpress را وارد کنید.
- برای ادامه، شرایط license را بررسی و قبول کنید.
-
تنظیمات پایگاه داده
درایور مناسب MS SQL را برای پایگاه داده خود انتخاب کنید. در این راهنما، گزینه «MS SQL Server (۲۰۰۸, ۲۰۱۲, ۲۰۱۴, or ۲۰۱۶)» را از منوی کشویی 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: نام میزبان سرور 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: private key کلاینت (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 و پورت دستگاهی که برای ارسال ایمیلها استفاده میشود. اگر پورت با ۲۵ متفاوت است، آن را به این شکل اضافه کنید: «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
