Use Case
When Terraform Enterprise fails to perform normal operations, it is often necessary to review the application’s internal logging to determine the root cause. A support bundle is commonly recommended as a starting point to investigate the internal components due to the comprehensive information it gathers in order to provide the context of events and symptoms to system administrators and HashiCorp Support.
Procedure
Gain Access to the Terraform Enterprise Container Command Line:
- Follow the instructions for your container management system (Docker or Kubernetes) as shown here.
Run tfectl command:
tfectl support bundle
Mounted disk installations
Terraform Enterprise will generate support bundles in /run/terraform-enterprise/support-bundles.
External Services, Active/Active and Kubernetes installations
Terraform Enterprise will upload the support bundles to the same object store bucket where Terraform state files are stored. Each specific run of the admin support bundle command will upload the bundle to a directory with the same JobID, which is a timestamp in RFC3339 format (bucket/node/timestamp).
Sending a support bundle to HashiCorp Support
Please make sure to package and send all associated bundles to ensure that we have all the necessary information.
support-bundles
└── 2020-11-10T02:03:05Z
├── 10.0.0.5
│ └── 10.0.0.5-support-bundle-timestamp.tar.gz
└── 10.0.0.6
└── 10.0.0.6-support-bundle-timestamp.tar.gz
Additional Information
- Further documentation on Support Bundle Generation is available here
- If you continue to experience issues after following this guide, please contact HashiCorp Support for further assistance.