Internet Information Server User s Guide

Transcription

1 IBM Tioli Monitoring for Web Infrastructure Internet Information Serer User s Guide Version SH

2

3 IBM Tioli Monitoring for Web Infrastructure Internet Information Serer User s Guide Version SH

4 Note Before using this information and the product it supports, be sure to read the general information under Notices on page 119. ISO 9001 Certification This product was deeloped using an ISO 9001 certified quality system. Certification has been awarded by Bureau Veritas Quality International (BVQI) (Certification No. BVQI /A). BVQI is a world leader in quality certification and is currently recognized by more than 20 accreditation bodies. First Edition (September 2002) This edition applies to ersion 5 release 1 modification leel 0 of IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation All rights resered. Note to U.S. Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corporation.

5 Contents About this guide Who should read this guide Publications Accessibility ii Contacting Customer Support iii Conentions used in this guide iii Chapter 1. Oeriew of IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer Aailability management Performance management Operations management Oeriew of IBM Tioli Monitoring Understanding IBM Tioli Monitoring Authorization roles Managed resources and endpoints User interface options Chapter 2. Setting up Tioli Monitoring for Web Infrastructure: Internet Information Serer Setting authorization roles Creating Tioli Monitoring for Web Infrastructure: Internet Information Serer objects Distributing profiles Chapter 3. Setting up the Tioli Enterprise Console for eent correlation Oeriew of the Tioli Enterprise Console for eent correlation Configuring the Tioli Enterprise Console eent serer Chapter 4. Integrating with Tioli Business Systems Manager Understanding Tioli Business Systems Manager.. 27 Prerequisites Configuring the Tioli Enterprise Console to forward eents to Tioli Business Systems Manager. 28 Installing Tioli Monitoring for Web Infrastructure: Internet Information Serer integration Discoering resources for Tioli Business Systems Manager Working with Tioli Business Systems Manager.. 34 Uninstalling Tioli Monitoring for Web Infrastructure: Internet Information Serer integration from Tioli Business Systems Manager. 35 Chapter 5. Working with IBM Tioli Monitoring resource models Customizing indications Adding or remoing built-in action Editing a built-in action Specifying tasks for an eent Sending a notice to administrators when an eent occurs Customizing parameters Creating scheduling rules Customizing the scheduling monitoring period.. 53 Customizing data logging information Managing profiles and resource models at endpoints 57 Managing IBM Tioli monitoring gateways Determining which resource models hae been distributed to endpoints Viewing resource models results with the IBM Tioli Monitoring Web Health Console Chapter 6. Working with Tioli Monitoring for Web Infrastructure: Internet Information Serer resources. 61 Showing object properties Refreshing object properties Checking the status of a Web serer Checking the status of a Web site Starting or stopping a Web serer Starting or stopping a Web site Chapter 7. Working with tasks and jobs 67 Running a task Customizing the Start Site and Stop Site tasks Creating a job Running a job Scheduling a job Chapter 8. Enabling Tioli Monitoring for Web Infrastructure: Internet Information Serer for Tioli Enterprise Data Warehouse Oeriew Uploading data to the central data warehouse Working with users and user groups Creating an IBM Console user Assigning roles to a user Creating a user group Assigning users to a user group Assigning user groups to a data mart Managing Tioli Enterprise Data Warehouse reports 89 Running reports Scheduling reports to run automatically Modifying default settings for reports Creating reports Creating a Many Measurements Versus Time report 93 Appendix A. Setting up IBM Tioli Monitoring iii

6 Creating profile managers and profiles Subscribing resources to profile managers Adding default resource models to profiles Adding customized resource models to profiles 100 Rerunning a failed profile distribution Appendix B. Creating customized resource models using CIM classes. 103 Working with IBM Tioli Monitoring Workbench 103 Getting started with the Resource Model Wizard 103 Appendix C. Tasks quick reference 105 Appendix D. Eent classes and rules 107 Eent classes Rules for eents Appendix E. Problem determination 109 Logs and traces Possible problems and solutions Appendix F. Accessibility Using assistie technologies Magnifying what is displayed on the screen Documentation in accessible formats Using alternatie text Notices Trademarks Index i IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

7 About this guide Who should read this guide Publications The IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide proides information about setting up and using IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer to monitor the aailability and performance of your Microsoft Internet Information Serer instances and sites. The target audience for this guide is administrators and system programmers who use IBM Tioli Monitoring for Web Infrastructure to manage Internet Information Serer resources. Readers should be familiar with the following: Installing and managing the Tioli Management Framework and the Tioli Management Enironment Monitoring the system by using IBM Tioli Monitoring You should also be familiar with the following: Tioli Enterprise Console Tioli Business Systems Manager Tioli Enterprise Data Warehouse This section lists publications in the IBM Tioli Monitoring for Web Infrastructure library and any other related documents. It also describes how to access Tioli publications online, how to order Tioli publications, and how to make comments on Tioli publications. Tioli Monitoring for Web Infrastructure: Internet Information Serer library The following documents are aailable in the IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer library: IBM Tioli Monitoring for Web Infrastructure: Installation and Setup Guide, GC Describes the procedures to install and set up IBM Tioli Monitoring for Web Infrastructure products. IBM Tioli Monitoring for Web Infrastructure: Reference Guide, GC Proides detailed programming information about the Tioli Monitoring for Web Infrastructure: Internet Information Serer resource models, tasks, commands, and error messages. IBM Tioli Monitoring for Web Infrastructure: Release Notes, GI Proides the most current information about IBM Tioli Monitoring for Web Infrastructure products. IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide, SH Describes how to use IBM Tioli Monitoring for Web Infrastructure with Micorosoft Internet Information Serer.

8 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer Workaround and Limitations Supplement, SH Proides information about problems that might occur, as well as customer issues that hae been resoled. Roadmap for a Typical Installation of IBM Tioli Monitoring for Web Infrastructure, GI Proides information about using an installation wizard to deploy IBM Tioli Monitoring for Web Infrastructure in a typical Tioli enironment. The Tioli Glossary includes definitions for many of the technical terms related to Tioli software. The Tioli Glossary is aailable, in English only, at the following Web site: Prerequisite publications To use the information in this guide effectiely, you must hae some prerequisite knowledge of IBM Tioli Monitoring, which you can get from the following books: IBM Tioli Monitoring: User s Guide, SH Describes how to install, customize, and use IBM Tioli Monitoring to manage system and application resources. IBM Tioli Monitoring: Workbench User s Guide, SH Describes how to use IBM Tioli Monitoring Workbench to create new resource models or to modify existing ones. Related publications The following publications also proide useful information: Tioli Management Framework: User s Guide Describes the concepts and procedures for using Tioli Management Framework serices. It proides instructions for performing tasks from the Tioli desktop and from the command line. Tioli Management Framework: Reference Manual Proides in-depth information about Tioli Management Framework commands. It also documents Tioli-proided policy scripts. Tioli Enterprise Data Warehouse: Installing and Configuring Describes how Tioli Enterprise Data Warehouse fits into your enterprise, explains how to plan for its deployment, and gies installation and configuration instructions. Tioli Enterprise Data Warehouse: Enabling an Application for Tioli Enterprise Data Warehouse Proides information describing the tasks related to connecting an application into the Tioli Enterprise Data Warehouse. Tioli Monitoring Warehouse Enablement Pack: Implementation Guide Describes how to install the extract, transform, and load (ETL) utilities to extract and moe data from Tioli application data stores to a central data warehouse database. Tioli Business Systems Manager: User s Guide Introduces Tioli Business Systems Manager and explains the commands and features of the product. Tioli Business Systems Manager: Installation and Configuration Guide Describes how to install and configure Tioli Business Systems Manager. i IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

9 Accessing publications online Publications in the product libraries are included in PDF or HTML formats, or both, on the product CD. To access the publications using a Web browser, open the infocenter.html file, which is located in the appropriate publications directory on the product CD. When IBM publishes an updated ersion of one or more online or hardcopy publications, they are posted to the Tioli Information Center. You can access updated publications in the Tioli Information Center from the following Customer Support Web site: The Tioli Information Center contains the most recent ersion of the books in the product library in PDF or HTML formats, or both. Translated documents are also aailable for some products. Note: If you print PDF documents on other than letter-sized paper, select the Fit to page check box in the Adobe Acrobat Print dialog box (which is aailable when you click File Print) to ensure that the full dimensions of a letter-sized page are printed on the paper that you are using. Ordering publications You can order many Tioli publications online at the following Web site: Accessibility You can also order by telephone by calling one of these numbers: In the United States: In Canada: In other countries, for a list of telephone numbers, see the following Web site: Proiding feedback about publications We are ery interested in hearing about your experience with Tioli products and documentation, and we welcome your suggestions for improements. If you hae comments or suggestions about Tioli products and documentation, contact us in one of the following ways: Send an to pubs@tioli.com. Complete the customer feedback surey at the following Web site: Accessibility features help users who hae physical disabilities, such as restricted mobility or limited ision, to use software products successfully. With this product, you can use assistie technologies to hear and naigate the interface. You can also use the keyboard instead of the mouse to operate all features of the graphical user interface. For additional information about the accessibility features of this product, see Appendix F, Accessibility on page 117. About this guide ii

