Install Tosca Server

Tosca Server is a bundle of complementary features for Tosca that extends your test environment, scope, and execution.

If you're in charge of setting up Tosca Server, this section of the manual is for you. It explains important setup decisions and guides you through the installation process.

Before you start

Before you start the installation process, make sure you meet these requirements:

  • You have downloaded the installation package. Please note that you can't mix and match versions; Tosca Server and Tosca must have the same version number.

  • You have administrator rights on the machine where you install Tosca Server.

  • You have all necessary software and hardware listed in the Tosca Server system requirements.

  • The ports that Tosca Server requires are free.

  • If you want to use the Tosca Administration Console or the Tosca REST API Service: you have installed Tosca on the machine where you want to install Tosca Server. If you install Tricentis Tosca after you have installed Tosca Server, you need to reboot your machine in between.

System restarts

The installation may require one or more restarts of the operating system.

If you want full control over your restarts and avoid automatic restarts, install the following components manually before you install Tosca Server:

Installation process

To install Tosca Server, follow these steps:

  1. Perform the installation, either via setup dialog or in unattended mode.

  2. Configure Tosca Server and its features in the Tricentis Service Configuration.

    Depending on your use case, you may also have to perform these actions:

  3. Some features are inactive by default. If you want to use any of the features in the table, perform these tasks: 

    • Perform additional configurations.

    • Set the service's Startup type to Automatic in the Windows Services app.

    Feature

    Additional configuration

    Service you need to start after configuration

    Interactive Testing

    Configure Interactive Testing Server

    Tricentis.InteractiveTestingServer

    Exploratory Testing

    Configure Exploratory Testing Server

    Make sure you enter a valid activation key.

    Tricentis.ExporatoryTestingServer

Tosca Server landing page

Tosca Server includes the Tosca Server landing page, which gives you access to Tosca Server features through a single web interface. Additionally, you can use it to configure service settings and perform service health checks.

To access the page, follow these steps:

  1. Enter the following URL: http(s)://<DNS name of the Tosca Server machine>:<Tosca Gateway port>.

    In HTTPS setups, make sure you enter the same name that you use in your certificate. If you're unsure about the name, check the ServiceDiscovery setting in C:\Program Files (x86)\TRICENTIS\Tosca Server\Gateway\appsettings.json.

  2. If you use an HTTPS binding, sign in with your Tricentis User Administration credentials.

Tosca Server landing page

Removal process

For information on how to uninstall Tosca Server, check out "Maintain the Tosca Server installation".