RPA server GUI installation

Currently, you cannot uninstall the RPA Server through the System Manager's GUI installer. However, you can uninstall using the Command Line Interface (CLI).

Nintex System Manager provides a comprehensive solution for managing the installation of RPA.

Jump to:

Prerequisites

To install RPA with the System Manager, you must have the following prerequisites in place:

  • The server where you will complete the install, configured with the prerequisites for Nintex RPA server.
  • Verify that no conflicting versions of .NET are present in the PATH environment variable. *See Known issues below.

  • Microsoft SQL Server Management Studio on the RPA Server.

  • MSSQL Server 2016 or later installed on a remote server.
  • A prepared authentication database for Keycloak.
  • Ensure that you have access to the server hosting MSSQL database and that you have full credentials, including usernames and passwords, for this database.

    To ensure proper functionality, you must establish an open connection between both servers.
  • The installation bundle zip file (for example: nintex-rpa-server-24.4.0-full.zip) from the Products page in your Customer Central instance.
  • (Optional) You can use SSL/TLS for secure connections, and we support different certificate file options: PFX (PKCS#12), CERT, KEY, and PEM files. Make sure to have the necessary files for your chosen option, and ensure that each server in a multi-server installation has a certificate installed.

Types of installation

Installation flow

Below are the recommended steps to follow for installing RPA:

Post-installation steps

  1. Proceed with the Client installation (Studio and Robot).

  2. Run the Dynamic Advanced Commands installer on each client machine (Studio and Robot).

    This step is only required the first time after installation. After installation, use the distribution system for updates.
  3. Log in to the Admin Tool to Activate your RPA license and manage the Nintex RPA platform.

  4. Log in to the Console Plus to create and manage robots, tasks, and triggers.

  5. To validate Single Sign-On for Client Server Authentication, log in to the client machine using an Active Directory user account that has been imported into Aerobase (and synchronized in the Admin tool). Start a client application (Studio or Robot), and if the setup is successful, it will log in automatically without requiring manual credentials.

  6. (Optional) Change configuration parameters: If you need to make changes like enabling or disabling TLS, you can do it by using the Silent installation instructions (CLI). There is no need to uninstall the previous version. Simply rerun the System Manager installation and adjust the config.prod.properties.json and config.prod.properties.secured.json files as required. You can use the original template and make changes there.

Known issues

.NET Core path conflict

  • Issue: When installing the RPA Server, the process may fail at the RPA Services step due to the Nintex Server - Authentication Service being stuck in a Paused state. This is typically caused by a conflict with the .NET Core installation path.

  • Explanation: The failure occurs because the installation process installs .NET Core 6 in C:\Program Files\dotnet. However, if the PATH environment variable has an entry for C:\Program Files (x86)\dotnet before the correct path, the system cannot find the installed .NET Core version. This conflict may occur on virtual machines (VMs) that come with .NET already installed in the wrong location and architecture (x86/x64).

  • Workaround: To resolve this issue, follow these steps:

    1. Check that .NET Core 6 is installed in C:\Program Files\dotnet.

    2. Remove C:\Program Files (x86)\dotnet from the PATH environment variable. To do this:

      1. Open System settings.

      2. Click Advanced system settings.

      3. Click Environment Variables in the Advanced tab.

      4. Select Path from the System variables.

      5. Click Edit.

      6. Delete the entry C:\Program Files (x86)\dotnet.

    3. Restart the machine.

    4. Run the installation or upgrade again.