10 Contacting Customer Support If you hae a problem with any Tioli product, you can contact Customer Support for Tioli products. See the Customer Support Handbook at the following Web site: The handbook proides information about how to contact Customer Support, depending on the seerity of your problem, and the following information: Registration and eligibility Conentions used in this guide Telephone numbers and addresses, depending on the country in which you are located What information you should gather before contacting Customer Support This guide uses seeral conentions for special terms and actions, operating system-dependent commands and paths, and margin graphics. Typeface conentions The following typeface conentions are used in this guide: Bold Italic Monospace Lowercase and mixed-case commands, command options, and flags that appear within text appear like this, in bold type. Graphical user interface elements (and names of keys also appear like this, in bold type. Variables, alues you must proide, new terms, and words and phrases that are emphasized appear like this, in italic type. Commands, command options, and flags that appear on a separate line, code examples, output, and message text appear like this, in monospace type. Text strings you must type, when they appear within text, names of Jaa methods and classes, and HTML and XML tags also appear like this, inmonospace type. Operating system-dependent ariables and paths This book uses the UNIX conention for specifying enironment ariables and for directory notation. When using the Windows command line, replace $ariable with %ariable% for enironment ariables and replace each forward slash (/) with a backslash (\) in directory paths. Note: If you are using the bash shell on a Windows system, you can use the UNIX conentions. iii IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

11 Chapter 1. Oeriew of IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer (hereinafter also referred to as product) proides a centralized system management tool for Internet Information Serer on the Tioli platform. The product facilitates the management of Internet Information Serer instances on Tioli Management Framework endpoints. Tioli Monitoring for Web Infrastructure: Internet Information Serer is based on the IBM Tioli Monitoring architecture. The product introduces a resource model category named Internet Information Serer, with four resource models. The product proides the ability to register a set of Internet Information Serer instances that are installed in your network, to collect their configurations in order to manage them. Once you hae registered your Internet Information Serer resources, use the product resource models and management functions to: Start, stop, and retriee the status of your Internet Information Serer instances and sites. Monitor key performance and aailability of Web sites hosted by Internet Information Serer. Forward Tioli Monitoring for Web Infrastructure: Internet Information Serer eents to the IBM Tioli Enterprise Console. Note: If you want to send secure eents to the Tioli Enterprise Console serer, the Adapter Configuration Facility must be installed. This guide address eent management topics with the assumption that Tioli Enterprise Console and Tioli Adapter Configuration Facility are installed where required. Forward Tioli Monitoring for Web Infrastructure: Internet Information Serer eents to Tioli Business Systems Manager. Note: To send eents to Tioli Business Systems Manager, Tioli Enterprise Console must be installed. Store historical data on Tioli Enterprise Data Warehouse. To ensure that you are managing all Tioli Monitoring for Web Infrastructure: Internet Information Serer resources aailable, the product proides a discoery function that finds the sites hosted by the Internet Information Serer. As the discoery function finds new Tioli Monitoring for Web Infrastructure: Internet Information Serer resources, they are added to your Tioli configuration. Refer to the following sections to learn how Tioli Monitoring for Web Infrastructure: Internet Information Serer proides: Aailability management Performance management Operations management 1

12 Aailability management Performance management Operations management Tioli Monitoring for Web Infrastructure: Internet Information Serer proides resource models, or groups of monitors, that periodically check the status of your Internet Information Serer and its hosted sites. The status of can be either up (operational) or down (non-operational). You can customize the resource models to meet your local requirements. The product resource models enable you to measure and report the performance of the sites hosted by your Internet Information Serer resources, to identify bottlenecks and potential problems in your Web infrastructure, such as: Traffic Access Error conditions Tioli Monitoring for Web Infrastructure: Internet Information Serer enables you to manage your Internet Information Serer resources on a daily basis. You can: Start and stop Internet Information Serer instances and Web sites Check the status and retriee information about your Internet Information Serer resources Oeriew of IBM Tioli Monitoring IBM Tioli Monitoring enables you deploy preconfigured best practices resource models as well as standard and customized resource models to automate the monitoring of essential resources. In this context, a resource is anything that affects the operation of a computer system and includes physical and logical disks, CPUs, memory, printers, as well as the processes running, and the serices, such as LanMan, the Windows eent log, the UNIX syslogd (logging system daemon) and TCP/IP. This enables you to detect bottlenecks and other potential problems and define automatic recoery from critical situations. This ability frees system administrators from manually scanning extensie performance data. The monitoring software integrates with other Tioli Aailability solutions, including Tioli Business Systems and Tioli Enterprise Console. A resource model captures and returns information, such as database status or serer aailability, about a resource or software application in the Tioli management enironment. To use a resource model, you must define and distribute it to an endpoint. Tioli proides tools for organizing system resources on the Tioli desktop. A profile manager is the top leel of organization. Serers are subscribed to profile managers. These subscriptions proide the channel through which resource models are distributed to serers. A profile manager also can contains profiles, which are containers for application-specific information about a particular type of resource. Each profile contains one or more resource models. You can subscribe resources to a pre-defined profile manager. You can distribute indiidual profiles within the profile manager to subscribers of the profile manager. You can group profile managers in a way that meets your needs. Profile managers can reflect functional grouping of resources, functional grouping of resource models, or any grouping at all. Likewise, a profile can contain any combination of resource models. 2 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

13 You must segregate profiles according to resources: Web serers need Web serer monitors, and database serers need database serer monitors. You can define each resource model to include information such as how often to check the serer resource status and what to do when certain conditions are met. Some resource models proide predefined settings and response actions, which you can adjust. Other resource models require you to define all the settings. See the IBM Tioli Monitoring for Web Infrastructure: Reference Guide for a description of indiidual settings. Before running a resource model, you must subscribe the serer resource to the profile manager that contains the profile in which the resource model is stored. You can distribute the profile to the resource. By default, resource models are set up to become actie when you distribute them to subscribers. You can actiate and deactiate resource models after they are distributed. Understanding IBM Tioli Monitoring This section describes the main concepts required for understanding how to set up and use resource models. IBM Tioli Monitoring uses resource models to product monitor and manage resources at distributed systems. A managed resource is a database object that represents a hardware, software, or data entity that you manage according to policies set up in a Tioli enironment. Managed resources can include physical and logical disks, CPUs, memory, printers, processes, and serices. A distributed system is the serice that monitors resources, compares data from monitored resources against configured thresholds, and runs automated responses in a Tioli enironment. Actions You can associate one or more recoery actions with a specific eent. These actions are automatically triggered when the eent occurs and, typically, are used for restoring satisfactory system serice leel. Each time an eent occurs, the system proides a notification of the eent, triggers a recoery action to restore satisfactory conditions and, if the action is successful, proides a notification that the action was performed. Actions are associated with the execution of a CIM method or the execution of a program. Associate actions with indications when modifying an existing resource model using this software, or when creating a new resource model with the IBM Tioli Monitoring Workbench. Attributes Attributes can be string or numeric alues. A resource model receies attributes when it is created. In Tioli Monitoring for Web Infrastructure: Internet Information Serer, you do not add, delete, or modify attributes that are in the default resource models. When creating a new resource model with the IBM Tioli Monitoring Workbench, you can qualify an eent by specifying releant attributes according to the information you want the resource model to monitor. For example, an eent might indicate insufficient disk space. When you specify attributes, such as disk name, or aailable disk space, the resource model can generate a more precise indication of the problem. For each resource model, some of the attributes are designated as keys. Cycles When a resource model runs at an endpoint, it gathers data at regular interals, called cycles; the duration of a cycle is the cycle time, which is displayed in seconds. A resource model with a cycle time of 60 seconds gathers data eery 60 seconds. Each of the supplied resource models has a default cycle time that you can modify when you define the resource Chapter 1. Oeriew of IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer 3

14 model. At each cycle, the resource model collects data, analyzes it, generates the eents, and triggers specified actions. The data collected are a snapshot of the status of the resources specified in the resource model. Heartbeat function In addition to the monitoring processes described in this guide, IBM Tioli Monitoring operates a heartbeat function, which monitors the basic system status at endpoints attached to the gateway at which it is enabled. Eents can be sent to the Tioli Business Systems Manager (proided that the Tioli Business Systems Manager Adapter component is installed at the gateway), the Tioli Enterprise Console, and the IBM Tioli Monitoring Notice Group. Indications and eents An indication is generated when the state of a gien resource meets defined criteria. By itself, an indication does not trigger any specific action. When indications are aggregated, the resource model generates an eent. When you define an eent, you must specify under what conditions a certain number of indications are aggregated into an eent. You also specify whether these indications must be consecutie, or whether the sequence may be interrupted by one or more monitoring cycles that do not register any indication. The cycles during which no indication is generated are called holes. An eent can notify that there is a problem in the resource state, trigger an action and, if enabled, send a notification to the Tioli Enterprise Console serer or to the Tioli Business Systems Manager. Indications Each resource model generates an indication if certain conditions implied by the resource model thresholds are not satisfied in a gien cycle. Each resource model uses an algorithm to determine which combinations of thresholds generate an indication. Indications can be generated in any one of the following circumstances: When a single threshold is exceeded. For example, in the Windows Process resource model, the Process High CPU indication is generated when the High CPU Usage threshold is exceeded (for any process that has a non-zero process ID). When a combination of two or more thresholds are exceeded. For example, in the Windows Logical Disk resource model a High Read Bytes per Second indication is generated when both the following thresholds are exceeded: The amount of bytes transferred per second (being written or read) exceeds the High Bytes per Second threshold The percentage of time that the selected disk drie spends making read or write requests exceeds the High Percent Usage threshold. When a combination of other factors change. For example, in the Windows Process resource model the Process Handle Leak indication is generated when a process is losing memory. There is no threshold for this indication. The resource model compares the number of handles of the fie processes with the most handles in consecutie cycles. If the number of handles has increased, the indication is generated. Occurrences and holes Occurrences and holes record whether or not an indication occurs during the cycle for a specific resource model. An occurrence is a cycle during which at least one threshold is exceeded and an indication occurs for a gien resource model. A hole is a cycle during which an 4 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

15 indication does not occur for a gien resource model. A hole means none of the conditions that generate an indication were met, but it does not necessarily mean that no thresholds were exceeded. For example, in the Windows Logical Disk resource model a High Read Bytes per Second indication is not created when the percentage disk time is higher than the High Percent Usage threshold, proided that the Low Disk Space threshold is exceeded. Eents An eent erifies the persistence of a gien indication, by eliminating unrepresentatie peaks and troughs for the indication. For example, a process that generates the Process High CPU indication in one cycle might not threaten other processes if the high usage is not repeated. Howeer, an indication that persists oer seeral cycles is more likely to be a problem. Thus, an eent defines the significant number of consecutie occurrences of the indication. When you define an eent, you can specify how many consecutie holes in the sequence of consecutie occurrences are permitted. Specifying how many consecutie holes are permitted during the accumulation of the consecutie occurrences enables you to conitune the counting of consecutie occurrences if one or two cycles fall below the threshold. An eent is an aggregation of a defined number of consecutie occurrences during which there can be a defined number of consecutie holes. An eent is generated only when the aggregation algorithm detects three consecutie occurences. The following examples illustrate what happens if you define an eent as three occurrences and two holes. 1 represents an occurrence and 0 represents a hole Because fewer than three holes exist between each of the three occurrences, the three occurences are consecutie. Therefore, the sequence represents an eent If each occurrence is followed by the maximum specified holes within seen cycles, an eent is triggered If the algorithm counts two consecutie occurrences and then obseres three consecutie holes (more holes than that allowed in the definition of an eent for this example) it sets the count of occurrences to zero. See Table 1 Table 1. Counting occurrences Sequence Count of Occurrences Chapter 1. Oeriew of IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer 5

16 The snapshots of the CPU usage obtained by the resource model are shown in Table 2. The first row shows the cycle number and the second the percentage of CPU usage. Table 2. High CPU Usage percentages oer 12 cycles: holes and occurrences Cycle CPU% Occurrence H O H O O H H O O H O O or Hole Occurrence Count Cycles that exceed the threshold, and are thus occurrences, are shown in bold type; the other cycles are holes. For this example, an eent is created for this indication if there are four consecutie occurrences with only one hole permitted. The final row in Table 2 shows the count that the resource model makes of the consecutie occurrences. The count is set to zero at the 7th cycle snapshot because the resource model has encountered two consecutie holes. In this example, an eent is triggered in the 12th cycle. The count is then set to zero and the process continues. While defining an eent, you can also indicate if you want the system to notify the Tioli Enterprise Console serer, or the Tioli Business Systems Manager, that an eent was generated. The Tioli Monitoring operator can change these selections later, when the resource model is included in a Tioli Monitoring profile. You can also define the degree of seerity and the message that will specify the notification of the eent. Clearing eents A clearing eent is a resource model function that, if enabled, allows IBM Tioli Monitoring to close an error eent when the circumstances that caused the eent are no longer present. Clearing eents can be processed by the Tioli Enterprise Console serer and by Tioli Business Systems Manager. Clearing eents hae a seerity of harmless, regardless of the seerity of the original eent, but hae the same eent ID as the original eent. For example, a serice stops and the Tioli Enterprise Console serer receies an eent notifying it of this problem. Until the serice restarts, the problem is still present on the endpoint, but IBM Tioli Monitoring does not send any further eent notifications to the Tioli Enterprise Console serer. If the Clearing Eent function is enabled, as soon as the serice restarts, a clearing eent is sent to the Tioli Enterprise Console serer, thereby closing the original eent. The Clearing Eent itself does not normally appear on the serer, because its only function is to clear the original error eent. Note: Correlated eents cannot be cleared. Monitoring of eents and indications Eents can be sent to the Tioli Enterprise Console serer, the Web Health Console, and Tioli Business Systems Manager. 6 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

17 Tioli Enterprise Console serer Eents can be iewed by a Tioli Enterprise Console serer proided that you hae compiled and loaded the releant Basic Recorder of Objects in C (BAROC) files on the serer. The eent contains a set of properties that can help to identify the problem. For example, the information in the ProcessHandleLeak eent includes alues for the following: Current Process ID Number of handles allocated to the process Name of the process Clearing eents can also be processed by the Tioli Enterprise Console serer. If the default procedure is used to enable the monitoring of eents, the Tioli Enterprise Console serer uses the clearing eent to close the associated error eent. Howeer, if you choose not to install the clearing eents rule incorporated in the aboe-mentioned default procedure, the clearing eent is displayed as a separate entity with the same id as the original error eent. Web Health Console The Web Health Console, which is an optional part of IBM Tioli Monitoring, obtains eents and indications from endpoints. The Web Health Console displays the health of each potential problem as a numeric alue between 100 (perfect health) and zero (with zero meaning that the conditions for the corresponding eent hae been met). Intermediate alues show the percentage of occurrences currently registered with respect to the total number of occurrences needed to trigger an eent. For example, Table 3 is based on Table 2 on page 6, but additionally shows the health percentage: Table 3. High CPU Usage percentages oer 12 cycles: health Cycle CPU% Occurrence H O H O O H H O O H O O or Hole Occurrence Count Health (%) In this example, the health percentage changes in steps of 25% because 4 occurrences were required to trigger an eent; if the indication had required 5 occurrences, the health percentage would hae changed by steps of 20%. Tioli Business Systems Manager Eents can also be sent to the Tioli Business Systems Manager. A full description of Tioli Business Systems Manager can be found in the Tioli Business Systems Manager documentation. Clearing eents can also be processed by the Tioli Business Systems Manager, which uses the clearing eent to close the associated error eent. Logging For any endpoint, you can log the data collected by a resource model and Chapter 1. Oeriew of IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer 7

18 write it in a local database. Then you can iew it through the History View of the Web Health Console. You can choose to store raw or aggregated data. Parameters While thresholds can be only numeric alues, parameters can be lists of numbers or strings. Using parameters enables you to customize your resource model. You can define different parameters, as required. For each parameter you can specify a alue, which can be a list of numbers or strings. This list can represent the instances you want to monitor, or a limit you do not want your resource to exceed, depending on how you use this setting in your script. The lists will then be displayed in the Tioli Monitoring dialogs, and depending on the type of list you select in the workbench, the lists will appear in different forms on Tioli Monitoring. Within the workbench you can define default alues and then let the operator customize the settings in Tioli Monitoring. You can choose one among the following kinds of lists when you specify the parameters: Boolean List Choice List String List Numeric List Some resource models hae one or more parameters. For example, the Windows Parametric TCP/IP Ports resource model uses parameters that contain lists of ports and port states that you want to monitor. Profiles IBM Tioli Monitoring is a profile-based application that runs in a Tioli enironment. Different profiles can be defined containing different selections of resource models. All aspects of existing profiles can be modified, including the addition, deletion and customization of resource models. You can distribute multiple profiles to each endpoint. Recoery actions For any eent, recoery actions can be run automatically, such as built-in actions (for Windows) or Tioli Framework tasks. The actions can take positie steps to remedy the situation, or can ensure that information about the eent is distributed to the appropriate authorities or entities. Built-in actions Certain eents can hae one or more built-in actions predefined for them. An action can be either the execution of a CIM class method or the execution of a program. Both type of actions can be implemented only through the workbench. For example, an eent that detects the failure of a serice could hae the restart of that serice as its built-in action. Thus, without any human interention, IBM Tioli Monitoring detects the failure of a serice and automatically restarts it. Built-in actions are defined by default as part of an eent, but can be remoed. They hae the same eent ID as the eent that they are designed to correct. Tasks For each eent you can select one or more Tioli Framework tasks to be performed when the eent is triggered. The tasks that are triggered by a IBM Tioli Monitoring eent can access the eent name and eent thresholds of the triggering eent by accessing the enironment ariables. 8 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

19 Resource models IBM Tioli Monitoring products proide predefined resource models that access specific performance data from the system at runtime. (For example, the Process resouce model gathers data about processes running on the system.) The resource models process the data they collect using an algorithm that determines whether or not the system is performing to expectations. You can either use a resource model s default alues to collect performance data or customize the resource models to match specific requirements in your enironment. Distributing resource models using default alues enables you begin monitoring immediately to obtain useful data concerning your enterprise. When you become more familiar with the monitoring process and feedback, you may choose to customize the resource model information. Scheduling IBM Tioli Monitoring contains a scheduling feature that enables you to determine a period within which monitoring takes place and specific scheduling rules.the monitoring period is determined by defining a from and a to date. The scheduling rules enable you to define time periods on specific weekdays during which monitoring takes place. Any number of rules can be defined, allowing you to set up a complex pattern of resource monitoring for a profile, coering the time periods important to you. The scheduled times are always interpreted as local times, enabling you to set up a single rule that monitors the same local time period in different time zones. For example, if your region coers seeral time zones, but you want to monitor morning actiities in each time zone, a single rule defining the monitoring period of between 08:00 and 13:00 is interpreted locally in each of the time zones, so that you monitor the same relatie period. You should note also that all times of eents or actiities reported from endpoints or gateways are also logged in the local time of the system from where they originated. Tioli Enterprise Data Warehouse Support component The Tioli Enterprise Data Warehouse Support component enables the integration of IBM Tioli Monitoring with Tioli Enterprise Data Warehouse. Tioli Enterprise Data Warehouse Support also interacts with the Tioli Monitoring for Web Infrastructure: Internet Information Serer. For more information about the integration with Tioli Enterprise Data Warehouse and how to install, configure, and use Tioli Enterprise Data Warehouse Support, see the IBM Tioli Monitoring: User s Guide. For more information about Tioli Enterprise Data Warehouse, see the following publications: Tioli Enterprise Data Warehouse: Installing and Configuring Tioli Enterprise Data Warehouse: Enabling an Application for Tioli Enterprise Data Warehouse Tioli Monitoring Warehouse Enablement Pack: Implementation Guide Thresholds Each resource model defines one or more thresholds. A threshold is a named property of the resource with a default alue that you can modify in the customization phase. Typically, the alue specified for a threshold represents a significant reference leel of a performance-related entity, Chapter 1. Oeriew of IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer 9

20 which, if exceeded or not reached, a system administrator might want to know about. Howeer, some thresholds are used as reference alues to limit the scope of the resource model. For example, the Windows Process resource model uses the following thresholds: A threshold alue might represent a limit that, if not met, indicates an unsatifactory resource state. For example, if you want the system to notify you when disk space drops under 70%, set the threshold alue to 70 to generate an indication each time your disk space is less than 70%. Some threshold alues control the scope of what the resource model monitors. For example, the Windows Process resource model uses the Maximum Processes threshold to limit the number processes monitored for the highest usage of CPU. Thus, if you set the Maximum Processes threshold to 5, the resource model only reports on the the fie highest CPU-using processes. You can add a description for each threshold in the Threshold dialog explaining what each alue measures and how it is used within the monitoring algorithm. Authorization roles Tioli Monitoring for Web Infrastructure: Internet Information Serer fully integrates into Tioli security. To perform administration functions, administrators must hae authorization roles for both Tioli Monitoring for Web Infrastructure: Internet Information Serer and the Tioli management enironment. Tioli Monitoring for Web Infrastructure: Internet Information Serer authorization roles are hierarchical, meaning that an administrator with iiswebserer_super authorization automatically also has iiswebserer_admin and iiswebserer_user authorization. Tioli Monitoring for Web Infrastructure: Internet Information Serer includes the following authorization roles: iiswebserer_super Enables the administrator to create and delete an Internet Information Serer object. iiswebserer_admin Enables the administrator to start and stop an Internet Information Serer instance. This role is also required to refresh object properties. iiswebserer_user Enables the administrator to check the status and iew the properties of an Internet Information Serer object. Managed resources and endpoints A managed resource is a system or network resource that you manage with Tioli Framework. In Tioli, a managed resource is a specific resource that has a default policy defined in the policy region. An endpoint is a managed resource that is the target of a profile distribution, or a resource where a task or job is to be run. For Tioli Monitoring for Web Infrastructure: Internet Information Serer, an endpoint is always an Internet Information Serer object. 10 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

21 User interface options To manage Internet Information Serer resources, the Tioli endpoint must be installed on each Internet Information Serer. With Tioli Monitoring for Web Infrastructure: Internet Information Serer, you can use the following user interfaces: The Tioli desktop, which is the traditional Tioli graphical user interface (GUI) The command line interface (CLI) IBM Tioli Monitoring Web Health Console Tioli Enterprise Console Tioli Business Systems Manager Tioli Enterprise Data Warehouse Chapter 1. Oeriew of IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer 11

22 12 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

23 Chapter 2. Setting up Tioli Monitoring for Web Infrastructure: Internet Information Serer Setting authorization roles This chapter describes how to configure Tioli Monitoring for Web Infrastructure: Internet Information Serer, which inoles the following steps: 1. Assign the required authorization to one or more Tioli administrators, as explained in Setting authorization roles. 2. Create product objects for your Internet Information Serer components, as described in Creating Tioli Monitoring for Web Infrastructure: Internet Information Serer objects on page Distribute profiles, as described in Distributing profiles on page 16. Optionally, you can set up the Tioli Enterprise Console for eent correlation and the Tioli Business Systems Manager. For detailed information, see respectiely Chapter 3, Setting up the Tioli Enterprise Console for eent correlation, and Chapter 4, Integrating with Tioli Business Systems Manager. Objectie To assign the Tioli Monitoring for Web Infrastructure: Internet Information Serer authorization roles to perform operations. Background information When you install Tioli Monitoring for Web Infrastructure: Internet Information Serer, the following hierarchical roles are created: iiswebserer_super iiswebserer_admin iiswebserer_user To perform operations on Tioli Monitoring for Web Infrastructure: Internet Information Serer, a Tioli administrator must be assigned at least one of these roles. In addition, some operations require Tioli authority as defined by Tioli management region roles. A Tioli administrator must hae the required Tioli authority and hae been assigned one of the Tioli Monitoring for Web Infrastructure: Internet Information Serer roles to successfully run these tasks and processes. Required authorization role Administrator with root authority Before you begin Before setting authorization roles, you must hae installed Tioli Monitoring for Web Infrastructure: Internet Information Serer. For information about installation, see the IBM Tioli Monitoring for Web Infrastructure: Installation and Setup Guide. When you finish Not applicable. Procedure You can perform this procedure from either the command line or Tioli desktop. 13

24 Command line: Run the wsetadmin command to set or change resource authorization roles. For more information about the command syntax, see the Tioli Management Framework: Reference Manual. Desktop: Perform the following steps: 1. Double-click the Administrators icon to display the Administrators window showing the defined Tioli administrators. 2. Right-click the administrator whose role you want to modify. 3. From the pop-up menu, select Edit TMR Roles to display the Set TMR Roles dialog box. 4. Add or remoe roles for the selected administrator, as follows: To add roles, select one or more roles from the Aailable Roles scrolling list and click the left-arrow button to moe them to the Current Roles scrolling list. To remoe roles, select one or more roles from the Current Roles scrolling list and click the right-arrow button to moe them to the Aailable Roles scrolling list. Note: The list of roles might include others not mentioned here, depending on the particular applications installed. 5. Click Change or Change & Close to set the authorization roles. A dialog box is displayed to inform you that to make your settings effectie, you must close and open the Tioli desktop again. 6. Click Dismiss to close the dialog box. 14 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

25 Creating Tioli Monitoring for Web Infrastructure: Internet Information Serer objects Objectie To create Tioli Monitoring for Web Infrastructure: Internet Information Serer objects that represent your Internet Information Serer resources. Background information Before you can manage your Internet Information Serer resources, you must first register them in your Tioli enironment by creating specific Internet Information Serer objects in a policy region. When you install Tioli Monitoring for Web Infrastructure: Internet Information Serer, a policy region named Monitoring for Internet Information Serer is automatically created for you to operate. To create Internet Information Serer objects in a different policy region, you must first add the IISWebSerer managed resource to the required policy region. Required authorization role iiswebserer_super Before you begin Before creating the product objects, ensure that: Any systems that you want to manage with Tioli Monitoring for Web Infrastructure: Internet Information Serer must hae Internet Information Serer, Version 4 or 5, installed and be configured as Tioli endpoints. See the Tioli Management Framework Reference Manual for information about configuring Tioli endpoints. You set the required authorization roles. For more information, see Setting authorization roles on page 13. When you finish The Internet Information Serer object that you created is added to the Policy Region window. Procedure You can perform this procedure from either the command line or Tioli desktop. Command line: Run the wiisws command with the c parameter to create objects. For more information about the command syntax, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Note: From the command line, you can create Internet Information Serer objects only in the Monitoring for Internet Information Serer policy region. Chapter 2. Setting up the serer enironment 15

26 Desktop: Perform the following steps: 1. Double-click a policy region icon to display the Policy Region window. 2. From the Create menu, select IISWebSerer to display the Create Internet Information Serer Object dialog box. Distributing profiles 3. Enter the label of the Managed Node where the object is to be located, or click Managed Nodes to select one label from the list. Note: You can specify only a managed node that belongs to the current Tioli management region. This limitation applies only to the graphical interface. 4. Enter the label of the Endpoint where the Internet Information Serer is located, or click Endpoints to select one label from the list. Note: You can specify only an endpoint that belongs to the current Tioli management region. This limitation applies only to the graphical interface. 5. Click Create & Close or Create to create the Internet Information Serer object that you defined. A dialog box with a message informing you that the object was created on the managed node that you specified is displayed. 6. Click OK to dismiss the information dialog box. The Internet Information Serer object icon is added to the Policy Region window, with the name format IISWebSerer@endpoint_label. Objectie To distribute profiles to specified subscribers. 16 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

27 Background information IBM Tioli Monitoring uses Multiplexed Distribution (MDist2) to perform asynchronous profile data transfers through a hierarchy of repeaters. MDist2 returns a sequence of responses containing the distribution status from each endpoint to the application initiating the distribution. IBM Tioli Monitoring makes full use of the following MDist2 functions: Asynchronous deliery IBM Tioli Monitoring submits a distribution request and immediately receies a distribution identifier and confirmation that the distribution is in progress. MDist2 uses the callback function to send the final distribution status for each endpoint when it completes each endpoint distribution instead of waiting until all endpoints are distributed. Assured deliery Assures that distributed profiles are deliered to the endpoints een when there are network interruptions, computer shutdowns, or disconnected endpoints. Assured deliery tries to reestablish the connections until it is either successful or the distribution time expires. The distribution begins at the point where it was interrupted. Check-point and restart Assures that an interrupted data stream resumes from the last successful checkpoint. You do not hae to resend all the IBM Tioli Monitoring Profile data when the distribution resumes, but only the data that was not sent when the interruption occurred. Data depoting Stores segments of the profile at a depot close to the endpoint so the endpoints can retriee the data from the depot instead of from the source host. This reduces network traffic and speeds up the distribution. Required authorization role admin Before you begin Create a profile manager and profile. For detailed information, see Creating profile managers and profiles on page 12. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 14. Add a resource model to a profile. For detailed information, see Adding a resource model to a profile on page 15. For detailed information about each resource model, refer to the IBM Tioli Monitoring: Reference Guide. When you finish Not applicable. Procedure You can perform this procedure from either the command line or Tioli desktop. Command line: Run the wdmdistrib command to distribute the profile to the subscribers of the profile manager. This command updates subscriber databases and configuration files. If no subscriber is specified, wdmdistrib updates all subscribers. Chapter 2. Setting up the serer enironment 17

28 For more information about the wdmdistrib command syntax, refer to the IBM Tioli Monitoring: User s Guide. Desktop: Perform the following steps: 1. Double-click a policy region icon to open the Policy Region window. 2. Double-click a profile manager icon to open the Profile Manager window. 3. From the Profiles box, double-click a profile to display the IBM Tioli Monitoring Profile window. 4. From the Profile drop-down menu, select Distribute to display the Distribute Profile dialog box. 5. From the Distribute To box, select the subscribers to which distribute the profile: Next leel of subscribers This selection distributes the profile only to the subscribers of the profile manager. It does not distribute to lower-leel subscribers. If a profile manager with subscribers resides at the next lower leel, you need to perform the distribution process from profile managers at more than one leel to reach all the profile endpoints. All leels of subscribers Distributes the profile to all subscribers in the hierarchy. For example, you hae a profile hierarchy where a dataless profile manager subscribed to a profile manager, and the dataless profile manager has an endpoint subscribed. If you distribute to the next leel of subscribers, the profile manager distributes the profile only to the dataless profile manager. If you distribute to all leels of subscribers, the profile manager distributes the profile to the dataless profile manager and to the endpoint. Select this option if you want to distribute a profile in which your resource is the only subscriber. 6. From the Distribute Will box, select the required option: Presere modifications in subscribers copy of the profile Retains changes to existing monitors in each copy of a profile. If you edit the configuration of a monitor in the subscriber s copy, those changes are written to eery copy of that profile. 18 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

29 Make subscribers profile an EXACT COPY of this profile Oerwrites the subscriber s profile with an exact copy of the profile being distributed. 7. Verify that the Distribute To These Subscribers list includes only those subscribers to receie the profile. Use the left and right arrows to moe selected subscribers between lists. Note: In the case of Tioli Monitoring for Web Infrastructure: Internet Information Serer, the subscribers are Internet Information Serer objects. 8. Click one of the following: Distribute & Close Distributes the profile immediately, closes the Distribute Profile dialog box, saes the settings you made, and returns to the IBM Tioli Monitoring Profile window. Distribute Distributes the profile immediately, saes the settings you made, and leaes the Distribute Profile dialog box open. Schedule Displays the Add Scheduled Job dialog box, where you can set the required job options to distribute the profile with the Tioli Scheduler. For more information, see Specifying tasks for an eent on page 44. For detailed information about using the Tioli Scheduler, refer to the Tioli Management Framework: User s Guide. 9. Click Close to close the IBM Tioli Monitoring Profile window. Chapter 2. Setting up the serer enironment 19

30 20 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

31 Chapter 3. Setting up the Tioli Enterprise Console for eent correlation This chapter describes how to set up the Tioli Enterprise Console for eent correlation. Oeriew of the Tioli Enterprise Console for eent correlation The Tioli Enterprise Console proides the following functions: Receiing eents from arious sources Processing eents using rules Grouping eents and delegating the groups selectiely to administrators Responding to eents automatically Viewing eents at a console In the Tioli Enterprise Console, rules (.rls) files contain the logic for correlation of eents. BAROC (.baroc, Basic Recorder of Objects in C) files contain the defined eent classes. The following list explains basic concepts of eent management. For more information about the Tioli Enterprise Console, refer to the Tioli Enterprise Console: User s Guide. Eents An eent is a structured piece of information. It carries information about itself, including the eent class, eent identity, seerity, location (host where the eent originated), and description. Sources of Eents The Tioli Enterprise Console accepts eents from many sources. Typically, Tioli software is set up so that eents are sent in response to changes in an application or system resource. For example, you can configure resource models to send eents as well as to report in other ways. Tioli resource model tasks can also send eents. Eent Processing The Tioli Enterprise Console uses rules to process eents. A rule is made up of a set of logic statements. The rule determines what to do with the eent based on information proided in the eent, such as the eent class, eent name, seerity, location, and description. A rule s logic proides one or more responses to the eent: it can drop insignificant eents, escalate important eents, create new eents, or respond to defined relationships of multiple eents (eent correlation). It can also close an old eent when a new eent indicates that the original condition is resoled. Eent Grouping The Tioli Enterprise Console can filter eents into eent groups. These eent groups are typically organized by function but can also be organized by other criteria, such as location or organizational jurisdiction. 21

32 Eent groups are especially useful for subdiiding all Tioli Enterprise Console eents into manageable chunks. Administrators can be assigned to one or more eent groups. Viewing Eents The Tioli Enterprise Console includes a console where administrators can watch for incoming eents and respond to them. The eent console is a useful tool for managing by exception. The Tioli Enterprise Console can filter out normal eents, respond automatically to anticipated problems, and forward only those eents that require human interention. Responses to Eents The Tioli Enterprise Console normally proides automatic responses to many common eents, either by executing response programs or by executing Tioli tasks. For example, you can set up a response to the eent that is receied when a serer becomes unaailable. The specific response can inform an administrator or to attempt automatic restarts of the serer, or a combination of both. You cannot use the automatic response mechanism with this product. Howeer, you can write Tioli Enterprise Console rules that accomplish the same thing. Configuring the Tioli Enterprise Console eent serer Objectie To set up your Tioli Enterprise Console eent serer to process Internet Information Serer eents. Background information Before eents can be processed by Tioli Enterprise Console, you must set up the eent serer by performing the following procedure: Import the IBM Tioli Monitoring eent classes, if not already present Import the Tioli Monitoring for Web Infrastructure: Internet Information Serer eent classes Compile the rule base to incorporate new classes Load the new rule base Optionally, stop and start the Tioli Enterprise Console eent serer to incorporate these changes Tioli Monitoring for Web Infrastructure: Internet Information Serer includes a set of eent classes and rules specific to Internet Information Serer. Required authorization role senior Before you begin Note: If you need to configure only Tioli Enterprise Console, follow the steps described in Procedure on page 23. If you need to configure Tioli Enterprise Console and Tioli Business Systems Manager, follow the procedure described in Configuring the Tioli Enterprise Console to forward eents to Tioli Business Systems Manager on page 28. To configure the Tioli Enterprise Console eent serer for receiing Internet Information Serer eents, you must: 22 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

33 1. Install IBM Tioli Monitoring on the Tioli management region where the Tioli Enterprise Console serer resides. 2. Install Tioli Monitoring for Web Infrastructure: Internet Information Serer on the Tioli management region where the Tioli Enterprise Console serer resides. 3. If Tioli Monitoring for Web Infrastructure: Internet Information Serer is not installed on the managed node where the Tioli Enterprise Console serer resides, manually copy the *.baroc, *.rls, and *.sh files from the following path on the Tioli management region serer: $BINDIR/../generic_unix/TME/iis/tec to the following path on the managed node where the Tioli Enterprise Console serer resides: $BINDIR/../generic_unix/TME/iis/tec When you finish You can now use Tioli Enterprise Console to display eents generated when running your resource models. Procedure You can perform this procedure either manually, or running the itmiis_tec_config.sh script that is proided as is with Tioli Monitoring for Web Infrastructure: Internet Information Serer. Manual procedure: Perform the following steps: 1. Import the IBM Tioli Monitoring eent classes to the rule base by issuing the following command: wrb -imprbclass [hostname:]path/tmw2k.baroc rule_base where: hostname path rule_base The name of the Tioli management region serer, if different from the Tioli Enterprise Console serer. The path where Tmw2k.baroc is located on the Tioli management region serer. (By default, the file is located in $BINDIR/TMNT_TEC). The name of the rule base to which you want to add the IBM Tioli Monitoring eent classes. Note: If the rule base is the default rule base you cannot add other eent classes to it. You must create a new rule base by issuing the wcrtrb command. 2. Import the product eent classes to the rule base by issuing the following commands: wrb imprbclass $BINDIR/../generic_unix/TME/iis/tec/IIS_ASP.baroc rule_base wrb imprbclass $BINDIR/../generic_unix/TME/iis/tec/IIS_GENERAL.baroc rule_base wrb imprbclass $BINDIR/../generic_unix/TME/iis/tec/IIS_SererAailability.baroc rule_base wrb imprbclass $BINDIR/../generic_unix/TME/iis/tec/IIS_WebSiteAailability.baroc rule_base where rule_base is the name of the rule base to which you want to add the Tioli Monitoring for Web Infrastructure: Internet Information Serer eent classes. 3. Recompile the rule base by issuing the following command: Chapter 3. Setting up the Tioli Enterprise Console for eent correlation 23

34 wrb comprules rule_base where rule_base is the name of the rule base to be compiled. 4. Load the rule base by issuing the following command: wloadrb rule_base where rule_base is the name of the rule base to be loaded. 5. Stop and restart the enterprise console serer by issuing the following commands: wstopesr wstartesr Running the script: If you do not want to configure the Tioli Enterprise Console eent serer manually, you can run the itmiis_tec_config.sh script that is proided as is with the product. Perform the following steps: 1. Open a bash shell and switch to the $BINDIR/../generic_unix/TME/iis/tec directory. 2. Depending on the operation you want to perform, enter one of the following commands: To create a new rule base: itmiis_tec_config_etsr.sh CREATE "" new_rule_base path rule_base_actiation itmiis_tec_config_etsr.sh CLONE rule_base Where: new_rule_base The name of the new rule base you want to create. If you specify, the default alue ITMIIS is used. path The complete path where the new rule base is to be stored. If you specify, the root is used. rule_base_actiation Specify one of the following: The rule base is not loaded and the Tioli Enterprise Console serer is not restarted. LOADONLY The rule base is loaded but the Tioli Enterprise Console serer is not restarted. RESTART The rule base is loaded and the Tioli Enterprise Console serer is restarted. To clone an existing rule base: new_rule_base path rule_base_actiation Where: rule_base The name of the existing rule base you want to clone. new_rule_base The name of the new rule base you want to create. If you specify, the default alue ITMIIS is used. 24 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

35 path The complete path where the new rule base is to be stored. If you specify, the root is used. rule_base_actiation Specify one of the following: The rule base is not loaded and the Tioli Enterprise Console serer is not restarted. LOADONLY The rule base is loaded but the Tioli Enterprise Console serer is not restarted. RESTART The rule base is loaded and the Tioli Enterprise Console serer is restarted. To update an existing rule base: itmiis_tec_config_etsr.sh UPDATE rule_base "" "" rule_base_actiation Where: rule_base The name of the existing rule base you want to update. rule_base_actiation Specify one of the following: The rule base is not loaded and the Tioli Enterprise Console serer is not restarted. LOADONLY The rule base is loaded but the Tioli Enterprise Console serer is not restarted. RESTART The rule base is loaded and the Tioli Enterprise Console serer is restarted. Chapter 3. Setting up the Tioli Enterprise Console for eent correlation 25

36 26 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

37 Chapter 4. Integrating with Tioli Business Systems Manager This chapter proides information on using Tioli Business Systems Manager to manage Tioli Monitoring for Web Infrastructure: Internet Information Serer resources and eents. Integrating Tioli Monitoring for Web Infrastructure: Internet Information Serer with Tioli Business Systems Manager includes the following steps: 1. Configure the Tioli Enterprise Console eent serer to forward Internet Information Serer eents to Tioli Business Systems Manager (see Configuring the Tioli Enterprise Console to forward eents to Tioli Business Systems Manager on page 28). 2. Install the Tioli Monitoring for Web Infrastructure: Internet Information Serer integration on the Tioli Business Systems Manager database serer (see Installing Tioli Monitoring for Web Infrastructure: Internet Information Serer integration on page 32). 3. Define the specific Internet Information Serer objects to Tioli Business Systems Manager, by using a discoery script (see Discoering resources for Tioli Business Systems Manager on page 33). This chapter also proides a list of the Tioli Monitoring for Web Infrastructure: Internet Information Serer tasks that you can run from Tioli Business Systems Manager, and information about uninstalling the Tioli Monitoring for Web Infrastructure: Internet Information Serer integration. Understanding Tioli Business Systems Manager Tioli Business Systems Manager is a business systems management tool that enables you to graphically monitor and control interconnected business components and operating system resources. A business resource and its resources are referred to as a Line of Business (LOB). Tioli Business Systems Manager consists of the following components: Tioli Business Systems Manager management serer The Tioli Business Systems Manager management serer processes all the aailability data that is collected from arious sources. Aailability data is inserted in the Tioli Business Systems Manager database, where intelligent agents proide alerts on monitored objects and then broadcast those alerts to Tioli Business Systems Manager workstations. The management serer processes all user requests that originate from the workstation and includes a database serer that is built around a Microsoft SQL Serer database. Tioli Business Systems Manager workstation The Tioli Business Systems Manager workstation displays objects in customized iews, called Line of Business Views. Objects are presented in a hierarchical TreeView so that users can see the relationship between objects. Alerts are oerlaid on the objects when the aailability of the object is threatened. Tioli Eent Enablement Tioli Eent Enablement is installed on the Tioli Enterprise Console eent serer and enables the eent serer to forward eents to Tioli Business 27

38 Systems Manager. Eent enablement defines eent classes and rules for handling eents related to Tioli Business Systems Manager. Task serer The Tioli Business Systems Manager task serer is installed on the Tioli Enterprise Console eent serer with Tioli Eent Enablement. It receies task requests from the Tioli Business Systems Manager workstation, runs the tasks on the Tioli serer on which it is installed, and returns the output to Tioli Business Systems Manager. Prerequisites Before you integrate Tioli Monitoring for Web Infrastructure: Internet Information Serer into Tioli Business Systems Manager, perform the following prerequisite steps: Install and configure Tioli Business Systems Manager Version 1.5, with patches 29 and 35. For more information about how to install and configure Tioli Business Systems Manager, see the Tioli Business Systems Manager: Installation and Configuration Guide. Install and configure Tioli Eent Enablement (with patch 38) on all Tioli Enterprise Console eent serers that receie eents to be forwarded to Tioli Business Systems Manager. For more information about installing and configuring Tioli Eent Enablement, see the Tioli Business Systems Manager: Installation and Configuration Guide. Configure Tioli Business Systems Manager to communicate with each Tioli Eent Enablement that you installed. For more information, see the Tioli Business Systems Manager: Installation and Configuration Guide. Configure the Tioli Enterprise Console eent serer to forward eents to Tioli Business Systems Manager. For more information, see Configuring the Tioli Enterprise Console to forward eents to Tioli Business Systems Manager on page 28. Configuring the Tioli Enterprise Console to forward eents to Tioli Business Systems Manager Objectie To set up your Tioli Enterprise Console eent serer to forward Internet Information Serer eents to Tioli Business Systems Manager. Background information Before eents can be sent to Tioli Business Systems Manager, you must set up the Tioli Enterprise Console eent serer by performing the following procedure. Import the IBM Tioli Monitoring eent classes, if not already present Import the Tioli Monitoring for Web Infrastructure: Internet Information Serer eent classes and rules Recompile the rule base to incorporate the new classes and rules Load the new rule base Stop and restart the Tioli Enterprise Console eent serer to incorporate these changes Required authorization role senior 28 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

39 Before you begin To configure the Tioli Enterprise Console eent serer for forwarding Internet Information Serer eents to Tioli Business Systems Manager, you must: 1. Install IBM Tioli Monitoring on the Tioli management region where the Tioli Enterprise Console serer resides. 2. Install Tioli Monitoring for Web Infrastructure: Internet Information Serer on the Tioli management region where the Tioli Enterprise Console serer resides. 3. If Tioli Monitoring for Web Infrastructure: Internet Information Serer is not installed on the managed node where the Tioli Enterprise Console serer resides, manually copy the *.baroc, *.rls, and *.sh files from the following path on the Tioli management region serer: $BINDIR/../generic_unix/TME/iis/tec to the following path on the managed node where the Tioli Enterprise Console serer resides: $BINDIR/../generic_unix/TME/iis/tec When you finish You can now forward Internet Information Serer eents to Tioli Business Systems Manager. Procedure You can perform this procedure either manually, or running the itmiis_tbsm_config_etsr.sh script that is proided as is with Tioli Monitoring for Web Infrastructure: Internet Information Serer. Manual procedure: Perform the following steps: 1. Import the IBM Tioli Monitoring eent classes to the rule base by issuing the following command: wrb -imprbclass hostname:path/tmw2k.baroc rule_base where: hostname path rule_base The name of the Tioli management region serer. The path where Tmw2k.baroc is located on the Tioli management region serer. (By default, the file is located in $BINDIR/TMNT_TEC). The name of the rule base to which you want to add the IBM Tioli Monitoring eent classes. Note: If the rule base is the default rule base you cannot add other eent classes to it. You must create a new rule base by issuing the wcrtrb command. 2. Import the product eent classes to the rule base by issuing the following commands: wrb imprbclass $BINDIR/../generic_unix/TME/iis/tec/IIS_ASP.baroc rule_base wrb imprbclass $BINDIR/../generic_unix/TME/iis/tec/IIS_GENERAL.baroc rule_base wrb imprbclass $BINDIR/../generic_unix/TME/iis/tec/IIS_SererAailability.baroc rule_base wrb imprbclass $BINDIR/../generic_unix/TME/iis/tec/IIS_WebSiteAailability.baroc rule_base where rule_base is the name of the rule base to which you want to add the Tioli Monitoring for Web Infrastructure: Internet Information Serer eent classes. Chapter 4. Integrating with Tioli Business Systems Manager 29

40 3. Import the product rule set by issuing the following command: wrb imprbrule $BINDIR/../generic_unix/TME/iis/tec/itmiis_tbsm_forward.rls rule_base where rule_base is the name of the rule base to which you hae added the Tioli Monitoring for Web Infrastructure: Internet Information Serer eent classes. 4. To import the new rule into the EentSerer target of the rule base you are configuring: wrb imptgtrule itmiis_tbsm_forward [ before ITM_rule_set] EentSerer rule_base Where: [ before ITM_rule_set] If the EentSerer target contains IBM Tioli Monitoring rules, specify this option to place the imported rule set before the IBM Tioli Monitoring rule set. This allows clearing eents to be forwarded to Tioli Business Systems Manager. rule_base The name of the rule base that contains the EentSerer target. Note: If the EentSerer target has not been created, you must create it by issuing the wrb crttarget command. 5. To enable the forwarding of eents to Tioli Business Systems Manager, copy the itmiis_tbsm_forward.sh file from the following path: $BINDIR/../generic_unix/TME/iis/tec/ to the following: $BINDIR/TME/TEC/scripts 6. Recompile the rule base by issuing the following command: wrb comprules rule_base where rule_base is the name of the rule base to be compiled. 7. Load the rule base by issuing the following command: wloadrb rule_base where rule_base is the name of the rule base to be loaded. 8. Stop and restart the enterprise console serer by issuing the following commands: wstopesr wstartesr Running the script: If you do not want to configure the Tioli Enterprise Console manually, you can run the itmiis_tbsm_config_etsr.sh script that is proided as is with the product. On the Tioli Enterprise Console serer, perform the following steps: 1. Open a bash shell and switch to the $BINDIR/../generic_unix/TME/iis/tec directory. 2. Depending on the operation you want to perform, enter one of the following commands: To create a new rule base: itmiis_tbsm_config_etsr.sh CREATE "" new_rule_base path rule_base_actiation 30 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

41 itmiis_tbsm_config_etsr.sh CLONE rule_base Where: new_rule_base The name of the new rule base you want to create. If you specify, the default alue ITMIIS is used. path The complete path where the new rule base is to be stored. If you specify, the root is used. rule_base_actiation Specify one of the following: The rule base is not loaded and the Tioli Enterprise Console serer is not restarted. LOADONLY The rule base is loaded but the Tioli Enterprise Console serer is not restarted. RESTART The rule base is loaded and the Tioli Enterprise Console serer is restarted. To clone an existing rule base: new_rule_base path rule_base_actiation Where: rule_base The name of the existing rule base you want to clone. new_rule_base The name of the new rule base you want to create. If you specify, the default alue ITMIIS is used. path The complete path where the new rule base is to be stored. If you specify, the root is used. rule_base_actiation Specify one of the following: The rule base is not loaded and the Tioli Enterprise Console serer is not restarted. LOADONLY The rule base is loaded but the Tioli Enterprise Console serer is not restarted. RESTART The rule base is loaded and the Tioli Enterprise Console serer is restarted. To update an existing rule base: itmiis_tbsm_config_etsr.sh UPDATE rule_base "" "" rule_base_actiation Where: rule_base The name of the existing rule base you want to update. rule_base_actiation Specify one of the following: Chapter 4. Integrating with Tioli Business Systems Manager 31

42 The rule base is not loaded and the Tioli Enterprise Console serer is not restarted. LOADONLY The rule base is loaded but the Tioli Enterprise Console serer is not restarted. RESTART The rule base is loaded and the Tioli Enterprise Console serer is restarted. Installing Tioli Monitoring for Web Infrastructure: Internet Information Serer integration Objectie To enable the Tioli Business Systems Manager serer to receie Internet Information Serer eents. Background information To enable Tioli Business Systems Manager to manage Tioli Monitoring for Web Infrastructure: Internet Information Serer eents, you must run the Tioli Monitoring for Web Infrastructure: Internet Information Serer integration program on the Tioli Business Systems Manager database serer. This integration program performs the following operations: Defines the Internet Information Serer objects in Tioli Business Systems Manager Adds Tioli Monitoring for Web Infrastructure: Internet Information Serer tasks to the object types in Tioli Business Systems Manager Defines a line of business for Internet Information Serer resources Required authorization role You must hae administrator authority on the Tioli Business Systems Manager serer. Before you begin Tioli Business Systems Manager must be installed. Ensure that your Tioli Business Systems Manager enironment is configured correctly. For more information, refer to the Tioli Business Systems Manager: Installation and Configuration Guide. When you finish After running the itmiis_tbsm_init.sh script, you must recycle all Tioli Business Systems Manager serices, on both the Tioli Business Systems Manager application and database serers, before discoering the resource instances or running resource models. Define your Internet Information Serer objects to Tioli Business Systems Manager with the itmiis_tbsm_discoery.sh script, as described in Discoering resources for Tioli Business Systems Manager on page 33. Procedure You can perform this procedure either from the command line or using an InstallShield Multi-platform (ISMP) front-end. Command line: To install the Tioli Monitoring for Web Infrastructure: Internet Information Serer integration, perform the following steps: 32 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

43 1. On the Tioli Business Systems Manager database serer, insert the product CD-ROM in the CD-ROM drie and, from a command prompt, switch to the \TBSM directory. 2. Run the itmiis_tbsm_init.sh script, as follows: sh itmiis_tbsm_init.sh S SQL_serer_hostname U userid P pwd Where: SQL_serer_hostname The host name of the SQL serer with which the Tioli Business Systems Manager serer is associated userid pwd The SQL serer user ID The password associated with the user ID InstallShield Multi-platform (ISMP) front-end: 1. On the /TBSM directory of the product CD-ROM, run the install.bat file. 2. Fill in the appropriate fields with the SQL serer hostname, userid, and password as for the itmiis_tbsm_init.sh script. Discoering resources for Tioli Business Systems Manager Objectie To define the specific Internet Information Serer objects to Tioli Business Systems Manager. Background information The Tioli Monitoring for Web Infrastructure: Internet Information Serer integration that you run, defined the types of objects that you want Tioli Business Systems Manager to manage. After defining object types, you need to define the specific objects by running the itmiis_tbsm_discoery.sh script. The itmiis_tbsm_discoery.sh script performs the following operations: Searches the Tioli database for Internet Information Serer objects and sends a DISCOVER eent to Tioli Business Systems Manager for each object found. Maintains a list of the objects that hae been discoered. Alerts Tioli Business Systems Manager when an object is deleted by sending Tioli Business Systems Manager a GONE eent for each object that no longer exists in the Tioli database. The script is able to discoer the objects on all the Tioli management regions interconnected with the Tioli management region where the Tioli Enterprise Console serer resides. A text file is maintained on the Tioli Enterprise Console serer by the discoery script to perform delta discoery. The file stores the object identifiers for the object instances that hae preiously been discoered and is used (and updated) in each subsequent discoery to understand which DISCOVER and GONE eents must be sent to Tioli Business Systems Manager. The file is called InternetInformationSerer_DISCOVERED_to_tbsm.file, and is located in $DBDIR on the managed node where the Tioli Enterprise Console serer resides. The uninstallation of Tioli Monitoring for Web Infrastructure: Internet Information Serer does not remoe this file, which must be deleted manually to allow subsequent installations of Tioli Monitoring for Web Infrastructure: Internet Information Serer to work correctly. Chapter 4. Integrating with Tioli Business Systems Manager 33

44 Required authorization role iiswebserer_user Before you begin Configure your Tioli Enterprise Console eent serer, as described in Configuring the Tioli Enterprise Console eent serer on page 22. Ensure that Tioli Business Systems Manager Eent Enablement is installed on the Tioli Enterprise Console eent serer, and correctly connected to Tioli Business Systems Manager. When you finish Use Tioli Business Systems Manager to iew and manage your Internet Information Serer objects. For information about using Tioli Business Systems Manager, see the Tioli Business Systems Manager: User s Guide. For information about the Tioli Monitoring for Web Infrastructure: Internet Information Serer tasks that you can run from Tioli Business Systems Manager, see Working with Tioli Business Systems Manager on page 34. Procedure You can perform this procedure from the command line only. Command line: On a Tioli Enterprise Console serer that has the Tioli Eent Enablement installed, perform the following steps: 1. Open a bash shell and switch to the $BINDIR/../generic_unix/TME/iis/tec directory. 2. Enter the following command:./itmiis_tbsm_discoery.sh Note: To access the Operation Tasks pop-up menu on the discoered objects, you must close and restart the Tioli Business Systems Manager Console. Working with Tioli Business Systems Manager In addition to using Tioli Business Systems Manager to monitor the state of your resources, you can also run tasks on objects. Tioli Monitoring for Web Infrastructure: Internet Information Serer tasks are loaded into Tioli Business Systems Manager when you run the Tioli Monitoring for Web Infrastructure: Internet Information Serer integration. Depending on the different object types, the tasks are displayed on the Operation Tasks pop-up menu that is shown when you right-click an object. To run tasks from Tioli Business Systems Manager to an Internet Information Serer resource instance, that resource must reside in the same Tioli management region where the Tioli Enterprise Console serer that sent the relatie eents to Tioli Business Systems Manager resides, or in an interconnected region. This is because the running of tasks is drien by the Tioli Enterprise Console serer, which therefore must hae isibility of the target Internet Information Serer object and endpoint. You can perform the following operations from Tioli Business Systems Manager: Start Web serer Stop Web serer Start Web site Stop Web site 34 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

45 Tioli Business Systems Manager also monitors the status of resource models. Eents generated by resource models are forwarded from the Tioli Enterprise Console eent serer to Tioli Business Systems Manager. For more information about tasks and resource models, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Uninstalling Tioli Monitoring for Web Infrastructure: Internet Information Serer integration from Tioli Business Systems Manager Objectie To remoe the Tioli Monitoring for Web Infrastructure: Internet Information Serer integration from Tioli Business Systems Manager. Background information Uninstalling the Tioli Monitoring for Web Infrastructure: Internet Information Serer integration remoes the Internet Information Serer objects and object definitions from Tioli Business Systems Manager. To uninstall Tioli Business Systems Manager, run the itmiis_tbsm_uninstall.sh script on the Tioli Business Systems Manager database serer. Required authorization role You must hae administrator authority on the Tioli Business Systems Manager serer. Before you begin On the Tioli Business Systems Manager application serer, stop the Tioli Business Systems Manager application serice. When you finish After running the itmiis_tbsm_uninstall.sh script, you must recycle all Tioli Business Systems Manager serices, on both the Tioli Business Systems Manager application and database serers. Procedure You can perform this procedure either from the command line or using an InstallShield Multi-platform (ISMP) front-end. Command line: To uninstall the Tioli Monitoring for Web Infrastructure: Internet Information Serer integration, perform the following steps: 1. On the Tioli Business Systems Manager database serer, insert the Tioli Monitoring for Web Infrastructure: Internet Information Serer CD-ROM in the CD-ROM drie and, from a command prompt, switch to the \TBSM\uninstall directory. 2. Run the itmiis_tbsm_uninstall.sh script, as follows: itmiis_tbsm_uninstall.sh S SQL_serer_hostname U userid P pwd Where: SQL_serer_hostname The host name of the SQL serer with which the Tioli Business Systems Manager serer is associated userid The SQL serer user ID pwd The password associated with the user ID Chapter 4. Integrating with Tioli Business Systems Manager 35

46 InstallShield Multi-platform (ISMP) front-end: 1. On the Tioli Business Systems Manager database serer, run the uninstall.bat file that was copied during installation. Note: You cannot run the uninstall.bat script from the CD-ROM. 2. Follow the on-screen instructions to uninstall the Tioli Monitoring for Web Infrastructure: Internet Information Serer integration. 36 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

47 Chapter 5. Working with IBM Tioli Monitoring resource models Customizing indications This chapter describes how to use the resource models proided with Tioli Monitoring for Web Infrastructure: Internet Information Serer. You can customize arious management aspects of the resource models, so that they hae the appropriate settings for your monitoring enironment. Customizing a resource model inoles the steps described in the following sections. Objectie To customize indication rules, so that resources are monitored and eents generated in the manner most appropriate to your enironment. Background information Each resource model triggers an indication, if certain conditions defined by the resource model s thresholds are not during the monitoring cycle. Each resource model has predefined thresholds that meet the business need of most customers. Howeer, you may hae specific requirements for which these thresholds are not appropriate; therefore, you can adjust these alues as needed. Required authorization role admin Before you begin Create a profile manager and profile. For detailed information, see Creating profile managers and profiles on page 95. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 97. Add a resource model to a profile. For detailed information, see Adding default resource models to profiles on page 99 and Adding customized resource models to profiles on page 100. For detailed information about each resource model, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. When you finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 16. Optional: Continue customizing the resource model, by: Setting a recoery action when a specific eent occurs. See Editing a built-in action on page 42. Specifying correctie or reporting tasks for an eent. See Specifying tasks for an eent on page 44. Specifying to receie information on a specific eent through a notice. See Sending a notice to administrators when an eent occurs on page 46. Customizing your parameters to optimize the monitoring process. See Customizing parameters on page 49. Setting the monitoring of resource models to take place on specific time periods of selected days. See Creating scheduling rules on page

48 Determining when the monitoring of resource models takes place. See Customizing the scheduling monitoring period on page 53. Specifying that the log data collected by a resource model is written to a local database. See Customizing data logging information on page 54. Procedure You can perform this procedure from either the command line or Tioli desktop. Command line: Run the wdmeditprf command to customize a resource model for a profile. For more information about the command syntax, refer to the IBM Tioli Monitoring: User s Guide. Desktop: Perform the following steps: 1. Double-click a policy region icon to open the Policy Region window. 2. Double-click a profile manager icon to open the Profile Manager window. 3. From the Profiles box, double-click a profile to display the IBM Tioli Monitoring Profile window. 38 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

49 4. Select the resource model you want to customize and click Edit. The Edit Resource Model dialog box is displayed. 5. Click Indications to display the Indications and Actions dialog box, where the indications appropriate to the resource model are shown. 6. Select the indication whose associated eents you want to change, and modify the alues as appropriate. 7. Click Apply for each change you make. You can customize the following: Number of Occurrences The number of consecutie times the problem occurs before the software generates an indication. You can change this alue to specify the number of times a problem occurs before an indication generates. Number of Holes How many cycles that do not produce an indication can occur between cycles that produce an indication. This determines if the occurrences of an indication are consecutie. Each cycle without an indication is termed a hole. For example, an eent that has a alue of two holes means that when up to two cycles without an indication occur between any two cycles with an indication, the cycles with an indication are considered consecutie. Use the alue for the Number of Holes in conjunction with the Number of Occurrences parameter and the Cycle Time to define a time window for the generation of an eent. If, for example, you define Cycle Time as 10 seconds, Number of Occurrences as 5, and Number of Holes as 2, the time that must elapse before an eent occurs is between 50 and 130 seconds. The minimum elapsed time is the number of occurrences multiplied by the cycle time. The maximum time window assumes that the maximum number of holes occur between each pair of occurrences, and is determined by the following equation: TW=CT x (Oc + (H x (Oc - 1)) Chapter 5. Working with IBM Tioli Monitoring resource models 39

50 where: TW The time window calculated CT The cycle time Oc The number of occurrences H The number of holes Send TEC Eents Select this check box to send an eent to the Tioli Enterprise Console. You must hae Tioli Enterprise Console installed and configured. Send to TBSM Sends eents to Tioli Business Systems Manager. If you hae Tioli Business Systems Manager installed and configured, this check box is not aailable because Tioli Enterprise Console automatically forwards eents to Tioli Business Systems Manager. 8. Click Apply Changes & Close to close the Indications and Actions dialog box and return to the Edit Resource Model dialog box. Adding or remoing built-in action Objectie Either to add a built-in action, so administrators and users can reinstate an eent s recoery actions, or to remoe a built-in action, so administrators and users can clear an eent s recoery action. Background information A built-in action is a recoery action for an eent. The actions take positie steps to remedy the situation, or ensures distribution of information about the eent to the appropriate authorities or entities. The Tioli software has predefined actions for certain eents. An action is either the execution of a common information model class method, or the execution of a program. For example, an eent that detects the failure of a serice has the restart of that serice as its built-in action. IBM Tioli Monitoring detects the failure of a serice and automatically restarts it. Built-in actions are defined by default as part of an eent, when the resource model is created with IBM Tioli Monitoring Workbench. For more information, refer to the IBM Tioli Monitoring documentation. Required authorization role admin Before you begin Create a profile manager and profile. For detailed information, see Creating profile managers and profiles on page 95. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 97. Add a resource model to a profile. For detailed information, see Adding default resource models to profiles on page 99 and Adding customized resource models to profiles on page 100. For detailed information about each resource model, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. 40 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

51 When you finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 16. Optional: Continue customizing the resource model, by: Setting a recoery action when a specific eent occurs. See Editing a built-in action on page 42. Specifying correctie or reporting tasks for an eent. See Specifying tasks for an eent on page 44. Specifying to receie information on a specific eent through a notice. See Sending a notice to administrators when an eent occurs on page 46. Customizing your parameters to optimize the monitoring process. See Customizing parameters on page 49. Setting the monitoring of resource models to take place on specific time periods of selected days. See Creating scheduling rules on page 50. Determining when the monitoring of resource models takes place. See Customizing the scheduling monitoring period on page 53. Specifying that the log data collected by a resource model is written to a local database. See Customizing data logging information on page 54. Procedure You can perform this procedure from either the command line or Tioli desktop. Command line: Run the wdmeditprf command to customize a resource model for a profile. For more information about the command syntax, refer to the IBM Tioli Monitoring: User s Guide. Desktop: Perform the following steps: 1. Double-click a policy region icon to open the Policy Region window. 2. Double-click a profile manager icon to open the Profile Manager window. 3. From the Profiles box, double-click a profile to display the IBM Tioli Monitoring Profile window. 4. Select the resource model you want and click Edit. The Edit Resource Model dialog box is displayed. Chapter 5. Working with IBM Tioli Monitoring resource models 41

52 5. Click Indications to display the Indications and Actions dialog box, where the indications appropriate to the resource model are shown. Editing a built-in action 6. Select the indication whose associated action you want to add or remoe. 7. From the Action List box, select the action you want. 8. Click Remoe to remoe the action. OR Click Built-in to display the Add Action dialog box. a. Select the action you want to run when an eent occurs. b. In the Retry text box, enter the number of times that you want the action to perform when an indication generates an eent. Additional information: If you set the Retry text box to zero, the product continually tries to perform the action until it is successful. c. Click one of the following buttons: Add To add the selected action with the alues specified and keep the Add Action dialog box open. Add & Close To add the selected action and close the Add Action dialog box. 9. Click one of the following buttons: Apply Changes To sae the changes made to the built-in actions and leae the Indications and Actions dialog box open. Apply Changes and Close To close the Indications and Actions dialog box and sae the changes made to the built-in actions. Objectie To specify the number of times the product attempts to execute the built-in action, when an eent is generated. 42 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

53 Background information A built-in action is a recoery action for an eent. The actions take positie steps to remedy the situation, or ensure distribution of information about the eent to the appropriate authorities or entities. The Tioli software has predefined actions for certain eents. An action is either the execution of a common information model class method, or the execution of a program. For example, an eent that detects the failure of a serice has the restart of that serice as its built-in action. IBM Tioli Monitoring detects the failure of a serice and automatically restarts it. Built-in actions are defined by default as part of an eent, when the resource model is created with IBM Tioli Monitoring Workbench. For more information, refer to the IBM Tioli Monitoring documentation. Required authorization role admin Before you begin Create a profile manager and profile. For detailed information, see Creating profile managers and profiles on page 95. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 97. Add a resource model to a profile. For detailed information, see Adding default resource models to profiles on page 99 and Adding customized resource models to profiles on page 100. For detailed information about each resource model, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. When you finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 16. Optional: Continue customizing the resource model, by: Setting a recoery action when a specific eent occurs. See Editing a built-in action on page 42. Specifying correctie or reporting tasks for an eent. See Specifying tasks for an eent on page 44. Specifying to receie information on a specific eent through a notice. See Sending a notice to administrators when an eent occurs on page 46. Customizing your parameters to optimize the monitoring process. See Customizing parameters on page 49. Setting the monitoring of resource models to take place on specific time periods of selected days. See Creating scheduling rules on page 50. Determining when the monitoring of resource models takes place. See Customizing the scheduling monitoring period on page 53. Specifying that the log data collected by a resource model is written to a local database. See Customizing data logging information on page 54. Procedure You can perform this procedure from either the command line or Tioli desktop. Command line: Run the wdmeditprf command to customize a resource model for a profile. For more information about the command syntax, refer to the IBM Tioli Monitoring: User s Guide. Chapter 5. Working with IBM Tioli Monitoring resource models 43

54 Desktop: Perform the following steps: 1. Double-click a policy region icon to open the Policy Region window. 2. Double-click a profile manager icon to open the Profile Manager window. 3. From the Profiles box, double-click a profile to display the IBM Tioli Monitoring Profile window. 4. Select the resource model you want and click Edit. The Edit Resource Model dialog box is displayed. 5. Click Indications to display the Indications and Actions dialog box, where the indications appropriate to the resource model are shown. 6. Select the indication whose associated eents you want to customize. 7. From the Action List box, select the action you want and click Edit. The Edit Current Action dialog box is displayed. 8. In the Retry text box, enter the number of times that you want the action to perform when an indication generates an eent. Additional information: If you set the Retry text box to zero, the product continually tries to perform the action until it is successful. 9. Click the Apply button next to the Retry field to apply the changes. 10. Click one of the following buttons: Modify & Close To sae the current settings and close the Edit Current Action dialog box. Close To close the Edit Current Action dialog box without saing the current settings. Specifying tasks for an eent Objectie To specify a task so administrators and users can determine correctie or reporting tasks for an eent. Background information You can select one or more tasks to perform when an indication generates an eent. You can select one or more tasks for each eent. These tasks can access the eent name and thresholds by accessing the enironment ariables. Required authorization role admin Before you begin Create a profile manager and profile. For detailed information, see Creating profile managers and profiles on page 95. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 97. Add a resource model to a profile. For detailed information, see Adding default resource models to profiles on page 99 and Adding customized resource models to profiles on page 100. For detailed information about each resource model, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. When you finish Distribute the profile to which the resource model belongs. See Distributing profiles on page IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

55 Optional: Continue customizing the resource model, by: Setting a recoery action when a specific eent occurs. See Editing a built-in action on page 42. Specifying correctie or reporting tasks for an eent. See Specifying tasks for an eent on page 44. Specifying to receie information on a specific eent through a notice. See Sending a notice to administrators when an eent occurs on page 46. Customizing your parameters to optimize the monitoring process. See Customizing parameters on page 49. Setting the monitoring of resource models to take place on specific time periods of selected days. See Creating scheduling rules on page 50. Determining when the monitoring of resource models takes place. See Customizing the scheduling monitoring period on page 53. Specifying that the log data collected by a resource model is written to a local database. See Customizing data logging information on page 54. Procedure You can perform this procedure from either the command line or Tioli desktop. Command line: Use the wdmeditprf command to customize a resource model for a profile. For more information about the command syntax, refer to the IBM Tioli Monitoring: User s Guide. Desktop: Perform the following steps: 1. Double-click a policy region icon to open the Policy Region window. 2. Double-click a profile manager icon to open the Profile Manager window. 3. From the Profiles box, double-click a profile to display the IBM Tioli Monitoring Profile window. 4. Select the resource model you want and click Edit. The Edit Resource Model dialog box is displayed. 5. Click Indications to display the Indications and Actions dialog box, where the indications appropriate to the resource model are shown. 6. Select the indication that you want to generate a task. Chapter 5. Working with IBM Tioli Monitoring resource models 45

56 7. From the Action List box, click Tasks. The Tasks dialog box is displayed. 8. From the Libraries box, double-click the required task library. The Tasks box is updated with the appropriate tasks. 9. Double-click the required task to display the Configure Task dialog box. 10. If required, specify the appropriate parameters. 11. Click Change & Close to close the Configure Task dialog box and add the customized parameter to the Tasks dialog box. 12. Click Change & Close to close the Tasks dialog box and add the task to the Action List box in the Indications and Actions dialog box. 13. Click Apply Changes & Close to return to the Edit Resource Model dialog box. 14. Click Modify & Close. Sending a notice to administrators when an eent occurs Objectie To send a notice in response to an eent, so administrators can take the appropriate actions or responses. Background information You can select the IBM Tioli Monitoring Utility task to send notices in response to an eent. Required authorization role admin 46 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

57 Before you begin Create a profile manager and profile. For detailed information, see Creating profile managers and profiles on page 95. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 97. Add a resource model to a profile. For detailed information, see Adding default resource models to profiles on page 99 and Adding customized resource models to profiles on page 100. For detailed information about each resource model, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. When you finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 16. Optional: Continue customizing the resource model, by: Setting a recoery action when a specific eent occurs. See Editing a built-in action on page 42. Specifying correctie or reporting tasks for an eent. See Specifying tasks for an eent on page 44. Specifying to receie information on a specific eent through a notice. See Sending a notice to administrators when an eent occurs on page 46. Customizing your parameters to optimize the monitoring process. See Customizing parameters on page 49. Setting the monitoring of resource models to take place on specific time periods of selected days. See Creating scheduling rules on page 50. Determining when the monitoring of resource models takes place. See Customizing the scheduling monitoring period on page 53. Specifying that the log data collected by a resource model is written to a local database. See Customizing data logging information on page 54. Procedure You can perform this procedure from either the command line or Tioli desktop. Command line: Run the wdmeditprf command to customize a resource model for a profile. For more information about the command syntax, refer to the IBM Tioli Monitoring: User s Guide. Desktop: Perform the following steps: 1. Double-click a policy region icon to open the Policy Region window. 2. Double-click a profile manager icon to open the Profile Manager window. 3. From the Profiles box, double-click a profile to display the IBM Tioli Monitoring Profile window. 4. Select the resource model you want and click Edit. The Edit Resource Model dialog box is displayed. 5. Click Indications to display the Indications and Actions dialog box, where the indications appropriate to the resource model are shown. 6. Select the indication that you want to generate a task. 7. From the Action List box, click Tasks. The Tasks dialog box is displayed. Chapter 5. Working with IBM Tioli Monitoring resource models 47

58 8. From the Libraries box, double-click IBM Tioli Monitoring Utility Tasks. The Tasks box is updated with the related tasks. 9. Double-click the dmae_mn_send_notice task. The Configure Task window is displayed. 10. Specify the appropriate parameters. Additional information: Run the wlsnotif g command to see the aailable Notice Groups. 11. Click Change & Close to close the Configure Task dialog box and add the customized parameter to the Tasks dialog box. 12. Click Change & Close to close the Tasks dialog box and add the task to the Action List box in the Indications and Actions dialog box. 13. Click Apply Changes & Close to return to the Edit Resource Model dialog box. 14. Click Modify & Close. 48 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

59 Customizing parameters Objectie To customize the parameters of a resource model, so administrators and users can optimize the monitoring process. Background information Some resource models hae one or more parameters. Each parameter can take the form of a list of strings, a list of numeric alues, a Boolean list of predetermined alues from which you can make any combination of selections, or a choice list of mutually exclusie alternaties. Required authorization role admin Before you begin Create a profile manager and profile. For detailed information, see Creating profile managers and profiles on page 95. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 97. Add a resource model to a profile. For detailed information, see Adding default resource models to profiles on page 99 and Adding customized resource models to profiles on page 100. For detailed information about each resource model, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. When you finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 16. Optional: Continue customizing the resource model, by: Setting a recoery action when a specific eent occurs. See Editing a built-in action on page 42. Specifying correctie or reporting tasks for an eent. See Specifying tasks for an eent on page 44. Specifying to receie information on a specific eent through a notice. See Sending a notice to administrators when an eent occurs on page 46. Customizing your parameters to optimize the monitoring process. See Customizing parameters. Setting the monitoring of resource models to take place on specific time periods of selected days. See Creating scheduling rules on page 50. Determining when the monitoring of resource models takes place. See Customizing the scheduling monitoring period on page 53. Specifying that the log data collected by a resource model is written to a local database. See Customizing data logging information on page 54. Procedure You can perform this procedure from either the command line or Tioli desktop. Command line: Run the wdmeditprf command to customize a resource model for a profile. For more information about the command syntax, refer to the IBM Tioli Monitoring: User s Guide. Chapter 5. Working with IBM Tioli Monitoring resource models 49

60 Desktop: Perform the following steps: 1. Double-click a policy region icon to open the Policy Region window. 2. Double-click a profile manager icon to open the Profile Manager window. 3. From the Profiles box, double-click a profile to display the IBM Tioli Monitoring Profile window. 4. Select the resource model you want and click Edit. The Edit Resource Model dialog box is displayed. 5. Click Parameters. Creating scheduling rules 6. From the Name drop-down list, select the type of parameter. 7. Add or delete the parameter alues, as appropriate. 8. Click Apply Changes and Close to sae your changes and return to the Edit Resource Model dialog box. Objectie To create schedule rules, so administrators and users can determine the day and time when monitoring is to take place. Background information IBM Tioli Monitoring contains a scheduling feature that enables you to determine the period when monitoring takes place, and specific scheduling rules. You can diide the oerall collection period into actie and inactie interals, by applying one or more schedule rules. The scheduling rules enable you to define time periods on specific weekdays during which monitoring takes place. You can define any number of rules which allow you set up a complex pattern of resource monitoring for a profile and coers the periods that you want to monitor. If the profile contains more than one schedule rule, all the time interals are respected, and rules are combined by adding together the time periods they define. For example, if you specify a rule that requests monitoring between 8:00 and 14:00 eery day and another that requests all-day monitoring on Fridays, the sum of the two rules gies all-day monitoring only on Fridays, and monitoring between 8:00 and 14:00 on all other days. If the second rule instead requested monitoring from 12:00 to 18:00 on 50 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

61 Fridays, the sum of the rules would gie monitoring between 8:00 and 18:00 on Fridays and between 08:00 and 14:00 on all other days. The scheduled times are always interpreted as local times, enabling you to set up a single rule that monitors the same local time period in different time zones. All times of eents or actiities reported from endpoints or gateways are also logged in the local time of the system from where they originated. The Scheduling window has the following group boxes: Schedule To set the data collection period. By default, all resource models are set to always collect data. Schedule Rules To manage time interals during which the resource model is actie. Rule Editor To create and edit schedule rules. Required authorization role admin Before you begin Create a profile manager and profile. For detailed information, see Creating profile managers and profiles on page 95. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 97. Add a resource model to a profile. For detailed information, see Adding default resource models to profiles on page 99 and Adding customized resource models to profiles on page 100. For detailed information about each resource model, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. When you finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 16. Optional: Continue customizing the resource model, by: Setting a recoery action when a specific eent occurs. See Editing a built-in action on page 42. Specifying correctie or reporting tasks for an eent. See Specifying tasks for an eent on page 44. Specifying to receie information on a specific eent through a notice. See Sending a notice to administrators when an eent occurs on page 46. Customizing your parameters to optimize the monitoring process. See Customizing parameters on page 49. Setting the monitoring of resource models to take place on specific time periods of selected days. See Creating scheduling rules on page 50. Determining when the monitoring of resource models takes place. See Customizing the scheduling monitoring period on page 53. Specifying that the log data collected by a resource model is written to a local database. See Customizing data logging information on page 54. Procedure You can perform this procedure from either the command line or Tioli desktop. Chapter 5. Working with IBM Tioli Monitoring resource models 51

62 Command line: Run the wdmeditprf command to customize a resource model for a profile. For more information about the command syntax, refer to the IBM Tioli Monitoring: User s Guide. Desktop: Perform the following steps: 1. Double-click a policy region icon to open the Policy Region window. 2. Double-click a profile manager icon to open the Profile Manager window. 3. From the Profiles box, double-click a profile to display the IBM Tioli Monitoring Profile window. 4. Select the resource model you want and click Edit. The Edit Resource Model dialog box is displayed. 5. Click Schedule to display the Scheduling window. 6. In the Schedule group box, clear the Always check box. 7. In the Schedule Rules box, click New Rule. 8. Specify a Rule Name. 9. Select one or more week days to specify the day or days when the collections are actie during the collection period. Additional information: Use the Shift or Ctrl key, as appropriate, to select more than one day from the list. 10. Set the Start Time and Stop Time for the collection actiity, or select the All Day check box. Additional information: Times are always interpreted as the local time of where the endpoint engine runs. Setting a time interal from 08:00 to 13:00 ensures that monitoring takes place between those times in all time zones where you distribute the profile. 11. Click Set Rule to show the new rule in the Schedule Rules list. Additional information: To display the details of any rule, select the rule from the Schedule Rules list. Its settings are displayed in the Rule Editor group box. 52 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

63 12. Click Modify & Close to sae your rule and close the Scheduling window. Customizing the scheduling monitoring period Objectie To customize the scheduling monitoring period of a resource model, so administrators and users can determine when monitoring takes place. Background information IBM Tioli Monitoring contains a scheduling feature that enables you to determine the period when monitoring is to take place, and specific scheduling rules. The scheduling rules enable you to define time periods on specific weekdays during which monitoring takes place. You can define any number of rules which enables you set up a complex pattern of resource monitoring for a profile and coers the periods that you want to monitor. If a profile contains more than one schedule rule, all the time interals are respected, and rules are combined by adding together the time periods they define. For example, if you specify a rule that requests monitoring between 8:00 and 14:00 eery day and another that requests all-day monitoring on Fridays, the sum of the two rules gies all-day monitoring only on Fridays, and monitoring between 8:00 and 14:00 on all other days. If the second rule instead requested monitoring from 12:00 to 18:00 on Fridays, the sum of the rules would gie monitoring between 8:00 and 18:00 on Fridays and between 08:00 and 14:00 on all other days. The scheduled times are always interpreted as local times, enabling you to set up a single rule that monitors the same local time period in different time zones. All times of eents or actiities reported from endpoints or gateways are also logged in the local time of the system from where they originated. The Scheduling window has the following group boxes: Schedule To set the data collection period. By default, all resource models are set to always collect data. Schedule Rules To manage time interals during which the resource model is actie. Rule Editor To create and edit schedule rules. Required authorization role admin Before you begin Create a profile manager and profile. For detailed information, see Creating profile managers and profiles on page 95. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 97. Add a resource model to a profile. For detailed information, see Adding default resource models to profiles on page 99 and Adding customized resource models to profiles on page 100. For detailed information about each resource model, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Chapter 5. Working with IBM Tioli Monitoring resource models 53

64 When you finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 16. Optional: Continue customizing the resource model, by: Setting a recoery action when a specific eent occurs. See Editing a built-in action on page 42. Specifying correctie or reporting tasks for an eent. See Specifying tasks for an eent on page 44. Specifying to receie information on a specific eent through a notice. See Sending a notice to administrators when an eent occurs on page 46. Customizing your parameters to optimize the monitoring process. See Customizing parameters on page 49. Setting the monitoring of resource models to take place on specific time periods of selected days. See Creating scheduling rules on page 50. Determining when the monitoring of resource models takes place. See Customizing the scheduling monitoring period on page 53. Specifying that the log data collected by a resource model is written to a local database. See Customizing data logging information. Procedure You can perform this procedure from either the command line or Tioli desktop. Command line: Run the wdmeditprf command to customize a resource model for a profile. For more information about the command syntax, refer to the IBM Tioli Monitoring: User s Guide. Desktop: Perform the following steps: 1. Double-click a policy region icon to open the Policy Region window. 2. Double-click a profile manager icon to open the Profile Manager window. 3. From the Profiles box, double-click a profile to display the IBM Tioli Monitoring Profile window. 4. Select the resource model you want and click Edit. The Edit Resource Model dialog box is displayed. 5. Click Schedule to display the Scheduling window. 6. In the Schedule group box, clear the Always check box. 7. Set a Start Date and Stop Date to define the monitoring period. 8. Optional: Add one or more schedule rules that determine time periods on the selected dates for monitoring to take place. 9. Click Modify & Close to sae your changes. Customizing data logging information Objectie To customize data logging information, so administrators and users can log data collected by a resource model and write it in a local database. Background information You can iew the log data through the Web Health Console, after you store it in a local database. You can store one of the following types of data in the database: 54 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

65 Raw data Data is stored in memory as it is collected by the resource model. All the monitored alues are copied eery fie minutes (six minutes, on UNIX) into the database. TEDW data Data is collected eery cycle time, aggregated eery hour, and copied in the database for later use by Tioli Enterprise Data Warehouse. Aggregate data Data collected and aggregated at fixed interals that you define (aggregation period). Only the aggregated alues are written in the database. The aggregated data is calculated on the basis of one or more of the following options: Maximum Minimum Aerage Required authorization role admin Before you begin Create a profile manager and profile. For detailed information, see Creating profile managers and profiles on page 95. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 97. Add a resource model to a profile. For detailed information, see Adding default resource models to profiles on page 99 and Adding customized resource models to profiles on page 100. For detailed information about each resource model, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. When you finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 16. Optional: Continue customizing the resource model, by: Setting a recoery action when a specific eent occurs. See Editing a built-in action on page 42. Specifying correctie or reporting tasks for an eent. See Specifying tasks for an eent on page 44. Specifying to receie information on a specific eent through a notice. See Sending a notice to administrators when an eent occurs on page 46. Customizing your parameters to optimize the monitoring process. See Customizing parameters on page 49. Setting the monitoring of resource models to take place on specific time periods of selected days. See Creating scheduling rules on page 50. Determining when the monitoring of resource models takes place. See Customizing the scheduling monitoring period on page 53. Specifying that the log data collected by a resource model is written to a local database. See Customizing data logging information on page 54. Procedure You can perform this procedure from either the command line or Tioli desktop. Chapter 5. Working with IBM Tioli Monitoring resource models 55

66 Command line: Run the wdmeditprf command to customize a resource model for a profile. For more information about the command syntax, refer to the IBM Tioli Monitoring: User s Guide. Desktop: Perform the following steps: 1. Double-click a policy region icon to open the Policy Region window. 2. Double-click a profile manager icon to open the Profile Manager window. 3. From the Profiles box, double-click a profile to display the IBM Tioli Monitoring Profile window. 4. Select the resource model you want and click Edit. The Edit Resource Model dialog box is displayed. 5. Click Logging to display the Logging window. 6. In the Data Logging Settings group box, select the Enable Data Logging check box. This enables logging of all data collected by the resource model to a database. 7. Choose the type of data you want to store in the database, by selecting or clearing the appropriate check boxes (by default, Raw Data is selected): Raw Data Data is stored in memory as it is collected by the resource model. All the monitored alues are copied eery fie minutes (six minutes, on UNIX) into the database. If you select this check box, you can also select TEDW Data. TEDW Data Data is collected eery cycle time, aggregated eery hour, and copied in the database for later use by Tioli Enterprise Data Warehouse. If you select this check box, you can also select Raw Data. Aggregate Data Data is collected eery cycle time and aggregated at fixed interals you define (aggregation period). Then, only the aggregated alues are written into the database. The aggregated data can be calculated on the basis of one or more of the following options: 56 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

67 Maximum To calculate and log the peak alue in each aggregation period, before data is written to the database. Minimum To calculate and log the lowest alue in each aggregation period, before data is written to the database. Aerage To calculate and log the aerage of all alues in each aggregation period, before data is written to the database. By default, data logging is not enabled. 8. To specify the period for which data is to be aggregated, set Hours and Minutes of the Aggregation Period to the required alues. 9. To specify the period for which data is to be stored in the database, set Hours and Minutes of the Historical Period to the required alues. 10. Click Apply Changes and Close to sae your changes and close the Logging window. Managing profiles and resource models at endpoints Objectie To manage profiles and resource models after they are distributed to endpoints (that is, Internet Information Serer objects), so administrators and users can maintain monitoring processes on those endpoints. Background information Not applicable. Required authorization role admin Before you begin Create a profile manager and profile. For detailed information, see Creating profile managers and profiles on page 95. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 97. Add a resource model to a profile. For detailed information, see Adding default resource models to profiles on page 99 and Adding customized resource models to profiles on page 100. Distribute the profile. For detailed information, see Distributing profiles on page 16. For detailed information about each resource model, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. When you finish Not applicable. Procedure You can perform this procedure from the command line only. Command line: Run the wdmcmd command to stop or restart IBM Tioli Monitoring on one or more endpoints from a gateway or serer. Chapter 5. Working with IBM Tioli Monitoring resource models 57

68 Run the wdmeng command to stop or start profiles or resource models at endpoints, or to delete profiles at endpoints. Run the wdmlseng command to return a list and the status of all resource models that hae been distributed on a specified endpoint. Run the wdmtrceng command to set the trace parameters of the IBM Tioli Monitoring engine at the endpoint. For more information about these commands syntax, refer to the IBM Tioli Monitoring: User s Guide. Managing IBM Tioli monitoring gateways Objectie To manage IBM Tioli Monitoring on gateways, so administrators and users can run monitoring processes on those gateways. Background information Not applicable. Required authorization role admin Before you begin Create a profile manager and profile. For detailed information, see Creating profile managers and profiles on page 95. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 97. Add a resource model to a profile. For detailed information, see Adding default resource models to profiles on page 99 and Adding customized resource models to profiles on page 100. Distribute the profile. For detailed information, see Distributing profiles on page 16. For detailed information about each resource model, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. When you finish Not applicable. Procedure You can perform this procedure from the command line only. Command line: Run the wdmmn command to stop or start the selected IBM Tioli Monitoring processes on one or all gateways. For more information about the command syntax, refer to the IBM Tioli Monitoring: User s Guide. Determining which resource models hae been distributed to endpoints Objectie To determine which resource models hae been distributed to an endpoint. Background information Not applicable. 58 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

69 Required authorization role admin Before you begin Create a profile manager and profile. For detailed information, see Creating profile managers and profiles on page 95. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 97. Add a resource model to a profile. For detailed information, see Adding default resource models to profiles on page 99 and Adding customized resource models to profiles on page 100. For detailed information about each resource model, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. When you finish Not applicable. Procedure You can perform this procedure from the command line only. Command line: Run the wdmlseng command to determine which monitors are running on an endpoint. For example, to iew the list of monitors on an endpoint, enter the following command. wdmlseng -e endpoint where endpoint specifies the endpoint label where the command is to be executed. For more information about the command syntax, refer to the IBM Tioli Monitoring: User s Guide. Viewing resource models results with the IBM Tioli Monitoring Web Health Console This section proides an oeriew of the IBM Tioli Monitoring Web Health Console (hereinafter also referred to as Web Health Console). For detailed information about installing and working with the Web Health Console, see the IBM Tioli Monitoring: User s Guide. The Web Health Console runs on Netscape 6.2 or later, and Internet Explorer 6.x. Use the Web Health Console for: Checking, displaying, and analyzing the status and health of endpoints that hae distributed resource monitors Displaying an endpoint s real-time and historical data logged to the IBM Tioli Monitoring database Viewing online and historical data on endpoints as a follow-up to specific problems Starting and stopping the IBM Tioli Monitoring engine and indiidual resource models on selected endpoint Remoing a profile from the selected endpoint You can use the Web Health Console to check, display, and analyze the status and health of any endpoint with profiles and resource models. Status reflects the state of the endpoint displayed on the Web Health Console, such as running or stopped. Health is a numeric alue determined by resource model settings. You can also use Chapter 5. Working with IBM Tioli Monitoring resource models 59

70 the Web Health Console to work with real-time or historical data from an endpoint that is logged to the IBM Tioli Monitoring database You can use the diagnostic and monitoring capabilities of the Web Health Console to perform targeted analysis of problems associated with indiidual endpoints when an eent is sent to the Tioli Enterprise Console. Use the online and historical data to follow up specific problems with single endpoints. Understanding resource health The Web Health Console obtains eents and indications from endpoints. The Web Health Console displays the health of each potential problem as a numeric alue between 100 (perfect health) and zero (with zero meaning that the conditions for the corresponding eent are met). Intermediate alues show the percentage of occurrences currently registered with respect to the total number of occurrences needed to trigger an eent. See Table 4. Table 4. Health determination example Cycle CPU% Occurrences of Holes H O H O O Occurrence Count Health % Table 4 displays the health percentage changes in steps of 25% because 4 occurrences were required to trigger an eent; if the indication required 5 occurrences, the health percentage would hae changed by steps of 20%. Resource health is determined at the indication leel and passed up to the endpoint. The lowest health of any indication in a resource model is shown as the health of that resource model and the lowest health of any resource model installed on an endpoint is shown as the health of that endpoint. For example, if one indication on one resource model that is installed on an endpoint has a health of zero, the health of the endpoint is shown as zero. The required occurrences, cycle times, thresholds, and parameters for indications are defined when the resource model is created in the IBM Tioli Monitoring Workbench. Connecting to Web Health Console You can connect the Web Health Console to any Tioli management region serer or managed node and configure it to monitor any or all of the endpoints that are found in that region. The Web Health Console does not hae to be within the region itself, although it could be. To connect to the Web Health Console you need access to the serer on which the Web Health Console serer is installed and the Tioli management region on which you want to monitor health. All user management and security is handled through the IBM Tioli management enironment. This includes creating users and passwords, as well as assigning authority. 60 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

71 Chapter 6. Working with Tioli Monitoring for Web Infrastructure: Internet Information Serer resources Showing object properties This chapter proides information about working with Tioli Monitoring for Web Infrastructure: Internet Information Serer resources, to: Show the properties of an Internet Information Serer object Refresh the properties of an Internet Information Serer object Check the status of an Internet Information Serer instance Check the status of a Web site hosted by an Internet Information Serer Start or stop an Internet Information Serer instance Start or stop a Web site hosted by an Internet Information Serer The procedures in this chapter are performed from the Tioli desktop. You can also perform the procedures by using the command line or, for starting and stopping, by using the associated tasks. For more information about the command line, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. For more information about running tasks and jobs, see Chapter 7, Working with tasks and jobs on page 67. Objectie To show the properties of an Internet Information Serer object. Note: The object properties show the actual information that Tioli Monitoring for Web Infrastructure: Internet Information Serer uses when you execute any operation. To keep the object properties up-to-date, see Refreshing object properties on page 62. Background information Not applicable. Required authorization role iiswebserer_user Before you begin Create an Internet Information Serer object. For more information, see Creating Tioli Monitoring for Web Infrastructure: Internet Information Serer objects on page 15. When you finish Not applicable. Procedure You can perform this procedure from either the Tioli desktop or command line. Command line: Run the wiisws command to show a list of the Web sites registered for your enironment. For more information about the command syntax, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Desktop: From the Tioli desktop, perform the following steps: 61

72 1. Double-click the policy region where the Internet Information Serer object is located, to display the Policy Region window. 2. Right-click the object for which you want to show the properties and, from the pop-up menu, select Show properties. (This is equialent to double-clicking the icon). Refreshing object properties A properties dialog box is displayed, showing the following information: The ersion of the Internet Information Serer associated with the object The date and time when the latest refresh of information occurred The list of the Web sites that are hosted by the Internet Information Serer associated with the object. The Web sites are shown in the format website_name(web_address). Objectie To refresh the properties of an Internet Information Serer object. Background information The object properties show the actual information that Tioli Monitoring for Web Infrastructure: Internet Information Serer uses when performing any operation on an Internet Information Serer object. Object properties are not automatically refreshed, when the Internet Information Serer associated with the object is modified (for example, the port is changed). To keep the properties up-to-date, you need to refresh them manually, as explained in this section. Required authorization role iiswebserer_admin Before you begin Not applicable. 62 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

73 When you finish The properties of the Internet Information Serer object hae been refreshed. Procedure You can perform this procedure either from the command line or Tioli desktop. Command line: Use the wiisws command to refresh the object properties. For more information about the command syntax, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Desktop: From the Tioli desktop, perform the following steps: 1. Double-click the policy region where the Internet Information Serer object is located, to display the Policy Region window. 2. Right-click the object for which you want to show the properties and, from the pop-up menu, select Refresh. A dialog box with a message informing you that the operation was successfully executed is displayed. 3. Click OK to close the dialog box and return to the Policy Region window. Checking the status of a Web serer Objectie To check the status of an Internet Information Serer associated with an object. Background information The status of the Internet Information Serer associated with an object, is displayed by Tioli Monitoring for Web Infrastructure: Internet Information Serer as: Actie Not actie Required authorization role iiswebserer_user Before you begin Refresh the object s properties, if needed. For more information, see Refreshing object properties on page 62. When you finish Not applicable. Procedure You can perform this procedure from either the command line or the Tioli desktop. Command line: Use the wiisws command to display the status of a Web serer. For more information about the command syntax, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Desktop: From the Tioli desktop, perform the following steps: 1. Double-click a policy region icon to display the Policy Region window. Chapter 6. Working with Tioli Monitoring for Web Infrastructure: Internet Information Serer resources 63

74 2. Right-click the object whose associated Internet Information Serer you want to check and, from the pop-up menu, select Check Web serer status. A dialog box with a message reporting the status of the Internet Information Serer is displayed. 3. Click OK to close the dialog box and return to the Policy Region window. Checking the status of a Web site Objectie To check the status of a Web site hosted by an Internet Information Serer. Background information The status of a Web site hosted by an Internet Information Serer is displayed by Tioli Monitoring for Web Infrastructure: Internet Information Serer as: Actie Not actie Required authorization role iiswebserer_user Before you begin Refresh the object s properties, if needed. For more information, see Refreshing object properties on page 62. When you finish Not applicable. Procedure You can perform this procedure from either the command line or the Tioli desktop. Command line: Use the wiisws command to display the status of a Web site. For more information about the command syntax, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Desktop: From the Tioli desktop, perform the following steps: 1. Double-click a policy region icon to display the Policy Region window. 2. Right-click the object whose Internet Information Serer Web site you want to check and, from the pop-up menu, select Check Web site status. 64 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

75 The Check the Status of a Web Site dialog box is displayed. 3. From the Web Sites list, select the Web site you want and click Check Status. A dialog box with a message reporting the status of the selected Web site is displayed. 4. Click OK to close the dialog box and return to the Check the Status of a Web Site dialog box. 5. Click Close to close the Check the Status of a Web Site dialog box and return to the Policy Region window. Starting or stopping a Web serer Objectie To start or stop an Internet Information Serer instance. Background information Not applicable. Required authorization role iiswebserer_admin Before you begin Refresh the object s properties. For more information, see Refreshing object properties on page 62. When you finish Not applicable. Procedure You can perform this procedure from the command line, by task, or from Tioli desktop. Command line: Use the wiisws command to start or stop an Internet Information Serer. For more information about the command syntax, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Task: Use the Start task or Stop task to start or stop an Internet Information Serer. For more information about running tasks, see Chapter 7, Working with tasks and jobs on page 67. Desktop: From the Tioli desktop, perform the following steps: 1. Double-click a policy region icon to display the Policy Region window. Chapter 6. Working with Tioli Monitoring for Web Infrastructure: Internet Information Serer resources 65

76 2. Right-click an Internet Information Serer object and, from the pop-up menu, select Start or Stop to start or stop the Web serer associated with the object. A dialog box with a message informing you that the operation was successfully executed is displayed. 3. Click OK to close the dialog box and return to the Policy Region window. Starting or stopping a Web site Objectie To start or stop a Web site hosted by an Internet Information Serer. Background information Not applicable. Required authorization role iiswebserer_admin Before you begin Refresh the objects properties, if needed. For more information, see Refreshing object properties on page 62. When you finish Not applicable. Procedure You can perform this procedure from the command line, task, or Tioli desktop. Command line: Use the wiisws command to start or stop a Web site. For more information about the command syntax, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Task: Use the Start Site task or Stop Site task to start or stop a Web site hosted by an Internet Information Serer. For more information about running tasks, see Chapter 7, Working with tasks and jobs on page 67. Desktop: From the Tioli desktop, perform the following steps: 1. Double-click a policy region icon to display the Policy Region window. 2. Right-click an Internet Information Serer object and, from the pop-up menu, select Start site or Stop site to start or stop a Web site. The Start Web Site or Stop Web Site dialog box is displayed. 3. From the Web Sites list, select the Web site you want and click the Start or Stop button. A dialog box with a message informing you that the operation was successfully executed is displayed. 4. Click OK to close the dialog box and return to the Start Web Site or Stop Web Site dialog box. 5. Click Close to return to the Policy Region window. 66 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

77 Chapter 7. Working with tasks and jobs Running a task This chapter proides information about using tasks to manage your Internet Information Serer objects. The installation process installs the Monitoring for Internet Information Serer Tasks task library in the Monitoring for Internet Information Serer policy region. It is recommended that you do not remoe the task library from this policy region. Objectie To run the Tioli Monitoring for Web Infrastructure: Internet Information Serer task that you require. Background information A task is an action that must be routinely performed on selected endpoints throughout the network. A task defines the executables to be run, the authorization role required to execute the task, and the user or group name under which the task will execute. Tioli Monitoring for Web Infrastructure: Internet Information Serer proides the following standard tasks in the Monitoring for Internet Information Serer Tasks task library: Start Stop Start Site Stop Site Standard tasks run on any machine without consideration of platform type. Required authorization roles iiswebserer_admin Before you begin Refresh the objects properties, if needed. For more information, see Refreshing object properties on page 62. When you finish Not applicable. Procedure You can perform this procedure from either the command line or Tioli desktop. Command line: Run the wruntask command. For more information about the command syntax, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Desktop: From the Tioli desktop, perform the following steps. 1. Double-click the Monitoring for Internet Information Serer policy region icon to display the Policy Region window. 67

78 2. Double-click the Monitoring for Internet Information Serer Tasks icon to display the Task Library window. 3. Double-click the icon of the task you want to run to display the Execute Task dialog box. Additional information: The Execute Task dialog box is a generic dialog box of execution parameters for all tasks. 4. In the Execution Mode group box, select one of the following check boxes: Parallel To run the task simultaneously on all targets. Parallel is typically the fastest method of execution. Serial To run the task sequentially on all targets in alphabetical order. Staged To run the task on all targets in alphabetical order according to a schedule 68 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

79 you specify. Staged execution is useful if you are running the task on a large number of endpoints. Complete Step 8 to specify the Staging Count (number of targets to run against per stage) and the Staging Interal (number of seconds between each set). 5. In the Timeout text box, type a timeout alue for the task (in seconds). Additional information: The Timeout alue does not stop the task. This alue specifies the number of seconds the desktop waits for the task to complete before it issues an error. The task continues to execute on the endpoint without display of output results. Setting an early timeout enables your desktop to become aailable again if the task takes a long time to execute. The default is 60 (seconds). If the task takes longer to complete than the specified Timeout and is running in Serial or Staged mode, the product moes on to other endpoints after this time expires. 6. In the Output Format group box, select one or more of the following check boxes to choose the output returned, upon task completion: Header Includes a descriptie header for each record, such as the task name and target. Return Code Includes the programming codes produced when the task executes. Standard Error Includes all error messages encountered when the task executes. Standard Output Includes all information that results from the task execution. 7. In the Output Destination group box, select one of the following to choose an output destination: Select Display on Desktop to display the task output on the desktop. Additional information: If you choose Display to Desktop, you hae an option to sae the information to a file as an option in the output display window. Select Sae to File to sae the output to a file. To sae the task output to a file: a. In the Output Destination group box, select the Sae to File check box to display the Destination for Task Output dialog box. b. In the On Host text box, type the name of the endpoint on which to sae the output. Additional information: The endpoint must be a Tioli client. c. In the Output File text box, type the absolute name of the output file. Additional information: For example, /tmp/mytask.out d. Click Set & Close to set your choices and return to the Execute Task dialog box. 8. To choose the Internet Information Serer objects where to run the task, do one of the following. Chapter 7. Working with tasks and jobs 69

80 Additional information: Tioli Monitoring for Web Infrastructure: Internet Information Serer tasks can be run only on IISWebSerer endpoints (the type of endpoint is displayed within parentheses following the endpoint). Run the task on specific Internet Information Serer objects, as follows: a. From the Aailable Task Endpoints list, select the Internet Information Serer objects you want. b. Click the left arrow button to moe the selected objects to the Selected Task Endpoints list. Run the task on all subscribers of the specified profile managers, as follows: a. From the Aailable Profile Managers list, select the profile managers. b. Click the left arrow button to moe the selected profile managers to the Selected Profile Managers list. 9. Click Execute. According to the task requirements, the following occurs: If the task does not require any additional argument, the task is immediately executed. If the task requires one or more arguments, the appropriate task argument dialog box is displayed. Additional information: Each task has a unique task argument dialog box. Following is an example of a task argument dialog box. For information about how to fill in the task argument dialog box, refer to the task description in the IBM Tioli Monitoring for Web Infrastructure: Reference Guide, or click Task Description to display the online help. At completion, click Set & Execute to run the task. Customizing the Start Site and Stop Site tasks Objectie To customize the Start Site and Stop Site tasks to execute them on a predefined Web site. Background information A customized task is a standard task with defined arguments saed in the task library with a unique name. For example, you can customize a task to sae task output results to a file after each execution. Because you can customize task arguments, the Tioli enironment does not display argument dialogs when you run the task from the desktop. Howeer, if you run a customized task from the command line, you still must specify the task arguments. Running a customized task requires additional information before it runs, such as the target of the execution. 70 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

81 Required authorization roles super, senior, admin Before you begin Not applicable. When you finish You can run the task by following the procedure in Running a task on page 67. When you run a customized task, the Tioli desktop does not display the task argument dialog. Procedure You can perform this procedure from the Tioli desktop only. 1. Double-click the Monitoring for Internet Information Serer policy region icon to display the Policy Region window. 2. Double-click the Monitoring for Internet Information Serer Tasks icon to display the Task Library window. 3. Double-click the Start Site or Stop Site icon to display the Execute Task dialog box for that task. Additional information: The Execute Task dialog box is a generic dialog box of execution parameters for all tasks. Enter the information required to run the task, as described in Running a task on page 67. Chapter 7. Working with tasks and jobs 71

82 4. Click Execute to display the task argument dialog box. Additional information: Each standard task has a unique task argument dialog box. Following is an example of a task argument dialog box. 5. In the Web Site Name text box, enter the name of the Web site where the task is to be run. Additional information: For information about each field in the dialog box, see the task description in the IBM Tioli Monitoring for Web Infrastructure: Reference Guide or click Task Description to display the online help. 72 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

83 6. Click Sae to display the Sae Argument dialog box. 7. Type the following information to define the customized task: a. In the Name text box, type a name for the task. Additional information: The name appears in the Library Contents field so you can iew the customized tasks that are based on the parent task. b. Type an identifier for the task. Additional information: The identifier is the name of the task icon in the Task Library window. A customized task identifier has two parts. The first part should be the standard task name (such as Start Site). The second part should be descriptie information that makes sense to you. For example, you could type Goodnews. The resulting task name would be Start Site_Goodnews. The software generates a unique default name (such as Start Site_aaa) if no identifier is entered. To enable filtering for an identifier without the standard task name, edit the tl_def_man_nodes policy method in the task library policy object. For more information, see the Tioli Management Framework Reference Manual. c. In the Description text box, type a description of the task. Additional information: This description appears when you click Task Description in the task argument dialog box for this customized task. d. Optional: Select the Show by Identifier check box to change the Library Contents list to use the task identifier instead of the task name. e. Optional: Click Parent Description to display information about the parent task from which you are creating this customized task. Additional information: The task information appears under the heading Description. f. Click Sae & Close to return to the task argument dialog box. 8. In the task argument dialog box, click Cancel to return to the Execute Task dialog box. Chapter 7. Working with tasks and jobs 73

84 9. In the Execute Task dialog box, click Close to return to the Task Library window. 10. From the View drop-down menu, click Refresh to update the Task Library window with the task you hae customized. Creating a job Objectie To create a job by defining execution parameters so you can specify a target enabling you to schedule it to run at certain times in the Scheduler. Background information A job is a task with defined and saed arguments that can be executed many times on specific managed resources. You can create jobs from both standard and customized tasks in the product task library. Like tasks, you store jobs in task libraries, so you can reuse them. Required authorization roles super, senior, admin Before you begin Not applicable. When you finish After you create a job, you can run it immediately using the procedure described in Running a job on page 78. You also can schedule jobs to run at certain times in the Scheduler, as described in Scheduling a job on page 79. Procedure You can perform this procedure from either the command line or Tioli desktop. Command Line: Run the wcrtjob command. The syntax is as follows: wcrtjob j job_name l Monitoring for Internet Information Serer Tasks t task_name M mode [ s interal n number] m timeout o output_format [ h target_endpoint_name] [ p prof_manager_name] where: h target_endpoint_name The name of the target Internet Information Serer object, in the 74 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

85 j job_name The name of the job being created. Job names can include any alphanumeric character, an underscore (_), a dash ( ), a period (.), and a space. l Monitoring for Internet Information Serer Tasks The task library containing the task to be included in the job. m timeout The number of seconds that the task library waits for results to be returned from the task. This option does not affect the execution of the job. If you selected staged mode, the timeout must be smaller than the interal time. M mode The mode in which the job runs. Valid options are: parallel serial staged Runs the job on all specified endpoints and any subscribers simultaneously. Runs the job on one endpoint at a time. Runs the job on a set number of endpoints at specified interals. n number The number of managed nodes in each group in staged mode. If you selected staged mode, you must specify a alue for this option. o output_format The format of the job output. s interal The number of seconds between when the task runs on one group of managed nodes and when it runs on the next group. If you selected staged mode, you must specify a alue for this option. t task_name The name of the task to include in the job (Start, Stop, Start Site, or Stop Site). p prof_manager_name The profile manager on which the job runs. For more information about the command syntax, refer to the Tioli Management Framework: Reference Manual. Desktop: Perform the following steps: 1. Double-click the Monitoring for Internet Information Serer policy region icon to display the Policy Region window. 2. Double-click the Monitoring for Internet Information Serer Tasks icon to display the Task Library window. Chapter 7. Working with tasks and jobs 75

86 3. From the Create drop-down menu, click Job to display the Create Job dialog box. 4. In the Job Name text box, type a descriptie job name. Additional information: The job name identifies the icon on the desktop. The name can include any alphanumeric character, an underscore (_), dash ( ), period (.), or blank space. 5. From the Task Name list, select the task on which the job is based. 6. In the Execution Mode group box, select one of the following check boxes: Parallel To run the task simultaneously on all targets. Parallel is typically the fastest method of execution. Serial To run the task sequentially on all targets in alphabetical order. Staged To run the task on all targets in alphabetical order according to a schedule you specify. Staged execution is useful if you are running the task on a large number of endpoints. Complete Step 8 to specify the Staging Count (number of targets to run against per stage) and the Staging Interal (number of seconds between each set). 7. In the Timeout text box of the Execution Parameters group box, type the timeout alue for the task (in seconds). Additional information: This alue specifies the number of seconds the product waits for the task or job to complete before it issues an error. The default is 60. If the task takes longer to complete than the specified Timeout and is running in Serial or Staged mode, the product moes on to other endpoints after this 76 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

87 time expires. The task continues to execute on the endpoint, een though the product has stopped waiting for it to end. 8. Optional: If you selected Staged in Step 6, specify the number of endpoints to include in each staged set in the Staging Count text box and the number of seconds between each set s startup time in the Staging Interal text box. 9. In the Output Format group box, select one or more of the following check boxes to choose the output type: Header Includes a descriptie header for each record. Return Code Includes the programming codes produced when the job executes. Standard Error Includes all error messages encountered when the job executes. Standard Output Includes all information that results from the job execution. 10. In the Output Destination group box, do one of the following to choose an output destination: Click Display on Desktop to display the job output on the desktop. Go to Step 12. Additional information: If you choose Display to Desktop, you hae an option to sae the information to a file as an option in the output display window. Click Sae to File to sae the output to a file and display the Destination for Task Output dialog box. Go to Step To sae the job output to a file, in the Destination for Task Output dialog box perform the following steps: a. In the On Host text box, type a Tioli client endpoint name on which to sae the output. b. In the Output File text box, type the name, with its complete path, of the output file. Additional information: For example, /tmp/myjob.out c. Click Set & Close to set your choices and return to the Create Job dialog box. 12. To choose the Internet Information Serer objects where to run the task, do one of the following. Additional information: Tioli Monitoring for Web Infrastructure: Internet Information Serer tasks can be run only on IISWebSerer endpoints (the type of endpoint is displayed within parentheses following the endpoint). Run the task on specific Internet Information Serer objects, as follows: a. From the Aailable Task Endpoints list, select the Internet Information Serer objects you want. b. Click the left arrow button to moe the selected objects to the Selected Task Endpoints list. Chapter 7. Working with tasks and jobs 77

88 Run the task on all subscribers of the specified profile managers, as follows: a. From the Aailable Profile Managers list, select the profile managers. b. Click the left arrow button to moe the selected profile managers to the Selected Profile Managers list. 13. Click Create & Close to create the job and return to the Task Library window, where the new job icon has been added. Running a job Objectie To execute a job on specific endpoints immediately, so you can perform a management operation. Background information Before you can run a job, you must create it, as described in Creating a job on page 74. If you created a job from a standard task, the Tioli desktop displays the task argument dialog so that you can fill in any required information. Jobs created from customized tasks run without further input because all required information is specified. (See Customizing the Start Site and Stop Site tasks on page 70 for information about how to create a customized task.) Required authorization roles iiswebserer_admin Before you begin Not applicable. When you finish Not applicable. Procedure You can perform this procedure from either the Tioli command line or the desktop. Command line: Run the wrunjob command. For more information about this command, see the Tioli Management Framework: Reference Manual. Desktop: Perform the following steps: 1. Double-click the Monitoring for Internet Information Serer policy region icon to display the Policy region window. 2. Double-click the Monitoring for Internet Information Serer Tasks icon to display the Task Library window. 3. Do one of the following: Double-click the job icon created from a customized task to begin executing the job. Double-click the job icon created from a standard task. Go to Step Type the alues in the task dialog box. Additional information: For information about specific fields, see the task description in the product reference guide or click Task Description to display the online help. The product runs the job and displays the output on the desktop or sends it to a file in accordance with the job specification. 78 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

89 Scheduling a job Objectie To schedule jobs to occur regularly so you can routinely perform management operations. Background information The product uses Scheduler to schedule jobs. Scheduler is a serice that enables you to run jobs unattended. You can schedule a job to run one time or multiple times. Scheduler notifies you by the manner you select when a job is complete. To schedule a job, the job must exist in the task library. You create a job by following the procedure described in Creating a job on page 74. Required authorization roles iiswebserer_admin Before you begin Not applicable. When you finish Not applicable. Procedure You can perform this procedure from either the Tioli command line or the desktop. Command Line: Run the wschedjob command. From the command line, you can schedule only jobs that already exist in the task library. For more information, see the Tioli Management Framework: Reference Manual. Desktop: Perform the following steps: 1. Double-click the Monitoring for Internet Information Serer policy region icon to display the Policy region window. 2. Double-click the Monitoring for Internet Information Serer Tasks icon to display the Task Library window. 3. Drag the job icon that you want to schedule onto the Scheduler icon located on the Tioli desktop. 4. Optional: If a task argument dialog box display, do the following: a. Type the appropriate information for each field in the dialog. Additional information: Refer to the task description in the product reference guide or click Task Description to display the online help for this task. b. Click Set & Execute to set the task arguments and open the Add Scheduled Job dialog box. 5. In the Job Label text box of the Add Scheduled Job dialog box, type a label for the job icon. Additional information: The label identifies the icon on the desktop. The job label can include alphanumeric character, underscores (_), dashes ( ), periods (.), and blanks. If you do not specify a label, the job name is used. 6. Do one of the following: To stop a scheduled job from running, select the Disable the Job check box. To continue running a scheduled job, clear the Disable the Job check box. Additional information: For more information on job disabling, see the Tioli Management Framework: User s Guide. Chapter 7. Working with tasks and jobs 79

90 7. Optional: In the Description field, type a job description to uniquely identify the job. 8. In the Schedule Job For group box, set the date and time to begin scheduling: a. Type a date in the Month, Day, and Year text boxes. b. Enter the time by using the Hour and Minute drop-down lists and the AM and PM radio buttons. 9. Optional: To repeat the job, in the Repeat the Job group box: a. Do one of the following: To repeat the job indefinitely, select the Repeat the job indefinitely check box. To repeat the job a finite number of times: 1) Select the Repeat the job check box. 2) Type the number of times you want the job to run. b. In the The job should start eery field, set the interal between start times for the job. 10. In the When Job Completes group box, select any of the following check boxes to send job completion notification: To send a notice to a specific group: a. Select the Post Tioli Notice check box. b. Click Aailable Groups to display the Aailable Groups dialog box. c. From the list of notice groups, select a group. d. Click Set to set your group and return to the Add Scheduled Job dialog box. Additional information: You can read notices from the Tioli desktop by clicking on the Notices icon. To send a notice to your desktop: a. Select the Post Status Dialog on Desktop check box. b. In the text box next to the check box, type the message you want displayed. To send an to a specified user: a. Select the Send to check box. b. In the text box next to the check box, type the complete address. To log the job completion status to a file: a. Select the Log to File check box. b. Enter the file destination by doing one of the following: In the Host and File text boxes, type the file destination. OR Browse for the file destination, as follows: 1) Click File Browser to display the File Browser dialog. 2) Double-click on a host name to display the directories and files for that host. 3) From the Directories and Files lists, select a directory and file. 4) Click Set File & Close to return to the Add Scheduled Job dialog box. 11. Optional: To set retry, cancel, or restriction options: 80 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

