RPA server GUI upgrade

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

Jump to:

Prerequisites

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

  • (Optional) Ensure you have noted down any custom configurations if you are upgrading from a version installed via Wix installation (21.10 - 22.9.1). These configurations will need to be entered during the upgrade.

  • Mandatory: Before upgrading from v23.11 to any version up to v24.12, run the script located at C:\Program Files\NintexSystemManager\scripts\recoverConfig.js. This step is required for the upgrade process.

  • Ensure that all services, including both server and client components, are shut down.

  • Ensure the VM is clean and dedicated to the RPA Server installation.

  • Verify that no conflicting versions of .NET are present in the PATH environment variable. *See Known issues below.

  • For external database:

    • Mandatory: Back up the external database.

    • MSSQL Server 2016 or later installed on a remote server.
  • For internal database:

    • (Optional) Back up the internal database, although it will also be backed up.

  • Backup and uninstall the clients. This step can be performed either before or after the server upgrade.

  • Configured Nintex RPA server.
  • Ensure that you have access to the server hosting the MSSQL database and that you have full credentials, including usernames and passwords, for this database.

    Establish an open connection between both servers to ensure optimal functionality.
  • Ensure that you have installed the latest version of the Nintex System Manager executable (NintexSystemManagerSetup.exe).
  • The installation bundle zip file (e.g., nintex-rpa-server-24.4.0-full.zip).
  • (For TLS/SSL installation) The certificate files, such as the Personal Information Exchange file (e.g., kryonaws_full_chain.pfx).
  • We support different certificate file options: PFX (PKCS#12), CERT, KEY, and PEM files. Make sure you have the necessary files for your environment and ensure that each server in a multi-server installation has a certificate installed.

Types of upgrade

Upgrade flow

Below are the recommended steps to follow for upgrading RPA:

Post-upgrade steps

  1. Back up and uninstall the previous version of the clients (Studio and Robot) if not already done.

  2. Install the latest version of the clients.

  3. 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.
  4. Log in to the Admin Tool to manage the Nintex RPA platform.

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

  6. 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.

  7. (Optional) If you need to make changes such as enabling or disabling TLS, you can do so using the repair feature. There's no need to uninstall the previous version. Simply drag the zip file into the System Manager and click Begin Repair. Follow the installation steps with the new settings or any desired changes.

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.