UP2DATE(8)                Red Hat Linux System Manual               UP2DATE(8)


       Update  Agent  -  a program for updating packages on Red Hat Enterprise


       up2date [OPTION]... [PACKAGE NAME]...
       up2date-nox [OPTION]... [PACKAGE NAME]...


       Update Agent provides a complete system for updating the  RPM  packages
       installed  on a Red Hat Enterprise Linux system.  Both command line and
       graphical interfaces are included.

       When you run Update Agent, you will be prompted for the computer’s root
       password.   This is because the Update Agent needs read/write access to
       the RPM database, and it needs to be able to install packages  when  so
       requested. It also needs read/write access to the up2date systemid file
       in /etc/sysconfig/rhn/systemid , and its configuration in  /etc/syscon-

       Update Agent has a quite a few configuration options, including but not
       limited to: installing packages after they are downloaded;  downloading
       source  RPMs along with binary RPMs; whether or not to upgrade packages
       where the default configuration file(s) have been modified,  and  more.
       You  can change these settings through a graphical interface by running
       up2date-config, or  you can edit the  configuration  file  /etc/syscon-
       fig/rhn/up2date  directly.   A  number  of  the  command line arguments
       described below can also be used at runtime to  override  configuration
       options.  There is also a text mode based configuration if invoked with
       with the --configure option.

       If you supply package names on the command line, those particular pack-
       ages  will be updated or installed if there are new versions available.
       Only the package name is needed, do not supply any version  or  release

       If  the  package  is not currently installed, it will be downloaded and
       installed, along with any dependencies that package requires.

              Configure Update Agent options.  This will allow you  to  adjust
              things such as which files/packages to skip by default, where to
              store retrieved packages, and more.

              Register a system with Red Hat Network.  This  is  mainly
              useful for re-registering a system, as up2date will auto-
              matically invoke this mode if the  current  system  isn’t

       -d, --download
              Download packages only, do not install them.  This option
              is equivalent to the configuration option "Do not install
              packages after retrieval."  It is mutually exclusive with
              the --install option.

              Do not download packages at all. This is for testing pur-

       -f, --force
              Force  package  installation.  This option is provided so
              that you can override the file, package and configuration
              skip lists.

       -i, --install
              Install  packages after they are downloaded.  This option
              is provided so that you can  override  the  configuration
              option  "Do not install packages after retrieval.". It is
              mutually exclusive with the the --download option.

       -l, --list
              Output a list of packages which  have  been  updated  and
              available for retrieval/installation.

              Output  a list of packages available for updates, and all
              the dependencies they need, including obsoletes.

              Show a list of all packages available from  the  channels
              the  system  is  currently subscribed to, including those
              not currently installed.

       -k, --packagedir
              Specify a colon separated path of directories to look for
              packages before attempting to download them.

              Do  not  use  GPG  to check package signatures (overrides
              configuration option).

       --src  Download source RPMs as well as binary RPMs.

              Do not download source package  (overrides  configuration

       -p, --packages
              Update  the  packages associated with this System Profile
              on Red  Hat  Network.   Useful  if  you  have  installed,
              updated,  or  removed  packages without Update Agent, and
              your package list has  become  unsynchronized  with  your
              remote Profile.

              up2date hardware profile associated with this System Pro-
              file on Red Hat Network.

              Specify an HTTP proxy to use

              Specify a username to  use  with  an  authenticated  HTTP

              Specify  a  password  to  use  with an authenticated HTTP

              Show the package installation dialog in GUI mode

       --get  Fetch the package specified without  resolving  dependen-

              Fetch  the source package for the specified package with-
              out resolving dependencies

              Upgrade to the channel specified

              Queries the RHN servers to resolve  the  comma  separated
              list  of  dependencies. It will return a list of packages
              that will satisfy these dependencies.

              Queries the RHN servers to resolve  the  comma  separated
              list  of dependencies. Essentially the same as --whatpro-
              vides except it will also download and install the  pack-
              ages that are needed to resolve the dependencies.

              Show  the channels associated with a package where appro-
              priate. If used alone, it shows the currently  subscribed
              channels.  If  used  with  --showall or --whatprovides it
              will show channels as well as package names.

              Used in combo with --channel to  install  all  the
              packages from a given channel.

              List all packages currently installed that are not
              present in channels the server is subscribed to.

              List all packages available in  the  channels  the
              server  is  subscribed  to,  but are not currently

              Specify a specific channel.  Used  in  combo  with

              Shows all currently available RPM rollbacks.

              allows you to override the configured package/tem-
              porary file storage directory.  This can be useful
              if you are about to download a lot of packages but
              you do not have enough space to store them in  the
              default location.

              Specify what server URL to use.

              Shows the flags that GPG will be invoked with (the
              keyring, the home directory,  etc).  Intended  for
              usage  in scripts that want to invoke GPG the same
              way up2date does.

       -u, --update
              Completely update the system.  All relevant  pack-
              ages  will  be downloaded (and possibly installed,
              if you have configured Update Agent to do so).

       --nox  do not even attempt to display the GUI.

       -h, --help
              display help on command line arguments  and

       -v, --verbose
              print  more  information  about what Update
              Agent is doing.

              only add packages to  the  database,do  not
              install  them  to the filesystem.  --dbpath
              Specify a path  where  an  alternative  RPM
              database to use is found.

              output version information and exit.


       Update Agent returns 0 on success, 1 on error.


              Configuration  settings  for  Update
              Configuration settings for  external
              package repositories
              Unique  system  identification  cer-
              tificate for Red Hat Network.
              The default  keyring  used  specifi-
              cally for up2date, if used with ver-
              sions  of  RPM   that   support   it
              (rpm-4.0.4 or higher)
              The     spool     directory    where
              RPM/up2date  stores  package  lists,
              package headers and packages.
              The     spool     directory    where
              RPM/up2date stores rollback RPMs.
              This is the log file for up2date.
              The default SSL certificate  author-
              ity   public   certificate  used  by
              up2date to validate the Red Hat Net-
              work SSL servers.
              A copy of the Red Hat, Inc RPM pack-
              age signing GPG public key. This  is
              the GPG key that can be used to ver-
              ify a package is signed by Red  Hat,


       The  following example starts up the inter-
       active GUI client.


       The following example shows  up2date  being
       used in non-interactive batch mode.

              up2date -u

       This  example  shows  up2date being used to
       discover which  packages  solve  a  set  of
       dependencies  manually  on  a Red Hat Linux
       7.0 machine.

              up2date --whatprovides "/bin/bash,gimp,libhistory.so.4.1"

       This example shows how to start up the text
       based config tool.

              up2date --nox --configure

       This  example  shows  how to use up2date to
       install a package  with  many  dependencies
       that aren’t currently installed.

              up2date kdebase

       This  example  shows how to install all the
       packages from the channel foobar-1.0-i386

              up2date --installall --channel foobar-1.0-i386

       This example shows how to list all the cur-
       rently installed packages that are not part
       of channels the system  is  currently  sub-
       scribed to.

              up2date --show-orphans


       Configuration is performed through up2date-
       config.  The Update Agent is  tightly  cou-
       pled   with   Red   Hat   Network.    Visit
       <http://rhn.redhat.com> for  access  or  to
       sign up.


       Written by Preston Brown <pbrown@redhat.com>, Cristian Gafton <gafton@redhat.com>,
       and Adrian Likins <alikins@redhat.com>


       Report    bugs   to   <http://bugzilla.red-


       Copyright © 1999-2002 Red Hat, Inc.
       This is free software; see the  source  for
       copying  conditions.  There is NO warranty;
       not even for MERCHANTABILITY or FITNESS FOR

4th Berkeley Distribution    Wed 29 November 2000                   UP2DATE(8)

Man(1) output converted with man2html