91 a. Click Set Retry/Cancel/Restriction Options to display the Set Retry/Cancel Restrictions Options dialog box. b. Choose one of the following cancel job options: To hae the Scheduler continue trying the job indefinitely, clear the Cancel job check box. To set the Scheduler to cancel a job in a specified time frame, do the following: 1) Select the Cancel job check box. 2) Type the time frame for the Scheduler to wait before canceling a job that has not started. c. Click one of the following retry options: To retry the job until it runs successfully, click Retry the job until success. To specify the number of times a job attempts to run, do the following: 1) Select the Retry the job check box. 2) Type the number of attempts to start the job in the text box. 3) In The job should retry eery field, type the amount of time the Scheduler waits before retrying. d. In the Restrictions group box, select any of the following check boxes to specify the job run times: During the day Set the beginning and ending hour of day for the job to run. At night Set the beginning and ending hour of night for the job to run. During the week Set the beginning and ending day of the week for the job to run. On weekends Set the beginning and ending day of the weekend for the job to run. e. Click Set to set the options and return to the Add Scheduled Job dialog box. 12. Click Schedule Job & Close to schedule the job and return to the Tioli desktop. Chapter 7. Working with tasks and jobs 81

92 82 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

93 Chapter 8. Enabling Tioli Monitoring for Web Infrastructure: Internet Information Serer for Tioli Enterprise Data Warehouse Oeriew This chapter proides information on enabling Tioli Monitoring for Web Infrastructure: Internet Information Serer for Tioli Enterprise Data Warehouse. Tioli Enterprise Data Warehouse enables you to access application reports from arious Tioli and customer applications. The infrastructure proides a set of extract, transform and load (ETL) utilities that you use to extract and moe data from Tioli application data stores to a central data warehouse database. Tioli Enterprise Data Warehouse proides the following capabilities: An open architecture for storing, aggregating, and correlating historical data. In addition to the data collected by IBM Tioli software, Tioli Enterprise Data Warehouse has the flexibility and extensibility to enable you to integrate your own application data. Database optimizations for the efficient storage of large amounts of historical data and for fast access to data for analysis and report generation. The infrastructure and tools necessary for maintaining and iewing the collected data. These include the Tioli Enterprise Data Warehouse application, IBM DB2 Uniersal Database Enterprise Edition, the Data Warehouse Center, DB2 Warehouse Manager, and a user interface for creating and iewing reports. The ability to use your choice of data analysis tools to examine your historical data. In addition to the report interface, you can analyze your data using other products such as online analytical processing (OLAP), planning, trending, analysis, accounting, and data mining tools. The ability to control access to your historical data. You can keep data about multiple customers and data centers in one central data warehouse, but restrict access so that customers can see and work with data and reports based only on their data and not any other customer s data. You can also restrict an indiidual user s ability to access data. A zero-footprint client. Users can access Tioli Enterprise Data Warehouse reports from any system by using a Web browser. No special software is required on the user s system. Internationalization support. Not only is the report interface localized, application programmers can localize the data stored in the central data warehouse. Tioli Enterpise Data Warehouse consists of the following components, which are described in the following sections: Control serer Central data warehouse Data marts Report interface 83

