illumos: manual page: onu.1onbld

ONU(1ONBLD) illumos Build Tools ONU(1ONBLD)

NAME

onu - OS/Net Update

SYNOPSIS

onu [opts] [-s <beName>] -t <beName>
onu [opts] -r

DESCRIPTION

onu is a replacement for bfu used to update a system with the latest set
of IPS packages for the ON (OS/Net) consolidation of Solaris, using
beadm(8) to create a new Boot Environment (BE) and pkg(1) to update the
image.

OPTIONS

The following global options are supported:

-c <consolidation>
Specifies the consolidation being installed via onu, used to locate
the publisher from which that consolidation is currently installed.
This is almost always "osnet".

-d <dir>
Specifies that <dir> contains the repo.redist sub-directory; onu will
run a depot using this packaging repository. Note that -d ignores -u
and -U as well as the environment variables used by those options.

-u <URI>
Specifies that <URI> should be used as the origin URI for the
publisher packaging repository. See ONURI below for default values.

-U <publisher>
Specifies that <publisher> should be used as the publisher name for
the packaging repository. See ONPUB below for default values.

-v Verbose mode.

The first form of onu creates a new BE and then updates it, and takes the
following options:

-s <beName>
Specifies that <beName> should be used as the source Boot Environment
to clone. The default is the active BE.

-t <beName>
Specifies the target BE name. This argument is required; there is no
default value.

-Z Do not update any installed zones.

The second form of onu takes the following option:

-r In the current BE configure the requested publisher appropriately,
without updating.

EXIT STATUS

The following exit values are returned:

0 The command completed successfully. No errors or warnings were
reported.

1 Incorrect usage.

2 One of the commands used by the script failed.

NOTES

Former users of bfu should note the following ways in which onu behaves
differently from bfu. First, as noted above, onu creates a new BE,
rather than updating an existing BE in-place. Second, onu will not
install packages that are older than what is already installed in the
source BE. Third, conflicts in system configuration files are
automatically resolved according to the files' "preserve" attribute, as
described in pkg(7).

If the -d option is given to specify a repository directory, the new
publishers will not be available in the new BE. This can prevent correct
zone installs or cause issues with installing additional packages sourced
from the ON repositories. In both cases, the -r option can be used in the
new BE to re-enable the publishers. See EXAMPLES.

Use of onu will prevent use of zone attach for ipkg-brand zones in the
new BE, since the entire incorporation is removed.

By default, onu will attempt to update any ipkg-brand installed zones on
the system; the -Z option may be used to disable this behavior.

EXAMPLES

Example 1: Installing latest ON nightly build

# onu -t new-nightly-be

Example 2: Installing an ON build from a directory

# onu -d /path/to/my/ws/packages/`uname -p`/nightly -t new-nightly-be

Example 3: Installing additional packages in the new BE

# onu -d /path/to/my/ws/packages/`uname -p`/nightly -t new-nightly-be
# reboot
# onu -r -d /path/to/my/ws/packages/`uname -p`/nightly
# pkg install netcat
#

ENVIRONMENT

ONURI

If the -u option is not provided, and this variable is set, it
will be used as the origin URI for the publisher packaging
repository. If -u is not provided and this variable is not set,
http://ipkg.sfbay/on-nightly will be used.

ONPUB

If the -U option is not provided, and this variable is set, it
will be used as the publisher name for the packaging repository.
If -U is not provided and this variable is not set, on-nightly
will be used.