background image

Red Hat Network 3.1

Provisioning Reference Guide

Содержание NETWORK 3.1 - PROVISIONING

Страница 1: ...Red Hat Network 3 1 Provisioning Reference Guide...

Страница 2: ...e 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...

Страница 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...

Страница 4: ...work 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 Softwar...

Страница 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...

Страница 6: ......

Страница 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...

Страница 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...

Страница 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...

Страница 10: ...e 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 suggestions ab...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 16: ...6 Chapter 1 What is Red Hat Network...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 38: ...2wk OZoaEtcubsNMquuLCMWijYhGBBgRAgAGBQI36lRyAAoJECGRgM3bQqYOhyYAnj7h VDY FJAGqmtZpwVp9IlitW5tAJ4xQApr jNFZCTksnI 4O1765F7tA 3AHZ END PGP PUBLIC KEY BLOCK 2 At the shell prompt import the key with the...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 48: ...38 Chapter 3 Red Hat Network Alert Notification Tool...

Страница 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...

Страница 50: ...s of 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 k...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 60: ...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 cubicle key w...

Страница 61: ...ackages as tar files select them and click the Download Packages button Refer to Section 4 6 5 2 Package Download for details Install Enables you to install new packages on the system from the availab...

Страница 62: ...stem verify Identify any differences between configuration files on the system and those associ ated with it in the central repository diff Display differences between configuration files on the syste...

Страница 63: ...es on the provided subtabs When satisfied with the reversion return to the Rollback subtab and click the Rollback to Snapshot button To see the list again click Return to snapshot list Snapshot Tags P...

Страница 64: ...g This list is automatically generated To view details of an event click its summary in the System History table To again view the table click Return to history list at the bottom of the page Pending...

Страница 65: ...roup or confirms that it is up to date Clicking on a group s status icon takes you to the Errata tab of its System Group Details page Refer to Section 4 4 3 3 System Group Details for more information...

Страница 66: ...Set Manager immediately Refer to Section 4 4 4 System Set Man ager for more information The System Group Details page contains five tabs Details Basic information about the system group the group name...

Страница 67: ...e Group in the System Groups list or Work with Group on the System Group Details page to work with a predefined system group The System Set Manager page contains a set of tabs Overview Description of...

Страница 68: ...tem snapshots enter a descriptive term in the Tag name field and click the Tag Current Snapshots button Rollback Use this subtab to rollback selected Provisioning entitled systems to previous snap sho...

Страница 69: ...itled subscribed to an RHN service level Use the System Entitlements page to configure which systems are entitled to which service offerings There are three primary types of entitlements Update should...

Страница 70: ...identify whether you wish to query all systems or only those loaded in the System Set Manager and click the Search button Yo may also select the Invert Result checkbox to reverse your results list The...

Страница 71: ...System Details page Those profiles end up here on the Stored Profiles page where they may be edited and even deleted To edit a profile click its name in the list alter its name and description and cli...

Страница 72: ...n or removal of specific software packages from the kickstart pro file To include packages enter them in the text field and click the Add Packages button To exclude packages select their checkboxes an...

Страница 73: ...ke the profile association in the GPG and SSL keys subtab of the Kickstart Details page To develop a new key certificate click create new cryptokey in the upper right corner of the page Enter a descri...

Страница 74: ...nt boot messages shorter timeout periods etc Then make the ISO as described in the Making an Installation Boot CD ROM section of the Red Hat Enterprise Linux 3 Installation Guide Or by issuing the com...

Страница 75: ...PM packages required to fix the problem Icons are used to identify the three types of Errata Alerts Security Updates available update strongly recommended Bug Fix Updates available and recommended Enh...

Страница 76: ...tems tab of the Errata Details page Then individually select the systems to be updated and click the Apply Errata button Double check the systems to be updated on the confirmation page then click the...

Страница 77: ...search through Errata according to specific criteria such as summary advisory and package name Type your keyword select the criterion to search by and click the Search button The results appear at th...

Страница 78: ...shown in Figure 4 6 the Relevant Channels page is shown by default when you click Software Channels in the left navigation bar It displays a list of channels now associated with your systems Links wi...

Страница 79: ...access to all channels Errata List of Errata affecting the channel The list displays advisory types names summaries and the dates issued Clicking on an advisory name takes you to its Errata Details p...

Страница 80: ...ers To download an ISO image Red Hat recommends copying its URL and using either curl or wget Click the help on using curl or wget link for precise instructions To obtain the URL right click on the di...

Страница 81: ...pdated on that system Important If you use scheduled package installation the packages will be installed via the RHN Daemon You must have the RHN Daemon enabled on your systems Refer to Chapter 5 Red...

Страница 82: ...cluding the package description size and version This information is similar to issuing the command rpm qi packagename but with more detail Click the links in the bottom right hand corner of the page...

Страница 83: ...ys system specific configuration channels and works similarly to the Global Config Channels page in that clicking the name of a system takes you to the List subtab of the Configuration Channel Details...

Страница 84: ...u click on the name or number of a file in a list the Configuration File Details page will appear You may remove the file at anytime by clicking delete file in the upper right corner of the page This...

Страница 85: ...profile refresh go to a system list under the Systems category click on the name of the system click the Hardware tab of the System Details page and click the Schedule Hardware Refresh button 4 Packa...

Страница 86: ...Earliest The earliest day and time the action will be performed Succeeded Number of systems on which this action was successful Failed Number of systems on which this action has been tried and failed...

Страница 87: ...the user If you click on a username the User Details page for the user is displayed Refer to Section 4 8 1 2 User Details for more information Real Name The full name of the user last name first Roles...

Страница 88: ...user to capture all systems registered by that user To do this select the default group or groups from the dropdown menu at the bottom of the page Then click the Update Defaults button An asterisk app...

Страница 89: ...one Set your time zone so that scheduled actions are arranged according to the time in your time zone Red Hat Contact Options Identify what ways email phone fax or mail Red Hat may contact you To modi...

Страница 90: ...80 Chapter 4 Red Hat Network Website...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 106: ...96 Chapter 6 Red Hat Network Registration Client...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 114: ...104 Appendix A Command Line Config Management Tools...

Страница 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...

Страница 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...

Страница 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...

Страница 118: ...108 Appendix B RHN API Access...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 124: ...114 Glossary...

Страница 125: ...s details 73 74 global 73 list of 72 Config Channels and Files Config Channel List 72 Configuration Channel List Channel Details 73 File Details 74 configuration files manage 73 quota 73 Configuration...

Страница 126: ...k Alert Notification Tool adding to panel 35 applying Errata Updates 37 configuring 35 icons 36 launching RHN website 37 requirements 35 with a proxy server 36 Red Hat Network Configuration Client rhn...

Страница 127: ...46 searching 60 System Details 49 System List 46 Systems Overview 46 viewing a list of 46 viewing details for 49 systems list status 46 Systems Selected explanation of 41 U unsubscribe to channel 67 u...

Страница 128: ...earch 60 Systems 46 Systems Overview 46 Users 77 Your Account 43 Your RHN 42 Y Your RHN 42 Account Deactivation 43 Addresses 43 Buy Now 44 Email 43 Help 44 Purchase History 44 Your Account 43 Your Pre...

Отзывы: