[TFE] Redis Issue: "ERR wrong number of arguments for 'hset' command"

Problem

When using an unsupported version of external Redis, Terraform Enterprise may fail to start or operate correctly. The application logs display a warning related to an incorrect number of arguments for a Redis command.

WARN: Redis::CommandError: ERR wrong number of arguments for 'hset' command

Prerequisites

• Terraform Enterprise version v202301-1 or newer.
• An external Redis instance is configured for Terraform Enterprise.

Cause

Terraform Enterprise release v202301-1 introduced support for Redis v6 and v7. This and subsequent versions of Terraform Enterprise use Redis commands that are only available in Redis v6 or later. If your external Redis instance is running a version older than v6, Terraform Enterprise will fail to execute commands like hset correctly, leading to this error.

Solution

To resolve this issue, you must upgrade your external Redis instance to a supported version, which is v6 or later. Ensure that the Redis version you choose is compatible with your specific version of Terraform Enterprise by consulting the official product documentation.

Additional Information

• This issue was reproduced on Terraform Enterprise v202411-1 running in a Flexible Deployment Options (FDO) environment on OpenShift with an incompatible external Redis Enterprise version.
• For guidance on configuring a compatible Redis instance, refer to the Redis Enterprise configuration documentation.