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