background image

Chapter 1. What is Red Hat Network?

5

1.7. Before You Begin

By default, all the software packages you need to use Red Hat Network are installed with Red Hat dis-

tributions. However, if you chose not to install them during the installation process, you will need to

obtain the

Red Hat Update Agent

and possibly the

Red Hat Network Registration Client

. Remem-

ber, if you are a Red Hat Enterprise Linux 2.1 user, you will need the

Red Hat Network Registration

Client

. To determine if the

Red Hat Network Registration Client

is installed, type the following

command:

rpm -q rhn_register

If the

Red Hat Network Registration Client

is installed, it will return something similar to

rhn_register-2.8.27

The version number might differ slightly.
If you do not have the

Red Hat Network Registration Client

installed, the command will return

package rhn_register is not installed

Perform this check for every package in Table 1-1 relevant to your system. If you prefer to use the

command line versions, you do not have to install the two packages ending in

gnome

.

Package Name

Description

rhn_register

Provides the

Red Hat Network Registration Client

program and the

text mode interface

rhn_register-gnome

Provides the GNOME interface (graphical version) for the

Red Hat

Network Registration Client

; runs if the X Window System is available

up2date

Provides the

Red Hat Update Agent

command line version and the Red

Hat Network Daemon

up2date-gnome

Provides the GNOME interface (graphical version) for the

Red Hat

Update Agent

; runs if the X Window System is available

Table 1-1. Red Hat Network Packages

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. If you install an

older version of these packages, you can retrieve the latest versions using Red Hat Network. The first

time that you request the RPM updates for your system, they will be included.

Summary of Contents for NETWORK 3.2 - PROVISIONING

Page 1: ...Red Hat Network 3 2 Provisioning Reference Guide...

Page 2: ...s Torvalds Motif and UNIX are registered trademarks of The Open Group XFree86 is a trademark of The XFree86 Project Inc and is pending registration Intel and Pentium are registered trademarks of Intel...

Page 3: ...ent Finished 24 2 3 5 Command Line Version 25 2 4 Configuration 29 2 4 1 Using the Red Hat Update Agent Configuration Tool 29 2 4 2 Command Line Version 32 2 5 Registering with Activation Keys 33 3 Re...

Page 4: ...etwork Registration Client 83 6 2 Starting the Red Hat Network Registration Client 85 6 3 Registering a User Account 87 6 4 Registering a System Profile 89 6 4 1 Hardware System Profile 89 6 4 2 Softw...

Page 5: ...ber of File Revisions 102 A 2 12 Updating a File in a Channel 102 A 2 13 Uploading Multiple Files at Once 103 B RHN API Access 105 B 1 Using the auth Class and Getting the Session 105 B 2 Obtaining th...

Page 6: ......

Page 7: ...of Red Hat Network offerings please review the descriptions available at http www redhat com software rhn 1 Document Conventions When you read this manual certain words are represented in different fo...

Page 8: ...UI screen or window A word in this style indicates that the word is the top level of a pulldown menu If you click on the word on the GUI screen the rest of the menu should appear For example Under Fil...

Page 9: ...version number where version number is the version of the kernel installed on this system Additionally we use several different strategies to draw your attention to certain pieces of informa tion In...

Page 10: ...e The Red Hat Network Provisioning Reference Guide is constantly expanding as new Red Hat Network features and service plans are launched 2 1 Send in Your Feedback If you would like to make suggestion...

Page 11: ...ning Red Hat Linux 6 2 7 3 and Red Hat Enterprise Linux 2 1 only The Red Hat Update Agent provides your initial connection to the Red Hat Network Once regis tered it enables channel subscription packa...

Page 12: ...ugh the full repository of RPMs available to Red Hat Network users Search Errata Search through the collection of all errata ever released through Red Hat Network 1 2 Update The RHN Update service is...

Page 13: ...and other workload focused sys tems may be grouped so that each set can be administered in common ways Multiple Administrators Administrators may be given rights to particular system groups easing the...

Page 14: ...top of the Red Hat Errata list Minimized security vulnerabilities in your network by providing the patches as soon as Red Hat releases them Filtered list of package updates packages not relevant to yo...

Page 15: ...versions you do not have to install the two packages ending in gnome Package Name Description rhn_register Provides the Red Hat Network Registration Client program and the text mode interface rhn_regi...

Page 16: ...6 Chapter 1 What is Red Hat Network...

Page 17: ...Hat Update Agent Important You must use Red Hat Update Agent Version 2 5 4 or higher to upgrade your kernel automatically It will install the updated kernel and configure LILO or GRUB to boot the new...

Page 18: ...ault location is var spool up2date This option is useful if you do not have enough space in the configured location justdb Only add packages to the database and do not install them dbpath dir Specify...

Page 19: ...this message again Figure 2 2 Install GPG Key 2 2 Registration Before you begin using Red Hat Network you need to create a username password and System Profile Upon launch the Red Hat Update Agent sen...

Page 20: ...e you start the Red Hat Update Agent Click Forward to continue Figure 2 3 Welcome Screen After clicking through the Welcome Screen the Red Hat Privacy Statement appears See Figure 2 4 Red Hat is commi...

Page 21: ...nd password Once logged in to Red Hat Network you can modify your preferences view your existing System Profile or obtain the latest Red Hat software packages Note If you are already a member of redha...

Page 22: ...er Account You must choose a unique username If you enter one already in use you will see an error message see Figure 2 6 Try different usernames until you find one that has not been used Warning Be s...

Page 23: ...you can log into Red Hat Network with your username and password to view all your systems simultaneously In the Create Account screen click Forward to continue If you are a new user to RHN the Red Hat...

Page 24: ...of hardware and software information about your Red Hat Linux system The System Profile information is used by Red Hat Network to determine what software update notifications you receive 2 2 2 1 Hardw...

Page 25: ...e information about hardware and network see Figure 2 8 Figure 2 8 System Profile Hardware Click Forward to continue with the registration process 2 2 2 2 Software System Profile The software System P...

Page 26: ...e progress bar you will see while the Red Hat Update Agent gathers a list of the RPM packages installed on your system This operation may take some time depending on your system installation Figure 2...

Page 27: ...hat the Canna devel and Canna libs packages have been omitted from the package list Choose which packages to exclude if any from the System Profile and click Forward to continue with the registration...

Page 28: ...Red Hat Network You will know your System Profile has been successfully sent when you see the Channels screen Figure 2 14 appear Refer to Section 2 3 1 Choosing a Channel for continued instructions 2...

Page 29: ...ion 4 6 Channels for more information on channels and how channels are used to determine which packages are installed Figure 2 14 Channels 2 3 2 Choosing Packages to Update After clicking Forward the...

Page 30: ...stering your System Profile these are displayed in Figure 2 17 You may override these settings and include any of these packages in the update by selecting the checkboxes next to them To see a summary...

Page 31: ...date Agent 21 Figure 2 18 View Advisory The Available Package Updates screen is the next to appear If your system is not up to date your customized list of available updated packages is displayed as s...

Page 32: ...ests for RPM dependencies and prompts you if you have chosen to omit packages that are required for software updates that you did choose The dialog box in Figure 2 20 is shown while it is testing for...

Page 33: ...have the packages installed via the Red Hat Update Agent skip to Section 2 3 5 2 Manual Package Installation for further instructions If you configured it to install the packages the default setting...

Page 34: ...tion Finished 2 3 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 Fig...

Page 35: ...of the Red Hat Update Agent allows you to perform advanced functions or to perform actions with little or no interaction For example the following command updates your system with no interaction It w...

Page 36: ...atabase and do not install them k packagedir Specify a colon separated path of directories to look for packages in before trying to download them l list List packages relevant to the system nodownload...

Page 37: ...u start Red Hat Update Agent you need to install the Red Hat GPG key manually If you do not have it installed you will see the following message Your GPG keyring does not contain the Red Hat Inc publi...

Page 38: ...2wk OZoaEtcubsNMquuLCMWijYhGBBgRAgAGBQI36lRyAAoJECGRgM3bQqYOhyYAnj7h VDY FJAGqmtZpwVp9IlitW5tAJ4xQApr jNFZCTksnI 4O1765F7tA 3AHZ END PGP PUBLIC KEY BLOCK 2 At the shell prompt import the key with the...

Page 39: ...rs various options to configure its settings If you are not running the X Window System or prefer the command line version skip to Section 2 4 2 Command Line Version 2 4 1 Using the Red Hat Update Age...

Page 40: ...for detailed instructions 2 4 1 2 Retrieval Installation Settings The Retrieval Installation tab allows you to customize your software package retrieval and package installation preferences Warning Y...

Page 41: ...source src rpm and the binary architecture rpm files The following installation options are configurable see Figure 2 25 Use GPG to verify package integrity before installing the packages verify Red H...

Page 42: ...Update Agent will not display any packages beginning with kernel To exclude packages by file name follow the same rules except click the Add button next to the File Names to Skip section Figure 2 26 P...

Page 43: ...ve your changes and exit Press q and then Enter to quit without saving your changes Important Although this isn t configurable users should still make note that the port used by the Red Hat Update Age...

Page 44: ...d to the RHN channels and system groups selected during key generation The system will not be subscribed to channels that contain packages not suitable for the system For example a Red Hat Linux 7 2 s...

Page 45: ...Red Hat Linux 7 3 the Red Hat Network Alert Notification Tool appears on the panel by default as shown in Figure 3 1 Figure 3 1 GNOME Panel with Red Hat Network Alert Notification Tool If it does not...

Page 46: ...t click on the applet and select Configuration Your preferences are written to the file rhn applet conf in your home directory The Red Hat Network Alert Notification Tool also uses the system wide con...

Page 47: ...l displays a list of available updates To alter your list of excluded packages click the Ignored Packages tab and make your modifications Figure 3 3 Available Updates 3 4 Applying Updates If the syste...

Page 48: ...38 Chapter 3 Red Hat Network Alert Notification Tool...

Page 49: ...HN Refer to Chapter 2 Red Hat Update Agent for step by step instructions After registering your system with Red Hat Network go back to http rhn redhat com and complete the username and password fields...

Page 50: ...systems Advanced Search Quickly search all of your systems by specific criteria such as name hardware devices system info networking packages and location Activation Keys Generate an activation key f...

Page 51: ...click the Search button Your results will appear at the bottom of the page Refer to the appropriate category for instructions on using these results 4 2 3 Systems Selected Also near the top of the pag...

Page 52: ...he layout and symbols used throughout the website Figure 4 2 Your Red Hat Network The top of the page shows how many systems need attention provides a link to quickly view those systems and displays a...

Page 53: ...merely make the changes in the appropriate text fields and click the Update button in the bottom right hand corner Remember if you change your Red Hat Network password the one used to log into RHN and...

Page 54: ...items that will appear in a list on a single page If more items are in the list clicking the Next button will display the next group of items This preference applies to system lists Errata lists packa...

Page 55: ...ork Note that links to other technical guides may also appear in the left navigation bar depending on the entitlement level and product offering of the account with which you logged in 4 3 5 6 Contact...

Page 56: ...ion You can also click the Use Group button in the System Groups section of the Overview page to go directly to the System Set Manager Refer to Section 4 4 4 System Set Manager for more information 4...

Page 57: ...s package updates for the system yet the Red Hat Update Agent responds with Your system is fully updated when run a conflict likely exists in the system s pack age profile or in the up2date configurat...

Page 58: ...lt set of your systems It displays every system you ve registered with Red Hat Network 4 4 2 2 Out of Date The Out of Date page displays the registered systems that have applicable Errata Alerts that...

Page 59: ...tes available you may click the update now link to apply all relevant Errata Updates to the individual system as you would under the Errata tab In addition some functions can be accessed only on this...

Page 60: ...e a note infor mation included here is more formal and can be searched upon For instance you may decide to identify the cubicle in which each system is located To do this you must first create a cubic...

Page 61: ...package removal are displayed on the page Upgrade Displays a list of packages that have a new version available based on the package versions in the channel for the system Click on the latest package...

Page 62: ...must be more robust These tools may already be installed on your system especially if you kickstarted the system with configuration management functionality If not they can be found within the RHN Pro...

Page 63: ...ge Refer to Section 4 6 6 6 Configuration File Details for instructions To replicate the file within a config channel select its checkbox click the Copy to Config Channel button and select the destina...

Page 64: ...art profile and click Continue Note that IP address kickstarts require ranges to be defined in kickstart profiles Click Continue finish choosing from the options available on the subsequent screen and...

Page 65: ...groups are added to the System Set Manager After adding groups to the System Set Manager you can use it to perform actions on them simultaneously To add an intersection of groups select them and click...

Page 66: ...ystems tab To remove systems from groups use the Groups tab of the System Details page Refer to Section 4 4 2 6 System Details for instructions 4 4 3 3 System Group Details At the top of each System G...

Page 67: ...systems you must select systems you wish to modify Note that Update level systems cannot be selected Pages including Systems list System Search and System Groups list have a column of checkboxes unde...

Page 68: ...channels For this reason this should be done with caution Select the new base channel from the pulldown menus and click the Change Base Channels button Provisioning Options for provisioning systems K...

Page 69: ...vents By default all Management and Provisioning systems are in cluded in the summary These are actions affecting packages such as scheduled Errata Up dates and system reboots or failures to check in...

Page 70: ...e you have enough Management entitlements available If you need to purchase additional entitlements click the Buy them now link at the top of the page After auto entitling a message appears at the top...

Page 71: ...y click the delete key link in the top right corner of the edit page If you do not want a key to be used to activate a system you can disable it by unselecting the corre sponding checkbox under the En...

Page 72: ...gs of the kickstart process refer to Section 4 4 10 2 Kickstart Explained 4 4 10 2 Kickstart Explained When a machine is to receive a network based kickstart the following events must occur in this or...

Page 73: ...Kickstart Details page shows the profile name and label as well as these fields Org Default which allows you to set this as the primary profile for the organization and Comments or simple notes regar...

Page 74: ...l uses IP Addresses Identifies the IP address ranges to be presented with this kickstart profile upon request Conflicts between IP address ranges will not be allowed unless one range is a subset of an...

Page 75: ...ntify the appropriate package based upon the distribution to be kickstarted It should look something like auto kickstart ks rhel i386 as 3 Then strip everything preceding the ks to derive the boot ima...

Page 76: ...ate files on an HTTP server for deployment Once the kickstart profile has been created you may use the URL from the Kickstart Details page just as you do for CD ROM based installs To obtain specific i...

Page 77: ...o Section 4 5 2 2 Errata Details for more information 4 5 2 1 Apply Errata Updates Errata Alerts include a list of updated packages that are required to apply the Errata Update To apply Errata Updates...

Page 78: ...talled on that system If an older version of the package is installed the package will be upgraded 4 5 2 2 Errata Details If you click on the Advisory of an Errata Alert in the Relevant or All pages i...

Page 79: ...hitecture that contains extra packages needed only for the organization such as a custom engineering application A system must be subscribed to one base channel only This base channel is assigned auto...

Page 80: ...channel if it is a child channel This is the first tab you see when you click on a channel It displays essential information about the channel such as summary description and architecture In addition...

