انتقال داده‌های Cassandra در TestRail Server به MS SQL Server برای Windows

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

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

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

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

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

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

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

shell خود را باز کنید (مثل Terminal یا PowerShell) و به پوشه‌ی deprecation_script بروید.
برای مطمئن شدن از اینکه Composer نصب است و درست اجرا می‌شود، دستور زیر را اجرا کنید:
```
composer -V
```
اگر Composer اجرا نمی‌شود، برای راهنمای نصب به مستندات پروژه مراجعه کنید.
وابستگی‌های لازم را با دستور زیر نصب کنید:
```
composer update
```
اتصال به پایگاه داده‌ی MS SQL Server را بررسی کنید:
```
sqlcmd -S  -U username -P password
```
اتصال به پایگاه داده‌ی Cassandra را بررسی کنید:
```
sqlcmd -S cqlsh  9042 -u  -p 
```

(اختیاری) برای مطمئن شدن از کارکرد Migration Script، یک dry run انجام دهید:

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

حتماً فایل config.ini را تکمیل کنید، database version را روی sqlsrv بگذارید و credentials اتصال به database را وارد کنید (اگر passwordها شامل کاراکتر خاص هستند، آن‌ها را داخل double quotes قرار دهید)
```
`driver = sqlsrv`
```
اگر همه‌ی مراحل قبلی با موفقیت کامل شد، Deprecation Script را با دستور زیر اجرا کنید:
```
php TestRailCassandraDeprecation.php 
```
همچنین می‌توانید flag –force-deprecation را اضافه کنید تا حتی اگر هنگام migration کردن attachmentها خطا رخ داد، فرایند deprecation به‌اجبار اجرا شود:
```
php TestRailCassandraDeprecation.php --force-deprecation
```