برای نصب خود برنامه 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 را وارد کنید
- برای ادامه، شرایط مجوز را بررسی و قبول کنید
-
تنظیمات پایگاه داده
درایور مناسب MS SQL را برای database خود انتخاب کنید. در این راهنما، گزینه «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 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: کلید خصوصی کلاینت (PK) برای اتصال به سرور RabbitMQ، در صورت استفاده از TLS
-
تنظیمات برنامه
- نام نصب: نام این نصب TestRail. این نام در صفحه ورود و داشبورد نمایش داده میشود.
- آدرس وب: آدرس وب نصب TestRail شما. از این آدرس، از جمله برای لینکهای موجود در اعلانهای ایمیلی استفاده میشود. «http://localhost/testrail/» مقدار نمونهای است که در این مستندات استفاده شده است.
- زبان پیشفرض: زبان پیشفرض رابط کاربری را تعیین میکند. کاربران میتوانند زبان خود را از بخش My Settings تغییر دهند.
- Locale پیشفرض: نحوه قالببندی تاریخها و عددها را بهصورت پیشفرض تعیین میکند. کاربران میتوانند Locale خود را از بخش My Settings تغییر دهند.
- منطقه زمانی پیشفرض: منطقه زمانی پیشفرض برای تاریخها و زمانها را تعیین میکند.
- دایرکتوری پیوستها: دایرکتوری روی وبسرور که پیوستهای آپلودشده در آن ذخیره میشوند. TestRail باید امکان نوشتن در این دایرکتوری را داشته باشد و این مسیر نباید مستقیماً از طریق مرورگر وب در دسترس باشد. در این سند از «C:\testrail\attachments\» استفاده میکنیم (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
- دایرکتوری گزارشها: دایرکتوری روی وبسرور که گزارشهای تولیدشده در آن ذخیره میشوند. TestRail باید امکان نوشتن در این دایرکتوری را داشته باشد و این مسیر نباید مستقیماً از طریق مرورگر وب در دسترس باشد. در این سند از «C:\testrail\reports\» استفاده میکنیم (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
- دایرکتوری لاگ: بهصورت پیشفرض «C:\testrail\logs\» است (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
-
دایرکتوری حسابرسی: بهصورت پیشفرض «C:\testrail\audit\» است (باید این دایرکتوری را بهصورت دستی ایجاد کنید).
نصبکننده همچنین از شما میخواهد دایرکتوریهایی را برای ذخیره پیوستها، گزارشها و فایلهای لاگ مشخص کنید. این دایرکتوریها را ایجاد کنید و مطمئن شوید وبسرور امکان نوشتن در آنها را دارد. برای دایرکتوریهای پیوست و گزارش، به دلایل امنیتی باید مطمئن شوید که مستقیماً از طریق مرورگر وب در دسترس نیستند. حتماً دایرکتوریای خارج از دایرکتوری 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) استفاده میکند و به آن نیاز دارد، این گزینه را فعال کنید.
- فرستنده: آدرس ایمیلی که برای ارسال ایمیلها استفاده میشود
- کاربر: اگر سرور ایمیل به احراز هویت نیاز ندارد، این فیلد را خالی بگذارید
- رمز عبور: اگر سرور ایمیل به احراز هویت نیاز ندارد، این فیلد را خالی بگذارید
-
فعالسازی اعلانهای ایمیلی: [Enable/Disable] اعلانهای ایمیلی برای تغییرات تست و نتایج تست ارسال میشوند. همچنین میتوان آنها را برای هر کاربر از طریق My Settings غیرفعال کرد.
-
حساب کاربری مدیر
اولین حساب کاربری خود را بسازید و 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، در کنار کارهای دیگر، اگر این قابلیت را فعال کرده باشید، اعلانهای ایمیلی مربوط به تغییرات تستها را ارسال میکند. در این راهنما میتوانید روش فعالسازی background task در TestRail را ببینید.
بعد از انجام این مراحل، در پایان صفحهای با پیام موفقیت میبینید.
برای شروع استفاده از برنامه، روی Log in to TestRail کلیک کنید یا آن را در مرورگر وب خود باز کنید؛ برای مثال:
http://<server>/testrail
