Error: "support bundle V1 is not implemented in replicatedctl" when generating a Support Bundle in Terraform Enterprise (Replicated)

Problem

Attempting to generate a Support Bundle for Terraform Enterprise (TFE) using either tfe-admin support-bundle or replicatedctl support-bundle, as described in the Support Bundles for Replicated Deployments documentation, fails with the following error.

Error: response from daemon: support bundle V1 is not implemented in replicatedctl, please use `replicated apps` and `replicated support-bundle <app-id>` instead

Cause

Changes to the Replicated version or modifications to the Replicated configuration may cause this issue.

Solutions

There are two solutions to resolve this issue. The first solution has no downtime, while the second requires a restart of the Terraform Enterprise application.

Solution 1: Use the replicated support-bundle Command (No Downtime)

As suggested by the error message, you can use an alternative command to generate the support bundle.

1. Obtain the application ID for Terraform Enterprise.

   $ replicated apps

2. Use the application ID to generate the support bundle.

   $ replicated support-bundle <app-id>

Note: For Active/Active deployments, you must run these commands on each node.

Solution 2: Restore replicatedctl Functionality (Requires Downtime)

This solution restores the original replicatedctl support-bundle functionality but requires an application restart, which will cause service downtime.

1. Run the following command to update the Replicated parameters.

   $ replicatedctl params set SupportBundleExternal --value "true"

2. After making this update, you must restart the application for the changes to take effect. Stop the application first.

   $ replicatedctl app stop

3. Restart the Replicated services.

   $ systemctl restart replicated replicated-operator

Note: For Active/Active deployments, you must run the above commands on each node.