Install Tricentis Tosca via setup dialog

You can install Tricentis Tosca in one of the following ways:

This chapter explains how to install Tricentis Tosca via setup dialog.

Prerequisites

Before you start the installation, ensure that you meet all requirements listed in chapter "Install Tricentis Tosca".

Start the installation

To start the installation, double-click the .exe installation file in your installation package. This opens the install wizard that guides you through the installation process.

On the start page, agree to the license terms and conditions and select Continue to proceed.

Tricentis Tosca Installer

If you already have an earlier version installed, select the check box and click Upgrade. This uninstalls the existing version and installs the new version with the default components to the previously configured folders.

However, Tricentis recommends that you do a clean uninstall and reinstall. For more information on how to upgrade, see the upgrade manual.

License information for third-party software components

Tricentis Tosca uses third-party software components. After a default installation, you can find a list of these components and the corresponding license information at C:\Program Files (x86)\Tricentis\Tosca Testsuite\License.url.

Navigate the Installer

You can see all steps of the installation process as tabs on the left side of the installer window.

To navigate between the installation steps, click Next to proceed or Back to modify a previous step. You can also return to a previous step by clicking on the respective tab.

Steps of the installation process

Check prerequisites

Tosca requires some prerequisites to work properly. The installer displays all prerequisites and checks whether the required components are available in the system:

  • indicates that a component is available.

  • indicates that the installer needs to install a missing component, which it does automatically.

If you select a component on the list, the respective icon turns white.

Click Next to continue.

Select the setup type

You can select one of the following setup types:

  • Tosca Commander performs a default installation. This setup type installs the default components.

  • Execution Agent is an execution-only agent exclusively for Engines 3.0.

  • Custom Installation allows you to select components to install.

Default components

If you upgrade from an earlier version, you can only select Tosca Commander. To select a different setup type, remove your installed version manually and restart the installation process.

Select a setup type and click Next to continue.

Select the install location

To change the default destination folders, you must select directories to which all Tosca users have write access.

Network drives can not host the directories Tosca_Projects and APPDATA. The Tosca_Projects folder must be placed in a directory that is persistent on the machine.

To select a different directory, click Browse and select a destination folder in the subsequent dialog.

Select installation directories

Click Next to continue.

Enable diagnostics

You can help improve Tosca by sending anonymous usage statistics.

To enable diagnostics, select the check box.

Enable diagnostics

After installation, you can enable or disable diagnostics under Project->Settings->Diagnostics. For more information, see chapter "Settings - Diagnostics".

Click Next to continue.

Enable Tricentis Data Integrity

Tricentis Data Integrity allows you to end-to-end test your data integrity, Data Warehouse, and general data environments.

To work with Data Integrity, you need a valid Data Integrity license. For further information, contact your Tricentis sales person.

To enable Data Integrity for immediate use after the installation, select the check box and click Next to continue.

Enable Data Integrity

If you don't enable Data Integrity during the installation, you can do so later in the Tosca Commander options under Project->Options->Tosca Data Integrity.

Configure Vision AI

Tricentis Vision AI allows you to automate even the hardest-to-access UI systems thanks to deep learning technology.

Vision AI is installed by default. If you don't want to install it, deselect the check box Install Tricentis Vision AI Engine.

If you want to change the default Vision AI Server, enter the URL of your server into the Vision AI Server field and click Next to continue.

Enable Tricentis Vision AI

Custom Setup

If you have selected Custom Installation in the Select Setup Type dialog, you can customize Tosca with selected components.

Select the check boxes next to the components that you want to install.

Select components

Click Next to continue.

Browser extensions

In the following screen, choose which browser extensions to install.

To do so, select the respective check boxes. If you want to get automatic updates for your Google Chrome and Microsoft Edge browser extensions, turn on Auto-Update.

Choose browser extensions

Note the following when installing browser extensions:

  • Uninstall all Tricentis Automation Extensions before installing them via the setup dialog.

  • Disabling Auto-Update prevents you from disabling or updating these extensions in your browser.

  • Disabling Auto-Update only works if you have an Active Directory (AD) set up on your machine. For more information on this limitation, check these Google Chrome and Microsoft Edge documentation articles.

  • Uninstalling Tosca also removes all browser extensions that you have installed.

  • Repairing your Tosca installation automatically re-installs your browser extensions.

Review the installation

On the Review screen, you can review the installation and configuration.

If you want to make changes before the installation, click Change Features. The installer will redirect you to the Setup Type dialog.

Review dialog

Change your settings and continue with the installation as described above.

If you agree with the installation summary, click Install to run the installation.

Installation progress

On the Installation screen, you can follow the installation progress:

  • The icon indicates a successful installation.

  • The icon indicates an unsuccessful installation of a component.

Installation progress

Finish the installation

The installer displays the installation summary and indicates whether all components have been installed successfully.

Completed installation process

If a component did not install properly, click Show Logs. You can also find the installation logs in the %TEMP% folder on your local machine. If you cannot identify the problem based on the logs, contact Tricentis Support.

Click Finish to complete the installation.

The installation is now complete for the Microsoft® Windows user currently logged in. Tosca is available to other users as soon as you reboot Microsoft® Windows.