دسته‌ها را مشاهده کنید

ارتقای TestRail از ۹.۴.۱ تا ۱۰.۴.۱ در Windows

مدت زمان مطالعه: : 4 دقیقه

TestRail ۱۰.۴.۱ برای همه مشتریان Server در دسترس است. مشتریانی که می‌خواهند به TestRail ۱۰.۴.۱ ارتقا دهند، می‌توانند فایل‌های نصب را از TestRail Billing Portal دانلود کنند.

این راهنما مراحل ارتقای TestRail Server روی Windows را از هر نسخه پشتیبانی‌شده (از ۹.۴.۱ به بعد) به هر نسخه جدیدتر توضیح می‌دهد. از این راهنما می‌توانید هم برای ارتقا به 10.4.1 و هم برای ارتقا به هر نسخه هدف پشتیبانی‌شده قدیمی‌تر (از ۹.۴.۱ به بعد) استفاده کنید. برای ارتقای نصب TestRail خود، این مراحل را دنبال کنید.

ℹ️ نکته مهم:

از TestRail ۹.۵.۱ Server به بعد، Cassandra رسماً deprecated شده و این محدودیت اعمال می‌شود.

  • Adminها باید ابتدا اسکریپت deprecated شدن Cassandra را در نسخه ۹.۴.۱ پیش از ارتقا به نسخه‌های جدیدتر اجرا کنند.

  • اگر این اسکریپت اجرا نشده باشد، ارتقا به نسخه‌های جدیدتر متوقف می‌شود و یک  پیام هشدار نمایش داده می‌شود  در طول فرایند ارتقا.

    👉 لطفاً مستندات deprecated شدن Cassandra را بررسی کنید.

Backup #

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

Requirements #

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

Suspend کردن Background Task پیش از ارتقا #

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

توجه: دستورهای زیر فرض می‌کنند Background Task طبق توضیحات بخش Activating the background task پیکربندی شده است. اگر تنظیمات شما متفاوت است، برای مثال محل فایل cron فرق دارد، نام task در Task Scheduler سفارشی است، یا مسیر PHP استاندارد نیست، پیش از ادامه دستورها را متناسب با محیط خود تغییر دهید.

پس از کامل شدن ارتقا، باید Background Task را دوباره فعال کنید. برای راهنما، ببینید: Activating the background task.

ویندوز (Bare Metal) #

  1. Scheduled Task را غیرفعال کنید
    1. PowerShell را با دسترسی Administrator باز کنید و این دستور را اجرا کنید:
Disable-ScheduledTask -TaskName "TestRail Background Task"
  1. اگر اجرای فعالی در جریان است، اجازه دهید کامل شود؛ سپس مطمئن شوید هیچ taskی در حال اجرا نیست
    1. اگر یک background task در حال اجراست، قبل از ادامه ارتقا صبر کنید تا کار آن تمام شود. برای بررسی، از دستور زیر استفاده کنید:
Get-Process php -ErrorAction SilentlyContinue
  1. اگر هیچ process مربوط به PHP در فهرست دیده نمی‌شود، می‌توانید ادامه دهید. اگر processی در حال اجراست، یک دقیقه صبر کنید و دوباره بررسی کنید.

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

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

ویندوز (PowerShell با دسترسی Administrator)

Enable-ScheduledTask - TaskName "TestRail Background Task"

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

  1. نصب dependencies – مطمئن شوید سیستم شما امکان باز کردن فایل‌های ZIP را دارد.
  2. دانلود دستی Chrome Headless Shell – در مرورگر، وب‌سایت Chrome for Testing را باز کنید و آخرین نسخه stable را دانلود کنید
  3. از حالت فشرده خارج کردن فایل – روی فایل .zip راست‌کلیک کنید و گزینه «Extract All» را انتخاب کنید
  4. انتقال به مسیر دلخواه – پوشه extract‌شده را به هر مسیری که می‌خواهید منتقل کنید، مثلا C:\Program Files\ChromeHeadless. مسیر binary را یادداشت کنید، چون باید آن را به تنظیمات TestRail اضافه کنید.

حذف فایل‌های قدیمی و extract کردن فایل‌های نصب جدید #

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

بعضی از تنظیمات web server ممکن است وقتی web server فعال است، اجازه ندهند فایل‌ها overwrite شوند. قبل از جایگزین کردن فایل‌های نصب TestRail، باید web server را متوقف کنید. این مورد بیشتر در سیستم‌های Windows/IIS رخ می‌دهد؛ بنابراین اگر هنگام ارتقا با مشکل روبه‌رو شدید، web server را متوقف کنید و دوباره فایل‌ها را overwrite کنید.

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

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

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

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

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

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

define('TR_CHROME_PATH', 'C:\\testrail\\chrome-headless-shell-win64\\chrome-headless-shell.exe');

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

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

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

عیب‌یابی #

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

- /app/libraries/PhpSpreadsheet folder
به‌روزرسانی شده در ۱۴۰۵-۰۴-۱۷

احساسات شما چیست؟

  • خوشحال
  • عادی
  • ناراحت

دیدگاهتان را بنویسید