test-suite
2023.10
false
  • Studio installation
    • Installing Studio
  • Robot installation
  • Orchestrator installation
  • Test Manager installation
UiPath logo, featuring letters U and I in white

Test Suite Installation Guide

Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated Oct 9, 2024

Silent install

Install Test Manager silently on your machine through the command-line. For this option, you need to download and open a command-line to run the UiPath Test Manager installation kit. Alternatively, if you execute through PowerShell, you can call the installation package using .\UiPathTestManager.msi.

Make sure that your environment is ready, by meeting the and requirements.

Important: The APPPOOL_IDENTITY_TYPE and DB_AUTHENTICATION_MODE commands are case sensitive.

Commands

The following section lists the available command-line parameters, including options and default values.

Command

Description

INSTALLDIR (Optional)
Enables you to install Test Manager in a custom location. By default, TestManager is installed in C:\Program Files (x86)\UiPath\TestManager.
WEBSITE_PORT (Optional)
The port you want to use to enable the communication between the machine and Test Manager. If not specified, the default value is set to 443 to enable HTTPS. Since Orchestrator is using the same port, you need to specify a different one, if you have both components installed on the same machine.
CERTIFICATE_SUBJECT (Optional)

The name of the SSL certificate you want to use to secure connections with Test Manager. If not specified, the full machine name is used as default.

If you have multiple certificates with the same subject, you need to specify the thumbprint from Certificate Manager Tool.

PORT_DO_VALIDATE (Optional)
Enables you to select whether the website port availability validation is performed or not. Set to 1 to perform validation. Otherwise, set to 0 if you do not want to perform validation.
PORT_FIREWALL (Optional)
Enables you to select if the firewall rules are automatically added for this port. Set to 1 to create firewall rules. Otherwise, set to 0 if you do not want to set firewall rules.
HOST_NAMEAdd the Fully Qualified Domain Name (FQDN) or the DNS name of the server (for example, yourTestManagerInstance.yourDomain.com). This is the server host name for the virtual or physical instance of Test Manager.
APPPOOL_IDENTITY_TYPE

The type of application pool you are using for Test Manager. You can use one of the following parameters:

  • SpecificUser - Select this option to run the Test Manager website under an existing Windows or Domain Identity. You need to fill in the Username and Password fields;
  • ApplicationPoolIdentity - Select this option to run the Test Manager website under the default identity of the application pool.
APPPOOL_USER_NAME *
  • Mandatory command if APPPOOL_IDENTITY_TYPE is configured with the SpecificUser option.

    The username running the application pool.

APPPOOL_USER_PASSWORD *
  • Mandatory command if APPPOOL_IDENTITY_TYPE is configured with the SpecificUser option.

    The password of the user that is running the application pool.

DB_SERVER_NAME

The name of the server on which the database you want to use is located.

DB_DATABASE_NAME

The name of the database you want to connect to.

DB_AUTHENTICATION_MODE

Enables you to choose the authentication method for the database. You can use one of the following parameters:

  • WindowsIntegrated - This is the default option. If you choose this option, Test Manager connects to the database using the detected IIS Application Pool's Windows account and creates the database using the Windows Credentials of the currently logged in user;
  • ServerAuthentication - Choose this option to use your SQL Server Credentials. You need to fill in the SQL Username and Password fields.
DB_USER_NAME *
  • Mandatory command if DB_AUTHENTICATION_MODE is configured with the ServerAuthentication option.

    The SQL database user.

DB_USER_PASSWORD *
  • Mandatory command if DB_AUTHENTICATION_MODE is configured with the ServerAuthentication option.

    The SQL database user password.

ORCHESTRATOR_URL

The URL of the parent Orchestrator instance that you want to use.

IDENTITY_URL
The URL of the Identity endpoint of the Orchestrator instance specified by the ORCHESTRATOR_URL parameter.
TEST_MANAGER_URL

The URL of the Test Manager instance that will be created.

ORCHESTRATOR_TENANT_NAME
The Orchestrator tenant that you want to integrate with Test Manager. Set the value to Default if you want to use the default tenant. Otherwise, you need to specify the tenant name.
ORCHESTRATOR_ADMIN_PASSWORD
The administrator password of the Orchestrator tenant specified by the ORCHESTRATOR_TENANT_NAME parameter.
IDENTITY_INSTALLATION_TOKEN

The token generated through the Orchestrator Identity. You can generate the token in Orchestrator Identity Management by logging in as the host tenant. For more information, see Generate an installation access token.

/q

Installs the specified UiPath features silently, without displaying the user interface. Use this mode only for unattended installations.

/l*vx <LogFile> (Optional)

Generates an installer log file at the specified path. You can send the file further to our support team if, for any reason, you encounter difficulties during the installation process.

Shell Script Sample

UiPathTestManager.msi ` 
CERTIFICATE_SUBJECT=UserMachine.company.com `
APPPOOL_IDENTITY_TYPE=SpecificUser `
APPPOOL_USER_NAME=AppPoolUser `
APPPOOL_USER_PASSWORD=Password ` 
DB_SERVER_NAME=. `
DB_DATABASE_NAME=UiPathTestManagerDatabaseName `
DB_AUTHENTICATION_MODE=ServerAuthentication `
DB_USER_NAME=DatabaseUsername `
DB_USER_PASSWORD=Password ` 
WEBSITE_PORT=555 `
ORCHESTRATOR_URL=https://UserMachine.company.com `
IDENTITY_URL=https://UserMachine.company.com/identity `
TEST_MANAGER_URL=https://UserMachine.company.com:555 `
ORCHESTRATOR_TENANT_NAME=Default `
ORCHESTRATOR_ADMIN_PASSWORD=Password `
IDENTITY_INSTALLATION_TOKEN=GeneratedThroughOrchestratorIdentityManagement `
/q `
/l*xv <LogFile>UiPathTestManager.msi ` 
CERTIFICATE_SUBJECT=UserMachine.company.com `
APPPOOL_IDENTITY_TYPE=SpecificUser `
APPPOOL_USER_NAME=AppPoolUser `
APPPOOL_USER_PASSWORD=Password ` 
DB_SERVER_NAME=. `
DB_DATABASE_NAME=UiPathTestManagerDatabaseName `
DB_AUTHENTICATION_MODE=ServerAuthentication `
DB_USER_NAME=DatabaseUsername `
DB_USER_PASSWORD=Password ` 
WEBSITE_PORT=555 `
ORCHESTRATOR_URL=https://UserMachine.company.com `
IDENTITY_URL=https://UserMachine.company.com/identity `
TEST_MANAGER_URL=https://UserMachine.company.com:555 `
ORCHESTRATOR_TENANT_NAME=Default `
ORCHESTRATOR_ADMIN_PASSWORD=Password `
IDENTITY_INSTALLATION_TOKEN=GeneratedThroughOrchestratorIdentityManagement `
/q `
/l*xv <LogFile>
Tip: Check out the following additional actions:
  • Commands
  • Shell Script Sample

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.