Upgrade Tosca Commander

The basic workflow of a Tosca Commander upgrade from Version 12.3 to 13.0 is as follows:

  1. Perform the necessary preparatory steps: create backups and clean up %COMMANDER_HOME%.

    You need to perform these steps on every machine that has Tosca Commander installed.

  2. Upgrade Tosca Commander. You can do so in one of the following ways:

    • Upgrade via uninstall / reinstall if you want full control over your upgrade and log files.

    • Upgrade via setup file. This type of upgrade implicitly removes the previous Tricentis Tosca version.

    • Upgrade via command line. Tricentis recommends that you use this option if you want to upgrade multiple clients at once.

  3. Perform the necessary final steps of your Tosca Commander upgrade.

    You need to perform these steps on every machine that has Tosca Commander installed.

Tricentis recommends that you install and test the new Tosca version on a test computer prior to performing the upgrade.

Install the new Tosca version on your productive clients only if the installation on your test environment is successful and operable.

The following chapters explain the upgrade process in detail.

Preparatory steps

Before you perform the actual upgrade, follow the preparatory steps listed below:

  1. If you have multiuser workspaces in your 12.3 project, check in all objects you want to include in your backup:

    • Find all checked out objects with the following TQL search query on the project root element:

      ->AllOwnedSubItems[CheckOutState == "CheckedOut"]

    • Right-click the search elements and select Revoke Checkout from the context menu.

  2. Back up your repositories. This step is only necessary if you intend to perform your migration manually.

    If you intend to migrate via Tosca Administration Console, you create your backup during the migration.

  3. Back up any customizations, such as settings, engines, controls, keywords, recovery scripts, etc.

    Any settings you adjusted in %TRICENTIS_ALLUSERS_APPDATA%\Settings are maintained.

  4. Uninstall your customizations.

  5. Remove all remaining files from the directory %COMMANDER_HOME%.

    The default path for Tricentis Tosca installations is C:\Program Files (x86)\TRICENTIS\Tosca Testsuite.

  6. To avoid conflicts, Tricentis recommends that you disable specific runtime environments, such as Java and PowerBuilder.

Upgrade Tosca Commander

You can upgrade Tosca Commander in one of the following ways:

Upgrade via uninstall / reinstall

To upgrade via uninstall /reinstall, follow the steps below:

  1. In the Windows Control Panel, select Programs and Features.

  2. Click the list entry Tricentis Tosca and select Uninstall from the dropdown menu.

  3. In the subsequent dialog, confirm the uninstallation by clicking Yes.

  4. Install 13.0 by double-clicking the installation file ToscaTestSuite<version number>.exe.

  5. Perform the installation as described in chapter "Tricentis Tosca installation overview" and chapter "Perform the installation".

Upgrade via setup file

To upgrade via setup file, follow the steps below:

  1. Run the installation file ToscaTestSuite<version number>.exe.

    The system automatically identifies the installed Tricentis Tosca version and starts the upgrade process.

  2. Perform the installation as described in chapter "Tricentis Tosca installation overview" and chapter "Perform the installation".

Upgrade via command line

To perform the Tosca Commander upgrade, enter ToscaTestSuite<versionnumber>.exe /s <MSI commands> /qn at the command prompt.

For information on possible parameters and MSI commands, see chapter "Install Tricentis Tosca in unattended mode".

Final steps of the Tosca Commander upgrade

To finalize your upgrade, follow the steps below:

  1. Install the latest versions of any existing custom AddIns. You need to do this before starting Tosca Commander for the first time.

  2. Recompile customized extensions (customizations, AddIns, and AddOns) and save them to the respective directories: %TRICENTIS_HOME% for classic customizations, %TBOX_HOME% for TBox customizations, and %COMMANDER_HOME% for AddOns or AddIns.

    Recompile customizations based on the Tosca Commander API with each new version (API programs, AddOns).

  3. Install Firefox and Chrome plugins for XBrowser, if necessary.

  4. Re-enable your runtime environments (see chapter "Enabling the Java Runtime Environment with Tosca Enabler" and chapter "Activating the application with PBEngine Enabler").