update-ux(1M)                                                 update-ux(1M)




 NAME    [Toc]    [Back]
      update-ux - updates the HP-UX operating system from new HP-UX media

 SYNOPSIS    [Toc]    [Back]
      update-ux -s source_location [-?] [-n|-y] [-i]
           [-x option=value] [sw_spec]

 DESCRIPTION    [Toc]    [Back]
      The update-ux command updates the HP-UX operating system to a newer
      version.

      Use update-ux when updating the operating system (OS), and installing
      or changing operating environments (OEs).  update-ux works only with
      source depots containing the OS and OEs such as HP-UX 11i OE DVDs.
      When using other media as source, use swinstall(1M) instead.

      update-ux will always attempt to update the OS.  These bundles are
      installed by default from HP-UX 11i OE DVDs:

         HPUXBaseOS
         HPUXBaseAux
         FibrChanl-00
         GigEther-00
         FDDI-00
         OnlineDiag
         CDE language bundle based on installed CDE.
         Other bundles based on the OE version.
         Other network drivers based on installed software.

      To list all product bundles available on the DVD mounted at /dvd,
      enter:

           /usr/sbin/swlist -s /dvd

      If you are changing OEs within the same OS version, update-ux will
      attempt to update the OS.  However, only software that has not yet
      been installed will be installed.  Software already on the target
      system will be deselected during the analysis phase.

      If the current OS is 11.22, first install update-ux onto the existing
      system. For example:

           swinstall -s source_location Update-UX

      where source_location is the full path to a depot containing the 11i
      Update-UX product.

    Options    [Toc]    [Back]
      update-ux supports these options:





 Hewlett-Packard Company            - 1 -              HP-UX 11i Version 2.0






 update-ux(1M)                                                 update-ux(1M)




           -s source_location  Specify the source location.  Possible
                               locations are a local directory, a mounted
                               DVD containing an SD depot, or a remote
                               machine and depot combination.  All paths
                               used in the source_location must be absolute
                               paths.  If source_location is a DVD, update-
                               ux expects to install from one DVD. If
                               source_location is a remote machine and depot
                               combination, the remote machine should be
                               specified first, followed by the absolute
                               path to the remote depot, separated by a
                               colon with no spaces; for example:
                               swperf:/var/spool/sw

           -?                  Print the usage statement.

           -n|-y               By default, update-ux pauses when an error is
                               detected to ask if it should continue.
                               Specify "no" (-n) or "yes" (-y) to tell
                               update-ux whether to continue when a error
                               message is issued.  Use -n (or omit this
                               option) at first to have update-ux abort when
                               an error is encountered.  Then review the
                               error logged in /var/adm/sw/swagent.log.
                               When you have reviewed/resolved the errors,
                               use -y to have update-ux ignore any remaining
                               errors.

           -i                  Start the swinstall interactive interface.
                               For more information, see the swinstall(1M)
                               manpage.

           -x option=value     Set swinstall(1M) options.  swinstall -p
                               (preview) is not supported.  For more
                               information, see the swinstall(1M) manpage.

           sw_spec             Specify optional software selection such as
                               an OE or network-driver bundle name.

 RETURN VALUES    [Toc]    [Back]
      The update-ux command returns a value when it is not successful:

           1    Error during execution; update aborted.
           2    Update aborted per user request (-n option) or from
                keyboard.

 DIAGNOSTICS    [Toc]    [Back]
    Standard Output:
      An update-ux session writes messages for significant events,
      including:




 Hewlett-Packard Company            - 2 -              HP-UX 11i Version 2.0






 update-ux(1M)                                                 update-ux(1M)




           +  Begin- and end-session messages.
           +  Major task messages.

    Logging:
      Errors are recorded in: /var/adm/sw/swagent.log.

 EXAMPLES    [Toc]    [Back]
      To update from the OS depot on an HP-UX 11i OE DVD mounted at /dvd,
      enter:

           /usr/sbin/update-ux -s /dvd HPUX11i-OE

      That example updates the OS and installs the HP-UX 11i Operating
      Environment (OE).

      To update the OS from /dvd, but not install an OE and ignore any error
      messages, enter:

           /usr/sbin/update-ux -s /dvd -y

      To update the OS and also update any software on the target system
      with new versions found in the source depot at /dvd, enter:

           /usr/sbin/update-ux -s /dvd -x match_target=true

 AUTHOR    [Toc]    [Back]
      update-ux was developed by HP.

 FILES    [Toc]    [Back]
      /usr/sbin/update-ux                The update-ux command.

      /var/adm/sw/swagent.log            The log file.

 SEE ALSO    [Toc]    [Back]
      sd(4), sd(5), swinstall(1M).

      These manuals are available on the HP-UX 11i Instant Information CD
      and at http://docs.hp.com/:

      +  HP-UX 11i Installation and Update Guide
      +  Software Distributor Administration Guide
      +  Managing Systems and Workgroups
      +  Managing Superdome Complexes


 Hewlett-Packard Company            - 3 -              HP-UX 11i Version 2.0