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

Summary

Terraform Enterprise (TFE) may fail to start when configured with unsupported or older versions of external Redis. This issue arises in environments using Redis versions below v6.

Prerequisites

• TFE version: >= v202301-1
  • Rationale: Redis v6 and v7 are supported starting in this release.
• External Redis (e.g., Active-Active mode).

Tested Configuration

• TFE FDO on OpenShift
• TFE Version: v202411-1
• Redis: Redis Enterprise

Troubleshooting

1. Check TFE logs for the following warning:

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

Solution

• Verify that your Redis version is v6 or later.
• Ensure that the version aligns with your current TFE release requirements.
• If using Redis OSS, consider upgrading or switching to Redis Enterprise for compatibility. See Redis Enterprise configuration settings on TFE.