Tosca Commander のアップグレード

このトピックでは、 Tricentis Toscaのアップグレードワークフローの一部である Tosca Commander のバージョン2024.2へのアップグレードについて説明いたします。

以下のバージョンからのアップグレードにのみ、指示が適用されることにご注意ください。

  • 2024.2リリースの頃にサポートされるバージョン：2024.1と2023.2

  • 2024.2リリースの時点で拡張サポート中のバージョン：2023.1、16.0、15.2、および15.0。

エンドオブライフバージョンのアップグレードを整理する方法に関する詳細は、 "生産が終了したバージョンをアップグレードする" を確認してください。

始める 前に

推奨されるステージング環境で新バージョンをテストし、ダウンタイムをスケジュールしましたか？

スキーマと XEngine の移行について

スキーマの移行はリポジトリデータベースを更新し、 XEngine の移行は標準サブセットのModulesとそれに接続されたTestCasesを更新します。

移行が必要かどうか、またその方法を学ぶためには、 "スキーマの移行" と "XEngine の移行" を確認してください。

アップグレードを実行する

ToscaCommander をアップグレードするには、以下の基本的なワークフローに従ってください。

  • データをバックアップします。

  • アップグレードを実行します。

  • アップグレードを完了してください。

ユースケースをお選びください。

データのバックアップ

始める前に、バックアップを作成してください。

  • ディレクトリとその子フォルダにある設定ファイルをバックアップします。%COMMANDER_HOME%アップグレードする際、Toscaはこれらの設定ファイルの新しいバージョンをインストールし、古いものを上書きします。

  • エンジン、コントロール、キーワード、リカバリースクリプトなどのカスタマイズをバックアップします。

  • リポジトリをバックアップします。これは単なる予防措置で、通常、アップグレード後にリポジトリを復元する必要はありません。

設定ダイアログで変更した設定をバックアップする必要はありません。Toscaはこれらの設定をそのまま維持します。基礎となるファイルは %TRICENTIS_ALLUSERS_APPDATA%\Settings ディレクトリで見つけることができます。

アップグレードを実行する

Tosca Commander を2024.2にアップグレードするには、以下の手順に従ってください。

  1. 以下のいずれかの方法で古いバージョンをアンインストールします。

  2. カスタマイズをアンインストールします。

  3. %COMMANDER_HOME% ディレクトリから残りのファイルをすべて削除します。

  4. 以下のいずれかの方法で新しいバージョンをインストールします。

アップグレードを完了する

アップグレードを完了させるために、カスタマイズ、プラグイン、設定を再追加してください。

  1. カスタマイズとアドオンを再コンパイルし、それぞれの場所に保存します。ToscaCommander を初めて起動する前にこの作業を行う必要があります。

    • カスタマイズを C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\TBox に保存します。

    • アドオンを %COMMANDER_HOME% に保存します。

  2. Tosca Commander API に基づいて作成したコードを再コンパイルしてください。

  3. 必要に応じて、XBrowser用のFirefoxおよびChromeプラグインをインストールします。

  4. 設定を確認し、更新してください。アップグレードプロセスは、すべてのconfig ファイルの新しいバージョンをインストールし、新しいバージョンは、以前のインストールの設定を上書きします。設定を再確立するには、以下の手順を実行します。

    • %TRICENTIS_ALLUSERS_APPDATA%\ConfigBackup<timestamp>\ToscaCommander にアクセスすると、古いファイルのバックアップを見つけることができます。

    • バックアップの情報を使って、新しいバージョンの .dll.config ファイルを手動で更新します。

バックアップファイルは参照用としてのみ使用してください。

  • 新しいバージョンのファイルをお使いのバックアップファイルに置き換えないでください。

  • 新旧バージョンの設定の違いをチェックせずに、バックアップファイルから全内容をペーストしないでください。

設定ダイアログで変更した Tosca Commander の設定を復元する必要はありません。Toscaはこれらの設定をそのまま維持します。

データのバックアップ

始める前に、バックアップを作成してください。

  • ディレクトリとその子フォルダにある設定ファイルをバックアップします。%COMMANDER_HOME%アップグレードする際、Toscaはこれらの設定ファイルの新しいバージョンをインストールし、古いものを上書きします。

  • エンジン、コントロール、キーワード、リカバリースクリプトなどのカスタマイズをバックアップします。

  • リポジトリをバックアップします。これは単なる予防措置で、通常、アップグレード後にリポジトリを復元する必要はありません。

設定ダイアログで変更した設定をバックアップする必要はありません。Toscaはこれらの設定をそのまま維持します。基礎となるファイルは %TRICENTIS_ALLUSERS_APPDATA%\Settings ディレクトリで見つけることができます。

アップグレードを実行する

Tosca Commander を2024.2にアップグレードするには、以下の手順に従ってください。

  1. 以下のいずれかの方法で古いバージョンをアンインストールします。

  2. カスタマイズをアンインストールします。

  3. %COMMANDER_HOME% ディレクトリから残りのファイルをすべて削除します。

  4. 以下のいずれかの方法で新しいバージョンをインストールします。

アップグレードを完了する

アップグレードを完了させるために、カスタマイズ、プラグイン、設定を再追加してください。

  1. アドオンを準備してください。

    • 以下に移行します。NET82024.1より、 ToscaCommander はNET8で動作します。

    • Prefer 32ビットオプションの選択を外します。2024.1より、 32ビットのサポートを廃止しました。

    • PropertyGroup 属性 TargetFramework を net8.0-windows に設定します。

    NETに移行した後はAssemblyInfos.cs は必要ありません。削除したい場合は、 Microsoftのベストプラクティスに従って、すべての設定を csproj ファイルに含めることができます。

  2. Tosca Commander API に基づいて作成したコードを準備してください（新しいタブで開きます）。

    • 以下に移行します。NET82024.1より、 ToscaCommander はNET8で動作します。

    • Prefer 32ビットオプションの選択を外します。2024.1より、 32ビットのサポートを廃止しました。

    • PropertyGroup 属性 TargetFramework を net8.0-windows に設定します。

    • PropertyGroup 属性 UseWindowsForms を TRUE に設定します。

  3. カスタマイズとアドオンを再コンパイルし、それぞれの場所に保存します。ToscaCommander を初めて起動する前にこの作業を行う必要があります。

    • カスタマイズを C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\TBox に保存します。

    • アドオンを %COMMANDER_HOME% に保存します。

  4. Tosca Commander API に基づいて作成したコードを再コンパイルしてください。

  5. 必要に応じて、XBrowser用のFirefoxおよびChromeプラグインをインストールします。

  6. 設定を確認し、更新してください。アップグレードプロセスは、すべてのconfig ファイルの新しいバージョンをインストールし、新しいバージョンは、以前のインストールの設定を上書きします。設定を再確立するには、以下の手順を実行します。

    • %TRICENTIS_ALLUSERS_APPDATA%\ConfigBackup<timestamp>\ToscaCommander にアクセスすると、古いファイルのバックアップを見つけることができます。

    • バックアップの情報を使って、新しいバージョンの .dll.config ファイルを手動で更新します。

バックアップファイルは参照用としてのみ使用してください。

  • 新しいバージョンのファイルをお使いのバックアップファイルに置き換えないでください。

  • 新旧バージョンの設定の違いをチェックせずに、バックアップファイルの内容を丸ごと貼り付けないでください。

設定ダイアログで変更した Tosca Commander の設定を復元する必要はありません。Toscaはこれらの設定をそのまま維持します。