- Overview
- Requirements
- Installation
- Post-installation
- Migration and upgrade
- Upgrading Automation Suite on EKS/AKS
- Step 1: Moving the Identity organization data from standalone to Automation Suite
- Step 2: Restoring the standalone product database
- Step 3: Backing up the platform database in Automation Suite
- Step 4: Merging organizations in Automation Suite
- Step 5: Updating the migrated product connection strings
- Step 6: Migrating standalone Orchestrator
- Step 7: Migrating standalone Insights
- Step 8: Migrating standalone Test Manager
- Step 9: Deleting the default tenant
- Performing a single tenant migration
- Migrating from Automation Suite on Linux to Automation Suite on EKS/AKS
- Monitoring and alerting
- Cluster administration
- Product-specific configuration
- 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
- Pods cannot communicate with FQDN in a proxy environment
- Test Automation SQL connection string is ignored
- EKS backup failure due to Velero version
- Velero backup fails with FailedValidation error
- Accessing FQDN returns RBAC access denied error
- Manual ArgoCD NetworkPolicy mitigation (GHSA-47m3-95c7-g2g8)
Installing Automation Suite
High-level installation instructions for Automation Suite on AKS and EKS.
This page walks you through the high-level installation instructions for Automation Suite on AKS and EKS.
Before you begin, consider the following:
- Kubernetes, AWS, and Azure cloud resources management knowledge is required to deploy and manage Automation Suite on AKS/EKS. If you encounter issues installing and configuring Automation Suite on AKS/EKS, contact UiPath® Professional Services.
- Before choosing your deployment profile, refer to Deployment scenarios.
- The installation process generates self-signed certificates on your behalf. You should replace them with certificates signed by a trusted Certificate Authority (CA) as soon as installation completes. For instructions, refer to Managing the certificates.
- Automation Suite supports enabling Federal Information Processing Standard 140-2 (FIPS 140-2) on AKS nodes. For details, refer to Security and compliance. You cannot enable FIPS 140-2 on EKS nodes.
Step 1: Provisioning the infrastructure prerequisites
Before installing Automation Suite, you must configure the cloud resources in your environment. This includes the following:
- AKS or EKS cluster
- Mandatory for offline installations: external OCI-compliant registry
- Object Storage - Azure Blob or Amazon S3
- Block storage
- File storage
- Databases
- Caching
- Networking (e.g., VNETs / VPC, DNS, subnets, NSGs / security groups, NAT gateway, elastic IP and internet gateway)
- Networking policies
- Certificates
For instructions on prerequisites, refer to Prerequisites at a glance.
Optional: Configuring the proxy
If you use a proxy server for internet-facing traffic, you must allow a list of URLs and use the no_proxy settings while configuring the proxy. For instructions on how to configure your proxy, refer to Proxy.
Step 2: Configuring the external OCI-compliant registry
In offline installations, you need a registry compliant with OCI (Open Container Initiative) to store the container images and deployment Helm charts.
There are two ways to upload the Automation Suite artifacts to the external OCI-compliant registry:
- Option A: By mirroring your OCI-compliant registry with the UiPath® registry
- Option B: By hydrating your OCI-compliant registry with the offline bundle
Step 3: Downloading the software on your client machine
You must install the following software on your management machine. Management machine refers to the machine you use to operate your cluster and that can access your cluster via the kubeconfig file. Your management machine can run Linux, Windows, or macOS.
The following tools are required to successfully run the prerequisite checks, installation, and post-installation steps on your cluster via the client machine.
| Tool | Description | Download |
|---|---|---|
uipathctl | Required. uipathctl is a UiPath® command-line tool that allows you to run commands against Automation Suite Kubernetes hosted on Azure Kubernetes Service (AKS) and Amazon Elastic Kubernetes Service (EKS). You can use uipathctl to check prerequisites in your environment, install Automation Suite, configure and manage it from a single unified CLI. | Download uipathctl Run uipathctl |
versions.json | Required. Needed to perform prerequisite checks and installation steps. | Download versions.json |
kubectl | Optional. Ensure that kubectl matches the version of your cluster | Download kubectl |
Step 4: Configuring input.json
You must edit the input.json file to provide the required inputs for the uipathctl installer and perform operations such as configuring the SQL connection strings and the UiPath® services you would like to enable.
We provide different input.json template files for AKS and EKS. For instructions on how to configure input.json, refer to Configuring input.json.
Optionally, you can bring your own components that are part of the Automation Suite stack. For details on the components, refer to Automation Suite on EKS/AKS stack. For details on how to configure the component you bring, refer to Bring your own components.
If you perform an offline installation, make sure to configure your external OCI-compliant registry.
To install Automation Suite on EKS/AKS in offline mode, you must take the following additional steps:
- Explicitly set the value of the
install_typeparameter toofflinein theinput.jsonfile; - Configure an external OCI-compliant registry.
Step 5: Accessing your cluster with uipathctl
uipathctl requires access to the KubeAPI Server to perform cluster-level operations such as deployment, resource creation, etc. To access the KubeAPI server, uipathctl uses the kubeconfig file, which contains the admin-level credentials needed to access the cluster. This file must be present in the ~/.kube/config folder (default location) of your local (management) machine.
Optionally, if you are concerned about storing the kubeconfig file in the default location, you can alternatively provide it with help of the --kubeconfig flag during every execution of uipathctl.
For example, you can use your preferred method to update your ~/.kube/config file by using AWS CLI or Azure CLI.
Step 6: Checking the infrastructure prerequisites
Prerequisite checks ensure that the needed cloud infrastructure is provisioned appropriately and is accessible by the client machine before starting the installation of Automation Suite.
The installer can automatically generate the following configurations on your behalf:
- The SQL databases required for the installation on the SQL server based if the
sql.create_dbkey is set in yourinput.jsonfile. - The object storage buckets required in your cloud provider if the
external_object_storage.create_bucketkey is set in the configuration file.
To allow the installer to generate these configurations, run the following command:
uipathctl prereq create input.json --versions versions.json
uipathctl prereq create input.json --versions versions.json
The uipathctl prereq create command does not create the required SQL databases for Process Mining. You must manually create them by following the instructions in Bring your own database.
To check the prerequisites based on the inputs you configured in the input.json, run the following command:
uipathctl prereq run input.json --versions versions.json
uipathctl prereq run input.json --versions versions.json
To check the prerequisites for installation, run . By default, the command checks all the prerequisites. However, it also allows you to run strictly the checks that are relevant to you:
- If you want to exclude components from the execution, use the
--excludedflag. For example, if you do not want to check the database connection strings, runuipathctl prereq --excluded SQL. The command runs all the prerequisite checks except for the SQL-related one. - If you want to include only certain components in the execution, use the
--includedflag. For example, if you only want to check the DNS and objectstore, runuipathctl prereq --included DNS,OBJECTSTORAGE.
You can find the names of the components you can include or exclude from the prerequisite checks here. In the example, the first word on each outdented line represents the component name. For example: SQL, OBJECTSTORE, DNS, etc.
You may receive a throttling message from AKS, such as Waited for 1.0447523s due to client-side throttling, not priority and fairness. In this case, allow a few minutes for the command to fully complete or try to re-run it.
For an output result example, refer to Output example: prerequisite check.
Prerequisite checks
It is recommended to run prerequisite checks to ensure that you properly configured the cloud infrastructure and to validate input.json before starting the Automation Suite installation.
You can run a prerequisite check using the uipathctl prereq run command. By default, this command verifies all the prerequisites. You can use the following flags:
--excluded, if you want to exclude components from the execution.--verbose, if you want to access the detailed prerequisites check output. You can skip this flag for a more concise and simplified output.
The prerequisite and health checks/tests run in the uipath-check namespace. You must either allow the creation of the uipath-check namespace or create it yourself before running the checks/tests. In addition to this, some checks/tests require that you allow the communication between the uipath-check and uipath namespaces, or that you enable the use of hostNetwork.
The checks in the following table are run on each node:
| Check | Description |
|---|---|
| SQL Connection | Validates that Automation Suite can successfully connect to SQL server for UiPath® products and shared services (such as Identity, Portal, Org Mamagement, etc.) using the SQL connection strings provided in input.json . This is mandatory for a successful installation. |
| SQL DB roles | Validates the necessary roles and permissions required by UiPath® products. This is mandatory for a successful installation. |
| SQL DB compatibility | Validates SQL DB compatibility requirements. |
| FQDN resolution | Validates that the FQDN and the sub-domains are successfully resolvable. |
| Object Storage API | Validates that Object store APIs are accessible based on access information provided in input.json . This is mandatory for a successful installation of UiPath® Services. |
| Cache / Redis | Validates the connection to Cloud Redis or ElastiCache. This is mandatory for a successful installation. |
| Capacity | Validates you have minimum worker nodes' CPU and RAM capacity based on products enabled in input.json . |
| Storage Class | Validates the storage classes for File Storage are configured as required for Automation Suite Robots. |
| Optional Components | Validates that your cluster has components that you chose to exclude from the Automation Suite installation. |
| Ingress | Validates that the cluster ingress is configured correctly and the FQDN URL requests can reach UiPath® products. |
| Network Policies | Checks if network policies configured in Automation Suite are compatible with the cluster. |
| Registry | Validates that Automation Suite can access the UiPath® docker registry. This is mandatory for a successful installation. |
| Cluster Connectivity | Validates whether the cluster communication is configured properly:
|
Step 7: Installing Automation Suite
To see which deployment scenarios are available for Automation Suite on AKS/EKS, refer to Deployment scenarios.
-
After successfully validating the prerequisites, you can proceed to install Automation Suite by running the following command:
uipathctl manifest apply input.json --versions versions.jsonuipathctl manifest apply input.json --versions versions.jsonFor an output example, refer to Output example: Automation Suite installation.
Note:If you encounter issues while running the installation, rerun the command the installation commands with all the arguments and flags. For details on the issues you might encounter, refer to Troubleshooting.
-
To validate that your installation is successful, and services are healthy, run the following command:
uipathctl health checkuipathctl health check
- Step 1: Provisioning the infrastructure prerequisites
- Optional: Configuring the proxy
- Step 2: Configuring the external OCI-compliant registry
- Step 3: Downloading the software on your client machine
- Step 4: Configuring input.json
- Step 5: Accessing your cluster with uipathctl
- Step 6: Checking the infrastructure prerequisites
- Prerequisite checks
- Step 7: Installing Automation Suite