Upgrade from Unmanaged Installation

Prerequisites

Before proceeding, ensure you have:

• An existing unmanaged Manifest installation directory
• AWS CLI configured with the manifest profile
• Docker installed and running

Getting Started

All commands are run from the machine where you performed the original installation.

1. Set your AWS_PROFILE environment variable

export AWS_PROFILE=manifest

2. Download the installer script, bundle, and install tools container (Manifest will provide the correct version)

export VERSION=<version>
export INSTALL_TOOLS_VERSION=<version>

aws s3 cp s3://manifest-deployables/on-prem/install.sh install.sh
aws s3 cp "s3://manifest-deployables/on-prem/k3s-on-prem-${VERSION}.tar" k3s-on-prem-${VERSION}.tar

aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin 623542229617.dkr.ecr.us-east-1.amazonaws.com

docker pull 623542229617.dkr.ecr.us-east-1.amazonaws.com/install-tools:${INSTALL_TOOLS_VERSION}

3. Run the installer to extract the bundle

chmod +x install.sh
./install.sh --bundle k3s-on-prem-${VERSION}.tar

4. Run the command displayed to add the manifest-installer to your PATH.

Migration

1. Migrate your existing installation to the managed deployment structure

manifest-installer migrate --source ~/manifest-install --deployment default

2. Upgrade to complete the migration

manifest-installer upgrade --verbose --to ${VERSION}

Next Steps

After migration completes:

• Review the Troubleshooting Guide if you encounter issues