up2date-nox
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/syscon-
fig/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/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
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 packages, and more.
--register
Register a system with Red Hat Network. This is mainly
useful for reregistering a system, as up2date will auto-
matically invoke this mode if the current system isnt
registered.
-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.
--nodownload
Do not download packages at all. This is for testing pur-
poses.
-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 exlusive with the the --download option.
-l, --list
Output a list of packages which have been updated and
available for retrieval/installation.
--dry-run
Output a list of packages available for updates, and all
the deps they need, including obsoletes.
--showall
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 seperated path of directories to look for
packages before attempting to download them.
--nosig
Do not use GPG to check package signatures (overrides
configuration option).
--src Download source rpms as well as binary rpms.
--nosrc
Do not download source package (overrides 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 seperated
list of dependencies. It will return a list of packages
that will satisfy these deps.
--solvedeps=<deps>
Queries the RHN servers to resolve the comma seperated
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-channels
Show the channels associated with a package where appror-
iate. If used alone, it shows the currently subscribed
channels. If used with --showall or --whatprovides it
will show channels as well as package names.
--installall
Used in combo with --channel to install all the
packages from a given channel.
--show-orphans
List all packages currently installed that are not
present in channels the server is subscribed to.
--show-available
List all packages available in the channels the
server is subscribed to, but are not currently
installed.
--channel
Specify a specific channel. Used in combo with
--installall.
--list-rollbacks
Shows all currently available rpm rollbacks.
--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.
--serverURL=<url>
Specify what server url to use.
--gpg-flags
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.
-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 cer-
tificate for Red Hat Network.
/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)
/var/spool/up2date
The spool directory where rpm stores
package lists, package headers and
packages.
/var/spool/repackage
The spool directory where
rpm/up2date stores rollback rpms.
/var/log/up2date
This is the log file for up2date.
/usr/share/rhn/RHNS-CA-CERT
The ssl certificate authority file
used by up2date to validate the Red
Hat Network ssl servers.
/usr/share/rhn/RPM-GPG-KEY
A copy of the Red Hat, Inc rpm pack-
age signing key. This is the gpg key
that can be used to verify a package
is signed by Red Hat, Inc.
EXAMPLES
The following example starts up the inter-
active 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
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
SEE ALSO
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.
AUTHORS
Written by Preston Brown <pbrown@redhat.com>, Cristian Gafton <gafton@redhat.com>,
and Adrian Likins <alikins@redhat.com>
REPORTING BUGS
Report bugs to <http://bugzilla.red-
hat.com>.
COPYRIGHT
Copyright (C) 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
A PARTICULAR PURPOSE.
4th Berkeley Distribution Wed 29 November 2000 UP2DATE(8)
