update-tfe-license
Terraform Enterprise requires an up-to-date license to maintain normal operations. These licenses have an expiration date, and must be updated once expired. This article provides the guidelines for updating licenses in Terraform Enterprise.
Find the License Expiration Date
You can find the expiration date through either the Replicated console UI or the Replicated command line interface.
Replicated Console
Navigate to the Replicated console at
https://<<TFE_HOSTNAME>>:8800
, and click on the gear icon in the top-right corner.Select the View License menu to display the license details, including the expiration date.
Replicated Command Line Interface
Connect to the Terraform Enterprise host machine using SSH.
Use the
replicatedctl license inspect
command to inspect the license information. TheExpirationTime
value in the output indicates the expiration date/time in UTC.
Update License - Online Installation Type
Automatic Updates
With the online installation type, you can use the following steps to configure Terraform Enterprise to periodically check for the updated license.
Navigate to the Replicated console at
https://<<TFE_HOSTNAME>>:8800
Click on the gear icon in the top-right corner select the Console Settings menu.
Scroll down to the License Sync section and select how often Terraform Enterprise should check the license.
Manual Updates
Replicated Console
Navigate to the Replicated console at
https://<<TFE_HOSTNAME>>:8800
, click on the gear icon on the top-right corner, and select the View License menu.Click on Sync License to start the operation.
Replicated Command Line Interface
Obtain the newly updated license file from HashiCorp and copy it to the Terraform Enterprise host machine.
Connect to the Terraform Enterprise host machine using SSH.
Load the new license.
Update License - Airgap Installation Type
Replicated Console
Navigate to the Replicated console at
https://<<TFE_HOSTNAME>>:8800
.Click on the gear icon in the top-right corner and select the Console Settings menu.
Select Airgapped Settings from the left menu and upload the license.
Replicated Command Line Interface
Obtain the updated license and airgap package from HashiCorp and copy them to the Terraform Enterprise host.
Connect to the Terraform Enterprise host machine using SSH.
Execute the following command, updating the paths as needed.
Troubleshooting
No error but the license is not updated
In the Airgap installation, the license update operation may finish without any error but the license detail displayed on the Replicated console or the Replicated command line output is still not updated. This symptom can be related to the incorrect license file being used. In order to further identify the symptom, please follow these steps:
Connect to the Terraform Enterprise host machine using SSH.
Run
docker logs replicated
and look for the warning message below.Please contact your assigned Customer Success Manager or HashiCorp Support for further assistance. When contacting support, please include the output from running
replicatedctl license inspect
on the Terraform Enterprise host machine.
Unable to sync license: Error: Unsuccessful HTTP response
Terraform can produce this error message for several different issues.
Network communication to the Replicated servers
Terraform Enterprise requires network communication to the Replicated endpoints, as noted in the network requirements guideline. During the license sync operation, the Replicated installer attempts to contact
api.replicated.com
to retrieve the license information. In the online installation type, you might see the above error if the network infrastructure changed after you installed Terraform Enterprise. The specific IP addresses of Replicated services for the Terraform Enterprise are available in Replicated’s GitHub repository.Customer name on new license does not match existing license
This may occur with an Airgap installation for a variety of reasons. One example is when a trial license is associated with a different customer name from the subsequent paid license. Please contact HashiCorp Support for assistance. In your request, include the output from running
replicatedctl license inspect
on the Terraform Enterprise host machine.
Incorrect version of airgap file
This error indicates that you are using the incorrect version of airgap file against the installed version of Terraform Enterprise.
The airgap download page displays the versions of Terraform Enterprise and their SHA256 checksum values. Check these against the version of the airgap package in your local environment.
Get Support
If you continue to experience the issues, please contact HashiCorp Support for assistance.