Previous
Next

How to Install and Set Up Tosca Server for Your Test Automation Environment

osca Server is an essential component that extends the capabilities of Tricentis Tosca, offering features that enhance your test environment, scope, and execution. Whether you’re setting up Tosca Server for the first time or need a refresher on the installation process, this guide will walk you through everything you need to know.

Before You Start

Before diving into the installation, make sure you meet the following prerequisites:

1. Installation Package

  • Download the correct Tosca Server installation package. Ensure that the version of Tosca Server matches the version of Tosca you’re using. Mixing different versions will lead to compatibility issues.

2. Administrator Rights

  • You’ll need administrator rights on the machine where you plan to install Tosca Server.

3. System Requirements

  • Verify that your machine meets all the necessary hardware and software requirements for Tosca Server. These are outlined in the Tosca Server system requirements documentation.

4. Free Ports

  • Ensure that the required ports for Tosca Server are free and not blocked by firewalls or other services.

5. Tosca Installation

  • If you plan to use the Tosca Administration Console or the Tosca REST API, Tosca must already be installed on the same machine where you will install Tosca Server. If you install Tosca after installing the server, make sure to reboot your machine before continuing.

System Restarts

The installation process may require one or more system restarts. If you prefer more control over these restarts, you can manually install the following components before starting the Tosca Server installation:

  • .NET Framework 4.8
  • .NET 8

By installing these components ahead of time, you can prevent automatic restarts during the Tosca Server setup.

Step-by-Step Installation Process

Once the prerequisites are in place, follow these steps to install and configure Tosca Server:

1. Install Tosca Server

  • Run the Installation Package: Launch the Tosca Server installer and follow the on-screen instructions. You can choose between an interactive setup or install in unattended mode (useful for automated deployments).

2. Configure Tosca Server

After installation, you’ll need to configure Tosca Server:

  • Open the TricentisService Configuration utility to adjust the server settings according to your needs.

3. Configure Optional Features

Depending on your use case, you may want to enable additional features. Some features are disabled by default and require extra configuration:

  • Interactive Testing: If you plan to use Interactive Testing, configure the Interactive Testing Server and ensure that the service is started (service name: Tricentis.InteractiveTestingServer).
  • Exploratory Testing: To enable Exploratory Testing, configure the Exploratory Testing Server and input a valid activation key (service name: Tricentis.ExploratoryTestingServer).

4. Set the Service Startup Type

To ensure Tosca Server services start automatically, you must set the service’s Startup type to Automatic in the Windows Services app.

Using Tosca Server with HTTPS

If you wish to secure Tosca Server using HTTPS, additional configuration is required:

  • Modify Configuration: Make sure to adjust the necessary settings in the Tosca Server configuration files.
  • Use Correct DNS Name: When setting up HTTPS, be sure to use the DNS name of the Tosca Server machine that matches your SSL certificate. If you’re unsure of the name, check the ServiceDiscovery setting in the configuration file located at:C:\Program Files (x86)\TRICENTIS\Tosca Server\Gateway\appsettings.json

Accessing the Tosca Server Landing Page

Tosca Server includes a user-friendly landing page that provides easy access to all its features through a single web interface. From here, you can configure settings, check service health, and more.

To Access the Tosca Server Landing Page:

  1. Open a web browser and enter the following URL:
http(s)://<DNS name of Tosca Server>:<Tosca Gateway port>
  1. For HTTPS setups, ensure that the DNS name matches what is used in your SSL certificate.
  2. If you’re using an HTTPS connection, log in with your Tricentis User Administration credentials.

The Tosca Server landing page will give you quick access to service settings, system health checks, and much more.

Final Thoughts

Congratulations! You’ve successfully installed and set up Tosca Server in your environment. With its powerful features, you can now extend your testing capabilities and streamline test execution.

Remember: If you need to enable advanced features such as Interactive Testing or Exploratory Testing, you will need to perform additional configuration steps, such as setting the services to start automatically and entering activation keys where necessary.

For ongoing management and monitoring, be sure to utilize the Tosca Server landing page to keep track of system health and adjust settings as needed.

No images available.

Previous
Next