ارتقا TestRail از ۹.۴.۱ به ۱۰.۴.۱ در یونیکس/لینوکس

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

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

الزامات #

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

قبل از ارتقا، کار پس‌زمینه را به حالت تعلیق درآورید #

قبل از شروع فرآیند ارتقا، باید TestRail Background Task را به حالت تعلیق در آورید تا از تداخل اجرای کار فعال با انتقال پایگاه داده جلوگیری کنید. اگر این کار را انجام ندهید ممکن است در حین ارتقا، خطاهای زمان انتظار قفل ایجاد شود.

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

لینوکس (بره متال) #

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

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

2. اجازه دهید اجرای فعال کامل شود، سپس تأیید کنید که هیچ کاری در حال اجرا نیست
   1. اگر اجرای یک کار پس‌زمینه در حال حاضر در حال انجام است، اجازه دهید قبل از ادامه ارتقا به پایان برسد. برای بررسی از دستور زیر استفاده کنید:

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

2. اگر دستور هیچ خروجی برگرداند، هیچ کاری در حال اجرا نیست و ادامه آن بی خطر است. اگر فرآیندی فهرست شده است، یک دقیقه صبر کنید و دوباره بررسی کنید

بعد از ارتقا دوباره فعال کنید #

هنگامی که ارتقاء کامل شد و ورود موفقیت آمیز به TestRail را تأیید کردید:

لینوکس

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

Chrome Headless Shell Dependency را نصب کنید #

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

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 را دانلود کنید و در ترمینال خود دستورات زیر را اجرا کنید:

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. باینری را از حالت فشرده خارج کرده و حرکت دهید. اکنون می توانید باینری را از حالت فشرده خارج کرده و به مکان دلخواه خود منتقل کنید. محل انتقال باینری را یادداشت کنید، زیرا باید این مسیر را به پیکربندی TestRail اضافه کنید.

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

4. مجوزها را تنظیم کنید. مطمئن شوید که کاربر وب دارای مجوزهای کافی برای اجرای باینری کروم است:

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 ۱۰.۴.۱ شما باید تمام فایل های نصب قدیمی را در پوشه نمونه حذف کنید، به جز فایل ها/پوشه های ایجاد شده توسط کاربر (به عنوان مثال config.php، گزارش‌ها و پوشه‌های حسابرسی)، قبل از استخراج بایگانی TestRail ۱۰.۴.۱.

هنگامی که فایل ها جایگزین شدند، نمونه ارتقا یافته است.

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

اگر در حال ارتقا از نسخه ای زودتر از آن هستید 10.1.4، باید فایل پیکربندی توکن Jira را به عنوان بخشی از این فرآیند به روز کنید.

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

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

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

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

در حال حاضر، شما نیاز دارید یک ورودی جدید اضافه کنید config.php:

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

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

کش مرورگر را پاک کنید #

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

• کروم – https://support.google.com/accounts/answer/32050?hl=fa&co=GENIE.Platform%3DDesktop
• فایرفاکس – https://support.mozilla.org/en-US/kb/how-clear-firefox-cache
• مایکروسافت اج – https://www.microsoft.com/en-us/edge/learning-center/how-to-manage-and-clear-your-cache-and-cookies?form=MA13I2
• سافاری – https://support.apple.com/lv-lv/guide/safari/sfri11471/ma

عیب یابی #

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

- /app/libraries/PhpSpreadsheet folder