این مقاله توضیح می‌دهد چطور یک نصب فعلی TestRail را به نسخه جدید ارتقا دهید. برای ارتقای نصب TestRail خود، این مراحل را دنبال کنید.
از TestRail ۷.۰ به بعد، PHP ۷.۲.x دیگر پشتیبانی نمی‌شود. راهنمای ارتقای PHP را می‌توانید اینجا.
Backup
اکیدا توصیه می‌شود پیش از ارتقا، از فایل‌های نصب TestRail و database آن backup بگیرید تا اگر در فرایند ارتقا مشکلی پیش آمد، بتوانید تغییرات را برگردانید و به نصب قبلی که درست کار می‌کرد بازگردید. بهتر است به‌طور منظم از نصب و database مربوط به TestRail backup بگیرید، به‌خصوص قبل از ارتقا به نسخه جدیدتر.
Requirements
قبل از شروع ارتقای TestRail، لطفا requirements documentation و دستورالعمل‌های مخصوص سیستم‌عامل، یعنی Windows یا Linux، را بررسی کنید. وابستگی‌های نرم‌افزاری مثل PHP و SQL ممکن است با گذشت زمان تغییر کنند؛ بنابراین مهم است پیش از به‌روزرسانی نرم‌افزار TestRail، این requirements را مرور کنید.
جایگزین کردن فایل‌های نصب
برای ارتقای نصب TestRail، فایل‌های نصب TestRail را روی web server خود upload و extract کنید، سپس فایل‌های نسخه جدید TestRail را روی فایل‌های نصب فعلی کپی کنید. می‌توانید همه فایل‌ها را جایگزین کنید، چون فایل‌های مخصوص نصب شما، مثل config.php، داخل فایل نصب اصلی قرار ندارند.
بعضی configurationهای web server اجازه نمی‌دهند وقتی web server فعال است، فایل‌ها overwrite شوند. ممکن است لازم باشد پیش از جایگزین کردن فایل‌های نصب TestRail، web server را متوقف کنید. این مورد بیشتر در سیستم‌های Windows/IIS دیده می‌شود. اگر هنگام ارتقا به مشکل خوردید، web server را متوقف کنید و دوباره فایل‌ها را overwrite کنید.
ارتقای database
بعضی از ارتقاهای TestRail، نه همه آن‌ها، به ارتقای database هم نیاز دارند. اگر ارتقای database لازم باشد، وقتی با مرورگر وارد TestRail می‌شوید، TestRail شما را به‌صورت خودکار به صفحه ارتقای database می‌برد. فقط administratorها می‌توانند database را ارتقا دهند و تا وقتی ارتقای database کامل نشود، سایر کاربران به TestRail دسترسی نخواهند داشت.
Migration
بعد از به‌روزرسانی TestRail و ذخیره شدن تنظیمات Cassandra، می‌توانید migration tool را اجرا کنید. این ابزار attachmentهای فعلی شما را از SQL database به Cassandra database منتقل می‌کند.
SQL Server Database
$ cd migration_script (folder in TestRail application)
$ php ./TestRailSqlToCassandraMigration.php -d2 -m"driver=sqlsrv;host=localhost;port=1433;database=testrail;user=testrail;password=123456789" -s"host=localhost;port=9042;keyspace=testrail;user=cassandra;password=cassandra" -iMySQL Database
$ cd migration_script (folder in TestRail application)
$ php ./TestRailSqlToCassandraMigration.php -d2 -m"driver=mysql;host=localhost;port=3306;database=testrail;user=testrail;password=123456789" -s"host=localhost;port=9042;keyspace=testrail;user=cassandra;password=cassandra" -iاین فرایند ممکن است کمی زمان ببرد. توجه داشته باشید تا وقتی migration در حال انجام است، به‌جای attachmentها فقط icon می‌بینید.
Troubleshooting
اگر نصب فعلی TestRail را با فایل‌های جدید overwrite می‌کنید، باید دو فایل قدیمی نسخه قبلی را حذف کنید:
- app/models/attachment.php
- app/helpers/attachments.php