osup - system upgrade manager for vpsAdminOS
osup [global options] command [command options] [arguments...]
osup is a command line program managing system upgrades of vpsAdminOS.
handles upgrades and downgrades of
osctl-managed data stored on ZFS pools.
This includes editing container/user/group configuration files, ZFS datasets
and other assets when some backward-incompatible change is introduced in
osup is run by
osctld when it import pools to ensure that the current
osctld is compatible with the data pools.
Do not show header, useful for scripts.
osctldare up to date, in need of an upgrade or a rollback. Each line of the output describes one ZFS pool. There are four columns:
statusis one of
ok- the pool is up-to-date,
outdated- the pool needs an upgrade and
incompatible- the pool needs a rollback.
versionis the pool's latest version that
osupcan work with.
flagsis a list of words separated by a comma. Known words are:
-- empty word, used when no flags are set
export- the pool has to be exported from
osctldbefore it can be migrated
stop- all containers have to be stopped during the export
incompatible, the pool needs to be rolled back to
version. Your current OS version will not be able to do it. You need to upgrade the OS to a version that can work with the pool, even if your goal is to downgrade the OS. To use a pool on an older OS version, you need to roll it back on a newer OS to
osup rollbackpool version, then downgrade the OS.
checkfor a list of pool flags. If the rollback cannot be done,
osupwill exit with an error.
osctldafter it has installed pool.
osupwill set the pool's version by marking all supported migrations as applied.
Overwrite the version file even if it already exists and isn't empty.
Unless you know what you're doing, this can potentially break both
osctld if the pool isn't in the expected state.
osupwill apply all available migrations until the system is up-to-date, or version has been reached.
upgradeon all pools marked as used by
rollbackon all pools marked as used by
osup is saving a list of applied migrations in a file on each pool. The file
is located at
<pool mountpoint>/.migrations, or at
<dataset mountpoint>/.migrations in case
osctld is scoped in a subdataset.
Report bugs to https://github.com/vpsfreecz/vpsadminos/issues.
osup is a part of vpsAdminOS.