- Overview
- Requirements
- Installation
- Q&A: Deployment Templates
- Step 1.1: Creating the VM
- Step 1.2: Configuring the VM
- Step 2: Configuring the Load Balancer
- Step 3: Configuring Azure SQL
- Step 4: Configuring the DNS
- Post-installation
- Cluster administration
- Managing products
- Managing the cluster in ArgoCD
- Setting up the external NFS server
- Automated: Enabling the Backup on the Cluster
- Automated: Disabling the Backup on the Cluster
- Automated, Online: Restoring the Cluster
- Automated, Offline: Restoring the Cluster
- Manual: Enabling the Backup on the Cluster
- Manual: Disabling the Backup on the Cluster
- Manual, Online: Restoring the Cluster
- Manual, Offline: Restoring the Cluster
- Additional configuration
- Migrating objectstore from persistent volume to raw disks
- Monitoring and alerting
- Migration and upgrade
- Migration options
- 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 Insights
- Step 7: Deleting the default tenant
- Performing a single tenant migration
- Product-specific configuration
- Best practices and maintenance
- Troubleshooting
- How to Troubleshoot Services During Installation
- How to Uninstall the Cluster
- How to clean up offline artifacts to improve disk space
- How to clear Redis data
- How to enable Istio logging
- How to manually clean up logs
- How to clean up old logs stored in the sf-logs bucket
- How to disable streaming logs for AI Center
- How to debug failed Automation Suite installations
- How to delete images from the old installer after upgrade
- How to automatically clean up Longhorn snapshots
- How to disable TX checksum offloading
- How to address weak ciphers in TLS 1.2
- Unable to run an offline installation on RHEL 8.4 OS
- Error in Downloading the Bundle
- Offline installation fails because of missing binary
- Certificate issue in offline installation
- First installation fails during Longhorn setup
- SQL connection string validation error
- Prerequisite check for selinux iscsid module fails
- Azure disk not marked as SSD
- Failure After Certificate Update
- Automation Suite not working after OS upgrade
- Automation Suite Requires Backlog_wait_time to Be Set 1
- Volume unable to mount due to not being ready for workloads
- RKE2 fails during installation and upgrade
- Failure to upload or download data in objectstore
- PVC resize does not heal Ceph
- Failure to Resize Objectstore PVC
- Rook Ceph or Looker pod stuck in Init state
- StatefulSet volume attachment error
- Failure to create persistent volumes
- Storage reclamation patch
- Backup failed due to TooManySnapshots error
- All Longhorn replicas are faulted
- Setting a timeout interval for the management portals
- Update the underlying directory connections
- Cannot Log in After Migration
- Kinit: Cannot Find KDC for Realm <AD Domain> While Getting Initial Credentials
- Kinit: Keytab Contains No Suitable Keys for *** While Getting Initial Credentials
- GSSAPI Operation Failed With Error: An Invalid Status Code Was Supplied (Client's Credentials Have Been Revoked).
- Alarm Received for Failed Kerberos-tgt-update Job
- SSPI Provider: Server Not Found in Kerberos Database
- Login Failed for User <ADDOMAIN><aduser>. Reason: The Account Is Disabled.
- ArgoCD login failed
- Failure to get the sandbox image
- Pods not showing in ArgoCD UI
- Redis Probe Failure
- RKE2 Server Fails to Start
- Secret Not Found in UiPath Namespace
- After the Initial Install, ArgoCD App Went Into Progressing State
- MongoDB pods in CrashLoopBackOff or pending PVC provisioning after deletion
- Unexpected Inconsistency; Run Fsck Manually
- Degraded MongoDB or Business Applications After Cluster Restore
- Missing Self-heal-operator and Sf-k8-utils Repo
- Unhealthy Services After Cluster Restore or Rollback
- RabbitMQ pod stuck in CrashLoopBackOff
- Prometheus in CrashloopBackoff state with out-of-memory (OOM) error
- Missing Ceph-rook metrics from monitoring dashboards
- Pods cannot communicate with FQDN in a proxy environment
- Using the Automation Suite Diagnostics Tool
- Using the Automation Suite support bundle
- Exploring Logs
This step is mandatory for a multi-node HA-ready production deployment or a single-node evaluation deployment with a dedicated Task Mining and/or GPU node.
If you are configuring a single-node evaluation deployment without a dedicated Task Mining and/or GPU node, proceed to Configuring Azure SQL.
If you are using the Azure Internal Load Balancer (LB) for deployments, you can encounter issues with the calls from the backend Virtual Machine (VM) to the LB frontend IP. The issues occur due to source IP and MAC address mismatch of the network packet. This prevents the recipient from working out the correct response path, resulting in the failure of calls from the VM to the LB. For more details, see Azure Load Balancer Components limitations and Backend Traffic Troubleshooting.
Step 2.1: Adding a frontend IP
-
Create an Azure load balancer using this link. Select Create.
-
Add to the same Resource Group and give the instance a name.
-
Go to Next: Frontend IP configuration.
-
Select Add a frontend IP.
-
Select Add.
Step 2.2: Creating the backend pool and add nodes
If you are installing Task Mining, the dedicated Task Mining should not be added in the node pool.
The Task Mining Analyzer node should not be added in the node pool.
-
Create the Backend Pool.
-
Select on Add under Virtual Machines.
-
You can now proceed with the creation of the Load Balancer by selecting Review + create.
Make sure to repeat these steps for all virtual networks corresponding to each node.
The recommended configuration is to add two backend pools, as follows:
- one backend pool that includes all server nodes (referred to as the Server Pool);
- one backend pool with all server and agent nodes (minus the Task Mining node, and this pool is referred to as the Node Pool in our documentation).
The Server Pool is associated with the kubeapi-probe, whereas the Node Pool is associated with the https-probe.
Step 2.3: Adding health probes
-
Go the Health Probes section in the Settings tab, and select Add.
-
Add these 3 health probes for the load balancer.
Go to health probe and select Add, filling in the following configurations:
- https-probe:
- protocol TCP
- port
443
- kubeapi-probe:
- protocol TCP
- port
6443
- https-probe:
-
For each health probe, fill in the following configuration form:
Step 2.4: Adding a load balancing rule
The load balancer must forward traffic to all nodes on the ports 443, 6443, and 9345.
-
Go to the Load balancing rules in the Settings tab.
-
Create three load balancing rules for each of the health probes:
- https-probe
443- HTTPS
- kubeapi-probe
6443- Kube API
See the following configuration page for updating the load balancing rule:
For specifying the backend pool, make sure you add the
kubeapi-probeto the server pool and thehttps-probeto the node pool. - https-probe
Step 2.5: Creating a load balancer domain name
-
Search the public IP address assigned to load balancer in the search bar.
-
Fill in the DNS name label and select Save.