Page 81: ...ist for the substring at the beginning in the middle or at the end of the package name For example typing ks in the filter might return all the ksconfig krb5 workstation and links The filter is case i...

Page 82: ...vant ISOs page is shown by default when you click Easy ISOs in the left navigation bar It displays a list of ISOs by channel now associated with your systems Links within this list go to the Downloads...

Page 83: ...package you want to install 5 On the Package Details page click on the Target Systems tab 6 Select the entitled systems you want to install the package on 7 Click on the Install Packages button 8 Con...

Page 84: ...fig Channels The Manage Config Channels interface provides the means to create and oversee channels con taining configuration files Like software channels configuration channels store files to be inst...

Page 85: ...nel Details page will appear This page contains the following tabs Details General information about the channel This is the first tab you see when you click on a channel It displays basic information...

Page 86: ...annels for your organization To copy the latest revision of this file to channels select the appropriate checkboxes and click the Copy File button 4 7 Schedule If you click the Schedule tab on the top...

Page 87: ...represents a single scheduled event or action that might affect multiple systems and involve various packages The list contains several columns of information Select Use the checkboxes in this column...

Page 88: ...action select the system using the appropriate checkbox and click the Unschedule Action button Clicking a system name takes you to its System Details page Refer to Section 4 4 2 6 System Details for...

Page 89: ...t rhn support redhat com to have users removed RHN Satellite Server customers may use the button on the User Details page 4 8 1 2 User Details Clicking on a username displays the User Details page for...

Page 90: ...anagement Identifies channels the user may manage To change these select or unselect the appropriate checkboxes and click the Update Permissions button This status does not enable the user to create n...

Page 91: ...dify the configuration file you must as root restart the daemon with the command service rhnsd restart or etc rc d init d rhnsd restart Important The minimum time interval allowed is one hour 60 minut...

Page 92: ...Daemon is activated and running You may ensure this by running the follow ing commands chkconfig level 345 rhnsd on service rhnsd start If these are correct and your systems still indicate they are no...

Page 93: ...tion functionality built into the Red Hat Update Agent After registering your system refer to Chapter 2 Red Hat Update Agent for instructions on starting the Red Hat Update Agent and begin steps liste...

Page 94: ...the number of the item that you want to modify and enter a new value for the option When you finish changing your configuration press Enter to save your changes and exit Press q and then Enter to quit...

Page 95: ...al console or remote terminal Refer to Section 6 7 Text Mode RHN Registration Client for further details Caution You must use Python 1 5 2 24 or later with Secure Sockets Layer SSL support If not the...

Page 96: ...stration process If you click Cancel the registration process will end and no information will be sent Figure 6 4 Welcome Screen Red Hat is committed to protecting your privacy see Figure 6 5 The info...

Page 97: ...nd a valid email address In the screen shown in Figure 6 7 you must choose a username and password Once logged in to Red Hat Network you can modify your preferences view your existing System Profile o...

Page 98: ...created a System Profile you can add a new machine to your account Run the Red Hat Network Registration Client on the new machine you wish to add and enter your existing Red Hat Network username and...

Page 99: ...stem Profile After creating a username 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 Host...

Page 100: ...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 T...

Page 101: ...ncluded in your System Profile to be up dated by Red Hat Network To exclude a package uncheck the package from the list by clicking the checkbox beside the package name For example Figure 6 11 shows t...

Page 102: ...de from System Profile 6 5 Finishing Registration As seen in Figure 6 12 the last step of registration is to confirm that you want to send your System Profile to the Red Hat Network If you choose Canc...

Page 103: ...me time depending on your connection speed Figure 6 13 Send System Profile to Red Hat Network You will know your System Profile has been successfully sent when you see the Registration Fin ished scree...

Page 104: ...ction from the dropdown menu under the Entitlement column beside the name of the system you just registered Only increases in entitlement levels are allowed Systems cannot be re entitled to a lower en...

