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