If you are not running the X Window System or prefer the command line version of the Red Hat Update Agent, skip to Section 2.3, “Command Line Version”.
You must be root to run the Red Hat Update Agent. If started as a standard user, Red Hat Update Agent prompts you to enter the root password before proceeding. The Red Hat Update Agent can be started using one of the following methods:
For Red Hat Enterprise Linux 3 and 4:
-
On the GNOME and KDE desktops, go to Applications (the main menu on the panel) => System Tools => Red Hat Network.
-
At a shell prompt (for example, an xterm or gnome-terminal), type the command
up2date.
For Red Hat Enterprise Linux 2.1:
-
On the GNOME desktop, go to the Main Menu Button (on the Panel) => Programs => System => Update Agent.
-
On the KDE desktop, go to the Main Menu Button (on the Panel) => Update Agent.
-
At a shell prompt (for example, an xterm or gnome-terminal), type the command
up2date.
If you choose the last option and start the application from a shell prompt, you can specify the options in Table 2.1, “Graphical Update Agent Options”. To view these options, type the command up2date --help.
For example, use the following command to specify the directory in which to download the updated packages (temporarily overriding your saved configuration):
up2date --tmpdir=/tmp/up2date/
| Option | Description |
|---|---|
--configure
|
Configure Red Hat Update Agent options. Refer to Section 2.4, “Configuration” for detailed instructions. |
-d, --download
|
Download packages only; do not install them. This argument temporarily overrides the configuration option Do not install packages after retrieval. Use this option if you prefer to install the packages manually. |
-f, --force
|
Force package installation. This option temporarily overrides the file, package, and configuration skip lists. |
-i, --install
|
Install packages after they are downloaded. This argument temporarily overrides the configuration option Do not install packages after retrieval. |
-k, --packagedir
|
Specify a colon separated path of directories in which to look for packages before trying to download them. |
--nosig
|
Do not use GPG to check package signatures. This option temporarily overrides the saved configuration option. |
--tmpdir=
|
Temporarily override the configured package directory. The default location is /var/spool/up2date. This option is useful if you do not have enough space in the configured location.
|
--dbpath=
|
Specify an alternate RPM database to use temporarily. |
Table 2.1. Graphical Update Agent Options
The first time you run the Red Hat Update Agent, two dialog boxes appear that you will not see in subsequent startups: Configure Proxy Server and Install GPG Key.
As shown in Figure 2.1, “Configure Proxy Server”, the first dialog box to appear prompts you for HTTP Proxy Server information. This is useful if your network connection requires you to use a proxy server to make HTTP connections. To use this feature, select the Enable HTTP Proxy checkbox and type your proxy server in the text field with the format HOST:PORT, such as squid.mysite.org:3128. Additionally, if your proxy server requires a username and password, select the Use Authentication checkbox and enter your username and password in the respective text fields.
An HTTP Proxy Server is not required by Red Hat Network. If you do not want to use this feature, click the OK button without making any selections. Note that the Red Hat Network Server dropdown menu at the top of the dialog box is only useful to RHN Proxy and Satellite customers. These customers should refer to the RHN Client Configuration Guide for registration steps. Also note that this dialog box is actually the General tab of the Red Hat Update Agent Configuration Tool. Refer to Section 2.4, “Configuration” for detailed instructions.
The second dialog box to appear prompts you to install the Red Hat GPG key, as shown in Figure 2.2, “Install GPG Key”. This key is used to verify the packages you download for security purposes. Click Yes to install the key, and you will not see this message again.
