tfe-admin health-check command fails with sh: /root/ptfe-health-check: not found

Problem

The tfe-admin health-check command fails with a not found error.

# tfe-admin health-check
sh: /root/ptfe-health-check: not found

Since tfe-admin is an alias for replicated admin, running the command directly produces the same error.

# replicated admin health-check
sh: /root/ptfe-health-check: not found

Prerequisites

• Terraform Enterprise versions v202204-1 and v202204-2.

Cause

In the affected versions, the health check process was updated to run as an unprivileged user. This change modified the binary's path from /root/ptfe-health-check to /run/ptfe-health-check. However, the command alias was not updated and still references the old path, causing the error.

Solution

To resolve this issue, you can create a temporary shell alias that points to the correct health check binary path.

Procedure

1. Connect to the Terraform Enterprise instance and open the ~/.bashrc file using a text editor.

2. Add the following alias to the file. This alias directs the healthcheck command to the correct binary path.

   alias healthcheck='docker exec -it ptfe_health_check /run/ptfe-health-check'

3. Save the file and reload your shell profile to apply the changes.

   # source ~/.bashrc

Outcome

Run the new healthcheck alias to verify the fix. The command should now execute successfully and display the health check results.

# healthcheck

The expected output shows all checks passing.

checking: Archivist Health Check...
| checks that Archivist is up and healthy
|- ✓ PASS
checking: Terraform Enterprise Health Check...
| checks that Terraform Enterprise is up and can communicate with Redis and Postgres
|- ✓ PASS
checking: Terraform Enterprise Vault Health Check...
| checks that Terraform Enterprise can connect to Vault and is able to encrypt and decrypt tokens
|- ✓ PASS
checking: Fluent Bit Health Check...
| checks that the configure Fluent Bit server is healthy
|- SKIPPED
checking: RabbitMQ Health Check...
| checks that RabbitMQ can be connected to and that we can send and consume messages
|- ✓ PASS
checking: Vault Server Health Check...
| checks that the configured Vault Server is healthy
|- ✓ PASS
All checks passed.

Additional Information

This issue was permanently resolved in Terraform Enterprise version v202205-1. We recommend upgrading to the latest version of Terraform Enterprise.

For more details, please refer to the official Terraform Enterprise release notes.