94 Control serer The control serer contains the control database for Tioli Enterprise Data Warehouse from which you manage your data warehouse. The control serer has the following subcomponents: A serer that controls communication between the control serer, the central data warehouse serer, the data mart serer, and the report serer. The control database, which contains metadata for Tioli Enterprise Data Warehouse. The control serer uses the following parts of the IBM DB2 product, which you must install manually before installing the control serer. These parts are all automatically installed when you install IBM DB2 Uniersal Database Enterprise Edition on a Microsoft Windows system. DB2 Serer. The Data Warehouse Center, a component that automates data warehouse processing. You can use the Data Warehouse Center to define the ETL processes that moe and transform data into the central data warehouse and the star schemas used by the data marts. Then, you can use the Data Warehouse Center to schedule, maintain, and monitor these processes. The warehouse agent, part of DB2 Warehouse Manager. Central data warehouse The central data warehouse is a DB2 database that contains the historical data for your enterprise. The system that hosts the central data warehouse is called the central data warehouse serer. The central data warehouse component uses IBM DB2 Uniersal Database Enterprise Edition, which you must install manually before installing the control serer. Data marts A separate DB2 database contains the data marts for your enterprise. Each data mart contains a subset of the historical data from the central data warehouse to satisfy the analysis and reporting needs of a specific department, team, customer, or application. The system that hosts this DB2 database is called the data mart serer. Although you can hae many data marts, you can hae only one data mart serer. The data mart component requires IBM DB2 Uniersal Database Enterprise Edition, which you must install manually before installing the control serer. The warehouse pack for Tioli Monitoring for Web Infrastructure: Internet Information Serer creates data marts whose structure is suitable for the report interface. They do this by proiding an extract, transform, and load (ETL) process, called a data mart ETL, that creates the data mart and loads it with data from the central data warehouse. You can modify an existing data mart, or create new data marts that contain slightly different data, to address a reporting need specific to your situation. To modify or create a data mart, you must be familiar with database ETL processes and with the internal representation of a data mart as star schemas in the Tioli Enterprise Data Warehouse databases. For information about this, see Enabling an Application for Tioli Enterprise Data Warehouse. 84 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

