Print this page
7388 Support DHCP Client FQDN. Allow IAID/DUID for all v4.
| Split |
Close |
| Expand all |
| Collapse all |
--- old/usr/src/tools/scripts/onu.1onbld.man.txt
+++ new/usr/src/tools/scripts/onu.1onbld.man.txt
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
|
↓ open down ↓ |
61 lines elided |
↑ open up ↑ |
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 + Distributions which segment certain system directories onto separate,
73 + child datasets (e.g., /var for openindiana Text Install) must run beadm
74 + unmount <new beName> after running onu or else the child dataset will
75 + not mount at the correct location after reboot.
76 +
72 77 Former users of bfu should note the following ways in which onu behaves
73 78 differently from bfu. First, as noted above, onu creates a new BE,
74 79 rather than updating an existing BE in-place. Second, onu will not
75 80 install packages that are older than what is already installed in the
76 81 source BE. Third, conflicts in system configuration files are
77 82 automatically resolved according to the files' "preserve" attribute, as
78 83 described in pkg(5).
79 84
80 85 If the -d option is given to specify a repository directory, the new
81 86 publishers will not be available in the new BE. This can prevent
82 87 correct zone installs or cause issues with installing additional
83 88 packages sourced from the ON repositories. In both cases, the -r option
84 89 can be used in the new BE to re-enable the publishers. See EXAMPLES.
85 90
86 91 Use of onu will prevent use of zone attach for ipkg-brand zones in the
87 92 new BE, since the entire incorporation is removed.
88 93
89 94 By default, onu will attempt to update any ipkg-brand installed zones
90 95 on the system; the -Z option may be used to disable this behavior.
91 96
92 97 EXAMPLES
93 98 Example 1 Installing latest ON nightly build
94 99
95 100 # onu -t new-nightly-be
96 101
97 102 Example 2 Installing an ON build from a directory
98 103
99 104 # onu -d /path/to/my/ws/packages/`uname -p`/nightly -t new-nightly-be
100 105
101 106 Example 3 Installing additional packages in the new BE
102 107
103 108 # onu -d /path/to/my/ws/packages/`uname -p`/nightly -t new-nightly-be
104 109 # reboot
105 110 # onu -r -d /path/to/my/ws/packages/`uname -p`/nightly
106 111 # pkg install netcat
107 112 #
108 113
109 114 ENVIRONMENT
110 115 ONURI
111 116
112 117 If the -u option is not provided, and this variable is set, it
113 118 will be used as the origin URI for the publisher packaging
114 119 repository. If -u is not provided and this variable is not set,
115 120 http://ipkg.sfbay/on-nightly will be used.
116 121
117 122 ONPUB
118 123
|
↓ open down ↓ |
37 lines elided |
↑ open up ↑ |
119 124 If the -U option is not provided, and this variable is set, it
120 125 will be used as the publisher name for the packaging repository.
121 126 If -U is not provided and this variable is not set, on-nightly
122 127 will be used.
123 128
124 129 SEE ALSO
125 130 beadm(1M), pkg(1), pkg(5)
126 131
127 132
128 133
129 - August 28, 2010 ONU(1ONBLD)
134 + November 7, 2016 ONU(1ONBLD)
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX