Subscribe

UiPath Installation and Upgrade

The UiPath Installation and Upgrade Guide

Server Installation

Before you begin

🚧

Important

If you want to install UiPath Process Mining or any of its components, you need
access to an environment, and you need a UiPath Process Mining license. Please
consult your UiPath Process Mining contact.

Windows Server

It is recommended to use a clean installation of Windows Server.
See Hardware and Software Requirements for the supported versions.

For production environments, it is recommended to use CPUs with high single-threaded performance, an SSD for storage, and enough RAM.

Web browser

A supported web browser must be installed on the server on which you want to install UiPath Process Mining. See Hardware and Software Requirements for the supported versions.

Part 1: Create the installation folder

Before you can install UiPath Process Mining you must copy the installation package to your server.
Follow these steps to create the installation folder.

Step

Action

1

Download the UiPath Process Mining installation package.

2

On the server, create a folder for UiPath Process Mining. For instance, D:\processmining.

In the rest of this guide, we will refer to this directory as <PLATFORMDIR>.

Note: For multiple installations on the same server, you must create a different folder for each installation.

3

Create the folder <PLATFORMDIR>\builds.

4

Place the installation package in the <PLATFORMDIR>\builds folder.
• Right click on the installation package.
• Select Extract All…. A sub folder is now created automatically.

In the rest of this guide, we will refer to this directory as <EXTRACTDIR>.

You have downloaded the installation package and copied it to your server. The package can now be installed.

Folder Compression

Cache files use a lot of disk space. To save disk space, it is strongly recommended to set the Compress contents to save disk space option for the UiPath Process Mining server installation folder.

Follow these steps to set the Compress contents to save disk space option.

Step

Action

1

In Windows Explorer, right click on the UiPath Process Mining installation folder <PLATFORMDIR> and select Properties....

2

On the General tab, click on Advanced....

3

Enable the Compress contents to save disk space option and click on OK (2x).

📘

Note

If you enable the Compress contents to save disk space option, you cannot enable the Encrypt contents to secure data option.

Part 2: Enable IIS on the server

You must enable IIS on the server on which you want to install UiPath Process Mining. Follow these steps to enable IIS.

Step

Action

1

Login on the server and open the Server Manager.

2

Go to the Manage menu and select Add Roles and Features.
Click on Next.

3

Click through the wizard and keep the default settings.
• In the Server Roles step, enable Web Server (IIS).
• Continue clicking through the wizard and reboot the server if necessary.

Grant permissions to IIS users

Follow these steps to grant permissions to IIS users.

Step

Action

1

In Windows Explorer, right-click on the UiPath Process Mining installation folder <PLATFORMDIR> and select Properties....

2

In the Security tab, click on Edit…, and then on Add….

3

Click on Locations…, select your local machine as the Location, and click on OK.

4

Enter IIS_IUSRS in the Enter the object names to select text box.

5

• Click on Check Names. Verify that IIS_IUSRS is prefixed with the hostname.
• Click on OK.

Note: For multiple installations with different users, use the users for that group instead of IIS_IUSRS.

6

In the Group or user names list, select IIS_IUSRS.

Note: For multiple installations with different users, use the users for that group instead of IIS_IUSRS.

7

In the list below find the Full control row, check Allow.

8

Click several times on OK to apply all changes and close all windows.

Requirements for external access

By default, Process Mining is only accessible externally through HTTPS. This requires that a port must be opened for external communication to enable end-users to access the platform using a web browser. Usually, port 443 is used for external communication.

If external access is needed, then a CA Certificate is required. The IT department may already have wildcard SSL certificates for your company domain name.

You have downloaded the installation package and copied it to your server. The package can now be installed.

Part 3: Install Process Mining

Follow these steps to install UiPath Process Mining on the server.

Step

Action

1

Run the following batch file: <EXTRACTDIR>\install\activate-build\activate-build.bat.

2

Copy the file <EXTRACTDIR>\install\processgold.lic to <PLATFORMDIR>.

3

Copy the directory <EXTRACTDIR>\install\databases to <PLATFORMDIR>.

4

From the install directory in the installation package, install the following packages:
iisnode-full-v0.2.18-x64-mv0.msi,
rewrite_amd64.msi,
vc_redist.x64.exe (for UiPath Process Mining 20.4 and earlier versions).

Note: For multiple installations on the same server, these packages need to be installed on the server only once.

5

Reboot the server, and verify that http://localhost shows an IIS test site.

IIS is enabled in Windows Server, and the prerequisites are installed. http://localhost shows the IIS test site.

See illustration below.

Part 4: Configuring IIS

Follow these steps to configure IIS.

Step

Action

1

Open Internet Information Services (IIS) Manager.

In the rest of this document, we will refer to this as IIS Manager.

2

In IIS Manager, select your server.
• Double click on Feature Delegation.
Note: For multiple installations on the same
server, you need to do this only once.

3

• In this list select Handler Mappings.
• In the panel on the right, click on Read/Write.
Note: For multiple installations on the same
server, you need to do this only once.

4

In IIS Manager, select your server again, and in the panel on the right, click on Restart.

5

In IIS Manager right click on Application Pools and click on Add Application Pool….
• Enter a name, e.g. processmining and click on OK.

6

For a single installation go to Step 7.

For multiple installations with different users:
In the panel on the right, click on Advanced Settings….
• Go to Identity and click on next to ApplicationPoolIdentity.
• Select the Custom account option.
• Click on Set... and enter the credentials for the User.
• Click on OK (2x).

7

In the panel on the right, click on Recycling….
• Uncheck the Regular time intervals checkbox.
• Check the Specific time(s) checkbox.
• In the text box, enter 02:00.

Other times will also do, but keep in mind that all users that are logged in, will be logged out at that time.
• Click on Next, and Finish.

8

In IIS Manager, right click on Sites and click on Add Website….
• Enter a name, e.g. processmining.
• Select the application pool created in Step 5.
• Enter <PLATFORMDIR>\builds as the physical path.
• Enter 8080 as the port number (any unused port number will do).
Note: When you have multiple installations on the same server, you must use a different (unused) port for each installation.
• Click OK to create the site.
Note: Leave the localhost binding intact. The initial login is only possible on localhost.

UiPath Process Mining is installed. It can be accessed locally at http://localhost:<PORT>/?page=superadmin.
A login screen is displayed where you can log in with the default username sa and default password sa.

🚧

Important

superadmin in the URL must be all lowercase!

Part 5: Make the UiPath Process Mining platform available to end-users

Making the platform available to the users over the internet is done by making the site in IIS available.

By default, UiPath Process Mining is set to only use HTTPS. Make sure that:

  • you have an HTTPS binding for the platform in IIS;
  • the domain name points to the UiPath Process Mining server;
  • HTTPS traffic to and from the UiPath Process Mining server is allowed.

Follow these steps to give end-users access to Process Mining.

Step

Action

1

Obtain an SSL certificate for that domain name and install it on the UiPath Process Mining server.

Refer to the documentation of the supplier of your SSL certificate for information on how to request and install an SSL certificate for your specific IIS version.

2

Create a new binding for HTTPS (Port 443)
• Go to IIS Manager and Click on the Process Mining Site.
• Click on Bindings... in the Actions panel.
• Click on Add to add a new binding,
• Select https as the Type. This automatically enables Port 443.
• Select the SSL Certificate installed in Step 1 from the SSL certificate list.
• Click on OK.
• Click on Close.

For a detailed description on how to create an SSL binding, visit the official Microsoft documentation.

Next steps

Updated about a month ago



Server Installation


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.