Replicated upgrade fails with: /usr/local/bin/replicated: Text file busy

Problem

When upgrading Terraform Enterprise, the installation of Replicated fails with the following error message.

/install.sh: line 2041: /usr/local/bin/replicated: Text file busy

If a support bundle was generated, the Replicated container logs may show that components were not successfully upgraded, with entries similar to the following.

WARN [operator] server.go:313 Operator API version "2.46.1" does not meet minimum requirement of "2.53.6", aborting announcement...
ERRO tasks/app_tasksteps.go:145 Failed to start the app: Unmet start requirement: License requires at least 1 node to be connected, found 0.

Prerequisites

• This issue applies to Terraform Enterprise upgrades where Replicated is also being upgraded, affecting both online and airgapped installation methods.

Cause

This error occurs when security or antivirus agents running on the Terraform Enterprise instance prevent the installer from replacing the Replicated binary files. These agents may be unalterable due to organizational security policies. The specific files being locked are:

• /usr/local/bin/replicated
• /usr/local/bin/replicatedctl

Solution

To resolve this issue, you must manually remove the locked files and re-run the installation script.

1. Manually delete the files that are preventing the upgrade from completing.

   # sudo rm -f /usr/local/bin/{replicated,replicatedctl}

2. Execute the install.sh script again. Add any required flags for your environment.

   # sudo bash ./install.sh no-docker no-proxy

Outcome

After you complete these steps, Replicated will upgrade successfully, and the install.sh script will output a confirmation message with the URL to access the Replicated Console.