- 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
Converting an existing installation to multi-site setup
Convert single-site Automation Suite to multi-site Active/Passive deployment on EKS/AKS.
You can convert an existing installation into multi-site by taking the following steps:
- Convert the standalone Automation Suite cluster into the primary cluster. For details, refer to Converting a standalone cluster into a primary cluster.
- Install secondary Automation Suite cluster. For details, refer to Disaster Recovery - Installing the secondary cluster.
Ensure that the certificates are the same on the primary and secondary clusters. This check is not performed or enforced automatically.
Converting a standalone cluster into a primary cluster
To convert an existing Automation Suite cluster into a primary cluster of the multi-site deployment, take the following steps:
-
Update
input.json. Add or updatefqdn,cluster_fqdn, and enablemultisite."fqdn" : "<global traffic manager fqdn>" "cluster_fqdn": "<fqdn of the primary cluster>", "multisite": { "enabled": true, "primary": true }"fqdn" : "<global traffic manager fqdn>" "cluster_fqdn": "<fqdn of the primary cluster>", "multisite": { "enabled": true, "primary": true }For details, refer to Advanced installation experience. Update the TLS certificate section to configure the new certificate, ensuring it meets the requirements outlined in the section.
Note:It is recommended to keep the FQDN of your existing Automation Suite setup to avoid reconfiguring all your robots.
-
Reapply the manifest by running the following command:
uipathctl manifest apply input.json --versions versions.jsonuipathctl manifest apply input.json --versions versions.jsonRefer to Installing Automation Suite.