در ادامه، روش ارتقای نصب فعلی TestRail به نسخه جدید (از ۸.۰.۴/۸.۰.۶/۸.۱.۰/۹.۰.۰/۹.۱.۰/۹.۲.۱ به ۹.۳.۲) توضیح داده شده است. برای ارتقای نصب TestRail خود، این مراحل را دنبال کنید.
پشتیبانگیری #
اکیداً توصیه میشود از فایلهای نصب TestRail و پایگاه داده TestRail خود backup بگیرید و این کار را پیش از ارتقا به نسخه جدیدتر انجام دهید. اگر هنگام ارتقا مشکلی پیش بیاید، backup تنها راه برگرداندن تغییرات و بازگشت به نصب قبلیِ سالم است. توصیه میکنیم بهطور منظم، بهویژه پیش از ارتقا به نسخه جدیدتر، از نصب و پایگاه داده TestRail خود backup بگیرید.
پیشنیازها #
پیش از شروع فرایند ارتقای TestRail، لطفاً مستندات پیشنیازها و دستورالعملهای مخصوص سیستمعامل (Windows/Linux) را بررسی کنید. وابستگیهای نرمافزاری مانند PHP و SQL ممکن است در طول زمان تغییر کنند؛ بنابراین مهم است که پیش از بهروزرسانی نرمافزار TestRail، این پیشنیازها را مرور کنید.
نصب وابستگی Chrome Headless Shell #
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. Binary را از حالت فشرده خارج کنید و منتقل کنید. اکنون میتوانید binary را extract کرده و به محل دلخواه خود منتقل کنید. محل انتقال binary را یادداشت کنید، چون باید این مسیر را به پیکربندی TestRail اضافه کنید.
unzip chrome-headless-shell-linux64.zip sudo mv chrome-headless-shell-linux64 /usr/bin/
4. مجوزها را تنظیم کنید. مطمئن شوید 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 ۹.۳.۲، باید همه فایلهای نصب قدیمی را از پوشه instance حذف کنید؛ فقط فایلها و پوشههایی را نگه دارید که کاربر ایجاد کرده است (مانند config.php و پوشههای logs و audit)، و سپس آرشیو TestRail ۹.۳.۲ را استخراج کنید.
برخی پیکربندیهای web server ممکن است وقتی web server فعال است، از overwrite شدن فایلها جلوگیری کنند. قبل از جایگزین کردن فایلهای نصب TestRail باید web server را متوقف کنید. این مورد بیشتر در سیستمهای Windows/IIS رخ میدهد؛ بنابراین اگر هنگام ارتقا با مشکل روبهرو شدید، web server را متوقف کنید و دوباره فایلها را overwrite کنید.
بعد از جایگزینی فایلها، instance ارتقا یافته است.
حالا باید یک entry جدید را در config.php اضافه کنید:
define('TR_CHROME_PATH', '/usr/bin/chrome-headless-shell-linux64');
پس از انجام مراحل بالا، میتوانید از طریق یک مرورگر وارد instance شوید (معمولاً با آدرس «http://localhost/testrail/» یا آدرسی مشابه) و موفق بودن ارتقا را تأیید کنید.
پاک کردن کش مرورگر #
پس از تأیید ارتقا، همه کاربران نهایی باید کش مرورگر خود را پاک کنند تا ارتقای jQuery اعمال شود. برای انجام این کار در هر یک از مرورگرهای پشتیبانیشده، مراحل زیر را دنبال کنید:
- Chrome – https://support.google.com/accounts/answer/32050?hl=fa&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 را با فایلهای جدید جایگزین میکنید، باید پوشهای از نسخه قبلی را حذف کنید پیش از استخراج فایلهای نصب نسخه جدید:
- /app/libraries/PhpSpreadsheet folder
