Subscribe

UiPath Automation Suite

The UiPath Automation Suite Guide

2022.10.0

Release date: 14 November 2022

What’s new


New products and services

📘

When upgrading to a new Automation Suite version, newly onboarded products are not enabled by default. This is also the case with Process Mining and Automation Suite Robots, which you can enable only following an upgrade to 2022.10. For instructions, see Managing products.

Process Mining

Process Mining is now available in Automation Suite.

With Process Mining you can discover, automate, and monitor your end-to-end business processes. It transforms data from your IT systems into visual interactive dashboards, allowing you to identify inefficiencies, bottlenecks, and non-conformance, as well as to understand the root-causes and possible risks. Process Mining enables all levels of the organization to understand business processes and to discover process improvement opportunities, including but not limited to Automation.

See Process Mining (Automation Suite) for an overview of the main Process Mining features.

Automation Suite Robots

Automation Suite Robots have joined the party as well.

Automation Suite Robots allow you to run background unattended automation and utilize high density robots without having to worry about constantly provisioning new machines yourself to provide robot computational power at scale. Create a machine template and add it to folders to make sure that a robot and machine are always available when unattended processes in that folder need to run.

See Automation Suite robots for more information on how to set up and use this feature.

 

Service trials

We have added a new self-service option that lets you try out new services and capabilities on your existing deployments and data.
If you don't already own them, you can now start a free trial for:

Organization administrators can request and enable a service trial from the organization-level Licenses page, on the new Trial Services tab:

12831283

For detailed instructions, see Requesting a service trial.

 

A-la-carte product selection

Until now, the default Automation Suite installation experience has included a choice of two product selections, each with its own set of hardware requirements: Complete and Basic.

We have deprecated the Basic product selection, and we are offering a-la-carte product selection instead so that you can pick only the products you are interested in. As a result, even Orchestrator is now an optional product.

While this change increases your flexibility, it also comes with some rules, but you’ll see these are for your own benefit. The Automation Suite interactive installer now ensures that cross-product dependencies are resolved and that your UiPath ecosystem works without any hiccups.

As expected, this new option has introduced a series of changes in the behavior of the Automation Suite interactive installer. For details, check out Manual: Single-node evaluation profile requirements and installation and Manual: Multi-node HA-ready production profile requirements and installation.

 

AI Center and Automation Suite interoperability

This release improves the way in which AI Center works within the Automation Suite environment.

  • You can convert your AI Center standalone installation to a standard Automation Suite one in order to benefit from the platform capabilities to host additional products.
  • You can connect your AI Center running in Automation Suite 2022.10 to a standalone Orchestrator and Identity the same way AI Center standalone installation worked in previous versions.

 

RPM packages

We have updated the list of prerequisites for the Automation Suite installation.

Before starting a manual installation, you must now ensure that you have a RHEL subscription, that you have enabled the suitable repositories, and that you have installed all the required RPM packages.

You can use the install-uipath.sh manual installer to install and validate RPM packages.

For a complete list of required RPM packages and details on the tools you can use to validate your environment, see Hardware and software requirements.

 

ArgoCD SSO authentication

Escape the need to manually enter your domain credentials every time you want to access ArgoCD. Configure the single sign-on authentication method for your users, and allow them to simply click for a more secure access. Learn how to Enable SSO for ArgoCD.

 

Unified UI experience

We have introduced a new tool guiding you through the steps you need to take to complete the Automation Suite installation as well as common post-installation operations. It is called Cluster Administration, and it sports an approachable UI that provides useful instructions on handling tasks such as certificate configuration, Kerberos authentication setup, node administration, database maintenance, cluster monitoring, and many more.

To put it briefly, Cluster Administration centralizes a multitude of tools you may need after completing an Automation Suite installation. Just click the output URL the interactive installer or the cloud templates provide you with at the end of the installation process, and explore your options.

For more details on the operations the Cluster Administration offers support for, see Getting started with the Cluster Administration portal.

 

New Deployment Assistant

If it's the prospect of complexity that keeps you from installing Automation Suite, you have fewer reasons to worry now as we bring the Deployment Assistant to your aid.

The Deployment Assistant provides step-by-step instructions on how to get your environment ready, which requirements you must meet, and which documentation you should read to make sure you do not miss anything.
The wizard asks you a series of questions about the configuration you target, then gives relevant guidance on how to build a deployment that caters to your needs.

The Deployment Assistant currently covers only the single-node evaluation profile of Automation Suite.
For more details, see Getting started with the Deployment Assistant.

 

Preview: Multi-site deployments

The good news does not stop here: we are introducing multi-site deployments.

What this means is that Automation Suite can withstand the complete failure of nodes, entire data centers, or even regions, and supports the following deployment topologies:

  • Active-Active – Both clusters deployed in active mode;
  • Active-Passive – One cluster is active whereas the other is deployed in standby mode.

Note, however, that this feature is in preview stage, and for the time being, only Orchestrator and part of AI Center are available in multi-site deployment.

For mode details, see Preview: Multi-site deployments.

 

