Upgrading the RPA Server and Clients

Upgrading the RPA Server

Follow these steps to upgrade from an earlier version to Nintex.

Each time you click a step it will take you to the relevant section in the guide. At the end of the target section you'll find a cross-reference "-I came here while upgrading, take me back to the upgrading steps overview-". Click this cross-reference to get back here.

Upgrading to v21.4.3 and later:

There are 2 ways to perform the upgrade from an old version to the latest version that supports the new queues:

  • Perform an upgrade on the same existing environment

  • Side by side - copy the DB to a new location and upgrade it there - recommended!

Before upgrading, make sure to back up the DB and environment.

The option to install a new environment and Export/Import the wizards is not supported .

Contact support for more details and for end-to-end assistance with the upgrade procedure.

  1. Stop all the Nintex RPA Services

  2. Back-up current version installation and database

  3. Configure current SQL instance to ensure support for new version (relevant only if your current version is 19.1.3 or below)

  4. Prepare the Nintex database for upgrade(relevant only if your current is below 5.25.0)

  5. Uninstall the current version of the Nintex RPA Server through Windows Control Panel.

  6. Make sure that OpenSSL in uninstalled. If not, uninstall it manually like you would normally do.

    NOTE: This step is relevant when upgrading from any version prior to 20.9.

  7. Open network ports if the default ports aren't relevant to you (check for changes from earlier versions)

  8. Remove the current Console configuration (relevant only if your current version is 19.3 or below)

  9. Install the Nintex RPA Server by following the standard installation procedure while taking into consideration that the database version will also be upgraded.

  10. Perform data migration:

    1. Migrate your data using the Nintex RPA Migration Tool

    2. Migrate users to the new authentication platform (relevant only if your current version is 19.1.3 or below)

    3. Encrypt the Credentials Vault (relevant only if your current version is 19.3 or below)

    4. Migrate users in Aerobase (relevant when upgrading to version 21.4.1)

  11. If you are upgrading from Console/ConsoleX to Console Plus, see the relevant topic below:

    Migrating from Console/ConsoleX to Console Plus

  12. After installing Console Plus, you'll need to re-configure the email settings.

    See the topic "Setting Up the Email Server" in Console Plus User Guide.

Upgrading the RPA Clients

Starting from Client version 19.5, you can automatically deploy software updates to Robots and Studio, on client machines. For more information, see Automatic Client Update.

If you are updating from a version before Client version 19.5, follow these steps:

  1. Uninstall the current versions of Nintex attended/unattended Robots and Studio, as applicable, through Windows Control Panel.

  2. Follow the regular client installation workflow to install and configure the new version of Nintex clients.

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

    See the Installation and Usage  section in the Dynamic Commands User Guide.