Install Tosca Server

This topic gives you an overview of the Tosca Server features and the installation process.

For information on how to install Tricentis Tosca, click here.

Tosca Server with Gateway

For a smoother use of the features and services, Tosca Server allows clients to access every self-hosted service through a single endpoint: the Gateway. Gateway utilizes Ocelot Gateway Framework as an API gateway and a reverse proxy. As an API gateway, it controls API requests, and as a reverse proxy, it validates and forwards client requests to other components of the Tosca Server. The Gateway is a firewall and a communication proxy between clients and the Tosca Server. Communication is safer, because clients don't communicate directly with the dedicated services within the Tosca Server.

The Gateway also functions as a service of its own. It encapsulates the Tosca Server Landing Page and Tricentis Service Discovery which is now hosted by the third-party service Consul.

Tosca Server features

The Tosca Server contains the following self-hosted components:

Prerequisites

To install the Tosca Server, you must fulfill the following requirements:

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

  • The Tosca Server that you want to install has the same version number as your installed version of Tricentis Tosca.

  • You have local administrator rights, which you need to install the Tosca Server.

  • Make sure that the ports required by Tosca Server are free.

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

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 the Tosca Server:

Installation process

To install the Tosca Server, follow these steps:

  1. Perform the installation in one of the following ways:

  2. To use one of the following Tosca Server features, you must configure them before you start them:

  3. Some services are disabled by default. If you want to use them, you need to enable them manually. To do so, open the Windows Services app and set the Startup type to Automatic for the following services:

    This step is especially important for Tricentis Notification Service. If you don't enable it, you can't make the necessary configurations in the Tricentis Service Configuration.

  4. Configure your Tosca Server services in the Tricentis Service Configuration. Saving your configurations starts/restarts the service you configured.

  5. If you use Tosca Server with an HTTPS binding, make the necessary modifications.

Maintain the installation

You can uninstall the Tosca Server.

Tosca Server landing page

The installation of the Tosca Server includes the installation of the Tosca Server landing page. This page gives you access to all server features through a single web interface and to monitor the availability of your installed services.

To access the page, follow these steps:

  1. Type the following URL: http(s)://<server address>:<port>.

    • Replace <server address> with the address of Tosca Gateway Service.

    • Replace <port> with Tosca Gateway Service port.

  2. If you use an HTTPS binding, authenticate to access the page.

Tosca Server Landing Page