Improvements


New admin experience

Administrators, we have big news for you: The Administration pages have been redone in a new style!

Left rail is out, App launcher is in

While on the Administration pages, there is no more left rail - the bar at the left of the window from where you could move between services. This change will make sense as you keep reading.

11801180

Old admin experience

Now, to switch to a different service, you do so by clicking the existing App launcher icon in the top left corner.

Host, organizations, and tenants

Functionally, the main things we have changed are to clarify the context shift between host-level, organization-level, and tenant-level settings.
In the new admin experience, the left hand side, which we typically use for navigation options, now shows your context options, which are as follows:

  • In the host portal:
    • The host at the top of the panel, which lets you access host-level settings.
    • Your existing organizations, which let you access options for each organization, are listed below the host.
  • In the organization-level portal:
    • The organization name at the top of the panel, which lets you access organization-level settings.
    • Your existing tenants, which let you access options for each tenant, are listed below the organization.

With this change, you select an item on the left - organization or tenant - to see the settings for it in the main page area:

11801180

New Admin experience

Where are my settings?

Not to worry. We have left all other functionality as you know it. It might live in a different place, but we assure you, it's all still there and your settings are unchanged.

But all you need to remember is this:
When on the Admin pages, the first thing to do is to select the entity for which you want to update settings. Then you can easily find all the settings you expect.

Licensing new tenants

As part of this overhaul, we also included a helpful tweak.
Before, when you created a new tenant, all your available licenses were automatically allocated to that tenant. If you didn't want that, you had to follow-up tenant creation with adjusting the tenant's licenses.
Now, as part of tenant creation (which is now a wizard-style guided process, by the way), on the final step, we let you see and adjust the number of licenses to allocate to the tenant as part of setup.

Change is hard

That's why we have included an option that lets you switch back to the old admin experience.

11801180

We understand you might have gotten attached to the old interface and might need to switch back because don't have time to figure out the new interface.
But you should know that this option is only available for a limited time. In the future, we plan to remove the old experience completely.

 

Security settings interface changes

We have also improved the user interface in the Security Settings pages of the administration portals. Again, functionally, the existing features remain the same. But what we changed is the wording we used around integrated third-party directories. These changes are meant to:

  • distinguish between authentication settings that are used with local accounts (native to UiPath) and the ones that are used with directory accounts (originating from a third-party directory);
  • clarify the impact of configuring a third-party directory integration at host level, in which case it is only enabling SSO for all users, as opposed to configuring it at organization level, in which case the integration allows for extended capabilities such as directory search from within UiPath and auto-provisioning of accounts.

 

Storage improvements

External object storage

We have decoupled Objectstore from the cluster nodes in favor of external storage. This translates into the possibility of choosing Azure, AWS, or S3-compatible providers to handle your storage externally.

Opting for external object storage is not mandatory, but it does bring multiple benefits to the table. First of all, this configuration ensures resilience to data loss when a node and the underlying storage crash or are corrupted. Aside from that, you can perform data replication and disaster recovery independently of Automation Suite.

As for how and when you can configure external object storage, here are your options:

Ceph on raw devices

We have moved the Objectstore outside the block storage and directly attached it to the nodes' disk. We have decided to implement this change so that we can reduce the replication factor for storage from 18x to 3x. While previously you needed 18 GiB of data disk to store 1 GiB of data, you now need only 3 GiB of disks. To find out more about this, check out the Hardware and software requirements and Evaluating your storage needs.

Another notable advantage of this approach is that you can scale your storage just by adding new disks without increasing the number of server nodes or changing any other configuration.

 

Optimized hardware requirements

We have optimized the per-node requirements for minimum processor and RAM . You now need 8 (v-)CPU/cores and 16 GiB of RAM per node to install Automation Suite in multi-node HA-ready production mode. For more details, see Hardware and software requirements.

 

Improved backup and restore

We have simplified the backup and restore strategy so that you can use a single command. Capture the snapshot at any point in time using the on-demand snapshot command, or set up a schedule to do it for you by just providing the desired frequency. Define the retention policy for any snapshot and create multiple restoration points for your cluster.
Backing up your cluster configuration protects you from unwanted data failure, as you can always restore to the latest snapshot.

 

Zero downtime Cumulative Updates

We want you to have quick and easy access to our latest bug fixes and improvements, so we've improved the upgrade experience. Whenever possible, you can move from a 2022.10.x minor version to another without worrying about downtime. Generally, Cumulative Updates (CUs) no longer require upgrading the entire infrastructure and the shared suite platform layer. As a result, Automation Suite CUs are less disruptive, and getting the latest bug fixes and improvements is easier than ever.

 

Optimized upgrades

When upgrading an offline Automation Suite installation to a new major version, you can now minimize the downtime. All you need to do is hydrate docker-registry and containerd with container images for the new product version before the upgrade. For instructions, see Automated: Offline upgrade and Manual: Offline upgrade.

 

SAML POST binding

