2 .\" "
   3 .\" " The contents of this file are subject to the terms of the
   4 .\" " Common Development and Distribution License (the "License").
   5 .\" " You may not use this file except in compliance with the License.
   6 .\" "
   7 .\" " You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   8 .\" " or http://www.opensolaris.org/os/licensing.
   9 .\" " See the License for the specific language governing permissions
  10 .\" " and limitations under the License.
  11 .\" "
  12 .\" " When distributing Covered Code, include this CDDL HEADER in each
  13 .\" " file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  14 .\" " If applicable, add the following below this CDDL HEADER, with the
  15 .\" " fields enclosed by brackets "[]" replaced with your own identifying
  16 .\" " information: Portions Copyright [yyyy] [name of copyright owner]
  17 .\" "
  18 .\" " CDDL HEADER END
  19 .\" "
  20 .\" "Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
  21 .\" "Copyright 2010, Richard Lowe

  22 .\" "
  23 .TH ONU 1ONBLD "Aug 28, 2010"
  24 .SH NAME
  25 .I onu
  26 \- OS/Net Update
  27 .SH SYNOPSIS
  28 \fBonu [opts] [-s <beName>] -t <beName>\fP
  29 .br
  30 \fBonu [opts] -r\fP
  31 .SH DESCRIPTION
  32 .LP
  33 .I onu
  34 is a replacement for
  35 .I bfu
  36 used to update a system with the latest set of IPS packages for the ON
  37 (OS/Net) consolidation of Solaris, using beadm(1M) to create a new Boot
  38 Environment (BE) and pkg(1) to update the image.
  39 .SH OPTIONS
  40 .LP
  41 The following global options are supported:
  42 .TP 4
  43 .B \-c <consolidation>

  81 The second form of onu takes the following option:
  82 .TP 4
  83 .B \-r
  84 In the current BE configure the requested publisher appropriately, without
  85 updating.
  86 .SH EXIT STATUS
  87 .LP
  88 The following exit values are returned:
  89 .TP 4
  90 .B 0
  91 The command completed successfully.
  92 No errors or warnings were reported.
  93 .TP 4
  94 .B 1
  95 Incorrect usage.
  96 .TP 4
  97 .B 2
  98 One of the commands used by the script failed.
  99 .SH NOTES
 100 .LP






 101 Former users of bfu should note the following ways in which onu behaves
 102 differently from bfu.  First, as noted above, onu creates a new BE, rather
 103 than updating an existing BE in-place.  Second, onu will not install packages
 104 that are older than what is already installed in the source BE.  Third,
 105 conflicts in system configuration files are automatically resolved according
 106 to the files' "preserve" attribute, as described in pkg(5).
 107 .LP
 108 If the
 109 .B -d
 110 option is given to specify a repository directory, the new
 111 publishers will not be available in the new BE. This can prevent correct
 112 zone installs or cause issues with installing additional packages
 113 sourced from the ON repositories. In both cases, the \fB-r\fR option
 114 can be used in the new BE to re-enable the publishers. See
 115 \fBEXAMPLES\fR.
 116 .LP
 117 Use of
 118 .I onu
 119 will prevent use of zone attach for ipkg-brand zones in the new BE,
 120 since the

   2 .\" "
   3 .\" " The contents of this file are subject to the terms of the
   4 .\" " Common Development and Distribution License (the "License").
   5 .\" " You may not use this file except in compliance with the License.
   6 .\" "
   7 .\" " You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   8 .\" " or http://www.opensolaris.org/os/licensing.
   9 .\" " See the License for the specific language governing permissions
  10 .\" " and limitations under the License.
  11 .\" "
  12 .\" " When distributing Covered Code, include this CDDL HEADER in each
  13 .\" " file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  14 .\" " If applicable, add the following below this CDDL HEADER, with the
  15 .\" " fields enclosed by brackets "[]" replaced with your own identifying
  16 .\" " information: Portions Copyright [yyyy] [name of copyright owner]
  17 .\" "
  18 .\" " CDDL HEADER END
  19 .\" "
  20 .\" "Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
  21 .\" "Copyright 2010, Richard Lowe
  22 .\" "Copyright (c) 2016, Chris Fraire <cfraire@me.com>.
  23 .\" "
  24 .TH ONU 1ONBLD "Nov 7, 2016"
  25 .SH NAME
  26 .I onu
  27 \- OS/Net Update
  28 .SH SYNOPSIS
  29 \fBonu [opts] [-s <beName>] -t <beName>\fP
  30 .br
  31 \fBonu [opts] -r\fP
  32 .SH DESCRIPTION
  33 .LP
  34 .I onu
  35 is a replacement for
  36 .I bfu
  37 used to update a system with the latest set of IPS packages for the ON
  38 (OS/Net) consolidation of Solaris, using beadm(1M) to create a new Boot
  39 Environment (BE) and pkg(1) to update the image.
  40 .SH OPTIONS
  41 .LP
  42 The following global options are supported:
  43 .TP 4
  44 .B \-c <consolidation>

  82 The second form of onu takes the following option:
  83 .TP 4
  84 .B \-r
  85 In the current BE configure the requested publisher appropriately, without
  86 updating.
  87 .SH EXIT STATUS
  88 .LP
  89 The following exit values are returned:
  90 .TP 4
  91 .B 0
  92 The command completed successfully.
  93 No errors or warnings were reported.
  94 .TP 4
  95 .B 1
  96 Incorrect usage.
  97 .TP 4
  98 .B 2
  99 One of the commands used by the script failed.
 100 .SH NOTES
 101 .LP
 102 Distributions which segment certain system directories onto separate, child
 103 datasets (e.g., /var for openindiana Text Install) must run
 104 .B beadm unmount <new beName>
 105 after running onu or else the child dataset will not mount at the correct
 106 location after reboot.
 107 .LP
 108 Former users of bfu should note the following ways in which onu behaves
 109 differently from bfu.  First, as noted above, onu creates a new BE, rather
 110 than updating an existing BE in-place.  Second, onu will not install packages
 111 that are older than what is already installed in the source BE.  Third,
 112 conflicts in system configuration files are automatically resolved according
 113 to the files' "preserve" attribute, as described in pkg(5).
 114 .LP
 115 If the
 116 .B -d
 117 option is given to specify a repository directory, the new
 118 publishers will not be available in the new BE. This can prevent correct
 119 zone installs or cause issues with installing additional packages
 120 sourced from the ON repositories. In both cases, the \fB-r\fR option
 121 can be used in the new BE to re-enable the publishers. See
 122 \fBEXAMPLES\fR.
 123 .LP
 124 Use of
 125 .I onu
 126 will prevent use of zone attach for ipkg-brand zones in the new BE,
 127 since the