Page 105: ...s for the text mode Red Hat Network Registration Client are almost identical to the screens for the graphical Red Hat Network Registration Client Some of the text in the text mode version is more conc...

Page 106: ...96 Chapter 6 Red Hat Network Registration Client...

Page 107: ...nd verify A 1 1 Listing Config Files To list the configuration files for the machine and the labels of the config channels containing them issue the command rhncfg client list You should see output re...

Page 108: ...m No such file or directory A 1 5 Verifying Config Files To quickly determine if files are different than those associated with it in RHN issue the command rhncfg client verify You should see output r...

Page 109: ...g channel for your organization issue the command rhncfg manager create channel channel label If prompted for your RHN username and password provide them You should see output resembling Red Hat Netwo...

Page 110: ...he config files on disk and the latest revisions in a channel issue the command rhncfg manager diff channel channel label dest file path to file txt local path to file You should see output resembling...

Page 111: ...ing All Files in a Channel To download all the files in a channel to disk create a directory and issue the command rhncfg manager download channel channel label topdir You should see output resembling...

Page 112: ...name and password provide them You should see output resembling Red Hat Network username rhn user Password Removing from config channel blah3 tmp dest_path foo txt removed A 2 10 Deleting a Config Cha...

Page 113: ...el dest file path to file txt local path to file You should see output resembling Pushing to channel blah Local file blah tmp dest_path foo txt remote file tmp dest_path foo txt A 2 13 Uploading Multi...

Page 114: ...104 Appendix A Command Line Config Management Tools...

Page 115: ...makes some of the calls B 1 Using the auth Class and Getting the Session It is worth noting you will almost invariably use the auth class first This class offers a single method login Use this to esta...

Page 116: ...make the association B 6 Sample API Script The following sample script depicts how an RHN API client should be constructed Review the com ments and links for a full discussion of the calls made usr b...

Page 117: ...ems client call system list_user_systems session for my system systems print Dumper system print n nCapturing ID of system systems 0 name n n my systemid systems 0 id This next call returns a list of...

Page 118: ...108 Appendix B RHN API Access...

Page 119: ...r package B Base Channel A base channel is a type of Channel that consists of a list of packages based on a specific architecture and Red Hat Linux release For example all the packages in Red Hat Linu...

Page 120: ...the Errata description of the Errata and a list of which systems are affected by the report Enhancement Alert An Errata Alert that pertains to a package enhancement request Entitled Server A server th...

Page 121: ...r Organization Administrator are sets of users that have the highest level of control over an orga nization s Red Hat Network account Members of this group can add users systems and system groups to t...

Page 122: ...e Red Hat Update Agent Configuration Tool to configure its preferences including whether to install the packages after they are downloaded RPM A software package manager that was developed by Red Hat...

Page 123: ...the organization System ID A unique string of characters and numbers that identifies a registered system It is stored in the system s Digital Certificate System Profile Hardware and software informat...

Page 124: ...114 Glossary...

Page 125: ...s details 75 76 global 74 list of 74 Config Channels and Files Config Channel List 74 Configuration Channel List Channel Details 75 File Details 76 configuration files manage 75 quota 75 Configuration...

Page 126: ...uick Search explanation of 41 R reactivating systems 50 Red Hat Network Alert Notification Tool adding to panel 35 applying Errata Updates 37 configuring 35 icons 36 launching RHN website 37 requireme...

Page 127: ...9 System Set Manager 57 Systems Advanced Search 60 deleting 49 Entitlements 59 entitling 59 overview 46 searching 60 System Details 49 System List 46 Systems Overview 46 viewing a list of 46 viewing d...

Page 128: ...s 59 System Group List 54 System Groups 54 System List 46 System Search 60 Systems 46 Systems Overview 46 Users 78 Your Account 43 Your RHN 42 Y Your RHN 42 Account Deactivation 43 Addresses 43 Buy No...

Reviews: