automation-suite
2024.10
true
UiPath logo, featuring letters U and I in white

Automation Suite on EKS/AKS installation guide

Last updated May 8, 2025

Upgrading Automation Suite

Automation Suite consists of multiple components. Both you as a customer and UiPath® share responsibility of these components. For details, see Responsibility matrix.

You are responsible for upgrading:

  • Kubernetes infrastructure where Automation Suite is deployed (AKS or EKS)
  • Components that you choose to bring as part of Automation Suite (e.g., Gatekeeper, FluentD, etc.)

UiPath® is responsible for upgrading:

  • UiPath® services (e.g., Orchestrator)
  • Components deployed as part of Automation Suite (e.g., ArgoCD)

Upgrading UiPath® services and components

Preparation

Note:

If you upgrade to Automation Suite 2024.10 and want to use Document Understanding modern projects, you must meet the additional hardware requirements we specify in Additional Document Understanding recommendations.

Note:
If you upgrade to Automation Suite 2024.10.3 or higher, and you want latest version of Airflow you need to bring a PostgreSQL database for AutomationSuite_Airflow and configure the connection string for it in input.json.
Note:

There is a known issue with the backup logic in Automation Suite for AKS/EKS versions 2024.10.0 to 2024.10.1. Specifically, this issue excludes the backup of Insights dashboards and Studio Web data. However, all historical data is successfully backed up.

To include the data of Insights and Studio Web in backup, you must reconfigure the backup solution using the script available here. This script allows you to reconfigure the backup solution and create the backup. For details on how to execute the command, see this section.

To prepare for the upgrade, take the following steps:
  1. Check the compatibility matrix to determine the supported versions for each available upgrade scenario. If you brought your own components, make sure the versions of your components are compatible with the version you plan to upgrade to. For details, see Compatibility matrix.
  2. Download versions.json and uipathctl for the version you want to upgrade to, on your management machine. For download instructions, see Downloading the installation packages.
  3. Generate the latest input.json file as follows:
    • Option A: To get the latest revision of your input.json file, run the following command: 
      uipathctl manifest get-revisionuipathctl manifest get-revision
    • Option B: To list all the past input.json files and determine the one you want to choose, run the following command: 
      uipathctl manifest list-revisionsuipathctl manifest list-revisions
  4. If Process Mining is installed, and you want to use latest version of Airflow which needs PostgreSQL, you must add or update the sqlalchemy connection string template applicable for PostgreSQL in the cluster_config.json file before the upgrade: postgresql_connection_string_template_sqlalchemy_pyodbc.
    postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name>postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name>
    Note:

    This only applies to Process Mining on Automation Suite 2024.10.3 or higher.

Execution

To perform an upgrade of UiPath® services and component, take the following steps:

  1. Confirm that your cluster is healthy: 
    uipathctl health checkuipathctl health check
  2. Put the cluster in maintenance mode to guarantee a consistent backup: 
    uipathctl cluster maintenance enableuipathctl cluster maintenance enable
    Important:

    This operation causes downtime, and your business automation is suspended while maintenance mode is enabled.

  3. Verify that the cluster is in maintenance mode: 
    uipathctl cluster maintenance is-enableduipathctl cluster maintenance is-enabled
  4. Back up the cluster and the SQL database, then check that the backup completed successfully.
    Important:

    It is strongly recommended to create a backup of the cluster and the SQL database before upgrading Automation Suite. This is to ensure you can restore the cluster if something goes wrong during the upgrade operation. This is applicable before upgrading your Kubernetes infrastructure as well.

    Make sure to copy the value of global.userInputs.identity.krb5KeytabSecret to global.kerberosAuthConfig.userKeytab, if you simultaneously meet the following requirements:
    • you configured the Active Directory integration using username and password
    • you have Windows authentication enabled
    • you do not use SQL integrated authentication
  5. Disable the maintenance mode: 
    uipathctl cluster maintenance disableuipathctl cluster maintenance disable
    Note: You must disable maintenance mode before upgrade. The Automation Suite upgrade process does not support having maintenance mode enabled.
  6. Perform the upgrade of UiPath® services and components: 
    uipathctl cluster upgrade input.json --versions versions.jsonuipathctl cluster upgrade input.json --versions versions.json
    Important:

    This operation causes downtime, and your business automation is suspended during the upgrade process. It is important that you perform the upgrade only during your maintenance window.

  7. Check that the cluster is healthy after the upgrade: 
    uipathctl health checkuipathctl health check
    Note: If you upgraded to Automation Suite 2024.10.3 or higher, you can uninstall Dapr and Cert Manager if you have not enabled Task Mining. For more details, refer to the Uninstall Dapr and Uninstall Cert Manager sections.

Upgrading Kubernetes infrastructure

Note: Automation Suite supports upstream N-1 to N-3 versions of Kubernetes irrespective of the cloud provider. For instance, if upstream is 1.27, we support versions 1.26, 1.25, and 1.24. For supported versions, see the Compatibility matrix.

You are responsible for upgrading the Kubernetes infrastructure hosting Automation Suite. You should follow the standard practices of your company to upgrade Kubernetes infrastructure.

  • Upgrading UiPath® services and components
  • Preparation
  • Execution
  • Upgrading Kubernetes infrastructure

Was this page helpful?

Support and Services
Get The Help You Need
UiPath Academy
Learning RPA - Automation Courses
UiPath Forum
UiPath Community Forum
Uipath Logo White
Trust and Security
Terms of Use
Privacy Policy
Cookies Policy
© 2005-2025 UiPath. All rights reserved.