Automation Suite on OpenShift installation guide

• Install and configure Redis, either on your OpenShift cluster or on different servers external to the OpenShift cluster.
• Install the Redis Enterprise Operator on your OpenShift cluster. To install Redis Enterprise Operator through OperatorHub, follow the instructions in this section. If you install multiple Automation Suite instances on the same cluster, make sure to install Redis in all the corresponding namespaces and replace the redis host accordingly in the input.json file based on each installation.
  Note:

  • Automation Suite does not come with a Redis Enterprise Operator license. You must obtain a license directly from Redis or use a UiPath-provided HAA Redis license.
  • If you use Redis Enterprise Operator version 6.2.18-41 or earlier, you must install the security context constraint before installing the operator. For more information, see the Redis documentation.

Installing Redis Enterprise Operator​

1. In the OpenShift interface, navigate to Operators > OperatorHub.
2. In the search field, search for Redis Enterprise.
3. Select Redis Enterprise Operator provided by Redis in the result list. The entry is marked as Certified. By default, the image is pulled from the Red Had registry.
4. On the Install Operator page, specify the namespace for the operator. Only one namespace per operator is supported.
5. Update the channel with the version you want to install. For more information about specific versions, see the operator release notes.
6. Choose an approval strategy. For production systems, use Manual to make sure that operator updates require your approval.
7. Select Install and approve the installation plan.

Creating the Redis Enterprise cluster​

1. Create a redis-enterprise-cluster.yaml file with the following contents:

   assignment

   ---
   apiVersion: app.redislabs.com/v1
   kind: RedisEnterpriseCluster
   metadata:
     name: rec
   spec:
     bootstrapperImageSpec:
       repository: registry.connect.redhat.com/redislabs/redis-enterprise-operator
     persistentSpec:
       enabled: true
     redisEnterpriseServicesRiggerImageSpec:
       repository: registry.connect.redhat.com/redislabs/services-manager
     redisEnterpriseImageSpec:
       imagePullPolicy: IfNotPresent
       repository: registry.connect.redhat.com/redislabs/redis-enterprise
     nodes: 1
     uiServiceType: ClusterIP
   ---
   apiVersion: app.redislabs.com/v1
   kind: RedisEnterpriseCluster
   metadata:
     name: rec
   spec:
     bootstrapperImageSpec:
       repository: registry.connect.redhat.com/redislabs/redis-enterprise-operator
     persistentSpec:
       enabled: true
     redisEnterpriseServicesRiggerImageSpec:
       repository: registry.connect.redhat.com/redislabs/services-manager
     redisEnterpriseImageSpec:
       imagePullPolicy: IfNotPresent
       repository: registry.connect.redhat.com/redislabs/redis-enterprise
     nodes: 1
     uiServiceType: ClusterIP
   

   Set the value of the nodes parameter in the YAML file to determine the number of pods running in the Redis Enterprise cluster.

2. Apply the configuration in the YAML file to the OpenShift cluster by running the following command:

   Note:

   Replace the <redis-namespace> placeholder in the command with the namespace that you used in the previous step.

   assignment

   oc apply -f redis-enterprise-cluster.yaml -n "<redis-namespace>"
   oc apply -f redis-enterprise-cluster.yaml -n "<redis-namespace>"
   

3. Verify that the cluster is in a Running state by using the following command. The command requires the jq utility to be installed on your machine.

   assignment

   oc get RedisEnterpriseCluster -n <redis-system> -o json | jq -r '.items[0].status.state'
   oc get RedisEnterpriseCluster -n <redis-system> -o json | jq -r '.items[0].status.state'
   

   To install jq, use one of the following options:

   • Option 1: Run the following command:
   assignment

   yum install -y epel-release yum install -y jq
   yum install -y epel-release yum install -y jq
   

   • Option 2: Run the following commands:
   assignment

   shell
   curl https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/j/jq-1.6-2.el7.x86_64.rpm --output /tmp/jq-1.6-2.el7.x86_64.rpm
   yum localinstall /tmp/jq-1.6-2.el7.x86_64.rpm
   shell
   curl https://download-ib01.fedoraproject.org/pub/epel/7/x86_64/Packages/j/jq-1.6-2.el7.x86_64.rpm --output /tmp/jq-1.6-2.el7.x86_64.rpm
   yum localinstall /tmp/jq-1.6-2.el7.x86_64.rpm
   

Creating the Redis database​

1. Create a redis-database.yaml file with the following contents:
   assignment

   ---
   apiVersion: app.redislabs.com/v1alpha1
   kind: RedisEnterpriseDatabase
   metadata:
     name: redb
   spec:
     tlsMode: disabled
     databasePort: 6380
   ---
   apiVersion: app.redislabs.com/v1alpha1
   kind: RedisEnterpriseDatabase
   metadata:
     name: redb
   spec:
     tlsMode: disabled
     databasePort: 6380
   

2. Apply the configuration in the YAML file to the OpenShift cluster by running the following command:
   Note:

   Replace the <redis-namespace> placeholder in the command with the namespace that you used in the previous step.

   assignment

   oc apply -f redis-database.yaml -n "<redis-namespace>"
   oc apply -f redis-database.yaml -n "<redis-namespace>"
   

3. Verify that the database is in an active state by running the following command:
   assignment

   oc get redisenterprisedatabase -n "<redis_namespace>" -o json | jq -r '.items[0].status.status'
   oc get redisenterprisedatabase -n "<redis_namespace>" -o json | jq -r '.items[0].status.status'
   

Updating the cluster configuration file​

  "fabric": {
    "redis": {
      "hostname": "redb.<redis-namespace>.svc.cluster.local",
      "port": 6380,
      "password": "<password>",
      "tls": false
    }
  },
  "fabric": {
    "redis": {
      "hostname": "redb.<redis-namespace>.svc.cluster.local",
      "port": 6380,
      "password": "<password>",
      "tls": false
    }
  },

oc get secret -n <redis-namespace> redb-redb -o json | jq -r '.data.password' | base64 -d
oc get secret -n <redis-namespace> redb-redb -o json | jq -r '.data.password' | base64 -d