このトピックでは、既存の TestRail を新しいバージョンにアップグレードする方法について説明します。TestRail をアップグレードするには、以下の手順に従ってください。
TestRail 8.0.1 では、コマンドラインによるアップグレードは出来ません。必ず WEB 画面から操作してください。
Windows 環境のアップグレードは、TestRail 7.5.3 を経由する必要がございます。
バックアップ
新しいバージョンにアップグレードする前に、TestRail のファイルとデータベースのバックアップを作成することを強くお勧めします。アップグレードで問題が発生した場合、変更をロールバックして以前の (正常に動作する) バージョンに戻す唯一の方法はバックアップです。TestRail のファイルとデータベースのバックアップを定期的に作成し、新しいバージョンにアップグレードする前にも作成することをお勧めします。
要件
TestRailのアップグレードを行う前に、要件および OS 固有の手順 (Windwos/Linux) を確認してください。PHPやSQLなどのTestRailが依存するソフトウェアは時間とともに変更されるため、TestRailをアップグレードする前に、これらの要件を確認することをお勧めします。
インストール ファイルの置き換え
TestRail をアップグレードするには、TestRail のファイルを Web サーバーにアップロードして抽出し、新しいバージョンのファイルを既存のファイルの上にコピーします。アーカイブにはインストールに固有のファイル (例えば config.php ファイル) は含まれないため、単純にすべてのファイルを置き換えることができます。
Web サーバーの設定によっては、Web サーバーがアクティブな間はファイルが上書きできない場合があります。その場合、TestRail のインストールファイルを置き換える前に Web サーバーを停止する必要があります。この問題は、主に Windows/IIS システムで発生しています。アップグレードで問題が起きた場合は、Web サーバーを停止してからファイルをもう一度上書きしてください。
データベースのアップグレード
毎回というわけではありませんが、TestRail のアップグレードに伴って TestRail データベースもアップグレードする必要がある場合があります。データベースのアップグレードが必要な場合、Web ブラウザーで TestRail にアクセスすると、自動的にデータベースのアップグレード画面にリダイレクトします。データベースをアップグレードできるのは管理者だけであり、他のすべてのユーザーは、データベースのアップグレードが完了するまで TestRail にアクセスできません。
移行
TestRail のアップデートが完了し、Cassandra 設定が保存されたら、移行ツールを開始できます。移行ツールは既存の添付ファイルを SQL データベースから Cassandra データベースに移行します。
SQL Server のデータベース
> 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" -i
MySQL のデータベース
$ 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
このプロセスは数分かかる場合があります。移行が実行されている間、添付ファイルの代わりにアイコンしか表示されないことに注意してください。
トラブルシューティング
既存の TestRail を新しいファイルで上書きした場合、次の 2 つの古いファイルを削除する必要があります。
-
- app/models/attachment.php
- app/helpers/attachments.php