automation-suite
2023.10
false
UiPath logo, featuring letters U and I in white

Automation Suite on Linux installation guide

Last updated Oct 3, 2025

Completing the upgrade

To complete the upgrade, take the following steps:

  1. Edit the cluster_config.json file to point to the cloned databases and, optionally, to the cloned buckets.
  2. If you installed Automation Suite in an offline environment and upgrade from 2023.4 or earlier to 2023.10 or later, add install_type: offline to the cluster_config.json file.
  3. Run the service installer on the target cluster:
    cd /opt/UiPathAutomationSuite/<version>/installer
    
    ./install-uipath.sh -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -s --accept-license-agreementcd /opt/UiPathAutomationSuite/<version>/installer
    
    ./install-uipath.sh -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -s --accept-license-agreement
  4. Update the certificates post-installation. For instructions, see: Managing the certificates.
  5. Start the skills:
    • sync the skills:
      ./configureUiPathAS.sh aicenter skill sync [skill_ids]./configureUiPathAS.sh aicenter skill sync [skill_ids]
    • check the skills status:
      ./configureUiPathAS.sh aicenter skill status [skill_ids]./configureUiPathAS.sh aicenter skill status [skill_ids]
      The command can return any of the following statuses:
      • InProgess - skill deployment is in progress.
      • Failed - skill deployment is failed.
      • OutOfSync - skill is available in the database; however, it has yet to be deployed.
      • Available - when the skills are deployed and available to consume.
  6. Validate that the target cluster works as expected.
    uipathctl health checkuipathctl health check
  7. Check the state of your new Automation Suite cluster related to data, connectivity, robots, and workflow.
  8. Applicable only if you are following the Side-by-side upgrade (identically sized target cluster): You can optionally update the FQDN of the target cluster to be same as the FQDN of the source cluster. Alternatively, you can use a new FQDN.
    Note:

    Changing the FQDN also requires new server certificates. If a new certificate is available, you have two options: either continue with the new self-signed certificates configured by the installer automatically, or stop the installation and bring in a new certificate.

    You can configure the certificate via the server_certificate field in cluster_config.json.

    If you are following the Side-by-side upgrade (single node start), the FQDN update should happen after the target cluster is scaled up.

  9. Optionally, if you experience issues with image vulnerabilities or storage consumption, delete the images from the old installer.
  10. Enable the backup on the cluster target.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo
Trust and Security
© 2005-2025 UiPath. All rights reserved.