ارتقا TestRail از ۷.۵.۳ به ۸.۰.۱ در ویندوز

در زیر، اطلاعاتی در مورد نحوه ارتقاء نصب موجود TestRail به نسخه جدید (۷.۵.۳ به ۸.۰.۱) خواهید دید. لطفاً این مراحل را دنبال کنید تا نصب TestRail خود را ارتقا دهید.

از TestRail ۸.۰.۱، PHP ۷.۴ دیگر پشتیبانی نمی‌شود. می توانید یاد بگیرید چگونه PHP را در اینجا ارتقا دهیم.

پشتیبان گیری #

به شدت توصیه می شود از فایل های نصب TestRail و پایگاه داده TestRail خود نسخه پشتیبان تهیه کنید قبل از ارتقا به نسخه جدیدتر در صورتی که مشکلی در ارتقا وجود داشته باشد، یک نسخه پشتیبان تنها راه برای برگرداندن تغییرات و بازگشت به نصب قبلی (در حال کار) است. توصیه می کنیم به طور منظم از نصب و پایگاه داده TestRail خود، به خصوص قبل از ارتقاء به نسخه جدیدتر، نسخه پشتیبان تهیه کنید.

الزامات #

قبل از ادامه ارتقاء به TestRail، لطفاً آن را بررسی کنید مستندات مورد نیاز و دستورالعمل های خاص عملیاتی (ویندوز/لینوکس). وابستگی های نرم افزاری مانند PHP و SQL می توانند در طول زمان تغییر کنند، بنابراین مهم است که قبل از به روز رسانی نرم افزار TestRail، این الزامات را مرور کنید.

ارتقاء وابستگی ها #

PHP 8.1 #

TestRail ۸.۰ به PHP ۸.۱ نیاز دارد.  اولین قدم در این ارتقا، نصب PHP ۸.۱ است.

دانلود کنید فایل های رسمی PHP در اینجا.

از سال ۲۰۲۳، VS16 x64 Non Thread Safe  نسخه توصیه شده برای دانلود است، زیرا در اسناد نصب استفاده می شود.

 

 

پس از اتمام دانلود، فایل های PHP فشرده شده را در آن استخراج کنید C:\php\ در سیستم میزبان

خود را ویرایش کنید متغیرهای محیطی،  و یک متغیر Path System جدید اضافه کنید C:\php. 

 

 

اکنون Handler Mappings را در IIS با مسیر جدید php به روز کنید. برو به مدیر IIS، روی میزبان سرور کلیک کنید، سپس کلیک کنید نگاشت هندلر، و اضافه کنید نقشه برداری ماژول.

 

 

در پنجره جدید، تمام فیلدها را با اطلاعات دقیق نشان داده شده در تصویر زیر پر کنید و سپس کلیک کنید باشه.

 

به میزبان سرور در قسمت بازگردید مدیر IISو این بار کلیک کنید سند پیش فرض. کلیک کنید اضافه کنید در پنل اقدامات

 

 

فیلد Name را با آن پر کنید Index.php و کلیک کنید باشه. بعد، کلیک کنید اضافه کنید دوباره و این بار فیلد Name را با Default.php و کلیک کنید باشه.

 

 

پسوندهای PHP #

برای استفاده از TestRail در ویندوز با پایگاه داده SQL Server، پسوندهای PHP زیر مورد نیاز است:

• پسوند cassandra برای دسترسی به پایگاه داده NoSQL
• پسوند gd PHP برای تولید نمودار
• sqlsrv_81_nts_x64 PHP پسوند برای دسترسی به پایگاه داده های SQL Server
• پسوند pdo_mysql PHP برای دسترسی به پایگاه داده
• پسوند fileinfo PHP برای تعیین نوع فایل و رمزگذاری
• پسوند imagick PHP برای کار با تصاویر
• پسوند mbstring PHP برای کار با رشته های یونیکد
• برای بررسی به‌روزرسانی‌ها و غیره، پسوند PHP را بچرخانید.
• پسوند openssl PHP برای رسیدگی به اتصالات SSL
• ioncube PHP loader برای رمزگشایی فایل های PHP TestRail

برای دانلود درایورهای PHP مایکروسافت برای SQL Server در اینجا، و کلیک کنید دانلود درایورهای مایکروسافت برای PHP برای SQL Server (ویندوز).

پس از استخراج فایل ها، فایل های زیر را در دایرکتوری C:\php\ext\ خود کپی کنید: 

• php_pdo_sqlsrv_81_nts_x64.dll
• sqlsrv_81_nts_x64

برای نصب این پسوندها، موارد زیر را به فایل های php.ini خود اضافه کنید:

• پسوند=pdo_sqlsrv_81_nts_x64
• پسوند=sqlsrv_81_nts_x64

برای نصب افزونه imagick، دستورالعمل‌های رسمی را دنبال کنید مستندات. 

آخرین پسوند مورد نیاز PHP، بارگذار رایگان ionCube PHP است. می توانید دانلود کنید ionCube loader برای Windows در اینجا.

این روش نصب به «ioncube_loader_win_8.۱.dll» نیاز دارد که در هنگام دانلود یافت می شود Windows VC16 (غیر TS) (۶۴ بیت) فایل فشرده (ioncube_loaders_win_nonts_vc16_x86-۶۴.zip). تمام فایل های روی سرور خود را استخراج کنید و پسوند لودر را در دایرکتوری ext PHP خود کپی کنید (معمولاً C:\php\ext\). در مرحله بعد، با افزودن خط زیر به فایل PHP.ini، افزونه را فعال کنید (این فایل را می توانید در پوشه نصب خود پیدا کنید، معمولاً C:\php\):

zend_extension = "C:\php\ext\ioncube_loader_win_8.1.dll"

برای تأیید اینکه پسوند لودر ionCube با موفقیت نصب شده است، php -v را در خط فرمان ویندوز اجرا کنید (برای اجرای این دستور باید به دایرکتوری نصب PHP تغییر دهید).

اگر php -v چیزی شبیه به این را خروجی دهد، پسوند ionCube loader با موفقیت نصب شده است (به خط 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.

بیشتر برنامه‌های افزودنی باید به‌طور خودکار اضافه شوند، اما باید مراحل اضافی Cassandra، IonCube و imagick را طی کنید. اگر PHP را به صورت دستی نصب کرده اید، ممکن است مجبور شوید پسوندهای مورد نیاز را در فایل PHP.ini مانند این فعال کنید:

zend_extension = "C:\php\ext\ioncube_loader_win_8.1.dll"
extension=cassandra
extension=gd
extension=fileinfo
extension=imagick
extension=mbstring
extension=curl
extension=openssl
extension=pdo_sqlsrv_81_nts_x64
extension=sqlsrv_81_nts_x64

برای بارگیری مجدد PHP، وب سرور IIS را مجددا راه اندازی کنید. ساده ترین راه برای انجام این کار، راه اندازی مجدد است ویندوز انتشار وب جهانی خدمات می توانید این کار را با باز کردن برنامه Services از Administrative Tools و راه اندازی مجدد سرویس انجام دهید. لطفاً توجه داشته باشید که با این کار تمام استخرهای برنامه و وب سایت های IIS راه اندازی مجدد می شود. اگر وب‌سایت‌ها و برنامه‌های کاربردی دیگری را روی این سرور میزبانی می‌کنید، ممکن است بخواهید فقط مجموعه برنامه مربوطه را مجدداً راه‌اندازی کنید.

فایل های نصب را جایگزین کنید #

برای ارتقای نصب TestRail خود، فایل های نصب TestRail را در وب سرور خود آپلود و استخراج کنید و فایل های نسخه جدید TestRail را روی فایل های نصب موجود خود کپی کنید. فقط می‌توانید همه فایل‌ها را جایگزین کنید، زیرا فایل‌هایی که مختص نصب شما هستند (مانند فایل config.php) بخشی از بایگانی نصب نیستند.

هنگامی که فایل ها جایگزین شدند، نمونه ارتقا یافته است.  از طریق مرورگر وب (معمولاً «http://localhost/testrail/» یا چیزی مشابه) وارد نمونه شوید تا ارتقای موفقیت‌آمیز را تأیید کنید.

MAX_CHART_ROWS #

اگر کاربران بدون افزودن MAX_CHART_ROWS به فایل config.php به ۸.۰ ارتقا دهند، خطایی مانند تصویر زیر ظاهر می شود:

برای رفع این مشکل، ثابت را اضافه کنید:

/*
|--------------------------------------------------------------------
| OPTIMIZATIONS
|--------------------------------------------------------------------
|
| You can choose whether to optimize the delivery of style sheet and
| javascript files and the handling of language files. The following
| optimization settings are available:
|
| DEPLOY_OPTIMIZE_LANG:   If enabled, TestRail uses a single combined
|                         language file named 'all_lang' instead of
|                         multiple language files.
|
| DEPLOY_OPTIMIZE_CSS:    If enabled, a single combined style sheet
|                         is served to the clients.
|
| DEPLOY_OPTIMIZE_JS:     If enabled, a single combined javascript
|                         file is served to the clients.
*/


define('DEPLOY_OPTIMIZE_LANG', true);
define('DEPLOY_OPTIMIZE_CSS', true);
define('DEPLOY_OPTIMIZE_JS', true);


define('MAX_CHART_ROWS', 150000);