Redis Configuration

If you are planning to run ITX Runtime Server instances in fenced mode, run maps asynchronously or cache catalog entries, you must install Redis prior to installing ITX Runtime Server.

Redis installation is not included and must be obtained separately. Ensure that the Redis you install comes from a reputable source that you trust. Redis version 6.0.6 was validated with this version of ITX Runtime Server and this version or later is the recommended version to use. Older Redis versions may not function as expected when combined with this product and may need to be upgraded before they can be used.

The installed Redis service must be accessible to all ITX Runtime Server pods, at the same host URL and port, which means it must be accessible to all worker nodes to which ITX Runtime Server pods are deployed.

If the selected Redis installation requires password for authentication, you must create a Kubernetes Secret object with the Redis password to use for connecting to Redis. You may give the Secret object any name, you only need to make sure to provide that name as the redis.secret configuration parameter value when deploying the server. The password value must be base64-encoded and must be set in the ITX_RS_REDIS_PASSWORD key within the Secret object.

Example: Presuming the Redis password is mypassword, start by based64-encoding it by running the base64 command in a Linux shell:

echo -n mypassword | base64

The above command will return base64-encoded value of the provided password. In this example the returned value will be bXlwYXNzd29yZA==.

Create a YAML file to store the Secret definition and store the following content in it:

apiVersion: v1
kind: Secret
metadata:
  name: itx-rs-redis-secret
type: Opaque
data:
  ITX_RS_REDIS_PASSWORD: "bXlwYXNzd29yZA=="

Apply the file to your target namespace in the OpenShift cluster. You can do it from the command line using tools like kubectl or oc, or from the OpenShift web console. If you have created and applied a file from the command line, you may want to permanently delete the yaml file after applying it, since it will contain the Redis password.