automation-suite
2.2510
true
Automation Suite on EKS/AKS installation guide
- Overview
- Requirements
- Pre-installation
- Preparing the installation
- Downloading the installation packages
- Configuring the OCI-compliant registry
- Granting installation permissions
- Installing and configuring the service mesh
- Installing and configuring the GitOps tool
- Installing the External Secrets Operator in Kubernetes
- Applying miscellaneous configurations
- Running uipathctl
- Installation
- Post-installation
- Migration and upgrade
- Monitoring and alerting
- Cluster administration
- Starting and shutting down the cluster
- Performing database maintenance
- Configuring the FQDN post-installation
- Forwarding logs to external tools
- Switching to the secondary cluster manually in an Active/Passive setup
- Converting an existing installation to multi-site setup
- Guidelines on upgrading an Active/Passive deployment
- Guidelines on backing up and restoring an Active/Passive deployment
- Product-specific configuration
- Orchestrator advanced configuration
- Configuring Orchestrator parameters
- Configuring appSettings
- Configuring the maximum request size
- Overriding cluster-level storage configuration
- Configuring NLog
- Saving robot logs to Elasticsearch
- Configuring credential stores
- Configuring encryption key per tenant
- Cleaning up the Orchestrator database
- Skipping host library installation
- AI Trust Layer
- Troubleshooting
- The backup setup does not work due to a failure to connect to Azure Government
- Pods in the uipath namespace stuck when enabling custom node taints
- Unable to launch Automation Hub and Apps with proxy setup
- Velero backup fails with FailedValidation error
- External Secrets troubleshooting
- Temporal as a Service troubleshooting
- AI Center and Document Understanding pods fail to start with TLS certificate verification enabled
- TLS certificate validation errors
- Fluentd does not export logs in IPv6 environments
- Studio Desktop cannot load Integration Service connectors and activities
- Manual ArgoCD NetworkPolicy mitigation (GHSA-47m3-95c7-g2g8)
- Configuring resource requests and limits for uipathctl-created workloads
Guidelines on upgrading an Active/Passive deployment
Upgrade multi-site Active/Passive deployments in Automation Suite on EKS/AKS.
Note:
For step-by-step instructions, refer to Upgrading Automation Suite.
Execution steps
A successful upgrade requires that both clusters are on the same version. To upgrade the clusters, you must follow the standard upgrade procedure of the standalone Automation Suite cluster, individually for each clusters.
Important:
Before performing the upgrade, make sure to add the type field to the multisite section of your input.json.
"multisite": {
"enabled": true,
"primary": true,
"other_kube_config": "",
"type": "active-passive"
},
"multisite": {
"enabled": true,
"primary": true,
"other_kube_config": "",
"type": "active-passive"
},
You must take the following high-level steps on each cluster separately:
- Hydrate the Docker registry for both clusters.
- Enable the backup of the primary cluster. Optionally, you can also enable the backup for the secondary cluster.
- Put both clusters into maintenance mode.
- Upgrade both the cluster individually.
- Disable the maintenance mode once the upgrade is a success.
Rollback on error
- Primary cluster recovery - you must use the backup to restore the Automation Suite cluster.
- Secondary cluster recovery - you can either use the backup to restore the data if you enabled it before the upgrade, or you can choose to build the new secondary cluster from the primary. The steps here will remain the same as adding a new secondary Automation Suite cluster.