When configuring the SAML integration for your organization, we now also support the HTTP POST option for the SAML binding type setting.
Depending on how you set up the identity provider, you can now select HTTP redirect to use URL parameters, or HTTP POST to use an HTML form with base64-encoded content instead.

 

Major platform updates

The Automation Suite internal components have received major updates to improve your overall experience with the platform. RKE2 and Rancher are the stars of the event, but many other internal components have seen considerable enhancements as well. For details, check out the Internal component version section.

 

Increased server node fault tolerance

We now offer the possibility of increasing the node fault tolerance for Longhorn and Ceph storage beyond 1. For this purpose, we have introduced a new cluster_config.json parameter: fault_tolerance. For instructions, see Advanced installation experience.

 

Certificate improvements

We have made some changes to the way identity token-signing certificates are updated. Previously, you had to provide a certificate in .pfx format to the --cert-file-path flag and a password to the --password flag in the configureUiPathAS.sh script.

Starting with Automation Suite 2022.10, you must provide a certificate in .pem format to --cert-file-path and specify the certificate private key using the --cert-key-file-path flag.

For details, see Managing identity token signing certificate.

 

Improved capacity calculator

We have improved the Automation Suite Install Sizing Calculator so that you can easily check how much hardware you need to deploy any Automation Suite setup. The tool now covers the newly onboarded products, and factors in all updated hardware requirements. If you want to migrate to external objectstore, you will find the tool useful. The same goes for performing backup and restore operations, changing the node fault tolerance configuration, or configuring a multi-site deployment.
If you want to take the calculator for a spin, see Capacity planning documentation.

 

Script improvements

We have made changes to all our scripts not only so that they reflect the new functionality introduced by this Automation Suite release, but also to fix some bugs.

 

Security improvements

We continue to provide security updates and patches to address Common Vulnerability and Exposures (CVE).

In addition to that, we have enhanced security hardening of container images used in UiPath products by standardizing and reducing the surface area of base container images up to ~90% in some cases. This helps in reducing the overall volume of CVEs in product images.

Last but not least, all container images are now digitally signed with a UiPath-owned key. This adds an additional layer of security to ensure the integrity of product artifacts in production registry.

 

Miscellaneous

  • We have improved the cluster uninstall operation, with the dedicated script performing raw device cleanup. For details, see Uninstalling the cluster.

  • The IP address of sources generating traffic is now logged by Istio, whereas previously it was masked by the IP address of the load balancer.

  • External apps can now authenticate using the client credentials flow.

 

Bug fixes


  • When users who did not have the organization administrator role navigated to the Management portal URL, they were navigated to an administrator-only page (https://<server>/identity/management/users) and saw a message stating that the URL does not exist, which was confusing. Now, the message This URL is only available to admins is displayed when they navigate to an admin-only page, and they are navigated to a non-administrator page.

  • You could not delete or modify users unless you were a member of the Administrators group.

  • We have made some changes to the configureUiPathAS.sh script to fix an issue causing certificate rotation to fail when a wildcard domain name (*) was not provided as a Subject Alternative Name (SAN).

  • When the TLS certificate expired, the Diagnostics tool was showing a warning instead of throwing an error.

  • The installUiPathAS.sh interactive installer did not check if the required ports were already in use before starting the installation.

 

Known issues


  • :warning: Erratum 18 November 2022: Trying to remove a node would fail in any of the following scenarios:

    • If you enabled external storage;
    • If Process Mining (AirFlow) and/or Automation Suite Robots service pods are scheduled on the node.
  • An Azure known issue incorrectly marks the Azure disk as non-SSD. If Azure is your cloud provider, and you want to configure the Ceph OSD disk, we have a workaround for you. Just follow the instructions in Troubleshooting.

  • Disabling or changing the AD integration settings does not update the underlying directory connections properly. As a workaround, delete the SQL DirectoryConnections and ExternalIdentityProviders table entries, then restart the Identity pods.

  • If you enable only Process Mining via the installUiPathAS.sh interactive installer, you must exit just before the installation step, and modify the cluster_config.json file generated at the /opt/UiPathAutomationSuite/cluster_config.json location by adding the following configuration: platform.enabled="true".

 

Deprecation timeline


We recommend that you regularly check the deprecation timeline for any updates regarding features that will be deprecated and removed.

 

Bundling details


Product versions

To find out what has changed on each Automation Suite product, visit the following links.
If the product is greyed out, this new Automation Suite version does not bring any changes to it.

Internal third-party component versions

Click here for details on the internal components this Automation Suite release bundles.
ComponentVersion
RKE2v1.22.12+rke2r1
ArgoCDv2.2.12
rook-cephv1.8.9
cert-manager1.9.1
rancher2.6.7
longhorn1.3.1
longhorn-crd1.1.100
reloaderv0.0.89
csi-driver-smbv1.8.0
rabbitmq-operator1.5.0
redis-operatorv6.2.10-45
redis-clusterv6.2.10-129
mongodb5.0.7-ent
docker_registry2.7.1

Updated 14 days ago


2022.10.0


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.