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.man.txt
+++ new/usr/src/tools/scripts/onu.1onbld.man.txt
1 -onu(1) User Commands onu(1)
1 +onu(1ONBLD) illumos Build Tools onu(1ONBLD)
2 2
3 3
4 4
5 5 NAME
6 6 onu - OS/Net Update
7 7
8 8 SYNOPSIS
9 9 onu [opts] [-s <beName>] -t <beName>
10 10 onu [opts] -r
11 11
12 12 DESCRIPTION
13 13 onu is a replacement for bfu used to update a system with the latest
14 14 set of IPS packages for the ON (OS/Net) consolidation of Solaris, using
15 15 beadm(1M) to create a new Boot Environment (BE) and pkg(1) to update
16 16 the image.
17 17
18 18 OPTIONS
19 19 The following global options are supported:
20 20
21 21 -c <consolidation>
22 22 Specifies the consolidation being installed via onu, used to locate
23 23 the publisher from which that consolidation is currently installed.
24 24 This is almost always "osnet".
25 25
26 26 -d <dir>
27 27 Specifies that <dir> contains the repo.redist sub-directory; onu
28 28 will run a depot using this packaging repository. Note that -d
29 29 ignores -u and -U as well as the environment variables used by
30 30 those options.
31 31
32 32 -u <URI>
33 33 Specifies that <URI> should be used as the origin URI for the
34 34 publisher packaging repository. See ONURI below for default
35 35 values.
36 36
37 37 -U <publisher>
38 38 Specifies that <publisher> should be used as the publisher name for
39 39 the packaging repository. See ONPUB below for default values.
40 40
41 41 -v Verbose mode.
42 42
43 43 The first form of onu creates a new BE and then updates it, and takes
44 44 the following options:
45 45
46 46 -s <beName>
47 47 Specifies that <beName> should be used as the source Boot
48 48 Environment to clone. The default is the active BE.
49 49
50 50 -t <beName>
51 51 Specifies the target BE name. This argument is required; there is
52 52 no default value.
53 53
54 54 -Z Do not update any installed zones.
55 55
56 56 The second form of onu takes the following option:
57 57
58 58 -r In the current BE configure the requested publisher appropriately,
59 59 without updating.
60 60
61 61 EXIT STATUS
62 62 The following exit values are returned:
63 63
64 64 0 The command completed successfully. No errors or warnings were
65 65 reported.
66 66
67 67 1 Incorrect usage.
68 68
69 69 2 One of the commands used by the script failed.
70 70
71 71 NOTES
72 72 Former users of bfu should note the following ways in which onu behaves
73 73 differently from bfu. First, as noted above, onu creates a new BE,
74 74 rather than updating an existing BE in-place. Second, onu will not
75 75 install packages that are older than what is already installed in the
76 76 source BE. Third, conflicts in system configuration files are
77 77 automatically resolved according to the files' "preserve" attribute, as
78 78 described in pkg(5).
79 79
80 80 If the -d option is given to specify a repository directory, the new
81 81 publishers will not be available in the new BE. This can prevent
82 82 correct zone installs or cause issues with installing additional
83 83 packages sourced from the ON repositories. In both cases, the -r option
84 84 can be used in the new BE to re-enable the publishers. See EXAMPLES.
85 85
86 86 Use of onu will prevent use of zone attach for ipkg-brand zones in the
87 87 new BE, since the entire incorporation is removed.
88 88
89 89 By default, onu will attempt to update any ipkg-brand installed zones
90 90 on the system; the -Z option may be used to disable this behavior.
91 91
92 92 EXAMPLES
93 93 Example 1 Installing latest ON nightly build
94 94
95 95 # onu -t new-nightly-be
96 96
97 97 Example 2 Installing an ON build from a directory
98 98
99 99 # onu -d /path/to/my/ws/packages/`uname -p`/nightly -t new-nightly-be
100 100
101 101 Example 3 Installing additional packages in the new BE
102 102
103 103 # onu -d /path/to/my/ws/packages/`uname -p`/nightly -t new-nightly-be
104 104 # reboot
105 105 # onu -r -d /path/to/my/ws/packages/`uname -p`/nightly
106 106 # pkg install netcat
107 107 #
108 108
109 109 ENVIRONMENT
110 110 ONURI
111 111
112 112 If the -u option is not provided, and this variable is set, it
113 113 will be used as the origin URI for the publisher packaging
114 114 repository. If -u is not provided and this variable is not set,
115 115 http://ipkg.sfbay/on-nightly will be used.
116 116
117 117 ONPUB
118 118
|
↓ open down ↓ |
107 lines elided |
↑ open up ↑ |
119 119 If the -U option is not provided, and this variable is set, it
120 120 will be used as the publisher name for the packaging repository.
121 121 If -U is not provided and this variable is not set, on-nightly
122 122 will be used.
123 123
124 124 SEE ALSO
125 125 beadm(1M), pkg(1), pkg(5)
126 126
127 127
128 128
129 - 28 August 2010 onu(1)
129 + 28 August 2010 onu(1ONBLD)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX