ارتقای TestRail از ۹.۴.۱ تا ۱۰.۴.۱ در Unix/Linux

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

اکیداً توصیه می‌شود که از فایل‌های نصب TestRail و database مربوط به TestRail backup بگیرید پیش از ارتقا به نسخه جدیدتر. اگر در فرآیند ارتقا مشکلی ایجاد شود، backup تنها راه برگشت دادن تغییرات و بازگشت به نصب قبلی است که بدون مشکل کار می‌کرد. پیشنهاد می‌کنیم به‌طور منظم از نصب و database مربوط به TestRail backup بگیرید، به‌خصوص قبل از ارتقا به نسخه جدیدتر.

نیازمندی‌ها #

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

تعلیق Background Task قبل از ارتقا #

قبل از شروع فرآیند ارتقا، باید TestRail Background Task را suspend کنید تا اجرای taskهای فعال با database migrations تداخل نداشته باشد. انجام ندادن این کار ممکن است هنگام ارتقا باعث خطای lock wait timeout شود.

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

Linux (Bare Metal) #

1. cron job را غیرفعال کنید
   1. برای اینکه cron این فایل را اجرا نکند، نام فایل cron را تغییر دهید:

sudo mv /etc/cron.d/testrail /etc/cron.d/testrail.disabled

2. اجازه دهید هر اجرای فعال کامل شود، سپس مطمئن شوید هیچ taskای در حال اجرا نیست
   1. اگر اجرای Background Task در حال حاضر در جریان است، قبل از ادامه ارتقا صبر کنید تا کامل شود. برای بررسی، از دستور زیر استفاده کنید:

ps aux | grep task.php | grep -v grep

2. اگر دستور هیچ خروجی‌ای نشان ندهد، یعنی هیچ taskای در حال اجرا نیست و می‌توانید ادامه دهید. اگر یک process نمایش داده شد، یک دقیقه صبر کنید و دوباره بررسی کنید

فعال‌سازی دوباره پس از ارتقا #

پس از اینکه ارتقا کامل شد و مطمئن شدید می‌توانید با موفقیت وارد TestRail شوید:

Linux

sudo mv /etc/cron.d/testrail.disabled /etc/cron.d/testrail

نصب dependency مربوط به Chrome Headless Shell #

1. terminal دلخواه خود را باز کنید و این دستور را اجرا کنید:

sudo apt update
sudo apt install -y wget unzip libnss3 libatk1.0-0 libxcomposite1 libxdamage1 libxrandr2 libgbm1 libxkbcommon0 libasound2 libatk-bridge2.0-0 libxfixes3

2.  آخرین نسخه Chrome Headless Shell را دانلود کنید و در terminal خود این دستورها را اجرا کنید:

cd /tmp
LATEST_VERSION=$(wget -qO- https://googlechromelabs.github.io/chrome-for-testing/LATEST_RELEASE_STABLE)
Wget https://storage.googleapis.com/chrome-for-testing-public/${LATEST_VERSION}/linux64/chrome-headless-shell-linux64.zip

3. فایل binary را unzip و منتقل کنید. اکنون می‌توانید فایل binary را از حالت فشرده خارج کنید و به محل دلخواه خود منتقل کنید. مسیر محل انتقال binary را یادداشت کنید، چون باید این path را به تنظیمات TestRail اضافه کنید.

unzip chrome-headless-shell-linux64.zip
sudo mv chrome-headless-shell-linux64 /usr/bin/

4. Permissionها را تنظیم کنید. مطمئن شوید web user دسترسی کافی برای اجرای Chrome binary را دارد:

sudo chown www-data:www-data /usr/bin/chrome-headless-shell-linux64 -R
sudo chmod 775 /usr/bin/chrome-headless-shell-linux64 -R

حذف فایل‌های قدیمی و استخراج فایل‌های نصب جدید #

برای ارتقای نصب TestRail خود، در TestRail ۱۰.۴.۱ باید قبل از استخراج archive مربوط به TestRail ۱۰.۴.۱، همه فایل‌های نصب قدیمی را از پوشه instance حذف کنید، به‌جز فایل‌ها و پوشه‌هایی که کاربر ایجاد کرده است (برای مثال config.php، پوشه logs و پوشه audit).

پس از جایگزین شدن فایل‌ها، instance ارتقا یافته است.

به‌روزرسانی تنظیمات Jira token (برای نسخه‌های پایین‌تر از ۱۰.۱.۴ الزامی است) #

اگر از نسخه‌ای قدیمی‌تر از 10.1.4 ارتقا می‌دهید، باید فایل تنظیمات Jira token را نیز در همین فرایند به‌روزرسانی کنید.

1. فایل‌های update را دانلود کنید اینجا.
2. فایل‌ها را به‌روزرسانی کنید
   1. مسیر نصب TestRail خود را پیدا کنید

   2. جایگزین کنید app/config/consts.php با نسخه به‌روزرسانی‌شده‌ای که ارائه شده است

   3. مالکیت درست فایل را تنظیم کنید.

      chown www-data:www-data <TestRail installation path>app/config/consts.php

اکنون باید یک entry جدید در config.php:

define('TR_CHROME_PATH', '/usr/bin/chrome-headless-shell-linux64');

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

پاک کردن cache مرورگر #

پس از تأیید ارتقا، همه کاربران نهایی باید cache مرورگر خود را پاک کنند تا ارتقای jQuery اعمال شود. برای انجام این کار در هر یک از مرورگرهای پشتیبانی‌شده، مراحل زیر را دنبال کنید:

• Chrome – https://support.google.com/accounts/answer/32050?hl=en&co=GENIE.Platform%3DDesktop
• Firefox – https://support.mozilla.org/en-US/kb/how-clear-firefox-cache
• Microsoft Edge – https://www.microsoft.com/en-us/edge/learning-center/how-to-manage-and-clear-your-cache-and-cookies?form=MA13I2
• Safari – https://support.apple.com/lv-lv/guide/safari/sfri11471/ma

عیب‌یابی #

اگر نصب فعلی TestRail را با فایل‌های جدید overwrite می‌کنید، باید پوشه‌ای از نسخه قبلی را حذف کنید پیش از extract کردن فایل‌های نصب نسخه جدید:

- /app/libraries/PhpSpreadsheet folder