Changing the Replicated IP Address on a Terraform Enterprise Instance Server

Introduction

When changing the IP address of a Terraform Enterprise instance server, you must also update the IP address within the underlying Replicated configuration. This ensures the Terraform Enterprise application remains operable after the network change.

Use Case

This procedure is necessary when migrating a Terraform Enterprise instance to a new Virtual Private Cloud (VPC) or any other scenario that results in a change to the server's primary IP address. Failing to update the Replicated configuration after an IP change can prevent Terraform Enterprise services from starting correctly.

Procedure

This workflow involves modifying the PRIVATE_ADDRESS, DAEMON_HOST, and PUBLIC_ADDRESS parameters in the Replicated operator configuration files and restarting the associated services.

Note: On systemd-based systems such as RHEL, CentOS, and modern Ubuntu versions, these configuration files are typically located at /etc/sysconfig/replicated and /etc/sysconfig/replicated-operator. You may also find them in the /etc/default directory.

1. Connect to the Terraform Enterprise instance server using SSH.
2. Edit the /etc/sysconfig/replicated file and update the PRIVATE_ADDRESS parameter with the new IP address.
3. Edit the /etc/sysconfig/replicated-operator file and update the PRIVATE_ADDRESS, DAEMON_HOST, and PUBLIC_ADDRESS parameters with the new IP address.

4. Verify that the Docker service is running.

   # systemctl status docker

   If the service is not active, start it.

   # systemctl start docker

5. Restart the Replicated services to apply the IP address changes.

   # systemctl restart replicated replicated-operator

Verification

1. Check the status of the Replicated services to ensure they started successfully.

   # systemctl status replicated
   # systemctl status replicated-operator

2. Attempt to access the Terraform Enterprise web UI using the new IP address or associated DNS name to confirm the application is operational.

Additional Information

For more details from the vendor, please see Replicated's documentation on How to Handle an IP Change.