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

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

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

الزامات #

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

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

PHP 8.1 #

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

اجرا کنید

sudo apt install php8.1

نسخه PHP مورد نظر خود را انتخاب کنید (در این مورد ۸.۱).

sudo update-alternatives --config php

آپاچی را ریستارت کنید

systemctl restart apache2

ionCube #

آخرین پسوند مورد نیاز PHP، بارگذار رایگان ionCube PHP است. می‌توانید به دایرکتوری ionCube بروید (این سند /opt/ioncube/ را فرض می‌کند)، بارگیری ionCube را برای یونیکس/لینوکس با اجرای دستورات زیر دانلود و نصب کنید:

دایرکتوری را به /opt/ioncube تغییر دهید

cd /opt/ioncube

دانلود فایل های ioncube

wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.zip

استخراج فایل های ioncube

unzip ioncube_loaders_lin_x86-64.zip

فایل php.ini (/apache و /cli) را با لودر ioncube جدید به روز کنید (معمولا “/etc/php/۸.۱/cli/php.ini” & /etc/php/۸.۱/apache2/php.ini)

zend_extension=/opt/ioncube/ioncube_loader_lin_8.1.so

اگر هنوز یک فایل phpinfo.php در پوشه wwwroot دارید، از مرحله زیر برای ایجاد فایل phpinfo.php صرفنظر کنید و به “localhost/phpinfo.php” در مرورگر وب خود بروید. 

برای بررسی اطلاعات نسخه PHP در مرورگر وب خود به localhost/phpinfo.php بروید.  باید چیزی شبیه به این باشد (توجه داشته باشید که نسخه مناسب در عنوان منعکس شده است):

لطفا بررسی کنید صفحه phpinfo که تمام پسوندهای مورد نیاز php از جمله Cassandra را لیست می کند.

برای تأیید اینکه پسوند لودر ionCube با موفقیت نصب شده است، php -v را اجرا کنید.

php -v

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

PHP 8.1.15 (cli) (built: Feb  7 2023 11:31:13) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.15, Copyright (c) Zend Technologies
with the ionCube PHP Loader v12.0.5, Copyright (c) 2002-2022, by ionCube Ltd.
with Zend OPcache v8.1.15, Copyright (c), by Zend Technologies

پسوندهای PHP #

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

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

معمولاً دایرکتوری پسوند php را می توان در «/usr/lib/php/۲۰۲۱۰۹۰۲/» یافت.  این سند فرض می کند که این دایرکتوری افزونه ما است.

اکثر برنامه های افزودنی به صورت پیش فرض وجود دارند، اما باید mbstring، gd و imagick را به صورت دستی نصب کنید.  

gd، fileinfo، mbstring، curl، openssl، & تصویر سازی

این ها را می توان با استفاده از دستور زیر نصب کرد:

apt-get -y install php8.1-imagick php8.1-mbstring php8.1-gd

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

extension=gd
extension=fileinfo
extension=mbstring
extension=curl
extension=openssl
extension=imagick

کاساندرا #

فایل php_cassandra.so را دانلود و نصب کنید.

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

فایل ها را در فهرست برنامه افزودنی PHP خود کپی کنید (معمولاً: /usr/lib/php/۲۰۲۱۰۹۰۲/).

cp -r /tmp/cassandra.so /usr/lib/php/20210902/

فایل php.ini (/apache و /cli) را با لودر ioncube جدید به روز کنید (معمولا “/etc/php/۸.۱/cli/php.ini” & /etc/php/۸.۱/apache2/php.ini)

extension=cassandra

برای بارگیری مجدد PHP، وب سرور آپاچی را مجددا راه اندازی کنید. 

systemctl restart apache2

بسته بندی #

پس از اتمام نصب، دستور زیر را اجرا کنید تا نسخه PHP ۸.۱ برای آپاچی فعال شود:

a2enmod php8.1

پس از به روز رسانی PHP، ionCube Loader، gd، mbstring، imagick، & Cassandra، فایل php.ini شما باید بسیار شبیه به مثال زیر باشد:

zend_extension ="/opt/ioncube/ioncube_loader_lin_8.1.so"
extension=cassandra
extension=gd
extension=fileinfo
extension=imagick
extension=mbstring
extension=curl
extension=openssl
extension=mysql

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

برای ارتقای نصب 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);