Executing the upgrade

Important:

To perform an Automation Suite upgrade, you must put the cluster in maintenance mode. Maintenance mode causes downtime during the entire upgrade process, and your business automation is suspended during this time.

It is strongly recommended to create a backup of the cluster and the SQL database before the upgrade. This is to ensure you can restore the cluster if something goes wrong during the upgrade operation.

Cluster data is backed up on the NFS server. Make sure to configure the NFS server before proceeding.

You must configure the backup after disabling the maintenance mode to ensure that all transactions are completed.

Putting the cluster in maintenance mode

Putting the cluster in maintenance mode shuts down the ingress controller and all the UiPath® services, blocking all the incoming traffic to the Automation Suite cluster.

1. To put the cluster in maintenance mode, run:

   ./configureUiPathAS.sh enable-maintenance-mode

2. To verify that the cluster is in maintenance mode, run:

   ./configureUiPathAS.sh is-maintenance-enabled

Configuring the backup

To configure the backup, take the following steps:

1. Make sure you enabled the backup on the cluster. You must create the backup using the same version of the installer as the one you used for the current deployment. For instructions, see the backup and restore documentation corresponding to the Automation Suite version from which you plan to upgrade. For instance, if you plan to upgrade from Automation Suite 2023.4, follow the instructions in the 2023.4 guide.
2. Connect to one of the server nodes via SSH.
3. Verify that all desired volumes have backups in the cluster:

   • If you upgrade from 2022.4 or older, run the following command:

     /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup

   • If you upgrade from 2022.10 or newer, run the following command:

     ./configureUiPathAS.sh snapshot list

   Note: The backup might take some time, so wait for approximately 15-20 minutes, and then verify the volumes backup again.

Once the backup is created, continue with the following steps.

Updating Kubernetes and other infrastructure components

To upgrade Kubernetes and the other infrastructure components, run the following command on the primary server node:

Important:

Make sure you updated the generated cluster_config.json file as described in Updating the cluster configuration.

cd /opt/UiPathAutomationSuite/latest/installer

./install-uipath.sh --upgrade -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -k --accept-license-agreement

Note:

• Running the previous command on the primary server node copies the installer and cluster_config.json to the /opt/UiPathAutomationSuite/<version>/installer default location and upgrades the infrastructure on all the machines.
• The /opt/UiPathAutomationSuite/<version> default location must have at least 5 GiB available across all nodes.

• To change the default location, update the following environment variable with the desired location. Make sure that the location is available on all the nodes and has the required permissions to run the upgrade.

  export INSTALLER_DIRECTORY=/path/to/copy/installer

• After executing the previous command and running the upgrade, the installer is copied to the /path/to/copy/installer/<version>/installer location. version is replaced with the version of the installer that you execute.

Troubleshooting

• The upgrade logs on the primary server are available in the /opt/UiPathAutomationSuite/latest/installer/upgrade-logs default location, unless you explicitly used a custom location for the installer.
• On all the other nodes, the logs are available in the /opt/UiPathAutomationSuite/<version>/installer/upgrade-logs default location, unless you explicitly changed this location via the INSTALLER_DIRECTORY variable.

Updating the shared components and UiPath® product services

1. To upgrade the shared components and the UiPath® product services, run the following command on the primary server node:

   ./install-uipath.sh --upgrade -i /opt/UiPathAutomationSuite/cluster_config.json -o ./output.json -f -s --accept-license-agreement

   Important:

   After completing the upgrade, maintenance mode is disabled automatically.

2. To verify if Automation Suite is healthy, run one of the following commands:

   cd /opt/UiPathAutomationSuite/latest/installer/bin
   ./uipathctl health check

   cd /opt/UiPathAutomationSuite/latest/installer/bin
   ./uipathctl health test --versions versions.json

   Note:

   To download versions.json, see Downloading the installation packages.

After completing the upgrade, perform the cleanup and migration activity applicable to you.