دسته‌ها را مشاهده کنید

نصب TestRail (ویندوز)

مدت زمان مطالعه: : 6 دقیقه

ℹ️ نکته مهم:

از TestRail ۹.۵.۱ Server به بعد، Cassandra رسماً منسوخ شده و این محدودیت اعمال می‌شود:

  • ادمین‌ها ابتدا باید اسکریپت منسوخ‌سازی Cassandra را در نسخه ۹.۴.۱ قبل از
    ارتقا به نسخه‌های جدیدتر اجرا کنند.

  • اگر این اسکریپت اجرا نشده باشد، ارتقا به نسخه‌های جدیدتر
    مسدود
    می‌شود و یک پیام هشدار نمایش داده می‌شود 
    در طول فرایند ارتقا.

    👉 لطفاً
    مستندات منسوخ‌سازی Cassandra
    را بررسی کنید.

برای نصب خود برنامه TestRail روی Windows Server، فایل آرشیو نصب TestRail را روی web server خود آپلود
و
extract
کنید و فایل‌ها را
در
دایرکتوری wwwroot وب‌سرور خود کپی کنید (برای مثال، C:\inetpub\wwwroot). همچنین می‌توانید
یک virtual directory در IIS بسازید و فایل‌های TestRail را
در محل دیگری
نصب کنید.

