Upgrade distribution
| Ninja upgrade distribution command is not supported for generic repository deployments. |
The upgrade-distribution command a composite command that will do multiple steps at once:
The midPoint instance has to be stopped before running this command.
The upgrade-distribution command requires using the --installation-directory option which specifies the installation directory.
Pre-upgrade check
The pre-upgrade check can be skipped using the --skip-pre-check option.
This might be useful for custom builds with a DB schema version that does not match the expected version of the corresponding midPoint release.
Verification
The verification step checks for items with critical priority and stops the upgrade if any are found.
Although not recommended, this step can be skipped using the --skip-verification option.
Download distribution
By default, Ninja downloads the recommended target distribution for the current installation. For regular releases, this is the next supported minor version. For LTS releases, this is the next supported LTS version.
Use the --distribution-version option to download a different version.
To skip the download altogether and use an already downloaded distribution archive, use the --distribution-archive <PATH_TO_ZIP> option.
Upgrade DB schema (Run SQL)
The database schema is upgraded using the run-sql command and the SQL scripts downloaded in the previous step.
Upgrade installation
The final step upgrades the midPoint installation by updating the installation directory with files from the new distribution.
A backup of the replaced files can be created using the --backup-midpoint-directory option.
The midpoint.home directory is not modified during this step.