.de FN \fI\|\\$1\|\fP .. .TH UP2DATE 8 "Wed 29 November 2000" "Linux" "Red Hat Linux System Manual" .UC 4 .SH NAME Update Agent \- a program for updating packages on Red Hat Linux .SH SYNOPSIS .B up2date [\fIOPTION\fR]... [\fIPACKAGE NAME\fR]... .br .B up2date-nox [\fIOPTION\fR]... [\fIPACKAGE NAME\fR]... .SH DESCRIPTION .PP \fBUpdate Agent\fR provides a complete system for updating the RPM packages installed on a Red Hat Linux system. Both command line and graphical interfaces are included. .PP 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 .FN /etc/sysconfig/rhn/systemid , and it's configuration in .FN /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 \fBup2date-config\fR, or you can edit the configuration file .FN /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 \fB--configure\fR option. If you supply package names on the command line, those particular packages will be updated or installed if there are new versions 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. .TP \fB--configure\fR 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. .TP .TP \fB--register\fR Register a system with Red Hat Network. This is mainly useful for reregistering a system, as up2date will automatically invoke this mode if the current system isnt registered. .TP \fB-d\fR, \fB--download\fR 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 \fB--install\fR option. .TP \fB--nodownload\fR Do not download packages at all. This is for testing purposes. .TP \fB-f\fR, \fB--force\fR Force package installation. This option is provided so that you can override the file, package and configuration skip lists. .TP \fB-i\fR, \fB--install\fR 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 exlusive with the the \fB--download\fR option. .TP \fB-l\fR, \fB--list\fR Output a list of packages which have been updated and available for retrieval/installation. .TP \fB--dry-run\fR Output a list of packages available for updates, and all the deps they need, including obsoletes. .TP \fB--showall\fR Show a list of all packages available from the channels the system is currently subscribed to, including those not currently installed. .TP \fB-k\fR, \fB--packagedir\fR Specify a colon seperated path of directories to look for packages before attempting to download them. .TP \fB--nosig\fR Do not use GPG to check package signatures (overrides configuration option). .TP \fB--src\fR Download source rpms as well as binary rpms. .TP \fB--nosrc\fR Do not download source package (overrides configuration option). .TP \fB-p\fR, \fB--packages\fR 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. .TP \fB--hardware\fR up2date hardware profile associated with this System Profile on Red Hat Network. .TP \fB--proxy\fR Specify an http proxy to use .TP \fB--proxyUser\fR Specify a username to use with an authenticated http proxy .TP \fB--proxyPassword\fR Specify a password to use with an authenticated http proxy .TP \fB--show-package-dialog\fR Show the package installation dialog in gui mode .TP \fB--get\fR Fetch the package specified without resolving dependencies .TP \fB--get-source\fR Fetch the source package for the specified package without resolving dependencies .TP \fB--upgrade-to-release\fR Upgrade to the channel specified .TP \fB--whatprovides=\fR Queries the RHN servers to resolve the comma seperated list of dependencies. It will return a list of packages that will satisfy these deps. .TP \fB--solvedeps=\fR Queries the RHN servers to resolve the comma seperated list of dependencies. Essentially the same as \fB--whatprovides\fR except it will also download and install the packages that are needed to resolve the dependencies. .TP \fB--show-channels\fR Show the channels associated with a package where approriate. If used alone, it shows the currently subscribed channels. If used with \fB--showall\fR or \fB--whatprovides\fR it will show channels as well as package names. .TP .TP \fB--installall\fR Used in combo with \fB--channel\fR to install all the packages from a given channel. .TP \fB--show-orphans\fR List all packages currently installed that are not present in channels the server is subscribed to. .TP \fB--show-available\fR List all packages available in the channels the server is subscribed to, but are not currently installed. .TP \fB--channel\fR Specify a specific channel. Used in combo with \FB--installall\fR. .TP \fB--list-rollbacks\fR Shows all currently available rpm rollbacks. .TP \fB--tmpdir=\fR allows you to override the configured package/temporary 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. .TP \fB--serverURL=\fR Specify what server url to use. .TP \fB--gpg-flags\fR Shows the flags that gpg will be invoked with (the keyring, the home directory, etc). Intentend for useage in scripts that want to invoke gpg the same way up2date does. .TP \fB-u\fR, \fB--update\fR Completely update the system. All relevant packages will be downloaded (and possibly installed, if you have configured Update Agent to do so). .TP \fB--nox\fR do not even attempt to display the gui. .TP .TP \fB-h\fR, \fB--help\fR display help on command line arguments and exit. .TP \fB-v\fR, \fB--verbose\fR print more information about what Update Agent is doing. .TP \fB--justdb\fR only add packages to the database,do not install them to the filesystem. .PD \fB--dbpath\fR Specify a path where an alternat rpm database to use is found. .TP \fB--version\fR output version information and exit. .PD .SH "RETURN CODES" \fBUpdate Agent\fR returns 0 on success, 1 on error. .PD .SH FILES .PD 0 .TP .TP .FN /etc/sysconfig/rhn/up2date Configuration settings for Update Agent. .TP .FN /etc/sysconfig/rhn/sources Configure settings for external package repositories .TP .FN /etc/sysconfig/rhn/systemid Unique system identification certificate for Red Hat Network. .TP .FN /etc/sysconfig/rhn/up2date-keyring.gpg The default keyring used specificaly for up2date, if used with versions of rpm that support it (rpm-4.0.4 or higher) .TP .FN /var/spool/up2date The spool directory where rpm stores package lists, package headers and packages. .TP .FN /var/spool/repackage The spool directory where rpm/up2date stores rollback rpms. .TP .FN /var/log/up2date This is the log file for up2date. .TP .FN /usr/share/rhn/RHNS-CA-CERT The ssl certificate authority file used by up2date to validate the Red Hat Network ssl servers. .TP .FN /usr/share/rhn/RPM-GPG-KEY A copy of the Red Hat, Inc rpm package signing key. This is the gpg key that can be used to verify a package is signed by Red Hat, Inc. .PD .SH "EXAMPLES" The following example starts up the interactive gui client. .RS .nf up2date .fi .RE The following example shows up2date being used in non-interactive batch mode. .RS .nf up2date -u .fi .RE This example shows up2date being used to discover which packages solve a set of deps manually on a Red Hat Linux 7.0 machine. .RS .nf up2date --whatprovides "/bin/bash,gimp,libhistory.so.4.1" bash-2.04-11 readline-4.1-5 gimp-1.1.25-1 .fi .RE This example shows how to start up the text based config tool. .RS .nf up2date --nox --configure .fi .RE This example shows how to use up2date to install a package with many deps that isnt currently installed. .RS .nf up2date kdebase .fi .RE This example shows how to install all the packages from the channel foobar-1.0-i386 .RS .nf up2date --installall --channel foobar-1.0-i386 .fi .RE This example shows how to list all the currently installed packages that are not part of channels the system is currently subscribed to. .RS .nf up2date --show-orphans .fi .RE .SH "SEE ALSO" Configuration is performed through \fBup2date-config\fR. The Update Agent is tightly coupled with \fBRed Hat Network\fR. Visit for access or to sign up. .SH AUTHORS .nf Written by Preston Brown , Cristian Gafton , and Adrian Likins .fi .SH "REPORTING BUGS" Report bugs to . .SH COPYRIGHT Copyright \(co 1999-2002 Red Hat, Inc. .br This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.