UiPath Orchestrator Guide

Managing Your Licenses

Renewing Your License

  1. Open the Command Prompt as an administrator on a machine you installed a UiPath Robot or Studio.
  2. Change the directory to the installation path of the UiPath suite. For example, cd C:\Program Files (x86)\UiPath\Studio\UiPath.
  3. Activate your license using the Regutil tool by executing the following command: regutil activate /email=emailaddress /code=licensecode.
  4. Check if the license was activated using the regutil.exe get-info command. Starting with 18.1.3, the license expiry date is displayed in the Subscription expire date field.
  5. Export the license information to a file by executing the following command: regutil export-info /out_file=D:\license.txt. The file is saved to the indicated directory.

Note:

The output file can be of any type. If you do not provide a full path for the file, it is saved in the installation folder of the UiPath suite, cd C:\Program Files (x86)\UiPath\Studio\UiPath.

  1. In Orchestrator, navigate to the User > License at tenant level, or simply click License at host level. The License page is displayed.
  2. Click Renew. The Open window is displayed.
  3. Browse for the license file generated at step 5 and click Open. The information is uploaded to Orchestrator, and the License page is updated to display the new number of available licenses per type, and the new expiry date. For more information on how they are consumed, please see the About Licensing page.

Important

You can only change your host license with a new one if the number of used licenses is equal or lower than that provided by the new license. For example, I have a license for 20 Attended Robots and all of them are distributed to my tenants. If I want to switch to a license for 10 Attended Robots, I am required to remove the licenses for at least 10 of my Robots in order to be able to upload the new license.

Allocating Licenses

Keep in mind that you can only allocate licenses to tenants at host level.

Note

This section only concerns enabled tenants which are to be licensed using a joint license, the host license. You can not allocate licenses to a tenant which is using an individual license unless you first remove it.

From the Tenants page

  1. In the Tenants page, click the Allocate Licenses button for a tenant. The Allocate Licenses page is displayed. If the tenant is licensed you must first proceed to remove the existing license before starting to allocate new ones.
  2. At the end of each row you can see the number of available licenses and their total number at host level. Allocate licenses as you wish, but keep in mind that you can not exceed the maximum per category.
    • In the below screenshot, we allocated 2 licenses for Attended Robots, meaning that 1 out of 10 licenses was still available.
  1. Click Allocate. Note that the Tenants page has been updated according to your changes. Take into account that the Allocate button is only enabled if you make some changes.

Note

When you allocate licenses to a tenant for the first time, you have 2 Development licenses allocated by default. The two licenses are free for testing purposes, up until you license your tenant by allocating a paid license to it. Note how in the first screenshot below, the 2 licenses do not affect the count at the end of the row. The moment you allocate a paid one, you have a licensed tenant, and the 2 Development ones are counted as well. If no Development licenses have been purchased, a message (There are no more licenses of this type available for allocation) is displayed and you have to decrease the number to 0 in order to be able to complete the process.

From the License page

  1. Click Allocate. The Allocate Licenses window is displayed.
  1. Choose the desired tenant from the Tenants drop-down list or simply fill in its name.
  2. Allocate the Robot licenses as needed, as long as they are within the limit of each category, and click Allocate. Note that the Allocate Licenses window is updated.

Removing Tenant Licenses

From the Tenants page

Note

This page is only available at host level.

As this page represents a centralized location of all tenants, you can remove licenses for multiple of them.

  1. In the Tenants page, click the Allocate Licenses button for the tenant which concerns you. The Allocate Licenses window is displayed.
  2. For deleting the license from the tenant, click Remove. Note that the Remove button is only displayed for already licensed tenants. Click Yes to confirm when prompted. The Allocate Licenses window is updated.
  3. Click Close. Note the Tenants page is updated as well, and on the License column, your tenant is displayed as Unlicensed.

From the License page

At Tenant Level

  1. In the License page, click Remove. A dialog box is displayed, asking if you are sure you want to perform this action.
  2. Click Yes. Your license is deleted. Note the License page is updated and your tenant is displayed as Unlicensed.

At Host Level

  1. Click Allocate. The Allocate Licenses window is displayed.
  2. Choose your tenant from the Tenants drop-down list or simply fill in the name of your tenant.
  3. Click Remove and then Yes when prompted. Note that the Allocate Licenses window is updated. Take into account that the Remove button is only displayed for licensed tenants.

Removing Your Host License

You can only remove the host license at host level, from the License page.

  1. In the License page, click Remove. A dialog box is displayed, asking if you are sure you want to perform this action.
  2. Click Yes. Your license is deleted. Unlicensed is displayed as the License page is updated.

Note that after removing the host license, all host licensed tenants become unlicensed.

Displaying License Details

To view more information about how Robot licenses are consumed per type, click the corresponding See More button. A page with the corresponding name is displayed:

Viewing Robots

It is possible to see all the Robots defined on a given machine for Unattended and NonProduction licenses, or with a specific user for Attended and Development licenses. To display this information, perform the following steps:

  1. In the License page, click See More for the type of license that interests you. The corresponding page is displayed.
  2. Click the View Robots button next to a user or machine. The Robots page is displayed, filtered to display only the Robots that have the indicated user or machine.

Editing Runtimes

To edit the number of runtimes allocated to a machine:

  1. In the License page, click See More for the type of license that interests you. The corresponding page is displayed.
  2. Click the Edit Runtimes button for a machine. The Edit Machine Runtimes window is displayed.
  3. In the Number of Runtimes input the number of processes that you want to be able to execute simultaneously on a specific machine.
  4. Click Update. The number of specified runtimes is allocated to that machine and you can start running jobs on it.