TestRail ۹.۸.۱ برای همه مشتریان Server در دسترس است. مشتریانی که میخواهند به TestRail ۹.۸.۱ ارتقا دهند، میتوانند فایلهای نصب را از TestRail Billing Portal دانلود کنند.
راهنمای زیر به شما کمک میکند با روش نصب TestRail روی سیستم Windows Server آشنا شوید. این دستورالعملها برای همه نسخههای TestRail Server از ۹.۴.۱ تا ۹.۸.۱ کاربرد دارد. میتوانید اطلاعات بیشتری درباره سیستمعاملها و سیستمهای سرور پشتیبانیشده را اینجا ببینید.
ℹ️ نکته مهم:
از TestRail ۹.۵.۱ Server به بعد، Cassandra رسما deprecated شده و این محدودیت اعمال میشود.
-
Adminها باید ابتدا اسکریپت deprecation مربوط به Cassandra را در نسخه ۹.۴.۱ قبل از
ارتقا به نسخههای جدیدتر اجرا کنند. -
اگر این اسکریپت اجرا نشده باشد، ارتقا به نسخههای
جدیدتر
مسدود
میشود و یک پیام هشدار نمایش داده میشود
در طول فرایند ارتقا.👉 لطفا
مستندات Cassandra Deprecation
را بررسی کنید.
XAMPP. در عوض، برای محیطهای ویندوز پیشنهاد میکنیم از IIS، PHP با FastCGI و SQL Server استفاده کنید تا بهترین عملکرد و پایداری را داشته باشید؛ همانطور که در ادامه توضیح داده شده است. گزینه جایگزین، استفاده از Linux، Apache و MySQL است، اما هر دو محیط به یک اندازه خوب کار میکنند.
آمادهسازی سرور
#
TestRail نیاز دارد که یک web server، یک SQL database یا 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، میزبان سروری را که میخواهید IIS روی آن نصب شود انتخاب کنید و
روی
Next کلیک کنید. سپس هنگام انتخاب Server Roles، مطمئن شوید که
Web Server (IIS) انتخاب شده باشد و زیر
وب سرور > توسعه اپلیکیشن مطمئن شوید CGI هم انتخاب شده باشد (اگر از قبل انتخاب نشده است). روی
Install.
#
برای اطلاعات بیشتر، به مستندات رسمی Microsoft مراجعه کنید:
فایلهای رسمی PHP را دانلود کنید با فرمت .zip. از آخرین نسخه ۸.۱ موجود استفاده کنید.
تا سال ۲۰۲۳، VS16 x64 Non Thread Safe نسخه پیشنهادی برای دانلود است، چون در مستندات نصب از همین نسخه استفاده میشود.
پس از پایان دانلود، فایلهای فشرده PHP را در مسیر
C:\php\ روی سیستم میزبان استخراج کنید.
بخش Environment Variables را ویرایش کنید و یک variable جدید از نوع System به Path اضافه کنید: C:\php.
به IIS Manager بروید، روی server host کلیک کنید و سپس روی
Handler Mappings و Add Module Mapping کلیک کنید.
در پنجره جدید، همه فیلدها را دقیقاً با اطلاعاتی که در تصویر زیر نشان داده شده است پر کنید و سپس روی OK کلیک کنید.
در IIS Manager به server host برگردید و این بار روی Default Document کلیک کنید. Add
را در پنل Actions انتخاب کنید.
در فیلد Name وارد کنید: Index.php و روی
OK کلیک کنید. سپس روی Add دوباره کلیک کنید و این بار در فیلد Name وارد کنید: Default.php و روی OK کلیک کنید.
#
دستورالعملهای
اجرای PHP info diagnostics و بررسی PHP Version را دنبال کنید.
نصب پیشنیازها
#
برای استفاده از TestRail در Windows همراه با دیتابیس 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 Microsoft drivers for 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_81_nts_x64.dll
- php_sqlsrv_81_nts_x64.dll
برای نصب این extensionها، موارد زیر را به فایلهای php.ini خود اضافه کنید:
-
- extension=pdo_sqlsrv_81_nts_x64
- extension=sqlsrv_81_nts_x64
این driver همچنین به نصب ODBC Driver نیاز دارد. پکیج متناسب را دانلود و نصب کنید:
بعد از فعال کردن extension در فایل پیکربندی PHP.ini و نصب ODBC Driver، وبسرور IIS را restart کنید. برای بررسی اینکه extension با موفقیت load شده است، میتوانید از روش زیر استفاده کنید: اجرای تابع phpinfo(). همچنین میتوانید در Command Prompt دستور php -m را اجرا کنید تا مطمئن شوید moduleها فعال هستند.
طبق مستندات رسمی نصب imagick extension که در اینجا آمده است عمل کنید.
آخرین PHP extension موردنیاز، 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.1.dll"برای بررسی اینکه ionCube Loader extension با موفقیت نصب شده است، دستور php -v را در Windows Command Prompt اجرا کنید. برای اجرای این دستور باید ابتدا به دایرکتوری نصب PHP بروید.
اگر خروجی php -v چیزی شبیه نمونه زیر باشد، ionCube Loader extension با موفقیت نصب شده است. به خط ionCube PHP Loader توجه کنید:
PHP 8.1.14 (cli) (built: Jan 4 2023 12:24:57) (NTS Visual C++ 2019 x64)
Copyright (c) The PHP Group
Zend Engine v4.1.14, Copyright (c) Zend Technologies
with the ionCube PHP Loader v12.0.5, Copyright (c) 2002-2022, 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.1.dll"
extension=gd
extension=fileinfo
extension=imagick
extension=mbstring
extension=curl
extension=openssl
extension=pdo_sqlsrv_81_nts_x64
extension=sqlsrv_81_nts_x64برای reload کردن PHP، وبسرور IIS را restart کنید. سادهترین روش، restart کردن سرویس World Wide Web Publishing Windows است. برای این کار، برنامه 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 اضافه کنید.
