برای نصب خود برنامه TestRail روی Windows Server، فایل فشرده نصب TestRail را روی web server آپلود و extract کنید و فایلها را در پوشه wwwroot وبسرور کپی کنید؛ برای مثال: C:\inetpub\wwwroot. همچنین میتوانید در IIS یک virtual directory بسازید و فایلهای TestRail را در مسیر دیگری قرار دهید.
سپس برای اجرای TestRail Installation Wizard، در مرورگر خود مسیر پوشه جدید TestRail روی web server را باز کنید؛ برای مثال http://<server>/testrail/ و دستورالعملها را دنبال کنید.
#
مشکل دسترسی (۴۰۱)؟ اگر هنگام دسترسی به نصبکننده TestRail خطای ۴۰۱ permission دریافت کردید، مطمئن شوید IIS میتواند فایلهای PHP را بخواند و اجرا کند. برای این کار، روی پوشه testrail در Explorer کلیک راست کنید و Properties را انتخاب کنید. سپس به تب Security بروید. اگر کاربر IIS در فهرست نبود، روی Add کلیک کنید، کاربر IIS را وارد کنید (در Windows ۲۰۰۸ و نسخههای بعدی IUSR، و در Windows ۲۰۰۳ مقدار IUSR_<hostname> ) و با OK تأیید کنید. سپس permissionهای 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 با نام 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 Server: نام Host سرور RabbitMQ
- Message Queue Port: پورت RabbitMQ (بهطور پیشفرض ۵۶۷۲)
- Message Queue User: کاربر RabbitMQ مربوط به TestRail. این کاربر برای مدیریت queueها (ایجاد/حذف) به مجوز نیاز دارد.
- Message Queue Password: رمز عبور کاربر TestRail RabbitMQ که در بالا مشخص شده است
- Use 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 شما. این آدرس، از جمله برای لینکهای داخل notificationهای ایمیل استفاده میشود. «http://localhost/testrail/» مقدار نمونهای است که در این مستندات استفاده شده است.
- زبان پیشفرض: زبان پیشفرض رابط کاربری را مشخص میکند. کاربران میتوانند زبان خود را از بخش My Settings تغییر دهند.
- locale پیشفرض: مشخص میکند تاریخها و عددها بهصورت پیشفرض با چه قالبی نمایش داده شوند. کاربران میتوانند locale خود را از بخش My Settings تغییر دهند.
- time zone پیشفرض: time zone پیشفرض را برای تاریخها و زمانها مشخص میکند.
- دایرکتوری attachmentها: دایرکتوری روی web server که attachmentهای آپلودشده در آن ذخیره میشوند. این دایرکتوری باید برای TestRail قابل نوشتن باشد و نباید مستقیماً با web browser قابل دسترسی باشد. در این مستند، از «C:\testrail\attachments\» استفاده میکنیم. این دایرکتوری را باید بهصورت دستی ایجاد کنید.
- دایرکتوری reportها: دایرکتوری روی web server که reportهای تولیدشده در آن ذخیره میشوند. این دایرکتوری باید برای TestRail قابل نوشتن باشد و نباید مستقیماً با web browser قابل دسترسی باشد. در این مستند، از «C:\testrail\reports\» استفاده میکنیم. این دایرکتوری را باید بهصورت دستی ایجاد کنید.
- دایرکتوری logها: بهصورت پیشفرض «C:\testrail\logs\» است. این دایرکتوری را باید بهصورت دستی ایجاد کنید.
-
دایرکتوری audit: بهصورت پیشفرض «C:\testrail\audit\» است. این دایرکتوری را باید بهصورت دستی ایجاد کنید.
Installer همچنین از شما میخواهد دایرکتوریهایی را برای ذخیره attachmentها، reportها و فایلهای log مشخص کنید. لطفاً این دایرکتوریها را ایجاد کنید و مطمئن شوید web server میتواند در آنها بنویسد. برای دایرکتوریهای attachment و report، به دلایل امنیتی، باید مطمئن شوید که مستقیماً با web browser قابل دسترسی نباشند. حتماً دایرکتوریای خارج از دایرکتوری wwwroot خود مشخص کنید؛ برای مثال: C:\TestRailAttachments. برای اینکه IIS بتواند در این دایرکتوریها بنویسد، کاربر IUSR را به تنظیمات امنیتی دایرکتوریها اضافه کنید و full permissions را به این کاربر بدهید. در سیستمهای Windows Server ۲۰۰۳، نام این کاربر معمولاً IUSR_<hostname>) است. مطمئن شوید IUSRS مالک این دایرکتوریها باشد:
-
تنظیمات ایمیل
این تنظیمات نیز اختیاری هستند. تنظیمات server برای notificationهای ایمیل استفاده میشوند و همچنین برای قابلیت Forgot Password به کار میروند.
- سرور: hostname و port سیستمی که برای ارسال ایمیل استفاده میشود. اگر port با ۲۵ متفاوت است، آن را به این شکل اضافه کنید: «mail.example.com:۵۰»
- رمزگذاری ایمیل: [Use SSL / Use TLS / No encryption] اگر سرور SMTP ایمیل شما از اتصال امن (SSL/TLS) استفاده میکند و به آن نیاز دارد، این گزینه را فعال کنید.
- From: آدرس ایمیلی که برای ارسال ایمیلها استفاده میشود
- User: اگر سرور ایمیل به authentication نیاز ندارد، این قسمت را خالی بگذارید
- Password: اگر سرور ایمیل به authentication نیاز ندارد، این قسمت را خالی بگذارید
-
فعالسازی notificationهای ایمیل: [Enable/Disable] notificationهای ایمیل برای تغییرات test و نتایج test ارسال میشوند. این گزینه را میتوان برای هر کاربر نیز از طریق My Settings غیرفعال کرد.
-
حساب Administrator
اولین حساب کاربری خود را ایجاد کنید و license key مربوط به TestRail را وارد کنید.
- نام کامل: برای مثال، John Doe یا Jane Doe
- آدرس ایمیل: برای مثال، john.doe@email.com یا jane.doe@email.com
- رمز عبور / تأیید رمز عبور: رمز عبور را وارد و تأیید کنید
-
License Key: license key آزمایشی یا کامل خود را جایگذاری کنید
-
تأیید پیکربندی
تنظیمات خود را بررسی کنید و روی Install کلیک کنید تا TestRail نصب شود.
#
فعالسازی Background Task #
باید background task مربوط به TestRail را فعال کنید. این background task از جمله وظیفه دارد در صورت فعال بودن این قابلیت، اعلانهای ایمیلی مربوط به تغییرات test را ارسال کند. برای آشنایی با روش فعالسازی background task در TestRail، اینجا را ببینید.
پس از تکمیل مراحل، در پایان صفحه موفقیت را میبینید.
بهروزرسانی config.php #
باید مسیر Chrome Headless Shell را در فایل config.php اضافه کنید:
define('TR_CHROME_PATH', 'C:\Program Files\ChromeHeadless');
ورود به TestRail #
برای شروع استفاده از برنامه، روی Log in to TestRail کلیک کنید، یا آن را با مرورگر وب خود باز کنید؛ برای مثال:
http://<server>/testrail
