スキーマの移行
Toscaは、プロジェクトデータをデータベースに保存し、共通リポジトリとして機能させます。このデータベースは特定のデータ構造、つまり「スキーマ」を持っています。Toscaのバージョン間でスキーマが変更された場合は、移行する必要があります。このトピックでは、スキーマの移行のプロセスを紹介します。
|
Tosca 12.3以降、スキーマのバージョンは変更されていません。したがって、バージョン12.3以降からアップグレードする場合は、 2024.2へのアップグレード中にこのトピックを無視しても問題ありません。 |
重要な考慮事項
スキーマの移行に関しては、以下の事項にご注意ください。
-
移行する必要があるのは、マルチユーザー環境のみです。シングルユーザー環境では、アップグレード後にワークスペースを初めて開いたときに、Toscaが自動的に移行を実行します。
-
必ず最初にテストデータベースで移行をテストしてください。テスト用データベースの移行に成功した場合のみ、製品用データベースを移行してください。
-
移行を元に戻すことはできません。移行されたスキーマ、モジュール、およびテストケースには下位互換性がありません。移行後に以前のスキーマに戻したい場合は、バックアップを復元する必要があります。
移行プロセス
手動で移行することも可能ですが、 Tosca Administration Console を使用する場合は、コンソール内で直接移行することもできます。
ユースケースを選択してください。
Tosca Administration Console を使用すると、コンソール内で直接、移行をトリガーすることができます。
移行の準備をする
コンソールはTosca サーバーの一部なので、以下の準備手順を実行する必要があります:
-
サーバーマシンにTosca2024.2をインストールします。
移行を実行する
詳細な手順については、こちらをチェックアウトしてください。"Tosca Administration Console を使用してプロジェクトを移行する"
コンソールを使用しない場合は、手動でスキーマを移行する必要があります。
移行の準備をする
手動の移行を準備するには、以下の手順を実行します。
-
レポジトリデータベースへの接続文字列を取得する。この接続文字列のユーザーには、テーブルを作成し、インデックスを削除し、新しいインデックスを作成する権限、ALTER、CREATE、および DELETE が必要。
-
すべてのユーザーに、ローカルの変更点をチェックインするように依頼する。移行は、すべてのオブジェクトのレポジトリバージョンで実行される。他のユーザーがチェックアウトしたオブジェクトを移行すると、ローカルのすべての変更が失われる。
-
データベースのバックアップを作成する。移行に失敗した場合、再度移行を試みる前にバックアップをロードする必要があります。
移行を実行する
スキーマを移行するには、以下の手順に従ってください。
-
%COMMANDER_HOME% に移動します。
-
「コマンドプロンプト」ウィンドウを開き、以下のコマンドを実行してください。
DbRepositorySchemaMigrator.exe "<database type>" "[schema name]" "[tablespace name]" "<connection string>"
-
<database type> を以下のリポジトリのデータベースタイプに置き換えます: Oracle 、 MS SQL Server 、 DB2 、または SQLite 。
-
任意で、 [schema name] をデータベースのスキーマ名に置き換えます。
-
任意で、 [tablespace name] をデータベースのテーブルスペース名に置き換えます。テーブルスペースの名前は、使用するデータベース(Tablespace (DB2)、Userspace (Oracle)、FileGroup (MS SQL))によって異なります。
-
は、リポジトリデータベースに接続するために、接続文字列に置き換えます。 <connection string>SQLiteレポジトリの場合は、 CommonRepository.db ファイルへの絶対パスを入力します。 -
任意で、コマンドの最後に「 -s 」を追加すると、ユーザーの介入なしにサイレントモードで移行を実行できます。
-
|
以下は移行コマンドの2つの例です。
|
移行が完了すると、 DbRepositorySchemaMigrator.exe は、移行が成功したかどうかを示すメッセージを表示します。移行結果の詳細については、 %APPDATA%\TRICENTIS\TOSCA TestSuite\7.0.0\Temp\TCTempLog にあるログファイル SchemaMigration_<File name> .txt を確認してください。
これで、Toscaでマルチユーザーワークスペースを開くことができるようになりました。Tosca は、スキーマの移行の後に初めてワークスペースを開くと、ワークスペースを移行します。
スキーマのバージョン一覧
以下の表は、 Tosca Commander のバージョンとそれぞれのスキーマのバージョンの一覧です。
|
ToscaCommander のバージョン |
スキーマバージョンの共通リポジトリ |
|
2024.2 LTS |
12030000 |
|
2024.1 LTS |
12030000 |
|
2023.2 LTS |
12030000 |
|
2023.1 LTS |
12030000 |
|
16.0 LTS |
12030000 |
|
15.2 LTS |
12030000 |
|
15.1 STS |
12030000 |
|
15.0 LTS |
12030000 |
|
14.3 STS |
12030000 |
|
14.2 LTS |
12030000 |
|
14.1 STS |
12030000 |
|
14.0 |
12030000 |
|
13.4 |
12030000 |
|
13.3 |
12030000 |
|
13.2 |
12030000 |
|
13.1 |
12030000 |
|
13.0 |
12030000 |
|
12.3 |
12030000 |
|
12.2 |
11010002 |
|
12.1 |
11010002 |
|
12.0 |
11010002 |