Description

The itu utility converts driver packages to Driver Update (DU) format and
patches a Solaris install media with driver packages and patches for Install
Time Update (ITU). itu has three subcommands: makedu, updatemedia and makeiso.

Options

The following options are supported:

-doutput_dir

Directory where the Driver Update directory is to be created.

-f

If output_dir/DU or iso_file already exists, remove it without asking first.

-liso_label

Label/volume name of the ISO image (if -o option is specified).

-oiso_file

Path of the ISO image file to be created. For subcommands updatemedia and makeiso, it will be a bootable ISO image. This option must be specified for subcommand makeiso.

-Rmedia_root

Top-level directory of on-disk image of Solaris installation media. This option must be specified for subcommand updatemedia.

-rsolaris_release

Solaris release number for which the Driver Update is intended. It takes the form of the output of uname-r, for example, 5.10. This option must be specified for subcommand makedu.

-v

Verbose. Multiple -v options increase verbosity.

Sub-commands

The itu subcommands are described as follows.

makedu

The makedu subcommand takes one or more driver packages as input and
converts them to DU format. At the beginning of an interactive Solaris
installation session, these driver updates can be applied to the running kernel,
which will then also automatically apply them to the newly installed Solaris at
the end of the installation process.

The -r option is required to specify the Solaris release number for
which the driver updates apply. The solaris_release option argument takes the form
uname-r output, for example, 5.10 or 5.11.

If the -d option is specified, the resulting DU directory tree is
placed in the directory output_dir.

If the -o option is specified, a (non-bootable) ISO image of the
DU directory tree is written in the file iso_file. This ISO image
can be burned onto a CD/DVD using cdrw(1) or cdrecord(1) (not a
SunOS man page).

At least one of -d and -o option must be specified. If
both are specified, then both an ISO image and a directory tree
are generated.

updatemedia

The updatemedia subcommand takes a list of driver packages and patches as
input and applies them to the miniroot of a Solaris install media.
It also places them in a subdirectory called ITUs under the Solaris
install media's top-level directory:

media_root/ITUs

When booting a system from the updated media, the patches and packages
will be part of the booted Solaris image. They will also be
applied to the target system being installed at the end of the
installation process.

The -R option must be entered on the command line to specify
the Solaris install media. Note that the install media must be on
a location that is writable by itu.

If the -o option is specified, a bootable ISO image of the
patched install media is also created in the file iso_file. The ISO
image can then be burned onto a CD or DVD.

makeiso

The makeiso subcommand runs mkisofs(8) to create a bootable Solaris ISO image
of the Solaris install media media_root and writes it to the file
iso_file. The ISO image file can then be burned onto a CD or
DVD with utilities such as cdrw(1) or cdrecord(1). (Note that mkisofs(8) and
cdrecord(1) are not SunOS man pages.)

Caution - The Solaris install media media-root must contain the file boot/grub/stage2_eltorito, which will
be written to the media boot sectors. This file will be modified
with some boot information, thus it has to be writable. If necessary, first
save a copy, prior to running this subcommand.

Operands

The following operands are supported:

package [package...]

One or more driver packages.

pkg_or_patch [pkg_or_patch...]

One or more patches or packages.

media_root

The top-level directory of a Solaris install media.

Examples

Example 1 Creating a DU CD/DVD

The following commands create a Driver Update CD/DVD containing the packages SAMPLEpkg1
and SAMPLEpkg2.

# itu makedu -r 5.10 -o my.iso SAMPLEpkg1 SAMPLEpkg2
# cdrw -i my.iso

Example 2 Patching the Solaris Install Media

The following command patches the Solaris install media in /export/s10u1 with patch
/opt/patches/123456-07 and driver package /opt/pkgs/MYdriver. The command also creates a bootable ISO
image with ISO label “MyS10U1” in the file /tmp/dvd.iso.