TestRail のアップグレード

このトピックでは、既存の TestRail を新しいバージョンにアップグレードする方法について説明します。TestRail をアップグレードするには、以下の手順に従ってください。

TestRail 7.0 以降では、PHP 7.2.x がサポートされなくなりました。

TestRail 7.5.3 では、コマンドラインによるバージョンアップは出来ません。必ず WEB 画面からバージョンアップしてください。

バックアップ

新しいバージョンにアップグレードする前に、TestRail のファイルとデータベースのバックアップを作成することを強くお勧めします。アップグレードで問題が発生した場合、変更をロールバックして以前の (正常に動作する) バージョンに戻す唯一の方法はバックアップです。TestRail のファイルとデータベースのバックアップを定期的に作成し、新しいバージョンにアップグレードする前にも作成することをお勧めします。

要件

TestRailのアップグレードを行う前に、要件および OS 固有の手順 (Windwos/Linux) を確認してください。PHPやSQLなどのTestRailが依存するソフトウェアは時間とともに変更されるため、TestRailをアップグレードする前に、これらの要件を確認することをお勧めします。

インストール ファイルの置き換え

TestRail をアップグレードするには、TestRail のファイルを Web サーバーにアップロードして抽出し、既存のファイルを新しいバージョンのファイルに置き換える必要があります。

    1. バックアップを取得
    2. TestRail インストールディレクトリ内のファイルを削除
    3. TestRail 7.5.3 のモジュールを展開後、TestRail インストールディレクトリに配置
    4. 必要なファイル、ディレクトリをバックアップから復元
      • config.php ファイル：必須
        • バックアップから config.php を取得して、インストールディレクトリに再配置してください。
      • logs, audit, reports, attachments ディレクトリ：必要に応じて
        • これらのディレクトリが TestRail インストールディレクトリ内に配置されている場合はバックアップからコピーして再配置が必要です。

 

Web サーバーの設定によっては、Web サーバーがアクティブな間はファイルが上書きできない場合があります。その場合、TestRail のインストールファイルを置き換える前に Web サーバーを停止する必要があります。この問題は、主に Windows/IIS システムで発生しています。アップグレードで問題が起きた場合は、Web サーバーを停止してからファイルをもう一度上書きしてください。

データベースのアップグレード

毎回というわけではありませんが、TestRail のアップグレードに伴って TestRail データベースもアップグレードする必要がある場合があります。データベースのアップグレードが必要な場合、Web ブラウザーで TestRail にアクセスすると、自動的にデータベースのアップグレード画面にリダイレクトします。データベースをアップグレードできるのは管理者だけであり、他のすべてのユーザーは、データベースのアップグレードが完了するまで TestRail にアクセスできません。

マイグレーションスクリプトの実行

Windows 環境を利用しており、TestRail 8.x へのバージョンアップ作業中に TestRail 7.5 のアップグレード操作を実施している場合、マイグレーションスクリプトの実行は 8.x バージョンアップ後に実施します。

WEB 画面でのデータベースのアップグレード操作が完了したら、8.0.1 インストール要件の確認 へ進んでください。

TestRail のアップデートが完了し、Cassandra 設定が保存されたら、移行ツールを開始できます。移行ツールは既存の添付ファイルを SQL データベースから Cassandra データベースに移行します。

SQL Server のデータベース

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
> 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
> 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
> 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 のデータベース

Plain text
Copy to clipboard
Open code in new window
EnlighterJS 3 Syntax Highlighter
$ 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
$ 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
$ 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