sysupgrade(8) - OpenBSD manual pages (original) (raw)

NAME

sysupgrade —upgrade system to the next release or a new snapshot

SYNOPSIS

sysupgrade	[-fkns] [-b base-directory] [-R version] [installurl \|path]

DESCRIPTION

sysupgrade is a utility to upgradeOpenBSD to a new release or snapshot if available.

sysupgrade downloads the necessary files to /home/_sysupgrade, verifies them withsignify(1), and copies bsd.rd to/bsd.upgrade.

sysupgrade by default then reboots the system. The bootloader will automatically choose/bsd.upgrade, triggering a one-shot upgrade using the files in /home/_sysupgrade.

The options are as follows:

-b base-directory

Download files tobase-directory/_sysupgrade instead of /home/_sysupgrade.

-f

For snapshots, force an already applied upgrade. This option has no effect on releases.

-k

Keep the files in /home/_sysupgrade. By default they will be deleted after the upgrade.

-n

Fetch and verify the files and create /bsd.upgrade but do not reboot.

-R version

Upgrade to a specific release version. Only upgrades from one version to the next are tested. Skipping versions may work. Downgrading is unlikely to work.

-s

Upgrade to a snapshot. The default is to upgrade to the next release.

When updating to a release or snapshot which lacks the required signify keys in /etc/signify, the missing keys will be downloaded in a secure way. In the usual case, the keys will already be present because OpenBSD releases ship with the current key, the next key, and a collection of older keys.

See upgrade.site(5) for how to customize the upgrade process.

FILES

/auto_upgrade.conf

Response file for the ramdisk kernel.

/bsd.upgrade

The ramdisk kernel to trigger an unattended upgrade.

/etc/installurl

OpenBSD mirror top-level URL for fetching an upgrade.

/home/_sysupgrade

Directory the upgrade is downloaded to.

HISTORY