manualshive.com logo in svg

Red Hat NETWORK SATELLITE 5.1.0 - CHANNEL MANAGEMENT, Reference Manual

Share
Download
Red Hat NETWORK SATELLITE 5.1.0 - CHANNEL MANAGEMENT Reference Manual Download Page 175

12.8. Client Configuration Guide

Documentation for setting up clients to connect to an RHN Proxy or Satellite server.

12.9. Channel Management Guide

Documentation for the creation and maintenance of custom channels using RHN.

12.10. API

Documentation for using the Red Hat Network Application Programming Interface (API) for

creating tools and programs to automate common tasks via Red Hat Network.

The API page contains an overview of the API, with links to detailed descriptions of various API

calls available to administrators and developers. There is also an FAQ page for answers to

common questions about the Red Hat Network API. Finally, there is a Sample Scripts page

that shows users example code using API calls.

Channel Management Guide

161

Summary of Contents for NETWORK SATELLITE 5.1.0 - CHANNEL MANAGEMENT

Page 1: ...Red Hat Network Satellite Reference Guide 5 1 0 5 1 ISBN Publication date ...

Page 2: ...Red Hat Network Satellite ...

Page 3: ...e copyright holder Distribution of the work or derivative of the work in any standard paper book form for commercial purposes is prohibited unless prior permission is obtained from the copyright holder Red Hat and the Red Hat Shadow Man logo are registered trademarks of Red Hat Inc in the United States and other countries All other trademarks referenced herein are the property of their respective ...

Page 4: ...Red Hat Network Satellite ...

Page 5: ...e Version 25 3 1 Installing the Red Hat GPG key 28 3 2 Manual Package Installation 29 3 3 Synchronizing Your System Profile 30 3 4 Log File 30 4 Configuration 30 4 1 Using the Red Hat Update Agent Configuration Tool 30 4 2 Command Line Version 34 5 Registering with Activation Keys 35 6 Registering a System to an Organization 37 3 Red Hat Network Daemon 39 1 Configuring 39 2 Viewing Status 39 3 Dis...

Page 6: ...our RHN 68 3 1 Your Account 70 3 2 Your Preferences 71 3 3 Locale Preferences 72 3 4 Subscription Management 72 4 Systems 74 4 1 Overview 74 4 2 Systems 74 4 3 System Groups 93 4 4 System Set Manager 96 4 5 Advanced Search 103 4 6 Activation Keys 103 4 7 Stored Profiles 106 4 8 Custom System Info 107 4 9 Kickstart 107 5 Errata 119 5 1 Relevant Errata 120 5 2 All Errata 121 5 3 Advanced Search 123 ...

Page 7: ...nfig Push 153 10 5 General Config 153 11 Satellite Tools 154 11 1 Satellite Tools Organizations 154 11 2 Satellite Tools Satellite Configuration 158 12 Help 160 12 1 Help Desk 160 12 2 RHN Security 160 12 3 Lookup Login Password 160 12 4 Release Notes 160 12 5 Reference Guide 160 12 6 Satellite Installation Guide 160 12 7 Proxy Guide 160 12 8 Client Configuration Guide 161 12 9 Channel Management ...

Page 8: ...ion Your Guest Systems 183 3 Working With Your Virtual Systems 184 3 1 Logging into Virtual Systems Directly via SSH 184 3 2 Gaining Console Access Via the Host 185 3 3 Installing Software Via the Satellite Web Interface 185 3 4 Installing Software Via Yum From the Virtual System 186 3 5 Deleting Virtual Systems 186 9 UNIX Support Guide 189 1 Introduction 189 1 1 Supported UNIX Variants 189 1 2 Pr...

Page 9: ...from a Channel 216 3 10 Deleting a Config Channel 216 3 11 Determining the Number of File Revisions 217 3 12 Updating a File in a Channel 217 3 13 Uploading Multiple Files at Once 218 B RHN API Access 219 1 Using the auth Class and Getting the Session 219 2 Obtaining the system_id 219 3 Determining the sid 219 4 Viewing the cid 219 5 Getting the sgid 220 6 Channel Labels 220 7 Sample API Script 22...

Page 10: ...sibility 246 7 2 MySQL Opened Tables 247 7 3 MySQL Open Tables 247 7 4 MySQL Query Rate 248 7 5 MySQL Threads Running 248 8 Network Services 249 8 1 Network Services DNS Lookup 249 8 2 Network Services FTP 249 8 3 Network Services IMAP Mail 250 8 4 Network Services Mail Transfer SMTP 251 8 5 Network Services Ping 251 8 6 Network Services POP Mail 252 8 7 Network Services Remote Ping 253 8 8 Networ...

Page 11: ... 266 10 2 RHN Satellite Server Execution Time 267 10 3 RHN Satellite Server Interface Traffic 267 10 4 RHN Satellite Server Latency 267 10 5 RHN Satellite Server Load 268 10 6 RHN Satellite Server Probe Count 268 10 7 RHN Satellite Server Process Counts 269 10 8 RHN Satellite Server Processes 269 10 9 RHN Satellite Server Process Health 270 10 10 RHN Satellite Server Process Running 271 10 11 RHN ...

Page 12: ...xii ...

Page 13: ...in HTML and PDF formats at http www redhat com docs manuals RHNetwork This version of the manual covers version 4 4 5 of the Red Hat Enterprise Linux 3 and 4 Red Hat Update Agent and versions 2 9 14 and 2 9 12 of the Red Hat Enterprise Linux 2 1 Red Hat Update Agent and Red Hat Network Registration Client respectively Warning Systems running Red Hat Enterprise Linux 2 1 must use the Red Hat Networ...

Page 14: ...atellite Reference Guide RHN Satellite Installation Guide RHN Client Configuration Guide RHN Channel Management Guide and RHN Satellite Release Notes Translated documentation is available at http rhn redhat com help 1 1 Send in Your Feedback If you would like to make suggestions about the Red Hat Network Reference Guide please submit a report in Bugzilla http bugzilla redhat com bugzilla against t...

Page 15: ...s the Red Hat Update Agent the Red Hat Network website whether this is hosted by the central RHN Servers an RHN Satellite Server or fed through an RHN Proxy Server Red Hat Network Daemon the Red Hat Network Registration Client for systems running Red Hat Enterprise Linux 2 1 only The Red Hat Update Agent up2date provides your initial connection to Red Hat Network Red Hat Enterprise Linux 3 and new...

Page 16: ...e service is ideal for a user with one Red Hat Enterprise Linux system or a small number of Red Hat Enterprise Linux systems Updated Subscription to Update can be purchased at https www redhat com apps commerce rhn With each Update subscription you receive the following services Download Software For customers who have purchased subscriptions to Red Hat Network ISO images are available for immedia...

Page 17: ... Red Hat Network features available to you depend on the subscription level for each Red Hat Enterprise Linux system With each Management subscription you receive the functionality provided to Update users plus Package Profile Comparison Compare the package set on a system with the package sets of similar systems with one click Search Systems Search through systems based on a number of criteria pa...

Page 18: ...Satellite Snapshot Rollbacks Provisioning level users have the ability to revert the package profile and RHN settings of systems RHN Satellite Server customers can also roll back local configurations files This is possible because snapshots are captured whenever an action takes place on a system These snapshots identify groups channels packages and configuration files Custom System Information Pro...

Page 19: ...nt halted or sent to an additional recipient for a specified time based on probe criteria notification method scout or organization 5 Errata Notifications and Scheduled Package Installations You can configure Red Hat Network to send you email notifications of new and updated software packages as soon as the packages are available through RHN You receive one email per Erratum regardless of the numb...

Page 20: ...wever if you chose not to install them during the installation process you must obtain the Red Hat Update Agent up2date and possibly the Red Hat Network Registration Client rhn_register In Red Hat Enterprise Linux 3 and later registration functionality is built into the Red Hat Update Agent while Red Hat Enterprise Linux 2 1 users will need the Red Hat Network Registration Client Warning The SSL c...

Page 21: ...egistration Client If you prefer to use the command line versions the two packages ending in gnome are not required 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 Pr...

Page 22: ...8 ...

Page 23: ...date Agent Refer to Chapter 5 Red Hat Network Registration Client for instructions then return to this chapter for Red Hat Update Agent instructions Important You must use Red Hat Update Agent Version 2 5 4 or higher to upgrade your kernel automatically It installs the updated kernel and configures LILO or GRUB to boot the new kernel the next time the system is rebooted To ensure that you are runn...

Page 24: ...uctions d download Download packages only do not install them This argument temporarily overrides the configuration option Do not install packages after retrieval Use this option if you prefer to install the packages manually f force Force package installation This option temporarily overrides the file package and configuration skip lists i install Install packages after they are downloaded This a...

Page 25: ...password select the Use Authentication checkbox and enter your username and password in the respective text fields An HTTP Proxy Server is not required by Red Hat Network If you do not want to use this feature click the OK button without making any selections Note that the Red Hat Network Server dropdown menu at the top of the dialog box is only useful to RHN Proxy and Satellite customers These cu...

Page 26: ...ortant If your username is part of a larger organizational account you should take caution when registering systems By default all systems registered with the Red Hat Update Agent end up in the Ungrouped section of systems visible only to Satellite Administrators To ensure you retain management of these systems Red Hat recommends that your organization create an activation key associated with a sp...

Page 27: ...ad Red Hat s privacy statement from this screen Click the Read our Privacy Statement button to do so Red Hat is committed to protecting your privacy The information gathered during the registration process is used to create a System Profile which is essential to receiving update notifications about your system When finished click OK Those users that have created a Red Hat login previously may ente...

Page 28: ...ate one radio button and click the Forward button Add details about yourself and your business to the screen shown in Figure 2 5 Create a User Account and identify the methods by which you may be reached Your username has the following restrictions Cannot contain any spaces Cannot contain the characters or Is not case sensitive thereby eliminating the possibility of duplicate usernames differing o...

Page 29: ...see an error message Try different usernames until you find one that has not been used Complete all fields marked by an asterisk The address and email addresses are required so that Red Hat may communicate with you regarding your account You may select to receive monthly copies of Red Hat Magazine a valuable source of tips insights and Red Hat news When finished click Forward Figure 2 5 Create a U...

Page 30: ... CPU model CPU speed Amount of RAM PCI devices Disk sizes Mount points The software System Profile consists of a list of RPM packages for which you wish to receive notifications The Red Hat Update Agent displays 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 To see the details of the information gathered from y...

Page 31: ... 2 6 Activate Figure 2 7 Sending System Profile to Red Hat Network shows the progress bar displayed as the System Profile is sent Figure 2 7 Sending System Profile to Red Hat Network 2 3 Channels Channels 17 ...

Page 32: ... Extras channel in the figure you may select them as well Additional information regarding the selected channel is displayed in the Channel Information pane When finished click Forward to continue Figure 2 8 Channels Red Hat Update Agent now compares the packages in your RPM database with those available from the Channel you selected The progress bar shown in Figure 2 9 Fetching package list is di...

Page 33: ...estarts and completes the initial update of the system 2 4 Packages Flagged to be Skipped The next step in the initial update is the selection of files to be skipped Any packages checked here will not be downloaded and updated by the Red Hat Update Agent This screen is displayed whenever packages are available that are currently selected to be ignored You may change these settings at any time from...

Page 34: ... you chose to skip in the previous screen Select those you wish to download and click Forward to continue To view the complete Errata Advisory text for an update highlight the relevant package and click the View Advisory button When finished click OK Select those you wish to download and click Forward to continue Chapter 2 Red Hat Update Agent 20 ...

Page 35: ...Figure 2 11 Available Package Updates Available Package Updates 21 ...

Page 36: ...et If any additional packages are required Red Hat Update Agent displays an error message Click OK to continue Once all dependencies are met Red Hat Update Agent retrieves the packages from RHN As the packages are downloaded they are temporarily stored in var spool up2date When all packages have been downloaded click Forward to continue Chapter 2 Red Hat Update Agent 22 ...

