What are general troubleshooting steps for the uiPath High Availability Add-on (HAA) and Redis?
Issue Description
HAA is a supported solution based on the Redis in-memory database for coordinating multiple UiPath Orchestrator nodes and unattended robots.
This article provides general troubleshooting and guidance for issues occur during or after installation.
Resolution
An expired HAA license will not affect the functionality of a Redis node/cluster, however it may affect the available support options. The cluster will function normally with an expired license. The license does not enable any capability, as it is an indication of an enterprise support contract.
For issues with Azure Redis, follow the steps in Troubleshooting Azure Redis Connectivity Issues.
Basic connectivity
To determine the network location used for HAA, check the Redis connection string parameters in UiPath.Orchestrator.dll.config.
Follow the steps to verify the cluster installation and confirm the cluster and database status.
Perform a Redis And HAA Connectivity Check:
- Ensure the telnet feature is enabled on the Orchestrator server.
- Open command prompt in admin mode, write the command : telnet <ipofmaster> <port>. Here, ipofmaster is the IP address of Redis server and port is the Redis port (10000 for HAA, 6379 by default).
- With PowerShell, check using the command Test-NetConnection -ComputerName <ipofmaster or hostname> -Port <portnumber>
- If the port is enabled and service is listening on Redis server, verify successful connection via telnet.
- Once authenticated, it should be possible to run all the Redis commands, like, keys *
- If any telnet command returns an error, either the Redis service is not running or the connectivity between Orchestrator and Redis server is not available.
- Immediate troubleshooting:
If the Redis frontend is not accessible, SSH into any node and run the following commands to check the Redis cluster status:
- rladmin status extra all
- Output Of The rladmin Status Command - A red exclamation mark is a UI indication of a running state machine or the DB change process is in progress.
- rlcheck
- Verification utility used to perform a basic health check, confirm a successful installation, and verify that the node is functioning on Redis Enterprise instances
Logs and details
The following information will help troubleshoot any issue more quickly:
- What action / component is failing, for example: Login with local user, Get Transaction Item, Add Queue Item, Submit Log Message?
- Is this failing intermittently - Yes/No
- Type of Orchestrator deployment - Single/Multi-node
- Type of HAA/Redis deployment - Single/Multi-node
- Clear timestamp with time-zone if possible
- Redis Support Package - Create a support package
- Automation Suite : Collect Logs using Support Bundle
- Orchestrator server Application Event Viewer logs (all nodes - MSI installation)
Create a UiPath support case, attaching the troubleshooting steps taken, findings, Redis support package, and collected logs.
For active HAA subscriptions, UiPath will create a support case with Redis, as appropriate, to coordinate additional support.
Instances without an active HAA license will be provided troubleshooting within our scope and may be redirected to Redis support for further assistance.
Common Redis troubleshooting
Update Redis Certificate Step-By-Step
How to change Redis DB port
How to modify Redis DB Password
Redis probe failure and rebuilding Redis cluster - Cluster fails to sync after non-graceful reboots or service restarts.
Connection refused HAA Installation Error
How To Configure TLS Authentication And Encryption With HAA Addon
Redis Installation Fail - Port 53
HAA Start_Redis_Servers Service Fails to Start - Error: FAILED - node bootstrapped state Failure: connect: connection failed: Error 111 connecting to unix socket: /var/opt/redislabs/run/ccs.sock.
Redis Flushall Error - Fix for Redis Error " root@lduiphaa01:~ # redis-cli FLUSHALL
Troubleshooting Guide: 500 Internal Server Error / Server Error In '/' Application
Redis Pods In Automation Suite Out Of Sync Due To x509 Certificate Expiration
How To Troubleshoot Pods In UiPath Namespace Stuck In Init Due To Secret "redb-redis-cluster-db" Not Found?
Multi-Node Installation Giving A (#199 - You Are Not Authenticated!)
Moving From HA To Single-Server Orchestrator
How to Uninstall HAA (High Availability Add on UiPath) On Linux Machine
How To Configure TLS Authentication And Encryption With HAA Addon
How To Prevent Redis Headcrab Attack For Multi Node Deployment?