iplanetwebserveruser sguide

Transcription

1 IBM Tioli Monitoring for Web Infrastructure iplanetwebsereruser sguide Version SH

2

3 IBM Tioli Monitoring for Web Infrastructure iplanetwebsereruser sguide Version SH

4 Note Before using this information and the product it supports, be sure to read the general information under Notices on page 115. 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: iplanet Web Serer (program number 5724-C01) 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: iplanet Web 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: iplanet Web Serer Setting authorization roles Configuring endpoints Creating Tioli Monitoring for Web Infrastructure: iplanet Web Serer objects Distributing profiles Chapter 3. Setting up the Tioli Enterprise Console 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.. 29 Prerequisites Configuring the Tioli Enterprise Console to forward eents to Tioli Business Systems Manager. 30 Installing Tioli Monitoring for Web Infrastructure: iplanet Web Serer integration Discoering resources for Tioli Business Systems Manager Working with Tioli Business Systems Manager.. 36 Uninstalling Tioli Monitoring for Web Infrastructure: iplanet Web Serer integration from Tioli Business Systems Manager Chapter 5. Working with IBM Tioli Monitoring Customizing thresholds and eents 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.. 50 Customizing data logging information Managing profiles and resource models at endpoints 54 Managing IBM Tioli monitoring gateways Determining which resource models hae been distributed to endpoints Chapter 6. Working with Tioli Monitoring for Web Infrastructure: iplanet Web Serer objects Showing object properties Refreshing object properties Checking the status of a Web serer Starting, stopping, or restarting a Web serer Starting or stopping a irtual serer Checking the status of a irtual serer Chapter 7. Working with tasks and jobs 65 Running a task Creating a job Running a job Scheduling a job Chapter 8. Enabling Tioli Monitoring for Web Infrastructure: iplanet Web 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 83 Running reports Scheduling reports to run automatically Modifying default settings for reports Creating reports Creating a Many Measurements Versus Time report 87 Appendix A. Setting up IBM Tioli Monitoring Creating profile managers and profiles Subscribing resources to profile managers Adding default resource models to profiles iii

6 Adding customized resource models to profiles.. 94 Rerunning a failed profile distribution Appendix B. Creating customized resource models using CIM classes.. 97 Working with IBM Tioli Monitoring Workbench.. 97 Getting started with the Resource Model Wizard.. 97 Appendix C. Tasks Quick Reference.. 99 Appendix D. Eent classes and rules 101 Eent classes Rules for eents 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 Appendix E. Problem Determination 103 i IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

7 About this guide Who should read this guide Publications IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer allows you to monitor the aailability and performance of your iplanet Web serer instances and irtual serers to identify bottlenecks and potential problems. Note: iplanet Web serer, Enterprise Edition is now known as Sun ONE Web Serer. This guide is for iplanet Web serer administrators. Readers should be familiar with the following: Installing and managing the Tioli Management Framework and the Tioli Management Enironment Monitoring the system 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 Tioli Monitoring for Web Infrastructure: iplanet Web Serer 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: iplanet Web Serer library The Tioli Monitoring for Web Infrastructure: iplanet Web Serer library contains the following publications: IBM Tioli Monitoring for Web Infrastructure: Installation and Setup Guide, GC Describes the procedures to install and uninstall IBM Tioli Monitoring for Web Infrastructure: products. IBM Tioli Monitoring for Web Infrastructure: Reference Guide, GC Describes resource models, commands, and tasks for IBM Tioli Monitoring for Web Infrastructure: products. Roadmap for a Typical Installation of IBM Tioli Monitoring for Web Infrastructure, GI Describes a typical installation of IBM Tioli Monitoring for Web Infrastructure. IBM Tioli Monitoring for Web Infrastructure: Release Notes, GI Proides the most current information about IBM Tioli Monitoring for Web Infrastructure: products.

8 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide, SH Describes how to use IBM Tioli Monitoring for Web Infrastructure: with iplanet Web Serer. IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer Workaround and Limitations Supplement, SH Describes known product limitations and problems related to the iplanet Web Serer component, their fixes and workarounds. 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 be able to use the information in this guide effectiely, you must hae some prerequisite knowledge, 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 i IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

9 Describes how to install and configure Tioli Business Systems Manager. 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 (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, send an to pubs@tioli.com or complete the customer feedback surey at the following Web site: Accessibility features help a 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, see Appendix F, Accessibility on page 113. 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 (except for titles of windows and dialogs) 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. Names of files and directories, 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 Variables 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: iplanet Web Serer User s Guide

11 Chapter 1. Oeriew of IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer (hereinafter also referred to as product) proides a centralized system management tool for iplanet Web serers on the Tioli platform. The product facilitates the management of iplanet Web serer instances and associated irtual serers on Tioli Management Framework endpoints. The product proides the ability to register a set of iplanet Web serers, to collect their configurations in order to manage them. Once you hae registered your resources, you can use the Tioli Monitoring for Web Infrastructure: iplanet Web Serer resource models and management functions to: Start, stop, restart, and retriee the status of your iplanet Web serers. Start, stop, and retriee the status of your irtual serers. Monitor key performance and aailability of iplanet Web serers and irtual serers. Forward Tioli Monitoring for Web Infrastructure: iplanet Web 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. The remainder of this document treats 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: iplanet Web Serer eents to Tioli Business Systems Manager.. Note: To send eents to Tioli Business Systems Manager, Tioli Enterprise Console must be installed and configured accordingly. Store historical data on Tioli Enterprise Data Warehouse. To ensure that you are managing all Tioli Monitoring for Web Infrastructure: iplanet Web Serer resources aailable, the product proides a discoery function that finds all the different iplanet Web serer instances running on a specific host and all the irtual serers hosted by each iplanet Web serer instance. As the discoery function finds new Tioli Monitoring for Web Infrastructure: iplanet Web Serer resources, they are added to your Tioli configuration. Refer to the following sections to learn how Tioli Monitoring for Web Infrastructure: iplanet Web Serer proides: Aailability management Performance management Operations management 1

12 Aailability management Performance management Operations management Tioli Monitoring for Web Infrastructure: iplanet Web Serer proides resource models, or groups of monitors, that periodically check the status of your iplanet Web serer components; iplanet Web serers and the irtual serers hosted by them. The status can be either actie (operational) or inactie (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 iplanet Web serer and of the irtual serers hosted, to identify bottlenecks and potential problems in your Web infrastructure. For example, you can measure: Traffic Access Load on the system Error conditions Tioli Monitoring for Web Infrastructure: iplanet Web Serer enables you to manage your iplanet Web serer resources on a scheduled basis. You can: Start, stop, and restart your iplanet Web serers Start, stop, and restart your iplanet irtual serers Check the status and retriee information about your iplanet Web serer instances and irtual serers 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 2 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

13 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. 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: iplanet Web 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 Chapter 1. Oeriew of IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer 3

14 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 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. 4 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

15 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 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: iplanet Web Serer 5

16 Table 1. Counting occurrences (continued) Sequence Count of Occurrences 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 6 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

17 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. 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 Chapter 1. Oeriew of IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer 7

18 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 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 8 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

19 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. 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: iplanet Web 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: Chapter 1. Oeriew of IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer 9

20 Authorization roles 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, 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. Tioli Monitoring for Web Infrastructure: iplanet Web Serer fully integrates into Tioli security. To perform administration functions, administrators must hae authorization roles for both Tioli Monitoring for Web Infrastructure: iplanet Web Serer and the Tioli management enironment. Tioli Monitoring for Web Infrastructure: iplanet Web Serer authorization roles are hierarchical in that an administrator with iplanetwebserer_super authorization automatically also has iplanetwebserer_admin and iplanetwebserer_user authorization. Tioli Monitoring for Web Infrastructure: iplanet Web Serer includes the following authorization roles: iplanetwebserer_super Enables the administrator to create or delete the configuration of an iplanet Web serer object. iplanetwebserer_admin Enables the administrator to start, stop, and restart an iplanet Web serer instance. This role is also required to refresh object properties. iplanetwebserer_user Enables the administrator to iew information about and get the status of any iplanet Web serer instance and Web sites. 10 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

21 Note: An administrator with iplanetwebserer_super authority can perform all these actions, while one with iplanetwebserer_admin authority can also perform the iplanetwebserer_user actions. Managed resources and endpoints User interface options 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 for distribution of a profile or the resource on which a task or job is to be run. In Tioli Monitoring for Web Infrastructure: iplanet Web Serer, an endpoint is an iplanet Web serer object. To manage iplanet Web serer resources, the Tioli endpoint must be installed on each iplanet Web serer node. You can use the following user interfaces when working with Tioli Monitoring for Web Infrastructure: iplanet Web Serer: 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: iplanet Web Serer 11

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

23 Chapter 2. Setting up Tioli Monitoring for Web Infrastructure: iplanet Web Serer Setting authorization roles This chapter describes how to configure Tioli Monitoring for Web Infrastructure: iplanet Web 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 Tioli Monitoring for Web Infrastructure: iplanet Web Serer objects for your iplanet Web serer components, as described in Creating Tioli Monitoring for Web Infrastructure: iplanet Web Serer objects on page Configure the endpoints, as explained in Configuring endpoints on page Distribute profiles, as described in Distributing profiles on page 18. 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 on page 23, and Chapter 4, Integrating with Tioli Business Systems Manager on page 29. Objectie To assign the Tioli Monitoring for Web Infrastructure: iplanet Web Serer authorization roles to perform operations. Background information When you install Tioli Monitoring for Web Infrastructure: iplanet Web Serer, the following three hierarchical roles are created: iplanetwebserer_super iplanetwebserer_admin iplanetwebserer_user To perform operations on Tioli Monitoring for Web Infrastructure: iplanet Web 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: iplanet Web 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: iplanet Web Serer. See the IBM Tioli Monitoring for Web Infrastructure: Installation Guide for information on installation. When you finish Not applicable. 13

24 Procedure You can perform this procedure from either the command line or the Tioli desktop. Command line: Run the wsetadmin command to set or change resource authorization roles. See the Tioli Management Framework: Reference Manual for more information. Desktop: From the Tioli desktop, perform the following steps: 1. Double-click the Administrators icon to display the Administrators dialog box showing the defined Tioli administrators. 2. Right-click the administrator whose role you want to modify. 3. Select Edit TMR Roles to open the Set TMR Roles dialog box. 4. Add or remoe roles for the selected resources, as follows: To add roles for the selected resources, select one or more roles from those shown in the Aailable Roles scrolling list and click the left-arrow button. The selected roles are moed from the Aailable Roles scrolling list to the Current Roles scrolling list. To remoe roles for the selected resources, select one or more roles from those shown in the Current Roles scrolling list and click the right-arrow button. The selected roles are moed from the Current Roles scrolling list to the Aailable Roles scrolling list. Note: The list of roles might include others not mentioned here, depending on the particular applications installed. You must click Change & Close or Change to add and remoe the selected roles; the selected roles are only temporarily moed to the Current Roles or Aailable Roles scrolling lists. 5. If you are adding more than one role, click Change to add or remoe the selected resource roles for the administrator as specified. The Set TMR Roles dialog box remains displayed. 6. Click Change & Close to add or remoe the selected resource roles for the administrator and return to the Administrators window. The administrator must restart the desktop for the changes to take effect. 14 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

25 Configuring endpoints Before you can create or monitor resources, you must configure the endpoints to work with Tioli Monitoring for Web Infrastructure: iplanet Web Serer. You only need to configure a node once. Configuring nodes includes the following steps: Installing and linking to a Jaa Runtime Enironment Objectie To make aailable to Tioli Monitoring for Web Infrastructure: iplanet Web Serer, Jaa Runtime EnironmentVersion 1.3, or later. Background information Tioli Monitoring for Web Infrastructure: iplanet Web Serer requires on your endpoints a Jaa Runtime Enironment, Version 1.3 or later. Note: iplanet Web serer ships with Jaa Runtime Enironment Version 1.2.2, that cannot be used to run Tioli Monitoring for Web Infrastructure: iplanet Web Serer. Required authorization role senior, super, or admin Before you begin Not applicable. When you finish Not applicable. Procedure Command line: If you do not hae a Jaa Runtime Enironment currently installed on the endpoint, you can install one from the IBM Tioli Monitoring product CD either manually, by running the wdmdistrib J command, or through the use of Tioli Software Installation Serice (SIS). For information about installing the Jaa Runtime Enironment, see the IBM Tioli Monitoring: User s Guide. Note: With this procedure, a link to the Jaa Runtime Enironment is automatically created. Desktop: Perform the following steps only if you hae to link your endpoint to an existing Jaa Runtime Enironment: 1. From the Tioli desktop, click Desktop TMR Connections Top Leel Policy Regions. 2. Double-click the TioliDefaultTmw2kRegion icon. 3. Double-click the Tioli Monitoring Tasks icon. 4. Double-click the DMLinkJre task. The Execute Task window is displayed. 5. Select the endpoint or endpoints on which you want to link the JRE and click Execute. Note: Ensure that the path where the JRE is physically installed is the same on all selected endpoints. 6. In the DMLinkJre window, type the complete path to where the JRE is installed (not including the \bin directory) and click Set & Execute. Here are examples of the path: Chapter 2. Setting up Tioli Monitoring for Web Infrastructure: iplanet Web Serer 15

26 UNIX: Windows: /opt/jre C:\jre1.3 Configuring iplanet Web serer for Monitoring Objectie To monitor the performance and status of iplanet Web serers and their associated irtual serers. Background information Tioli Monitoring for Web Infrastructure: iplanet Web Serer uses SNMP to monitor iplanet Web serers and their associated irtual serers. Required authorization role Not applicable. Before you begin Not applicable. When you finish Not applicable. Procedure You must configure iplanet SNMP to be able to monitor your iplanet Web serers and irtual serers. SNMP is a protocol used to exchange data about network actiity. When you use SNMP with an iplanet Web serer, this information is transferred using two types of agent, the subagent and the master agent. The subagent gathers information about the iplanet Web serer and passes it to the iplanet Web serer s master agent. Eery iplanet Web serer, except for the Administration Serer, has a subagent. The iplanet Web serer stores ariables pertaining to network management. Variable that the master agent can access are called managed objects. These objects are defined in a tree-like structure called the management information base (MIB). The MIB proides access to the iplanet Web serers network configuration, and you can iew this information using SNMP. You can configure the SNMP agent to use a port or community different from the defaults. See the iplanet Web Serer, Enterprise Edition Administrator s Guide for more detailed information. Creating Tioli Monitoring for Web Infrastructure: iplanet Web Serer objects Objectie To create Tioli Monitoring for Web Infrastructure: iplanet Web Serer objects that represent your iplanet Web serer resources. Background information Before you can manage your iplanet Web serer resources you must first register them in your Tioli enironment by creating specific iplanet Web serer objects in a policy region.when you install Tioli Monitoring for Web Infrastructure: iplanet Web Serer, a policy region named Monitoring for iplanet Web serer is automatically created for you to operate. To create iplanet Web serer objects in a different policy region, you must first add the iplanetwebserer managed resource to the required policy region. 16 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

27 Required authorization role iplanetwebserer_super Before you begin Any systems that you want to manage with Tioli Monitoring for Web Infrastructure: iplanet Web Serer must hae iplanet Web serer ersion 6.0 sp2 installed and must be configured as Tioli endpoints. See the Tioli Management Framework: Reference Manual for information about configuring Tioli endpoints. Before creating the product objects, you must hae configured your endpoints, as described in Configuring endpoints on page 15, and set authorization roles. When you finish The iplanet Web serer objects that you created are added to the Policy Region window. An object is created for each instance running at the specified endpoint and for the administration serer. Procedure You can perform this procedure from either the command line or the Tioli desktop. Command line: Run the wiplanetws command with the c parameter to create objects. See the IBM Tioli Monitoring for Web Infrastructure: Reference Guide for more information about the command syntax. Note: From the command line, you can create iplanet Web serer objects only in the Monitoring for iplanet Web serer policy region. Desktop: Perform the following steps: 1. Double-click the Monitoring for iplanet Web Serer policy region icon to display the Policy Region window. Chapter 2. Setting up Tioli Monitoring for Web Infrastructure: iplanet Web Serer 17

28 2. From the Create menu, select IPlanetWebSerer to display the Create iplanet Web serer Objects 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 from the list. Note: You can only specify managed nodes belonging to the current Tioli management region, not to interconnected Tioli management regions. This limitation applies only to the graphical interface 4. Enter the label of the Endpoint where the iplanet Web serer is located, or click Endpoints to select one from the list. Note: You can only specify endpoints belonging to the current Tioli management region, not to interconnected Tioli management regions. This limitation applies only to the graphical interface 5. Enter the iplanet Web Serer installation directory, for example, /usr/iplanet/serers. 6. Modify the iplanet SNMP agent port if different from the default (161). 7. Modify the iplanet SNMP community if different from the default (public). 8. To create other iplanet Web serer objects on a different endpoint select Create and repeat the aboe steps; otherwise select Create & Close. A dialog box with a message informing you that the objects were created on the managed node that you specified is displayed. 9. Click OK. The iplanet Web serer object icons are added to the Policy Region window, with the name in the format IPlanetWebSerern@endpoint_label. Objectie To distribute profiles to specified subscribers. 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 18 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

29 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. See Creating profile managers and profiles on page 12 for information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 14 for information. Add a resource model to a profile. See Adding a resource model to a profile on page 15 for information. See the IBM Tioli Monitoring for Web Infrastructure: Reference Guide for detailed information about each resource model. When you finish Not applicable. Procedure You can perform this procedure from the command line or the Tioli desktop. Command line: Use 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. Refer to the IBM Tioli Monitoring: User s Guide for more information about the wdmdistrib command. Desktop: Perform the following steps: 1. Double-click a policy region icon to display the Policy Region window. 2. Double-click a profile manager icon to display the Profile Manager window. 3. Double-click the profile to display the IBM Tioli Monitoring Profile Properties window. Chapter 2. Setting up Tioli Monitoring for Web Infrastructure: iplanet Web Serer 19

30 4. From the Profile drop-down menu, select Distribute to display the Distribute Profile window. 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. 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. 20 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

31 Note: In the case of Tioli Monitoring for Web Infrastructure: iplanet Web Serer, the subscribers are iplanet Web serer objects. iplanet Administrator serer objects cannot be subscribed to profile managers. 8. Click one of the following: Distribute & Close Distributes the profile immediately, closes the Distribute Profile window, 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 window 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 45. 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 Tioli Monitoring for Web Infrastructure: iplanet Web Serer 21

32 22 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

33 Chapter 3. Setting up the Tioli Enterprise Console This chapter proides an introduction to the Tioli Enterprise Console and describes how to configure the Tioli Enterprise Console eent serer. 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. 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. 23

34 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 iplanet Web 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: iplanet Web 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: iplanet Web Serer includes a set of eent classes and rules specific to iplanet Web 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 25. 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 30. To configure the Tioli Enterprise Console serer for receiing eents, 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: iplanet Web Serer on the Tioli management region where the Tioli Enterprise Console serer resides. 24 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

35 3. If Tioli Monitoring for Web Infrastructure: iplanet Web Serer is not installed on the managed node where the Tioli Enterprise Console serer resides, manually copy the *.baroc, *.rls, *.sh files from the following path on the Tioli management region serer: $BINDIR/../generic_unix/TME/IPlanet/tec to the following path on the managed node where the Tioli Enterprise Console serer resides: $BINDIR/../generic_unix/TME/Iplanet/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 itmiplanet_tec_config.sh script that is proided as is with Tioli Monitoring for Web Infrastructure: iplanet Web 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/IPlanet/tec/iPlanet_SererAailability.baroc rule_base wrb -imprbclass $BINDIR/../generic_unix/TME/IPlanet/tec/iPlanet_SererLoad.baroc $rule_base wrb -imprbclass $BINDIR/../generic_unix/TME/IPlanet/tec/iPlanet_SererPerformance.baroc rule_base wrb -imprbclass $BINDIR/../generic_unix/TME/IPlanet/tec/iPlanet_VirtualSererAailability.baroc rule_base wrb -imprbclass $BINDIR/../generic_unix/TME/IPlanet/tec/iPlanet_VirtualSererPerformance.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: iplanet Web Serer eent classes. 3. 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. 4. Load the rule base by issuing the following command: wloadrb rule_base Chapter 3. Setting up the Tioli Enterprise Console 25

36 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 itmiplanet_tec_config.sh script that is proided as is with the product. Perform the following steps: 1. Open a bash shell and switch to $BINDIR/../generic_unix/TME/IPlanet/tec directory. 2. Depending on the operation you want to perform, enter one of the following commands: To create a new rule base: itmiplanet_tec_config_etsr.sh CREATE "" new_rule_base path rule_base_actiation Where: new_rule_base The name of the new rule base you want to create. If you specify, the default alue ITMIPLANET 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: itmiplanet_tec_config_etsr.sh CLONE 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 ITMIPLANET 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: 26 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

37 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: itmiplanet_tec_config_etsr.sh UPDATE rule_base "" rule_base_actiation Where: rule_base The name of the existing rule base you want to update or clone. 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 27

38 28 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

39 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: iplanet Web Serer resources and eents. Integrating Tioli Monitoring for Web Infrastructure: iplanet Web Serer with Tioli Business Systems Manager includes the following steps: 1. Configure the Tioli Enterprise Console eent serer to forward iplanet Web serer eents to Tioli Business Systems Manager (see Configuring the Tioli Enterprise Console to forward eents to Tioli Business Systems Manager on page 30). 2. Install the Tioli Monitoring for Web Infrastructure: iplanet Web Serer integration on the Tioli Business Systems Manager serer (see Installing Tioli Monitoring for Web Infrastructure: iplanet Web Serer integration on page 34). 3. Define the specific iplanet Web serer objects to Tioli Business Systems Manager using a discoery script (see Discoering resources for Tioli Business Systems Manager on page 35). This chapter also proides a list of the Tioli Monitoring for Web Infrastructure: iplanet Web Serer tasks that you can run from Tioli Business Systems Manager, and information about uninstalling the Tioli Monitoring for Web Infrastructure: iplanet Web 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 29

40 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: iplanet Web 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. 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 iplanet Web 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: iplanet Web Serer eent classes 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 Before you begin To configure the Tioli Enterprise Console serer for forwarding iplanet Web serer eents to Tioli Business Systems Manager, you must: 30 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

41 1. Install IBM Tioli Monitoring on the Tioli management region where the Tioli Enterprise Console serer resides. 2. Install Tioli Monitoring for Web Infrastructure: iplanet Web Serer on the Tioli management region where the Tioli Enterprise Console serer resides. 3. If Tioli Monitoring for Web Infrastructure: iplanet Web 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/IPlanet/tec to the following path on the managed node where the Tioli Enterprise Console serer resides: $BINDIR/../generic_unix/TME/IPlanet/tec When you finish You can now forward iplanet Web serer eents to Tioli Business Systems Manager. Procedure You can perform this procedure either manually, or running the itmiplanet_tbsm_config.sh script that is proided as is with Tioli Monitoring for Web Infrastructure: iplanet Web 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/IPlanet/tec/iPlanet_SererAailability.baroc rule_base wrb -imprbclass $BINDIR/../generic_unix/TME/IPlanet/tec/iPlanet_SererLoad.baroc rule_base wrb -imprbclass $BINDIR/../generic_unix/TME/IPlanet/tec/iPlanet_SererPerformance.baroc rule_base wrb -imprbclass $BINDIR/../generic_unix/TME/IPlanet/tec/iPlanet_VirtualSererAailability.baroc rule_base wrb -imprbclass $BINDIR/../generic_unix/TME/IPlanet/tec/iPlanet_VirtualSererPerformance.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: iplanet Web Serer eent classes. 3. Import the product rule set by issuing the following command: wrb -imprbrule $BINDIR/../generic_unix/TME/IPlanet/tec/itmiplanet_tbsm_forward.rls rule_base Chapter 4. Integrating with Tioli Business Systems Manager 31

42 where rule_base is the name of the rule base to which you hae added the IBM Tioli Monitoring for Web Infrastructure: Internet Information Serer eent classes. 4. To import the new rule set into the EentSerer target of the rule base you are configuring: wrb imptgtrule itmiplanet_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 itmiplanet_tbsm_forward.sh file from the following path: $BINDIR/../generic_unix/TME/IPlanet/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 eent serer manually, you can run the itmiplanet_tec_config.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 $BINDIR/../generic_unix/TME/IPlanet/tec directory. 2. Depending on the operation you want to perform, enter one of the following commands: To create a new rule base: itmiplanet_tec_config_etsr.sh CREATE "" new_rule_base path rule_base_actiation Where: 32 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

43 new_rule_base The name of the new rule base you want to create. If you specify, the default alue ITMIPLANET 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: itmiplanet_tec_config_etsr.sh CLONE 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 ITMIPLANET 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: itmiplanet_tec_config_etsr.sh UPDATE rule_base "" rule_base_actiation Where: rule_base The name of the existing rule base you want to update or clone. rule_base_actiation Specify one of the following: The rule base is not loaded and the Tioli Enterprise Console serer is not restarted. Chapter 4. Integrating with Tioli Business Systems Manager 33

44 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: iplanet Web Serer integration Objectie To integrate Tioli Monitoring for Web Infrastructure: iplanet Web Serer with Tioli Business Systems Manager to enable the Tioli Business Systems Manager serer to receie Tioli Monitoring for Web Infrastructure: iplanet Web Serer eents and to run tasks against iplanet Web serer objects. Background information To enable Tioli Business Systems Manager to manage Tioli Monitoring for Web Infrastructure: iplanet Web Serer eents, you must run the Tioli Monitoring for Web Infrastructure: iplanet Web Serer integration program on the Tioli Business Systems Manager serer. This integration program performs the following operations: Defines the iplanet Web serer object types in Tioli Business Systems Manager Adds Tioli Monitoring for Web Infrastructure: iplanet Web Serer tasks to the object types in Tioli Business Systems Manager Defines a line of business for iplanet Web 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, see the Tioli Business Systems Manager: Installation and Configuration Guide. When you finish After running the itmiplanet_tbsm_init.sh script, you must recycle all Tioli Business Systems Manager application and database serers, before discoering the resource instances or running resource models. Define your iplanet Web serer objects to Tioli Business Systems Manager with the itmiplanet_tbsm_discoery.sh script, as described in Discoering resources for Tioli Business Systems Manager on page 35. Procedure You can perform this procedure from the command line or using an InstallShield Multi-platform (ISMP) front-end. Command line: To install the Tioli Monitoring for Web Infrastructure: iplanet Web Serer integration, perform the following steps : 1. On the Tioli Business Systems Manager serer, insert the iplanet Web serer CD in the CD-ROM drie and, from a command prompt, switch to the \TBSM directory. 34 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

45 2. Run the itmiplanet_tbsm_init.sh script, as follows: sh itmiplanet_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 itmiplanet_tbsm_init.sh. Discoering resources for Tioli Business Systems Manager Objectie To define the specific iplanet Web serer objects to Tioli Business Systems Manager. Background information The Tioli Monitoring for Web Infrastructure: iplanet Web Serer integration defines 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 itmiplanet_tbsm_discoery.sh script. The itmiplanet_tbsm_discoery.sh script performs the following operations: Searches the Tioli database for iplanet Web 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 located in $DBDIR on the managed node where the Tioli Enterprise Console serer resides and is called iplanetwebserer_discovered_to_tbsm.file. The uninstallation of Tioli Monitoring for Web Infrastructure: iplanet Web Serer does not remoe this file, so it must be deleted manually to allow subsequent installations of Tioli Monitoring for Web Infrastructure: iplanet Web Serer to work correctly. Required authorization role iplanetwebserer_user Chapter 4. Integrating with Tioli Business Systems Manager 35

46 Before you begin Configure your Tioli Enterprise Console eent serer, as described in Configuring the Tioli Enterprise Console eent serer on page 24. Tioli Business Systems Manager Eent Enablement must be installed on the Tioli Enterprise Console serer and correctly connected to Tioli Business Systems Manager. See the Tioli Business Systems Manager: Installation and Configuration Guide for details. When you finish Use Tioli Business Systems Manager to iew and manage your iplanet Web 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: iplanet Web Serer tasks that you can run from Tioli Business Systems Manager, see Working with Tioli Business Systems Manager on page 36. Procedure You can perform this procedure from the command line only. Command line: 1. Open a bash shell and switch to the $BINDIR/../generic_unix/TME/iPlanet/tec directory. 2. Run the script:./itmiplanet_tbsm_discoery 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: iplanet Web Serer tasks are loaded into Tioli Business Systems Manager when you install the Tioli Monitoring for Web Infrastructure: iplanet Web 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. In order to run tasks from Tioli Business Systems Manager on to an iplanet Web serer resource instance, that resource must reside in the same Tioli 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 iplanet Web serer object and endpoint. You can perform the following web serer tasks from Tioli Business Systems Manager: Start Web Serer Stop Web Serer Start Virtual Serer Stop Virtual Serer 36 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

47 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, see the Tioli Monitoring for Web Infrastructure: Reference Guide. Uninstalling Tioli Monitoring for Web Infrastructure: iplanet Web Serer integration from Tioli Business Systems Manager Objectie To remoe the Tioli Monitoring for Web Infrastructure: iplanet Web Serer integration from Tioli Business Systems Manager. Background information Uninstalling the Tioli Monitoring for Web Infrastructure: iplanet Web Serer integration remoes the iplanet Web serer objects and object definitions from Tioli Business Systems Manager. To unistall Tioli Business Systems Manager, run the itmiplanet_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 itmiplanet_tbsm_uninstall.sh script, you must recycle all Tioli Business Systems Manager application and database serers, before discoering the resource instances or running resource models. Procedure You can perform this procedure from the command line or using an InstallShield Multi-platform (ISMP) front-end. Command line: To uninstall the Tioli Monitoring for Web Infrastructure: iplanet Web Serer integration, perform the following steps: 1. On the Tioli Business Systems Manager database serer, insert the Tioli Monitoring for Web Infrastructure: iplanet Web Serer CD-ROM in the CD-ROM drie and, from a command prompt, switch to the \TBSM\uninstall directory. 2. Run the itmiplanet_tbsm_uninstall.sh script, as follows: itmiplanet_tbsm_uninstall.sh S SQL_sererhostname 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 37

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

49 Chapter 5. Working with IBM Tioli Monitoring This chapter proides information about using the resource models included in Tioli Monitoring for Web Infrastructure: iplanet Web 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. Customizing thresholds and eents 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 satisfied during the monitoring cycle. Each resource model has prefedined thresholds that meet the business needs of must customers; howeer, you may hae specific requirements for which these 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. See Creating profile managers and profiles on page 89 for more information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 91 for more information. Add a resource model to a profile. See Adding default resource models to profiles on page 93 and Adding customized resource models to profiles on page 94 for more information. See the IBM Tioli Monitoring for Web Infrastructure Reference Guide for detailed information abour each resource model. When you finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 18. Optional: continue customizing the resource model as described in the other sections in this chapter. Procedure You can perform this procedure from the command line or the Tioli desktop. Command line Run the wdmeditprf command to customize a resource model for a profile. 39

50 Desktop 1. Open the IBM Tioli Monitoring Profile dialog box by doing the following: a. Open the Tioli desktop. b. Double-click the policy region icon to display the policy region. c. Double-click the profile manager icon to display the profile manager. d. Double-click the profile icon to which you want to customize a resource model. 2. Select the resource model that you want to customize from the IBM Tioli Monitoring Profile dialog box. 3. Click Edit. The Edit Resource Model dialog box opens. 4. Click Indications. The Indications and Actions dialog box opens and displays the indications appropriate to the selected resource model. 5. Select the indication of which you want to customize the alues of the eent associated with that indication. 6. Apply the changes to the alues that are appropriate to your requirements. See the IBM Tioli Monitoring for Web Infrastructure: Reference Guide for the default resource model settings. The following describes the alues that you can customize: Number of Occurrences Specifies 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 Determines how many cycles that do not produce an indication can occur between cycles that do 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)) where: TW CT Oc H Specifies the time window calculated Specifies the cycle time Specifies the number of occurrences Specifies the number of holes 40 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

51 Send TEC Eents Select this check box to specify that if an eent occurs, the specified eent serer receies a message from. Send to TBSM Sends eents to Tioli Business Systems Manager. If you hae Tioli Business Systems Manager installed and configured, Tioli Enterprise Console automatically forwards eents to Tioli Business Systems Manager. You do not need to select this box. 7. Click Apply Changes & Close to sae your changes to the indication. Adding or remoing built-in action Objectie 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 in the IBM Tioli Monitoring Workbench. See the IBM Tioli Monitoring documentation for more information. Required authorization role admin Before your begin You must hae preiously remoed a built-in action to actiate the Built-In button for adding a built-in action. Use this procedure to reinstate the preiously remoed built-in action. Create a profile manager and profile. See Creating profile managers and profiles on page 89 for more information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 91 for more information. Add a resource model to a profile. See Adding default resource models to profiles on page 93 and Adding customized resource models to profiles on page 94 for more information. See the IBM Tioli Monitoring for Web Infrastructure Reference Guide for detailed information abour each resource model. When You Finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 18. Chapter 5. Working with IBM Tioli Monitoring 41

52 Optional: Continue customizing the resource model: Specify if you want a recoery action when a specific eent occurs. See Editing a built-in action on page 43 Specify if you want correctie or reporting tasks for an eent. See Specifying tasks for an eent on page 45 Specify if you want to receie information on a specific eent through a notice. See Sending a notice to administrators when an eent occurs on page 46 Specify if you want to customize your parameters to optimize the monitoring process. See Customizing parameters on page 47 Specify if you want the monitoring of resource models to take place on specific time periods of selected days. See Creating scheduling rules on page 48 Determine when the monitoring of resource models takes place. See Customizing the scheduling monitoring period on page 50 Specify if you want the log data collected by a resource model written to a local database. See Customizing data logging information on page 52. Procedure You can perform this procedure from the command line or the Tioli desktop. Command Line: Run the wdmeditprf command to customize a resource model for a profile. Desktop: 1. Open the IBM Tioli Monitoring Profile dialog box by doing the following: a. Open the Tioli desktop. b. Double-click the policy region icon to display the policy region. c. Double-click the profile manager icon to display the profile manager. d. Double-click the profile icon in which you want to customize a resource model. 2. Select a resource model from the IBM Tioli Monitoring Profile dialog box. 3. Click Edit to open the Edit Resource Model dialog box. 4. Click Indications. The Indications and Actions dialog box opens and displays the indications appropriate to the selected resource model. 5. Select the indication that has the associated eents you want to add or remoe. 6. Select the action from the Action List panel of the Indications and Actionsdialog box. 7. Click Remoe to remoe the action from the list OR Click Built-in to open the Add Action dialog box. a. Select the action you want to run when an eent occurs. b. Enter the number of times you want the action to perform when an indication generates an eent in the Retry field. Additional information:if you set the Retry field to zero, the product continually tries to perform the action until the action is successful. What are the ramifications of running these action until they are successful? c. Click one of the following buttons: Add Adds the selected action with the alues specified and keeps the Add Action dialog box open. 42 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

53 Editing a built-in action Add & Close Adds the selected action and closes the Add Action dialog box. 8. Click one of the following buttons: Apply Changes Saes the changes made to the built-in actions and leaes the Indications and Actions dialog box open. Apply Changes and Close Closes the Indications and Actions dialog box and saes the changes made to the built-in actions. Objectie Specifies the number of times the software attempts to execute the built-in action when an eent is generated. 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 in the IBM Tioli Monitoring Workbench. See the IBM Tioli Monitoring documentation for more information. Required authorization role admin Before your begin Create a profile manager and profile. See Creating profile managers and profiles on page 89 for more information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 91 for more information. Add a resource model to a profile. See Adding default resource models to profiles on page 93 and Adding customized resource models to profiles on page 94 for more information. See the IBM Tioli Monitoring for Web Infrastructure Reference Guide for detailed information abour each resource model. When You Finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 18. Optional: Continue customizing the resource model: Specify if you want a recoery action when a specific eent occurs. See Editing a built-in action Chapter 5. Working with IBM Tioli Monitoring 43

54 Specify if you want correctie or reporting tasks for an eent. See Specifying tasks for an eent on page 45 Specify if you want to receie information on a specific eent through a notice. See Sending a notice to administrators when an eent occurs on page 46 Specify if you want to customize your parameters to optimize the monitoring process. See Customizing parameters on page 47 Specify if you want the monitoring of resource models to take place on specific time periods of selected days. See Creating scheduling rules on page 48 Determine when the monitoring of resource models takes place. See Customizing the scheduling monitoring period on page 50 Specify if you want the log data collected by a resource model written to a local database. See Customizing data logging information on page 52. Procedure You can perform this procedure from the command line or the Tioli desktop. Command Line: Run the wdmeditprf command to customize a resource model for a profile. Desktop: 1. Open the IBM Tioli Monitoring Profile dialog box by doing the following: a. Open the Tioli desktop. b. Double-click the policy region icon to display the policy region. c. Double-click the profile manager icon to display the profile manager. d. Double-click the profile icon in which you want to customize a resource model. 2. Select a resource model from the IBM Tioli Monitoring Profile dialog box. 3. Click Edit to open the Edit Resource Model dialog box. 4. Click Indications. The Indications and Actions dialog box opens and displays the indications appropriate to the selected resource model. 5. Select the indication that has the associated eents you want to add or remoe. 6. Select the action from the Action List panel of the Indications and Actions dialog box. 7. Click Edit to open the Edit Current Action dialog box. 8. Enter the number of times you want the action to perform when an indication generates an eent in the Retry field. Additional information:if you set the Retry field to zero, the product continually tries to perform the action until the action is successful. What are the ramifications of running these action until they are successful? 9. Click Apply next to the Retry field to apply the changes. 10. Click one of the following buttons: Close Closes the Edit Current Action dialog box and saes the original retry alue. Modify & Close Closes the Edit Current Action dialog box and saes the modified retry alue. 44 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

55 Specifying tasks for an eent Objectie To specify a Tioli Framework Task so administrators and users can determine correctie or reporting tasks for an eent. Background Information You can select one or more Tioli Framework Tasks to perform when an indication generates an eent. You can select one or more task 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. See Creating profile managers and profiles on page 89 for more information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 91 for more information. Add a resource model to a profile. See Adding default resource models to profiles on page 93 and Adding customized resource models to profiles on page 94 for more information. See the IBM Tioli Monitoring for Web Infrastructure Reference Guide for detailed information abour each resource model. When You Finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 18. Optional: continue customizing the resource model as described in the other sections in this chapter. Procedure You can perform this procedure from the command line or the Tioli desktop. Command Line Run the wdmeditprf command to customize a resource model for a profile. Desktop 1. Open the IBM Tioli Monitoring Profile dialog box by doing the following: a. Open the Tioli desktop. b. Double-click the policy region icon to display the policy region. c. Double-click the profile manager icon to display the profile manager. d. Double-click the profile icon to which you want to customize a resource model. 2. Select the resource model that you want to customize from the IBM Tioli Monitoring Profile dialog box. 3. Click Edit. The Edit Resource Model dialog box opens. 4. Click Indications. The Indications and Actions dialog box opens and displays the indications appropriate to the selected resource model. Chapter 5. Working with IBM Tioli Monitoring 45

56 5. Select the indication that you want to generate a task from the Indications and Actions dialog box. 6. Click the Tasks button in the Action List dialog box. The Tasks dialog box opens. 7. Double-click the appropriate task library from the scroll list of the Libraries window. The tasks contained in the library are displayed in the Tasks window. 8. Double-click the appropriate task in the Tasks panel. 9. Specify the appropriate parameters in the Configure Task dialog box. Additional Information: Run the wlsnotif -g command to see the aailable Notice Groups. 10. Click Change & Close to add the task to the Action List panel in the Indications and Actions dialog box. Sending a notice to administrators when an eent occurs Objectie To send a notice in response to an eent so administratorscan take the apporpriate action. Background Information You can select the IBM Tioli Monitoring Utility task to send notices in response to an eent. Required Authorization Role admin Before You Begin Create a profile manager and profile. See Creating profile managers and profiles on page 89 for more information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 91 for more information. Add a resource model to a profile. See Adding default resource models to profiles on page 93 and Adding customized resource models to profiles on page 94 for more information. See the IBM Tioli Monitoring for Web Infrastructure Reference Guide for detailed information abour each resource model. When You Finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 18. Optional: continue customizing the resource model as described in the other sections in this chapter. Procedure You can perform this procedure from the command line or the Tioli desktop. Command Line Run the wdmeditprf command to customize a resource model for a profile. 46 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

57 Customizing parameters Desktop 1. Open the IBM Tioli Monitoring Profile dialog box by doing the following: a. Open the Tioli desktop. b. Double-click the policy region icon to display the policy region. c. Double-click the profile manager icon to display the profile manager. d. Double-click the profile icon to which you want to customize a resource model. 2. Select the resource model that you want to customize from the IBM Tioli Monitoring Profile dialog box. 3. Click Edit. The Edit Resource Model dialog box opens. 4. Click Indications. The Indications and Actions dialog box opens and displays the indications appropriate to the selected resource model. 5. Select the indication that you want to generate a task from the Indications and Actions dialog box. 6. Click the Tasks button in the Action List dialog box. The Tasks dialog box opens. 7. Double-click the IBM Tioli Monitoring Utility Tasks library in the scroll list of the Libraries panel. The tasks contained in the IBM Tioli Monitoring Utility Tasks library are displayed in the Tasks panel. 8. Double-click dm_mn_send_notice in the Tasks panel. The Configure Task dialog box opens. 9. Specify the appropriate parameters in the Configure Task dialog box. Additional Information: Run the wlsnotif -g command to see the aailable Notice Groups. 10. Click Change & Close to add the task to the Action List panel in the Indications and Actions dialog box. 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. See Creating profile managers and profiles on page 89 for more information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 91 for more information. Chapter 5. Working with IBM Tioli Monitoring 47

58 Add a resource model to a profile. See Adding default resource models to profiles on page 93 and Adding customized resource models to profiles on page 94 for more information. See the IBM Tioli Monitoring for Web Infrastructure Reference Guide for detailed information abour each resource model. When You Finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 18. Optional: continue customizing the resource model as described in the other sections in this chapter. Procedure You can perform this procedure from the command line or the Tioli desktop. Creating scheduling rules Command Line Run the wdmeditprf command to customize a resource model for a profile. Desktop 1. Open the IBM Tioli Monitoring Profile dialog box by doing the following: a. Open the Tioli desktop. b. Double-click the policy region icon to display the policy region. c. Double-click the profile manager icon to display the profile manager. d. Double-click the profile icon to which you want to customize a resource model. 2. Select the resource model that you want to customize from the IBM Tioli Monitoring Profile dialog box. 3. Click Edit. The Edit Resource Model dialog box opens. 4. Click the Parameters button. 5. Select the type of parameter from the Name drop-down list in the Parameters dialog box. 6. Add or delete the parameter alues as required by checking or unchecking the boxes. 7. Click Apply Changes and Close to sae your changes. Objectie To create schedule rules so administrators and users can determine the time periods on selected days when monitoring takes place. Background Information IBM Tioli Monitoring contains a scheduling feature that allows you to determine a 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 allows you set up a complex pattern of resource monitoring for a profile and 48 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

59 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 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, allowing 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 Sets the data collection period. By default, all resource models are set to always collect data. Schedule Rules Manages time interals during which the resource model is actie. Rule Editor Creates and edits schedule rules. Required Authorization Role admin Before You Begin Create a profile manager and profile. See Creating profile managers and profiles on page 89 for more information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 91 for more information. Add a resource model to a profile. See Adding default resource models to profiles on page 93 and Adding customized resource models to profiles on page 94 for more information. See the IBM Tioli Monitoring for Web Infrastructure Reference Guide for detailed information abour each resource model. When You Finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 18. Optional: continue customizing the resource model as described in the other sections in this chapter. Procedure You can perform this procedure from the command line or the Tioli desktop. Command Line Run the wdmeditprf command to customize a resource model for a profile. Chapter 5. Working with IBM Tioli Monitoring 49

60 Desktop 1. Open the IBM Tioli Monitoring Profile dialog box by doing the following: a. Open the Tioli desktop. b. Double-click the policy region icon to display the policy region. c. Double-click the profile manager icon to display the profile manager. d. Double-click the profile icon to which you want to customize a resource model. 2. Select the resource model that you want to customize from the IBM Tioli Monitoring Profile dialog box. 3. Click Edit. The Edit Resource Model dialog box opens. 4. Click the Schedule button. The Scheduling dialog opens. 5. Click the New Rule button in the Schedule Rules window. 6. Type a name for the rule in the Rule Name text box of the Rule Editor window. 7. Select one or more items in the weekday list to specify the day or days on which you want the collections actie during the collection period. Additional information: Use the Shift or Ctrl key as necessary to select more than one day from the list. 8. 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 local time where the endpoint engine runs. Setting a time interal of 08:00 to 13:00 ensures that monitoring takes place between those times in all time zones to which you distribute the profile. 9. Click Set Rule. Your new rule appears in the Schedule Rules list. Additional information: To display the details of any rule, select the rule in the Schedule Rules list. Its settings are displayed in the Rule Editor group box. If the Schedule Rules list 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. 10. Click Modify & Close to sae your rule and close the Scheduling dialog box. 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 allows you to determine a 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. 50 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

61 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 allows 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 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, allowing 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 dialog box has the following group boxes: Schedule Sets the data collection period. By default, all resource models are set to always collect data. Schedule Rules Manages time interals during which the resource model is actie. Rule Editor Creates and edits schedule rules. Required Authorization Role admin Before You Begin Create a profile manager and profile. See Creating profile managers and profiles on page 89 for more information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 91 for more information. Add a resource model to a profile. See Adding default resource models to profiles on page 93 and Adding customized resource models to profiles on page 94 for more information. Create the schedule rules. See Creating scheduling rules on page 48 for more details. See the IBM Tioli Monitoring for Web Infrastructure Reference Guide for detailed information abour each resource model. When You Finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 18. Optional: continue customizing the resource model as described in the other sections in this chapter. Chapter 5. Working with IBM Tioli Monitoring 51

62 Procedure You can perform this procedure from the command line or the Tioli desktop. Command Line Run the wdmeditprf command to customize a resource model for a profile. Desktop 1. Open the IBM Tioli Monitoring Profile dialog box by doing the following: a. Open the Tioli desktop. b. Double-click the policy region icon to display the policy region. c. Double-click the profile manager icon to display the profile manager. d. Double-click the profile icon to which you want to customize a resource model. 2. Select the resource model that you want to customize from the IBM Tioli Monitoring Profile dialog box. 3. Click Edit. The Edit Resource Model dialog box opens. 4. Click the Schedule button. The Schedule dialog box opens. 5. Deselect Always in the Schedule dialog box. 6. Set a Start Date and Stop Date to define the monitoring period. 7. Optional: Add one or more schedule rules that determine time periods on the selected dates that monitoring takes place. 8. 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 write it in a local database. You can store one of the following types of data in the database: Raw data Data written exactly as the resource model collects it. All the monitored alues are collected and copied in the database. Aggregated 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 52 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

63 Before You Begin Create a profile manager and profile. See Creating profile managers and profiles on page 89 for more information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 91 for more information. Add a resource model to a profile. See Adding default resource models to profiles on page 93 and Adding customized resource models to profiles on page 94 for more information. See the IBM Tioli Monitoring for Web Infrastructure Reference Guide for detailed information abour each resource model. When You Finish Distribute the profile to which the resource model belongs. See Distributing profiles on page 18. Optional: continue customizing the resource model as described in the other sections in this chapter. Procedure You can perform this procedure from the command line or the Tioli desktop. Command Line Run the wdmeditprf command to customize a resource model for a profile. Desktop 1. Open the IBM Tioli Monitoring Profile dialog box by doing the following: a. Open the Tioli desktop. b. Double-click the policy region icon to display the policy region. c. Double-click the profile manager icon to display the profile manager. d. Double-click the profile icon to which you want to customize a resource model. 2. Select the resource model that you want to customize from the IBM Tioli Monitoring Profile dialog box. 3. Click Edit. The Edit Resource Model dialog box opens. 4. Click Logging. The Logging dialog opens. 5. Select the Enable Data Logging check box in the Data Logging Settings window. This enables logging of all raw data collected by the resource model to a database. 6. Perform the following steps to specify the aggregation rule applied to the data before it is written to the database: a. Set Hours and Minutes of the Aggregation Period to the required alues. b. Select one or more of the following functions to perform on the numerical data collected during the aggregation period before it is written to the database: Maximum Calculates and logs the peak alue in each aggregation period. Minimum Calculates and logs the lowest alue in each aggregation period. Chapter 5. Working with IBM Tioli Monitoring 53

64 Aerage Calculates and logs the aerage of all alues in each aggregation period. 7. Set Hours and Minutes of the Historical Period to the required alues. 8. Click Apply Changes and Close to sae your changes and close the Logging dialog box. Managing profiles and resource models at endpoints Objectie To manage profiles and resource models after they are distributed to endpoints so administrators and users can maintain monitoring processes on those endpoints. Background information None Required Authorization Role admin Before You Begin Create a profile manager and profile. See Creating profile managers and profiles on page 89 for more information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 91 for more information. Add a resource model to a profile. See Adding default resource models to profiles on page 93 and Adding customized resource models to profiles on page 94 for more information. See the IBM Tioli Monitoring for Web Infrastructure Reference Guide for detailed information abour each resource model. When You Finish Not applicable. Procedure You can perform this procedure from the command line only. Command Line Run the wdmcmd to stop or restart on one or more endpoints from a gateway or serer. Run the wdmdistirb command to distribute a profile to one or more subscribers. 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 engine at the endpoint. 54 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

65 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. See Creating profile managers and profiles on page 89 for more information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 91 for more information. Add a resource model to a profile. See Adding default resource models to profiles on page 93 and Adding customized resource models to profiles on page 94 for more information. Distribute the profile. See Distributing profiles on page 18 for more information. See the IBM Tioli Monitoring for Web Infrastructure Reference Guide for detailed information abour each resource model. 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 selected processes on one or all gateways. Determining which resource models hae been distributed to endpoints Objectie To determine which resource models hae been distributed to an endpoint. Background Information Open an endpoint window from the desktop to see if a monitor has been distributed to it. Note: To distribute monitors, you must hae the authorization role. Required Authorization Role admin Chapter 5. Working with IBM Tioli Monitoring 55

66 Before You Begin Create a profile manager and profile. See Creating profile managers and profiles on page 89 for more information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 91 for more information. Add a resource model to a profile. See Adding default resource models to profiles on page 93 and Adding customized resource models to profiles on page 94 for more information. Distribute the profile. See Distributing profiles on page 18 for more information. See the IBM Tioli Monitoring for Web Infrastructure Reference Guide for detailed information abour each resource model. 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. 56 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

67 Chapter 6. Working with Tioli Monitoring for Web Infrastructure: iplanet Web Serer objects Showing object properties This chapter proides information about working with Tioli Monitoring for Web Infrastructure: iplanet Web Serer resources, to: Show the properties of an iplanet Web serer object Refresh the properties of an iplanet Web serer object Check the status of an iplanet Web serer instance Start, stop, or restart an iplanet Web serer instance Start or stop a irtual serer Check the status of a irtual 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 the Web serer and irtual serer, 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. Objectie To show the properties of an iplanet Web serer object. Note: The object properties show the actual information that Tioli Monitoring for Web Infrastructure: iplanet Web Serer uses when you perform any operation. To keep the object properties up-to-date, see Refreshing object properties on page 58. Not all the information is refreshed. If you change the SNMP information or the installation path, then you need to delete and recreate the iplanet Web serer object. Background information Not applicable. Required authorization role iplanetwebserer_user Before you begin Create the iplanet Web serer object. For more information, see Creating Tioli Monitoring for Web Infrastructure: iplanet Web Serer objects on page 16. When you finish You can now see the properties of the iplanet Web serer object. Procedure You can perform this procedure from the command line or Tioli desktop. 57

68 Command line: Run the wiplanetws command to show the list of the irtual serers hosted by the iplanet 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 the policy region where the iplanet Web 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: Version of the iplanet Web serer associated with the object The SNMP community and SNMP port of the iplanet Web serer The installation path of where the iplanet Web serer is installed The date and time when the latest information refresh occurred A list of the irtual serers that are hosted by the iplanet Web serer associated with the object, together with their properties. Objectie To refresh the properties of an iplanet Web serer object. Background information The object properties show the actual information that Tioli Monitoring for Web Infrastructure: iplanet Web Serer uses when you execute any operation. Object properties are not automatically refreshed, when the iplanet Web serer associated 58 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

69 with the object is modified. To keep the properties up-to-date, you need to refresh them manually, as explained in this section. Note: Not all the information is refreshed. If you change the SNMP information or the installation path, then you need to delete and recreate the iplanet Web serer object. Required authorization role iplanetwebserer_admin Before you begin Create the iplanet Web serer object. For more information, see Creating Tioli Monitoring for Web Infrastructure: iplanet Web Serer objects on page 16. When you finish The properties of the iplanet Web serer object hae been refreshed to reflect the current iplanet Web serer instance configuration. Procedure You can perform this procedure from the command line or from the Tioli desktop. Command line: Run the wiplanetws 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 iplanet Web serer object is located to display the Policy Region window. 2. Right-click on the object for which you want to refresh the properties and, from the pop-up menu, select Refresh. A dialog with a message informing you that the operation was successfully executed is displayed. 3. Click OK to close the information dialog and return to the Policy Region window. Checking the status of a Web serer Objectie To check the status of an iplanet Web serer associated with an object. Background information The status of the iplanet Web serer associated with an object, is displayed by Tioli Monitoring for Web Infrastructure: iplanet Web Serer as: Actie Not actie Required authorization role iplanetwebserer_user Chapter 6. Working with Tioli Monitoring for Web Infrastructure: iplanet Web Serer objects 59

70 Before you begin Create the iplanet Web serer object. For more information see Creating Tioli Monitoring for Web Infrastructure: iplanet Web Serer objects on page 16. Refresh the object properties. For more information, see Refreshing object properties on page 58. When you finish Not applicable. Procedure You can perform this procedure from the command line or Tioli desktop. Command line: Run the wiplanetws 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 the Monitoring for iplanet Web serer policy region to display the Policy Region window. 2. Right-click the object whose associated iplanet Web serer you want to check and, from the pop-up menu, select Check Web Serer Status. A dialog with a message reporting the status of the iplanet Web serer is displayed. 3. Click OK to close the information dialog and return to the Policy Region window. Starting, stopping, or restarting a Web serer Objectie To start, stop, or restart an iplanet Web serer. Note: If the iplanet Web serer runs at least a secure irtual serer, you cannot start or restart the serer with Tioli Monitoring for Web Infrastructure: iplanet Web Serer. Background information You can restart a Web Serer only if it is already running. If the Web Serer is stopped it cannot be restarted. You must use the start option to start it. Required authorization role iplanetwebserer_admin Before you begin Create iplanet Web serer objects. For more information see Creating Tioli Monitoring for Web Infrastructure: iplanet Web Serer objects on page 16. Refresh the object properties. For more information, see Refreshing object properties on page IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

71 When you finish The Web Serer has been started, stopped, or restarted. Procedure You can perform this procedure from the command line, by task, or from the Tioli desktop. Command line: Run the wiplanetws command to start or stop an iplanet Web serer. For more information about the command syntax, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Task: Run the Start task or Stop task to start or stop an iplanet Web serer. For more information about running tasks, see Chapter 7, Working with tasks and jobs. Desktop: From the Tioli desktop, perform the following steps: 1. Double-click the Monitoring for iplanet Web serer policy region to display the Policy Region window. 2. Right-click an iplanet Web serer object and, from the pop-up menu, select Start, Stop, orrestart to start, stop, or restart the Web serer associated with the object. A dialog with a message informing you that the operation was successfully executed is displayed. 3. Click OK to close the information dialog and return to the Policy Region window. Starting or stopping a irtual serer Objectie To start or stop a irtual serer hosted by an iplanet Web serer. Note: You cannot stop the default irtual serer. Background information You cannot perform start or stop on Administration serer objects. Required authorization role iplanetwebserer_admin Before you begin Refresh the object properties, if needed. For more information, see Refreshing object properties on page 58. When you finish Not applicable. Procedure You can perform this procedure from the command line, by task, or from the Tioli desktop. Command line: Run the wiplanetws command to start or stop a irtual serer. For more information about the command syntax, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Chapter 6. Working with Tioli Monitoring for Web Infrastructure: iplanet Web Serer objects 61

72 Task: Run the Start Site task or Stop Site task to start or stop a irtual serer hosted by an iplanet Web serer. For more information about running tasks, see Chapter 7, Working with tasks and jobs. Desktop: From the Tioli desktop, perform the following steps: 1. Double-click the policy region to display the Policy Region window. 2. Right-click an iplanet Web serer object and, from the pop-up menu, select Start Virtual Serer or Stop Virtual Serer to start or stop a irtual serer. The Start Virtual Serer or Stop Virtual Serer dialog box is displayed. 3. From the irtual serers list, select the irtual serer 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 Virtual Serer or Stop Virtual Serer dialog box. 5. Click Close to return to the Policy Region window. Checking the status of a irtual serer Objectie To check the status of a irtual serer hosted by an iplanet Web serer. Background information The status of a irtual serer hosted by an iplanet Web serer is displayed by Tioli Monitoring for Web Infrastructure: iplanet Web Serer as: Actie Not actie Required authorization role iplanetwebserer_user Before you begin Refresh the objects properties, if needed. For more information, see Refreshing object properties on page 58. When you finish Not applicable. Procedure You can perform this procedure from either the command line or the Tioli desktop. 62 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

73 Command line: Run the wiplanetws command to display the status of a irtual 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 the Monitoring for iplanet Web serer policy region to display the Policy Region window. 2. Right-click the object whose iplanet Web serer irtual serer you want to check and, from the pop-up menu, select Check Virtual Serer status. The Check the Status of a irtual serer dialog box is displayed. 3. From the irtual serers list, select the irtual serer you want and click Check Status. A dialog box with a message reporting the status of the selected irtual serer is displayed. 4. Click OK to close the dialog box and return to the Check the Status of a irtual serer dialog box. 5. Click Close to close the Check the Status of a irtual serer dialog box and return to the Policy Region window. Chapter 6. Working with Tioli Monitoring for Web Infrastructure: iplanet Web Serer objects 63

74 64 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

75 Chapter 7. Working with tasks and jobs Running a task This chapter proides information about using tasks and jobs to manage your iplanet Web serer objects. The installation process installs the Monitoring for iplanet Web serer Tasks task library in the Monitoring for iplanet Web 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: iplanet Web 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. The product proides standard tasks in a task library. Standard tasks run on any machine regardless of the operating system installed. Tioli Monitoring for Web Infrastructure: iplanet Web Serer proides four standard tasks: Start and Stop to start and stop the Web serer, and Start Site and Stop Site to start and stop irtual serers. Required authorization roles iplanetwebserer_admin Before you begin Not applicable. When you finish Not applicable. Procedure You can perform this procedure from either the command line or the Tioli desktop. Command line: Run the wruntask command. For more information about the command syntax, see the Tioli Monitoring for Web Infrastructure: Reference Guide. Desktop: From the Tioli desktop, perform the following steps: 1. Double-click the Monitoring for iplanet Web Serer policy region icon to display the Policy Region window. 65

76 2. Double-click the Monitoring for iplanet Web 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 Runs the task simultaneously on all targets. Parallel is typically the fastest method of execution. Serial Runs the task sequentially on all targets in alphabetical order. Staged Runs the task on all targets in alphabetical order according to a schedule you specify. Staged execution is useful if you are running the 66 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

77 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 name, with its complete path, 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 iplanetwebserer objects where to run the task, do one of the following. Chapter 7. Working with tasks and jobs 67

78 Additional Information: Tioli Monitoring for Web Infrastructure: iplanet Web Serer tasks can only be run on iplanetwebserer objects (the type of endpoint is displayed within parentheses following the endpoint). Run the task on specific iplanet Web Serer objects, as follows: a. From the Aailable Task Endpoints list, select the iplanetwebserer 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. To run the task, click Execute. As Tioli Monitoring for Web Infrastructure: iplanet Web Serer tasks do not require additional arguments, the task is run. 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, or 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 72. You also can schedule jobs to run at certain times in the Scheduler, as described in Scheduling a job on page 73. Procedure You can perform this procedure from either the Tioli command line or the desktop. Command Line: Run the wcrtjob command. The syntax is as follows: wcrtjob j job_name l Monitoring for iplanet 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: 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. 68 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

79 l Monitoring for iplanet Web serer tasks The task library containing the task to be included in the job. t task_name The name of the task to include in the job, Start, Stop, Start Site, orstop Site. 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. -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 running of the job. If you are using staged mode, the timeout must be smaller than the interal time. -o output-format Defines the format of the job output. h target_endpoint_name The name of the target iplanet Web serer object, in the -p profile_manager_name The profiles managers on which the job runs. Desktop: 1. Double-click the Monitoring for iplanet Web serer policy region icon to display the Policy Region window. 2. Double-click the Monitoring for iplanet Web serer tasks task library icon to display the task library window. Chapter 7. Working with tasks and jobs 69

80 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 Runs the task simultaneously on all targets. Parallel is typically the fastest method of execution. Serial Runs the task sequentially on all targets in alphabetical order. Staged Runs 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). 70 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

81 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 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. 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 start-up 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 iplanetwebserer objects where to run the task, do one of the following. Additional Information: Tioli Monitoring for Web Infrastructure: iplanet Web Serer tasks can only be run on iplanetwebserer objects (the type of endpoint is displayed within parentheses following the endpoint). Run the task on specific iplanet Web Serer objects, as follows: Chapter 7. Working with tasks and jobs 71

82 a. From the Aailable Task Endpoints list, select the iplanetwebserer 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. 13. Click Create & Close to create the job and return to the Task Library window. Additional Information: The new job icon appears in the Task Library window. 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 68. Required authorization roles iplanetwebserer_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: 1. Double-click the Monitoring for iplanet Web Serer policy region icon to display the Policy region window. 2. Double-click the Monitoring for iplanet Web 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. 72 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

83 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 68. Required authorization roles iplanetwebserer_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: 1. Double-click the Monitoring for iplanet Web Serer policy region icon to display the Policy region window. 2. Double-click the Monitoring for iplanet Web 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. 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. 5. Do one of the following: To stop a scheduled job from running, select the The Disable the Job check box. To continue running a scheduled job, deselect the The Disable the Job check box. Additional Information: For more information on job disabling, see the Tioli Management Framework User s Guide. 6. Optional: In the Description field, type a job description to uniquely identify the job. 7. In the Schedule Job For group box, set the date and time to begin scheduling: Chapter 7. Working with tasks and jobs 73

84 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. 8. Optional: To repeat the job, in the Repeat the Job group box: a. Do one of the following: T o 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. 9. 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 box. 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. 10. Optional: To set retry, cancel, or restriction options: 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: 74 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

85 To hae the Scheduler continue trying the job indefinitely, deselect 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. 11. Click Schedule Job & Close to schedule the job and return to the Tioli desktop. Chapter 7. Working with tasks and jobs 75

86 76 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

87 Chapter 8. Enabling Tioli Monitoring for Web Infrastructure: iplanet Web Serer for Tioli Enterprise Data Warehouse Oeriew This chapter proides information on enabling Tioli Monitoring for Web Infrastructure: iplanet Web 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 Enterprise Data Warehouse consists of the following components: Control serer Central data warehouse Data marts Report interface Control serer The control serer contains the control database for Tioli Enterprise Data Warehouse from which you manage your data warehouse. 77

88 The control serer has these 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: iplanet Web 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 Tioli Enterprise Data Warehouse V1.1 Enabling an Application for Tioli Enterprise Data Warehouse. 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 78 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

89 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. The following sections describe how to do 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, run 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 Creating an IBM Console user An oeriew of the Tioli Enterprise Data Warehouse roles 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. 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. Chapter 8. Enabling Tioli Monitoring for Web Infrastructure: iplanet Web Serer for Tioli Enterprise Data Warehouse 79

90 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: Creating an IBM console user 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. 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 Enterprise 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 create an IBM Console user, complete the following steps: 1. From the IBM Console, select Administer Users and then Create a User. 2. Open the Task Assistant and follow the instructions proided in the online help to create a user. 80 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

91 Assigning roles to a user Creating a user group 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 Enterprise 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, complete the following steps: 1. From 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 Enterprise 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. Procedure To create a user group, complete the following steps: 1. From the IBM Console, select Work with Reports and then Manage User Groups. 2. In the Manage User Groups window, click the context menu of Root and select Create. 3. Follow the instructions in the Task Assistant about creating user groups. Chapter 8. Enabling Tioli Monitoring for Web Infrastructure: iplanet Web Serer for Tioli Enterprise Data Warehouse 81

92 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 Enterprise 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, complete the following steps: 1. From 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. Assigning user groups to a data mart Objectie To assign users 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 Enterprise 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, remoing users from a user group, and remoing data mart access from a user group. Procedure To assign user groups to a data mart, complete the following steps: 1. From 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 select Properties. 82 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

93 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: iplanet Web 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 Enterprise 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 IBM Console. This includes reports from all Tioli software products that use the Tioli Enterprise Data Warehouse report interface. A Tioli Enterprise Data Warehouse report uses data from a single 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 Enterprise Data Warehouse V1.1 Enabling an Application for Tioli Enterprise Data Warehouse. For information about the specific data mart, star schema, and report mapping of Tioli Monitoring for Web Infrastructure: iplanet Web Serer, see the Tioli Monitoring for Web Infrastructure: iplanet Web 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. Required authorization role AdRepAuthRole, RepAuthRole, or RepReaderRole Before you begin Not applicable. Chapter 8. Enabling Tioli Monitoring for Web Infrastructure: iplanet Web Serer for Tioli Enterprise Data Warehouse 83

94 When you finish The Tioli Enterprise Data Warehouse online help also guides 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, complete the following steps: 1. From 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 Enterprise 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 schedule a report to run automatically when the associated data mart is updated, complete the following steps: 1. From 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. 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. 84 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

95 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 4. 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, complete 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: 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 Chapter 8. Enabling Tioli Monitoring for Web Infrastructure: iplanet Web Serer for Tioli Enterprise Data Warehouse 85

96 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 Enterprise 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 irtual serer, select the name of the irtual serer in the GWP.D_SERVER.SERVERNAME field. 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 January 1, 2002 through January 31, IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

97 14. 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 First Paragraph After you finish First Paragraph 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: Chapter 8. Enabling Tioli Monitoring for Web Infrastructure: iplanet Web Serer for Tioli Enterprise Data Warehouse 87

98 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 GWP.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 January 1, 2002 through January 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. 88 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

99 Appendix A. Setting up IBM Tioli Monitoring During installation, Tioli Monitoring for Web Infrastructure: iplanet Web Serer performs 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. Profile managers and profiles can group resources to enable simultaneous monitoring of multiple resources. You can hierarchically organize 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 89

100 Before you begin Set up the Tmw2kProfile managed resource types. Refer to the IBM Tioli Monitoring: User s Guide for information. When you finish Add resource models to the profile. See Adding default resource models to profiles on page 93 and Adding customized resource models to profiles on page 94. 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 the following command: MarketingProfile MarketingProf2 For additional information about these commands, see the Tioli Management Framework: Reference Manual. Desktop: 1. Double-click the Monitoring for iplanet Web Serer 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. 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 90 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

101 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 18. Required authorization role admin Before you begin Create a monitoring profile with monitoring resources. For more information, see Creating profile managers and profiles on page 89. When you finish Distribute the monitoring profile to the subscribed resource. For more information, see Distributing profiles on page 18. Appendix A. Setting up IBM Tioli Monitoring 91

102 Procedure You can perform this procedure from either the command line or the Tioli desktop. Command line: Run the wsub command to add subscribers to the profile manager. For example, to add an iplanet Web serer object called as a subscriber to the profile manager WebSererMonitors, Notes: 1. In the case of Tioli Monitoring for Web Infrastructure: iplanet Web Serer, the subscribers are always iplanet Web serer objects. 2. iplanet Administrator serer objects cannot be subscribed to profile managers. For more information about the command syntax, see the Tioli Management Framework: Reference Manual. Desktop: 1. Double-click a policy region icon to display the Policy Region window. 2. Double-click a profile manager icon to display 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. 92 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

103 Note: In the case of Tioli Monitoring for Web Infrastructure: iplanet Web Serer, the subscribers are iplanet Web serer objects. iplanet Administrator serer objects cannot be subscribed to profile managers. 5. Click the left-arrow button to moe the selected subscribers to the Current Subscribers scrolling list. 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 model 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 allows you to begin monitoring resources immediately. We recommend that you put all the resource models you are going to distribute 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, see Creating profile managers and profiles on page 89 for more information. Add subscribers to a profile manager, see Subscribing resources to profile managers on page 91. See the IBM Tioli Monitoring for Web Infrastructure: Reference Guide for detailed information about each resource model. When you finish Distribute the profile. See Distributing profiles on page 18 for more information. Procedure You can perform this procedure from either the command line or the Tioli desktop. Command line: Run the wdmeditprf command to add a customized resource model to a profile. For more information, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Desktop: 1. Double-click a policy region icon to display the Policy Region window. 2. Double-click a profile manager icon to display the Profile Manager window. Appendix A. Setting up IBM Tioli Monitoring 93

104 3. From the Profiles dialog box, double-click a profile to display the IBM Tioli Monitoring Profile window. 4. Click Add with Defaults to display the Add Default Models to Profile dialog box. 5. From the Category drop-down list, select IPlanet. 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 operating system, 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. To add a resource model to a profile using its default alues so administrators and users can include them in the IBM Tioli Monitoring 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 allows you to begin monitoring resources immediately. We recommend that you put all the resource models you are going to distribute to the same endpoint in a single profile because the distribution occurs on a per-profile basis. 94 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

105 Required Authorization Role admin Before you begin Create a profile manager and profile. See Creating profile managers and profiles on page 89 for information. Add subscribers to a profile manager. See Subscribing resources to profile managers on page 91 for information. See the IBM Tioli Monitoring for Web Infrastructure: Reference Guide for detailed information about each resource model. When you finish Distribute the profile. See Distributing profiles on page 18 for more information. Procedure You can perform this procedure from either the command line or the Tioli desktop. Command line: Run the wdmeditprf command to add a customized resource model to a profile. For more information, see the IBM Tioli Monitoring: User s Guide Desktop: 1. Double-click a policy region icon to display the Policy Region window. 2. Double-click a profile manager icon to display 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 display the Add Resource Models to Profile dialog box. 5. From the Category drop-down list, select IPlanet. 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 of the threshold that you selected. A dialog box aboe the description displays the currently assigned threshold alue. 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 proided with the resource models. See Customizing thresholds and eents on page 40, Customizing parameters on page 49, and Customizing the scheduling monitoring period on page 53 for more information. 10. Click Add & Close to sae your changes. The resource model is added to the IBM Tioli Monitoring Profile window. Appendix A. Setting up IBM Tioli Monitoring 95

106 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. 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: 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 named according to the following conention: OriginalProfileName_Push_Failed_Bad_Interpreter 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 or Linux 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. 96 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

107 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: iplanet Web 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: iplanet Web 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: iplanet Web 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: iplanet Web 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. 97

108 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: iplanet Web 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: iplanet Web Serer CIM classes begin with iplanet. 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. In the left pane, 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: iplanet Web Serer CD-ROM. f. According to the operating system where the resource model is to run, select one of the following directories: Windows: Workbench/w32-ix86 UNIX: Workbench/UNIX 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: iplanet Web 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: iplanet Web Serer CIM classes, must belong to the IPlanet category and need to be distributed to the iplanetwebserer objects. 98 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

109 Appendix C. Tasks Quick Reference Tioli Monitoring for Web Infrastructure: iplanet Web Serer proides the following tasks to help you manage your iplanet Web serer. For more information about these tasks, see the IBM Tioli Monitoring for Web Infrastructure: Reference Guide. Table 5. Tioli Monitoring for Web Infrastructure: iplanet Web Serer task libraries and tasks Task library Task Name Required Authority Target endpoint Monitoring for iplanet Web Start iplanetwebserer_admin iplanet Web Serer object Serer Tasks Stop iplanetwebserer_admin iplanet Web Serer object Start Site iplanetwebserer_admin iplanet Web Serer object Stop Site iplanetwebserer_admin iplanet Web Serer object 99

110 100 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

111 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: iplanet Web Serer proides. The following topics are discussed: Eent classes Rules for eents Tioli Monitoring for Web Infrastructure: iplanet Web Serer proides a set of Tioli Enterprise Console eent classes: IPlanet_EV_HighBytesSent IPlanet_EV_HighFailedResp IPlanet_EV_HighSererError IPlanet_EV_HighBytesReceied IPlanet_EV_HighUnauthorizedResponse IPlanet_EV_LowSuccessResp IPlanet_EV_VirtualSererDown IPlanet_EV_KBytesOutPerSecHigh IPlanet_EV_KBytesInPerSecHigh IPlanet_EV_HighFractionOnSystemMemory IPlanet_EV_HighLoad IPlanet_EV_ConnQueueFull IPlanet_EV_KeepAlieQueueFull IPlanet_EV_SererStopped Tioli Monitoring for Web Infrastructure: iplanet Web Serer supplies a set of rules that proide correlation of related eents. The itmiplanet_tbsm_forward.rls file contains the set of rules. This rule set uses the classes from the from the *.baroc files that are proided with the product. The rules and their functions are as follows: forward_itmiplanet_eent_to_tbsm Forwards eents to Tioli Business Systems Manager. forward_itmiplanet_clearing_eent_to_tbsm Forwards clearing eents to Tioli Business Systems Manager. 101

112 102 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

