up2date

 


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



NAME
       Update  Agent - a program for updating packages on Red Hat
       Linux

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

DESCRIPTION
       Update Agent provides a complete system for  updating  the
       RPM  packages  installed  on a Red Hat 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 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  it's configuration in
       /etc/sysconfig/rhn/up2date

       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/sysconfig/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 packages will be updated if there are new  ver­
       sions  available.  Only the package name is needed, do not
       supply any version or release information.

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


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

       -d, --download
              download  packages only, do not install them.  This
              option is provided so that  you  can  override  the
              configuration option "Do not install packages after
              retrieval."  It  is  mutually  exclusive  with  the
              --install option.

       -f, --force
              force  package  installation.   This option is pro­
              vided 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."

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

       --showall
              Show  a  list  of  all  packages available for your
              release of Red Hat Linux, including those not  cur­
              rently installed.

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

       --nosig
              Do  not  use GPG to check package signatures (over­
              rides configuration option).

       -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.

       --whatprovides=<deps>
              Queries the RHN servers to resolve the comma seper­
              ated  list  of dependiencies. It will return a list
              of packages will satisfy those  deps.  It  make  be
              necessary

       --solvedeps=<deps>
              Queries the RHN servers to resolve the comma seper­
              ated list of dependiencies. Essentially the same as
              --whatprovides  except  it  will  also download the
              packages that are needed to resolve the  dependien­
              cies.

       --tmpdir=<directory>
              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.

       -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 exit.

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

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

       --version
              output version information and exit.

RETURN CODES
       Update Agent returns 0 on success, 1 on error.

FILES
       /etc/sysconfig/rhn/up2date
              Configuration settings for Update Agent.
       /etc/sysconfig/rhn/systemid
              Unique system identification certificate for
              Red Hat Network.

EXAMPLES
       The following example starts up the interactive gui
       client.

              up2date

       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 deps  manually  on  a
       Red Hat Linux 7.0 machine.

              up2date --whatprovides "/bin/bash,gimp,libhistory.so.4.1"
              bash-2.04-11
              readline-4.1-5
              gimp-1.1.25-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   deps  that  isnt  currently
       installed.

              up2date kdebase


SEE ALSO
       Configuration is performed through  up2date-config.
       The  Update  Agent  is tightly coupled with Red Hat
       Network.  Visit <http://www.redhat.com/network> for
       access  or to sign up.  You can also run rhn_regis­
       ter to register a system with Red Hat Network.

AUTHORS
       Written by Preston Brown <pbrown@redhat.com> and
       Cristian Gafton <gafton@redhat.com>

REPORTING BUGS
       Report bugs to <http://bugzilla.redhat.com>.

COPYRIGHT
       Copyright © 1999-2001 Red Hat, Inc.
       This is free software; see the source  for  copying
       conditions.   There  is  NO  warranty; not even for
       MERCHANTABILITY or FITNESS FOR  A  PARTICULAR  PUR­
       POSE.



Linux                  Wed 29 November 2000            UP2DATE(8)