NAME

appjail-upgrade — Upgrade a jail or a release

SYNOPSIS

DESCRIPTION

The appjail upgrade is a utility to fetch files necessary for upgrading a jail or a release to a new FreeBSD release.

appjail upgrade can't upgrade a jail or a release that comes from an empty release or a build from the FreeBSD source tree. In the case of jails, only thick jails can be upgraded.

The options are as follows:

jail -i [-f] jail

-i

Install the most recently fetched updates or upgrade in a jail.

-f

Force freebsd-update(8) fetch to proceed in the case of an unfinished upgrade

jail -u -n new-release [-f] jail

-u

Fetch files necessary for upgrading a jail to a new FreeBSD release.

-n new-release

Specify the new release (e.g., 11.2-RELEASE) to which freebsd-update(8) should upgrade.

-f

Force freebsd-update(8) fetch to proceed in the case of an unfinished upgrade

release -i -n new-release [-If] [-a arch] [-v version] [release]

-i

Install the most recently fetched updates or upgrade in a release. By default, the release specified by the DEFAULT_RELEASE parameter is used.

-n new-release

Specify the new release (e.g., 11.2-RELEASE) to which freebsd-update(8) should upgrade.

-I

Ignore invalid FreeBSD release syntax.

-f

Force freebsd-update(8) fetch to proceed in the case of an unfinished upgrade

-a arch

Match release with the given architecture.

-v version

Match release with the given version.

release -u -n new-release [-If] [-a arch] [-v version] [release]

-u

Fetch files necessary for upgrading a release to a new FreeBSD release. By default, the release specified by the DEFAULT_RELEASE parameter is used.

Since there is a possibility that existing thin jails are still using the old release, this parameter makes a copy of the release with the version and architecture you specified and performs the upgrade using it. The release with the previous version remains intact.

If a failed upgrade is detected, this option continues by removing the release that matches the new version to perform the upgrade again.

-n new-release

Specify the new release (e.g., 11.2-RELEASE) to which freebsd-update(8) should upgrade.

-I

Ignore invalid FreeBSD release syntax.

-f

Force freebsd-update(8) fetch to proceed in the case of an unfinished upgrade

-a arch

Upgrade release with the given architecture.

-v version

Upgrade release with the given version.

EXIT STATUS

The appjail upgrade utility exits 0 on success, and >0 if an error occurs.

SEE ALSO

appjail-fetch(1) appjail-update(1) sysexits(3)

AUTHORS

Jesús Daniel Colmenares Oviedo <DtxdF@disroot.org>