background image

Red Hat Network

User Reference Guide 2.0

Summary of Contents for DIRECTORY SERVER 2.0 - GATEWAY

Page 1: ...Red Hat Network User Reference Guide 2 0 ...

Page 2: ...rom the copyright holder Red Hat Red Hat Network the Red Hat Shadow Man logo RPM Maximum RPM the RPM logo Linux Library PowerTools Linux Undercover RHmember RHmember More Rough Cuts Rawhide and all Red Hat based trademarks and logos are trademarks or registered trademarks of Red Hat Inc in the United States and other countries Linux is a registered trademark of Linus Torvalds Motif and UNIX are re...

Page 3: ...stering a System Profile 21 2 4 Finishing Registration 25 2 5 Text Mode RHN Registration Client 27 Chapter 3 Red Hat Update Agent Configuration 29 3 1 Configuring the Red Hat Update Agent 29 3 2 General Settings 29 3 3 Retrieval Installation Settings 30 3 4 Package Exceptions Settings 32 Chapter 4 Red Hat Update Agent 35 4 1 Starting the Red Hat Update Agent 35 4 2 Choosing Packages to Update 37 4...

Page 4: ...9 5 4 Viewing Your Network Group 50 5 5 Viewing Individual System Pages 52 5 6 Downloading Updated Packages 53 5 7 Customizing Preferences 53 5 8 Searching Errata 55 5 9 Viewing Online Help 56 Chapter 6 Red Hat Network Daemon 57 Chapter 7 Using Red Hat Network with Red Hat Linux 6 2 59 Chapter 8 Frequently Asked Questions 61 iv ...

Page 5: ...When you read this manual you ll see that certain words are represented in different fonts typefaces sizes and weights This highlighting is systematic different words are represented in the same style to indicate their inclusion in a specific category The types of words that are represented this way include the following command Linux commands and other operating system commands when used are repr...

Page 6: ...nterface A title word or phrase found on a GUI interface screen or window will be shown in this style When you see text shown in this style it is being used to identify a particular GUI screen or an element on a GUI screen e g text associated with a checkbox or field Examples On the GNOME Control Center screen you can customize your GNOME window manager Select the Require Password checkbox if you ...

Page 7: ...his case the contents of the directory is shown in this style prompt A prompt which is a computer s way of signifying that it is ready for you to input something will be shown in this style Examples stephen maturin stephen leopard login user input Text that the user has to type either on the command line or into a text box on a GUI screen is displayed in this style In the following example text an...

Page 8: ... be marked as a tip a note important a caution or a warning For example Note Remember that Linux is case sensitive In other words a rose is not a ROSE is not a rOsE CAUTION Don t do routine tasks as root use a regular user account unless you need to use the root account to administer your system WARNING If you choose not to partition manually a server class installation will remove all existing pa...

Page 9: ...end in Your Feedback If you d like to make suggestions about the Red Hat Network User Reference Guide please mention this guide s identifier RHNurg EN 2 0 Print RHI 2001 01 29T10 47 0400 You can send mail to rhn feedback redhat com ...

Page 10: ...x Introduction ...

Page 11: ...a Alerts can be downloaded directly from Red Hat using the Red Hat Update Agent standalone application or through a Web browser at http www redhat com network The three main components of Red Hat Network are as follows The Red Hat Network Registration Client The Red Hat Network user interface The Red Hat Network Daemon The Red Hat Network Registration Client allows you to create a unique RHN user ...

Page 12: ...vides significant benefits to your network including security and quality assur ance All transactions made between you and Red Hat Network are encrypted and all RPM packages are signed with Red Hat s GNU Privacy Guard GPG signature to ensure authenticity Red Hat Network incorporates the following security measures 1 Your System Profile available at http www redhat com network is only accessible wi...

Page 13: ...ll return package rhn_register is not installed Perform this check for every package in Table 1 1 Red Hat Network Packages If you do not want to use the graphical versions you do not have to install the two packages ending in gnome Table 1 1 Red Hat Network Packages Package Name Description rhn_register Provides the Red Hat Network Registration Client program and the text mode interface rhn_regist...

Page 14: ...14 Chapter 1 What is Red Hat Network ...

Page 15: ...ain Menu Button on the Panel Programs System RHN Registration 2 On the KDE desktop go to the Main Menu Button on the Panel Red Hat System RHN Registration 3 Type the command rhn_register at a shell prompt for example an xterm or gnome terminal 4 If you are not running the X Window System type the command rhn_register at a virtual console or remote terminal Please refer to Section 2 5 Text Mode RHN...

Page 16: ...ork Registration Client gives you a brief overview of the services available and the steps required to register see Figure 2 2 Welcome Screen Click Next to continue with the registration process If you click Cancel the registration process will end and no information will be sent Figure 2 2 Welcome Screen ...

Page 17: ... com Figure 2 3 Red Hat Privacy Statement 2 2 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 2 2 1 Required User Account Information In the screen shown in Figure 2 6 Create a Unique User Name and Password you must choose a user name and password Once logged into Red H...

Page 18: ...owing restrictions Must be at least four characters long Are case insentitive Can not contain any spaces Can not contain any tabs Can not contain any line feeds Can not contain the characters or If you have already registered your system and try to register it again the dialog box shown in Figure 2 5 Warning This System Already Registered will appear If you continue it will overwrite your ex istin...

Page 19: ...Profile and you can log into Red Hat Network with your user name and password to view all your systems simultaneously You can register one free system with Red Hat Network Software Manager To register more than one system you must purchase additional Software Manager subscriptions Refer Section 5 4 3 As sign Service Levels for more information about purchasing additional subscriptions Once again i...

Page 20: ...address text area will no longer be shaded and you can enter the email address where notifications will be sent The email address can be changed at any time Click Next to continue creating a User Account After successfully creating a user name and password you are prompted for your contact information This information is optional If you would like to receive information about special offers from R...

Page 21: ...e information about your Red Hat Linux system The software System Profile information is used by Red Hat Network to determine what software update notifications you receive 2 3 1 Hardware System Profile After creating a user name and password for your Red Hat Network account the Red Hat Network Registration Client probes your system for the following information Red Hat Linux version Hostname IP a...

Page 22: ...e for the system You may modify this to be a more descriptive string such as Email Server for Support Team if you find it more helpful If you do not wish to include information about your hardware or network in your System Profile deselect Include information about hardware and network see Figure 2 8 System Profile Hard ware Click Next to continue with the registration process Figure 2 8 System Pr...

Page 23: ...m Profile and you will only receive notifications about the packages in your System Profile Thus if you use an older version of a package and deselect it from the list it will not be replaced with a newer version This RPM list can be modifed through the Red Hat Network web interface or by using the Red Hat Update Agent As shown in Figure 2 9 Registration Wizard querying the RPM database may take s...

Page 24: ... be updated by Red Hat Network To exclude a package uncheck the package from the list by clicking the X beside the package name For example Figure 2 11 Choose which RPM Packages to Exclude from System 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 Next to continue with the regis tr...

Page 25: ...2 4 Finishing Registration As seen in Figure 2 12 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 If you choose Cancel at this point no information will be sent Clicking Next will send your profile ...

Page 26: ... may take some time depending on your connection speed Figure 2 13 Send System Profile to Red Hat Network You will know your System Profile has been successfully sent when you see the Registration Finished screen Figure 2 14 Registration Finished Click Finish to exit the Red Hat Network Registration Client After completing registration visit http www redhat com network to verify your System Profil...

Page 27: ...al to the screens for the graphical version of Red Hat Network Registration Client Some of the text in the text mode version is more concise due to lack of space in the interface However there is an equal number of screens and fields in both versions Thus if you are using the text mode version you can still follow the instructions that begin in Section 2 1 Starting the Red Hat Network Registration...

Page 28: ...28 Chapter 2 Registration Figure 2 15 Text Mode Welcome Screen ...

Page 29: ...tarted using one of the following methods On the GNOME desktop go to the Main Menu Button on the Panel Programs System RHN Configuration or Update Agent Configuration for older versions of Red Hat Update Agent On the KDE desktop go to the Main Menu Button on the Panel Red Hat RHN Configu ration or Update Agent Configuration for older versions of Red Hat Update Agent Type the command up2date config...

Page 30: ...eval 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 New kernels are not installed automatically ...

Page 31: ...ble Do not display packages when local configuration file has been modified if the configu ration file has been modified for a package such as Apache and Squid do not display them in the list of available packages Retrieve source RPM along with binary package download both the source src rpm and the binary architecture rpm files The following installation options are configurable see Figure 3 2 Re...

Page 32: ... define a set of packages to be excluded according to the package name click the Add button next to the Package Names to Skip section and enter a character string including wild cards A wild card at the end of the character string means all packages beginning with the character string will be excluded from the list A wild card at the beginning of the character string means any packages that end wi...

Page 33: ...Section 3 4 Package Exceptions Settings 33 Figure 3 3 Package Exceptions Settings ...

Page 34: ...34 Chapter 3 Red Hat Update Agent Configuration ...

Page 35: ...eding The Red Hat Update Agent can be started using one of the following methods On the GNOME desktop go to the Main Menu Button on the Panel Programs System RHN Update Agent On the KDE desktop go to the Main Menu Button on the Panel Red Hat RHN Update Agent Type the command up2date at a shell prompt for example an xterm or gnome terminal If you choose the last option and start the application fro...

Page 36: ...The first time you run the Red Hat Update Agent the dialog window in Figure 4 1 Install GPG Key will prompt you to install the Red Hat GPG key This is used to verify the RPM packages you download for security purposes Click Yes to install the key and you will not see this message again Figure 4 1 Install GPG Key After installing the Red Hat GPG key the screen in Figure 4 2 Welcome Screen will appe...

Page 37: ...nnection to Red Hat Network is being established and that your customized list of updates is being retreived This might take some time depending on the speed of your connection and the number of packages you have installed Figure 4 3 Retrieve Update Information While you see this dialog box Red Hat Update Agent uses your unique Digital Certificate etc sysconfig rhn systemid to determine if there a...

Page 38: ...n in Figure 4 5 List of Available Updates Figure 4 5 List of Available Updates By default no packages are selected for download If you highlight each package the package de scription is displayed in the Package Information section at the bottom of the screen To select the package for download and installation if you chose that option click the checkbox as shown in Fig ure 4 6 Choose Updates to Ret...

Page 39: ...ss of each package retrieval as shown in Figure 4 7 Re trieval Finished When they have all been retrieved the message All finished is displayed at the bottom of the screen Click Next to continue If you did not chose to install the packages automati cally skip the next section and go to Section 4 4 Update Agent Finished ...

Page 40: ...ve all the packages installed automatically see Chapter 3 Red Hat Update Agent Configuration the selected packages are installed The progress of installing each package as well as the total progress is displayed When the packages have been installed as seen in Figure 4 8 Installation Finished click Next to continue ...

Page 41: ...ished 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 9 Update Agent Finished Click Finish to exit the Red Hat Update Agent ...

Page 42: ...emote terminal The command line version of the Red Hat Update Agent accepts the following arguments Table 4 2 Update Agent Command Line Arguments Argument Description a allpackages Show make available all packages related to your release of Red Hat Linux not just those installed on your system configure Graphically configure Red Hat Update Agent options through the Red Hat Update Agent Configurati...

Page 43: ...ter Register as an anonymous user with Red Hat Network You can register as a full user later by running rhn_register tmpdir directory Override the configured package directory The default location is var spool up2date u update Download all packages relevant to my system and install if preferences set through up2date config has Do not install packages after retrieval unchecked packagename Only down...

Page 44: ...8QydLhjVfU1VSl4xt6bupPbWJbyjkg5Z3P7BlUOUJmrx3wCgobNV EDGaWYJcch5z5B1of 41G8kEAKii6q7Gu vhXXnLS6m15oNnPVybyngiw 23dKjS ZVG7rKANEK2mxg1VB vc uUc4k49UxJJfCZg1gu1sPFV3GSa Y 7jsiLktQvCiLP lncQt1dV ENmHR5BdIDPWDzKBVbgWnSDnqQ6KrZ7T6AlZ74VMpjGxxkWU6vV2xsW XCLPA 9P vtImA8CZN3jxGgtK5GGtDNJ cMhhuv5tnfwFg4b VGo2Jr8mhLUqoIb E6zeGAmZbUpdckDco8D5fiFmqTf5 pCEpJLJkkzel 32N2w4qzPrcRMCiBURES PjCLd4Y5rPoU8E4kOHc 4BuH...

Page 45: ...Hat as well as your own keys 4 6 Syncronizing Your System Profile If you configured the Red Hat Update Agent to install the latest packages automatically then your System Profile stored by Red Hat Network will be updated automatically also However if you only download the latest RPM packages using the Red Hat Update Agent or through the Web interface and upgrade or install the packages yourself yo...

Page 46: ...46 Chapter 4 Red Hat Update Agent ...

Page 47: ...ts tab allows you to generate custom reports detailing the health and se curity of your Network Group 3 System administrators can quickly determine if their systems require updating and what type of updates are available by viewing the System Overview page 4 It will only display errata relevant to your network 5 1 Logging into Red Hat Network In a Web browser go to http www redhat com network The ...

Page 48: ...s 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 Click the View All button to view the details for the errata related to your network group You can also view the errata page for your network by clicking the Your Network button on the top navigation bar and...

Page 49: ...hether or not to include hardware and software information in your system profile After saving a Digital Certificate the Red Hat Network Daemon initiates a connection from the client to 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 http www redhat com network to customize your preferences...

Page 50: ...e up to thirty minutes or longer if you increased the time interval for your Red Hat Network Daemon 7 Open a shell prompt for example an xterm or gnome terminal and log in as root Copy the systemid file that you downloaded to etc sysconfig rhn systemid 8 No hardware or software information is gathered during the Web registration process The Red Hat Network Daemon on the client side must initiate a...

Page 51: ...at are available for each system De pending on your notification preference settings individual systems may be flagged with bug fix security alert or package enhancement icons Click on the individual system name to view the detailed profile information and specific notifications see Section 5 5 Viewing Individual System Pages The Service Level column displays the level of Red Hat Network service f...

Page 52: ...els 5 5 Viewing Individual System Pages After logging into Red Hat Network click the Your Network button on the top navigation bar and then click on the desired system name The System Detail tab provides basic system information Your Architecture OS and Version infor mation determine which notifications you receive The Errata Alerts tab shows you errata for a currently selected system If an errata...

Page 53: ...the packages you wish to download After choosing which packages to download you have three options Click the Download Now button to download the RPM files immediately Click the Download Later button to add it to your Download List All RPM packages added to your Download List remain there until they are downloaded or deleted from the list When you are ready to download the packages in your download...

Page 54: ...ou need by email If there is a Security Alert for any of your systems we can contact you directly Select Yes to receive email notifications for new Errata that affect your systems Then customize your notification delivery by choosing which systems you want to receive alerts about If you don t want to receive email notifications answer No If you later decide you want to get notifications by email r...

Page 55: ...ed Hat Network If you select Latest Errata Alerts under the Status Windows section the three most recent errata the number of affected systems and the number of new packages they include will be listed on the Main Page as soon as you log into Red Hat Network Click the Update button at the bottom of the page to apply the changes There is also a customizable list of Favorite Guides and Favorite Foru...

Page 56: ...fied time period see Figure 5 5 Search Errata Alerts Figure 5 5 Search Errata Alerts 5 9 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 FAQs Contact Customer Service Support Forums ...

Page 57: ...is one hour 60 minutes If you set the interval below one hour it will default to two hours 120 minutes You can view the status of the rhnsd by typing the command service rhnsd status or etc rc d init d rhnsd status at a shell prompt To disable the daemon as root run the ntsysv utility and uncheck rhnsd You can also as root execute the command chkconfig rhnsd off Using these two methods will only d...

Page 58: ...58 Chapter 6 Red Hat Network Daemon ...

Page 59: ... to download the packages 2 In the same shell prompt execute the command cd rhnpackages to change to the new direc tory 3 In a Web browser download the necessary packages from http www redhat com network ser vice rhl_62 html 4 Go back to the shell prompt in the rhnpackages directory you must still be root and execute the command rpm Uvh to upgrade the exist Red Hat Update Agent to the version that...

Page 60: ...60 Chapter 7 Using Red Hat Network with Red Hat Linux 6 2 ...

Page 61: ... Hat Network Software Manager subscriptions A First profile each system using the Red Hat Network Registration Client You can set up a Red Hat Network user name and password if you don t have one yet Then log into Red Hat Network at http www redhat com network go to Your Network Assign Service Levels and follow the instructions there Q Can I cancel my Red Hat Network Software Manager subscriptions...

Page 62: ...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 Q Will Red Hat Network update packages that were not installed with the Red Hat distribution A No Red ...

Page 63: ...hase subscriptions Q Why does the Red Hat Update Agent return the error No Route to Host A The system you are running up2date 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 Q Why does the Red Ha...

Page 64: ...64 Chapter 8 Frequently Asked Questions ...

Page 65: ...2 R Red Hat Linux 6 2 Using Red Hat Network with 59 Red Hat Network Logging In 47 Red Hat Network Daemon 11 57 Disable 57 Status 57 Red Hat Network Registration Client 11 Red Hat Update Agent 11 35 Command Line Arguments 42 Configuration 29 Registration 15 Email notification 17 Hardware System Profile 21 Password 17 RPM Package List 23 Software System Profile 23 System Profile 17 21 through the We...

Page 66: ...66 Index Systems Overview 50 U up2date See Red Hat Update Agent V Visual Alerts 51 Y Your Network Group 50 ...

Reviews: