Operate

Upgrade or remove Punaha

Prepare a version specific upgrade or an ordered removal while protecting installation identity and data.

Current RC1 replacement limit

Use a fresh, separate evaluation installation for rebuild-20261012. Replacing an earlier RC1 in place, database migration, and rollback have not been validated.

Do not uninstall your existing copy as a shortcut to upgrading. Keep its data, configuration, protected identity, and backups. Do not apply the older repair2 bundle to this rebuild.

The exact new Windows MSI passed repair, restart, complete uninstall and reinstall in an isolated Windows Server 2025 VM. Uninstall cleanup now follows the ASCII installation path. This does not establish upgrade acceptance.

Before an upgrade

Use an upgrade path qualified for the exact starting build, target package, operating system, and database. RC1 source support is not a guarantee for every older development installation.

  1. Record the installed version, package, provider, node roles, and ports.
  2. Stop new work under the approved maintenance plan and create a consistent recovery checkpoint.
  3. Include all three databases, required shared files, and the corresponding protected installation state.
  4. Verify the target package and read its platform instructions.
  5. Review how to recover if the target fails readiness.

Keep upgrade separate from removal

A supported MSI upgrade preserves configuration and protected state. The Ubuntu upgrade wizard retains existing choices and saves a protected settings copy. That settings copy is not a database backup.

Same version replacement, downgrade, and incomplete installation recovery need their explicit platform procedure. Do not uninstall first as a shortcut for upgrading.

Check the result

Verify the target version, retained settings, registration status, every node, and service readiness. Check safe workflow, case, document, and sign in journeys before reopening normal work.

If the upgrade fails

Keep the installer evidence and recovery copies. Do not assume the installer automatically restores databases or downgrades safely. Use the approved recovery checkpoint.

Remove an installation

Export and back up required information while normal access is available. Revoke and uninstall additional Nodes before removing the Primary. Review the platform's data removal behaviour before confirming.

Loss of registration does not itself delete data. Export before the 720 TPM powered on hour cutoff because expired allowance blocks ordinary exports.

The registration service is not online yet. Renewal cannot currently restore RC1 access. Preserve the installation and seek release specific guidance if the cutoff has already passed.

Next step

Use Make a safe production change and Verify a backup and restore.

Pūnaha Docs

Search the guides

Enter at least two characters.

    Product screen

    View the full screenshot