DOCUMENTATION

Introduction

Designed for MuleSoft RPA, TSplus RPA Connector for Windows enables a single MuleSoft RPA Bot running multiple parallel MuleSoft process sessions on any PC.

Why the need for Robotic Process Automation?

Robotic Process Automation (RPA) is a software technology that makes it easy to deploy and manage software robots. It's a key technology for digital transformation in all industries and across all departments. Companies and organizations that automate processes with software robots increase their competitiveness in a digitalized and globalized market.

TSplus MuleSoft RPA Connector enables automation on Windows systems

The TSplus Robotic Process Automation connector for MuleSoft RPA is an easy-to-use software connector, which enables running multiple parallel digital tasks on a single Windows system (W10, W11 or Windows servers). You can scale vertically digital tasks on a single Windows system rather than installing multiple RPA Bots across a larger Windows machine footprint.

Servicetrace becomes MuleSoft RPA

Salesforce has acquired Servicetrace, which is now a part of the MuleSoft family of products. The robotic process automation capabilities from Servicetrace are now delivered as MuleSoft RPA. For more information about Servicetrace and MuleSoft RPA, please visit this link.

TSplus MuleSoft RPA Connector was specifically developed to support Servicetrace software and is fully compatible with the new MuleSoft RPA solution.

Prerequisites

The following sections detail the minimum requirements for installing and running TSplus MuleSoft RPA Connector.

Operating system

Microsoft Windows 7 Service Pack 1 (build 6.1.7601) or Windows 2008 R2 Service Pack 1 (build 6.1.7601) or higher. TSplus MuleSoft RPA Connector supports 32-bit and 64-bit architectures.

.NET framework

.NET framework 3.5 or higher.
.NET framework runtimes are available for download from the Microsoft website.

Network

Please configure your proxy settings accordingly. See section "Configure proxy settings" below.

Quick start

You are all set. Thank you for using TSplus MuleSoft RPA Connector!

Get your license(s)

When installing TSplus MuleSoft RPA Connector from the setup wizard or the command line, the setup requires a license key to proceed. If the license key is not provided during the first installation, then a full featured 15-day trial period starts following the installation.

You can order 1 or more licenses on this page.

One license allows an installation of TSplus MuleSoft RPA Connector on one computer. Don't forget to enter the number of licenses you need on the box above the "Buy now" button before clicking it. The default quantity is 1.

After the payment, you will receive your license(s) key(s) in an email at the address provided during the checkout.

Installation

You can download TSplus MuleSoft RPA Connector setup program here.
‍‍Administrator privileges are required to run the setup program.

Get started

You are all set. Thank you for using TSplus MuleSoft RPA Connector!

Install from the setup wizard

Enter your license key and click on the Next button to continue.
‍(Leave this field blank if you are starting the 15-day free trial period)

The License Agreement page invites you to accept the terms of TSplus MuleSoft RPA Connector’s license agreement.

Select I accept the agreement, and then click Next.

You are now ready to install TSplus MuleSoft RPA Connector. Please note that canceling setup will not be possible past this page.

Click on the Install button to proceed with the installation.

TSplus MuleSoft RPA Connector is now installed on your system. Click Finish to exit the setup program.

Leave the checkbox Run TSplus MuleSoft RPA Connector checked if you want to activate your license or check for updates.

There is no need to reboot before using TSplus MuleSoft RPA Connector, unless prompted to by the setup program.

Install silently from the command line

The TSplus MuleSoft RPA Connector setup program can be executed from the command line to perform an unsupervised and silent installation.

> Setup-TSplus-RPA.exe [/VOLUMELICENSEKEY=<your license key> /VERYSILENT] [/NORESTART]

• Order number is required and must be entered as the /VOLUMELICENSEKEY parameter
• Install silently by using the /VERYSILENT parameter
• Prevent rebooting at the end of the setup with the /NORESTART parameter

For example, run the following command (using your license key) to install silently and without rebooting at the end of the installation:

> Setup-TSplus-RPA.exe /VOLUMELICENSEKEY=VOLU-MELI-CENS-EKEY /VERYSILENT /NORESTART

You can confirm that the installation was successful by reviewing the setup_success.log file created in the logs directory of TSplus MuleSoft RPA Connector setup directory (typically, C:\Program Files (x86)\TSplus-RPA). This file may be attached to future support requests to provide more information about the current TSplus MuleSoftRPA Connector installation.

Upgrade from TSplus for Servicetrace

