Introduction
This guide runs through the steps for uninstalling Terraform Enterprise that is using the Replicated deployment option, using an uninstall script.
Expected Outcome
Terraform Enterprise (Replicated) is uninstalled.
Prerequisites
- Terraform Enterprise
- Replicated
Precaution
Prior to uninstalling Terraform Enterprise, it is recommended to export the existing application configuration for reference. Some critical information such as encryption password is required to match the previous installation if re-installation is performed, otherwise Terraform Enterprise will not be able to access existing information stored in the PostgreSQL database and in object storage. The following command can be used to export application configuration.
replicatedctl app-config export --hiddenUse Case
Uninstalling a Terraform Enterprise (Replicated) deployment, primarily when creating a new instance may not be an option for a broken or corrupted installation.
Procedure
Stop the Terraform Enterprise application and Replicated services.
- Stop the Terraform Enterprise application from the Replicated console on port 8800 or on the command line using
replicatedctl:
replicatedctl app stop- Verify that the Terraform Enterprise application has stopped using the following command:
replicatedctl app status- The output should show the
Stateasstopped. Please note, it may take a few minutes. This process stops and removes the Docker containers running the Terraform Enterprise application. - Once Terraform Enterprise has stopped, stop the Replicated services:
systemctl stop replicated replicated-ui replicated-operator
Uninstall the Terraform Enterprise application and Replicated services using the uninstall script.
- Follow the steps in Uninstall Terraform Enterprise to download and run the uninstall script.