Red Hat NETWORK - USER REFERENCE GUIDE 2.1 User Reference Manual

Hide thumbs Also See for NETWORK - USER REFERENCE GUIDE 2.1:

Advertisement

Red Hat Network
User Reference Guide 2.1

Advertisement

Table of Contents
loading

Summary of Contents for Red Hat NETWORK - USER REFERENCE GUIDE 2.1

  • Page 1 Red Hat Network User Reference Guide 2.1...
  • Page 2 ISBN: N/A Red Hat, Inc. 2600 Meridian Parkway Durham, NC 27713 USA +1 919 547 0012 (Voice) +1 919 547 0024 (FAX) 888 733 4281 (Voice) P.O. Box 13588 Research Triangle Park, NC 27709 USA © 2001 Red Hat, Inc. RHNurg(EN)-2.1-Print-RHI (2001-05-14T16:00-0400) Copyright ©...
  • Page 3: Table Of Contents

    Contents Red Hat Network Introduction ................. . . v Document Conventions..
  • Page 4 Update Agent Finished............41 Command Line Version of Red Hat Update Agent ..
  • Page 5: Introduction

    All version of this manual are available at http://www.redhat.com/support/manuals/. Once you use Red Hat Network to update these applications, you can use the latest version of this manual.
  • Page 6 Introduction The /usr/share/doc directory contains documentation for various programs. Install the webalizer RPM if you want to use a Web server log file analysis program. application This style should indicate to you that the program named is an end-user application (as opposed to system software).
  • Page 7: Document Conventions

    Section 0.1:Document Conventions Click on the Back button to return to the Web page you last viewed. computer output When you see text in this style, it indicates text displayed by the computer on the command line. You’ll see responses to commands you typed in, error messages and interactive prompts for your input during scripts or programs shown this way.
  • Page 8: More To Come

    viii Introduction In this case, the style of the word daemon should indicate to you that a definition of the term is available in the glossary. Additionally, we use several different strategies to draw your attention to certain pieces of information. In order of how critical the information is to your system, these items will be marked as a note, a caution or a warning.
  • Page 9 Section 0.2:More to Come rhn-feedback@redhat.com...
  • Page 10 Introduction...
  • Page 11: Chapter 1 What Is Red Hat Network

    Network Registration Client for further information). You can use either of the two Red Hat Network user interfaces: • web interface available at http://www.redhat.com/network/ • The Red Hat Update Agent Both the Web interface and the Red Hat Update Agent allow you to view all Errata Alerts included in the Red Hat Errata list.
  • Page 12: Software Manager

    Download List — use the Software Manager Web interface to create a download list of packages from all the systems in your network and download all the packages at one time For information on purchasing Software Manager subscription, refer to http://www.redhat.com/net- work/purchase/.
  • Page 13: Security, Quality Assurance, And Red Hat Network

    Red Hat’s GNU Privacy Guard (GPG) signature to ensure authenticity. Red Hat Network incorporates the following security measures: Your System Profile available at http://www.redhat.com/network/ is only accessible with the correct user name and password. 2. A Digital Certificate stored on the client system in the file /etc/sysconfig/rhn/systemid after registration is used to authenticate the system during each transaction between the client and Red Hat Network.
  • Page 14 If the packages are not installed, they can be found on the Red Hat Linux 7 or higher CD-ROM 1 in the RedHat/RPMS directory or downloaded from the Red Hat FTP site available at ftp://ftp.redhat.com (or from a Red Hat FTP mirror available at http://www.redhat.com/mirrors.html). Always check the Red Hat errata page, available at http://www.redhat.com/errata/, for package updates.
  • Page 15: Chapter 2 Red Hat Network Registration Client

    Client before registering their systems. Do not attempt to use this option unless you are required to. To start the configuration tool, use the command: rhn_register --configure You will be presented with a list of options and their current values: noSSLServerURL http://www.rhns.redhat.com/XMLRPC enableProxy httpProxy serverURL https://www.rhns.redhat.com/XMLRPC debug Enter number of item to edit <return to exit, q to quit without saving>:...
  • Page 16: Starting The Red Hat Network Registration Client

    Chapter 2:Red Hat Network Registration Client 2.2 Starting the Red Hat Network Registration Client You must be root to register a system with RHN. If you start the Red Hat Network Registration Client as a standard user, you will be prompted to enter the root password before proceeding. To start the Red Hat Network Registration Client in Red Hat Linux 6.2 or higher, use one of the following methods: 1.
  • Page 17 Red Hat Network Registration process is used to create a System Profile. The System Profile is essential if you wish to receive update notifications about your system. If you have any questions about how your information is being used, please contact us at feed- back@redhat.com.
  • Page 18: Registering A User Account

    Chapter 2:Red Hat Network Registration Client Figure 2–3 Red Hat Privacy Statement 2.3 Registering a User Account Before you can create a System Profile, you must create a user account. The only required information in this section is a unique user name and password and a valid email address. In the screen shown in Figure 2–6, Create a Unique User Name and Password, you must choose a user name and password.
  • Page 19 Figure 2–4 Error: Username Already Exists Note If you are already a member of redhat.com, you can use the same user name and password. However, you will still need to continue with the registration process to create your System Profile.
  • Page 20 Chapter 2:Red Hat Network Registration Client Figure 2–5 Warning: This System Already Registered If you have already registered a machine and created a System Profile, you can add a new machine to your System Profile. Run the Red Hat Network Registration Client on the new machine you wish to add and enter your existing Red Hat Network user name and password.
  • Page 21: Registering A System Profile

    Section 2.4:Registering a System Profile Figure 2–6 Create a Unique User Name and Password You can also choose whether to receive email notifications about updates relevant to your system by selecting the box next titled I want to receive email notification for updates to my System Profiles When selected, the text area will no longer be shaded and you can enter the email Email address:...
  • Page 22 Chapter 2:Red Hat Network Registration Client • Hostname • IP address • CPU model • CPU speed • Amount of RAM • PCI devices • Disk sizes • Mount points The next step is choosing a profile name for your system as shown in Figure 2–7, System Profile - Hardware.
  • Page 23 Section 2.4:Registering a System Profile Figure 2–7 System Profile - Hardware 2.4.2 Software System Profile The software System Profile consists of a list of RPM packages for which you wish to receive notifi- cations. The Red Hat Network Registration Client shows you a list of all RPM packages listed in the RPM database on your system and then allows you to customize the list by deselecting packages.
  • Page 24 Chapter 2:Red Hat Network Registration Client Figure 2–8 Registration Wizard Once the RPM package list is built, the list will be displayed as shown in Figure 2–9, RPM Package Information. Deselecting Include RPM Packages installed on this system in my System Profile will omit this information from your System Profile.
  • Page 25: Finishing Registration

    Section 2.5:Finishing Registration Profile shows that the procmail procps , and psgml packages have been omitted from the package list. Choose which packages to exclude from the system profile, and click to continue with the regis- Next tration process. Figure 2–10 Choose which RPM Packages to Exclude from System Profile 2.5 Finishing Registration As seen in Figure 2–11, Finished Collecting Information for System Profile, the last step of registration is to confirm that you want to send your System Profile to the Red Hat Network.
  • Page 26 You will know your System Profile has been successfully sent when you see the Registration Finished to exit the Red Hat Network Registration screen (Figure 2–13, Registration Finished). Click Finish Client. After completing registration, visit http://www.redhat.com/network to verify your System Profile and make any changes.
  • Page 27: Text Mode Rhn Registration Client

    Section 2.6:Text Mode RHN Registration Client Figure 2–13 Registration Finished 2.6 Text Mode RHN Registration Client You can force the Red Hat Network Registration Client to run in text mode with the command: rhn_register --nox The screens for the Text Mode Red Hat Network Registration Client are almost identical to the screens for the graphical version of Red Hat Network Registration Client.
  • Page 28 Chapter 2:Red Hat Network Registration Client Figure 2–14 Text Mode Welcome Screen...
  • Page 29: Chapter 3 Red Hat Update Agent Configuration Tool

    Section 3.2:General Settings 3 Red Hat Update Agent Configuration Tool Before using the Red Hat Update Agent, you should configure the settings. This can be done with the Red Hat Update Agent Configuration Tool. If you are not running the X Window System or prefer the command line version, skip to Section 3.5, Command Line Version of Red Hat Update Agent Configuration Tool .
  • Page 30: Retrieval/Installation Settings

    Chapter 3:Red Hat Update Agent Configuration Tool Figure 3–1 General Settings 3.3 Retrieval/Installation Settings The Retrieval/Installation tab allows you to customize your software package retrieval and package installation preferences. Note Even if you set the Red Hat Update Agent to install the packages automati- cally, it will only download the RPM packages required for new versions of the kernel.
  • Page 31 Section 3.3:Retrieval/Installation Settings Figure 3–2 Retrieval/Installation Settings The following retrieval options can be selected (see Figure 3–2, Retrieval/Installation Settings): • — download selected RPM packages to desired directory Do not install packages after retrieval and ignore the installation preferences • Do not display packages when local configuration file has been modified —...
  • Page 32: Package Exceptions Settings

    Chapter 3:Red Hat Update Agent Configuration Tool • Override version stored in System Profile — override the Red Hat Linux version in your System Profile • — change the directory where packages are downloaded; the default Package storage directory location is /var/spool/up2date 3.4 Package Exceptions Settings The Package Exceptions tab allows you to define which packages to exclude from the list of updated RPM packages according to the package name or file name (see Figure 3–3, Package Exceptions Set-...
  • Page 33: Command Line Version Of Red Hat Update Agent Configuration Tool

    Section 3.5:Command Line Version of Red Hat Update Agent Configuration Tool Figure 3–3 Package Exceptions Settings 3.5 Command Line Version of Red Hat Update Agent Configuration Tool The command line version of this tool performs the same function as the graphical version. It allows you to configure the settings used by the Red Hat Update Agent and store them in the configuration file /etc/sysconfig/rhn/up2date.
  • Page 34 Chapter 3:Red Hat Update Agent Configuration Tool retrieveOnly enableProxy keepAfterInstall proxyPassword proxyUser 10. headerFetchCount 11. versionOverride 12. enableProxyAuth 13. noSSLServerURL http://www.rhns.redhat.com/XMLRPC 14. noReplaceConfig 15. noBootLoader 16. systemIdPath /etc/sysconfig/rhn/systemid 17. serverURL https://www.rhns.redhat.com/XMLRPC 18. pkgSkipList [’kernel*’] 19. adminAddress [’root@localhost’] 20. forceInstall 21. fileSkipList 22.
  • Page 35: Chapter 4 Red Hat Update Agent

    Section 4.1:Starting the Red Hat Update Agent 4 Red Hat Update Agent After configuring the settings for the Red Hat Update Agent using the instructions in Chapter 3, Red Hat Update Agent Configuration Tool , you can use the Red Hat Update Agent to retrieve the latest software packages from Red Hat.
  • Page 36 Chapter 4:Red Hat Update Agent Argument Description -i, --install Install packages after they are downloaded. This argument will override the configuraton option Do not install packages after retrieval. -k, --packagedir Specify a colon separated path of directories to look for packages before trying to download them.
  • Page 37: Choosing Packages To Update

    Section 4.2:Choosing Packages to Update Figure 4–2 Welcome Screen 4.2 Choosing Packages to Update After clicking on the Welcome Screen, the dialog box in Figure 4–3, Retrieve Update Information Next will appear. This means that a connection to Red Hat Network is being established and that your customized list of updates is being retreived.
  • Page 38 Chapter 4:Red Hat Update Agent for your system. If there are no updated packages available for your system, the dialog box in Figure 4–4, No new packages needed appears. Click to exit Red Hat Update Agent. Figure 4–4 No new packages needed If your system is not up-to-date, your customized list of available updated packages is displayed as shown in Figure 4–5, List of Available Updates.
  • Page 39 Section 4.2:Choosing Packages to Update If you want to view the advisory for the RPM Update, click the View Advisory button. This will display what type of Errata Alert it is and what problems it addresses as shown in Figure 4–6, View Advisory.
  • Page 40: Installing Updated Packages

    Chapter 4:Red Hat Update Agent Red Hat Update Agent shows the progress of each package retrieval as shown in Figure 4–8, Re- trieval Finished. When they have all been retrieved, the message . is displayed at the All finished bottom of the screen. Click to continue.
  • Page 41: Update Agent Finished

    Section 4.4:Update Agent Finished Figure 4–9 Installation Finished 4.4 Update Agent Finished When the Red Hat Update Agent has finished downloading the desired packages (and installing them if you chose the install option), you will see the screen in Figure 4–10, Update Agent Finished. to exit the Red Hat Update Agent.
  • Page 42: Command Line Version Of Red Hat Update Agent

    Chapter 4:Red Hat Update Agent Figure 4–10 Update Agent Finished 4.5 Command Line Version of Red Hat Update Agent If you are not running X, you can still run the Red Hat Update Agent from a virtual console or remote terminal. If you are running X but want to use the command line version, you can force it not to display the graphical interface with the command up2date --nox.
  • Page 43 Section 4.5:Command Line Version of Red Hat Update Agent Table 4–2 Update Agent Command Line Arguments Argument Description --configure Configure Red Hat Update Agent options. This is equivalent to running the Red Hat Update Agent Configuration Tool (up2date-config). To run the command line version of up2date-config, use this option in conjunction with the --nox option: up2date --nox --configure.
  • Page 44 Chapter 4:Red Hat Update Agent Argument Description --tmpdir=directory 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. -u, --update Update the system. All package updates for your system will be downloaded based on your configured preferences (and installed if you chose that option).
  • Page 45 Cut and paste the following into a file and save it as redhat2.asc or download it from http://www.redhat.com/about/contact/. Type bits/keyID Date User ID 1024D/DB42A60E 1999-09-23 Red Hat Software, Inc. (security@redhat.com) 2048g/961630A2 1999-09-23 -----BEGIN PGP PUBLIC KEY BLOCK----- Version: GnuPG v1.0.0 (GNU/Linux) Comment: For info see http://www.gnupg.org...
  • Page 46: Manual Package Installation

    Chapter 4:Red Hat Update Agent lMH27qFYzLbT6npXwXYIOtVn0K2/iMDj+oEB1Aa2au4OnddYaLWp06v3d+XyS0t+ 5ab2ZfIQzdh7wCwxqRkzR+/H5TLYbMG+hvtTdylfqIX0WEfoOXMtWEGSVwyUsnM3 Jy3LOi48rQQSCKtCAUdV20FoIGWhwnb/gHU1BnmES6UdQujFBE6EANqPhp0coYoI hHJ2oIO8ujQItvvNaU88j/s/izQv5e7MXOgVSjKe/WX3s2JtB/tW7utpy12wh1J+ JsFdbLV/t8CozUTpJgx5mVA3RKlxjTA+On+1IEUWioB+iVfT7Ov/0kcAzwADBQf9 E4SKCWRand8K0XloMYgmipxMhJNnWDMLkokvbMNTUoNpSfRoQJ9EheXDxwMpTPwK ti/PYrrL2J11P2ed0x7zm8v3gLrY0cue1iSba+8glY+p31ZPOr5ogaJw7ZARgoS8 BwjyRymXQp+8Dete0TELKOL2/itDOPGHW07SsVWOR6cmX4VlRRcWB5KejaNvdrE5 4XFtOd04NMgWI63uqZc4zkRa+kwEZtmbz3tHSdRCCE+Y7YVP6IUf/w6YPQFQriWY FiA6fD10eB+BlIUqIw80VgjsBKmCwvKkn4jg8kibXgj4/TzQSx77uYokw1EqQ2wk OZoaEtcubsNMquuLCMWijYhGBBgRAgAGBQI36lRyAAoJECGRgM3bQqYOhyYAnj7h VDY/FJAGqmtZpwVp9IlitW5tAJ4xQApr/jNFZCTksnI+4O1765F7tA== =3AHZ -----END PGP PUBLIC KEY BLOCK----- At the shell prompt, import the key with the following command: gpg --import redhat2.asc The resulting message tells you that the key was processed. To check that the key was added, type gpg --list-keys.
  • Page 47: Log File

    Section 4.8:Log File To syncronize the RPM package list on your local system and on Red Hat Network run the command up2date -p After running this command, your System Profile on Red Hat Network will reflect the latest software versions installed on your system. 4.8 Log File The Red Hat Update Agent keeps a log of all the actions that it peforms on your system in the file /var/log/up2date.
  • Page 48 Chapter 4:Red Hat Update Agent...
  • Page 49: Chapter 5 Software Manager

    In a Web browser, go to https://www.redhat.com/network/. The page shown in Figure 5–1, Logging into Red Hat Network will be displayed. If you have not registered a system yet or do not have a redhat.com account, create a new account by clicking the button on the left side of the page.
  • Page 50: Viewing Your Notifications

    Chapter 5:Software Manager Figure 5–1 Logging into Red Hat Network 5.2 Viewing Your Notifications After logging into Software Manager, click on the button on the top navigation bar. Depending Main on your preferences, this page displays all Security Alerts, Bug Fixes Alerts, and Enhancements Alerts (collectively referred to as Errata Alerts) for all registered systems in your network group (see Figure 5–2, Main Page).
  • Page 51: Adding A System Profile

    Red Hat Network to send the desired information to the servers. After this information is sent, the system appears in your network group. You can then login to https://www.redhat.com/network/ to customize your preferences such as receiving email notifications and excluding packages from your...
  • Page 52: Viewing Your Network Group

    Red Hat Network Registration Client to register a new system (see Chapter 2, Red Hat Network Registration Client ). To register a system through the Web interface use the following steps: 1. Login to Red Hat Network at https://www.redhat.com/network/, click the button on the top Main navigation bar and click the link.
  • Page 53 Section 5.4:Viewing Your Network Group 5.4.1 Systems Overview As shown in Figure 5–3, Systems Overview Tab, clicking on shows the status of your Your Network entire network so you can quickly determine the health and security of each system. This page shows you an overview of the systems in your network and errata for every system in your network.
  • Page 54 Chapter 5:Software Manager column is a brief description for the system. It is configured when the system is registered. The New Packages column displays the total number or errata reports available for the system. To change the sorting order of the list, click on the column header names.
  • Page 55: Viewing Individual System

    Hat Network Software Manager to no service. Use the Upgrade Downgrade buttons to move systems between service levels. For information on purchasing Software Manager subscription, refer to http://www.redhat.com/net- work/purchase/. 5.5 Viewing Individual System Pages After logging into Software Manager, click the button on the top navigation bar and Your Network then click on the desired system name.
  • Page 56: Customizing Preferences

    Chapter 5:Software Manager download the relevant packages immediately or add them to your Download List . Change the sorting order of errata by clicking on the column header names. A bold column header indicates the current sort order. Packages Profile tab allows you to browse all packages included in your system profile.
  • Page 57 Section 5.6:Customizing Preferences Email Errata Alerts Get the notifications you need by email. If there is a Security Alert for any of your systems, we can contact you directly. Select to receive email notifications for new Errata that affect your systems.
  • Page 58: Searching Errata

    Chapter 5:Software Manager Under the Epoch section, choose to display the epoch for packages within the package profile. Click the button to apply the changes. Update Account 5.6.3 Main Page From the Main Page tab of the Preferences page you can customize the information displayed when you login Red Hat Network.
  • Page 59: Viewing Online Help

    Section 5.8:Viewing Online Help Figure 5–6 Search Errata Alerts 5.8 Viewing Online Help In addition to this User Reference Guide, the following help is available by clicking the Help Desk button on the top navigation bar: • Security and Privacy statement •...
  • Page 60 Chapter 5:Software Manager...
  • Page 61: Chapter 6 Red Hat Network Daemon

    Red Hat Network Daemon 6 Red Hat Network Daemon The Red Hat Network Daemon periodically connects to the Red Hat Network to check for updates and notifications. The default interval time is two hours (120 minutes). This can be configured in the /etc/sysconfig/rhn/rhnsd file by specifying the time interval in minutes.
  • Page 62 Chapter 6:Red Hat Network Daemon...
  • Page 63: Using Red Hat Network With Red Hat Linux

    After they are installed, run the Red Hat Network Registration Client (rhn_register) to register your system. See Chapter 2, Red Hat Network Registration Client for details. Login to your account at https://www.redhat.com/network/ to configure your preferences and to configure which systems you want to subscribe to Software Manager.
  • Page 64 Chapter 7:Using Red Hat Network with Red Hat Linux 6.2...
  • Page 65: Chapter 8 Frequently Asked Questions

    April 6. Q: How do I purchase Red Hat Network Software Manager subscriptions? A: Go to http://www.redhat.com/network/purchase/ for instructions. Q: Can I cancel my Red Hat Network Software Manager subscriptions? A: To cancel your Software Manager subscriptions, go to Your Network =>...
  • Page 66 Red Hat Update Agent. Q: I forgot my username and password. How do I access my account? A: Go to http://www.redhat.com/network. In the Member Login section is a Forgot Your Password link. Click the link and complete the form. Your password will be sent to your email address. If this does not work for you, please call our customer service desk.
  • Page 67 A: The system you are running it on is not connected to the Internet, or the system is attempting to access Red Hat Network through a proxy server. Proxy server settings can be configured in the newest version of up2date available at http://www.redhat.com/support/errata/RHBA-2000-138.html. For instructions on configuring the proxy server, refer to Section 3.2, General Settings.
  • Page 68 Chapter 8:Frequently Asked Questions...
  • Page 69 Index Index Preferences ........56 General........57 Adding a System Profile Main Page .
  • Page 70 Index rhnsd ........52, 61 Search Errata Alerts ......58 Secure Sockets Layer .

This manual is also suitable for:

Advanced 2.1

Table of Contents