95 Report interface The Tioli Enterprise Data Warehouse report interface (RPI) proides tools and a graphical user interface that other Tioli software products use to create and display reports. You can use Tioli Enterprise Data Warehouse to customize reports proided with other Tioli software and to create new reports. You also use the report interface to control access to data marts and to the reports associated with a data mart. The system on which you install the report interface is called the report serer. Use the Work with Reports task group in the report interface to manage users, groups, and data marts for Tioli Enterprise Data Warehouse or to run, create, and iew Tioli Enterprise Data Warehouse reports. Refer to the following sections for a description of how to perform the following tasks: Working with users Working with roles and groups Working with data marts Working with reports Uploading data to the central data warehouse When you distribute a profile that was enabled for data logging into the central data warehouse, the endpoint runs the resource model and data is collected into the endpoint database. To upload the data from the endpoint database into a relational database management system (RDBMS) used by IBM Tioli Monitoring, use the wdmcollect command. After the data is loaded to the RDBMS, the Tioli Monitoring ETL1 process, which is scheduled by Tioli Enterprise Data Warehouse, extracts the data from the database and loads it to the central data warehouse. For more information about the integration with Tioli Enterprise Data Warehouse and the wdmcollect command syntax, refer to the IBM Tioli Monitoring: User s Guide. Working with users and user groups This section describes tasks associated with managing user groups for Tioli Enterprise Data Warehouse. It includes the following topics: An oeriew of users and user groups An oeriew of the Tioli Enterprise Data Warehouse roles Creating an IBM Console user Assigning roles to a user Creating a user group Assigning users to a user group About users and user groups You control access to data in Tioli Enterprise Data Warehouse data marts by specifying which user groups (collections of users) can run the reports that access the data in each data mart. Each user in a user group is gien access to all reports that access the data in the data marts to which that user group has access. Chapter 8. Enabling product for Tioli Enterprise Data Warehouse 85

96 By default, Tioli Enterprise Data Warehouse proides the TWHAdmin user group, which contains a single user: superadmin. You can customize the TWHAdmin user group for the needs of your enterprise. A user can be assigned to more than one user group. The Tioli Enterprise Data Warehouse roles The following Tioli Enterprise Data Warehouse roles control access to tasks and actiities in the Work with Reports task group: Warehouse Security Administrator With this role, a user can create and manage groups and data marts. A user with this role controls access to data marts by assigning users to groups and by giing groups access to specific data marts. In effect, this role controls access to the Tioli Enterprise Data Warehouse data using user groups and data marts. Report roles control a user s ability to create and modify reports for the data marts his user groups can access. Assign only one of the following roles to each user: Adanced Report Author With this role, a user can create, modify, run, and delete public and their own personal reports, and sae the output of reports, both public and personal. Report Author With this role, a user can run and sae the output of public reports and create and modify their own personal reports. They can run public and personal reports, and create, modify, and delete personal reports. Report Reader With this role, a user can run public reports and iew the saed output of public reports. Creating an IBM Console user Objectie To create an IBM Console user. Background information Tioli Enterprise Data Warehouse is displayed using the IBM Console, which is also used by other Tioli software products. A user is gien access to tasks in the IBM Console based on the roles that are assigned to that user. One user can hae roles for dierse tasks including administering IBM Console users, managing Tioli Enterprise Data Warehouse user groups and data marts, running and iewing the output of Tioli Enterprise Data Warehouse reports, and performing tasks associated with other Tioli software products. Required authorization role superadmin Before you begin Not applicable. When you finish The Tioli Enterpise Data Warehouse online help also guides you through additional tasks for managing users, such as updating or displaying the properties of a user and deleting a user. 86 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

97 Assigning roles to a user Creating a user group Procedure To create an IBM Console user, perform the following steps: 1. From the portfolio of the IBM Console, select Administer Users and then Create a User. 2. Open the Task Assistant and follow the instructions proided about creating a user. Objectie To assign roles to a user. Background information Not applicable. Required authorization role superuser Before you begin Not applicable. When you finish The Tioli Enterpise Data Warehouse online help also guides you through additional tasks for managing users, such as updating or displaying the properties of a user and deleting a user. Procedure To assign a role to a user, perform the following steps: 1. From the portfolio of the IBM Console, select Administer Users and Roles and then Manage Users. 2. From the table of users, click the context menu icon of a user and select Properties. 3. Follow the instructions in the Task Assistant about assigning roles to the user. Objectie To create a user group. Background information Not applicable. Required authorization role Administration authorizations Before you begin Not applicable. When you finish The Tioli Enterpise Data Warehouse online help also guides you through additional tasks for managing user groups, such as updating or displaying the properties of a user group, adding users to a user group, and deleting a user group. Chapter 8. Enabling product for Tioli Enterprise Data Warehouse 87

98 Assigning users to a user group Objectie To assign users to user groups. Background information Not applicable. Required authorization role Administration authorizations Before you begin Not applicable. When you finish The Tioli Enterpise Data Warehouse online help also guides you through additional tasks for managing user groups, such as updating or displaying the properties of a user group, adding or remoing users from a user group, and deleting a user group. Procedure To assign one or more users to a user group, perform the following steps: 1. From the portfolio of the IBM Console, select Work with Reports and then Manage User Groups. 2. In the Manage User Groups window, click the context menu icon of a group and select Properties. 3. Follow the instructions in the Task Assistant about assigning users to user groups. The Tioli Enterpise Data Warehouse online help also guides you through additional tasks for managing user groups, such as updating or displaying the properties of a user group, adding or remoing users from a user group, and deleting a user group. Assigning user groups to a data mart Objectie To assign user groups to a data mart. Background information Grant access to only those user groups whose users need the data mart to perform tasks. Required authorization role Administration authorizations Before you begin Not applicable. When you finish The Tioli Enterpise Data Warehouse online help can guide you through additional tasks for managing user groups, such as updating or displaying the properties of a user group, remoing users from a user group, and remoing data mart access from a user group. Procedure To assign user groups to a data mart, perform the following steps: 88 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

99 1. From the portfolio of the IBM Console, select Work with Reports and then Manage Data Marts. 2. In the Manage Data Marts window, in the Data Mart iew, click the context menu icon for the data mart that you want to change and click Properties. 3. Select the User Groups tab. Managing Tioli Enterprise Data Warehouse reports Running reports Tioli Enterprise Data Warehouse reports display a static iew of the data in a data mart. Reports are proided by the warehouse pack for Tioli Monitoring for Web Infrastructure: Internet Information Serer, along with the data marts required to collect the data used in the report. This section describes the following tasks: Running a report manually Automatically running reports Modifying default settings for report creation Creating a report For more information about working with reports, see the Tioli Enterpise Data Warehouse online help. Tioli software products using the Tioli Enterprise Data Warehouse can proide prepackaged reports that enable you to access specific information about your business enironment. All of these reports are listed in the Manage Reports and Report Output task of the Work with Reports task group in the portfolio. This includes reports from all Tioli software products that use the Tioli Enterprise Data Warehouse report interface. Tioli software products can also proide a different reporting interface. A Tioli Enterprise Data Warehouse report uses data from a single data mart. If you hae the appropriate role, you can also create additional reports or modify existing reports. Before you can create a new report or modify an existing report, you must understand the structure of the underlying warehouse data and of the operational data that is the source of that data. For information about the structure of data in the data mart and in the central data warehouse, see Tioli Enterpise Data Warehouse V1.1 Enabling an Application for Tioli Enterpise Data Warehouse. For information about the specific data mart, star schema, and report mapping of Tioli Monitoring for Web Infrastructure: Internet Information Serer, see the Tioli Monitoring for Web Infrastructure: Internet Information Serer Warehouse Enablement Pack Implementation Guide that is located in the /Docs directory of your product installation CD-ROM. Objectie To run a report using the report interface. Background information Not applicable. Chapter 8. Enabling product for Tioli Enterprise Data Warehouse 89

100 Required authorization role AdRepAuthRole, RepAuthRole, or RepReaderRole Before you begin Not applicable. When you finish The Tioli Enterpise Data Warehouse online help can also guide you through additional tasks for reports, such as displaying the properties of a report and deleting a report. Procedure To run a report using the report interface, perform the following steps: 1. From the portfolio of the IBM Console, select Work with Reports and then Manage Reports and Report Output. 2. In the Manage Reports and Report Output window, in the Reports iew, click the context menu icon of a report and select Run. Scheduling reports to run automatically Objectie To automatically run reports. Background information Using the Tioli Enterprise Data Warehouse report interface, you can schedule a report to run automatically when the associated data mart is updated. This ensures that when you examine the output of the report, it displays the most recent data in the warehouse. Required authorization role AdRepAuthRole Before you begin Not applicable. When you finish The Tioli Enterpise Data Warehouse online help can also guide you through additional tasks for reports, such as modifying or displaying the properties of a report and deleting a report. Procedure To schedule a report to run automatically when the associated data mart is updated, perform the following steps: 1. From the portfolio of the IBM Console, select Work with Reports and then Manage Reports and Report Output. 2. In the Manage Reports and Report Output window, in the Reports iew, click Reports. 3. Click the context menu icon of a report and select Properties. Modifying default settings for reports Objectie To modify default settings for report creation. 90 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

101 Background information When you create or modify a report, you select predetermined alues for the time frame of the report. The predetermined alues of Peak Hours and Weekdays specified under Filtering in the Time page of report properties can be modified. Do this by modifying the information in the control database on the control serer. The default alue for Peak Hours is 9:00 am through 5:00 PM, or 0900 to This alue can be modified to reflect different peak hours if necessary. The default alue for Weekdays is Monday through Friday. This alue can also be modified. The RPI.TimeFilters table contains the following filters and default filter alues. Table 5. Default time filter names and alues TIME_FILTER_NAME TIME_FILTER_VALUES Peak hours hour(meas_hour) in (9,10,11,12,13,14,15,16,17) Weekdays dayofweek(meas_date) between 2 and 6 Creating reports Required authorization role AdRepAuthRole Before you begin Not applicable. When you finish For additional information on the properties of the RPI.TimeFilters table, see Enabling an Application for Tioli Enterprise Data Warehouse. Procedure To change the alues displayed in the report interface, perform the following steps: 1. Connect to the control database (TWH_MD). 2. Use an SQL statement similar to the following to modify the alues for Peak Hours or Weekdays in the RPI.TimeFilters table. The following example sets the Weekdays filter to represent Sunday through Thursday: Update RPI.TimeFilters set TIME_FILTER_VALUES =dayofweek(meas_date) between 1 and 5 where TIME_FILTER_NAME =Weekdays After doing this, when a user selects a Weekdays filter for a report in the report interface, the data returned is for Sunday through Thursday. Note: There is no error-checking for the alues inserted into the tables for Peak Hours and Weekdays. Therefore, ensure that the information you insert into the tables is correct. You can sae a report that contains incorrect alues for these parameters without receiing an error message. The message is not generated until the report is run. Objectie To create a report. Background information Tioli Enterprise Data Warehouse proides the following types of report: Chapter 8. Enabling product for Tioli Enterprise Data Warehouse 91

102 Extreme case A typical use of a One Measurement Versus Many Components class of report is to display the worst n cases. Extreme case reports show the extreme cases, such as the top n serers haing the most critical eents. Health check A typical use of a Many Measurements Against Many Components Versus Time class of report is a health check report. This type of report depicts a gien measurement, or measurements, against a specified time frame. The X-axis always shows a specified time frame. The Y-axis (or axes) shows the measures you would like to see, within the specified X-axis time frame. You can illustrate one to fie measurements on the Y-axis. Summary A typical use of a Many Measurements Versus Many Components class of report is a summary report. This type of report is useful for showing subtotals for a particular grouping and grand totals for the entire report. The rows represent components, or more often component groupings. The columns contain typically between measurements. Required authorization role AdRepAuthRole or RepAuthRole Before you begin Ensure that you use descriptie and meaningful names for the reports you create. Report names are unique across all users of Tioli Enterprise Data Warehouse. When you finish The Tioli Enterpise Data Warehouse online help also guides you through additional tasks for reports, such as modifying or displaying the properties of a report and deleting a report. Procedure To create a report, from the IBM Console perform the following steps: 1. From the My Work pane, click Work with Reports and select Create a Report. 2. In the Create a Report pane, select the Type of report you want to create. 3. From the Aailable Data Marts list, select the data mart that contains the information from which to create a report. 4. Click OK to display the Create a Report pane with the General tab already selected for you. 5. Enter a Name and Description for the report. 6. Optional: Select the Public check box to make the report aailable to other users. 7. Click the Metrics tab and select the Add button to display the Add Metrics pane. 8. From the Aailable Star Schemas list, select the star schema that you want. The Aailable Metrics list is updated accordingly. 9. Select at least one up to fie metrics to include in your report, and click Next. 10. From the Aggregation drop-down list of each metric, select the type of data aggregation you want, and click Next. 11. From the Filter by drop-down lis of each attributet, select the alue that determines which data is to display in your report. Additional information: For example, to display information about a specific Web site, select the name of the Web site in the GWI.D_SERVER.SERVERNAME field. 92 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

103 12. Click Finish to return to the Create a Report pane. 13. Click the Time tab, and specify the time frame for which you want to run the report. Additional information: You can either specify a General Time Frame, such as the last 7 days, or a Specific Time Interal, such as Noember 1, 2002 through Noember 30, Optional: Click the Schedule tab, and select the Run the report when the data mart is built check box. 15. Click OK to create the report. A dialog box with the message The report was created is displayed. 16. Click OK to close the window and return to the Welcome pane. To see the report output, from the My Work pane select Manage reports and Report Output. Creating a Many Measurements Versus Time report Objectie To create a Many Measurements Versus Time report. Background information Following is an example of a report that shows the data aggregated for the metric Error rate, oer the specified time frame. Required authorization role AdRepAuthRole or RepAuthRole Before you begin Not applicable. When you finish Not applicable. Chapter 8. Enabling product for Tioli Enterprise Data Warehouse 93

104 Procedure You can perform this procedure from the IBM Console. The steps are the same as the procedure in Creating reports, but includes the specific alues for this type of report. To create reports of the Many Measurements Versus Time class, from the IBM Console perform the following steps: 1. From the My Work pane, click Work with Reports and select Create a Report. 2. In the Create a Report pane, select Health Check as the type of report to create. 3. From the Aailable Data Marts list, select GWI Sample Website Data Mart. 4. Click OK to display the Create a Report pane with the General tab already selected for you. 5. Enter a Name and Description for the report. 6. Click the Metrics tab and select the Add button to display the Add Metrics pane. 7. From the Aailable Star Schemas list, select the star schema that you want. The Aailable Metrics list is updated accordingly. 8. Select at least one up to fie metrics to include in your report, and click Next. 9. From the Aggregation drop-down list of each metric, select the type of data aggregation you want, and click Next. 10. From the Filter by drop-down lis of each attributet, select the alue that determines which data is to display in your report. Additional information: For example, to display information about a specific Web site, select the name of the Web site in the GWI.D_SERVER.SERVERNAME field. 11. Click Finish to return to the Create a Report pane. 12. Click the Time tab, and specify the time frame for which you want to run the report. Additional information: You can either specify a General Time Frame, such as the last 7 days, or a Specific Time Interal, such as Noember 1, 2002 through Noember 31, Click OK to create the report. A dialog box with the message The report was created is displayed. 14. Click OK to close the window and return to the Welcome pane. 94 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

105 Appendix A. Setting up IBM Tioli Monitoring During installation, Tioli Monitoring for Web Infrastructure: Internet Information SererTioli Monitoring for Web Infrastructure: Internet Information Sererperforms seeral tasks that help to set up your IBM Tioli Monitoring enironment, including creating profile managers, adding resources to the profiles, and adding resource models to profiles. This appendix proides procedures to create additional profile managers or customize the resources or resource models assigned to your profile manager. To guide you to set up IBM Tioli Monitoring and monitoring information, the following topics are coered: Creating profile managers and profiles Subscribing resources to profile managers Adding default resource models to profiles Adding customized resource models to profiles Rerun a failed profile distribution Creating profile managers and profiles Objectie To create profile managers and profiles so that you can organize and distribute your resource models. Background information A monitoring profile is a group of defined resource models that you can distribute (download or push) to a subscribed (marked to receie) managed resource in a profile manager. In addition to actiating default resource models, profile managers and profiles can group resources to enable simultaneous monitoring of multiple resources. You can hierarchically organize the profile managers. The profile manager is the top leel of the organization and contains specific profiles that contain specific resource models. Instances and databases are then subscribed to the profile managers, which enable the monitoring information to be channeled to those resources. You can create an unlimited number of profile managers, but it is recommended that they reflect some logical or functional grouping of database resources or the business s organizational structure. For example, profile managers could be labeled Sales and Marketing, Administration and Finance, and Operations to reflect a business organization. IBM Tioli Monitoring profile managers can be created as dataless or database profile managers. Only profiles in dataless profile managers can be distributed to endpoints. Only profiles in database profile managers can be distributed to other profile managers. Required authorization role admin 95

106 Before you begin Set up the Tmw2kProfile managed resource types. For more information, refer to the IBM Tioli Monitoring: User s Guide. When you finish Add resource models to the profile. See Adding default resource models to profiles on page 99 and Adding customized resource models to profiles on page 100. Procedure You can perform this procedure from either the command line or the Tioli desktop. Command line: 1. Run the wcrtprfmgr command to create a profile manager. For example, to create a profile manager called ProfMgr2 in the TestRegion policy region, enter: ProfMgr2 2. Run the wsetpm command with the d parameter to make the policy manager operate in dataless mode. For example, to make the profile manager ProfMgr2 dataless, enter: wsetpm 3. Run the wcrtprf command to create a profile. For example, to create a profile called MarketingProf2 in the ProfMgr2 profile manager, enter: MarketingProfile MarketingProf2 For additional information about these commands syntax, see the Tioli Management Framework: Reference Manual. Desktop: Perform the following steps: 1. Double-click the policy region icon to display the Policy Region window. 2. From the Create drop-down menu, select ProfileManager to display the Create Profile Manager dialog box. 3. In the Name/Icon Label text box, specify a unique name for the profile manager. 4. Select the Dataless Endpoint Mode check box to create the profile manager in dataless mode. Additional Information: IBM Tioli Monitoring profile managers can be created as dataless or database profile managers. Only dataless profile managers can be distributed to endpoints, meaning that only endpoints can subscribe to a 96 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

107 dataless profile manager. Only database profile managers can be distributed to other profile managers, meaning that only profile managers can subscribe to a database profile manager 5. Click Create & Close to return to the policy region window. 6. Double-click the profile manager icon to display the Profile Manager window. 7. From the Create drop-down menu, select Profile to display the Create Profile dialog box. 8. In the Name/Icon text box, type a unique name for the profile. 9. From the Type box, select the Tmw2kProfile resource. 10. Click Create & Close. An icon for the new profile is displayed in the Profiles list of the Profile Manager window. Subscribing resources to profile managers Objectie To add managed resources to a monitoring profile, so you can define the resources to monitor. Background information Subscribing resources to a profile manager determines which resources receie a profile when the profile is distributed. IBM Tioli Monitoring uses the list of subscribers to determine which systems are monitored. To add a subscriber to a distributed monitoring profile, you must add the subscriber to the profile manager. Resources can also be subscribed to profiles from the IBM Tioli Monitoring Profile window. For more information, see Distributing profiles on page 16. Required authorization role admin Before you begin Create a monitoring profile with monitoring resources. For more information, see Creating profile managers and profiles. When you finish Distibute the monitoring profile to the subscribed resource. For more information, see Distributing profiles on page 16. Appendix A. Setting up IBM Tioli Monitoring 97

108 Procedure You can perform this procedure from either the command line or Tioli desktop. Command line: Run the wsub command to add subscribers to the profile manager. For example, to add an Internet Information Serer object called as a subscriber to the profile manager WebSererMonitors, Note: In the case of Tioli Monitoring for Web Infrastructure: Internet Information Serer, the subscribers are always Internet Information Serer objects. For more information about the command syntax, see the Tioli Management Framework: Reference Manual. Desktop: Perform the following steps: 1. Double-click a policy region icon to open the Policy Region window. 2. Double-click a profile manager icon to open the Profile Manager window. 3. From the Profile Manager drop-down menu, select Subscribers to display the Subscribers window. 4. From the Aailable to become Subscribers scrolling list, select the subscribers to receie the profile distribution. Note: In the case of Tioli Monitoring for Web Infrastructure: Internet Information Serer, the subscribers are Internet Information Serer objects. 5. Click the left-arrow button to moe the selected subscribers to the Current Subscribers scrolling list. 98 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

109 6. Click Set Subscriptions & Close to add the subscribers to the Subscribers box in the Profile Manager window. Adding default resource models to profiles Objectie To add a resource model to a profile using its default alues, so you can run the resource models immediately. Background information A resource model captures and returns information about a resource or application. You set up resource models and distribute them to endpoints. Each resource model monitors multiple resources. Choose the resource models to add to a profile based on the resources you want to monitor. Adding one or more of these resource models to a profile enables you to begin monitoring resources immediately. It is recommended that you put all of the resource models to be distributed to the same endpoint in a single profile, because the distribution occurs on a per-profile basis. Required authorization role admin Before you begin Create a profile manager and profile. For detailed information, refer to Creating profile managers and profiles on page 95. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 14. For detailed information about each resource model, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. When you finish Distribute the profile. See Distributing profiles on page 16. Procedure You can perform this procedure from either the command line or Tioli desktop. Command line: Run the wdmeditprf command to add a customized resource model to a profile. For more information about the command syntax, see the IBM Tioli Monitoring: User s Guide. Desktop: Perform the following steps: 1. Double-click a policy region icon to open the Policy Region window. 2. Double-click a profile manager icon to open the Profile Manager window. Appendix A. Setting up IBM Tioli Monitoring 99

110 3. From the Profiles box, double-click a profile to display the IBM Tioli Monitoring Profile window. 4. Click Add with Defaults to open the Add Default Models to Profile dialog box. 5. From the Category drop-down list, select Internet Information Serer. 6. From the Select the models to insert drop-down list, select the desired resource model. 7. Click Add & Close. The resource model is added to the Resource Model text box in the IBM Tioli Monitoring Profile window. Adding customized resource models to profiles Objectie To specify the platform, cycle time, and threshold alues that customize a resource model to meet the needs of your enironment and add the resource model to a profile. Background information A resource model captures and returns information about a resource or application. You set up resource models and distribute them to endpoints. Each resource model monitors multiple resources. Choose the resource models to add to a profile based on the resources you want to monitor. Adding one or more of these resource models to a profile enables you to begin monitoring resources immediately. It is recommended that you put all of the resource models to be distributed to the same endpoint in a single profile, because the distribution occurs on a per-profile basis. Required authorization role admin 100 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

111 Before you begin Create a profile manager and profile. For detailed information, refer to Creating profile managers and profiles on page 95. Add subscribers to a profile manager. For detailed information, see Subscribing resources to profile managers on page 14. For detailed information about each resource model, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. When you finish Distribute the profile. See Distributing profiles on page 16. Procedure You can perform this procedure from either the command line or Tioli desktop. Command line: Run the wdmeditprf command to add a customized resource model to a profile. For more information about the command syntax, see the IBM Tioli Monitoring: User s Guide. Desktop: Perform the following steps: 1. Double-click a policy region icon to open the Policy Region window. 2. Double-click a profile manager icon to open the Profile Manager window. 3. From the Profiles box, double-click a profile to display the IBM Tioli Monitoring Profile window. 4. Click Add to open the Add Resource Models to Profile dialog box. 5. From the Category drop-down list, select Internet Information Serer. 6. From the Resource Model drop-down list, select the desired resource model. 7. In the Cycle Time text box, set the frequency with which the resource model monitors the data. Enter a alue in seconds. 8. To change any of the threshold alues: a. Select the Threshold Name that you want to change. Additional Information: The description box displays a description for the threshold that you selected. A dialog box aboe the description displays the alue currently assigned to the threshold. For the default threshold alues, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. b. Change the alue currently assigned to the threshold, as appropriate. c. Click Apply to set and display the new alue for the threshold. 9. Optional: Click Indications or Parameters to modify indications and parameters, and click Schedule to add scheduling information. Additional information: If you do not perform this step, the indications and parameters use the default alues shipped with the resource models. For information, see Customizing indications on page 37, Customizing parameters on page 49, and Customizing the scheduling monitoring period on page Click Add & Close. The resource model is added to the IBM Tioli Monitoring Profile window. Rerunning a failed profile distribution Objectie To see the profile manager that contains the endpoint subscribers to which the profile distribution was not successful, so that you can rerun the distribution. Appendix A. Setting up IBM Tioli Monitoring 101

112 Background information If a profile distribution is not successful, a profile manager that contains the endpoint subscribers to which the distribution failed, is created. Required authorization role admin Before you begin Not applicable. When you finish Not applicable. Procedure You can perform this procedure from the Tioli desktop only. Desktop: Perform the following steps: 1. Double-click the policy region icon to display the Policy Region window. 2. From the View drop-down menu, select Refresh to update the Policy Region window with the new profile managers. 3. A profile distribution that was not successful, generates a profile manager that is named according to the following conention: OriginalProfileName_Push_Failed_Bad_Intepreter where OriginalProfileName is the name of the profile that you were distributing when the error occurred. The failed distribution is due to a Bad_Interpreter error. The AMW089E error message is displayed, indicating that the resource model type is not compatible with the endpoint operating system. For example, you might hae distributed a Windows resource model to a UNIX-T endpoint, or ice ersa. OriginalProfileName_Distribution_Failed where OriginalProfileName is the name of the profile that you were distributing when the error occurred. The failed distribution is due to any other error, apart from a Bad_Interpreter error. 4. Subscribe the profile managers that contain the endpoints where the distribution failed, to the profile manager that contained the original profile. Note: This can be done only if the profile manager used for the original distribution was not created in dataless mode. 5. Distribute the original profile to the failed endpoints by selecting these profile managers as the target for distribution. You can also edit the profile managers to delete an endpoint from a group of failed endpoints, before retrying the distribution. 102 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

113 Appendix B. Creating customized resource models using CIM classes This appendix briefly describes how you can use the Resource Model Wizard to create your own resource models using the Tioli Monitoring for Web Infrastructure: Internet Information Serer specific CIM classes. For more information about how to create resource models, refer to the IBM Tioli Monitoring: Workbench User s Guide. Working with IBM Tioli Monitoring Workbench IBM Tioli Monitoring Workbench is a programming tool for creating, modifying, debugging, and packaging resource models for use with IBM Tioli Monitoring products. Samples of the Best Practice Resource Models hae also been proided for you to use within the IBM Tioli Monitoring Workbench. The sample resource models are intended to be used as working examples for creating new resource models. The Tioli Maintenance and Support Contract coers assistance with problems relating to the operation of the IBM Tioli Monitoring Workbench, but does not coer assistance for new or modified resource models other than the ones that are included in the workbench. Before you begin, perform the following steps: 1. On Windows NT, install and configure Windows Management Instrumentation. (On Windows 2000, this is installed by default). Additional information: You can download Windows Management Instrumentation from 2. Install and configure IBM Tioli Monitoring Workbench. 3. Load each Tioli Monitoring for Web Infrastructure: Internet Information Serer CIM class you want to use. Additional information: Load the classes by running the mofcomp command from the Workbench/w32 ix86 directory in the Tioli Monitoring for Web Infrastructure: Internet Information Serer CD-ROM. For more information about the mofcomp command, refer to the Windows Management Instrumentation documentation. Getting started with the Resource Model Wizard The Resource Model Wizard guides you through the process of creating resource models. Perform the following steps to create a customized resource model using Tioli Monitoring for Web Infrastructure: Internet Information Serer CIM classes: 1. Open IBM Tioli Monitoring Workbench. 2. From the File drop-down menu, select New to display the New window. 3. Select Jaa Script Resource Model. 4. Click OK to display the New Resource Model Workspace window. 5. Select the Resource Model Wizard radio button. 6. Click OK. 7. Select the CIM/WMI data source type. 103

114 8. Select all of the aailable operating systems on which you want the resource model to run. 9. Click Next. 10. In the Connect to namespace field, type ROOT\CIMV2. Additional information: ROOT\CIMV2 is the namespace that stores the Tioli Monitoring for Web Infrastructure: Internet Information Serer specific CIM classes. 11. Optional: Type your password. 12. Click OK to display the Select a Class window. Additional information: The Selected Class field displays all aailable CIM classes for use in your customized resource models. All Tioli Monitoring for Web Infrastructure: Internet Information Serer CIM classes begin with IIS. 13. Select one or more CIM classes. Additional information: For a complete list of the product CIM classes and properties, refer to the Tioli Monitoring for Web Infrastructure: Reference Guide. 14. From the Class Properties group box, select the CIM class properties to monitor. 15. Click Next. 16. To complete your resource model, follow the wizard instructions. For detailed instructions, refer to the IBM Tioli Monitoring: Workbench User s Guide. 17. After completing the wizard, add the CIM classes as platform-specific dependencies to the resource models as follows: a. Open the IBM Tioli Monitoring Workbench window. b. Click the plus sign (+) to expand the tree list for the new resource model. c. Click the plus sign (+) of the Dependencies folder to expand its contents. d. Right-click on a platform-specific dependency element and select Add. The Open dialog box is displayed. e. From the scrolling list of the Look in field, select the Tioli Monitoring for Web Infrastructure: Internet Information Serer CD-ROM. f. Select the Workbench/w32-ix86 directory. g. Click Open to add the classes to the Dependencies folder. h. Repeat steps 17d to 17h until all platform-specific dependencies hae been updated with the Tioli Monitoring for Web Infrastructure: Internet Information Serer CIM classes. For instructions about how to build and deploy your new resource model, refer to the IBM Tioli Monitoring: Workbench User s Guide. Resource models created to use the Tioli Monitoring for Web Infrastructure: Internet Information Serer CIM classes, must belong to the Internet Information Serer category and need to be distributed to the IISWebSerer objects. 104 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

115 Appendix C. Tasks quick reference A task is an operation or set of operations that is performed routinely. The following table lists the Tioli Monitoring for Web Infrastructure: Internet Information Serer tasks alphabetically. For more information about these tasks, refer to the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Table 6. Tioli Monitoring for Web Infrastructure: Internet Information Serer task libraries and tasks Task library Task name Required role Target endpoint Monitoring for Internet Information Serer Tasks Start iiswebserer_admin Internet Information Serer object Stop iiswebserer_admin Internet Information Serer object Start Site iiswebserer_admin Internet Information Serer object Stop Site iiswebserer_admin Internet Information Serer object 105

116 106 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

117 Appendix D. Eent classes and rules Eent classes Rules for eents This appendix contains information about the Tioli Enterprise Console eent classes and rules that Tioli Monitoring for Web Infrastructure: Internet Information Serer proides. The following topics are discussed: Eent classes Rule for eents Tioli Monitoring for Web Infrastructure: Internet Information Serer proides a set of Tioli Enterprise Console eent classes: IIS_EV_ WebSiteDown IIS_EV_AnonymousConnectionsHigh IIS_EV_RequestPerSecHigh IIS_EV_KBytesSentPerSecHigh IIS_EV_KBytesReceiedPerSecHigh IIS_SericeFailing IIS_SericeStopped IIS_EV_ErrorsPerSecHigh IIS_EV_MemoryAllocatedHigh IIS_EV_RequestsQueuedHigh IIS_EV_RequestsQueueIncreasing IIS_EV_SlowRequestDispatch Tioli Monitoring for Web Infrastructure: Internet Information Serer supplies a set of rules that proide correlation of related eents. The itmiis_tbsm_forward.rls file contains the set of rules. This rule set uses the classes from the *.baroc files that are proided with the product. The rules and their functions are as follows: forward_itmiis_eent_to_tbsm Forwards eents to Tioli Business Systems Manager. forward_itmiis_clearing_eent_to_tbsm Forwards clearing eents to Tioli Business Systems Manager. 107

118 108 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

119 Appendix E. Problem determination Logs and traces This appendix proides information about resoling problems that might occur when you run Tioli Monitoring for Web Infrastructure: Internet Information Serer. Log and trace files are written in a readable format and stored in the following directories: $DBDIR/GWI/logs Serer and managed node files $LCF_DATDIR/LCFNEW/GWI/logs Endpoint files If the problem cannot be resoled from the log file, proide the trace files to customer support. Log and trace files can be generated in XML format. Only log files are generated in XML by default. Log files are named msgxxxx.log. Trace files are named tracexxxx.log. Tioli Monitoring for Web Infrastructure: Internet Information Serer logs and traces The following sections describe the Tioli Monitoring for Web Infrastructure: Internet Information Serer log and trace files, with their locations. Serer traces and logs Log and trace files at the Tioli management serer keep track of the actiities carried out when the Internet Information Serer registration, inoked by using the command line or GUI, is running. Here is a description of the log and trace files: Log and trace files: Log file (xml format): msgiiswebsererspd.log Trace file: traceiiswebsererspd.log Location: $DBDIR/GWI/logs You can configure trace and log file formats and leels in the sericeability.properties file located in the same directory. For more information about how to configure the files, see Log and trace configuration on page 112. Managed node traces and logs When you run a command, on the managed node where the command is executed and on the managed node where the Internet Information Serer object resides, there are log and trace files related to all the actiity performed. Here is a description of the log and trace files: Log and trace files: Log file (xml format): msgcli.log 109

120 Trace file: tracecli.log Trace file: traceiiswebserer.log This file contains the information related to all the actiity performed on the Internet Information Serer object. Location: $DBDIR/GWI/logs You can configure trace and log file formats and leels in the sericeability.properties file located in the same directory. For more information about how to configure the files, see Log and trace configuration on page 112. Endpoint traces A trace file is stored at endpoints. Trace file: traceendpoint.log Location: $LCF_DATDIR/LCFNEW/GWI/logs You can configure trace and log file formats and leels in the sericeability.properties file located in the same directory. For more information about how to configure the files, see Log and trace configuration on page 112. Resource model traces You can also check Internet Information Serer resource model trace information in the IBM Tioli Monitoring trace files located at the endpoint. The main trace log generated by the IBM Tioli Monitoring engine at endpoints, records the actiities of the endpoint engine, as follows: Trace Name: Tmw2k.log (when the log is full, the oldest 20% of messages are deleted) Location: $LCF_DATDIR/LCFNEW/Tmw2k Configuration: To configure the trace, run the command wdmtrceng from the serer or managed node by specifying the endpoint where you want to create the log. You can set any of the following parameters: Trace filename Trace leel, from 0 (minimum) to 3 (maximum) Maximum file size Each line in the log contains the following columns: Date Trace leel Component Thread ID Message Log record format The log record format is as follows: MessageID TraceLe Date1 Date2 ProductID Component Serer LogText Exception 110 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

121 where: MessageID A unique numeric message identifier. TraceLe Leel of detail the trace represents: ERROR Only error messages are traced WARN Warning and error messages are traced INFO All types of messages are traced Date1 Time when the log was produced, calculated since January 1st 1970 and specified in milliseconds. For example, Date2 Time when the log was produced, specified in GMT. It includes the date, time, and time zone. For example, Tue Oct 22 15:53: GMT. ProductID The three letter code assigned to the product that identifies its messages uniquely (for Tioli Monitoring for Web Infrastructure: Internet Information Serer, GWI). Component A run-time grouping of a product s parts. If a product has multiple applications, the component name reflects the name of the application. Serer Host name. LogText Text of the message. Exception Exception element depends upon the specific language and platform. Trace record format The trace record format is as follows: Date Time SourceFile MethodName LineNumber ProductID Component Hostname Message where: Date Date when the trace was produced. Time Time when the trace was produced. SourceFile Name of the source file to which the trace refers. MethodName Name of the method in the class to which the trace refers. LineNumber Method line number to which the trace refers. ProductID A three letter code assigned to the product that identifies its messages uniquely (for Tioli Monitoring for Web Infrastructure: Internet Information Serer, GWI). Appendix E. Problem determination 111

122 Component A run-time grouping of a product s parts. If a product has multiple applications, the component name reflects the name of the application. HostName Host name. Message Text of the message. Log and trace configuration You can set filtering leels in the sericeability.properties file, located in eery directory where log and trace files are stored. For log files, the filtering leels are ERROR, WARNING, and INFO. Informational messages Proide users with information or feedback about normal eents that hae occurred or are occurring, or request information from users in cases where the outcome will not be negatie, regardless of the response. Informational messages indicate conditions that are worthy of noting, but that do not require a user to take any precautions. Warning messages Indicate that potentially undesirable conditions hae occurred or could occur, but the program can continue. Error messages Indicate problems that require interention or correction, before the program can continue. For trace files, the leels you can set are DEBUG_MAX, DEBUG_MID, and DEBUG_MIN. In the sericeability.properties file, you can also set the output format: ccg_basicformatter Produces the default formatted output for an eent. The following context information is gien: Date and time when the eent was created Name of the file where the message was logged number of the line where the message was logged Name of the product that created the message Name of the component that created the message A serer associated with the creation of the message Text of the eent ccg_xmlformatter Produces XML formatter output. pac_consoleformatter Used to produce output to the console. Contains no context information. Sericeability tools The following sericeability tools are supported: AutoTrace AutoTrace is a process tracing software from The Kernel Group Inc. (TKG), 112 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

123 and is aailable on Solaris Operating Enironment, HP-UX, AIX and Windows operating systems. It is used to collect execution flow information at an endpoint which is stored in a configurable memory buffer. You choose when to write a snapshot of the buffer to a file, and you then send the file to Tioli customer support for analysis. The information written to the trace file consists of the input and output parameters for each process call. AutoTrace consists of two elements: At the endpoint, a trace collector enabled and controlled by you. At Tioli customer support, a trace analyzer operated by the Tioli customer support staff. For detailed information about how to install and configure AutoTrace, refer to the IBM Tioli Monitoring: User s Guide. witmcollectsupportdata The witmcollectsupportdata command is proided with the IBM Tioli Monitoring Component Serices to collect log files that are to be sent to Customer Support. This tool collects the logs from gateways and endpoints and creates an XML file containing all the data that can be iewed with a Web browser. The command syntax is as follows: witmcollectsupportdata objectid output_file.xml [IISWebSerer] Possible problems and solutions Where: objectid The object identifier of the endpoint or IISWebSerer object. output_file The name of the output file where collected data is to be stored. IISWebSerer Specify the class name IISWebSerer only if the object identifier refers to an endpoint. Notes: 1. The output XML file that is created might exceed 20 MB of disk space. It is recommended that you store the file on a file system where at least 50 MB of disk space is aailable. 2. Ensure you compressed the file, before sending it to Customer Support. Cannot create an Internet Information Serer object When you try to create an Internet Information Serer object, the message FRWOG0022E: insufficiente authorization is displayed. Solution Ensure that you hae assigned the Tioli management region role iiswebserer_super, which is required to create an the Internet Information Serer object. Verify that Internet Information Serer is installed on the specified endpoint. Appendix E. Problem determination 113

124 Cannot create an Internet Information Serer object on a managed node When you try to create an Internet Information Serer object, the message GWI12148E: You cannot create an Internet Information Serer object on managed node managed_node_label that is not part of this TMR is displayed. Solution Run the command again by specifying a managed node that exists in the Tioli management region that you are using. In an enironment with interconnected Tioli management regions, ensure that the managed node and endpoint that you specified are in the same Tioli management region. Starting an Internet Information Serer Web site is not successful If you try to start an Internet Information Serer Web Site on an endpoint, the message GWI2243E: The Internet Information Serer Web site could not be started is displayed. Solution Check that the Internet Information Serer is correctly configured. Ensure that the properties of the Internet Information Serer object you are trying to start are updated. This is needed, for example, if the number or configuration (host header name, IP address, listening port) of Web sites are changed. To update the properties of an Internet Information Serer object, see Refreshing object properties on page 62. Stopping an Internet Information Serer Web site is not successful If you try to stop an Internet Information Serer Web Site on an endpoint, the message GWI2244E: The Internet Information Serer Web site could not be stopped is displayed. Solution Check that the Internet Information Serer is correctly configured. Ensure that the properties of the Internet Information Serer object you are trying to stop are updated. This is needed, for example, if the number or configuration (host header name, IP address, listening port) of Web sites are changed. To update the properties of an Internet Information Serer object, see Refreshing object properties on page 62. Checking the status of an Internet Information Serer Web site is not successful If you try to check the status of an Internet Information Serer Web site on an endpoint, the message GWI2246E: The Internet Information Serer Web site status could not be retrieed is displayed. Solution Check that the Internet Information Serer is correctly configured. Ensure that the properties of the Internet Information Serer object whose status you are trying to check are updated. This is needed, for example, if the number or configuration (host header name, IP address, listening port) of Web sites are 114 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

125 changed. To update the properties of an Internet Information Serer object, see Refreshing object properties on page 62. Log or trace files are not written The log and trace files are not stored in the logs directory. Solution Check that the sericeability.properties file is appropriately configured. For more informaiton about how to configure the sericeability.properties file, see Log and trace configuration on page 112. According to the operating system you are using, ensure that the /GWI directory and related subdirectories are assigned the correct access control list: UNIX Read, write, and execute (777). Windows Eeryone must be gien Full Control. On Windows 2000, the check box Allow inheritable permissions from parent to propagate to this object must be cleared. Resource model fails to start but no eent is sent to Tioli Enterprise Console A resource model fails to start, but an eent is not sent to Tioli Enterprise Console. Solution Tioli Enterprise Console eents are generated only when a problem occurs or a resource is changed, during monitoring. Problems with resource models are reported in the Web Health Console. An indication has health of 100% but wdmlseng shows that the applicable resource model is failing An indication shows health of 100%, but the wdmlseng command returns a resource model in failing state. Solution IBM Tioli Monitoring determines the health of a particular indication by how often the indication is being sent. If a resource model is in any state other than running, it does not generate any indications. The indication health is therefore determined to be 100% (perfect health). Appendix E. Problem determination 115

126 116 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

127 Appendix F. Accessibility Using assistie technologies Accessibility features help users who hae physical disabilities, such as restricted mobility or limited ision, to use software products successfully. The major accessibility features in Tioli Monitoring for Web Infrastructure: Internet Information Serer enable you to: Use assistie technologies such as screen-reader software and a digital speech synthesizer to hear what is displayed on the screen Operate specific or equialent features using only the keyboard Magnify what is displayed on the screen In addition, the product documentation includes the following features to aid accessibility: All documentation is aailable in both HTML and conertible PDF formats to gie the maximum opportunity for you to apply screen-reader software. All images are proided with alternatie text so that users of the documentation with ision impairments can understand the contents of the images. Assistie technology products such as screen-readers function with both the text-based and graphical user interfaces found in Tioli Monitoring for Web Infrastructure: Internet Information Serer. Consult the assistie technology product documentation for specific information about using it to access command-line or graphical interfaces. Magnifying what is displayed on the screen In all components of Tioli Monitoring for Web Infrastructure: Internet Information Serer other than the Web Health Console, you can magnify the screens of the product user interfaces using facilities proided by the operating systems on which the product is run. For example, in a Windows enironment you can change the screen settings to a lower resolution to enlarge the font sizes of the text on the screen. Information about these facilities is proided in the releant operating system documentation. Documentation in accessible formats Using alternatie text All user documentation is proided in HTML format, which can be read directly by assistie tools such as screen readers, or in conertible PDF format. Conertible PDF files are those that can be conerted from PDF to HTML by the Adobe PDF to HTML conerter. For information about conerting PDF documents to HTML, refer to the Optimizing Adobe PDF Files for Accessibility manual. All documentation images are proided with an alternatie text that can be read by assistie tools such as screen readers. 117

128 118 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

129 Notices This information was deeloped for products and serices offered in the U.S.A. IBM may not offer the products, serices, or features discussed in this document in other countries. Consult your local IBM representatie for information on the products and serices currently aailable in your area. Any reference to an IBM product, program, or serice is not intended to state or imply that only that IBM product, program, or serice may be used. Any functionally equialent product, program, or serice that does not infringe any IBM intellectual property right may be used instead. Howeer, it is the user s responsibility to ealuate and erify the operation of any non-ibm product, program, or serice. IBM may hae patents or pending patent applications coering subject matter described in this document. The furnishing of this document does not gie you any license to these patents.you can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drie Armonk, NY U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan The following paragraph does not apply to the United Kingdom or any other country where such proisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement might not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-ibm Web sites are proided for conenience only and do not in any manner sere as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. 119

130 IBM may use or distribute any of the information you supply in any way it beliees appropriate without incurring any obligation to you. Licensees of this program who wish to hae information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/ Burnet Road Austin, TX U.S.A. Such information may be aailable, subject to appropriate terms and conditions, including in some cases payment of a fee. The licensed program described in this document and all licensed material aailable for it are proided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equialent agreement between us. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of indiiduals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on arious operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of deeloping, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples hae not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, sericeability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of deeloping, using, marketing, or distributing application programs conforming to IBM s application programming interfaces. If you are iewing this information in softcopy form, the photographs and color illustrations might not appear. 120 IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer User s Guide

131 Trademarks IBM, the IBM logo, Tioli, Tioli Enterprise, Tioli Enterprise Console, and Tioli Enterprise Data Warehouse are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. Microsoft, Windows, and Windows NT are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Jaa and all Jaa-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. Other company, product, and serice names may be trademarks or serice marks of others. Notices 121