TSplus for Servicetrace has been discontinued. TSplus MuleSoft RPA Connector replaces TSplus for Servicetrace, bringing significant improvements such as automatic Windows compatibility updates.

FROM THE COMMAND LINE -> Prior to upgrading from TSplus for Servicetrace, you must first uninstall TSplus program and reboot.

FROM THE SETUP WIZARD-> When installing from the setup wizard, you will be prompted to uninstall TSplus and reboot.

Once rebooted, run Setup-TSplus-RPA.exe again to resume the installation of TSplus MuleSoft RPA Connector.

Update

TSplus MuleSoft RPA Connector is frequently updated to include security fixes and Windows compatibility updates.

Usually, there is no need to reboot after updating TSplus MuleSoft RPA Connector. However, the setup may prompt you to do so.

Update from the administration program

The administration program displays the current version of the software and enables the download of the updated setup program in one click. To download the available update, click on the tile marked by a red ‘X’.
The most recent setup program will be downloaded in your  Downloads folder.

Update from the command line

The administration program can be executed from the command line to perform a silent update.

> TSplus-RPA.exe /update [/silent]

-> Update silently by providing the /silent parameter. No message box will be displayed.

Apply Windows compatibility updates

TSplus RPA introduces automatic Windows compatibility updates. These automatic updates ensure that TSplus RPA remains compatible with new Windows updates and avoid the need to download and reinstall a newer version of TSplus RPA.

Windows compatibility updates can occur daily. TSplus RPA allows forced updating. This is useful when compatibility seems broken, and you need to retrieve the latest TSplus MuleSoft RPA Connector compatibility patch outside of the regular update schedule.

Open a command prompt as an administrator located in TSplus MuleSoft RPA Connector setup directory (typically: C:\Program Files (x86)\TSplus-RPA). Then, execute the following command:

> svcac.exe /updatekernel [/silent]

-> Update silently by providing the /silent parameter. No message box will be displayed.

If your installation of TSplus MuleSoft RPA Connector is up to date, the message box above is displayed.

Please note that a valid license is required to retrieve compatibility updates. If your trial license has expired or if your license is invalid, the message box above will be displayed. Please contact our support team with a screenshot of this error message if the issue is unexpected.

Manage your licenses

TSplus MuleSoft RPA Connector administration program displays the status of your license. The example below shows the status of an activated permanent license:

Activate your license after setup

If you have installed your product without providing a license key, then a 15-day trial period starts following the installation.

To activate your license, run the following command line as an elevated administrator from TSplus MuleSoft RPAConnector setup directory (typically, C:\Program Files (x86)\TSplus-RPA):

> TSplus-RPA.exe /vl /activate <your license key> [/silent]

• License key is required and must be used as parameter
• Execute silently by using the /silent parameter

For example, run the following command to activate the license on your installation providing your license key. A message box will display the result since the /silent parameter was omitted:

> TSplus-RPA.exe /vl /activate VOLU-MELI-CENS-EKEY

Disable your license

Disabling a license puts that license back into your available pool of licenses. To disable the license assigned to a computer, run the following command line as an elevated administrator from TSplus MuleSoft RPA Connector setup directory (typically, C:\Program Files (x86)\TSplus-RPA):

> TSplus-RPA.exe /vl /disable <your license key> [/silent]

• License key is required and must be used as parameter
• Execute silently by using the /silent parameter

For example, run the following command to disable the license on your installation providing your license key. A message box will display the result since the /silent parameter was omitted:

> TSplus-RPA.exe /vl /disable VOLU-MELI-CENS-EKEY

For example, run the above command to disable the license on your installation providing your license key.

Configure proxy settings

Proxy settings defined during the installation are saved. If no proxy settings were defined, then the Windows compatibility update service uses Internet Explorer proxy settings.

Configure proxy settings during installation

The proxy configuration can be done through the command line while installing TSplus MuleSoft RPA Connector. These parameters can be specified additionally to the parameters defined in section Install silently from the command line.