Page 37: ...nt skip to Section 3 2 Manual Package Installation for further instructions If you configured the Red Hat Update Agent to install the packages the default setting the installation process begins The progress of installing each package as well as the total progress is displayed When the packages have been installed as seen in Figure 2 14 Installing Packages click Forward to continue Installing Pack...

Page 38: ... Hat Update Agent has finished downloading the desired packages and installing them if you chose the install option it displays the screen in Figure 2 15 All Finished Click Finish to exit the Red Hat Update Agent Chapter 2 Red Hat Update Agent 24 ...

Page 39: ... can force it not to display the graphical interface with the following command up2date nox The command line version 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 downloads the newer packages and installs them if you configured it to do so up2date ...

Page 40: ...ng dependencies and other requirements prior to actual installation f force Force package installation This option temporarily overrides the file package and configuration skip lists firstboot Pop up in the center of the screen for Firstboot get Fetch the package specified without resolving dependencies get source Fetch the source package specified without resolving dependencies gpg flags Show the...

Page 41: ...ch to retrieve packages showall List all packages available for download show available List all packages available that are not currently installed show channels Show the channel name associated with each package show orphans List all packages currently installed that are not in channels to which the system is subscribed show package dialog Show the package installation dialog in GUI mode solvede...

Page 42: ...and line version the first time you start Red Hat Update Agent you must 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 public key Without it you will be unable to verify that packages Update Agent downloads are securely signed by Red Hat Note GPG keys must be installed for each user To instal...

Page 43: ... ZMAPJWTs2bB 0QaXxUgWlwW84GVf2rA6RSbvMLTbDjTH8t7J1RGP9zAqu8SgraTA QbQdao6TNxVt ohGBBMRAgAGBQI 3LjCAAoJECGRgM3bQqYOf5MAoIjiJDe hDOj 9 jlR0qDs9lIi C2AJ9SBBfd4A8hyR4z3lY7e0LzjWF51LkCDQQ7 9O3EAgA8tMs xdUmuTfA X78fMXh7LCvrL4Hi28CqvNM Au81XJjDLNawZvpVmFlMmd9h0Xb5Jt2 BZWLR13rcDUByNdw1EWhVAzCz6Bp9Z3MIDhcP00iIBctIHn7YP9fi5vV0G03iryT XE01mhWoBlC233wr3XHwsqxFfZzaCZqqNKTl0 PNfEAIzJRgtYiW8nzFTPpIR05E oRn6EvmQf...

Page 44: ...r log up2date It uses the standard rotating log method Thus older logs are in var log up2date 1 var log up2date 2 and var log up2date 3 The log files store actions performed by the Red Hat Update Agent such as when your RPM database is opened when it connects to Red Hat Network to retrieve information from your System Profile which packages are downloaded which packages are installed using the Red...

Page 45: ...xt field Additionally if your proxy server requires a username and password select the Use Authentication option and enter your username and password in the respective text fields Figure 2 16 General Settings In addition RHN Proxy and Satellite customers have the option of selecting Red Hat Network Servers here These customers should refer to the RHN Client Configuration Guide for detailed instruc...

Page 46: ...rieval options can be selected see Figure 2 17 Retrieval Installation Settings Do not install packages after retrieval download selected RPM packages to the desired directory and ignore the installation preferences Do not upgrade packages when local configuration file has been modified if the configuration file has been modified for a package such as apache or squid do not attempt to upgrade it Th...

Page 47: ...ult location is var spool up2date 4 1 3 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 2 18 Package Exceptions Settings To define a set of packages to be excluded according to the package name enter a character string including wild cards in the Add new...

Page 48: ...t Update Agent Configuration Tool use the following command up2date nox configure You are presented with a list of options and their current values 0 debug No 1 isatty Yes 2 depslist 3 networkSetup Yes 4 retrieveOnly No 5 enableRollbacks No 6 pkgSkipList kernel 7 storageDir var spool up2date 8 adminAddress root localhost 9 noBootLoader No 10 serverURL https xmlrpc rhn redhat com XMLRPC 11 fileSkip...

Page 49: ...he protocol for serverURL from https to http in the etc sysconfig rhn up2date configuration file 5 Registering with Activation Keys In addition to the standard Red Hat Update Agent interface up2date offers a utility aimed at batch processing system registrations activation keys Each unique key can be used to register Red Hat Enterprise Linux systems entitle them to an RHN service level and subscri...

Page 50: ...ce to understand how differences in activation keys are handled The above command performs all the actions of the Red Hat Network Registration Client and the registration function of the Red Hat Update Agent Do not run either of these applications for registration after running rhnreg_ks A System Profile including software and hardware information is created for the system and sent to the RHN Serv...

Page 51: ...thout any effect on the systems it was used to register 6 Registering a System to an Organization RHN Satellite Server now supports the Organizations feature which allows administrators to appropriate software and system entitlements across various organizations as well as control an organization s access to systems management Systems can now be registered directly to an organization To register a...

Page 52: ...38 ...

Page 53: ...urs 240 minutes If you modify 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 minutes If you set the interval below one hour it will default to four hours 240 minutes 2 Viewing Status You can view the status of the rhnsd by typing the command service rhnsd s...

Page 54: ... Daemon is activated and running You may ensure this by running the following commands chkconfig level 345 rhnsd on service rhnsd start If these are correct and your systems still indicate they are not checking in please contact our technical support team Chapter 3 Red Hat Network Daemon 40 ...

Page 55: ...ol appears on the panel by default as shown in Figure 4 1 GNOME Panel with Red Hat Network Alert Notification Tool Figure 4 1 GNOME Panel with Red Hat Network Alert Notification Tool If it does not appear on the panel you can add it In Red Hat Enterprise Linux 3 and later select Applications the main menu on the panel System Tools Red Hat Network Alert Icon To ensure the icon appears on subsequent...

Page 56: ... username and password select the Use Authentication option and enter your username and password in the respective text fields Tip To run the configuration wizard again right click on the applet and select Configuration Your preferences are written to the rhn applet conf file in your home directory The Red Hat Network Alert Notification Tool also uses the system wide configuration file etc sysconf...

Page 57: ...pdates Error has occurred Table 4 1 Red Hat Network Alert Notification Tool Icons If you see the icon it is strongly recommended that you apply the updates Refer to Section 4 Applying Updates for information on applying updates If you have scheduled updates to be installed you can watch the applet icon to determine when updates are applied The icon changes to the icon after the Errata Updates are ...

Page 58: ... Hat Update Agent click on the applet and then click on the Launch up2date button You can also right click on the icon and select Launch up2date For more information on the Red Hat Update Agent refer to Chapter 2 Red Hat Update Agent 5 Launching the RHN Website The simplest way to obtain a comprehensive view of your system s status is to access the RHN website This can be accomplished through the ...

Page 59: ...ing Red Hat Enterprise Linux 3 and later have this registration 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 1 Configuring the Red Hat Network Registration Client To start the graphical interface for configuring the application to connect through an HTTP proxy server typ...

Page 60: ...dhat com XMLRPC 2 oemInfoFile etc sysconfig rhn oeminfo 3 enableProxy No 4 networkSetup Yes 5 httpProxy 6 proxyUser 7 serverURL https xmlrpc rhn redhat com XMLRPC 8 proxyPassword 9 debug No Enter number of item to edit return to exit q to quit without saving Enter the number of the item to modify and enter a new value for the option When finished changing your configuration press Enter to save you...

Page 61: ...nizational account be cautious when registering your systems By default all systems registered with the Red Hat Network Registration Client end up in the Ungrouped section of systems visible only to Satellite Administrators To ensure that you retain management of these systems Red Hat recommends that your organization create an activation key associated with a specific system group and grant you p...

Page 62: ...er If you have already registered your system and try to register it again the dialog box shown in Figure 5 3 Warning This System Already Registered appears If you continue it overwrites your existing Digital Certificate file etc sysconfig rhn systemid and creates a different System Profile You will no longer be able to use your previous System Profile be sure this is what you want to do before yo...

Page 63: ...tration process If you click Cancel the registration process ends and no information is sent Figure 5 4 Welcome Screen Red Hat is committed to protecting your privacy see Figure 5 5 Red Hat Privacy Statement The information gathered during the 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 yo...

Page 64: ...ate a Unique Username and Password you must choose a username and 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 You must choose a unique username If you enter one already in use you will see an error message see Figure 5 6 Error Username Already Exists Try different usernames until you fin...

Page 65: ...bility of duplicate usernames differing only by capitalization In addition the following restrictions apply to both your username and password Must be at least four characters long Cannot contain any tabs Cannot contain any line feeds Passwords are case sensitive for obvious reasons If you have already registered a machine and created a System Profile you can add a new machine to your account Run ...

Page 66: ... provided text fields If the values are valid the system is added to the organization s Red Hat Network account Your Satellite Administrator can then create your user account through the Users category of the RHN website Refer to Section 9 Users for instructions Click Next to continue 4 Registering a System Profile Now that you have a user account you can create a System Profile that consists of h...

Page 67: ...for your system as shown in Figure 5 8 System Profile Hardware The default value is the hostname for the system You may modify this to be a more descriptive string such as Email Server for Support Team Optionally you can enter a computer serial or identification number for the system If you do not wish to include information about your hardware or network in your System Profile deselect Include in...

Page 68: ...rt of the registration are included in your System 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 modified through the Red Hat Network website or by using the Red Hat Update Agent Figure 5 9 Registration Wizard show...

Page 69: ...ormation 4 2 2 Choosing RPM Packages to Exclude from the System Profile By default all RPM packages in your RPM database are included in your System Profile to be updated 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 5 11 Choose which RPM Packages to Exclude from System Profile shows that the procmail p...

Page 70: ... System Profile 5 Finishing Registration As seen in Figure 5 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 is sent Clicking Next submits your RHN System Profile Chapter 5 Red Hat Network Registration Client 56 ...

Page 71: ...igure 5 13 Send System Profile to Red Hat Network The Red Hat Network Registration Client displays the Registration Finished screen Figure 5 14 Registration Finished once your System Profile has been sent successfully Click Finish to exit the Red Hat Network Registration Client After completing the registration you must entitle your system to an RHN service level Refer to Section 6 Entitling Your ...

Page 72: ...he System Entitlements page displays the following items a list of the system for which the user can choose an entitlement level the current entitlements applied to each of these systems buttons that allow the user to change entitlement level an overview of the number and types of purchased entitlements that remain available to the organization To change the entitlement level of a system or system...

Page 73: ...s in text mode 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 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 are equal n...

Page 74: ...Figure 5 15 Text Mode Welcome Screen Chapter 5 Red Hat Network Registration Client 60 ...

Page 75: ...customers see the Monitoring and Satellite Tools tabs Figure 6 1 Top Navigation bar RHN Satellite Server The Left Navigation Bar is divided into pages The links are context sensitive and may vary slightly between RHN Satellite Server and non Satellite web interfaces The following is an example of the Left Navigation Bar for the Users tab Figure 6 2 Left Navigation Bar Users Some pages have sub tab...

Page 76: ...itlement Regardless each tab is identified separately 1 2 Categories and Pages This section summarizes all of the categories and primary pages those linked from the top and left navigation bars within the RHN website It does not list the many subpages tabs and subtabs accessible from the left navigation bar and individual pages Each area of the website is explained in detail later in this chapter ...

Page 77: ... as name hardware devices system info networking packages and location Activation Keys Generate an activation key for an RHN entitled system This activation key can be used to grant a specified level of entitlement or group membership to a newly registered system with the rhnreg_ks command Stored Profiles View system profiles used to provision systems Custom System Info Create and edit system info...

Page 78: ...ration Files List and create files from which systems receive configuration input Systems List the systems that have RHN managed configuration files Schedule Keep track of your scheduled actions Pending Actions List scheduled actions that have not been completed Failed Actions List scheduled actions that have failed Completed Actions List scheduled actions that have been completed Completed action...

