Upgrade

Upgrade the SMP Operator and the Harness Platform through the Installer UI.

You can upgrade the Harness SMP Operator and the Harness Platform separately, and perform both upgrades through the Installer UI. An operator upgrade updates the platform-installer Helm release, and a platform upgrade updates Harness SMP itself.

There are two upgrade types, and each one targets a different component.

• Operator upgrade: Upgrades the platform-installer Helm release.

• Platform upgrade: Upgrades the Harness SMP.

---

What will you learn in this topic?

By the end of this topic, you will be able to:

• Upgrade the operator to a newer Harness Operator version.

• Upgrade the platform by uploading and applying a workflow bundle.

---

Before you begin

Before you upgrade, ensure you have the following:

• A running installation: A deployed SMP Operator that passes the verification checks. For more information, see Post-installation checks.

• Installer UI access: The admin email and password you supplied during installation, and the DNS hostname you installed with.

• Target versions: The operator version or workflow version you upgrade to. For more information, see Releases.

• Private registry contents (air-gapped only): The target operator version mirrored into your private registry.

---

Upgrade the operator

An operator upgrade updates the platform-installer. Trigger it from the Installer UI by supplying the version you want.

1. Open the Installer UI at https://<YOUR_DNS>/pi

2. Navigate to Upgrade Cluster → Upgrade Operator

3. Enter the Harness Operator version you want to upgrade to

4. Click Trigger Upgrade

AIR-GAPPED ENVIRONMENTS

For air-gapped customers, the operator version you want to upgrade to must already be available in your private registry before initiating the upgrade.

---

Upgrade the platform

A workflow upgrade is performed when upgrading Harness SMP. Download the workflow bundle for the target version, upload it through the Installer UI, and then apply it.

Step 1: Download the workflow bundle

Retrieve the workflow bundle for the version you upgrade to.

curl -L -o workflow-<VERSION>.tgz \
  "https://pkg.harness.io/pkg/G_iX-gJ_SiSGIITUoe06eQ/platform-installer/files/harness-clustermgr/<VERSION>/workflow-<VERSION>.tgz"

Step 2: Upload via the Installer UI

Make the downloaded bundle available to the operator.

1. Open the Installer UI at https://<YOUR_DNS>/pi

2. Navigate to Upgrade Cluster

3. Click Upload Workflow Version and upload the workflow-<VERSION>.tgz file

Step 3: Apply the upgrade

Select the version you uploaded and confirm the changes to start the upgrade.

1. Select the uploaded version from the dropdown

2. Click Next

3. Review the changes

4. Click Apply

---

Related articles

• Releases: Look up the latest operator and workflow versions.

• Post-installation checks: Verify the deployment after an upgrade completes.

• Troubleshooting and support: Resolve common issues.