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        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 
  77        Former users of bfu should note the following ways in which onu behaves
  78        differently from bfu.  First, as noted above, onu creates a new BE,
  79        rather than updating an existing BE in-place.  Second, onu will not
  80        install packages that are older than what is already installed in the
  81        source BE.  Third, conflicts in system configuration files are
  82        automatically resolved according to the files' "preserve" attribute, as
  83        described in pkg(5).
  84 
  85        If the -d option is given to specify a repository directory, the new
  86        publishers will not be available in the new BE. This can prevent
  87        correct zone installs or cause issues with installing additional
  88        packages sourced from the ON repositories. In both cases, the -r option
  89        can be used in the new BE to re-enable the publishers. See EXAMPLES.
  90 
  91        Use of onu will prevent use of zone attach for ipkg-brand zones in the
  92        new BE, since the entire incorporation is removed.
  93 
  94        By default, onu will attempt to update any ipkg-brand installed zones
  95        on the system; the -Z option may be used to disable this behavior.
  96 
  97 EXAMPLES
  98        Example 1 Installing latest ON nightly build
  99 
 100        # onu -t new-nightly-be
 101 
 102        Example 2 Installing an ON build from a directory
 103 
 104        # onu -d /path/to/my/ws/packages/`uname -p`/nightly -t new-nightly-be
 105 
 106        Example 3 Installing additional packages in the new BE
 107 
 108        # onu -d /path/to/my/ws/packages/`uname -p`/nightly -t new-nightly-be
 109        # reboot
 110        # onu -r -d /path/to/my/ws/packages/`uname -p`/nightly
 111        # pkg install netcat
 112        #
 113 
 114 ENVIRONMENT
 115        ONURI
 116 
 117               If the -u option is not provided, and this variable is set, it
 118               will be used as the origin URI for the publisher packaging
 119               repository.  If -u is not provided and this variable is not set,
 120               http://ipkg.sfbay/on-nightly will be used.
 121 
 122        ONPUB
 123 
 124               If the -U option is not provided, and this variable is set, it
 125               will be used as the publisher name for the packaging repository.
 126               If -U is not provided and this variable is not set, on-nightly
 127               will be used.
 128 
 129 SEE ALSO
 130        beadm(1M),  pkg(1),  pkg(5)
 131 
 132 
 133 
 134                                November 7, 2016                    ONU(1ONBLD)