7388 Wdiff usr/src/tools/scripts/onu.1onbld

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
          +++ 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  .\" "

↓ open down ↓

11 lines elided

↑ open up ↑

  12   12  .\" " When distributing Covered Code, include this CDDL HEADER in each
  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 +.\" "Copyright (c) 2016, Chris Fraire <cfraire@me.com>.
  22   23  .\" "
  23      -.TH ONU 1ONBLD "Aug 28, 2010"
       24 +.TH ONU 1ONBLD "Nov 7, 2016"
  24   25  .SH NAME
  25   26  .I onu
  26   27  \- OS/Net Update
  27   28  .SH SYNOPSIS
  28   29  \fBonu [opts] [-s <beName>] -t <beName>\fP
  29   30  .br
  30   31  \fBonu [opts] -r\fP
  31   32  .SH DESCRIPTION
  32   33  .LP
  33   34  .I onu

  34   35  is a replacement for
  35   36  .I bfu
  36   37  used to update a system with the latest set of IPS packages for the ON
  37   38  (OS/Net) consolidation of Solaris, using beadm(1M) to create a new Boot
  38   39  Environment (BE) and pkg(1) to update the image.
  39   40  .SH OPTIONS
  40   41  .LP
  41   42  The following global options are supported:
  42   43  .TP 4
  43   44  .B \-c <consolidation>
  44   45  Specifies the consolidation being installed via
  45   46  .IR onu ,
  46   47  used to locate the publisher from which that consolidation is currently
  47   48  installed.  This is almost always "osnet".
  48   49  .TP 4
  49   50  .B \-d <dir>
  50   51  Specifies that <dir> contains the repo.redist sub-directory;
  51   52  .I onu
  52   53  will run a depot using this packaging repository.
  53   54  Note that -d ignores -u and -U as well
  54   55  as the environment variables used by those options.
  55   56  .TP 4
  56   57  .B \-u <URI>
  57   58  Specifies that <URI> should be used as the origin URI for the publisher
  58   59  packaging repository.  See \fBONURI\fP below for default values.
  59   60  .TP 4
  60   61  .B \-U <publisher>
  61   62  Specifies that <publisher> should be used as the publisher name for
  62   63  the packaging repository.  See \fBONPUB\fP below for default values.
  63   64  .TP 4
  64   65  .B \-v
  65   66  Verbose mode.
  66   67  .LP
  67   68  The first form of onu creates a new BE and then updates it, and takes
  68   69  the following options:
  69   70  .TP 4
  70   71  .B \-s <beName>
  71   72  Specifies that <beName> should be used as the source Boot Environment to
  72   73  clone.  The default is the active BE.
  73   74  .TP 4
  74   75  .B \-t <beName>
  75   76  Specifies the target BE name.  This argument is required; there
  76   77  is no default value.
  77   78  .TP 4
  78   79  .B \-Z
  79   80  Do not update any installed zones.
  80   81  .LP
  81   82  The second form of onu takes the following option:
  82   83  .TP 4
  83   84  .B \-r
  84   85  In the current BE configure the requested publisher appropriately, without
  85   86  updating.
  86   87  .SH EXIT STATUS
  87   88  .LP
  88   89  The following exit values are returned:
  89   90  .TP 4
  90   91  .B 0

↓ open down ↓

57 lines elided

↑ open up ↑

  91   92  The command completed successfully.
  92   93  No errors or warnings were reported.
  93   94  .TP 4
  94   95  .B 1
  95   96  Incorrect usage.
  96   97  .TP 4
  97   98  .B 2
  98   99  One of the commands used by the script failed.
  99  100  .SH NOTES
 100  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
 101  108  Former users of bfu should note the following ways in which onu behaves
 102  109  differently from bfu.  First, as noted above, onu creates a new BE, rather
 103  110  than updating an existing BE in-place.  Second, onu will not install packages
 104  111  that are older than what is already installed in the source BE.  Third,
 105  112  conflicts in system configuration files are automatically resolved according
 106  113  to the files' "preserve" attribute, as described in pkg(5).
 107  114  .LP
 108  115  If the
 109  116  .B -d
 110  117  option is given to specify a repository directory, the new

 111  118  publishers will not be available in the new BE. This can prevent correct
 112  119  zone installs or cause issues with installing additional packages
 113  120  sourced from the ON repositories. In both cases, the \fB-r\fR option
 114  121  can be used in the new BE to re-enable the publishers. See
 115  122  \fBEXAMPLES\fR.
 116  123  .LP
 117  124  Use of
 118  125  .I onu
 119  126  will prevent use of zone attach for ipkg-brand zones in the new BE,
 120  127  since the
 121  128  .B entire
 122  129  incorporation is removed.
 123  130  .LP
 124  131  By default,
 125  132  .I onu
 126  133  will attempt to update any ipkg-brand installed zones on the system; the
 127  134  .B -Z
 128  135  option may be used to disable this behavior.
 129  136  .SH EXAMPLES
 130  137  .LP
 131  138  \fBExample 1\fR Installing latest ON nightly build
 132  139  .LP
 133  140  # onu -t new-nightly-be
 134  141  .LP
 135  142  \fBExample 2\fR Installing an ON build from a directory
 136  143  .LP
 137  144  # onu -d /path/to/my/ws/packages/`uname -p`/nightly -t new-nightly-be
 138  145  .LP
 139  146  \fBExample 3\fR Installing additional packages in the new BE
 140  147  .LP
 141  148  # onu -d /path/to/my/ws/packages/`uname -p`/nightly -t new-nightly-be
 142  149  .br
 143  150  # reboot
 144  151  .br
 145  152  # onu -r -d /path/to/my/ws/packages/`uname -p`/nightly
 146  153  .br
 147  154  # pkg install netcat
 148  155  .br
 149  156  #
 150  157  .SH ENVIRONMENT
 151  158  .LP
 152  159  ONURI
 153  160  .IP
 154  161  If the -u option is not provided, and this variable is set, it will be used
 155  162  as the origin URI for the publisher packaging repository.  If -u is not
 156  163  provided and this variable is not set, http://ipkg.sfbay/on-nightly will
 157  164  be used.
 158  165  .LP
 159  166  ONPUB
 160  167  .IP
 161  168  If the -U option is not provided, and this variable is set, it will be
 162  169  used as the publisher name for the packaging repository.  If -U is not
 163  170  provided and this variable is not set, on-nightly will be used.
 164  171  .SH SEE ALSO
 165  172  .BR beadm "(1M), "
 166  173  .BR pkg "(1), "
 167  174  .BR pkg "(5) "

↓ open down ↓

57 lines elided

↑ open up ↑

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX