Print this page
6205 onbld manuals should be declared as 1onbld
Reviewed by: Dan McDonald <danmcd@omniti.com>
Reviewed by: Josef Sipek <jeffpc@josefsipek.net>
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/tools/scripts/onu.1
+++ new/usr/src/tools/scripts/onu.1onbld
1 1 .\" " CDDL HEADER START
2 2 .\" "
3 3 .\" " The contents of this file are subject to the terms of the
4 4 .\" " Common Development and Distribution License (the "License").
5 5 .\" " You may not use this file except in compliance with the License.
6 6 .\" "
7 7 .\" " You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
8 8 .\" " or http://www.opensolaris.org/os/licensing.
9 9 .\" " See the License for the specific language governing permissions
10 10 .\" " and limitations under the License.
11 11 .\" "
12 12 .\" " When distributing Covered Code, include this CDDL HEADER in each
|
↓ open down ↓ |
12 lines elided |
↑ open up ↑ |
13 13 .\" " file and include the License file at usr/src/OPENSOLARIS.LICENSE.
14 14 .\" " If applicable, add the following below this CDDL HEADER, with the
15 15 .\" " fields enclosed by brackets "[]" replaced with your own identifying
16 16 .\" " information: Portions Copyright [yyyy] [name of copyright owner]
17 17 .\" "
18 18 .\" " CDDL HEADER END
19 19 .\" "
20 20 .\" "Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
21 21 .\" "Copyright 2010, Richard Lowe
22 22 .\" "
23 -.TH onu 1 "28 August 2010"
23 +.TH onu 1ONBLD "28 August 2010"
24 24 .SH NAME
25 25 .I onu
26 26 \- OS/Net Update
27 27 .SH SYNOPSIS
28 28 \fBonu [opts] [-s <beName>] -t <beName>\fP
29 29 .br
30 30 \fBonu [opts] -r\fP
31 31 .LP
32 32 .SH DESCRIPTION
33 33 .IX "OS-Net build tools" "onu" "" "\fBonu\fP"
34 34 .LP
35 35 .I onu
36 36 is a replacement for
37 37 .I bfu
38 38 used to update a system with the latest set of IPS packages for the ON
39 39 (OS/Net) consolidation of Solaris, using beadm(1M) to create a new Boot
40 40 Environment (BE) and pkg(1) to update the image.
41 41 .SH OPTIONS
42 42 .LP
43 43 The following global options are supported:
44 44 .TP 4
45 45 .B \-c <consolidation>
46 46 Specifies the consolidation being installed via
47 47 .IR onu ,
48 48 used to locate the publisher from which that consolidation is currently
49 49 installed. This is almost always "osnet".
50 50 .TP 4
51 51 .B \-d <dir>
52 52 Specifies that <dir> contains the repo.redist sub-directory;
53 53 .I onu
54 54 will run a depot using this packaging repository.
55 55 Note that -d ignores -u and -U as well
56 56 as the environment variables used by those options.
57 57 .TP 4
58 58 .B \-u <URI>
59 59 Specifies that <URI> should be used as the origin URI for the publisher
60 60 packaging repository. See \fBONURI\fP below for default values.
61 61 .TP 4
62 62 .B \-U <publisher>
63 63 Specifies that <publisher> should be used as the publisher name for
64 64 the packaging repository. See \fBONPUB\fP below for default values.
65 65 .TP 4
66 66 .B \-v
67 67 Verbose mode.
68 68 .LP
69 69 The first form of onu creates a new BE and then updates it, and takes
70 70 the following options:
71 71 .TP 4
72 72 .B \-s <beName>
73 73 Specifies that <beName> should be used as the source Boot Environment to
74 74 clone. The default is the active BE.
75 75 .TP 4
76 76 .B \-t <beName>
77 77 Specifies the target BE name. This argument is required; there
78 78 is no default value.
79 79 .TP 4
80 80 .B \-Z
81 81 Do not update any installed zones.
82 82 .LP
83 83 The second form of onu takes the following option:
84 84 .TP 4
85 85 .B \-r
86 86 In the current BE configure the requested publisher appropriately, without
87 87 updating.
88 88 .SH EXIT STATUS
89 89 .LP
90 90 The following exit values are returned:
91 91 .TP 4
92 92 .B 0
93 93 The command completed successfully.
94 94 No errors or warnings were reported.
95 95 .LP
96 96 .TP 4
97 97 .B 1
98 98 Incorrect usage.
99 99 .LP
100 100 .TP 4
101 101 .B 2
102 102 One of the commands used by the script failed.
103 103 .SH NOTES
104 104 .LP
105 105 Former users of bfu should note the following ways in which onu behaves
106 106 differently from bfu. First, as noted above, onu creates a new BE, rather
107 107 than updating an existing BE in-place. Second, onu will not install packages
108 108 that are older than what is already installed in the source BE. Third,
109 109 conflicts in system configuration files are automatically resolved according
110 110 to the files' "preserve" attribute, as described in pkg(5).
111 111 .LP
112 112 If the
113 113 .B -d
114 114 option is given to specify a repository directory, the new
115 115 publishers will not be available in the new BE. This can prevent correct
116 116 zone installs or cause issues with installing additional packages
117 117 sourced from the ON repositories. In both cases, the \fB-r\fR option
118 118 can be used in the new BE to re-enable the publishers. See
119 119 \fBEXAMPLES\fR.
120 120 .LP
121 121 Use of
122 122 .I onu
123 123 will prevent use of zone attach for ipkg-brand zones in the new BE,
124 124 since the
125 125 .B entire
126 126 incorporation is removed.
127 127 .LP
128 128 By default,
129 129 .I onu
130 130 will attempt to update any ipkg-brand installed zones on the system; the
131 131 .B -Z
132 132 option may be used to disable this behavior.
133 133 .SH EXAMPLES
134 134 .LP
135 135 \fBExample 1\fR Installing latest ON nightly build
136 136 .LP
137 137 .SP
138 138 .IN +2
139 139 .NF
140 140 # onu -t new-nightly-be
141 141 .FI
142 142 .IN -2
143 143 .SP
144 144 .LP
145 145 \fBExample 2\fR Installing an ON build from a directory
146 146 .LP
147 147 .SP
148 148 .IN +2
149 149 .NF
150 150 # onu -d /path/to/my/ws/packages/`uname -p`/nightly -t new-nightly-be
151 151 .FI
152 152 .IN -2
153 153 .SP
154 154 .LP
155 155 \fBExample 3\fR Installing additional packages in the new BE
156 156 .LP
157 157 .SP
158 158 .IN +2
159 159 .NF
160 160 # onu -d /path/to/my/ws/packages/`uname -p`/nightly -t new-nightly-be
161 161 .br
162 162 # reboot
163 163 .br
164 164 # onu -r -d /path/to/my/ws/packages/`uname -p`/nightly
165 165 .br
166 166 # pkg install netcat
167 167 .br
168 168 #
169 169 .FI
170 170 .IN -2
171 171 .SP
172 172 .SH ENVIRONMENT
173 173 .LP
174 174 ONURI
175 175 .IP
176 176 If the -u option is not provided, and this variable is set, it will be used
177 177 as the origin URI for the publisher packaging repository. If -u is not
178 178 provided and this variable is not set, http://ipkg.sfbay/on-nightly will
179 179 be used.
180 180 .LP
181 181 ONPUB
182 182 .IP
183 183 If the -U option is not provided, and this variable is set, it will be
184 184 used as the publisher name for the packaging repository. If -U is not
185 185 provided and this variable is not set, on-nightly will be used.
186 186 .LP
187 187 .SH SEE ALSO
188 188 .BR beadm "(1M), "
189 189 .BR pkg "(1), "
190 190 .BR pkg "(5) "
|
↓ open down ↓ |
157 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX