Upgrading the IBM RPA on premises client

Learn how to upgrade the IBM RPA on premises client.

Important:You need to upgrade the server before upgrading the clients. You can't run a client version higher than the server version.

Choose the procedure for the version that you are upgrading to:

Upgrading to version 21.0.0, 21.0.1, or 21.0.2

Requirements:

  • Stop the following services on Windows Task Manager:
    • IBM Robotic Process Automation Agent
    • Credential Manager
  • Make sure to check which version are you upgrading from. If you are upgrading from a version prior to 20.12, see Upgrading certificates for more information.
  • You need to upgrade the server before upgrading the clients.

Procedure:

  1. On the Windows Start menu, search for Add or remove programs.

  2. Remove the IBM Robotic Process Automation software.

  3. On the uninstaller, click Next.

  4. After uninstalling, restart the machine to apply the changes.

  5. To reinstall the client, refer to Installing the client by using the installer.

    Icon for information notes Important: During the reinstallation, do not enter license data to reuse the previous license.

Upgrading to version 21.0.3 or higher

Requirement:

You must have an older version of IBM RPA on premises client installed on the host machine.

Procedure:

To upgrade the client, run the IBM RPA client installer. If the installer identifies that the host machine has an older version of the IBM RPA on premises client installed, you get prompted to initiate the upgrade process.

During the upgrade process, you can't update previous configuration, but the installer prompts you to set optional configuration that were not set before and new features. The installer steps are the same as when installing the IBM RPA on premises client. Refer to the Installing the client by using the installer procedure to get guidance for any configuration prompt you get.

Remember:The upgrade process does not erase log files.

If you experience issues with upgrading, see Troubleshooting the IBM RPA on premises edition installation or contact IBM Support External link if you can't find your issue listed.

Upgrading certificates

If you are upgrading from version 20.12.x or lower, you need to upgrade your certificate after the IBM RPA upgrade procedure.

  1. Log in to the IBM RPA Control Center.
  2. Go to Configuration > Computers.
  3. Search for your computer ID, which might be your computer's hostname.
  4. Click Actions > Download certificate.
  5. Run the certificate file to install the new license certificate.