Terraform Enterprise Fails to Upgrade with "market app version not found" Error

Introduction

This article troubleshoots an issue where a Terraform Enterprise installation or upgrade fails with a market app version not found error message in the Replicated logs.

Problem

During a Terraform Enterprise installation or upgrade, the process fails and enters a restart cycle. The Replicated logs contain the following error messages.

INFO marketlicense/app.go:200 Failed to get app YAML: market app version not found
ERRO daemon/daemon.go:410 License bootstrap failed: install license online: process license properties: finalize license import online: market app version not found

While the second message mentions a license issue, the key error is market app version not found.

Cause

This error occurs when the release sequence number provided to the installation script or configured in /etc/replicated.conf is not an active or valid release. Terraform Enterprise releases are not always sequential.

For example, the release sequence may jump from one number to another, skipping integers in between.

v202110-1 576
v202111-1 582

Specifying a non-existent release sequence number, such as 577 or 581, will cause the installation to fail with the error shown above.

Solution

To resolve this issue, you must provide a valid and active release sequence number for the desired Terraform Enterprise version.

1. Verify the correct release sequence number for the version of Terraform Enterprise you are installing or upgrading to.
2. Use the correct number in your installation script or update it in the /etc/replicated.conf file.
3. Retry the installation or upgrade process.

Additional Information

You can find the official list of versions and their corresponding release sequence numbers in the Terraform Enterprise Release Sequence Versions knowledge base article.