سپس در مرورگر خود به دایرکتوری جدید TestRail روی web server بروید
تا TestRail Installation Wizard اجرا شود (برای مثال http://<server>/testrail/)
و دستورالعمل‌ها را دنبال کنید.

 
#

مشکل دسترسی (۴۰۱)؟ اگر هنگام تلاش برای دسترسی به installer TestRail با خطای دسترسی ۴۰۱
روبه‌رو شدید، مطمئن شوید که IIS
می‌تواند فایل‌های PHP را
بخواند
و اجرا کند. برای این کار، در Explorer ، روی دایرکتوری testrail راست‌کلیک کنید 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 (یا نسخه دیگری از SQL Server) را به‌صورت named instance نصب کرده‌اید، ممکن است هنگام اتصال TestRail به database لازم باشد نام instance را هم به‌عنوان بخشی از نام server وارد کنید. یعنی در صفحه دوم ویزارد نصب، باید هم hostname و هم نام instance را در فیلد Server  وارد کنید. برای مثال، برای یک SQL Server Express محلی با نام instance برابر sqlexpress، مقدار localhost\sqlexpress را وارد کنید.

 

  1. برای ادامه، شرایط license را بررسی و قبول کنید
    image3.png

  2. تنظیمات database

    درایور MS SQL مناسب برای database خود را انتخاب کنید. در این راهنما، از منوی کشویی Driver گزینه «MS SQL Server (۲۰۰۸، ۲۰۱۲، ۲۰۱۴ یا ۲۰۱۶)» را انتخاب می‌کنیم. قبل از ادامه، مقدار همه فیلدهای ضروری این صفحه را وارد کنید.

    در اینجا از مقادیر نمونه زیر استفاده شده است؛ شما می‌توانید هنگام نصب، مقادیر موردنظر خودتان را وارد کنید:

    • Server: localhost (hostname). در این مثال، از نام PC استفاده شده و ‎\SQLEXPRESS به انتهای آن اضافه شده است. این اطلاعات در SQL Server Management Studio هم نمایش داده می‌شود (تصویر زیر). توجه داشته باشید که اطلاعات شما متفاوت خواهد بود.
      image12.png
    • Database: TestRail (نام database که در SQL Server ساخته‌اید)
    • User: testrail
    • Password: رمز عبوری که هنگام ساخت Login با نام «testrail» استفاده کردید

    image9.png

  3. تنظیمات RabbitMQ

    استفاده از RabbitMQ اختیاری است. اگر می‌خواهید از برخی قابلیت‌های Webhooks استفاده کنید، باید RabbitMQ را پیکربندی کنید. چون هیچ‌کدام از این فیلدها برای ادامه نصب الزامی نیست، در صورت تمایل می‌توانید به مرحله بعد بروید.

     
    #

    برای اطلاعات بیشتر درباره دانلود و نصب RabbitMQ روی سیستم‌عامل خود،
     به مستندات رسمی نصب مراجعه کنید.

    اگر می‌خواهید RabbitMQ را پیکربندی کنید، مقادیر پیش‌فرض به این صورت است:

    • Message Queue Server: hostname سرور 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 استفاده می‌کنید
    • گواهی client برای Message Queue: گواهی client برای اتصال به سرور RabbitMQ، در صورتی که از TLS استفاده می‌کنید
    • کلید خصوصی Message Queue: کلید خصوصی client (PK) برای اتصال به سرور RabbitMQ، در صورتی که از TLS استفاده می‌کنید
      image6.png

  4. تنظیمات برنامه

    • نام نصب: نام این نصب TestRail. این نام در صفحه ورود و داشبورد نمایش داده می‌شود.
    • آدرس وب: آدرس وب نصب TestRail شما. از این آدرس، از جمله برای لینک‌های اعلان‌های ایمیلی استفاده می‌شود. مقدار نمونه «http://localhost/testrail/» در این مستندات استفاده شده است.
    • زبان پیش‌فرض: زبان پیش‌فرض رابط کاربری را مشخص می‌کند. کاربران می‌توانند زبان خود را از بخش My Settings تغییر دهند.
    • Locale پیش‌فرض: مشخص می‌کند تاریخ‌ها و عددها به‌طور پیش‌فرض چگونه قالب‌بندی شوند. کاربران می‌توانند locale خود را از بخش My Settings تغییر دهند.
    • منطقه زمانی پیش‌فرض: منطقه زمانی پیش‌فرض را برای تاریخ‌ها و زمان‌ها مشخص می‌کند.
    • دایرکتوری پیوست‌ها: دایرکتوری روی وب‌سرور که پیوست‌های آپلودشده در آن ذخیره می‌شوند. TestRail باید بتواند در این دایرکتوری بنویسد و این دایرکتوری نباید مستقیماً از طریق مرورگر وب در دسترس باشد. در این سند از «C:\testrail\attachments\» استفاده می‌کنیم. شما باید این دایرکتوری را به‌صورت دستی ایجاد کنید.
    • دایرکتوری گزارش‌ها: دایرکتوری روی وب‌سرور که گزارش‌های تولیدشده در آن ذخیره می‌شوند. TestRail باید بتواند در این دایرکتوری بنویسد و این دایرکتوری نباید مستقیماً از طریق مرورگر وب در دسترس باشد. در این سند از «C:\testrail\reports\» استفاده می‌کنیم. شما باید این دایرکتوری را به‌صورت دستی ایجاد کنید.
    • دایرکتوری log: به‌طور پیش‌فرض «C:\testrail\logs\» است. شما باید این دایرکتوری را به‌صورت دستی ایجاد کنید.
    • دایرکتوری Audit: به‌طور پیش‌فرض «C:\testrail\audit\» است. شما باید این دایرکتوری را به‌صورت دستی ایجاد کنید.
      image7.png
      installer همچنین از شما می‌خواهد دایرکتوری‌هایی را برای ذخیره پیوست‌ها، گزارش‌ها و فایل‌های log مشخص کنید. این دایرکتوری‌ها را ایجاد کنید و مطمئن شوید وب‌سرور اجازه نوشتن در آن‌ها را دارد. برای دایرکتوری‌های پیوست و گزارش، به دلایل امنیتی باید مطمئن شوید که مستقیماً از طریق مرورگر وب در دسترس نیستند. حتماً دایرکتوری‌ای خارج از wwwroot انتخاب کنید، برای مثال C:\TestRailAttachments. برای اینکه IIS بتواند در این دایرکتوری‌ها بنویسد، کاربر IUSR را به تنظیمات امنیتی دایرکتوری‌ها اضافه کنید و به این کاربر دسترسی کامل بدهید. در سیستم‌های Windows Server ۲۰۰۳، نام این کاربر معمولاً IUSR_<hostname>است. مطمئن شوید IUSRS مالک این دایرکتوری‌هاست:
      permissions_for_logs.png

  5. تنظیمات ایمیل

    این تنظیمات نیز اختیاری هستند. تنظیمات سرور برای اعلان‌های ایمیلی استفاده می‌شوند و همچنین برای قابلیت «Forgot Password». 

    • سرور: hostname و پورت دستگاهی که برای ارسال ایمیل استفاده می‌شود. اگر پورت متفاوت از ۲۵ است، آن را به این شکل اضافه کنید: «mail.example.com:۵۰»
    • رمزگذاری ایمیل: [Use SSL / Use TLS / No encryption] اگر سرور SMTP ایمیل شما از اتصال امن (SSL/TLS) استفاده می‌کند و به آن نیاز دارد، این گزینه را فعال کنید.
    • From: آدرس ایمیلی که برای ارسال ایمیل‌ها استفاده می‌شود
    • کاربر: اگر سرور ایمیل به احراز هویت نیاز ندارد، این فیلد را خالی بگذارید
    • رمز عبور: اگر سرور ایمیل به احراز هویت نیاز ندارد، این قسمت را خالی بگذارید.
    • فعال کردن اعلان‌های ایمیل: [فعال/غیرفعال] اعلان‌های ایمیل برای تغییرات تست و نتایج تست ارسال می‌شوند. همچنین می‌توانید این گزینه را برای هر کاربر به‌صورت جداگانه از بخش «My Settings» غیرفعال کنید.
      image11.png

  6. حساب Administrator

    اولین حساب کاربری خود را بسازید و license key مربوط به TestRail را وارد کنید.

    • نام کامل: برای مثال، John Doe یا Jane Doe
    • آدرس ایمیل: برای مثال: john.doe@email.com یا jane.doe@email.com
    • رمز عبور / تأیید رمز عبور: رمز عبور را وارد و تأیید کنید.
    • License Key: license key نسخه آزمایشی یا کامل خود را جای‌گذاری کنید.
      image5.png

  7. تأیید پیکربندی

    تنظیمات خود را بررسی کنید و روی Install کلیک کنید تا TestRail نصب شود.
    image8.png

 
#

فعال کردن Background Task #

باید background task مربوط به TestRail را فعال کنید. این background task، در کنار کارهای دیگر، اگر این قابلیت را فعال کرده باشید، مسئول ارسال اعلان‌های ایمیل برای تغییرات تست است. برای آشنایی با روش
فعال کردن 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

 

به‌روزرسانی شده در ۱۴۰۵-۰۴-۱۷

احساسات شما چیست؟

  • خوشحال
  • عادی
  • ناراحت

دیدگاهتان را بنویسید