Page 79: ...tellite Server Task Engine Status configures the daemon that runs on the Satellite server itself and performs routine operations such as database cleanup Errata mailings and other tasks that are performed in the background 1 3 Errata Alert Icons Throughout Red Hat Network you will see three Errata Alert icons represents a Security Alert represents a Bug Fix Alert represents an Enhancement Alert In...

Page 80: ...below the column Each time the Systems Selected tool at the top of the page changes to reflect the new number of systems ready for use in the System Set Manager Refer to Section 4 4 System Set Manager for details 1 6 Lists The information within most categories is presented as lists These lists have some common features for navigation For instance you can navigate through virtually all lists by cl...

Page 81: ...om and complete the username and password fields with the same information established during registration Once complete press the Log In button to continue Tip You may click the Sign In tab at the top of the screen to display the fields if they are not already visible If you have not previously accepted the RHN Site Terms and the T7 agreement you will be asked to do so now before proceeding To re...

Page 82: ...nto the web interface of Red Hat Network the first page to appear is Your RHN This page contains important information about your systems including summaries of system status actions and Errata Alerts Tip If you are new to the RHN web interface it is recommended that you read Section 1 Navigation to become familiar with the layout and symbols used throughout the interface Chapter 6 Red Hat Network...

Page 83: ...ts the most common tasks that an administrator performs via the web Click on any of the links to be taken to the page within RHN that allows you to accomplish that task To the right is the Inactive System listing If any systems have not been checking in to RHN they are listed here Highlighting them in this way allows an administrator quickly select those systems for troubleshooting Customers with ...

Page 84: ...nd to those errata that apply to your systems The System Groups section lists the groups if any and indicates whether the systems in those groups are fully updated Click on the link below this section to be taken to the System Groups page from which you can chose System Groups to use with the System Set Manager The Recently Registered Systems lists the systems that have been added to the Satellite...

Page 85: ...eactivate your account 3 2 Your Preferences The Your Preferences page allows you to configure Red Hat Network options including Email Notifications Determine whether you want to receive email every time an Errata Alert is applicable to one or more systems in your RHN account Important This setting also enables Management and Provisioning customers to receive a daily summary of system events These ...

Page 86: ...ntitlements Update manages a single Red Hat Enterprise Linux system It includes Errata Alerts Scheduled Errata Updates Package Installation and the Red Hat Update Agent Management manages multiple systems with multiple system administrators In addition to the features of the Update offering it includes system group management user management and the System Set Manager interface to quickly perform ...

Page 87: ...ou to adjust your Red Hat Network infrastructure as your organization grows and changes To enable the base entitlement select the checkbox to the left of the system then click the Set to Management Entitled button For add on entitlements select the system s checkbox followed by the desired entitlement from the drop down box and finally press the Add Entitlement button If clicking on an entitlement...

Page 88: ...f the channel opens a page that displays information about the channels associated with that channel entitlement Clicking on the number of entitled systems displays a list of the systems so entitled 4 Systems If you click the Systems tab on the top navigation bar the Systems category and links appear The pages in the Systems category allow you to select systems so that you can perform actions on t...

Page 89: ...y to the Update Confirmation page Also the Not Checking In icon is linked to instructions for resolving the issue System is up to date Critical Errata available update strongly recommended Updates available and recommended System is locked Actions prohibited System is being kickstarted Updates have been scheduled System not checking in properly for 24 hours or more System not entitled to any updat...

Page 90: ...or more information Entitlement Whether or not the system is entitled and at what service level Links in the left navigation bar below Systems enable you to select and view predefined sets of your systems All of the options described above can be applied within these pages 4 2 1 All The All page contains the default set of your systems It displays every system you have permission to manage A user ...

Page 91: ...e Red Hat Update Agent connects to RHN to see if there are any updates available or if any actions have been scheduled this is considered a check in If you are seeing a message indicating checkins are not taking place the RHN client on your system is not successfully reaching Red Hat Network for some reason This indicates The system is not entitled to any RHN service System Profiles that remain un...

Page 92: ...rom here you may modify the displayed information or remove the system altogether by clicking the delete system link on the top right corner Note The delete system link in the upper right of this screen refers to the system profile only Deleting a host system profile will not destroy or remove the registration of guest systems Deleting a guest system profile does not remove it from the list of gue...

Page 93: ...ur system in relation to RHN Note If updates are available for any entitled system the message Critical updates available appears To apply these updates click the update now link system ID A unique identifier generated each time a system registers with RHN Note The system ID can be used to eliminate duplicate profiles from RHN Compare the system ID listed on this page with the information stored o...

Page 94: ...eduled for locked systems through the web interface until the lock is removed manually This does not include preventing auto errata updates scheduled through the web interface To prevent the application of auto errata updates de select Auto Errata Update from the System Details Details Properties subtab Locking a system can help to prevent you from accidentally making any changes to a system until...

Page 95: ...at the task begins immediately instead of waiting the set interval In addition to the configuration of the Satellite each client system to receive pushed actions must have the osad package installed and its service started Refer to the Enabling Push to Clients section of the RHN Satellite Server 5 1 0 Installation Guide for details Subscribed Channels Base Channel The first line indicates the base...

Page 96: ... text you choose then click the Update Properties button to confirm 4 2 9 1 2 System Details Details Properties This subtab allows you to alter the following basic properties of your system Profile Name By default this is the hostname of the system You can however alter the profile name to anything that allows you to distinguish this profile from others Base Entitlement Select a base channel for t...

Page 97: ...system is stored To confirm any changes to these fields click the Update Properties button Note Many of these properties can be set for multiple systems at once through the System Set Manager interface Refer to Section 4 4 System Set Manager for details 4 2 9 1 3 System Details Details Remote Command This subtab allows you to run a remote command on the system if the system possesses a Provisionin...

Page 98: ...ecific activation key created here to re register the system and return its other RHN settings For this reason you should not regenerate delete or use this key with rhnreg_ks while a profile based kickstart is in progress If you do the kickstart will fail 4 2 9 1 5 System Details Details Hardware This subtab provides detailed information about the system including networking BIOS storage and other...

Page 99: ... Satellite refer to the RHN Satellite Installation Guide 4 2 9 2 System Details Software This tab and its accompanying subtabs allow you to manage the software of the system errata packages and package profiles and software channel memberships 4 2 9 2 1 System Details Software Errata This subtab contains a list of Errata Alerts applicable to the system Refer to Section 1 3 Errata Alert Icons for m...

Page 100: ...on the latest package name to view its Package Details page To upgrade packages immediately select them and click the Upgrade Packages button To download the packages as a tar file select them and click the Download Packages button Install Enables you to install new packages on the system from the available channels Click on the package name to view its Package Details page To install packages sel...

Page 101: ...k a channel name to view its Channel Details page To modify the child channels associated with this system use the checkboxes next to the channels and click the Change Subscriptions button You will receive a success message or be notified of any errors To change the system s base channel select the new one from the pulldown menu and click the Modify Base Channel button Refer to Section 6 1 Softwar...

Page 102: ...ble to this system only Overrides If this configuration file overrides another the overridden file is listed in this column along with its host channel If you wish to deploy any of these files to the client system overwriting any changes that have been made locally check the box to the left of the file and click the Deploy Configuration button On the following screen choose a deployment time and c...

Page 103: ...e its files take precedence over files on lower ranked channels for example the higher ranked channel may have an httpd conf file that will take precedence over the file on lower ranked channel 4 2 9 3 5 System Details Configuration Local Overrides This subtab displays the default configuration files for the system and allows you to manage them If no files exist you may use the add files upload fi...

Page 104: ...e not created any profiles refer to Section 4 9 3 Create a New Kickstart Profile before scheduling a kickstart for a system Session Status If you have scheduled a kickstart this subtab shows the progress of the kickstart The provided details include the kickstart profile used its state the next action and the number of requested packages Kickstarts that do not complete within approximately two hou...

Page 105: ...heir checkboxes click Remove Tags and confirm the action 4 2 9 5 System Details Virtualization This is tab allows you to create a new virtual guest on a host system or allows you to change the status of virtual guests The Virtualization tab has two subtabs Details and Kickstart These tabs appear the same for both virtual hosts and guests but the functionality only makes sense for virtual hosts It ...

Page 106: ...click the create new probe link at the top right corner of the page and complete the fields on the following page Refer to Section 5 1 Managing Probes for detailed instructions Once the probe has been added you must reconfigure your Monitoring infrastructure to recognize it Refer to Section 10 4 Scout Config Push for details After the probe has run its results become available on the Current State...

Page 107: ...t action Instead a checkbox appears next to the prerequisite action canceling the prerequisite action causes the action in question to fail Actions can be chained in this manner so that action a requires action b which requires action c Action c is the first one attempted and has a checkbox next to it until it is completed successfully if any action in the chain fails the remaining actions also fa...

Page 108: ...excluding those systems that belong only to one or some of the selected groups To do so select them and click the Work with Intersection button To add all systems in all selected groups select them and click the Work with Union button Each system will show up once regardless of the number of groups to which it belongs Refer to Section 4 4 System Set Manager for details Updates Shows which type of ...

Page 109: ...ded or removed and click the Add Systems or Remove Systems button 4 3 3 System Group Details At the top of each System Group Details page are two links work with group and delete group Clicking delete group deletes the System Group and should be used with caution Clicking Work with Group functions similarly to the Use Group button from the System Groups list in that it loads the group s systems an...

Page 110: ...mins List of all organization users that have the ability to manage the system group Satellite Administrators are clearly identified System Group Administrators are marked with an asterisk To change the system group s users select and unselect the appropriate checkboxes and click the Update button 4 3 3 6 System Group Details Probes List all probes assigned to systems in the system group The State...

Page 111: ... on the System Group Details page 4 4 1 System Set Manager Overview Description of the various options available to you in the remaining tabs 4 4 2 System Set Manager Systems List of systems now selected To remove systems from this set select them and click the Remove button 4 4 3 System Set Manager Errata List of Errata Updates applicable to the current system set Click the number in the Systems ...

Page 112: ... Set Manager Packages Remove A list of all the packages installed on the selected systems that might be removed Multiple versions appear if systems in the System Set Manager have more than one version installed Select the packages to be deleted then click the Remove Packages button 4 4 5 System Set Manager Verify A list of all installed package whose contents MD5 sum and other details may be verif...

Page 113: ...hin the System Details Channels Configuration tab the subtabs here can be used to subscribe the selected systems to configuration channels and deploy and compare the configuration files on the systems The channels are created in the Manage Config Channels interface within the Channels category Refer to Section 7 2 Overview for channel creation instructions To manage the configuration of a system i...

Page 114: ...d to the selected systems The three buttons below the channels reflect your options Clicking Subscribe with Highest Priority places all the ranked channels before any other channels to which the selected systems are currently subscribed Clicking Subscribe With Lowest Priority places the ranked channels after those channels to which the selected systems are currently subscribed Clicking Replace Exi...

Page 115: ... When the kickstarts for the selected systems are successfully scheduled the web interface returns you to the System Set Manager page 4 4 11 2 System Set Manager Provisioning Tag Systems Use this subtab to add meaningful descriptions to the most recent snapshots of your selected systems To tag the most recent system snapshots enter a descriptive term in the Tag name field and click the Tag Current...

Page 116: ... message at the top of the page select the systems and click Unschedule Action 4 4 12 4 System Set Manager Misc Lock Systems Select the appropriate systems and click the Lock Systems link to prevent the scheduling of any action through RHN that affects the selected systems This can be reversed by clicking the Unlock Systems link 4 4 12 5 System Set Manager Misc Delete Systems Click Delete System P...

Page 117: ...s 4 5 Advanced Search The System Search page allows you to search through your systems according to specific criteria These criteria include custom system information system details hardware devices interface networking packages and location The activity selections Days Since Last Checkin for instance can be especially useful in finding and removing outdated System Profiles Type the keyword select...

Page 118: ...or details 3 Provide the following information Description User defined description to identify the generated activation key Usage Limit The maximum number of registered systems that can be registered to the activation key at any one time Leave blank for unlimited use Deleting a system profile reduces the usage count by one and registering a system profile with the key increases the usage count by...

Page 119: ...Key button To disassociate channels and groups from a key deselect them in their respective menus by Ctrl clicking their highlighted names To remove a key entirely click the delete key link in the top right corner of the edit page A system may be set to subscribe to a base channel during registration with an activation key However if the activation key specifies a base channel that is not compatib...

Page 120: ...ng values do not cause registration to fail a combination of values is applied software packages software child channels and config channels Conflicts in the remaining properties are resolved in the following manner base software channels registration fails entitlements registration fails enable config flag configuration management is set Do not use system specific activation keys along with other...

Page 121: ...ovisioning needs of customers RHN provides this interface for developing kickstart profiles that can be used to install Red Hat Enterprise Linux on either new or already registered systems This enables systems to be installed automatically to particular specifications Important If your systems are connected to the central RHN Servers you will need an external installation tree for each distributio...

Page 122: ...uction to Kickstart Many system administrators would prefer to use an automated installation method to install Red Hat Enterprise Linux on their machines To answer this need Red Hat created the kickstart installation method Using kickstart a system administrator can create a single file containing the answers to all the questions that would normally be asked during a typical installation Kickstart...

Page 123: ...m 4 The bootloader once loaded searches for its configuration file on the server from which it was itself loaded This file dictates which kernel and kernel options such as the initial RAM disk initrd image should be executed on the booting machine Assuming the bootloader program is SYSLINUX this file is located in the pxelinux cfg directory on the server and named the hexadecimal equivalent of the...

Page 124: ...not yet have an operating system installed One common method of doing this is to create a bootable CD ROM that is inserted into the target system When the system is rebooted it boots from the CD ROM loads the kickstart configuration from the RHN Servers or your Satellite and proceeds to install Red Hat Enterprise Linux according to the kickstart profile you have created To do this copy the content...

Page 125: ...D ROM based installs RHN supports kickstarts through a Pre Boot Execution Environment PXE This is less error prone than CDs enables kickstarting from bare metal and integrates with existing PXE DHCP environments To use this method make sure your systems have network interface cards NIC that support PXE install and configure a PXE server ensure DHCP is running and then place the appropriate files o...

Page 126: ...ons for instructions Once that is done return to the Kickstart Overview page to create the Kickstart Profile Click on the Create a New Kickstart Profile link from the Systems Kickstart page to start the brief wizard that populates the base values needed for a kickstart profile 1 On the first page enter a kickstart profile label and select a kickstartable tree for this profile The kickstartable tre...

Page 127: ...it cannot be used to schedule a kickstart by removing the Active checkmark Select whether this profile is the default for all of your organization s kickstarts by checking or unchecking the box Enter comments that are useful to you in distinguishing this profile from others 4 9 3 2 Kickstart Details Operating System From this page you can make the following changes to the operating system that the...

Page 128: ...ddress 4 9 3 5 System Details Details Figure 6 10 System Details The figure above shows the sub tabs that are available from the System Details tab From the System Details Details sub tab you can Select from DHCP and static IP depending on your network Choose the level of SELinux that is configured on kickstarted systems Enable configuration management or remote command execution on kickstarted sy...

Page 129: ... the GPG keys and or SSL certificates to be imported to the kickstarted system during the post section of the kickstart For Satellite customers this list includes the SSL Certificate used during the installation of the Satellite Note Any GPG key you wish to import to the kickstarted system must be in ASCII rather than binary format 4 9 3 10 System Details Troubleshooting From this sub tab you can ...

Page 130: ...ed system Refer to Section 4 2 9 2 2 System Details Software Packages for more information about package profiles 4 9 3 13 Activation Keys Figure 6 12 Activation Keys The Activation Keys tab which has no sub tabs allows you select Activation Keys to include as part of the kickstart profile These keys which must have been created previous to creating the kickstart profile will be used when re regis...

Page 131: ...s field of the System Details Partitioning tab include tmp part include 4 9 3 15 Kickstart File Figure 6 14 Kickstart File The Kickstart File tab which has no sub tabs allows you to view or download the kickstart profile that has been generated from the options chosen in the previous tabs 4 9 4 Kickstart Bare Metal Lists the IP addresses that have been associated with kickstart profiles created by...

Page 132: ... channels imported with satellite sync are made available automatically and do not require the creation of a separate installation tree These trees are available to client systems that kickstart through the Satellite While you may be able to access the files from a non kickstarting client this functionality is not supported and may be removed at any time in the future To create a new distribution ...

Page 133: ...nd directory names may be entered No regular expression wildcards can be included When finished you may include the file preservation list in the kickstart profile to be used on systems containing those files Refer to Section 4 9 3 Create a New Kickstart Profile for precise steps 5 Errata Select the Errata tab from the top navigation bar to track the availability and application of errata to your ...

Page 134: ...systems In addition to the pages described within this chapter you may view Errata by product line from the following location https rhn redhat com errata 5 1 Relevant Errata As shown in Figure 6 15 Errata List the Relevant Errata page displays a customized list of Errata Updates that applies to your registered systems The list provides a summary of each Errata Update including its type severity f...

Page 135: ...s released by Red Hat It works much the same as the Relevant Errata page in that clicking either the Advisory or the number of systems affected takes you to related tabs of the Errata Details page Refer to Section 5 2 2 Errata Details for more information 5 2 1 Apply Errata Updates Errata Updates include a list of updated packages that are required to apply the Errata Update To apply Errata Update...

Page 136: ...he appropriate systems are selected click the Errata tab select the Errata Updates to apply and click the Apply Errata button You can select to apply the Errata as soon as possible the next time the Red Hat Network Daemon on the client systems connect to RHN or schedule a date and time for the Errata Updates to occur Then click the Schedule Updates button You can follow the progress of the Errata ...

Page 137: ...icking on the link below the Oval label downloads this information to your system 5 2 2 2 Errata Details Packages Provides links to each of the updated RPMs broken down by channel Clicking on the name of a package displays its Package Details page 5 2 2 3 Errata Details Affected Systems Lists systems affected by the Errata Update You can apply updates here See Section 5 2 1 Apply Errata Updates Cl...

Page 138: ...e used to choose packages to be installed on a system There are two types of software channels base channels and child channels 6 1 1 Base Channels A base channel consists of a list of packages based on a specific architecture and Red Hat Enterprise Linux release For example all of the packages in Red Hat Enterprise Linux 3 for the x86 architecture make up a base channel The list of packages in Re...

Page 139: ...s a custom engineering application A system can be subscribed to multiple child channels of its base channel Only packages included in a system s subscribed channels can be installed or updated on that system Further RHN Satellite Server and RHN Proxy Server customers have channel management authority This authority gives them the ability to create and manage their own custom channels Refer to the...

Page 140: ...on bar It works identically to the Relevant button with one exception it displays all software channels offered by Red Hat Network regardless of whether you have systems associated with them 6 1 6 Software Channel Details If you click on the name of a channel the Software Channel Details page appears This page is broken down into the following tabs 6 1 6 1 Software Channel Details Details General ...

Page 141: ...that has Red Hat Enterprise Linux AS v 4 for x86 cannot be registered to a Red Hat Enterprise Linux ES v 4 for x86 base channel 6 1 6 2 Software Channel Details 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 page Refer to Section 5 2 2 Errata Details for more information ...

Page 142: ...es to select the systems then click the Unsubscribe button on the bottom right hand corner 6 1 6 5 Software Channel Details Target Systems List of entitled systems that are eligible for subscription to the channel This tab appears only for child channels Use the checkboxes to select the systems then click the Subscribe button on the bottom right hand corner You will receive a success message or be...

Page 143: ...86 Solaris 6 3 Manage Software Channels This tab allows Administrators to create clone and delete custom channels These channels may contain altered versions of distribution based channels or custom packages 6 3 1 Manage Software Channels Channel Details The default screen of the Manage Software Channels tab is a listing of all available channels This includes custom distribution based and child c...

Page 144: ...are Channels Channel Details Packages This subtab is similar to the Errata subtab It allows Channel and Organization Administrators to list remove compare and add packages to the custom channel To list all packages in the channel click the List Remove Packages link Check the box to the left of any package you wish to remove then click the Remove Packages button in the lower right of the page To ad...

Page 145: ...reparing Systems for Config Management For a system to have its configuration managed through RHN it must have the appropriate tools and config enable file installed 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 Tools child channel for your distribution Download and in...

Page 146: ...nd to take action to correct any issues Clicking on any blue text displays the System Details Schedule page for the specified system 7 3 Configuration Channels As mentioned above RHN manages both central and local configuration channels and files Central configuration management allows you to deploy configuration files to multiple systems Local configuration management allows you to specify overri...

Page 147: ... there are files in the configuration channel lists the files that this configuration channel contains You can remove a file or files or copy the latest version into a set of local overrides or into other central configuration channels Check the box next to any files you wish to manipulate and click the button corresponding to the desired action at the bottom of the screen Add Files The Add Files ...

Page 148: ...ms the file s should be applied The listed systems are those that are subscribed to this channel If you wish to apply the file to a system not listed here first subscribe that system to the channel When ready press the Confirm and Deploy to Selected Systems button to deploy the files Systems This tab which consists of two sub tabs allows you to manage the systems that are subscribed to the configu...

Page 149: ...ly managed file will not be deployed to those systems 7 5 Locally Managed Files Locally managed configuration files are those files that apply to only one system They may be files in the system s sandbox or they may be files that can be deployed to the system at any time Local files have higher priority than centrally managed files that is if a system is subscribed to a configuration channel with ...

Page 150: ...ils page Then open its Configuration File Details page and include the supported macros of your choosing Ensure that the delimiters used to offset your variables match those set in the Macro Start Delimiter and Macro End Delimiter fields and do not conflict with other characters in the file The delimiters must be two characters in length and cannot contain the percent symbol As an example you may ...

Page 151: ...y system containing it Using the Red Hat Network Configuration Manager rhncfg manager will not translate or alter files as that tool is system agnostic rhncfg manager does not depend on system settings Binary files cannot be interpolated 7 6 Systems This page displays status information about your system in relation to configuration There are two sub tabs Managed Systems and Target Systems 7 6 1 M...

Page 152: ...ill have to perform a few manual steps to enable configuration file deployment but on screen instructions are provided to assist with this step 8 Schedule If you click the Schedule tab on the top navigation bar the Schedule category and links appear These pages enable you to track the actions taking place within your systems An action is a scheduled RHN task that is to be performed on one or more ...

Page 153: ...r It displays actions that have not started or are in progress Figure 6 18 Schedule Pending Actions 8 2 Failed Actions Actions that could not be completed If the action returns an error it is displayed here 8 3 Completed Actions Actions that have succeeded 8 4 Archived Actions Actions that you have selected to store for review 8 5 Actions List Failed Actions 139 ...

Page 154: ...ystems on which this action has been scheduled 8 5 1 Action Details If you click on the name of an action the Action Details page appears This page is broken down into the following tabs 8 5 1 1 Action Details Details General information about the action This is the first tab you see when you click on an action It displays the action type scheduling administrator earliest execution and notes Click...

Page 155: ...will be able to login to RHN Once all fields are complete select the Create Login button RHN now sends an email to the specified address and redirects you to the Users User List page If you wish to select permissions and options for the newly created user select their name from the list Doing so displays the User Details page for that user which provides several subtabs of options from which to ch...

Page 156: ...all users Included in the User Details page is the ability to delete or deactivate users Users may now be deactivated directly from the RHN web interface RHN Satellite Server customers may deactivate or delete users from their systems although non Satellite customers must contact Customer Service to delete a user Users may be deactivated or deleted by Satellite Administrators or users may deactiva...

Page 157: ...e Submit button in the lower right of the screen 3 Click the deactivate user link in the upper right of the screen 4 Click the Deactivate User button in the lower right to confirm To delete a user 1 Navigate to the user s User Details tab 2 Verify that the user is not an Satellite Administrator and remove that role if necessary 3 Click the delete user link in the upper right 4 Click the Delete Use...

Page 158: ...ing infrastructure This role is available only on Monitoring enabled RHN Satellite Server version 3 6 or later Satellite Administrator This role can perform any function available within Red Hat Network As the master account for your organization the person holding this role can alter the privileges of all other accounts as well as conduct any of the tasks available to the other roles Like the oth...

Page 159: ...em Details page Refer to Section 4 2 9 System Details for more information 9 1 1 4 User List Active User Details Channel Permissions This tab lists all channels available to your organization You may grant explicit channel subscription permission to this user for each of the channels listed by checking the box to the left of the channel and clicking the Update Permissions button Permissions grante...

Page 160: ...y of these options make your changes and click the Save Preferences button 9 1 1 6 User List Active User Details Addresses This tab lists the addresses associated with the user s account To update this information click the appropriate Edit this address link enter the relevant information and click the Update button 9 1 1 7 User List Active User Details Notification Methods This tab lists email an...

Page 161: ...and manage the configuration of your monitoring infrastructure Initiate monitoring of a system through the Probes tab of the System Details page Refer to Section 4 2 9 System Details for a description of the tab See Appendix C Probes for the complete list of available probes 10 1 Probe Status The Probe Status page is shown by default when you click Monitoring in the top navigation bar The Probe St...

Page 162: ...nload CSV files of relevent information The exported data may include but is not limited to Probe status All probes in a given state OK WARN UNKNOWN CRITICAL PENDING A Probe Event history 10 1 1 Probe Status Critical The probes that have crossed their CRITICAL thresholds or reached a critical status by some other means For instance some probes become critical rather than unknown when exceeding the...

Page 163: ...he checkboxes whether the results should be shown in a graph an event log or both Then click Generate report at the bottom of the page If no data exist for the probe s metrics you are presented with the following message NO DATA SELECTED TIME PERIOD AND METRIC 10 2 Notification Identifies the contact methods that have been established for your organization These methods contain email or pager addr...

Page 164: ...t which probe state s relate to the filter For example you may choose to create a supplemental notification for critical probes only Un check the box to the left of any state you want the filter to ignore 7 Notifications sent to This is the method to which the notification would be sent if no filter were in place You may for example redirect notifications that would normally go to a user should th...

Page 165: ... time savings and consistency for Monitoring customers To create and apply a Probe Suite first create an empty Probe Suite then configure member probes and finally apply the Suite to selected systems 1 From the Monitoring Probe Suites page select the create probe suite link Enter an easily distinguishable name for the Probe Suite You may also choose to add a brief description of the Suite Click th...

Page 166: ...e probe you wish to remove 4 Click the Delete probes from Probe Suites button You may also remove a system from the Probe Suite There are two ways to accomplish this The first method is to detach the system from the Probe Suite When you do so the system still has the same probes assigned to it However you now have the ability to configure these probes individually without affecting any other syste...

Page 167: ...Scout Configs The table on this page identifies the date and time of requested and completed pushes Clicking the name of the server opens its Red Hat Network Monitoring Daemon SSH Public Key This allows you to copy and paste the SSH key to the systems that are monitored by the scout This is required in order for the Red Hat Network Monitoring Daemon to connect to the Satellite 10 5 General Config ...

Page 168: ...ions The Organizations feature allows administrators to to create and manage multiple organizations across the Satellite The Organizations feature allows administrators to appropriate software and system entitlements across various organizations as well as control an organization s access to systems management tasks Figure 6 20 Satellite Tools The Organizations page contains a listing of organizat...

Page 169: ...ting the entire Satellite Figure 6 21 Create New Organization 1 Input the Organization Name in the provided text box The name should be between 3 and 128 characters 2 Create an administrator for the organization a Enter a Desired Login for the organization administrator which should be between 5 and 64 characters long b Create a Desired Password and Confirm the password c Type in the Email for the...

Page 170: ...ble to the organization Configuration Channels The number of Configuration Channels available to the organization From this page you can delete the organization by clicking the Delete Organization link The Details page also contains two subtabs Users and Subscriptions 11 1 2 1 Satellite Tools Organizations Details Users The Users subtab lists the users assigned to the organization including their ...

Page 171: ...e Channel Entitlements subtab enables administrators to set the number of allocations per software channel Enter the number of allocations of each software entitlement in the text box not to exceed the limit indicated in the Possible Values below the text box 11 1 3 Satellite Tools Users The Users Across Satellite page contains a list of all users on the Satellite throughout all organizations Note...

Page 172: ...this Satellite across all organizations as well as their usage Click on the entitlement s name for more details about it The Details subtab for the system entitlement contains information about the entitlement and what access it grants The Organizations subtab allows Satellite administrators to adjust the number of system entitlement allocations available to each organization Type in the number wi...

Page 173: ...a bootstrap script for redirecting client systems from the central RHN Servers to the Satellite This script to be placed in the var www html pub bootstrap directory of the Satellite significantly reduces the effort involved in reconfiguring all systems which by default obtain packages from the central RHN Servers The required fields are pre populated with values derived from previous installation ...

Page 174: ...be automatically reset and sent to them via e mail by the system If users have forgotten their login information they may retrieve it by typing their e mail address in the Red Hat Login Unknown section The login information will be sent via e mail to the user 12 4 Release Notes The Release Notes page lists the notes accompanying every recent release of Red Hat Network These notes describe all sign...

Page 175: ...Network Application Programming Interface API for creating tools and programs to automate common tasks via Red Hat Network The API page contains an overview of the API with links to detailed descriptions of various API calls available to administrators and developers There is also an FAQ page for answers to common questions about the Red Hat Network API Finally there is a Sample Scripts page that ...

Page 176: ...162 ...

Page 177: ... of the necessary tools in place At a minimum you need Monitoring entitlements These entitlements are required for all systems that are to be monitored Monitoring is supported only on Red Hat Enterprise Linux systems RHN Satellite Server with Monitoring Monitoring systems must be connected to a Satellite with a base operating system of Red Hat Enterprise Linux AS 3 Update 5 Red Hat Enterprise Linu...

Page 178: ...her by using sshd instead Refer to Section 2 3 Configuring SSH for details 2 1 Probes requiring the daemon An encrypted connection either through the Red Hat Network Monitoring Daemon or sshd is required on client systems for the following probes to run Linux CPU Usage Linux Disk IO Throughput Linux Disk Usage Linux Inodes Linux Interface Traffic Linux Load Linux Memory Usage Linux Process Counts ...

Page 179: ...gh the Channel Details Target Systems tab 2 Once subscribed open the Channel Details Packages tab and find the rhnmd package under R 3 Click the package name to open the Package Details page Go to the Target Systems tab select the desired systems and click Install Packages 4 Install the SSH public key on all client systems to be monitored as described in Section 2 4 Installing the SSH key 5 Start ...

Page 180: ...aemon public SSH key on the systems to be monitored to complete the secure connection To install it 1 Navigate to the Satellite Tools Satellite Configuration Scout Config Push page on the Satellite interface and click the name of the RHN Server that will monitor the client system The SSH id_dsa pub key is visible on the resulting page 2 Copy the character string beginning with ssh dss and ending w...

Page 181: ...ql server package on the RHN Satellite Server Refer to Appendix C Probes for a listing of all available probes Subscribe the Satellite to the Red Hat Enterprise Linux AS Extras channel and install the mysql server package either through the RHN website or via up2date Two additional packages will also be downloaded in the transaction These are needed for the mysql server package to be installed and...

Page 182: ... headers system and probe details and instructions for response 5 When finished click Create Method The new method shows up in the User Details Notification Methods tab and the Notification page under the top Monitoring category Click its name to edit or delete it 6 While adding probes select the Probe Notifications checkbox and select the new notification method from the resulting dropdown menu N...

Page 183: ...ct destination s in addition to the default destination ACK SUSPEND Suspends the notification method for a specified time period ACK AUTOACK Does not change the destination of the notification but automatically acknowledges matching alerts as soon as they are sent ACK REDIR Sends the notification to the redirect destination s instead of the default destination The format of the rule should be filt...

Page 184: ...thods and probes can complicate this process Follow these steps to remove a notification method 1 Log into the RHN website as an Satellite Administrator or Monitoring Administrator 2 Navigate to the Monitoring Notifications page and click the name of the method to be removed 3 On the User Details Notification Methods tab click delete method If the method is not associated with any probes you are p...

Page 185: ...uire the Red Hat Network Monitoring Daemon to be installed on the client system 4 Select the desired Probe Command and the Monitoring Scout typically RHN Monitoring Satellite but possibly an RHN Proxy Server Enter a brief but unique description for the probe 5 Select the Probe Notifications checkbox to receive notifications when the probe changes state Use the Probe Check Interval dropdown menu to...

Page 186: ...ns for a time to establish baseline performance for each of your systems Although the default values provided for probes may suit you every organization has a different environment that may require altering thresholds 5 3 Monitoring the RHN Server In addition to monitoring all of your client systems you may also use RHN to monitor your RHN Server whether that be an RHN Satellite Server a RHN Proxy...

Page 187: ...eProbe on example2 redhat com 199 168 36 173 rhel2 1 test 4 ServiceProbe on example3 redhat com 199 168 36 174 SSH 5 ServiceProbe on example4 redhat com 199 168 36 175 HTTP The probe ID is the first number while the probe name as entered in the RHN website is the final entry on the line In the above example the 5 probe ID corresponds to the probe named HTTP Further you may pass the commandline c a...

Page 188: ...ode to run log all LEVEL Set log level for a package or package prefix debug LEVEL Set numeric debugging level live Execute the probe enqueue data and send out notifications if needed Table 7 1 rhn runprobe Options At a minimum you should include the probe option the log option and values for each The probe option takes the probeID as its value and the log option takes the value all for all run le...

Page 189: ...n proceed to provision virtual guests 1 1 Create a Kickstart Profile for the Guest Systems 1 Login to the Satellite s web interface Navigate to the Kickstart Overview screen by clicking the Manage Kickstarts link in the Tasks widget in Your RHN or by clicking on the Systems tab followed by the Kickstart subtab in the left navigation bar 2 On the Kickstart Overview page click the Create a New Kicks...

Page 190: ... button on this screen to continue to Step 3 Note As in the previous step if the default download location is missing you may not have successfully synced software channel content to your Satellite from Red Hat s server 5 For Step 3 of the kickstart profile creation process please choose a root password to set on the host system you will be provisioning and click Next to finish creation of the pro...

Page 191: ...top red navigation bar You should see the host system you just registered click on its profile name to access its system profile page 3 Add a provisioning entitlement to your host system From your host system profile page click on Details Properties tab Check the Provisioning checkbox in the Add On Entitlements field and click the Update Properties button in the lower right hand corner of the scre...

Page 192: ...rt process on the host system and it will eventually warn you that the system is going dow for reboot in three minutes 8 After three minutes have passed the system will reboot Follow the progress of the kickstart via the Satellite web interface 9 Depending on various factors the kickstart process may take between ten and thirty minutes At the end of this time period the Satellite kickstart status ...

Page 193: ...able at http www redhat com docs manuals enterprise for tips on how to do this Note that your host system s hardware must support boot via these devices 2 Insert the boot CD in the drive and reboot the system making sure the CD ROM drive is set as the primary boot device in the system s BIOS 3 After reboot you should find yourself at a boot prompt Type the following command at this prompt to start...

Page 194: ...ample com Click on the Systems tab in the top red navigational bar You should see the host system you just registered click on its profile name to access its system profile page 3 Make sure your system has access to the software channels it needs to access the software required for hosting virtual guests From your host system s profile page click on the Alter Channel Subscriptions link in the uppe...

Page 195: ...ot need to reboot after installing rhn virtualization host 6 You will also need to install and run the osad package in order for your host system to be responsive to commands sent from the Satellite such as start pause resume and shutdown To install yum install y osad after installation you should then start the osad process sbin service osad restart 7 Your host system should now be ready for RHN ...

Page 196: ...ield you should select ks rhel ARCH PRODUCT 5 where ARCH is the architecture of your host system and PRODUCT is either server or client depending on which product with which you would like to provision your guest d Select Para Virtualized Guest for the Virtualization Type field e Finally click the Next button in the lower right of the screen to continue on to the next step 4 For Step 2 of the kick...

Page 197: ...t and Finish button in the lower right corner of the screen You will be taken to the Kickstart Status page where you can follow along with the guest s kickstart progress After ten to fifteen minutes the status screen should indicate the kickstart successfully completed To view your new guest click on the Virtualization tab of the host system s profile on the Satellite To view a list of virtual hos...

Page 198: ... is currently taking place the current guest kickstart process will be canceled and the new guest kickstart process will begin 5 View your newly created virtual guest s system in the Satellite s web interface by clicking on the Virtualization tab in the host system s profile Then click on the profile name of your virtual system You will be brought to its Satellite system profile 3 Working With You...

Page 199: ...s case hit the Enter key on your keyboard to receive a fresh login prompt 4 To exit the guest console and return to the host system s command prompt you may hit the Ctrl and keys on your keyboard simultaneously 3 3 Installing Software Via the Satellite Web Interface 1 Browse to the virtual system s profile in your Satellite s web interface by logging in and navigating to Systems Systems Virtual Sy...

Page 200: ...ng down by clicking the Shutdown Systems button at the bottom of the screen 2 Next delete the virtual system from Satellite This is accomplished by checking off the virtual system s checkbox and clicking the Delete System button at the bottom of the screen Tip Please allow for at least two minutes between shutting down a virtual system and deleting it Otherwise the virtual system may not shut down...

Page 201: ...iguration file for guest1 run the following command grep guest1 etc sysconfig rhn virt xml Then delete the file indicated For example rm etc sysconfig rhn virt 14e5cfbf72342515236ad74b260c2f6b xml 5 You have successfully deleted a guest system from your host system and from Satellite Interface 187 ...

Page 202: ...188 ...

Page 203: ...ted UNIX Variants The following UNIX variants versions and architectures are supported by Red Hat Network Solaris 8 9 10 sparc Solaris 9 10 x86 1 2 Prerequisites These items are needed to obtain UNIX support RHN Satellite Server 5 0 0 or later A Satellite certificate with Management entitlements Management entitlements for each UNIX client RHN packages for UNIX including python pyOpenSSL and the R...

Page 204: ...oolset for package installation rather than rpm Refer to Section 4 2 3 Updating From the Command Line for the precise list of options The RHN Push application has been similarly modified to upload native UNIX file types including packages patches and patch clusters Since Solaris package patch and patch cluster files are different from RPM files the channel upload mechanism is somewhat different Th...

Page 205: ...r Preparation Configuration You must configure the Satellite to support UNIX clients before the required files are available for deployment to the client systems This can be accomplished in one of two ways depending on whether you have yet installed your Satellite server 1 During the Satellite installation Enable UNIX support on the Satellite by checking the Enable Solaris Support box during the i...

Page 206: ...pport After Satellite Installation Click the Update Configuration button to confirm the change 3 Finally you must create a base channel to which your client systems may subscribe This is because RHN does not provide UNIX content as a result you cannot use satellite sync to create the channel To create a Solaris channel login to the web interface of the Satellite as either an Satellite Administrato...

Page 207: ... Install Additional Packages This section steps you through the process of downloading and installing third party applications and the RHN applications from the Satellite onto the UNIX client Of primary importance is the Red Hat Update Agent for UNIX up2date which provides the link between your client systems and Red Hat Network The UNIX specific version of the Red Hat Update Agent is limited in f...

Page 208: ...ibgcc or SMCgcc SMCossl SMCzlib To verify if a package is installed on the client use the pkginfo command For example to check for a package that contains zlib in the name run the following command pkginfo grep zlib Note Solaris package archive names differ from the name of the installed package For example the package archive libgcc version sol solaris version sparc local gz becomes SMClibgcc aft...

Page 209: ...ib usr lib usr local lib usr sfw lib 3 1 3 Download RHN Client Packages Download the appropriate tarball of packages from the var www html pub directory of your Satellite If you are able to use a GUI web browser like Mozilla navigate to the pub directory of the Satellite and save the appropriate tarball to your client http your satellite example com pub rhn solaris bootstrap version solaris arch s...

Page 210: ...o use the n of pkgadd which runs the command in non interactive mode However this may cause the installation of some packages to fail silently on Solaris 10 Continue until each package is installed in the RHN specific path opt redhat rhn solaris 3 1 5 Include RHN Packages in the PATH In order to make the RHN packages available at each login you may wish to add them to your PATH To do so add these ...

Page 211: ...hese steps for each client 1 Download the SSL certificate from the var www html pub directory of the RHN Satellite Server onto the client system The certificate will be named something similar to RHN ORG TRUSTED SSL CERT It is accessible via the web at the following URL https your satellite example com pub RHN ORG TRUSTED SSL CERT 2 Move the client SSL certificate to the RHN specific directory for...

Page 212: ...re the application refers to the RHN Satellite Server even when SSL is turned off by also setting the noSSLServerURL value to the Satellite noSSLServerURL comment Remote server URL without SSL noSSLServerURL http your satellite example com XMLRPC 5 With the up2date configuration file still open find the sslCACert entry and set its value to the name and location of the SSL certificate described in ...

Page 213: ...tem groups 4 Open a terminal on the client system to be registered and switch user to root 5 Use rhnreg_ks along with the activationkey option to register the client with the Satellite The string of characters that make up the key may be copied directly from the Activation Keys list on the website The resulting command will look something like the following rhnreg_ks activationkey b25fef0966659314...

Page 214: ... as installed entities so they do not appear in the installed packages or patches list Patch Cluster names look like patch cluster solaris 7_Recommended The version is a datestring such as 20040206 the release is always 1 and the epoch is always 0 4 2 1 Uploading Packages to the Satellite RHN does not provide UNIX content any Solaris packages patches or Patch Clusters must be uploaded to the Satel...

Page 215: ... containing information about the cluster as a whole Below are the options of solaris2mpm Option Description version Displays the program s version number and exits h help Displays this information and exits usage Prints program usage information and exits tempdir tempdir Temporary directory to work from select arch arch Selects the architecture i386 or Sparc for multi arch packages Table 9 1 sola...

Page 216: ...te Commands for instructions To install packages or patches on multiple systems at once select the systems and click System Set Manager in the left navigation bar Then in the Packages tab select the packages from the Upgrade or Install lists and click Install Upgrade Packages To complete the action schedule the updates On Red Hat Enterprise Linux systems the rhnsd daemon which instructs the client...

Page 217: ...pts the following arguments on UNIX systems Argument Description version Show program version information h help Show this help message and exit v verbose Show additional output l list List the latest versions of all packages installed p packages Update packages associated with this System Profile hardware Update this system s hardware profile on RHN showall List all packages available for downloa...

Page 218: ...tem Details Configuration for details In short you must create a directory and file on the UNIX system that tell RHN it is acceptable to run remote commands on the machine The directory must be named script the file must be named run and both must be located in the etc sysconfig rhn allowed actions directory specific to your UNIX variant For instance in Solaris issue this command to create the dir...

Page 219: ... run a remote command on the selected systems at once To run a remote command with a package action schedule the action through the Packages tab of the System Details page and click Run Remote Command while confirming the action Use the radio buttons at the top to determine whether the command should run before or after the package action establish the settings for the command and click Schedule P...

Page 220: ...206 ...

Page 221: ...ent systems cannot be managed in this fashion by default This tool allows Satellite Administrators to enable or disable specific modes of allowable actions such as deploying a configuration file onto the system uploading a file from the system diffing what is currently managed on a system and what is available or allowing running arbitrary remote commands These various modes are enabled disabled b...

Page 222: ... Red Hat Network Configuration Client rhncfg client is installed and run from an individual client system From there you may use it to gain knowledge about how RHN deploys configuration files to the client The Red Hat Network Configuration Client offers these primary modes list get channels diff and verify 2 1 Listing Config Files To list the configuration files for the machine and the labels of t...

Page 223: ...t relevant configuration file for the machine issue the command rhncfg client get etc example config txt You should see output resembling Deploying etc example config txt You may then view the contents of the file with less or another pager Note that the file is selected as the most relevant based upon the rank of the config channel containing it This is accomplished within the Configuration tab o...

Page 224: ... config files in RHN with those located in an arbitrary and unused location on the client system like so root root rhncfg client diff topdir home test blah usr bin diff home test blah etc example config txt No such file or directory usr bin diff home test blah var spool aalib rpm No such file or directory 2 5 Verifying Config Files To quickly determine if client configuration files are different t...

Page 225: ...the rhncfg manager section of rhncfgrc When the Red Hat Network Configuration Manager is run as root it attempts to pull in needed configuration values from the Red Hat Update Agent When run as a user other than root you may have to make configuration changes within the rhncfgrc file The session file is cached in rhncfg manager session to prevent logging in for every command The default timeout fo...

Page 226: ...cal file to be uploaded such as rhncfg manager add channel channel label path to file In addition to the required channel label and the path to the file you may use the available options for modifying the file during its addition For instance you may alter the path and file name by including the dest file option in the command like rhncfg manager add channel channel label dest file new path to fil...

Page 227: ...ue the command rhncfg manager diff channel channel label dest file path to file txt local path to file You should see output resembling tmp dest_path example config txt home test blah hello_world txt tmp dest_path example config txt config_channel example channel revision 1 home test blah hello_world txt 2003 12 14 19 08 59 000000000 0500 1 1 foo hello world The following table lists the options a...

Page 228: ...ision 1 tmp dest_path example config txt 2004 01 13 14 42 42 config channel example channel3 revision 1 1 1 20 foo blaaaaaaaaaaaaaaah BEGIN PGP SIGNATURE Version GnuPG v1 0 6 GNU Linux Comment For info see http www gnupg org iD8DBQA9ZY6vse4XmfJPGwgRAsHcAJ9ud9dabUcdscdcqB8AZP7e0Fua0NmKsdhQCeOWHX VsDTfen2NWdwwPaTM S Cow Ltp2 END PGP SIGNATURE The following table lists the options available for rhncf...

Page 229: ...channel label tmp dest_path example config txt You should see the contents of the file as output 3 7 Listing All Files in a Channel To list all the files in a channel issue the command rhncfg manager list channel label You should see output resembling Files in config channel example channel3 tmp dest_path example config txt The following table lists the options available for rhncfg manager get Opt...

Page 230: ...for your RHN username and password provide them You should see output resembling Red Hat Network username rhn user Password Removing from config channel example channel3 tmp dest_path example config txt removed The following table lists the options available for rhncfg manager remove Option Description cCHANNEL channel CHANNEL Remove files from this config channel tTOPDIR topdir TOPDIR Make all fi...

Page 231: ...given path issue the following command rhncfg manager update channel channel label dest file path to file txt local path to file The output resembles the following Pushing to channel example channel Local file example channel tmp dest_path example config txt remote file tmp dest_path example config txt The following table lists the options available for rhncfg manager update Option Description cCH...

