انتقال داده‌های Cassandra به MySQL در TestRail Server برای Linux

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

از TestRail Server ۹.۴ به بعد، محل نگهداری attachmentها از Cassandra به Microsoft SQL Server یا MySQL منتقل می‌شود. به‌روزرسانی ۹.۴ یک اسکریپت انتقال پشتیبانی‌شده دارد که با آن می‌توانید attachmentهای فعلی خود را از Cassandra به MS SQL Server یا MySQL کپی کنید. داده‌های اصلی Cassandra بدون تغییر باقی می‌مانند.

توجه: اگر در حال حاضر از TestRail ۸.۱ استفاده می‌کنید، لازم نیست مراحل زیر را انجام دهید. با این حال، باید config.php را به‌صورت دستی ویرایش کنید و اطلاعات مربوط به Cassandra را حذف کنید. همچنین با بررسی جدول settings مطمئن شوید TestRail در حالت SQL-only اجرا می‌شود:

primary_attachment_db باید روی “sql” تنظیم شده باشد
attachments_to_both_dbs باید روی “۰” تنظیم شده باشد

می‌توانید انتقال را با سرعت و برنامه خودتان انجام دهید. اما از نسخه بعدی (TestRail ۹.۵)، برای ارتقا باید انتقال کامل شده باشد. مشتریانی که انتقال را کامل نکرده‌اند، تا پیش از تکمیل آن نمی‌توانند TestRail ۹.۵ و به‌روزرسانی‌های بعدی را نصب کنند.

اگر نمی‌خواهید انتقال را انجام دهید، می‌توانید همچنان از نسخه فعلی خود استفاده کنید. توجه داشته باشید که پشتیبانی TestRail Server شامل نسخه‌های فعال دو سال گذشته می‌شود؛ بنابراین به‌روز ماندن، دسترسی شما به پشتیبانی و به‌روزرسانی‌های امنیتی را حفظ می‌کند.

اگر می‌خواهید ادامه دهید، مراحل زیر را به‌ترتیب انجام دهید:

محیط shell خود را (مثل Terminal یا PowerShell) باز کنید و به پوشه
deprecation_script بروید.
برای بررسی اینکه Composer نصب است و درست اجرا می‌شود، دستور زیر را اجرا کنید:
```
composer -V
```
اگر Composer اجرا نمی‌شود، برای راهنمای نصب به مستندات پروژه مراجعه کنید.
وابستگی‌های لازم را با دستور زیر نصب کنید:
```
composer update
```
اتصال به پایگاه داده MySQL را بررسی کنید:
```
mysql -h  -u testrail -p
```

(اختیاری) برای بررسی درست کار کردن اسکریپت انتقال، یک dry-run اجرا کنید:

php TestRailSqlToCassandraMigration.php -d2 -r -m"driver=mysql;host=;port=;database=;user=;password=" -s"host=;port=9042;keyspace=;user=;password=" -v2 -b --attachments=""

فایل config.ini را با اطلاعات لازم برای اتصال به
پایگاه داده تکمیل کنید (اگر گذرواژه یا گذرواژه‌های شما کاراکترهای خاص دارند، آن‌ها را داخل double quotes قرار دهید)
1. در فایل config.ini مقدار `driver = mysql` را تنظیم کنید
اگر همه مراحل قبلی با موفقیت انجام شد، Deprecation Script را با دستور زیر اجرا کنید:
```
php TestRailCassandraDeprecation.php
```
در صورت نیاز، می‌توانید flag –force-deprecation را هم اضافه کنید تا اگر هنگام انتقال attachmentها خطایی رخ داد، فرایند deprecation همچنان اجرا شود:
```
php TestRailCassandraDeprecation.php --force-deprecation
```