> Setup-TSplus-RPA.exe [/PROXYHOST=<ie|none|proxy.company.org> [/PROXYPORT=<80>] [/PROXYUSERNAME=<user> /PROXYPASSWORD=<password>]

For example, run the following command to configure a company proxy "proxy.company.org" which listens on port 3128:

> Setup-TSplus-RPA.exe /PROXYHOST=proxy.company.org /PROXYPORT=3128

Configure proxy settings after installation

Once the software is installed, you can also configure the proxy settings manually by running the following command line, as an elevated administrator from TSplus MuleSoft RPA Connector setup directory:

> TSplus-RPA.exe /proxy /set /host <ie|none|proxy.company.org> [/port <80>] [/username <user> /password <password>]

The following parameters are used to configure the proxy:

/host <ie|none|custom>

The destination host can be a predefined value (e.g. "ie" or "none") or a user-defined value (ex. 127.0.0.1 or proxy.company.org). This parameter is mandatory.

/port <80>

The port number used to connect to the proxy server. Required if the hostname value is a custom user-defined value.

/username <user>

The username to connect to the proxy server. This setting is optional.

/password

The user’s password must be supplied if a username has been defined. However, its value can be empty.

For example, run the following command to configure a company proxy "proxy.company.org" which listens on port 3128:

> TSplus-RPA.exe /proxy /set /host proxy.company.org /port 3128

For example, run the above command to disable the license on your installation providing your license key.

Troubleshooting

Below are a few common troubleshooting techniques. If you require further assistance, our support team is standing by to help.

Review the log files

Below are the log files available when installing or using TSplus MuleSoft RPA Connector:

WHEN THE SETUP SUCCEEDS ->

The setup_success.log file is created in the logs directory in TSplus RPA setup directory (typically: C:\Program Files (x86)\TSplus-RPA) when the setup program runs successfully. This file provides detailed information about the current installation.
‍
Note: This file may be useful to confirm the successful installation while installing TSplus MuleSoft RPA Connector silently.

WHEN THE SETUP FAILS ->

The setup_error.log file is created in the same directory as the setup program (typically, your download folder) when the setup program fails. This file provides detailed information about any error which have occurred during the setup process and includes resolution steps.
‍
For example, the extract below invites the user to specify another order number with remaining available installations:

---- SETUP FAILED ----
An error occurred while installing TSplus MuleSoft RPA Connector (15.50.7.4) at 05-07-2022 10:50:47
Failed to register the software: there is no remaining installation for the provided license key (ERROR=VL-NOT-ENOUGH-LICENSES-AVAILABLE Please contact us).

Also, the extract below invites the user to review the license key specified as it is not known of our licensing portal:

---- SETUP FAILED ----
An error occurred while installing TSplus MuleSoft RPA Connector (15.50.7.4) at 05-07-2022 10:50:47
Failed to register the software: the provided license key does not exist (ERROR=VL-INVALID-KEY Please contact us).

WHEN A WINDOWS COMPATIBILITY UPDATE FAILS->

The following log contains technical content and is designed to be analyzed by the technical support team.

• The svcmain_versions.txt file is created in TSplus MuleSoft RPA Connector setup directory (typically: C:\Program Files (x86)\TSplus-RPA) when the Windows compatibility update runs. This file provides detailed information about the supported Windows version.
• The svcac.txt log file is created in the logs directory in TSplus MuleSoft RPA Connector setup directory (typically: C:\Program Files (x86)\TSplus-RPA) when the Windows compatibility update runs in debug mode. This file provides detailed information about the Windows compatibility update.

By default, this log is deactivated. You can activate this log by setting the value debug of the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Digital River\JWTS to true. It is not recommended to leave the log activatedfor a prolonged period of time in a production environment.

WHEN AN OPERATION ON LICENSING FAILS->

The following log contains technical content and is designed to be analyzed by the technical support team.

• The Application.log file is created in the logs directory in TSplus MuleSoft RPA Connector setup directory (typically: C:\Program Files (x86)\TSplus-RPA) when the administration program executes a command or is opened. This file provides detailed information about the license and overall program status.
• The VolumeLicensing.log file is created in the logs directory in TSplus MuleSoft RPA Connector setup directory (typically: C:\Program Files (x86)\TSplus-RPA). This file provides the responses from the License server while activating, enabling or disabling a license.

Contact our support team

Do not hesitate to contact us at https://support.tsplus.net if any issues arise. Please provide the log files listed in the
‍previous section if they exist.

Security

Aside from TSplus RPA Connector for Windows, TSplus provides a complete suite of software products. One of them is TSplus Advanced Security, a unique all-in-one tool to prevent cyberattacks of your IT infrastructure and stop intruders.

TSplus Advanced Security provides the fundamental protections every Windows system must have. When using Remote Desktop, TSplus Advanced Security’s powerful features are blocking RDP attackers and every single security threat you can think of.

Learn more