itu(1m) - osol9

1itu(1M)                 System Administration Commands                 itu(1M)
2
3
4

NAME

6       itu  -  convert  packages  to  Driver  Update  format and patch Solaris
7       install media for Install Time Update
8

SYNOPSIS

10       itu makedu -r solaris_release [-v] [-f] [-d output_dir] [-o iso_file]
11            [-l iso_label] package [package...]
12
13
14       itu updatemedia -R media_root [-v] [-f] [-o iso_file]
15            [-l iso_label] pkg_or_patch [pkg_or_patch...]
16
17
18       itu makeiso -o iso_file [-v] [-l iso_label] media_root
19
20

DESCRIPTION

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

OPTIONS

28       The following options are supported:
29
30       -d output_dir
31
32           Directory where the Driver Update directory is to be created.
33
34
35       -f
36
37           If output_dir/DU or iso_file already exists, remove it without ask‐
38           ing first.
39
40
41       -l iso_label
42
43           Label/volume name of the ISO image (if -o option is specified).
44
45
46       -o iso_file
47
48           Path of the ISO image file to be created. For subcommands updateme‐
49           dia  and makeiso, it will be a bootable ISO image. This option must
50           be specified for subcommand makeiso.
51
52
53       -R media_root
54
55           Top-level directory of on-disk image of Solaris installation media.
56           This option must be specified for subcommand updatemedia.
57
58
59       -r solaris_release
60
61           Solaris  release number for which the Driver Update is intended. It
62           takes the form of the output of uname -r, for example,  5.10.  This
63           option must be specified for subcommand makedu.
64
65
66       -v
67
68           Verbose. Multiple -v options increase verbosity.
69
70

SUB-COMMANDS

72       The itu subcommands are described as follows.
73
74   makedu
75       The  makedu  subcommand  takes one or more driver packages as input and
76       converts them to DU format. At the beginning of an interactive  Solaris
77       installation  session,  these driver updates can be applied to the run‐
78       ning kernel, which will then also automatically apply them to the newly
79       installed Solaris at the end of the installation process.
80
81
82       The  -r  option  is  required to specify the Solaris release number for
83       which the driver updates apply.  The  solaris_release  option  argument
84       takes the form uname -r output, for example, 5.10 or 5.11.
85
86
87       If  the  -d  option  is  specified,  the resulting DU directory tree is
88       placed in the directory output_dir.
89
90
91       If the -o option is specified, a (non-bootable) ISO  image  of  the  DU
92       directory  tree  is written in the file iso_file. This ISO image can be
93       burned onto a CD/DVD using cdrw(1) or  cdrecord(1)  (not  a  SunOS  man
94       page). See the "Examples" section below for an example of creating a DU
95       on a floppy.
96
97
98       At least one of -d and -o option must be specified. If both are  speci‐
99       fied, then both an ISO image and a directory tree are generated.
100
101   updatemedia
102       The  updatemedia subcommand takes a list of driver packages and patches
103       as input and applies them to the miniroot of a Solaris  install  media.
104       It  also  places  them  in a subdirectory called ITUs under the Solaris
105       install media's top-level directory:
106
107         media_root/ITUs
108
109
110
111
112       When booting a system from the updated media, the patches and  packages
113       will  be part of the booted Solaris image. They will also be applied to
114       the target system being  installed  at  the  end  of  the  installation
115       process.
116
117
118       The  -R  option  must  be  entered  on  the command line to specify the
119       Solaris install media. Note that the install media must be on  a  loca‐
120       tion that is writable by itu.
121
122
123       If  the  -o  option  is  specified, a bootable ISO image of the patched
124       install media is also created in the file iso_file. The ISO  image  can
125       then be burned onto a CD or DVD.
126
127   makeiso
128       The makeiso subcommand runs mkisofs(8) to create a bootable Solaris ISO
129       image of the Solaris install media media_root and writes it to the file
130       iso_file.  The  ISO image file can then be burned onto a CD or DVD with
131       utilities such as cdrw(1) or cdrecord(1).  (Note  that  mkisofs(8)  and
132       cdrecord(1) are not SunOS man pages.)
133
134       Caution -
135
136         The   Solaris   install   media  media-root  must  contain  the  file
137         boot/grub/stage2_eltorito, which will be written to  the  media  boot
138         sectors.  This file will be modified with some boot information, thus
139         it has to be writable. If necessary, first save a copy, prior to run‐
140         ning this subcommand.
141

OPERANDS

143       The following operands are supported:
144
145       package [package...]
146
147           One or more driver packages.
148
149
150       pkg_or_patch [pkg_or_patch...]
151
152           One or more patches or packages.
153
154
155       media_root
156
157           The top-level directory of a Solaris install media.
158
159

EXAMPLES

161       Example 1 Creating a DU CD/DVD
162
163
164       The  following  commands  create  a Driver Update CD/DVD containing the
165       packages SAMPLEpkg1 and SAMPLEpkg2.
166
167
168         # itu makedu -r 5.10 -o my.iso SAMPLEpkg1 SAMPLEpkg2
169         # cdrw -i my.iso
170
171
172
173       Example 2 Creating a DU Floppy
174
175
176       The following commands create a Driver  Update  floppy  containing  the
177       driver package MYdriver.
178
179
180         # rmformat -F quick /dev/rdiskette
181         # mkfs -F pcfs /dev/rdiskette
182         # mount -F pcfs /dev/diskette /mnt
183         # /usr/bin/itu makedu -r 5.10 -d /mnt /export/MYdriver
184         # umount /mnt
185         # dd if=/dev/rdiskette of=floppy.dd
186
187
188
189
190       The  itu  command above creates the DU directly onto the floppy mounted
191       on /mnt. The dd invocation stores an image of the floppy  in  the  file
192       floppy.dd.  This  is  useful for distributing a DU floppy in file form.
193       From the file, the floppy can then be recreated as follows:
194
195
196         # dd if=floppy.dd of=/dev/rdiskette
197
198
199
200       Example 3 Patching the Solaris Install Media
201
202
203       The  following  command  patches   the   Solaris   install   media   in
204       /export/s10u1  with  patch  /opt/patches/123456-07  and  driver package
205       /opt/pkgs/MYdriver. The command also creates a bootable ISO image  with
206       ISO label "MyS10U1" in the file /tmp/dvd.iso.
207
208
209         # /usr/bin/itu updatemedia -R /export/s10u1 -o /tmp/dvd.iso -l MyS10U1 \
210                /opt/patches/123456-07 /opt/pkgs/MYdriver
211
212
213
214       Example 4 Creating a Bootable ISO Image
215
216
217       The  following  commands create the bootable ISO image mydvd.iso of the
218       Solaris install image /export/solaris-10u1  with  ISO  label  "Special-
219       S10".
220
221
222         # /usr/bin/itu makeiso -o mydvd.iso -l "Special-S10" \
223              /export/solaris-10u1
224         # cdrw -i mydvd.iso
225
226
227

ATTRIBUTES

229       See attributes(5) for descriptions of the following attributes:
230
231
232
233
234       ┌─────────────────────────────┬─────────────────────────────┐
235       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
236       ├─────────────────────────────┼─────────────────────────────┤
237       │Availability                 │SUNWcsu                      │
238       ├─────────────────────────────┼─────────────────────────────┤
239       │Interface Stability          │Committed                    │
240       └─────────────────────────────┴─────────────────────────────┘
241