113 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: iplanet Web Serer. Log and trace files are written in a readable format and stored in the following directories: $DBDIR/GWP/logs Serer and managed node files $LCF_DATDIR/LCFNEW/GWP/logs Endpoint files If the problem cannot be resoled from the log file, proide the trace file 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: iplanet Web Serer Logs and Traces The following sections describe the Tioli Monitoring for Web Infrastructure: iplanet Web 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 iplanet Web serer registration, inoked using command line or GUI, is running. Here is a description of the log and trace files: Log and trace files: Log file (xml format): msgiplanetwebsererspd.log Trace file: traceiplanetwebsererspd.log Location: $DBDIR/GWP/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 106. Managed node traces and logs When you use CLI, on the managed node where the command is run and on the managed node where the iplanet Web 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, for command line actiities 103

114 Trace file: tracecli.log, for command line actiities Trace file: traceiplanetwebserer.log, for actiities performed on the iplanet Web serer object. Location: $DBDIR/GWP/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 106. Endpoint traces Two trace files are stored at endpoints. Trace files: Trace file: traceendpoint.log Tracks the actiities carried out when the endpoint methods are running. trace_instr1.log Tracks the actiities carried out when JMX MBeans and related jaa code are running Location: $LCF_DATDIR/LCFNEW/GWP/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 106. Resource model traces You can also check iplanet Web serer resource model trace information in IBM Tioli Monitoring trace files located at the endpoint. Windows endpoint log: The main trace log generated by the IBM Tioli Monitoring engine at Windows 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 issue the command wdmtrceng from the Serer or managed node, specifying the endpoint at which you want to configure 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 104 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

115 Non-Windows endpoint log and trace: These files maintain details of the actiities of the engine, which is the process that runs the resource models and sends eents and indications to the gateway, as follows: Log Name: msg_dmxengine.log (when the log is full it is renamed to dmxengine.old, deleting any existing file with that name, and a new log file is created.) Trace Name: trace_dmxengine.log (when the log is full it is renamed to dmxengine.old, deleting any existing file with that name, and a new log file is created.) Location: $LCF_DATDIR/LCFNEW/AMW/logs Configuration: To configure the log issue the command wdmtrceng from the Serer or managed node, identifying the endpoint at which you want to configure the log. You should note that this command maintains a common configuration for all logs at a non-windows endpoint. You can set any of the following parameters: Trace leel, from 0 (minimum) to 3 (maximum) Maximum file size: default= (2.5MB) Log record format The log record format is as follows: MessageId TraceLe Date1 Date2 ProductID Component Serer LogText Exception where: MessageId The unique numeric message identifier. TraceLe The 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 the log was produced specified in milliseconds, since January 1st 1970, for example, Date2 Time the log was produced specified in GMT. It includes the date, time, and time zone, for example, Tue Mar 05 15:53: GMT. ProductID The three letter code assigned to the product to identify its messages uniquely (GWP for Tioli Monitoring for Web Infrastructure: iplanet Web Serer). Component Represents a run-time grouping of a product s parts. If a product has multiple applications, the Component name will reflect the name of the application. Serer Host name. LogText Text of the message. Appendix E. Problem Determination 105

116 Exception Exception element will depend upon the specific language/platform. For Jaa, it will be a stack trace. Trace record format The trace record format is as follows: Date Time SourceFile MethodName LineNumber ProductID Component Hostname Message where: Date Date the trace was produced. Time Time the trace was produced. SourceFile Name of the source file to which the trace refers. MethodName The name of the method in the class to which the trace refers. LineNumber The method line number to which the trace refers. ProductID The three letter code assigned to the product to identify its messages uniquely). Component Represents a run-time grouping of a product s parts. If a product has multiple applications, the Component name will reflect the name of the application. HostName Host name. Message Text of the message. Log and trace configuration In the sericeability.properties file, located in eery directory dedicated to log/trace files, it is possible to set filtering leels. 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 settable leels are DEBUG_MAX, DEBUG_MID, and DEBUG_MIN. 106 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

117 In the sericeability.properties file it is also possible to set the output format: ccg_basicformatter Produces the default formatted output for an eent. The following context information is gien: The date and time at which the eent was created. The file name where the message was logged. The line number where the message was logged. The name of the product that created the message. The name of the component that created the message. A serer associated with the creation of the message. The eent text. ccg_xmlformatter Produces output in XML format. 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), and is aailable on Solaris, 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 [IPlanetWebSerer] Where: objectid The object identifier of the endpoint or IPlanetWebSerer object. output_file The name of the output file where collected data is to be stored. Appendix E. Problem Determination 107

118 Possible problems and solutions IPlanetWebSerer Specify the class name IPlanetWebSerer 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. Insufficient authorization to create iplanet Web serer object When you try to create an iplanet Web serer object, the message FRWOG0022E insufficient authorization is displayed. Solution Check the Tioli management region role: iplanetwebserer_super is required for an administrator to be able to create an iplanet Web serer object. Unable to create an iplanet Web serer object You are unable to create an iplanet Web serer Object. When you try to register a new iplanet Web serer object, the message GWP2234E A Web serer cannot be created is displayed. Solution Check the installation directory, for example, /usr/iplanet/serers Check the SNMP port & community, that you can optionally specify. The default alues are 161 and public. Check if Jaa Runtime Enironment is on the endpoint machine. If not, you can either run the DMLinkJre task, or run the wdmdistrib command: wdmdistrib l J JRE_location_dir { s subscribers_file subscriber} where: l Mandatory. Allows distributions only to the current subscribers of the profile manager to which the profile belongs J JRE_location_dir The complete path of the directory where Jaa Runtime Enironment is located on the CD-ROM (excluding the operating system directory). The path can be included within double quotes. s subscribers_file A file containing the profile s subscriber names, separated by the CR/LF character. subscriber If more than one subscriber is specified, separate the names with blanks. For more information, see Installing and linking to a Jaa Runtime Enironment on page 15. If you hae an Interconnected Tioli management region enironment, check that the managed node and endpoint you specify during registration are in the same Tioli management region. 108 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

119 No iplanet Web serer instances hae been discoered When you try to register a new iplanet Web serer object, the messages GWP2248I No iplanet instances hae been discoered on endpoint is displayed. Solution Check that the SNMP agent is installed, configured, and running: Using the iplanet Administratie interface If running on Windows: check that SNMP was installed before Tioli Monitoring for Web Infrastructure: iplanet Web Serer Unable to create a new iplanet Web serer object When you try to create a new iplanet Web serer object, the messages GWP2235E An error occurred during an attempt to collect the irtual serers hosted on endpoint is displayed. Solution Check that you entered the installation directory correctly, for example, /usr/iplanet/serers. You cannot register a new iplanet Web serer object if you specify an incomplete installation path. Cannot restart an iplanet Web serer When you try to restart an iplanet Web serer on a specific endpoint using Tioli Monitoring for Web Infrastructure: iplanet Web Serer, after creating the related iplanet Web serer object, the message GWP2252E: The iplanet Web serer could not be restarted is displayed. Solution Ensure that the iplanet Web serer is running. Check if the iplanet Web serer configuration changed since the last refresh action. It is important to Refresh the iplanet Web serer object eery time there are changes in the associated iplanet Web serer configuration, for example, if you changed the number or configuration of irtual serers. Cannot start or stop an iplanet irtual serer When you try to start or stop an iplanet irtual serer on a specific endpoint, the message GWP2243E: The iplanet irtual serer could not be started is displayed. Solution On Windows NT, starting and stopping an iplanet irtual serer does not execute successfully because of a problem with iplanet Web Serer Version 6.0. Check that the serer.xml file has write permission for user root (on UNIX) or the Administrator (on Windows). You cannot stop the default irtual serer. Check if the iplanet Web serer configuration changed since the last refresh action. It is important to Refresh the iplanet Web serer object eery time there are changes in the associated iplanet Web serer configuration, for example, if you changed the number or configuration of irtual serers. Unable to start iplanet Web serer You are unable to start the iplanet Web serer. Appendix E. Problem Determination 109

120 Solution Check whether the Web serer runs at least one secure irtual serer. If so, you cannot use Tioli Monitoring for Web Infrastructure: iplanet Web Serer to start the Web serer. Prerequisite or dependency missing After resource model distribution, the IBM Tioli Monitoring command: wdmlseng e endpoint_label erbose displays a Missed prereq message. Solution A prerequisite or dependency (MOF, Proider, or other) is missing. Check that Jaa Runtime Enironment is installed on the endpoint machine. If not, you can either run the DMLinkJre the wdmistrib command: wdmdistrib l J JRE_location_dir { s subscribers_file subscriber} where: l Mandatory. Allows distributions only to the current subscribers of the profile manager to which the profile belongs J JRE_location_dir The complete path of the directory where Jaa Runtime Enironment is located on the CD-ROM (excluding the operating system directory). The path can be included within double quotes. s subscribers_file A file containing the profile s subscriber names, separated by the CR/LF character. subscriber If more than one subscriber is specified, separate the names with blanks. For more information, see Installing and linking to a Jaa Runtime Enironment on page 15. Unable to distribute resource models After resource model distribution, the IBM Tioli Monitoring command: wdmlseng e endpoint_label erbose displays an Unable to start message. Solution Check if you are distributing the resource model to an Administration serer. Check if the iplanet Web serer configuration changed since the last refresh action. It is important to Refresh the iplanet Web serer object eery time there are changes in the associated iplanet Web serer configuration, for example, if you changed the number or configuration of irtual serers. Log or trace files are not written The log and trace files are not stored in the logs directory. 110 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

121 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 106. According to the operating system you are using, ensure that the /GWP 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. List of irtual serers empty after creating an iplanet Web serer object When you create an iplanet Web serer object, its list of irtual serers is empty. Solution This problem occurs because the Web serer is not actie. You can start it from either the command line or the Tioli desktop. Command line: wiplanetws -p object_label start To start the Web serer, run the following command: Then, to refresh the serer properties run the following command: wiplanetws -p object_label refresh Desktop: From the Tioli desktop, perform the following steps: 1. Right-click the iplanet Web serer object and, from the pop-up menu, select Start to start the Web serer associated with the object. A dialog with a message informing you that the operation was successfully executed is displayed. 2. Right-click on the object and, from the pop-up menu, select Refresh to refresh its properties. 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 on a resource being 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. Appendix E. Problem Determination 111

122 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). 112 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

123 Appendix F. Accessibility Using assistie technologies Accessibility features help users who hae a physical disability, such as restricted mobility or limited ision, to use software products successfully. The major accessibility features in Tioli Monitoring for Web Infrastructure: iplanet Web 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: iplanet Web 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: iplanet Web 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 Adobe book Optimizing Adobe PDF Files for Accessibility All documentation images are proided with an alternatie text that can be read by assistie tools such as screen readers. 113

124 114 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

125 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. 115

126 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. 116 IBM Tioli Monitoring for Web Infrastructure: iplanet Web Serer User s Guide

127 Trademarks The following terms are trademarks of International Business Machines Corporation in the United States, other countries, or both: IBM, the IBM logo, Tioli, Tioli Enterprise, Tioli Enterprise Console, and TME are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo 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 117