- 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
- 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
AI Center and Document Understanding pods fail to start with TLS certificate verification enabled
Solutions for pod startup failures with TLS verification in Automation Suite on EKS/AKS, including volume mount configuration.
Description
When database TLS certificate verification is enabled (trustservercertificate=false in the SQL connection string), some AI Center and Document Understanding pods may get stuck in Init:CrashLoopBackOff. The await-migration-completion init container fails to connect to the database, with TLS/SSL handshake errors in the logs.
Solution
To address the issue, take the following steps:
-
Disable Auto-Sync for AI Center and Document Understanding in ArgoCD.
-
Manually add the following volume mounts to the
await-migration-completioninit container in each affected deployment.For
aistorageandaistorage-cleanup:- mountPath: /etc/pki/ca-trust/extracted/java/ name: java - mountPath: /etc/pki/ca-trust/extracted/edk2/ name: edk2 - mountPath: /etc/pki/ca-trust/extracted/pem/ name: pem - mountPath: /etc/pki/ca-trust/extracted/openssl/ name: openssl - mountPath: /etc/pki/ca-trust/source/anchors/ name: cert-location- mountPath: /etc/pki/ca-trust/extracted/java/ name: java - mountPath: /etc/pki/ca-trust/extracted/edk2/ name: edk2 - mountPath: /etc/pki/ca-trust/extracted/pem/ name: pem - mountPath: /etc/pki/ca-trust/extracted/openssl/ name: openssl - mountPath: /etc/pki/ca-trust/source/anchors/ name: cert-locationFor
du-digitizeranddu-digitizer-cleanup:- mountPath: /etc/ssl/certs name: cert-trust-store - mountPath: /usr/local/share/ca-certificates name: cert-location- mountPath: /etc/ssl/certs name: cert-trust-store - mountPath: /usr/local/share/ca-certificates name: cert-locationNote:These volumes are already defined at the pod level and only need to be mounted into the init container.
-
Enable Auto-Sync again.