TestRail ۱۰.۴.۱ برای همه مشتریان Server در دسترس است. مشتریانی که میخواهند به TestRail ۱۰.۴.۱ ارتقا دهند، میتوانند فایلهای نصب را از TestRail Billing Portal دانلود کنند.
دستورالعملهای زیر به شما کمک میکند با نحوه نصب TestRail روی یک سیستم Windows Server آشنا شوید.
این دستورالعملها برای همه نسخههای TestRail Server از ۹.۴.۱ تا ۱۰.۴.۱ کاربرد دارد. برای اطلاعات بیشتر درباره سیستمعاملها و سیستمهای سرور پشتیبانیشده، اینجا را ببینید.
ℹ️ نکته مهم:
از TestRail ۹.۵.۱ Server به بعد، Cassandra رسماً deprecated شده و این محدودیت اعمال میشود.
-
Adminها باید ابتدا اسکریپت deprecated شدن Cassandra را در نسخه ۹.۴.۱ قبل از ارتقا به نسخههای جدیدتر اجرا کنند.
-
اگر این اسکریپت اجرا نشده باشد، ارتقا به نسخههای جدیدتر مسدود میشود و یک پیام هشدار نمایش داده میشود
در طول فرایند ارتقا.👉 لطفاً
مستندات Cassandra Deprecation
را بررسی کنید.
آمادهسازی سرور
#
TestRail به یک web server، یک پایگاه داده SQL یعنی SQL Server، و یک محیط فعال PHP ۸.۳ نیاز دارد که روی سرور نصب شده باشد. در Windows Server، TestRail بهترین عملکرد را با web server مایکروسافت یعنی IIS و PHP پیکربندیشده برای اجرا با FastCGI دارد.
نصب IIS
#
برای نصب IIS روی Windows Server، Server Managerرا اجرا کنید. در Dashboard، زیر Configure This Local Server، روی Add roles and features
کلیک کنید. Role-based or feature-based installation را انتخاب کنید و روی
Next کلیک کنید.
از server pool، server host موردنظر خود را برای نصب IIS انتخاب کنید و روی
Next کلیک کنید. سپس هنگام انتخاب Server Roles، مطمئن شوید
Web Server (IIS) انتخاب شده باشد و زیر
Web Server > Application Development مطمئن شوید CGI هم هم انتخاب شده باشد (اگر از قبل انتخاب نشده است). روی
Install.
#
برای اطلاعات بیشتر، به مستندات رسمی Microsoft مراجعه کنید:
فایلهای رسمی PHP را دانلود کنید با فرمت .zip. از آخرین نسخه موجود ۸.۳ استفاده کنید.
از سال ۲۰۲۳، VS16 x64 Non Thread Safe نسخه پیشنهادی برای دانلود است، چون در مستندات نصب از همین نسخه استفاده میشود.
پس از کامل شدن دانلود، فایلهای فشرده PHP را در مسیر
C:\php\ روی سیستم میزبان استخراج کنید.
بخش Environment Variables را ویرایش کنید و یک متغیر جدید Path در سطح System اضافه کنید: C:\php.
به IIS Manager بروید، روی میزبان سرور کلیک کنید، سپس روی
Handler Mappings و Add Module Mapping کلیک کنید.
در پنجره جدید، همه فیلدها را دقیقاً مطابق اطلاعات نمایشدادهشده در تصویر زیر پر کنید و سپس روی OK کلیک کنید.
در IIS Manager دوباره به میزبان سرور برگردید و این بار روی Default Document کلیک کنید. Add
در پنل Actions.
فیلد Name را با مقدار Index.php پر کنید و روی
OK کلیک کنید. سپس روی Add دوباره کلیک کنید و این بار فیلد Name را با مقدار Default.php پر کنید و روی OK کلیک کنید.
نصب پیشنیازها
#
برای استفاده از TestRail در ویندوز همراه با دیتابیس SQL Server، extensionهای PHP زیر لازم هستند:
- extension مربوط به gd در PHP برای تولید نمودارها
- PHP sqlsrv_81_nts_x64 extension برای دسترسی به دیتابیسهای SQL Server
- extension مربوط به pdo_mysql در PHP برای دسترسی به دیتابیس
- extension مربوط به fileinfo در PHP برای تشخیص نوع فایل و encoding
- extension مربوط به imagick در PHP برای کار با تصاویر
- extension مربوط به mbstring در PHP برای کار با رشتههای Unicode
- extension مربوط به curl در PHP برای بررسی بهروزرسانیها و موارد مشابه
- extension مربوط به openssl در PHP برای مدیریت اتصالهای SSL
- ionCube PHP Loader برای decode کردن فایلهای PHP مربوط به TestRail
دانلود کنید
درایورهای PHP مایکروسافت برای SQL Server را از اینجا، و روی Download Microsoft Drivers for PHP for SQL Server (Windows) کلیک کنید.
قبل از extract کردن فایلها، باید مطمئن شوید نسخه PHP شما از کدام حالت Thread Safety استفاده میکند (ts یا nts)؛ در غیر این صورت نصب درست کار نمیکند. برای اینکه ببینید نسخه شما Thread Safe است یا Not Thread Safe، دستور زیر را وارد کنید:
php -i|find "Thread Safety"پس از extract کردن فایلها، فایلهای Thread Safety متناسب با نسخه خود را پیدا کنید و آنها را در مسیر C:\php\ext\ کپی کنید. برای مثال:
-
- php_pdo_sqlsrv_83_nts_x64.dll
- php_sqlsrv_83_nts_x64.dll
برای نصب این extensionها، خطوط زیر را به فایلهای php.ini خود اضافه کنید:
-
- extension=pdo_sqlsrv_83_nts_x64
- extension=sqlsrv_83_nts_x64
این driver برای کار کردن به نصب ODBC Driver هم نیاز دارد. package متناسب را دانلود و نصب کنید:
بعد از فعال کردن extension در فایل تنظیمات PHP.ini و نصب ODBC Driver، وبسرور IIS را restart کنید. برای بررسی اینکه extension با موفقیت load شده است، میتوانید تابع phpinfo() را اجرا کنید. برای اطمینان از فعال بودن moduleها، میتوانید در Command Prompt دستور php -m را اجرا کنید.
طبق مستندات رسمی نصب extension imagick که در اینجا آمده است عمل کنید.
آخرین extension موردنیاز PHP، ionCube PHP loader رایگان است. میتوانید
ionCube loader مخصوص Windows را از اینجا دانلود کنید.
برای این روش نصب به فایل ioncube_loader_win_8.۳.dll نیاز دارید که با دانلود فایل Windows VC16 (Non-TS) (64 bits) zip با نام ioncube_loaders_win_nonts_vc16_x86-۶۴.zip در دسترس قرار میگیرد. همه فایلها را روی سرور extract کنید و loader extension را در دایرکتوری ext مربوط به PHP کپی کنید؛ این مسیر معمولاً C:\php\ext\ است. سپس با اضافه کردن خط زیر به فایل PHP.ini، extension را فعال کنید. این فایل معمولاً در دایرکتوری نصب PHP قرار دارد، یعنی C:\php\:
zend_extension = "C:\php\ext\ioncube_loader_win_8.3.dll"برای بررسی اینکه ionCube loader extension با موفقیت نصب شده است، دستور php -v را در Windows Command Prompt اجرا کنید. برای اجرای این دستور باید به دایرکتوری نصب PHP بروید.
اگر در خروجی php -v چیزی شبیه نمونه زیر نمایش داده شود، ionCube loader extension با موفقیت نصب شده است. به خط ionCube PHP Loader توجه کنید:
PHP 8.3.2 (cli) (built: Jan 16 2026 10:12:45) (NTS Visual C++ 2019 x64)
Copyright (c) The PHP Group
Zend Engine v4.3.2, Copyright (c) Zend Technologies
with the ionCube PHP Loader v13.0.2, Copyright (c) 2002-2026, by ionCube Ltd.
#
برای اینکه IIS بتواند extension را load کند، ممکن است لازم باشد permission فایل extension مربوط به ionCube را تغییر دهید. برای این کار، در Explorer روی فایل راستکلیک کنید، Properties را بزنید، تب Security را انتخاب کنید و گروه Users را اضافه کنید.
بیشتر extensionها باید بهصورت خودکار اضافه شوند، بهجز مراحل IonCube و imagick. اگر PHP را دستی نصب کردهاید، ممکن است لازم باشد extensionهای موردنیاز را در فایل PHP.ini به این شکل فعال کنید:
zend_extension = "C:\php\ext\ioncube_loader_win_8.3.dll"
extension=gd
extension=fileinfo
extension=imagick
extension=mbstring
extension=curl
extension=openssl
extension=pdo_sqlsrv_83_nts_x64
extension=sqlsrv_83_nts_x64برای reload کردن PHP، وبسرور IIS را restart کنید. سادهترین راه این است که سرویس World Wide Web Publishing Windows را restart کنید. برای این کار، برنامه Services را از Administrative Tools باز کنید و سرویس را restart کنید. توجه داشته باشید که با این کار همه IIS application poolها و وبسایتها restart میشوند. اگر وبسایتها یا applicationهای دیگری هم روی این سرور host میکنید، بهتر است فقط application pool مربوطه را restart کنید.
نصب dependency مربوط به Chrome Headless Shell برای Reports #
- نصب dependencyها – مطمئن شوید سیستم شما قابلیت extract کردن فایلهای ZIP را دارد.
-
دانلود دستی Chrome Headless Shell – وبسایت
Chrome for Testing
را در مرورگر باز کنید و آخرین نسخه stable را دانلود کنید - Extract کردن فایل – روی فایل .zip راستکلیک کنید و گزینه Extract All را انتخاب کنید
- انتقال به محل دلخواه – پوشه extractشده را به هر مسیری که میخواهید منتقل کنید، مثل C:\Program Files\ChromeHeadless. مسیر محل انتقال binary را یادداشت کنید، چون باید این path را به تنظیمات TestRail اضافه کنید.