Page 232: ...a_world txt from blah4 tmp ola_world txt The following table lists the options available for rhncfg manager upload channel Option Description tTOPDIR topdir TOPDIR Directory all the file paths are relative to cCHANNEL channel CHANNEL List of channels the config info will be uploaded into Channels delimited by Example channel foo bar baz h help Show help message and exit Table A 11 rhncfg manager u...

Page 233: ...ur RHN account while the third is the length of time the session should last in seconds typically 1200 It returns a session string than can be used in all other methods 2 Obtaining the system_id Many of the methods require a value for the system_id parameter This is the unique alphanumeric value assigned to each system when registered to RHN It can be found within the etc sysconfig rhn systemid fi...

Page 234: ... architecture of a channel is not always clear from the channel label Below is a list that shows the correspondence between channel labels and the official title of the architecture they serve Channel Label Platform channel i386 sun solaris i386 Solaris channel ia32 IA 32 channel ia64 IA 64 channel sparc Sparc channel alpha Alpha channel s390 IBM S 390 channel s390x IBM System z channel iSeries IB...

Page 235: ...session my client new Frontier Client url http HOST rpc api Next we execute a login call which returns a session identifier that will be passed in all subsequent calls The syntax of this call is described at http HOST rpc api auth login my session client call auth login username password System calls This next call returns a list of systems available to the user The syntax of this call is describe...

Page 236: ...his call is described at http HOST rpc api system list_packages This will probably be a pretty long list my packages client call system list_packages session systemid for my package packages print Dumper package Additional system calls are described at http HOST rpc api system Appendix B RHN API Access 222 ...

Page 237: ...Probe Guidelines covers general guidelines the remaining sections examine individual probes Note Nearly all of the probes use Transmission Control Protocol TCP as their transport protocol Exceptions to this are noted within the individual probe references 1 Probe Guidelines The following general guidelines outline the meaning of each probe state and provide guidance in setting thresholds for your ...

Page 238: ... Remember that Red Hat recommends running your probes without notifications for a time to establish baseline performance for each of your systems Although the default values provided for probes may suit your needs every organization has a different environment that may require altering thresholds 2 Apache 1 3 x and 2 0 x The probes in this section may be applied to instances of the Apache Web serv...

Page 239: ...pache Processes settings 2 2 Apache Traffic The Apache Traffic probe monitors the requests on an Apache Web server and collects the following metrics Current Requests The number of requests being processed by the server at probe runtime Request Rate The accesses to the server per second since the probe last ran Traffic The kilobytes per second of traffic the server has processed since the probe la...

Page 240: ...agreements SLAs Field Value Application Protocol http Port 80 Pathname server status UserAgent NOCpulse ApacheUptime 1 0 Username Password Timeout 15 Table C 3 Apache Uptime settings 3 BEA WebLogic 6 x and higher The probes in this section with the exception of JDBC Connection Pool can be configured to monitor the properties of any BEA WebLogic 6 x and higher server Administration or Managed runni...

Page 241: ... managed_server_name in order for the SNMP query to return results for the desired Managed Server Finally SNMP must be enabled on each monitored system SNMP support can be enabled and configured through the WebLogic Console Please see the documentation that came with your BEA server or information on the BEA website for more details about BEA s community string naming conventions http e docs bea c...

Page 242: ...er Name myserver Critical Maximum Heap Free Warning Maximum Heap Free Warning Minimum Heap Free Critical Minimum Heap Free Table C 5 BEA WebLogic Heap Free settings 3 3 BEA WebLogic JDBC Connection Pool The BEA WebLogic JDBC Connection Pool probe monitors the Java Database Connection JDBC pool on a domain Admin Server only no Managed Servers and collects the following metrics Connections The numbe...

Page 243: ...l settings 3 4 BEA WebLogic Server State The BEA WebLogic Server State probe monitors the current state of a BEA Weblogic Web server If the probe is unable to make a connection to the server a CRITICAL status results This probe s transport protocol is User Datagram Protocol UDP Field Value SNMP Community String public SNMP Port 161 SNMP Version 1 BEA Domain Admin Server BEA Server Name Table C 7 B...

Page 244: ...c SNMP Port 161 SNMP Version 1 BEA Domain Admin Server BEA Server Name myserver Servlet Name Critical Maximum High Execution Time Warning Maximum High Execution Time Critical Maximum Execution Time Moving Average Warning Maximum Execution Time Moving Average Table C 8 BEA WebLogic Servlet settings 4 General The probes in this section are designed to monitor basic aspects of your systems When apply...

Page 245: ... key item The remote program will need to output some iteration of the following code to STDOUT perldata hash item key data 10 item item key status_message status message here item hash perldata The required value for data is the data point to be inserted in the database for time series trending The status_message is optional and can be whatever text string is desired with a maximum length of 1024...

Page 246: ...server to answer a connection request Requirements SNMP must be running on the monitored system to perform this probe Only integers can be used for the threshold values This probe s transport protocol is User Datagram Protocol UDP Field Value SNMP OID SNMP Community String public SNMP Port 161 SNMP Version 2 Timeout 15 Critical Maximum Value Warning Maximum Value Warning Minimum Value Critical Min...

Page 247: ...ral UDP Check probe tests your UDP server by verifying that it can connect to a system via the specified port number It collects the following metric Remote Service Latency The time it takes in seconds for the UDP server to answer a connection request The probe passes the string specified in the Send field upon making a connection The probe anticipates a response from the system which should inclu...

Page 248: ...ssential aspects of your Linux systems from CPU usage to virtual memory Apply them to mission critical systems to obtain warnings prior to failure Unlike other probe groups which may or may not require the Red Hat Network Monitoring Daemon every Linux probe requires that the rhnmd daemon be running on the monitored system 5 1 Linux CPU Usage The Linux CPU Usage probe monitors the CPU utilization o...

Page 249: ...em to execute this probe Also the Disk number or disk name parameter must match the format visible when the iostat command is run If the format is not identical the configured probe enters an UNKNOWN state Field Value Disk number or disk name 0 Timeout 15 Critical Maximum KB read second Warning Maximum KB read second Warning Minimum KB read second Critical Minimum KB read second Critical Maximum K...

Page 250: ...inux Inodes The Linux Inodes probe monitors the specified file system and collects the following metric Inodes The percentage of inodes currently in use An inode is a data structure that holds information about files in a Linux file system There is an inode for each file and a file is uniquely identified by the file system on which it resides and its inode number on that system Requirements The Re...

Page 251: ...Warning Maximum Input Rate Warning Minimum Input Rate Critical Minimum Input Rate Critical Maximum Output Rate Warning Maximum Output Rate Warning Minimum Output Rate Critical Minimum Output Rate Table C 19 Linux Interface Traffic settings 5 6 Linux Load The Linux Load probe monitors the CPU of a system and collects the following metric Load The average load on the system CPU over various periods ...

Page 252: ...able memory no Timeout 15 Warning Maximum RAM Free Critical Maximum RAM Free Table C 21 Linux Memory Usage settings 5 8 Linux Process Counts by State The Linux Process Counts by State probe identifies the number of processes in the following states Blocked A process that has been switched to the waiting queue and whose state has been switched to waiting Defunct A process that has terminated either...

Page 253: ...ximum Child Processes Warning Maximum Child Processes Table C 22 Linux Process Counts by State settings 5 9 Linux Process Count Total The Linux Process Count Total probe monitors a system and collects the following metric Process Count The total number of processes currently running on the system Requirements The Red Hat Network Monitoring Daemon rhnmd must be running on the monitored system to ex...

Page 254: ...The amount of physical memory or RAM in kilobytes used by the specified process Virtual Memory Used The amount of virtual memory in kilobytes used by the specified process or the size of the process in real memory plus swap Specify the process by its command name or process ID PID Entering a PID overrides the entry of a command name If no command name or PID is entered the error Command not found ...

Page 255: ...rs matching the specified process Specify the process by its command name or process ID PID Entering a PID overrides the entry of a command name If no command name or PID is entered the error Command not found is displayed and the probe enters a CRITICAL state Requirements The Red Hat Network Monitoring Daemon rhnmd must be running on the monitored system to execute this probe Field Value Command ...

Page 256: ...ved from the network This probe can be helpful in finding and isolating network traffic to specific IP addresses or examining network connections into the monitored system The filter parameters for the probe let you narrow the probe s scope This probe uses the netstat ant command to retrieve data The Local IP address and Local port parameters use values in the Local Address column of the output th...

Page 257: ...ions by State settings 5 14 Linux Users The Linux Users probe monitors the users of a system and reports the following metric Users The number of users currently logged in Requirements The Red Hat Network Monitoring Daemon rhnmd must be running on the monitored system to execute this probe Field Value Timeout 15 Critical Maximum Users Warning Maximum Users Table C 28 Linux Users settings 5 15 Linu...

Page 258: ...gAgent Log Pattern Match probe uses regular expressions to match text located within the monitored log file and collects the following metrics Regular Expression Matches The number of matches that have occurred since the probe last ran Regular Expression Match Rate The number of matches per minute since the probe last ran Requirements The Red Hat Network Monitoring Daemon rhnmd must be running on ...

Page 259: ... Minimum Matches Critical Maximum Match Rate Warning Maximum Match Rate Warning Minimum Match Rate Critical Maximum Match Rate Table C 30 LogAgent Log Pattern Match settings 6 2 LogAgent Log Size The LogAgent Log Size probe monitors log file growth and collects the following metrics Size The size the log file has grown in bytes since the probe last ran Output Rate The number of bytes per minute th...

Page 260: ...l Maximum Line Rate Warning Maximum Line Rate Warning Minimum Line Rate Critical Minimum Line Rate Table C 31 LogAgent Log Size settings 7 MySQL 3 23 3 33 The probes in this section monitor aspects of the MySQL database using the mysqladmin binary No specific user privileges are needed for these probes Note that the mysql server package must be installed on the system conducting the monitoring for...

Page 261: ...ened since the server was started Field Value Username Password MySQL Port 3306 Timeout 15 Critical Maximum Opened Objects Warning Maximum Opened Objects Warning Minimum Opened Objects Critical Minimum Opened Objects Table C 33 MySQL Opened Tables settings 7 3 MySQL Open Tables The MySQL Open Tables probe monitors the MySQL server and collects the following metric Open Tables The number of tables ...

Page 262: ...ery Rate The average number of queries per second per database server Field Value Username Password MySQL Port 3306 Timeout 15 Critical Maximum Query Rate Warning Maximum Query Rate Warning Minimum Query Rate Critical Minimum Query Rate Table C 35 MySQL Query Rate settings 7 5 MySQL Threads Running The MySQL Threads Running probe monitors the MySQL server and collects the following metric Threads ...

Page 263: ...ncy thereby nullifying the thresholds 8 1 Network Services DNS Lookup The Network Services DNS Lookup probe uses the dig command to see if it can resolve the system or domain name specified in the Host or Address to look up field It collects the following metric Query Time The time in milliseconds required to execute the dig request This is useful in monitoring the status of your DNS servers To mo...

Page 264: ...ort 21 Timeout 10 Critical Maximum Remote Service Latency Warning Maximum Remote Service Latency Table C 38 Network Services FTP settings 8 3 Network Services IMAP Mail The Network Services IMAP Mail probe determines if it can connect to the IMAP 4 service on the system Specifying an optional port will override the default port 143 It collects the following metric Remote Service Latency The time i...

Page 265: ...nitored system or a specified IP address It also checks the packet loss and compares the round trip average against the Warning and Critical threshold levels The required Packets to send value allows you to control how many ICMP ECHO packets are sent to the system This probe collects the following metrics Round Trip Average The time it takes in milliseconds for the ICMP ECHO packet to travel to an...

Page 266: ...um Packet Loss Table C 41 Network Services Ping settings 8 6 Network Services POP Mail The Network Services POP Mail probe determines if it can connect to the POP3 port on the system A port number must be specified specifying another port number overrides the default port 110 This probe collects the following metric Remote Service Latency The time it takes in seconds for the POP server to answer a...

Page 267: ...nce the Remote Ping probe tests connectivity from the monitored system another IP address must be specified To conduct pings from the RHN Server to a system or IP address use the standard Ping probe instead Refer to Section 8 5 Network Services Ping Requirements The Red Hat Network Monitoring Daemon rhnmd must be running on the monitored system to execute this probe Field Value IP Address Packets ...

Page 268: ...RPCService settings 8 9 Network Services Secure Web Server HTTPS The Network Services Secure Web Server HTTPS probe determines the availability of the secure Web server and collects the following metric Remote Service Latency The time it takes in seconds for the HTTPS server to answer a connection request This probe confirms that it can connect to the HTTPS port on the specified host and retrieve ...

Page 269: ...se the probe displays the protocol and server version information If the probe receives an invalid response it displays the message returned from the server and generates a WARNING state Field Value SSH Port 22 Timeout 5 Critical Maximum Remote Service Latency Warning Maximum Remote Service Latency Table C 46 Network Services SSH settings 8 11 Network Services Web Server HTTP The Network Services ...

Page 270: ... necessary to monitor all virtual hosts on the machine Field Value URL Path Virtual Host Expect Header HTTP 1 Expect Content UserAgent NOCpulse check_http 1 0 Username Password Timeout 10 HTTP Port 80 Critical Maximum Remote Service Latency Warning Maximum Remote Service Latency Table C 47 Network Services Web Server HTTP settings 9 Oracle 8i and 9i The probes in this section may be applied to ins...

Page 271: ...ed Server MTS must contact Red Hat support to have entries added to the RHN Server s etc hosts file to ensure that the DNS name is resolved correctly 9 1 Oracle Active Sessions The Oracle Active Sessions probe monitors an Oracle instance and collects the following metrics Active Sessions The number of active sessions based on the value of V PARAMETER PROCESSES Available Sessions The percentage of ...

Page 272: ...at have been blocking for this duration which is measured in seconds are counted as blocking sessions Field Value Oracle SID Oracle Username Oracle Password Oracle Port 1521 Time Blocking seconds 20 Timeout 30 Critical Maximum Blocking Sessions Warning Maximum Blocking Sessions Table C 50 Oracle Blocking Sessions settings 9 4 Oracle Buffer Cache The Oracle Buffer Cache probe computes the Buffer Ca...

Page 273: ...e Client Connectivity probe determines if the database is up and capable of receiving connections from the monitored system This probe opens an rhnmd connection to the system and issues a sqlplus connect command on the monitored system The Expected DB name parameter is the expected value of V DATABASE NAME This value is case insensitive A CRITICAL status is returned if this value is not found Requ...

Page 274: ... number of blocks accessed via single block gets not through the consistent get mechanism Cache Misses The number of accesses made to the block buffer to retrieve data in a consistent mode Field Value Oracle SID Oracle Username Oracle Password Oracle Port 1521 Timeout 30 Warning Minimum Data Dictionary Hit Ratio Critical Minimum Data Dictionary Hit Ratio Table C 53 Oracle Data Dictionary Cache set...

Page 275: ...or this duration which is measured in seconds are counted as idle sessions Field Value Oracle SID Oracle Username Oracle Password Oracle Port 1521 Time Idle seconds 20 Timeout 30 Critical Maximum Idle Sessions Warning Maximum Idle Sessions Table C 55 Oracle Idle Sessions settings 9 9 Oracle Index Extents The Oracle Index Extents probe monitors an Oracle instance and collects the following metric A...

Page 276: ...metrics Library Cache Miss Ratio The rate at which a library cache pin miss occurs This happens when a session executes a statement that it has already parsed but finds that the statement is no longer in the shared pool Executions The number of times a pin was requested for objects of this namespace Cache Misses The number of pins of objects with previous pins since the object handle was created t...

Page 277: ...le Port 1521 Timeout 30 Critical Maximum Active Locks Warning Maximum Active Locks Table C 58 Oracle Locks settings 9 12 Oracle Redo Log The Oracle Redo Log probe monitors an Oracle database instance and collects the following metrics Redo Log Space Request Rate The average number of redo log space requests per minute since the server has been started Redo Buffer Allocation Retry Rate The average ...

Page 278: ...n amount of space configured when the table is created Extents are configured on a per table basis with an extent size and a maximum number of extents For example a table that starts with 10 MB of space and that is configured with an extent size of 1 MB and max extents of 10 can grow to a maximum of 20 MB by being extended by 1 MB ten times This probe can be configured to alert by 1 the number of ...

Page 279: ...ed pool of space in which a set of tables live This probe alerts the user when the total amount of available space falls below the threshold Tablespace is measured in bytes so extents do not factor into it directly though each extension removes available space from the shared pool The required Tablespace Name field is case insensitive and contains a default value of that matches any table name Fie...

Page 280: ...performance Since these probes run locally no specific application or transport protocols are required 10 1 RHN Satellite Server Disk Space The RHN Satellite Server Disk Space probe monitors the free disk space on a Satellite and collects the following metrics File System Used The percent of the current file system now in use Space Used The file size used by the current file system Space Available...

Page 281: ...robe monitors the interface traffic on a Satellite and collects the following metrics Input Rate The amount of traffic in bytes per second the device receives Output Rate The amount of traffic in bytes per second the device sends Field Value Interface eth0 Timeout seconds 30 Critical Maximum Input Rate Critical Maximum Output Rate Table C 65 RHN Satellite Server Interface Traffic settings 10 4 RHN...

Page 282: ... 5 and 15 minute period Field Value Critical Maximum 1 minute Average Warning Maximum 1 minute Average Critical Maximum 5 minute Average Warning Maximum 5 minute Average Critical Maximum 15 minute Average Warning Maximum 15 minute Average Table C 67 RHN Satellite Server Load settings 10 6 RHN Satellite Server Probe Count The RHN Satellite Server Probe Count probe monitors the number of probes on a...

Page 283: ...ore their executions could be completed Sleeping A process that is in the Interruptible sleep state and that can later be reintroduced into memory resuming execution where it left off Field Value Critical Maximum Blocked Processes Warning Maximum Blocked Processes Critical Maximum Child Processes Warning Maximum Child Processes Critical Maximum Defunct Processes Warning Maximum Defunct Processes C...

Page 284: ...tack space A thread is also called a lightweight process Physical Memory Used The amount of physical memory in kilobytes being used by the specified process Virtual Memory Used The amount of virtual memory in kilobytes being used by the specified process or the size of the process in real memory plus swap Specify the process by its command name or process ID PID Entering a PID overrides the entry ...

Page 285: ...llite Server Process Running settings 10 11 RHN Satellite Server Swap The RHN Satellite Server Swap probe monitors the percent of free swap space available on a Satellite A CRITICAL status results if the value falls below the Critical threshold A WARNING status results if the value falls below the Warning threshold Field Value Critical Minimum Swap Percent Free Warning Minimum Swap Percent Free Ta...

Page 286: ...Field Value Warning Maximum Users Table C 74 RHN Satellite Server Users settings Appendix C Probes 272 ...

Page 287: ... A base channel is a type of Channel that consists of a list of packages based on a specific architecture and Red Hat release For example all the packages in Red Hat Enterprise Linux AS 3 for the x86 architecture make a base channel Bug Fix Alert An Errata Alert that pertains to a bug fix Bugzilla Bugzilla is an online application http www redhat com bugzilla1 that allows users to communicate dire...

Page 288: ...by the report Enhancement Alert An Errata Alert that pertains to a package enhancement request Entitled Server A server that is subscribed to an RHN service level Because the server is entitled the RHN website can be used to manage its packages Errata Information published by Red Hat describing security fixes bug fixes and package enhancements for Red Hat Enterprise Linux The information includes ...

Page 289: ...inistrator are sets of users that have the highest level of control over an organization s Red Hat Network account Members of this group can add users systems and system groups to the organization as well as remove them An Satellite Administrator can also give users administrative privileges to system groups An RHN organization must have at least one member of the Satellite Administrator group P P...

Page 290: ...llows users to retrieve and install all updated packages for the client system on which the application is run Use the 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 Inc It can be used to build install query verify update and uninstall software pack...

Page 291: ... numbers that identifies a registered system It is stored in the system s Digital Certificate System Profile Hardware and software information about the client system It is created during the registration process The software information is a list of RPM packages and their versions installed on the client system The System Profile is used to determine every Errata Alert relevant to each client sys...

Page 292: ...ain 0 or dom0 Y Yellowdog Updater Modified yum The Yellowdog Updater Modified is the Red Hat Network client application yum that allows users to retrieve and install new or updated packages for the client system on which the application is run Glossary 278 ...

Page 293: ...oftware and Configuration Files 124 channels 124 all 126 base 124 child 124 errata 127 list of 124 packages 127 relevant 125 retired 126 Channels and Packages Channel List 124 child channel 124 client applications obtaining 6 redirecting 197 client systems configuring 197 registering 198 updating 199 config management system preparation 131 configuration actions 131 channel create 132 files 131 Sc...

Page 294: ...alization script etc init d rhnsd 39 etc rc d init d rhnsd 39 K kickstart explained 109 L Linux CPU Usage 234 Disk IO Throughput 235 Disk Usage 235 Inodes 236 Interface Traffic 236 Load 237 Memory Usage 238 probes nocpulse 234 Process Count Total 239 Process Counts by State 238 Process Health 239 Process Running 241 Swap Usage 241 TCP Connections by State 242 Users 243 Virtual Memory 243 List Navi...

Page 295: ...70 filtering 170 receiving 168 redirecting 169 ntsysv 39 O Oracle Active Sessions 257 Availability 257 Blocking Sessions 258 Buffer Cache 258 Client Connectivity 259 Data Dictionary Cache 260 Disk Sort Ratio 260 Idle Sessions 261 Index Extents 261 Library Cache 262 Locks 263 probes 256 Redo Log 263 Table Extents 264 Tablespace Usage 265 TNS Ping 265 overview of website 62 P package installation sc...

Page 296: ... 258 Buffer Cache 258 Client Connectivity 259 Data Dictionary Cache 260 Disk Sort Ratio 260 Idle Sessions 261 Index Extents 261 Library Cache 262 Locks 263 Redo Log 263 Table Extents 264 Tablespace Usage 265 TNS Ping 265 RHN Satellite Server Disk Space 266 Execution Time 267 Interface Traffic 267 Latency 267 Load 268 Probe Count 268 Process Counts 269 Process Health 270 Process Running 271 Process...

Page 297: ...SH key installation 166 using sshd instead 165 Red Hat Network packages comparison 7 Red Hat Network Registration Client rhn _register initial description 2 Red Hat packages for UNIX 193 installing 193 Red Hat Update Agent 44 Command Line Arguments 25 configuration 30 UNIX Command Line Arguments 203 with a proxy server 31 Red Hat Update Agent up2date activation keys 35 command line options 26 comm...

Page 298: ...Actions 139 Completed Actions 139 Failed Actions 139 Pending Actions 139 Scout Config Push 163 Secure Sockets Layer 6 security overview 5 service levels Management 3 Monitoring 4 Provisioning 4 Update 2 Software Channel List Channel Details 126 Package Search 128 software searching 128 software channels details 126 SSH 165 SSH key 166 sshd 165 SSL setting up 197 SSL certificates deploying 197 SSL ...

Page 299: ...roles 143 V variables macros in configuration files 135 W WebLogic Execute Queue 227 Heap Free 228 JDBC Connection Pool 228 probes 226 Server State 229 Servlet 229 website 61 activation keys 103 All Errata 121 Channel List 124 Channels 124 custom system information 107 Errata 119 Errata Search 123 Help 160 language 72 locale 72 logging in 66 Monitoring 147 navigation bar 61 overview 61 Relevant Er...

Page 300: ...Your Preferences 71 Index 286 ...

Reviews:

No comments

Brands by name

Popular brands

Load more brands