IBM Tivoli Management Solution for Exchange. User s Guide. Version 1.1 GC

Transcription

1 IBM Tivoli Management Solution for Exchange User s Guide Version 1.1 GC

2

3 IBM Tivoli Management Solution for Exchange User s Guide Version 1.1 GC

4 IBM Tivoli Management Solution for Exchange Copyright Notice Copyright IBM Corporation 2002 All rights reserved. May only be used pursuant to a Tivoli Systems Software License Agreement, an IBM Software License Agreement, or Addendum for Tivoli Products to IBM Customer or License Agreement. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual, or otherwise, without prior written permission of IBM Corporation. IBM Corporation grants you limited permission to make hardcopy or other reproductions of any machine-readable documentation for your own use, provided that each such reproduction shall carry the IBM Corporation copyright notice. No other rights under copyright are granted without prior written permission of IBM Corporation. The document is not intended for production and is furnished as is without warranty of any kind. All warranties on this document are hereby disclaimed, including the warranties of merchantability and fitness for a particular purpose. U.S. Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corporation. Trademarks IBM, the IBM logo, Tivoli, the Tivoli logo, AIX, Cross-Site, NetView, OS/2, Planet Tivoli, RS/6000, Tivoli Certified, Tivoli Enterprise, Tivoli Ready, and TME are trademarks or registered trademarks of International Business Machines Corporation or Tivoli Systems Inc. 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. Other company, product, and service names may be trademarks or service marks of others. Notices References in this publication to Tivoli Systems or IBM products, programs, or services do not imply that they will be available in all countries in which Tivoli Systems or IBM operates. Any reference to these products, programs, or services is not intended to imply that only Tivoli Systems or IBM products, programs, or services can be used. Subject to valid intellectual property or other legally protectable right of Tivoli Systems or IBM, any functionally equivalent product, program, or service can be used instead of the referenced product, program, or service. The evaluation and verification of operation in conjunction with other products, except those expressly designated by Tivoli Systems or IBM, are the responsibility of the user. Tivoli Systems or IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to the IBM Director of Licensing, IBM Corporation, North Castle Drive, Armonk, New York , U.S.A.

5 Contents About this guide vii Who should read this guide vii What this guide contains vii Publications viii Related publications viii Accessing publications online viii Ordering publications ix Providing feedback about publications.... ix Accessibility ix Contacting customer support ix Conventions used in this guide x Typeface conventions x Chapter 1. Product Overview IBM Tivoli Management Solution for Exchange product architecture Tier one: rules Tier two: data store Tier three: Tivoli Event Monitor and Tivoli Reporting and Graphing IBM Tivoli Management Solution for Exchange components Chapter 2. Installing IBM Tivoli Management Solution for Exchange.. 5 Installation overview Preparing for installation Installing Microsoft Data Access Component Installing local full or agent IBM Tivoli Management Solution for Exchange Installing remote full or agent IBM Tivoli Management Solution for Exchange Installing Tivoli Web Event Monitor Installing SendTEC Uninstalling IBM Tivoli Management Solution for Exchange Chapter 3. Working with the Tivoli Enterprise Manager Tivoli Enterprise Manager views Tivoli Enterprise Manager and the network Customizing the Tivoli Enterprise Manager behavior options Changing the Source Rule Computer Finding IBM Tivoli Management Solution for Exchange in the network Refreshing the network view Using the Tivoli Configuration Manager Chapter 4. Managing processes Displaying the Manage Processes dialog box and selecting a process Viewing process information Starting and stopping processes Performing operations on processes Creating processes Chapter 5. Managing rules Displaying the Manage Rules dialog box and selecting a rule Firing a rule Enabling or disabling a rule Viewing rule information Managing rules within a process Chapter 6. Managing solutions Displaying the Tivoli Solutions Manager Adding and removing solutions Setting Tivoli Solutions Manager options Editing solution variables Chapter 7. Working with the Tivoli Rule Designer Creating a new rule using the New Rule Wizard.. 82 Scheduling rules Managing rule selections Managing rule conditions Managing rule actions Documenting a rule Editing rules graphically using the Tivoli Rule Designer Creating rules manually using the Tivoli Rule Editor Editing rules manually using the Tivoli Rule Editor 107 Chapter 8. Working with the Tivoli Statistics Builder Understanding statistic domains Working with statistic domains Importing and exporting statistic domains Copying statistic domains Working with performance monitor statistic domains Working with ASCII file statistic domains Working with ODBC database statistic domains 121 Working with SNMP statistic domains Working with COM statistic domains Chapter 9. Managing events Understanding events in the Tivoli Event Monitor 129 Accessing and understanding the Tivoli Event Monitor window Filtering events in Tivoli Event Monitor Setting event alerts in Tivoli Event Monitor Configuring settings and filters in the Event Configuration Manager Sending and receiving events between computers 159 Managing events with Tivoli Web Event Monitor 165 iii

6 Chapter 10. Reporting and graphing 173 Understanding reports and graphs in the Tivoli Reporting and Graphing Manager Creating a report Exporting a report Creating a graph Customizing graphs Exporting a graph Creating batch reports and graphs Managing the batch folders Customizing views of reports and graphs Appendix A. Command line Using the command line interface Command line parameters and syntax Return values Commands RoboMon /Ra RoboMon /Rd RoboMon /Re RoboMon /Rk RoboMon /Rl RoboMon /Rp RoboMon /Rr RoboMon /Rs RoboMon /Rv RoboMon /Sk RoboMon /Sp RoboMon /Ss RoboMon /Vd RoboMon /Vp RoboMon /Vw RoboMon /Ps Appendix B. Troubleshooting Installation Installing IBM Tivoli Management Solution for Exchange Starting Tivoli services Starting Tivoli Event Service Simple Network Management Protocol Open Database Connectivity Error messages during remote installation Setting up Microsoft Exchange Events and databases Tivoli Event Service - Jet database Tivoli Event Service using excessive central processing unit capacity Large event database Routing events across the network Diagnosing problems in the Tivoli Remote Event Service Diagnosing problems in the Tivoli Event Service 217 Untrusting domains and workgroups Untrusting domains Management functions Event and performance data forwarding One-way trust relationships Management functions Event and performance data forwarding Workgroups Installing to computers in a workgroup Managing remote computers in a workgroup 219 Forwarding events and performance data in workgroups Managing event and performance data forwarding between a workgroup and a domain General product notes IBM Tivoli Management Solution for Exchange databases Converting IBM Tivoli Management Solution for Exchange databases to SQL Servers Compacting IBM Tivoli Management Solution for Exchange databases IBM Tivoli Management Solution for Exchange and TCP/IP Network adapter TCP/IP host names TCP/IP port numbers Forcing remote procedure call connections to use TCP/IP IBM Tivoli Management Solution for Exchange rules Execution of multiple one-shot rules Variable usage in asynchronous rules IBM Tivoli Management Solution for Exchange services Uninstalling IBM Tivoli Management Solution for Exchange Miscellaneous Tivoli Statistics Builder Issues with Tivoli Enterprise Manager Service 222 Issues with Microsoft Internet Information Server Microsoft Exchange mail action IBM Tivoli Management Solution for Exchange rate statistics Central processing unit statistics on Windows 2000 computers Windows NT errors DISK_READ_PCT and DISK_WRITE_PCT statistic values EVT_DATE and EVT_TIME statistic values Error when loading a dynamic link library during an upgrade installation Adding columns or tables to performance databases Security for IBM Tivoli Management Solution for Exchange files Maximum number of IBM Tivoli Management Solution for Exchange rule processes IP address for a computer name Defining timeout values for IP_REACHABLE 225 Defining community name and timeout value for DHCP statistics Large icon view Appendix C. Rules syntax Structure of the rules Conditions iv IBM Tivoli Management Solution for Exchange: User s Guide

7 CONDITION statement Expressions Expression functions Expression operators Actions The ACTION statement Schedules Selections Rule syntax Metacharacters Case-sensitivity Quoted text General file statements Including statements from another file Macros Symbol substitution Predefined symbols Predefined variables Object definitions SET VARIABLE TEXT_BLOCK SCHEDULE SELECT RULE Actions EVENT Appendix D. Action list APPEND CALCULATE CHECK_BOUNDS CLOSE COPY CREATE DECREMENT DELETE DISABLE ENABLE EVENT TYPE=MESSAGE EVENT TYPE=PROBLEM EVENT TYPE=TEXT EVENT TYPE=WINDOWS EXECUTE EXECUTE_SQL EXIT EXPORT IF INCREMENT LOG MAIL MODIFY PRIORITY READ REMOVE SNMP_SET SNMP_TRAP TERMINATE WAIT WORKING_SET WRITE ZERO Glossary Glossary Index Contents v

8 vi IBM Tivoli Management Solution for Exchange: User s Guide

9 About this guide Who should read this guide What this guide contains The IBM Tivoli Management Solution for Exchange User s Guide describes how to install and use the software to manage computer resources. The objectives of this guide include the following: v Define IBM Tivoli Management Solution for Exchange and how it can improve delivery of information technology services v Outline basic IBM Tivoli Management Solution for Exchange capabilities, implementation options, directory structure, and components v Install and deploy IBM Tivoli Management Solution for Exchange v Customize IBM Tivoli Management Solution for Exchange by editing existing rules and optionally defining site-specific rules v Provide information on where to obtain help with IBM Tivoli Management Solution for Exchange This guide is intended for system administrators who need to implement, use, or support IBM Tivoli Management Solution for Exchange. It explains the concepts you must know to use the IBM Tivoli Management Solution for Exchange product and how IBM Tivoli Management Solution for Exchange is integrated into the Tivoli environment. Readers of this guide should have prior knowledge of the Windows NT or Windows 2000 operating system, the Tivoli environment, and Exchange administration. This guide contains the following sections: v Chapter 1, Product Overview on page 1 Provides an overview of IBM Tivoli Management Solution for Exchange features. v Chapter 2, Installing IBM Tivoli Management Solution for Exchange on page 5 Provides installation procedures for IBM Tivoli Management Solution for Exchange and related software programs. v Chapter 3, Working with the Tivoli Enterprise Manager on page 41 Provides an explanation of the Tivoli Enterprise Manager features and step-by-step instructions for related procedures. v Chapter 4, Managing processes on page 55 Provides an explanation of the processes concepts and step-by-step instructions for related procedures. v Chapter 5, Managing rules on page 65 Provides an explanation of the rules concepts and step-by-step instructions for related procedures. v Chapter 6, Managing solutions on page 73 Provides information about controlling the execution of Tivoli solutions on a network and step-by-step instructions for related procedures. v Chapter 7, Working with the Tivoli Rule Designer on page 81 vii

10 Provides information about Tivoli rules, including how to create and modify rules. v Chapter 8, Working with the Tivoli Statistics Builder on page 111 Provides an explanation of the processes and concepts of the Tivoli Statistics Builder and step-by-step instructions for related procedures. v Chapter 9, Managing events on page 129 Provides an explanation of managing events in IBM Tivoli Management Solution for Exchange by using the Tivoli Event Monitor and the Tivoli Event Configuration Manager. v Chapter 10, Reporting and graphing on page 173 Provides an explanation of how to create reports and graphs using Tivoli Reporting and Graphing. v Appendix A, Command line on page 195 Provides information on how to use the command line interface for IBM Tivoli Management Solution for Exchange. v Appendix B, Troubleshooting on page 213 Provides information on how to troubleshoot problems that can arise during normal operations of IBM Tivoli Management Solution for Exchange. v Appendix C, Rules syntax on page 227 Provides descriptions of the features and capabilities of Tivoli rules. v Appendix D, Action list on page 263 Provides explanations of the actions used for IBM Tivoli Management Solution for Exchange. v Glossary on page 319 Provides a description of terminology used in IBM Tivoli Management Solution for Exchange. Publications This section lists publications in the IBM Tivoli Management Solution for Exchange library and any other related documents. It also describes how to access Tivoli publications online, how to order Tivoli publications, and how to submit comments on Tivoli publications. Related publications The Tivoli Glossary includes definitions for many of the technical terms related to Tivoli software offered by IBM. The Tivoli Glossary is available, in English only, at the following Web site: Accessing publications online When IBM publishes an updated version of one or more online or hardcopy publications, they are posted to the Tivoli Information Center. You can access updated publications in the Tivoli Information Center from the following Tivoli Customer Support Web site: viii IBM Tivoli Management Solution for Exchange: User s Guide

11 Accessibility The Tivoli Information Center contains the most recent version of the books in the product library in PDF or HTML formats, or both. Translated documents are also available for some products. If you print PDF documents on other than letter-sized paper, select the Fit to page check box in the Adobe Acrobat Print dialog. Access this dialog 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 Tivoli publications online at the following Web site: You can also order by telephone by calling one of these numbers: v In the United States: v In Canada: For a list of telephone numbers in other countries, see the following Web site: order.html Providing feedback about publications We are very interested in hearing about your experience with Tivoli products and documentation, and we welcome your suggestions for improvements. If you have comments or suggestions about our products and documentation, contact us in one of the following ways: v v Send an to pubs@tivoli.com Contacting customer support Complete our customer feedback survey at the following Web site: Accessibility features help a user who has a physical disability, such as restricted mobility or limited vision, to use software products successfully. With this product, you can use assistive technologies to hear and navigate the interface. You can also use the keyboard instead of the mouse to operate all features of the graphical user interface. If you have a problem with any Tivoli product, you can contact Tivoli Customer Support. See the Tivoli Customer Support Handbook at the following Web site: The handbook provides information about how to contact Tivoli Customer Support, depending on the severity of your problem, and the following information: v Registration and eligibility v v Telephone numbers and addresses, depending on the country in which you are located What information you should gather before contacting support About this guide ix

12 Conventions used in this guide Typeface conventions This guide uses several typeface conventions for special terms and actions. These conventions have the following meaning: Bold Lowercase and mixed-case commands, command options, and flags that appear within text appear like this in bold type. Graphical user interface elements and names of keys also appear like this in bold type. Italic Variables, values you must provide, new terms, and words and phrases that are emphasized appear like this in italic. Monospace Commands, command options, flags that appear on a separate line, code examples, output, and message text appear like this in Monospace. x IBM Tivoli Management Solution for Exchange: User s Guide

13 Chapter 1. Product Overview The IBM Tivoli Management Solution for Exchange product complements existing Exchange tools and adds features for managing large numbers of Exchange servers and databases in a distributed environment. The software uses autonomous agents running on each monitored server called intelligent solution sets, or rules, to detect and correct application problems. IBM Tivoli Management Solution for Exchange can monitor and take appropriate actions for a wide variety of operating system, network, database and application problems. For example, the software can detect a hung database server, shut it down, and restart it. Use IBM Tivoli Management Solution for Exchange to do the following: v Monitor a running computer for application problems v Detect and solve problems before users experience failures v Use rules to take appropriate corrective action v Check results of corrective action and escalate corrections and notifications until the problem is solved IBM Tivoli Management Solution for Exchange product architecture This section describes the three-tiered architecture of IBM Tivoli Management Solution for Exchange. Tier one: rules The first tier consists of the IBM Tivoli Management Solution for Exchange Intelligent Solution Sets (ISS) or rules. An IBM Tivoli Management Solution for Exchange rule operates as an autonomous agent that monitors each server. It is a named entity that is used to monitor a specific situation and take corrective action, and perform external notification. Rules consist of the following four major components: 1. The schedule that defines when the rule executes 2. The selections that define the entities (disks, files, processes) that the rules should examine 3. The conditions that the rule must monitor 4. The actions that the rule must take based on the condition Use the Tivoli Rule Designer to write and test individual Tivoli rules. You can invoke the Tivoli Rule Designer from the Tivoli Enterprise Manager to write new rules or modify existing rules. Tier two: data store The second tier consists of the data store where events are generated and routed through the Tivoli Event Configuration Manager. In the second tier, rules forward events detected in tier one to an ODBC-compliant database or multiple databases for centralized monitoring. An event occurs when an IBM Tivoli Management Solution for Exchange rule detects that user-specified criteria is met. For example, a critical service that stopped running generates an event. The Tivoli Event Configuration Manager automatically routes events between computers as instructed so that events can be consolidated for real-time centralized monitoring 1

14 or for remote actions. Events are routed in real-time with guaranteed delivery using a store and forward technology to ensure that initially undeliverable events are eventually delivered. Tier three: Tivoli Event Monitor and Tivoli Reporting and Graphing The third tier consists of the Tivoli Enterprise Manager, Tivoli Event Monitor, and Tivoli Reporting and Graphing user interfaces. Tivoli Enterprise Manager provides command and control of rules while the Tivoli Event Monitor and Tivoli Reporting and Graphing extract and display or report data real time from the database or databases. The Tivoli Event Monitor enables real time notification of all events throughout the Tivoli Enterprise Manager. Tivoli Reporting and Graphing uses Crystal Reports and Pinnacle BPS Graphic control to provide interactive batch reporting and graphing capabilities. You can launch multiple Tivoli Event Monitor and Tivoli Reporting and Graphing interfaces. IBM Tivoli Management Solution for Exchange components All of the following IBM Tivoli Management Solution for Exchange components are supplied on the product CD and are automatically installed as part of the product with the full installation option. For more information on installation options, see Chapter 2, Installing IBM Tivoli Management Solution for Exchange on page 5. Tivoli Enterprise Manager The Tivoli Enterprise Manager is a graphical interface that you can use to manage the IBM Tivoli Management Solution for Exchange throughout the network from one central location. Tivoli Event Monitor The Tivoli Event Monitor is a graphical interface that you can use to monitor events across the network in real time. You can invoke the Tivoli Event Monitor from the Tivoli Enterprise Manager by clicking on the Tivoli Event Monitor icon on the toolbar, or by selecting Tivoli Event Monitor from the Run drop-down menu. Tivoli Reporting and Graphing Tivoli Reporting and Graphing generates a variety of reports and graphs on performance data, events, and problems. You can invoke Tivoli Reporting and Graphing from the Tivoli Enterprise Manager by clicking the Tivoli Reporting and Graphing icon on the toolbar or by selecting Tivoli Reporting and Graphingfrom the Run drop-down menu. Tivoli Solutions Manager Tivoli Solutions Manager enables you to tailor thresholds and selections of a running process without changing the process rule code and without stopping and restarting the process. Examples of tailoring are changing the CPU busy percentage threshold from 85% to 90% or changing the set of processes to check that they are functioning properly. You can invoke the Tivoli Solutions Manager from the Tivoli Enterprise Manager by clicking the Tailor Tivoli Solutions icon in the toolbar or by selecting Tailor Solutions... from the Manage drop-down menu. Tivoli Event Configuration Manager The Tivoli Event Configuration Manager is also called the Event Server. Tivoli Event Configuration Manager automatically routes events between computers, so that events can be consolidated for real time centralized monitoring or for remote actions. You can invoke the Tivoli Event 2 IBM Tivoli Management Solution for Exchange: User s Guide

15 Configuration Manager from the Tivoli Enterprise Manager by clicking the Configure the Event Server icon on the toolbar or by selecting Event Server... from the Manage drop-down menu. Tivoli Configuration Manager The Tivoli Configuration Manager provides complete management and control of the configuration settings on any managed computer in the network. You can invoke the Tivoli Configuration Manager from the Tivoli Enterprise Manager toolbar by clicking the Configure Tivoli icon or by selecting Configuration... from the Manage drop-down menu. Tivoli Rule Designer The Tivoli Rule Designer is a graphical tool that enables you to write and test individual Tivoli rules. You can invoke the Tivoli Rule Designer from the Tivoli Enterprise Manager toolbar by clicking the Run the Tivoli Rule Designer icon or by selecting Tivoli Rule Designer... from the Run drop-down menu. Tivoli Statistics Builder The Tivoli Statistics Builder is a tool that enables you to define Tivoli statistics from the Windows NT Performance Monitor database, an ASCII file, an ODBC database, or SNMP variables. A statistic is a named value that you can use in Tivoli rules. You can invoke the Tivoli Statistics Builder from the Tivoli Enterprise Manager toolbar by clicking the Create Tivoli Statistics icon or by selecting Statistics... from the Manage drop-down menu. IBM Tivoli Management Solution for Exchange Command Line The IBM Tivoli Management Solution for Exchange command line executable is named RoboMon.exe, and is located in the bin subdirectory under the main installation directory. To execute commands, you must add this directory to your path or include the path in the command. You can add a directory to your path from the environment tab in the control panel s system applet. Chapter 1. Product Overview 3

16 4 IBM Tivoli Management Solution for Exchange: User s Guide

17 Chapter 2. Installing IBM Tivoli Management Solution for Exchange This chapter describes how to install IBM Tivoli Management Solution for Exchange and additional software programs to enhance the functions of IBM Tivoli Management Solution for Exchange. Note: The term IBM Tivoli Management Solution for Exchange and the term Tivoli Enterprise Management Solutions are used interchangeably in the product. Table 1 provides an overview of the topics covered in this chapter: Table 1. Guidelines for Installing IBM Tivoli Management Solution for Exchange Goal Refer to 1. Understanding the different IBM Tivoli Management Solution for Exchange and related software installations Installation overview on page 5 2. Preparing system and hardware requirements for installation of IBM Tivoli Management Solution for Exchange 3. Installing Microsoft Data Access Component (MDAC) as a prerequisite to IBM Tivoli Management Solution for Exchange installation 4. Installing a full or agent version of IBM Tivoli Management Solution for Exchange on a local machine 5. Installing a full or agent version of IBM Tivoli Management Solution for Exchange on a remote machine 6. Installing Tivoli Web Event Monitor on a local machine Preparing for installation on page 6 Installing Microsoft Data Access Component on page 10 Installing local full or agent IBM Tivoli Management Solution for Exchange on page 12 Installing remote full or agent IBM Tivoli Management Solution for Exchange on page 22 Installing Tivoli Web Event Monitor on page Installing SendTEC on a local machine Installing SendTEC on page Uninstalling IBM Tivoli Management Solution for Exchange to remove the product files Uninstalling IBM Tivoli Management Solution for Exchange on page 40 Installation overview IBM Tivoli Management Solution for Exchange is designed to run on computers that are part of the same domain or on computers in different domains when these domains have a full two-way trust relationship. Not all of the features of IBM Tivoli Management Solution for Exchange work between partially trusted domains. IBM Tivoli Management Solution for Exchange provides two types of installations: full and agent. A full installation installs the entire product with a graphical user interface (GUI). Full installation is recommended for complete management capabilities, including 5

18 Preparing for installation Rule Engine, Reporting and Graphing, and Event Monitoring. When a full installation is complete, you can push installations out to other computers using the remote installation. An agent installation installs the Rule Engine to provide monitoring capabilities, but does not install a GUI. Agent versions of IBM Tivoli Management Solution for Exchange require no intervention by the user of the computer running the agent version. Agent installations require less space on a computer than a full installation. Computers with agent installations must be controlled from a computer running the full installation. You can perform agent installs on new installs or over existing agents, but not over a full installation. IBM Tivoli Management Solution for Exchange offers two methods of performing installations: local and remote. A local installation is performed on a local computer. A local computer is a computer that you access directly, not through a network or modem. You run a setup file from a CD-ROM that is inserted into that computer. Local installations can install full or agent versions of IBM Tivoli Management Solution for Exchange. A remote installation is pushed out from a computer in a trusted domain to a computer in a trusting domain. The computer receiving the remote install must set permissions allowing the installation. Remote installations can install full or agent versions of IBM Tivoli Management Solution for Exchange. You can use a Web browser to manage IBM Tivoli Management Solution for Exchange events by installing IBM Tivoli Management Solution for Exchange Web Event Monitor. You can send IBM Tivoli Management Solution for Exchange events to Tivoli Enterprise Console by installing SendTEC. SendTEC translates and sends events from IBM Tivoli Management Solution for Exchange to Tivoli Enterprise Console. IBM Tivoli Management Solution for Exchange supports Microsoft Systems Management Server software distributions. Microsoft Systems Management Server provides unattended installation. This section describes the hardware and software requirements for IBM Tivoli Management Solution for Exchange and the preparations you must complete before installation. The following table lists the system, software, and hardware requirements for installing and deploying IBM Tivoli Management Solution for Exchange: Table 2. System Requirements, IBM Tivoli Management Solution for Exchange Full Install Agent Install Operating System v Windows NT 4.0 service pack 5 or higher OR Processor v Windows 2000 on Intel hardware only Pentium: 200 Megahertz or faster v v Windows NT 4.0 service pack 3 or higher OR Windows 2000 on Intel hardware only Pentium: 200 Megahertz or faster 6 IBM Tivoli Management Solution for Exchange: User s Guide

19 Table 2. System Requirements, IBM Tivoli Management Solution for Exchange (continued) Full Install Agent Install Memory 60 MB minimum 60 MB minimum Disk Space 61 MB of free disk space (approximately) 30 MB of free disk space (approximately) Page File Space 50 MB free space minimum 60 MB free space minimum To check the free page file space, press CTRL + ALT + DEL to open the task manager, go to the Performance tab, and check Mem Usage on the status bar at the bottom of the window. The free page file space is the difference between the two numbers displayed. Display Network Required Software Color display with a minimum resolution of 640x480 The TCP/IP protocol must be available Microsoft Data Access Component/Jet Full installation requires Microsoft Data Access Component to fully operate. For installation instructions, see Installing Microsoft Data Access Component on page 10 Note: Microsoft Data Access Component 2.6 does not include Access Drivers which must be installed separately. Not Applicable The TCP/IP protocol must be available v v ODBC Driver for Access OR Jet You might need to install Microsoft Jet on computers that have an agent installation. Optional: Use the planning sheet in Table 3 on page 8 to prepare information required for a local installation. Optional: Use the planning sheet in Table 4 on page 9 to prepare information required for a remote installation. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 7

20 Table 3. Local Installation Planning Sheet Name Platform Domain Account Password Destination (Optional) SMTP Mail Server (Optional) Microsoft Exchange Profile Name Name of the local computer on which IBM Tivoli Management Solution for Exchange software is to be installed Operating system of the local computer Domain of the user on the local computer Account name for the user on the local computer Corresponding password for the user on the local computer Path on the local computer where the IBM Tivoli Management Solution for Exchange software is to be installed Name of the SMTP mail server for SMTP mail service Microsoft Exchange Profile name for Microsoft Exchange mail service 8 IBM Tivoli Management Solution for Exchange: User s Guide

21 Table 4. Remote Installation Planning Sheet Name Platform Domain Account Password Destination (Optional) SMTP Mail Server (Optional) Microsoft Exchange Profile Name Name of the local computer on which IBM Tivoli Management Solution for Exchange software is installed Operating system of the remote computer Domain of the user performing the remote installation Account name for the user performing the remote installation Corresponding password for the user performing the remote installation Path on the local computer where the IBM Tivoli Management Solution for Exchange software is installed Name of the SMTP mail server for SMTP mail service Microsoft Exchange Profile name for Microsoft Exchange mail service Chapter 2. Installing IBM Tivoli Management Solution for Exchange 9

22 Installing Microsoft Data Access Component Objective To install Microsoft Data Access Component on a workstation so you can perform a full installation of IBM Tivoli Management Solution for Exchange. Background information IBM Tivoli Management Solution for Exchange full installations require Microsoft Data Access Component to obtain the driver for Access. Install Microsoft Data Access Component or higher before a full install of IBM Tivoli Management Solution for Exchange. IBM Tivoli Management Solution for Exchange agent installations need an Access driver, but do not need the entire Microsoft Data Access Component product to operate. If you do not wish to install the entire Microsoft Data Access Component product, but need an ODBC driver, you can install Microsoft Jet, the Microsoft Jet OLE DB Provider. Note: Microsoft Data Access Component version 2.6 does not include Microsoft Jet, the Microsoft Jet OLE DB Provider. To install Microsoft Jet, download the program from the Microsoft web site. Terminal Server computers that need an installation of IBM Tivoli Management Solution for Exchange have separate instructions for installing Microsoft Data Access Component. Find instructions for installing Microsoft Data Access Component to Terminal Server computers in Microsoft Knowledge Base article Q Before you begin Check your computer for Microsoft Data Access Component or a Microsoft Access Driver. For Windows NT, go to Settings Control Panel ODBC Drivers for Microsoft Access Driver. For Windows 2000, go to Settings Control Panel Administrative Tools Data Sources. If your system already is installed with Microsoft Data Access Component or a Microsoft Access Driver, you can begin installation of IBM Tivoli Management Solution for Exchange. When you finish Proceed with installation of IBM Tivoli Management Solution for Exchange. See Installing local full or agent IBM Tivoli Management Solution for Exchange on page 12 for installation instructions. Procedure 1. Close all running applications. 2. Insert the product CD-ROM for IBM Tivoli Management Solution for Exchange. Note: The term IBM Tivoli Management Solution for Exchange and the term Tivoli Enterprise Management Solutions are used interchangeably in the product. 3. Double-click the CD-ROM drive to display the CD-ROM contents. 4. Check the CD-ROM for a directory called Microsoft Data Access Component: v No, Microsoft Data Access Component is not on the CD-ROM: Download Microsoft Data Access Component from the Microsoft Web site and go to Step 5. OR v Yes, Microsoft Data Access Component is on the CD-ROM: Go to Step IBM Tivoli Management Solution for Exchange: User s Guide

23 5. Double-click the mdac.exe file to display the Microsoft Data Access 2.1 License Agreement screen. 6. Click Yes in the license screen to display the Microsoft Data Access 2.1 Setup screen. 7. Choose Continue on the Microsoft Data Access 2.1 Setup screen to display the Microsoft Data Access 2.1 Setup screen. 8. Click on the large icon to begin installation of Microsoft Data Access Component. The following screen displays upon successful installation. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 11

24 Installing local full or agent IBM Tivoli Management Solution for Exchange Objective To do a full or agent installation of IBM Tivoli Management Solution for Exchange on a local computer so you can monitor running Windows NT systems to detect and correct system and application problems. Background information For an understanding about local IBM Tivoli Management Solution for Exchange installations, see Installation overview on page 5. Before you begin You must install Microsoft Data Access Component for a full installation of IBM Tivoli Management Solution for Exchange to operate. For Microsoft Data Access Component installation instructions, see Installing Microsoft Data Access Component on page 10. You must know the user domain, account, and password to complete account information during installation of IBM Tivoli Management Solution for Exchange. When you finish You can change configuration information at any time after installation using the Tivoli Configuration Manager. No system restart is necessary following installation of IBM Tivoli Management Solution for Exchange. Service Packs perform future upgrades. Procedure 1. Close all running applications. 2. Insert the product CD-ROM. 3. Double-click the CD-ROM drive to display the CD-ROM contents. 4. Open the Tivoli Enterprise Management Solutions folder. Note: The term IBM Tivoli Management Solution for Exchange and the term Tivoli Enterprise Management Solutions are used interchangeably in the product. 5. Optional: Double-click the Readme.hlp file to read additional information about installation. 12 IBM Tivoli Management Solution for Exchange: User s Guide

25 6. Double-click the Setup.exe file to display the Welcome screen. Additional Information: IBM Tivoli Management Solution for Exchange generates an installation log that logs the entire install process. You can check installation progress in the C:\Program files\tems\tivoliinstalllog.txt file. 7. Click Next on the Welcome screen to display the Software License Agreement screen. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 13

26 8. Click Yes on the Software License Agreement screen to display the Choose Destination Location screen. 9. Review the displayed location in the Destination Folder field and do one of the following: v Click Next to install IBM Tivoli Management Solution for Exchange to the location displayed in the Destination Folder field and display the Setup Type screen. Go to Step 10. OR v Choose a different location by doing the following: a. Click Browse. b. Choose another destination. c. Click OK. d. Click Next to install IBM Tivoli Management Solution for Exchange to the directory displayed in the Destination Folder field and display the Setup Type screen. 10. Click one of the following on the Setup Type screen: v Full to install the entire product including a GUI. 14 IBM Tivoli Management Solution for Exchange: User s Guide

27 v OR Agent to install monitoring capabilities without a GUI. Additional Information: A full installation installs the entire product with a graphical user interface (GUI). Full installation is recommended for complete management capabilities, including Rule Engine, Reporting and Graphing, and Event Monitoring. When a full installation is complete, you can push installations out to other computers using the remote installation. An agent installation installs the Rule Engine to provide monitoring capabilities, but does not install a GUI. Agent versions of IBM Tivoli Management Solution for Exchange require no intervention by the user of the computer running the agent version. Agent installations require less space on a computer than a full installation. Computers with agent installations must be controlled from a computer running the full installation. You can perform agent installs on new installs or over existing agents, but not over a full installation. 11. Click Next on the Setup Type screen to display the Select Program Folder screen. 12. Do one of the following to name the program folder: Note: The term IBM Tivoli Management Solution for Exchange and the term Tivoli Enterprise Management Solutions are used interchangeably in the product. v Click Next on the Select Program Folder screen to keep the default folder name and display the Rules and Rule Processes screen. OR v Choose a different program folder name by doing the following: a. Type the new folder name in the Program Folders text box. b. Click Next on the Select Program Folder screen to display the Rules and Rule Processes screen. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 15

28 13. Click one of the following Rules and Rule Processes options: v Install the newest Tivoli supplied rules and rule processes, replacing any existing rules and rule processes of the same name Choose this option if you have no existing rules, or to replace previous rules and rule processes. After installation, only the newest Tivoli supplied rules and rule processes are present. OR v Install the newest Tivoli supplied rules and rule processes, but keep a copy of any existing rules and rule processes of the same name Choose this option to save previously set rules and rule processes and to install the newest rules and rule processes. OR v Leave existing versions of Tivoli supplied rules and rule processes, and do not replace them with newer versions Choose this option to keep only the previous rules and rule processes without installing new rules and rule processes. 16 IBM Tivoli Management Solution for Exchange: User s Guide

29 14. Click Next on the Rules and Rule Processes screen to display the Start Copying Files screen. 15. Click Next on the Start Copying Files screen to accept the current settings and display the Tivoli Enterprise Management Solution Configuration screen. 16. Click Next on the Tivoli Enterprise Management Solutions Configuration screen to display the Configuration: Existing Account Information screen. 17. Enter the following account information in the text fields on the Configuration: Existing Account Information screen: Note: Enter the account information that IBM Tivoli Management Solution for Exchange uses to access local and remote systems. The specified account must have appropriate rights. Domain Type the domain containing the user account for the installation. Account Type the user account name. This field is case-sensitive. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 17

30 Password Type the corresponding password for the user account. 18. Click Next on the Configuration: Existing Account Information screen to display the Configuration: Mail Service Information screen. 19. Click one of the following options to reports from the reporting facility: v No Mail Service provides no mail notification and no Exchange mailbox statistics. Click Next and go to Step 22. OR v SMTP Mail provides mail notification, but no Exchange mailbox statistics. Click Next and go to Step 20. OR v Microsoft Exchange provides both mail notification and Exchange mailbox statistics. See Note below. Click Next and go to Step 21. Note: You must configure the mail action for Microsoft Exchange on every computer where the mail action is used. This is also required for the collection of Exchange mailbox and folder statistics. For instructions on configuring Microsoft Exchange, see Setting up Microsoft Exchange on page Optional for SMTP Mail: Do the following to configure IBM Tivoli Management Solution for Exchange to accept SMTP mail. a. Type the name of the mail server in the text box. b. Click Next to accept the mail server name. c. Go to Step IBM Tivoli Management Solution for Exchange: User s Guide

31 21. Optional for Exchange Mail: Do the following to configure IBM Tivoli Management Solution for Exchange to accept Exchange mail: a. Type the Profile Name in the Profile Name text box. b. Click Next to accept the Profile Name. c. Go to Step 22. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 19

32 22. Click any rules from the Configuration: AutoStart Rules screen to automatically start every time your system restarts. Additional Information: Installation detects applications on your system and presents a corresponding set of rules for each application. IBM Tivoli Management Solution for Exchange rules are used to monitor hardware and software components on your computer and can take actions based on the conditions found. After installation, the rules you select for automatic start begin executing. 23. Click Next to display the Configuration Information: Complete screen. 20 IBM Tivoli Management Solution for Exchange: User s Guide

33 24. Click Next to display the Setup Complete screen. 25. Click Finish to display the installed folders in your chosen directory. Installation is complete. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 21

34 Installing remote full or agent IBM Tivoli Management Solution for Exchange Objective To do a full or agent installation of IBM Tivoli Management Solution for Exchange on remote computers from a central location so you run monitoring functions across remote computers. Background information Cross-domain remote installations follow the same security rules as accessing any resource in a remote, trusting domain. Note: You cannot perform remote installations from a trusting domain to a trusted domain. Before you begin Verify your network speed. If it is 10 MB or less, a local installation from the CD-ROM can be faster than a remote installation. You can push out remote installations only from a full local installation. See Installing local full or agent IBM Tivoli Management Solution for Exchange on page 12 for full local installation instructions. When you finish You can change configuration information at any time after the installation using the Tivoli Configuration Manager. Procedure 1. Establish a trusted domain relationship between the domains of the local and remote computers. 2. On the remote computer, do one of the following to grant administrator privileges to the user of the initiating computer: v Windows NT Desktop: a. Click Start in the Windows taskbar to display the Start menu. b. Select Programs in the Start menu to display the Programs menu. c. Select Administrative Tools (Common) in the Programs menu to display the Administrative Tools (Common) menu. d. Click User Manager in the Administrative Tools (Common) menu to access the User Manager window. e. Select the user you want to modify in the Username list. f. Add the user to the Administrators group as follows: 1) Double-click the user name to access the Users Properties window. 2) Click the Groups button to access the Group Memberships dialog box. 3) Select Administrators in the Not member of list. 4) Click Add to move Administrators to the Member of list. 5) Click OK to return to the Users Properties window. 6) Click OK to save your changes and return to the User Manager window. v OR Windows 2000 Desktop: 22 IBM Tivoli Management Solution for Exchange: User s Guide

35 a. Click Start in the Windows taskbar to display the Start menu. b. Select Settings from the Start menu to display the Settings menu. c. Select Control Panel from the Settings menu to display the Control Panel menu. d. Double-click Users and Passwords from the Control Panel menu to access the Users and Passwords window. e. Click Advanced from the Users and Passwords window to display the Advanced tab. f. Click Advanced in the Advanced User Management field to display the Local Users and Groups screen. g. Double-click the Groups folder under Local Users and Groups (Local). h. Double-click Administrators to display the Administrators Properties screen. i. Click Add to display the Select Users or Groups screen. j. Select the user who will run the installation for IBM Tivoli Management Solution for Exchange from the Name list. k. Click Add. l. Click OK to return to the Administrator Properties screen. m. Click OK to save the administrator group assignments. 3. Log on to the local computer running a full installation of IBM Tivoli Management Solution for Exchange to begin the remote installation. Note: Log on to the local computer with the account information that was granted privileges on the remote computers as described in Step Open IBM Tivoli Management Solution for Exchange by doing the following: a. Click Start to display the Start menu. b. Click Programs from the Start menu to display the Programs menu. c. Click Tivoli Enterprise Management Solutions from the Programs menu to display the Tivoli Enterprise Management Solutions menu. d. Click Tivoli Enterprise Manager from the Tivoli Enterprise Management Solutions menu. Note: The term IBM Tivoli Management Solution for Exchange and the term Tivoli Enterprise Management Solutions are used interchangeably in the product. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 23

36 5. Click Run to display the Run menu. 6. Click Tivoli Remote Installer from the Run menu to display the Account Information screen. 7. Type the following information in the text boxes: Tivoli Installation Kit Directory: Do one of the following: v Type the path location of the IBM Tivoli Management Solution for Exchange installation CD-ROM. OR v Type the computer and path in UNC format (\\computer\directory) where the Tivoli Installation Kit Directory is located. 24 IBM Tivoli Management Solution for Exchange: User s Guide

37 Additional Information: You can browse for the location by clicking (...) to the right of the Tivoli Installation Kit Directory text box. Tivoli Location for New Installations (Upgrade Installations will keep their current location): Type the path where IBM Tivoli Management Solution for Exchange will be installed on all of the selected computers. This path is for new installations. Upgrade installations retain their current location. Domain Type the domain name of the local computer from which you are doing the remote installation. Account Type the account name that exists on the local computer and for which administrative privileges were assigned on the remote computers. Password Type the corresponding password for the account listed above. 8. Click Next on the Account Information screen to display the Computer Information screen. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 25

38 9. Click the down arrow in the Default Type of installation field to display the drop-down menu for type of installation. 10. Click one of the following installation types: v Agent OR v Full Additional Information: A full installation installs the entire product with a graphical user interface (GUI). Full installation is recommended for complete management capabilities, including Rule Engine, Reporting and Graphing, and Event Monitoring. When a full installation is complete, you can push installations out to other computers using the remote installation. An agent installation installs the Rule Engine to provide monitoring capabilities, but does not install a GUI. Agent versions of IBM Tivoli Management Solution for Exchange require no intervention by the user of the computer running the agent version. Agent installations require less space on a computer than a full installation. Computers with agent installations must be controlled from a computer running the full installation. You can perform agent installs on new installs or over existing agents, but not over a full installation. 11. Choose the target computer to receive the remote installation by doing one of the following: v Manually add a computer by doing the following: 26 IBM Tivoli Management Solution for Exchange: User s Guide

39 a. Click Add Computer to display a text box labeled A New Computer. b. Type the computer name in the text box. c. Click Add Computer. v OR Browse for a computer by doing the following: a. Click Browse to display the Add Computers screen. b. Double-click on a displayed domain in the Available Computers field to display the computers for that domain. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 27

40 c. Double-click the target computer in the Available Computers field to move that computer to the Selected Computers field. d. Click Apply. e. Click OK to add the computer. 12. Click Finish to display the Tivoli Remote Installation time commitment screen. 13. Do one of the following: 28 IBM Tivoli Management Solution for Exchange: User s Guide

41 v v Click Yes to begin remote installation. OR Click No to cancel the remote installation and return to the Tivoli Enterprise Manager screen. Additional Information: For multiple computer installations, the status bar displays progress on a per computer basis. For example, one computer of four is represented as 25%. Installations are completed one at a time. Note: Single installs often show 0% complete until it is 100% complete. You can check that the install service is running on the remote system and examine the TivoliInstallLog.txt file to verify. 14. Click OK when the installation has completed. Installing Tivoli Web Event Monitor Objective To install the IBM Tivoli Management Solution for Exchange Web Event Monitor so you can manage IBM Tivoli Management Solution for Exchange events over the Internet. Background information None. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 29

42 Before you begin Pre-installation and system requirements include: v IBM Tivoli Management Solution for Exchange, Version 1.1 or later v Microsoft Internet Information Services 4.0 or later v SQL Server 7 (SP2) or later (must use NT authentication) v v v An NT domain and user name for the designated Security administrator who can restrict access of other users Internet Explorer 4.0 or later as the browser. One of the following operating systems: Windows NT 4.0, Terminal Server Edition OR Windows 2000 Server/Advanced Server with Terminal Services enabled, running in Application Server mode When you finish Locate IBM Tivoli Management Solution for Exchange Web Event Monitor at where [SERVER] is the fully qualified DNS name of the Microsoft Internet Information Services server. Access to the IBM Tivoli Management Solution for Exchange Web Event Monitor requires an NT login accepted by the Microsoft Internet Information Services server. Anonymous access is not supported. Maximize IBM Tivoli Management Solution for Exchange Web Event Monitor by configuring all IBM Tivoli Management Solution for Exchange installations within your enterprise to forward events to the server. Procedure 1. Set Internet Explorer 4.0 Web browser settings to support Web Event Monitor by doing the following: a. Open the Internet Explorer 4.0 Web browser. b. Click Tools to display the Tools menu. 30 IBM Tivoli Management Solution for Exchange: User s Guide

43 1) Click Internet Options from the Tools menu to display the Internet Options window. 2) Click General to display the General tab. 3) Click Settings in the Temporary Internet Files field to display the Settings screen. 4) Click Every visit to the page. Additional Information: Changing this setting ensures that Tivoli Event Monitor accepts new choices since it does not use cached pages. 5) Click OK. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 31

44 c. Click Security in the Internet Options window to display the Security tab. d. Click Local Intranet Zone for the Zone selection. e. Configure the browser by doing the following: 1) Click Custom Level to display the Security Settings screen. 2) Set the following configurations in the Security Settings screen: Download signed ActiveX controls Click Prompt. Download unsigned ActiveX controls Click Prompt. 32 IBM Tivoli Management Solution for Exchange: User s Guide

45 Initialize and script ActiveX controls not marked as safe Click Prompt. Run ActiveX controls and plugins Click Enable. Script Active X controls marked safe for scripting Click Enable. Submit non-encrypted form data Click Prompt. Active scripting Click Enable. Allow cookies that are stored on your computer Click Enable. Additional Information: You must enable the browser to accept cookies for the Tivoli Web Event Monitor to work properly. 3) Click OK. f. Click Internet Zone for the Zone selection. g. Repeat Steps 1e1 through 1e3 as necessary. 2. Run the SQL Server service. Additional Information: For SQL Server 2000 installations, make sure the service for the instance you wish to install the central collection database on is running. 3. Close all running programs. 4. Locate the setup.exe file by doing one of the following: v Browse to the directory to which the IBM Tivoli Management Solution for Exchange setup kit was downloaded and extracted. OR v Browse to the directory on the IBM Tivoli Management Solution for Exchange installation CD-ROM. 5. Double-click the setup.exe file to display the Welcome Screen. 6. Click Next on the Welcome Screen to display the Software License Agreement screen. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 33

46 7. Click Yes on the Software License Agreement screen to display the Account Information screen. 8. Complete the following information: Domain: Type the domain containing the user account. Username: Type the NT login username for the security administrator of the Tivoli Web Event Monitor. Additional Information: This user is responsible for: v adding new IBM Tivoli Management Solution for Exchange Event Monitor users v adding additional security administrators v modifying security settings for existing users The default selection for this account is the user performing the installation. 9. Click Next on the Account Information screen. A Creating SQL Database screen displays followed by a Start Copying Files screen. Note: Setup can take five minutes or more. Do not interrupt the setup process. 34 IBM Tivoli Management Solution for Exchange: User s Guide

47 10. Click Next on the Start Copying Files screen to copy files and display the Setup Complete screen. Installing SendTEC 11. Click Finish on the Setup Complete Screen to complete the installation. Objective To install SendTEC so you can forward events to the Tivoli Enterprise Console. Background information SendTEC sends events to the Tivoli Enterprise Console. The Tivoli Enterprise Console combines events from IBM Tivoli Management Solution for Exchange with events from other sources making it the main point for event handling in the enterprise. By using SendTEC with Tivoli Enterprise Management Solutions you can define a complete event handling and management strategy that is set up and managed from a central location. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 35

48 SendTEC runs in the background and requires no user interface. Before you begin The following software must be installed for SendTEC to work properly: v IBM Tivoli Management Solution for Exchange v Tivoli Event Integration Facility (EIF), an event adapter SendTEC should be installed on the same computer that is consolidating all of the IBM Tivoli Management Solution for Exchange events. When you finish None. Procedure 1. Locate the SendTEC directory on the IBM Tivoli Management Solution for Exchange product CD-ROM. 2. Double-click the setup.exe file to display the Welcome screen. 3. Click Next on the Welcome screen to display the Choose Destination Location screen. 36 IBM Tivoli Management Solution for Exchange: User s Guide

49 4. Review the displayed location in the Destination Folder field and do one of the following: v Click Next to install SendTEC to the location displayed in the Destination Folder field and display the Select Program Folder screen. OR v Choose a different location by doing the following: a. Click Browse. b. Choose another destination. c. Click OK. d. Click Next to install SendTEC to the directory displayed in the Destination Folder field and display the Select Program Folder screen. 5. Do one of the following to name the program folder: v Click Next on the Select Program Folder screen to keep the default folder name and display the Check Setup Information screen. OR v Choose a different program folder name by doing the following: a. Type the new folder name in the Program Folders text box. b. Click Next on the Select Program Folder screen to display the Check Setup Information screen. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 37

50 6. Click Next on the Check Setup Information screen to display the Setup Complete screen. 7. Click Finish to complete the installation of the SendTEC product. Additional Information: Installing SendTEC does not create an ini file. An example version called demosendtec.ini is created in an examples directory. This file must be transferred to a configuration directory and edited before starting SendTEC. Perform the steps below to complete this procedure. 8. Edit the SendTEC configuration files by doing the following (for detailed configuration notes, see C:\Program Files\SendTEC\documentation): a. Locate the C:\ProgramFiles\SendTec\examples\config\demosendtec.ini file. b. Rename the demosendtec.ini file to sendtec.ini. c. Copy the sendtec.ini file into the C:\ProgramFiles\SendTec\config directory. d. Open the sendtec.ini file in the C:\ProgramFiles\SendTec\config directory. e. Set the following parameters: HOST_NAME Enter the name or IP address of the host (running TEC server), to 38 IBM Tivoli Management Solution for Exchange: User s Guide

51 which events are sent. SendTEC can send to only one receiving host. See the documentation to set up multiple process instances. SOCKET Enter the TEC port number. Tivoli TEC server listens for events. PRODUCT_ID and PRODUCT_VERSION If SOCKET is set to 0, SendTEC finds the socket to use by contacting the portmapper on the host defined in HOST_NAME. SendTEC finds the port number that serves the product specified by PRODUCT_ID and PRODUCT_VERSION. Check Tivoli documentation for the correct product ID and version numbers. EVENT_FILE_IN Enter the file where SendTEC receives the events it processes. MAX_FILE_AGE_IN Enter the maximum age of any event file to be processed. EVENT_FILE_OUT Enter the file to which SendTEC writes any normal or error events. DEBUG_LEVEL Enter the level of debug information to include in the output information. Higher values provide more detail about the internal behavior of the process. Level 0 provides no debug messages. Level 3 provides initialization data, and record count and action processing information. DEBUG_FILE Enter the name of a file to which debug information is written. ERROR_FILE Enter the name of a file to which errors are written. f. Save the sendtec.ini file. 9. Run the CreateServices.bat batch file in the bin subdirectory. 10. Add the values below to the following registry key using REGEDIT to enable IBM Tivoli Management Solution for Exchange to create ASCII.evt files to send to the Tivoli Enterprise Console: In the HKEY_LOCAL_computer\SOFTWARE\TEMS\EventServer registry key v Value Name: EventFileEnable v Data Type: REG_DWORD v Value: Copy the included Baroc file to the Tivoli Enterprise Console Server. 12. Start the SendTEC service by doing one of the following on a Windows 2000 or NT operating system: v Windows 2000: a. Open the Control Panel. b. Open Administrative Tools. c. Open Services. d. Click SendTEC to select the SendTEC service. e. Click Action to display the Action menu. f. Click Start from the Action menu. v Windows NT: a. Open the Control Panel. Chapter 2. Installing IBM Tivoli Management Solution for Exchange 39

52 b. Open Services. c. Click SendTEC to select the SendTEC service. d. Click Start. Uninstalling IBM Tivoli Management Solution for Exchange Objective To uninstall IBM Tivoli Management Solution for Exchange so you can remove all of the program files from a computer. Background information Uninstall removes all files in the IBM Tivoli Management Solution for Exchange directories. Note: The term IBM Tivoli Management Solution for Exchange and the term Tivoli Enterprise Management Solutions are used interchangeably in the product. Before you begin None. When you finish None. Procedure 1. Open the Control Panel by doing the following: a. Click Start in the Windows taskbar to display the Start menu. b. Select Settings from the Start menu to display the Settings menu. c. Select Control Panel from the Settings menu to display the Control Panel menu. 2. Click the Add/Remove Programs icon. 3. Select IBM Tivoli Management Solution for Exchange. 4. Click Add/Remove. 5. Click Yes to confirm uninstallation. 40 IBM Tivoli Management Solution for Exchange: User s Guide

53 Chapter 3. Working with the Tivoli Enterprise Manager The Tivoli Enterprise Manager is the central location where you manage and control the operations of IBM Tivoli Management Solution for Exchange. You can control the Tivoli Rule Engine through the Tivoli Enterprise Manager. The Tivoli Rule Engine executes a rule process, which is a set of one or more rules. Each rule monitors a specific situation throughout the network. It notifies and takes corrective actions, if the situation occurs. For example, a rule can detect if a database server is hung, and if so, the rule can stop it and restart it. IBM Tivoli Management Solution for Exchange can monitor and take appropriate actions for a wide variety of operating system, network, database, and application problems. A computer can execute one or more Tivoli Rule Engine processes. To learn more about rules and rule processes, see Chapter 5, Managing rules on page 65 and Chapter 6, Managing solutions on page 73. This chapter provides an explanation of the Tivoli Enterprise Manager features and step-by-step instructions for related procedures. Table 5 provides an overview of the topics covered in this chapter. Table 5. Guidelines for working with the Tivoli Enterprise Manager Goal Refer to 1. Understanding Tivoli Enterprise Manager views 2. Understanding how Tivoli Enterprise Manager represents your network 3. Understanding and customizing the Tivoli Enterprise Manager behavior options 4. Understanding and managing the source rule display 5. Finding IBM Tivoli Management Solution for Exchange in the network Tivoli Enterprise Manager views on page 41 Tivoli Enterprise Manager and the network on page 42 Customizing the Tivoli Enterprise Manager behavior options on page 42 Changing the Source Rule Computer on page 45 Finding IBM Tivoli Management Solution for Exchange in the network on page Refreshing the network view Refreshing the network view on page Managing domains Managing domains on page Managing computers Managing computers on page Working with the Tivoli Configuration Manager Using the Tivoli Configuration Manager on page 51 Tivoli Enterprise Manager views The Tivoli Enterprise Manager runs in two modes: the Management View and the Development View. The default mode is the Management View. The Management View displays and manages rule processes deployed throughout the network. The Management View has two panes. The left pane displays icons that represent containers, which are the network, domains, or computers, and the right pane displays the contents of those containers. The Development View also has a left and a right window pane, but panes are independent of each other. The Development View enables you to write and 41

54 modify individual rules before deployment. Development View provides a view of all existing rule processes. The left pane is the network display of domains, computers, rule processes, and the rules within the rule processes that the Tivoli Enterprise Manager manages. The right pane displays rules. It contains the available source rules used to build new Tivoli rule processes or update existing Tivoli rule processes. You can toggle between the two views from the Tivoli Enterprise Manager View drop-down menu. Tivoli Enterprise Manager and the network The Tivoli Enterprise Manager represents the network using a hierarchy that includes a domain and computer where the domain represents a group of computers that share common account administration and security and the individual computer is a member of a domain. When constructing a Tivoli rule process, the source rules comes from a computer on the network. Additionally, the Tivoli Enterprise Manager processes create and manage the rule process on any computer in the network. The Tivoli Enterprise Manager fully complies with the Windows NT security system. Consequently, the computers that can be managed by the Tivoli Enterprise Manager are constrained by the underlying security in place on the network. Customizing the Tivoli Enterprise Manager behavior options Objective To set the IBM Tivoli Management Solution for ExchangeBrowse, Cache, Confirmation, and Process Start options to your specifications. Background information You can customize the following options: Browse options Customizes the browsing behavior of the Tivoli Enterprise Manager. Browsing refers to the periodic consulting of the network for a list of 42 IBM Tivoli Management Solution for Exchange: User s Guide

55 domains and computers in each domain. Browsing can also involve checking the state of IBM Tivoli Management Solution for Exchange on each computer in each domain. Cache options Maintains and clears cache of the computers that it previously examined, speeding up network-wide operations. The first time you run the Tivoli Enterprise Manager, caching is disabled by default. Confirmation options Specifies whether or not the Tivoli Enterprise Manager asks you for confirmations before performing specific types of operations. Process start options Determines whether Tivoli Rule Processes start automatically when they are first created. Before you begin Browse Options: The amount of time it takes to browse the network depends on the size of your network (how many domains and how many computers in each domain) and how many computers in the network are running IBM Tivoli Management Solution for Exchange. Read the following browse option descriptions to help you decide which browse option is appropriate for your system: Confirmation Options: You can change whether or not the Tivoli Enterprise Manager asks you for confirmations after performing specific operations. To control confirmation behavior, click the View menu in the main Tivoli Enterprise Manager window and select the Options menu item. When the Options window is displayed, select the Confirmation tab. You can turn confirmations on or off independently for each of the following operations: When you finish None. Procedure You can perform this procedure from the Tivoli Enterprise Manager. 1. Click View from the toolbar to display the View drop-down menu. 2. Select Options... to display the Options... dialog box. 3. Set the Browse settings a. Click the Browse tab to display the Browse settings. b. Select one of the following options by clicking the corresponding radio button: Do not browse (add domains and computers manually) Does not to find the domains in a network or find the computers in a given domain. Enter domains and computers manually that you want Tivoli Enterprise Manager to manage. This option is suitable for large networks with few computers running IBM Tivoli Management Solution for Exchange. This setting is the default browse setting. Browse, but do not check for Tivoli running (faster) Looks up domains in the network as well as computers in a given domain. The Tivoli Enterprise Manager does not check to see if IBM Tivoli Management Solution for Exchange is running on each computer. This option is suitable for domains that have a small to Chapter 3. Working with the Tivoli Enterprise Manager 43

56 moderate number of computers, where very few of the computers are running IBM Tivoli Management Solution for Exchange. Perform a full browse, including checking for Tivoli running Looks up domains the computers in a specified domain and check each computer for IBM Tivoli Management Solution for Exchange. A full browse is more convenient for the user but requires the highest level of browse effort. This option is suitable for small domains or domains with the vast majority of the computers running IBM Tivoli Management Solution for Exchange. c. Do one of the following to manage the cache: v Click the Clear cache installed state of Tivoli for up to one week check box to enable the caching mechanism. OR v Clear the check box to disable the caching mechanism. Additional Information: Tivoli Enterprise Manager automatically declares entries in the cache stale after seven days. At any time you can empty the cache by clicking the Clear Cache Now button. When you clear the cache, Tivoli Enterprise Manager checks each remote computer for IBM Tivoli Management Solution for Exchange. Clearing the cache might be appropriate if you have just installed IBM Tivoli Management Solution for Exchange on several computers. 4. Set the Confirmation settings. a. Click the Confirmation tab to display the Confirmation settings. b. Select any combination of the following options. Confirming Drag Operations Asks for confirmation of drag and drop operations. If the Confirm all Drag Operations box is not checked, all drag and drop operations are performed without confirmation. Confirming Replacement Operations Asks for confirmation before replacing the existing process or rule. If the Confirm all Replacement Operations box is not checked, operations that result in the replacement of existing processes or rules complete without confirmation. Displaying Browse Warnings Asks for confirmation the browse operation. If the Confirm browse operations box is not checked, operations that result in a browse of the domain complete without confirmation. Displaying Success Messages Displays a message indicating an operation completes successfully. If the Display success messages box is not checked, you do not receive a message indicating the operation was successful. The lack of a message indicates success. Operations that generate errors are always generate a message. 5. Set the Process Start settings a. Click the Process Start tab to display the Process Start option. b. Do one of the following: v Select the Automatically start newly created processes check box. OR v Deselect the Automatically start newly created processes check box. 6. Do one of the following to apply your changes: 44 IBM Tivoli Management Solution for Exchange: User s Guide

57 v v Click OK. OR Click Apply. Changing the Source Rule Computer Objective To change the source rule computer so you can manage rules on different computers. See Chapter 5, Managing rules on page 65 for more information on rules. Background information A source rule is a rule written by the Tivoli Rule Designer that is included when constructing Tivoli processes. The source rule display is on the right of the Tivoli Enterprise Manager main window in the Development View. The source rule display includes icons representing the rules. The text box above the source rule display indicates the Source Rule domain, computer, and directory currently providing the source rules used to build and augment Tivoli rule processes. Different directories can provide different rules. For example, one directory might provide rules for an NT Server. Another might provide rules for Exchange or for an SQL Server. The set of directories that are available for source rule storage on a specific computer is the set of subdirectories under the C:\Program Files\TEMS\Rules directory, assuming IBM Tivoli Management Solution for Exchange is installed in the default location of the C:\Program Files\TEMS directory. The format of the directory display in the text box is \\domain\computer\directory. This display includes a drop-down list that you can use to change the source rule computer and directory. Before you begin None. When you finish None. Procedure Do one of the following to change the source rule computer. v From the Source Rule Computer: text box in the right window pane of the Tivoli Enterprise Manager 1. Click the right arrow next to the Source Rule Computer: text box to display the Source Rule Computer: drop-down list. 2. Select a new source rule computer/directory from the list. OR OR v From the Change Source Rule Computer dialog box: 1. Display the Change Source Rule Computer dialog box: Click the Change Source Rule Computer icon on the toolbar. OR Select Manage from the toolbar to display the Manage drop-down menu and select Source Rule Computer... OR Right-click in the source rule display (not positioned on an individual rule) to display a drop-down menu and select Change Source Rule Computer... Chapter 3. Working with the Tivoli Enterprise Manager 45

58 2. Click the down arrow under Domain: to display the Domain options. 3. Select a Domain. 4. Click the down arrow under Computer: to display the Computer options. 5. Select a Computer. 6. Click the down arrow under Directory: to display the Directory options. 7. Select a Directory. 8. Select a source rule from the Available source rules list. Additional Information: To view the properties of a source rule, click the Properties button under the Available source rules list. To view the source rule code, click the View Code button under the Available source rules list. Finding IBM Tivoli Management Solution for Exchange in the network Objective To search the network and add computers not managed by the Tivoli Enterprise Manager. This feature also refreshes the Tivoli Enterprise Manager view of processes and rules for computers and domains already managed by Tivoli Enterprise Manager. See the Refreshing the network view on page 46. Background information Finding computers managed by IBM Tivoli Management Solution for Exchange in the network can be a lengthy process in large networks. You can also use this feature to determine if domains and computers have been added or removed from the network by other users. Tivoli Enterprise Manager does not discover domains or computers that have become unavailable due to computer or network error. Tivoli Enterprise Manager can remove any previously managed domains or computers not discovered during the find operation. The difference between Refresh Network View and Find Tivoli in Network is that Refresh Network View updates only the process and rule listing for domains and computers already managed by the Tivoli Enterprise Manager. Unlike Find Tivoli in Network, Refresh Network View does not add new domains and computers to the Tivoli Enterprise Manager. The Find Tivoli in Network option performs the Refresh Network View operations and adds domains and computers located on the network that were not previously managed by the Tivoli Enterprise Manager. Before you begin None. When You Finish None. Refreshing the network view Procedure You can perform this procedure from the Tivoli Enterprise Manager. 1. Select File from the toolbar to display the File drop-down menu. 2. Select Find Tivoli in Network. Objective To search all domains listed in the Tivoli Enterprise Manager for computers, processes, and rules currently running in each domain so the Tivoli Enterprise Manager view can be updated. 46 IBM Tivoli Management Solution for Exchange: User s Guide

59 Managing domains Background information Refreshing the network view ensures that the configuration represented by the Tivoli Enterprise Manager is synchronized with the actual configuration on each computer in the domain. This feature is useful if changes have been made by another Tivoli Enterprise Manager program running elsewhere in the network. The difference between Refresh Network View and Find Tivoli in Network is that Refresh Network View updates only the process and rule listing for domains and computers already managed by the Tivoli Enterprise Manager. Unlike Find Tivoli in Network, Refresh Network View does not add new domains and computers to the Tivoli Enterprise Manager. The Find Tivoli in Network option performs the Refresh Network View operations and adds domains and computers located on the network that were not previously managed by the Tivoli Enterprise Manager. Before you begin None. When you finish None. Procedure You can perform this procedure from the Tivoli Enterprise Manager. 1. Select View from the toolbar to display the View drop-down menu. 2. Select Refresh Network View. Objective To specify the domains for the Tivoli Enterprise Manager to manage so you can create, modify, and control the execution of Tivoli rule processes on some or all of the computers in a domain. Background information You can manage any domain on the network to which you have security access. The Manage Domains window contains an Available Domains list and a Managed Domains list. The available domain is empty when browsing is disabled. Virtual domains provide a flexible way of grouping computers. Virtual domains do not physically exist, but are made by software to appear to physically exist. A virtual domain is not a Windows NT domain and has no relationship to Windows NT domains. An example of a virtual domain might have several Exchange servers that actually exist in different Windows NT domains. You can group them together creating a virtual domain named Exchange and adding all of the Exchange severs to it. The Tivoli Enterprise Manager can manage domains that are completely physical, completely virtual, or a combination of both. Additionally, a computer can be a member of more than one domain. When Tivoli Enterprise Manager no longer manages a domain, operation of IBM Tivoli Management Solution for Exchange on the domain s computers is not affected. Chapter 3. Working with the Tivoli Enterprise Manager 47

60 Domains already managed by the Tivoli Enterprise Manager are listed in the Managed Network View, found in the left window pane of the Tivoli Enterprise Manager. Before you begin You must be logged into a domain account. If your computer is in a domain but you are not logged into a domain account, Windows NT security restrictions prevent you from discovering available domains. When you finish If browsing is enabled, the Manage Domains window displays a View Computers button below the available and managed domain lists. If you select a domain and click View Computers, the View Computers window is displayed. Finally, you can see the properties of one or more computers by selecting the computers of interest and clicking Properties or right-clicking the mouse on a computer and selecting Properties from the drop-down menu. Procedure 1. Do one of the following to display the Manage Domains window. v From the toolbar menu: a. Select Manage from the toolbar to display the Manage drop-down menu b. Select Domains... from the drop-down menu. OR v From the Managed Network View: a. Right-click empty space in the Managed Network View to display a drop-down menu b. Select Manage Domains. 2. You can perform one or more of the following options in the Manage Domains window: v Add a domain to the Managed Domains list using the following steps: a. Select a domain from the Available Domains list. b. Click Add to move the domain into the Managed Domains list. OR v Remove a domain from the Managed Domains list using the following steps: 48 IBM Tivoli Management Solution for Exchange: User s Guide

61 Managing computers a. Select a domain from the Managed Domains list. b. Click Remove to move the domain into the Available Domains list OR v Add a virtual domain to the Managed Domains using the following steps: a. Enter a domain name in the Add virtual domain: text box. b. Click Add Domain. 3. Click Apply or OK to commit the changes you made in the Manage Domains window. 4. Use the following steps to view the computers in a domain: a. Select a domain from the Available domains list or the Managed Domains list. b. Click View Computers... to display the View Computers... dialog box. Objective To create, modify, and control the execution of Tivoli processes on a computer within a domain managed by IBM Tivoli Management Solution for Exchange. Background information You can manage computers that are in domains on the network to which you have security access. You can choose to manage all the computers or you can manage only a subset of the computers within a given domain. The computers that are managed by the Tivoli Enterprise Manager are listed in the Managed Network View. Before you begin Enable browsing so you can determine if the computers you want Tivoli Enterprise Manager to manage are currently running on the network. See Customizing the Tivoli Enterprise Manager behavior options on page 42 for information on browse options. When you finish None. Procedure You can perform this procedure from the Tivoli Enterprise Manager. 1. Do one of the following to display the Manage Computers window. v From the toolbar: a. Select Manage from the toolbar to display the Manage drop-down menu. b. Select Computers... from the drop-down menu. OR v From empty space in the Managed Network View: a. Right-click empty space in the Managed Network View to display a drop-down menu. b. Select Manage Computer. Chapter 3. Working with the Tivoli Enterprise Manager 49

62 2. Click the down arrow on the Domain: text box to display a list of domains. 3. Click the domain you want to work with to select it. Additional Information: When you select a a domain, IBM Tivoli Management Solution for Exchange populates the Available Computers and Managed Computer lists below the domain drop-down list according to their current state. 4. Select an Available Computer Display: option: a. Click the down arrow on the Available Computer Display: to display the Available Computer Display: options. b. Select one of the following options: Do not list computers in the domain Does not list computers in the Available Computers list of the Manage Computers dialog box. This is the only option available when you disable the browse options. For more information on browsing, see Customizing the Tivoli Enterprise Manager behavior options on page 42. List all available computers in the domain Lists all available computers for the specified domain in the Available Computers list of the Manage Computers dialog box. This option is available when you enable browsing for computers. List all available computers in the domain that are running IBM Tivoli Management Solution for Exchange Lists all available computers for the specified domain in the Available Computers list of the Manage Computers dialog box, but only if they are running IBM Tivoli Management Solution for Exchange. This option is available only when full browsing is enabled. 5. Do one of the following to add or remove a computer from the domain you selected in Step 3: v Add a computer to the Managed Computers list: 50 IBM Tivoli Management Solution for Exchange: User s Guide

63 a. Select a computer from the Available Computers list. b. Click Add to move the domain into the Managed Computers list. OR v Manually add a computer to the Managed Computers list: a. Type the name of a computer in the Add managed computer text box to add a computer manually. b. Click Add Computer. OR v Remove a computer from the Managed Computer list: a. Select a computer from the Managed Computer list. Additional Information: To check the properties of a computer before removing it, select it from the Managed Computers list and click Properties. b. Click Remove to move the domain into the Available Computer list. 6. Do one of the following to save and apply the changes you made in the Managing Computers dialog box. v Click OK to apply the changes and close the dialog box. OR v Click Apply the changes without closing the dialog box. Using the Tivoli Configuration Manager Objective To use the Tivoli Configuration Manager to set the configuration settings on each computer in the network. Background information You can control the configuration settings for individual computers or all computers, an individual domain or all domains, or the entire network from one computer. Before you begin You must perform this procedure from the Tivoli Configuration Manager. You can open the Tivoli Configuration Manager from the Tivoli Enterprise Manager toolbar. If you specify a Microsoft Exchange profile name in the Mail Information tab, you must complete the following guidelines on every computer where the MAIL action is used or where these statistics are collected. For more more information, consult your Microsoft documentation. 1. Install the Microsoft Exchange client. 2. Using the Microsoft Exchange Administrator, create a Tivoli mailbox. 3. Using the User Manager, create a domain level account with administrator privilege named Tivoli. 4. Configure IBM Tivoli Management Solution for Exchange to use this account. Enter the domain name, the account name (Tivoli), and the password. 5. Log off and log back on to IBM Tivoli Management Solution for Exchange under the new Tivoli account. 6. Create a Microsoft Exchange profile for IBM Tivoli Management Solution for Exchange to use. This is typically done using the mail applet from within the control panel or by clicking on the Inbox icon. Consult your Microsoft documentation for details. Chapter 3. Working with the Tivoli Enterprise Manager 51

64 7. Start the Tivoli Configuration Manager. 8. Click next until you see the Mail Information tab. 9. Enter the Microsoft Exchange profile name in the Profile Name field. For example, type MS Exchange Settings or Microsoft Outlook. 10. Click Finish. 11. Exit IBM Tivoli Management Solution for Exchange. 12. Log off from the Tivoli account. When you finish None. Procedure You can perform this procedure from the Tivoli Enterprise Manager. 1. Click Manage from the Tivoli Enterprise Manager toolbar to display the Manage drop-down menu. 2. Select Configuration... from the drop-down menu to open the Tivoli Configuration Manager. 3. Click one of the following to display configuration settings: v Enterprise to display the configuration settings for the entire enterprise. OR v A Domain_Name to display the configurations settings for a domain. OR v A Computer_Name to display the configurations settings for a computer. Additional Information: Configuration settings display in the Settings: pane if the item you click has IBM Tivoli Management Solution for Exchange. 4. Click one or more of the following tabs to change configuration settings for the selected tab. General Information To change date and time format and key expiration warnings: a. Select a date format. b. Select a time format. c. Click the box next the Show Key Expiration Warning to enable the feature. OR Click the box next to the Show Key Expiration Warning to remove the check mark and disable the feature. Account Information To configure IBM Tivoli Management Solution for Exchange to use the account specified by the Domain and Account fields: a. Type a domain in the domain text box b. Type an account in the account text box c. Type a password in the password text box. Mail Information To define how IBM Tivoli Management Solution for Exchange sends mail with the MAIL action: a. Select No Mail Service. OR 52 IBM Tivoli Management Solution for Exchange: User s Guide

65 b. Select SMTP Mail and type a mail server in the Mail Server text box. OR c. Select Microsoft Exchange and type a profile name in the Profile Name text box. Rule Information To change which rules start automatically when your systems starts: a. Check the box of an item if you want its rules to begin monitoring whenever you restart your computer. b. Click Apply. Collection Information To limit the number of entities a rule collects and to set an delivery timeout to return a delivery receipt. a. Type a value in the Maximum Items field. Additional Information: Set this number large enough to handle the largest collection of entities any of your rules perform. If you do not set the number large enough, IBM Tivoli Management Solution for Exchange might not be able to diagnose potential problems. b. Type a value in seconds in the delivery timeout. Additional Information: You can write rules using domain MSExchange to send an to a specified address and perform an action if a delivery receipt is not returned in the amount of time specified by the delivery timeout. View To display the drop-down menu. a. Select Options... to display the Tivoli Configuration Manager options dialog box. b. Check the Confirm all update operations check box to enable the feature. c. Check the Display success messages check box to enable the feature. Chapter 3. Working with the Tivoli Enterprise Manager 53

66 54 IBM Tivoli Management Solution for Exchange: User s Guide

67 Chapter 4. Managing processes A Tivoli process is a background process that runs on a Microsoft Windows NT computer. The process starts the Tivoli Rule Engine, which runs a defined set of Tivoli rules. Each rule performs a specific monitoring task and can take actions appropriate to the conditions monitored. See Chapter 5, Managing rules on page 65 for more information on rules. The Tivoli Enterprise Manager makes it easy to construct a Tivoli rule process from one or more rules written by the Tivoli Rule Designer. You control all aspects of a Tivoli rule process through the Manage Processes dialog box. After you construct a Tivoli rule process, you can manage it from the Tivoli Enterprise Manager. This chapter provides an explanation of the process concepts and step-by-step instructions for related procedures. Table 6 on page 55 provides an overview of the topics covered in this chapter. Table 6. Guidelines for managing processes Goal Refer to 1. Displaying the Manage Processes dialog box and selecting processes to manage Displaying the Manage Processes dialog box and selecting a process on page Starting and stopping processes Starting and stopping processes on page Viewing process information Viewing process information on page Copying processes from one domain to another 5. Moving processes from one domain to another 6. Deleting processes 7. Changing the startup state of processes 8. Setting the debug level of processes Performing operations on processes on page Creating processes Creating processes on page 62 Displaying the Manage Processes dialog box and selecting a process Objective To display the Manage Processes dialog box and select an individual process to manage. Background information You perform this procedure from the Tivoli Enterprise Manager. Use the Manage Processes dialog box to control a Tivoli rule process at the individual rule level. Managing rules includes the following: enabling and disabling rules; firing rules; examining rule properties; viewing process status; writing process code; and copying, moving, renaming, and deleting individual rules. Before you begin You must start the Tivoli Enterprise Manager. You must perform the steps in the procedure before you can manage a process. 55

68 When you finish None. Procedure You can perform this procedure from the Tivoli Enterprise Manager. 1. Do one of the following to display the Manage Processes dialog box: a. Click Manage from the Tivoli Enterprise Manager toolbar to display the Manage drop-down menu. b. Select Processes... to display the Manage Processes dialog box. OR a. Click the Processes icon from the toolbar. OR a. Right-click empty space in the Managed Network View to display the Manage drop-down menu. b. Select Manage Processes... from the drop-down menu to display the Manage Processes dialog box. OR a. Right-click on a process within a computer to display the process drop-down menu b. Select Manage from the drop-down menu to manage the process. 2. Click the down arrow next to the Domain... text box to display the list of available domains. Additional Information: If you do not see the domain that you want, you need to add it to the available domains list. See Managing domains on page 47 for more information. 3. Select a domain from the Domain... text box list. 4. Click the down arrow next to the Computer: text box to display the list of available computers. 56 IBM Tivoli Management Solution for Exchange: User s Guide

69 Viewing process information Additional Information: If you do not see the computer that you want, you need to add it to the available computers list. See Managing computers on page 49 for more information. 5. Select a computer from the Computer... text box list. 6. Click the down arrow next to the Process... text box to display the list of available processes. 7. Select a process from the Process... text box list. Objective To display the status, rule code, or scheduling properties of a process to obtain complete process information. Background information The status of the process includes the the following information: v The date and time the process was started on the computer v The amount of time the process has been running on the computer in seconds v The CPU time used by the computer and the percentage of the CPU used v A listing of each rule in the process, including the rule name and whether the rule is enabled or disabled The rule code consists of actual statements that are executed by the Tivoli Rule Engine. The rule code is in ASCII language. The rule code defines the schedules, selections, and actions that define the mission of the rule. The Tivoli Rule Designer writes the rule code based on the choices you make in the Tivoli Rule Designer graphical user interface. Users can write the rule code using the Tivoli Rule Editor. See Creating a new rule using the New Rule Wizard on page 82. The process properties include the following: v The domain and computer on which the process is maintained v The process name v Whether or not the process is automatically started at system startup time v Whether or not the process is currently running v A list of rules that make up the process v Each listed rule s schedule Before you begin Complete all steps in Displaying the Manage Processes dialog box and selecting a process on page 55. When you finish Close the Manage Processes dialog box to return to the Tivoli Enterprise Manager. Procedure You can perform this procedure from the Tivoli Enterprise Manager Development View. 1. Display the Manage Processes dialog box. See Step1 on page 56 of Displaying the Manage Processes dialog box and selecting a process on page 55 for more information. 2. Select a domain, computer, and process as described in Steps 2 through 7 of Displaying the Manage Processes dialog box and selecting a process on page 55. Chapter 4. Managing processes 57

70 3. Do one of the following from the Process control panel of the Manage Processes dialog box: v Click Status to display the rule status properties. OR v Click Code to display the rule code. OR v Click Properties to display the rule properties. 4. Click Close to close the window when you finish viewing rule status, code, or scheduling properties. Starting and stopping processes Objective To start a process so the Tivoli Rule Engine can execute the process rules, or stops a process so the Tivoli Rule Engine can stop the rules. Background information When you start a process, it executes the Tivoli Rule Engine, which in turn executes the defined set of process rules. Each process rule monitors for specific conditions and can take appropriate action when specific conditions occur. When you stop a process, the Tivoli Rule Engine stops the rules from monitoring for conditions. Before you begin Complete all steps in Displaying the Manage Processes dialog box and selecting a process on page 55. When you finish None. Procedure You can perform this procedure from the Tivoli Enterprise Manager. Do one of the following to start or stop a process: v Click Start from the Process control panel to start a process. OR v Click Stop from the Process control panel to stop a process. Additional Information: You can right-click a process from the Managed Network View of the Tivoli Enterprise Manager to display a drop-down menu that includes the Start and Stop options. Performing operations on processes Objective To perform operations on a process to control the rules that monitor for specific conditions. Background information This procedure guides you through the following tasks: Copying a process A copy operation copies all of the rules of the process as well as the startup state of the process. Within the Copy Process dialog box, the source process is the copied process. The new copy of the process is the target 58 IBM Tivoli Management Solution for Exchange: User s Guide

71 process. The target process and source process have the same name but you can change the target process name by typing a new name into the Target process text box. You can put a target process on the same computer as the source process provided you give them different names. Moving a process A move operation moves all of the rules of the process from the source computer to the target computer. The startup state of the process is preserved. Within the Move Process dialog box, the source process is the moved process. The new name and location of the moved process is the target process. The target process and source process have the same name but you can change the target process name by typing a new name into the Target process text box. You can put a target process on the same computer as the source process provided you give them different names. Renaming a process You can rename a process within a computer. In the Rename Process window, the process you are renaming is listed in the Old process name: field. If an existing process already has the new name you have selected, you are notified and the rename operation fails. If the process was running at the time of the process rename, the process stops and restarts after the successful rename process operation. Deleting a process In the Delete Process dialog box, the Process to Delete: text box lists the rule that is targeted for deletion. You can change the process to be deleted by typing over the existing process in the text box. Changing the startup state of a process You can configure a rule process to startup automatically when you startup the system. You can also prevent a rule process from starting up automatically when you start the system. Setting the debug level of a process You can configure a Tivoli rule process to run at different debug levels. Each debug level provides a successively higher level of debugging information for a running Tivoli rule process. Setting a nonzero debug level when you first create a rule process ensures they are executing according to plan. Debug information is written to a file in the following format: ProcessName_Computer _Output.Log where: ProcessName is the name of the Tivoli rule process and Computer is the name of the computer the process is running on. The file is stored in the \logs subdirectory under the Tivoli Enterprise Management Solutions installation directory. For example, the full file specification for the file that contains debug information for a process called MyProcess on a computer named Everest could be: C:\Program Files\TEMS\logs\MyProcess_Everest_output.log Chapter 4. Managing processes 59

72 Table 7 lists the debug level definitions. Table 7. Debug levels Level Definition 0 No debugging. This is the default setting. 1 Log each rule name as it executes. 2 Log each rule name as it executes, log automatic file closes. 3 Log each rule name as it executes, log automatic file closes, log each context value for each rule as it executes. 4 Log each rule name as it executes, log automatic file closes, log each context value for each rule as it executes, log the condition as well (true or false). 5 Log each rule name as it executes, log automatic file closes, log each context value for each rule as it executes, log the condition as true or false, log each action taken. Before you begin You must complete all the steps in Displaying the Manage Processes dialog box and selecting a process on page 55. When you finish None. Procedure You can perform this procedure from the Tivoli Enterprise Manager Development View. 1. Display the Manage Processes dialog box. See Step 1 on page 56 of Displaying the Manage Processes dialog box and selecting a process on page 55 for instructions. Additional Information: Click Modify Process Rules to display the Modify Process Rules dialog box. See Managing rules within a process on page 69 for more information. 2. Do one of the following to alter the process startup state from the Manage Processes dialog box: v Check the Process automatically runs at startup box to put a check mark in the box and to run the process automatically when the systems starts. OR v Check the Process automatically runs at startup box to remove the check mark from the box and to prevent the process from running at system startup. 3. Click Debug Level... to display the Process Debugging Level dialog box. 4. Click the radio button the corresponds to the debug level you want to set. 5. Click OK to commit debug level setting and close the Process Debugging Level dialog box. 6. Do one of the following from the Rule Control panel of the Manage Processes dialog box: a. Click Copy to display the Copy Process dialog box. b. Go to Step 7 on page 61. OR a. Click Move to display the Move Process dialog box. b. Go to Step 7 on page IBM Tivoli Management Solution for Exchange: User s Guide

73 OR a. Click Rename display the Rename Process dialog box. b. Go to Step 9 on page 61. OR a. Click Delete to display the Delete Process dialog box. b. Go to Step 8 on page Use the following steps to copy or move a process from one computer to another: a. Click the down arrow on the Source Domain: text box to display the Source Domain: drop-down list. b. Select a domain. c. Click the down arrow on the Source Computer: text box to display the Source Computer: drop-down list. d. Select a computer. e. Click the down arrow on the Source Process: text box to display the Source Process: drop-down list. f. Select a process. g. Select a rule. h. Click the down arrow on the Target Domain: text box to display the Target Domain: drop-down list. i. Select a domain. j. Click the down arrow on the Target Computer: text box to display the Target Computer: drop-down list. k. Select a computer. l. Verify the target process. Additional Information: If the process in the Target process: text box is not the desired target process, you can type in the name of a different process. m. Do one of the following to commit the changes: v Click Apply to commit the changes. OR v Click OK to commit the changes and close the dialog box. n. Go back to Step 6 on page 60 if you want to move, rename, or delete a process. OR Go to Step 11 on page Click OK to delete the process in the text box. OR a. Type the name of the process you want to delete. b. Click OK to delete the process and close the Delete Process dialog box. c. Go back to Step 6 on page 60 if you want to copy, rename, or move a process. OR Go to Step 11 on page Type a new name for the process in the text box. 10. Click OK to commit the change to the process name. 11. Click Close to close the Manage Process dialog box. Chapter 4. Managing processes 61

74 Creating processes Objective To create a new process to manage rules. Background information Creating a new rule process includes the following tasks: v Selecting the target domain and computer for the process. v Specifying a name for the process. v Selecting the rules for the process to execute. v Indicating if the process runs automatically at system startup or not. Before you begin You must perform this procedure from the Tivoli Enterprise Manager Development View. See Tivoli Enterprise Manager views on page 41 for more information. When you finish You must click OK or Apply to commit changes you make in the Create Rule Process dialog box. Procedure You can perform this procedure from the Tivoli Enterprise Manager. 1. Do one of the following to display the Create Rules Process dialog box a. Select File from the Tivoli Enterprise Manager toolbar b. Select Create Rule Process.... OR a. Display the Manage Process... dialog box. See Displaying the Manage Processes dialog box and selecting a process on page 55 for more information. b. Click New from the Process Control panel of the Manage Process... dialog box. OR a. Right-click a process within the Tivoli Managed Network pane of the Tivoli Enterprise Manager to display a drop-down menu. b. Select Create Process Click the down arrow on the domain text box to display the domain drop-down menu. 3. Select a domain. 4. Click the down arrow on the Computer text box to display the Computer drop-down menu. 5. Select a computer. 6. Specify a process name in the Process: text box. Additional Information: After you specify a domain and computer, the Tivoli Enterprise Manager generates a default name for the process. You can change the default process name by typing a new name in the Process: text box. The Tivoli Enterprise Manager only allows you to type letters and numbers. 7. Do the following to select rules for the process to execute. a. Click the multiple rules you want to add to the Selected Rules: list from the Available rules: list to highlight them. b. Click Add to add the highlighted rules to the Selected Rules: list. 62 IBM Tivoli Management Solution for Exchange: User s Guide

75 8. Do one of the following: v Click the Start process now and automatically at system startup check box to start the process automatically when the systems starts. OR v Click the Start process now and automatically at system startup check box to remove the check mark and prevent the process form starting automatically when the systems starts. 9. Do one of the following to commit the changes you make in the Create Rule Process dialog box. v Click Apply to commit the changes. OR v Click OK to commit the changes and close the Create Rule Process dialog box. Chapter 4. Managing processes 63

76 64 IBM Tivoli Management Solution for Exchange: User s Guide

77 Chapter 5. Managing rules An IBM Tivoli Management Solution for Exchange rule is a named entity used to a monitor specific situation and if necessary, take corrective action and perform external notification. A rule operates as an autonomous agent proactively monitoring each server. A rule can, for example, detect if a database server is unresponsive and stop and restart it. IBM Tivoli Management Solution for Exchange can monitor and take appropriate actions for a variety of operating system, network, database, and application problems. A computer can execute one or more Tivoli Rule Engine processes, each consisting of a set of Tivoli rules. Rules consist of the following components: v The schedule that defines when the rule executes v The selections which define the entities (disks, files, processes) the rules should examine v The conditions for which the rules must look v Actions the rule should take if the condition is found to be true or false You can also write, test, and edit rules using the Tivoli Rule Designer. See Chapter 7, Working with the Tivoli Rule Designer on page 81 for more information. This chapter provides an explanation of the rules concepts and step-by-step instructions for related procedures. Table 8 provides an overview of the topics covered in this chapter. Table 8. Guidelines for Managing Rules Goal Refer To 1. Displaying the Manage Rules dialog box and selecting a rule to manage Displaying the Manage Rules dialog box and selecting a rule on page Firing a rule Firing a rule on page Enabling or disabling a rule Enabling or disabling a rule on page Viewing the Status of a Rule Viewing rule information on page Viewing the Code of a Rule 6. Viewing the Properties of a Rule 7. Defining the Rules of a Process Managing rules within a process on page 8. Copying a rule from one process to another process Moving a rule from one process to another process 10. Renaming a rule within a process 11. Deleting a rule from a process Displaying the Manage Rules dialog box and selecting a rule Objective To display the Manage Rules dialog box and select an individual rule to manage. 65

78 Background information You perform this procedure from the Tivoli Enterprise Manager. Use the Manage Rules dialog box to control a Tivoli rule process at the individual rule level. Managing rules includes the following: enabling and disabling rules; firing rules; examining rule properties; viewing rule status and code; and copying, moving, renaming, and deleting individual rules. Before you begin You must start the Tivoli Enterprise Manager. You must perform the steps in this procedure before you can manage a rule. When you finish None. Procedure You can perform this procedure from the Tivoli Enterprise Manager. 1. Do one of the following to display the Manage Rules dialog box: a. Click Manage from the Tivoli Enterprise Manager toolbar to display the Manage drop-down menu. b. Select Rules... to display the Manage Rules dialog box. OR a. Click the rule icon from the toolbar. OR a. Right-click empty space in the Managed Network View to display the Manage drop-down menu. b. Select Manage Rules... from the drop-down menu to display the Manage Rules dialog box. OR a. Right-click on a rule within a process to display the rule drop-down menu b. Select Manage from the drop-down menu to manage the rule. 2. Click the down arrow next to the Domain... text box to display the list of available domains. 66 IBM Tivoli Management Solution for Exchange: User s Guide

79 Additional Information: If you do not see the domain that you want, you need to add it to the available domains list. See Managing domains on page 47 for more information. 3. Select a domain from the Domain... text box list. 4. Click the down arrow next to the Computer: text box to display the list of available computers. Additional Information: If you do not see the computer that you want, you need to add it to the available computers list. See Managing computers on page 49 for more information. 5. Select a computer from the Computer... text box list. 6. Click the down arrow next to the Process... text box to display the list of available processes. 7. Select a process from the Process... text box list 8. Select the rule you want to manage from the Select a rule: list. Firing a rule Objective To execute a rule manually to check for conditions and perform necessary actions immediately. Background information The only types of rules that you can fire are rules that have an asynchronous schedule. You cannot fire a rule with the interval, time of day, or one-shot schedules. IBM Tivoli Management Solution for Exchange does not perform the request and returns an error if you attempt to fire a rule with a schedule type other than asynchronous. See Scheduling rules on page 85 for more information on scheduling rules. The Tivoli Rule Engine can execute one rule at a time. When you fire a rule, the Tivoli Rule Engine, if idle, executes the rule immediately. If the Tivoli Rule Engine receives a request to fire a rule while it is currently executing a rule or while others are waiting to be executed, it fires the rule after completing previous requests. Before you begin You perform this procedure from the Manage Rules dialog box. You must complete the steps in Displaying the Manage Rules dialog box and selecting a rule on page 65. When you finish If the rule fires successfully, the success message window is displayed. Click OK to close the message window. If the rule does not fire, an error message displays. Procedure You can perform this procedure from the Tivoli Enterprise Manager. Chapter 5. Managing rules 67

80 1. Display the Manage Rules dialog box. See step 1 on page 66 of Displaying the Manage Rules dialog box and selecting a rule on page 65 for more information. 2. Select a rule from the Select a rule: list. 3. Click Fire from the Rule Control panel of the Manage Rules dialog box. Enabling or disabling a rule Objective To enable a rule so the Tivoli Rule Engine can execute it when its next scheduled execution time occurs or to disable a rule to prevent the Tivoli Rule Engine from executing it. Background information A rule is in its normal state when it is enabled. When you disable a rule, you prevent the Tivoli Rule Engine from executing the disabled rule until you enable it again. You can enable a rule upon request manually, or you can enable a rule under program control by another rule. When you disable a rule, it is only disabled while in the currently running rule process. If you stop and restart the process for any reason, disabled rules are enabled. Before you begin You perform this procedure from the Manage Rules dialog box. See Displaying the Manage Rules dialog box and selecting a rule on page 65 for more information on how to display the Manage Rules dialog box. When you finish None. Procedure You can perform this procedure from the Tivoli Enterprise Manager. 1. Display the Manage Rules dialog box. See step 1 on page 66 of Displaying the Manage Rules dialog box and selecting a rule on page 65 for more information. 2. Select a rule or multiple rules from the Select a rule: list. 3. Do one of the following from the Rule Control panel of the Manage Rule dialog box: v Click Enable to enable the selected rule or rules. OR v Click Disable to disable the selected rule or rules. 68 IBM Tivoli Management Solution for Exchange: User s Guide

81 Viewing rule information Objective To display the status, code, or scheduling properties of a rule to obtain complete rule information. Background information The rule status includes the name of the rule and whether the rule is enabled or disabled. The rule code consists of actual statements that are executed by the Tivoli Rule Engine. The rule code is in ASCII language. The rule code defines the schedules, selections, and actions that define the mission of the rule. The Tivoli Rule Designer writes the rule code based on the choices you make in the Tivoli Rule Designer graphical user interface. Users can write the rule code using the Tivoli Rule Editor. See Chapter 7, Working with the Tivoli Rule Designer on page 81. The scheduling properties include the rule description, rule author, rule name, the type of schedule the rule uses, the details of the schedule including whether or not it is enabled or disabled, and what the user selections and thresholds are, if any. Before you begin You perform this procedure from the Manage Rules dialog box. See Displaying the Manage Rules dialog box and selecting a rule on page 65 for more information on how to display the Manage Rules dialog box. When you finish Close the view window when you finish viewing rule status, code, or properties. Procedure You can perform this procedure from the Tivoli Enterprise Manager Development View. 1. Display the Manage Rules dialog box. See step 1 on page 66 of Displaying the Manage Rules dialog box and selecting a rule on page 65 for more information. 2. Select a rule or multiple rules from the Select a rule: list. 3. Do one of the following from the Rule Control panel of the Manage Rule dialog box: v Click Status to display the rule status properties. OR v Click Code to display the rule code. OR v Click Properties to display the rule properties. 4. Click Close to close the window when you finish viewing rule status, code, or scheduling properties. Managing rules within a process Objective To define the rules of a process, copy, or move rules from one process to another, and to rename or delete a rule within a process. Chapter 5. Managing rules 69

82 Background information Defining the processes of a rule is the same as modifying the rule of a process. Modifying the process rules includes adding rules to and removing rules from a process, or changing the order of the rules in a process. The source rule is the copied rule within the Copy Rule dialog box. The new copy of the rule is the target rule. The target rule and source rule have the same name but you can change the target rule name by typing a new name into the Target rule text box. You can put a target rule in the same process as the source rule provided you give then different names. After the target rule is created, it is placed at the end of the target process rule list. If confirmation options are set to require confirmation for replacement options, the following message is displayed when you try to copy to an existing target rule: If confirmation options are set not to require confirmation for replacement options, an existing target rule is replaced with a copy of the source rule without prior confirmation. If the target process is running during the time in which you copy a rule, it is stopped and restarted after the rule is copied into the target process. Within the Move Rule dialog box, the source rule is the moved rule. The new name and location of the moved rule is the target rule. The target rule and source rule have the same name but you can change the target rule name by typing a new name into the Target rule text box. You can put a target rule in the same process as the source rule provided you give them different names. The target rule is placed at the end of the target process rule list. You can rename a rule within a process. In the Rename Rule window, the rule you are renaming is listed in the Old rule name: field. If you type a new name for an existing rule in the process that already exists, you are notified and the rename operation fails. If the rule process was running at the time of the rule rename, it stops and restarts after the successful rename rule operation. In the Delete Rule dialog box, the Rule to Delete: text box lists the rule that is targeted for deletion. If the rule process is running at the time you delete the rule, it stops and restarts after the successful delete rule operation. If the rule to delete is the only rule in the rule process, the rule process is also deleted. Before you begin You perform this procedure from the Manage Rules dialog box. See Displaying the Manage Rules dialog box and selecting a rule on page 65 for more information on how to display the Manage Rules dialog box. When you finish None. Procedure You can perform this procedure from the Tivoli Enterprise Manager Development View. 1. Display the Manage Rules dialog box. See Step 1 on page 66 of Displaying the Manage Rules dialog box and selecting a rule on page 65 for more information. 70 IBM Tivoli Management Solution for Exchange: User s Guide

83 2. Select a rule or multiple rules from the Select a rule: list. 3. Do one of the following from the Rule Control panel of the Manage Rule dialog box: a. Click Rules... to display the Modify Process Rules dialog box. b. Go to Step 4 on page 71. OR a. Click Copy to display the Copy Rule dialog box. b. Go to Step 5 on page 71. OR a. Click Move to display the Move Rule dialog box. b. Go to Step 5 on page 71. OR a. Click Rename display the Rename Rule dialog box. b. Go to Step 6 on page 72. OR a. Click Delete to display the Delete Rule dialog box. b. Go to Step 8 on page Do the following to modify the process rule: a. Click the down arrow on the Domain: text box to display the Domain: drop-down list. b. Select a domain. c. Click the down arrow on the Computer: text box to display the Computer: drop-down list. d. Select a computer. e. Click the down arrow on the Process: text box to display the Process: drop-down list. f. Select a process. g. Do one of the following to modify a process rule: 1) Select a rule or rules from the Available Rules: list. 2) Click Add to move the selected rules to the Selected Rules: list. OR 1) Select a rule or rules from the Selected Rules: list. 2) Click Remove to move the selected rules to the Available Rules: list. Additional Information: Click Source to open the Change source rule computer dialog box. See Changing the Source Rule Computer on page 45 for more information. h. Do one of the following to commit the changes: v Click Apply to commit the changes. OR v Click OK to commit the changes and close the Modify Process Rule dialog box. 5. Use the following steps to copy or move a rule from one process to another: a. Click the down arrow on the Source Domain: text box to display the Source Domain: drop-down list. b. Select a domain. c. Click the down arrow on the Source Computer: text box to display the Source Computer: drop-down list. Chapter 5. Managing rules 71

84 d. Select a computer. e. Click the down arrow on the Source Process: text box to display the Source Process: drop-down list. f. Select a process. g. Click the down arrow on the Source Rule: text box to display the Source Rule: drop-down list. h. Select a rule. i. Click the down arrow on the Target Domain: text box to display the Target Domain: drop-down list. j. Select a domain. k. Click the down arrow on the Target Computer: text box to display the Target Computer: drop-down list. l. Select a computer. m. Click the down arrow on the Target Process: text box to display the Target Process: drop-down list. n. Select a process. o. Do one of the following to commit the changes: v Click Apply to commit the changes. OR v Click OK to commit the changes and close the dialog box. 6. Type a new name for the rule in the text box. 7. Click OK to commit the change to the rule name. 8. Click OK to delete the rule in the text box. OR a. Type the name of the rule you want to delete. b. Click OK to delete the rule and close the Delete Rule dialog box. 9. Click Close to close the Manage Rules dialog box. 72 IBM Tivoli Management Solution for Exchange: User s Guide

85 Chapter 6. Managing solutions A solution is a pre-defined rule process designed to monitor a specific application. IBM Tivoli Management Solution for Exchange offers the following six solutions: v Admin v Exchange v Exchange 2000 v SQL Server 2000 v SQL Server 6.5 v SCL Server 7 Solutions differ from ordinary rule processes in that you can tailor their behavior while the solution is running. This chapter provides information about controlling the execution of Tivoli solutions on a network and step-by-step instructions for related procedures. Table 9 provides an overview of the topics covered in this chapter. Table 9. Guidelines for managing solutions Goal 1. Viewing and understanding the Tivoli Solutions Manager Refer to Displaying the Tivoli Solutions Manager on page Defining a set of solutions Adding and removing solutions on page Setting confirmation or success notifications 4. Changing thresholds or selections of a running process Setting Tivoli Solutions Manager options on page 76 Editing solution variables on page 77 Displaying the Tivoli Solutions Manager Objective To display the Tivoli Solutions Manager so you can manage solutions. Background information The Tivoli Solutions Manager uses variables to update computers throughout your IBM Tivoli Management Solution for Exchange network. A variable is a placeholder for a value or a set of values. The values control the behavior of solutions. Through the Tivoli Solutions Manager, you can edit variables on all IBM Tivoli Management Solution for Exchange computers in your network from a central location. The following displays the Tivoli Solutions Manager graphical user interface. Before you begin You must perform this procedure from the Tivoli Enterprise Manager Development View. When you finish None. 73

86 Procedure 1. Click Manage from the Tivoli Enterprise Manager to display the Manage drop-down menu. 2. Select Statistics... from the Manage drop-down menu to display the Tivoli Solutions Manager. Adding and removing solutions Objective To define the set of solutions so you can view and manage them through the Tivoli Enterprise Manager. Background information The Tivoli Enterprise Manager window displays a list of solutions for each computer managed by IBM Tivoli Management Solution for Exchange. You can increase or decrease the size of this list for a computer or group of computers. If you remove any solutions, you can add them back into the managed list at any time. When you select a domain or enterprise, the first computer in the domain or enterprise displays a list of solutions, and the available or managed state of solutions. Usually all computers in the domain or enterprise have the same set of solutions. Solutions that are not explicitly listed are not altered when computers within the same domain or enterprise have different solution sets. The Solution Set Driver File: Each solution managed by the Tivoli Solutions Manager must have a.sdd (solutions set driver) file. This file has the same name as the solution and a file extension of.sdd. For example, the solution set driver file for Exchange2000 is Exchange2000.ssd. This file must exist in the IBM Tivoli Management Solution for Exchange \config folder. If you are adding rules to an existing solution, add entries for variables that are used in your new rules to the existing solution set driver file. If you are creating a new solution, you must also create a new solution set driver file. Blank lines can exist anywhere in the file, and 74 IBM Tivoli Management Solution for Exchange: User s Guide

87 comments can be added by beginning a line with an exclamation point. The first three lines in the solution set driver file must be: RoboMon Solution Set Driver File Major Version Number: 1 Minor Version Number: 0 You must add the following lines for each variable that Tivoli Solutions Manager manages: Name: The name of the variable used in the rule or rules Display Name: The name of the variable displayed by the Tivoli Solutions Type: The data type of the variable (I, F, or S) Minimum Value: The minimum value of the variable (numeric data types only) Maximum Value: Default Value: The default (initial) value of the variable Units: The units associated with the value The maximum value of the variable (numeric data types only) Brief Description: The brief description displayed by the Tivoli Solutions Manager Full Description: The full description displayed by the Tivoli Solutions Manager Creating or Updating the Solution Variable File: Each solution has a default variable file where each variable used in all of its rules is maintained. This file is in the IBM Tivoli Management Solution for Exchange \config folder and is named solution.var where solution is the name of the solution. For example, the default variable file for Exchange2000 is Exchange2000.var. From a command window, execute the following command in the IBM Tivoli Management Solution for Exchange \bin folder: UpdateVarFile solution where solution is the name of the solution. This command creates a variable in the solution s default variable file for each variable defined in the solutions set driver file (.ssd), if it does not currently exist in the variable file. If you add new variables to the solution set driver file and run this command, these variables are created in the default variable file. Also, executing this command populates all the variables in the default variable file when you create a new solution and a corresponding solutions set driver file. Keeping Threshold Variables Updated: Each solution must include a rule that reads all threshold variables used in the solution. This rule name is Refresh_solution_Variables, where solution is the name of the solution. See the following example: Example: Refresh_Performance_Variables This rule is comprised of a list of READ actions, one for each threshold variable. You must also add any new threshold variable that you added to the solution to this list of READ actions. Before you begin You must perform this procedure from the Tivoli Enterprise Manager window. When you finish None. Procedure 1. Click the entity (enterprise, domain, or computer) for which you want to change solutions in the Managed Network view of the Tivoli Enterprise Manager window. Chapter 6. Managing solutions 75

88 2. Click Manage on the toolbar to display the Manage drop-down list. 3. Click Add/Remove Solutions to display the Add/Remove Solutions dialog box. Additional Information: The top part of the dialog box includes a label and an icon that indicates the entity you are about to change. 4. Do the following from the Add/Remove Solutions dialog box: a. Select one or more solutions from the Available solutions list that you want to add to the selected entity. b. Click Add to move the solutions to the Managed solutions list. c. Select one or more solutions from the Managed solutions list that you want to remove from the selected entity. d. Click Remove to move the undesired solutions to the Available solutions list. Note: If a solution is running when you remove it from the Managed solutions list, it automatically stops. OR e. Click Select All under the Available solutions list or the Managed solutions list. f. Click Add or Remove to move all of the selected solutions to the other list. OR g. Double-click a solution to transfer it from one list to another. h. Click OK to apply the changes to the lists. OR i. Click Cancel to cancel the changes to the lists. Setting Tivoli Solutions Manager options Objective To set Tivoli Solutions Manager so you can control whether the Tivoli Solutions Manager asks you for confirmations before performing specific operations. Background information The confirmation options control whether certain operations require confirmation and whether or not success messages display. Error messages always display; they are not optional. Two options are available: Confirm all update operations Select this option to have the Tivoli Solutions Manager identify and confirm the operation you are about to perform. Tivoli Solutions Manager performs requested operations without asking for confirmation if you do not select this option. Display success messages If you select this option, the Tivoli Solutions Manager informs you when the requested operation completes successfully. If you do not select this option, you do not receive a message indicating the operation was successful. The lack of a messages indicates success. Before you begin You must perform this procedure from the Tivoli Enterprise Manager. 76 IBM Tivoli Management Solution for Exchange: User s Guide

89 When you finish None Editing solution variables Procedure You can perform this procedure from the Tivoli Enterprise Manager Management View. 1. Click View on the Tivoli Solutions Management toolbar to display the View drop-down menu. 2. Click Options on the View drop-down menu to display the Options dialog box. 3. Check or uncheck one or both of the following options: v Confirm all update operations Additional Information: Tivoli Solutions Manager asks you to confirm the operation when Confirm all update operations is checked. Click Yes to perform the operation, or No to cancel the operation. v Display success message Additional Information: Tivoli Solutions Manager informs you that a requested operation was successfully performed when Display success message is checked. Click OK to dismiss the success message. Objective To change thresholds or selections of a running process so you can control the way the solutions behave. Background information A variable is a placeholder for a value or a set of values. The values control how the solution behaves. Using variables in a rule s selections and condition is the key to managing the rule with the Tivoli Solutions Manager. When a rule executes, the value of each variable used is read from the default variable file of the rule. You can change the value of these variables with the Tivoli Solutions Manager, which writes the changed value to the default variable file. The next time the rule executes, the new value is used without the need to change the rule or restart the rule process. See the following examples: v A rule s condition is: CPU_BUSY_PCT >CPU_BUSY_PCT_MAX v CPU_BUSY_PCT is the percentage of the computer s CPU that was busy during the interval. CPU_BUSY_PCT_MAX is a variable in the rule s default variable file containing the maximum value permitted for CPU_BUSY_PCT. If CPU_BUSY_PCT exceeds this value, the true actions of the rule execute. A rule s selection for PROCESS_NAME is: {PROCESS_NAME_SEL} PROCESS_NAME_SEL is a variable in the rule s default variable file containing a list of process names (separated by commas) that the rule examines. The rule executes for each process specified in this list. Variables must be enclosed in braces when used in selections. A solution set includes the variables. The following parts comprise a variable: Chapter 6. Managing solutions 77

90 v v v v v Name Value Type Units Description Before you begin You must perform this procedure from the Tivoli Enterprise Manager. When you finish None. Procedure 1. Click on enterprise, domain, or computer for which you want to change solutions in the Tivoli Enterprise Manager window. Additional Information: The available solution sets and their variables display on the right side of the screen. Note: Editing variables on the enterprise or a domain changes the variables on all of the computers in the selected enterprise or domain. 2. Display the Tivoli Solutions Management window: a. Click Manage on the Tivoli Enterprise Manager Management View toolbar to display the Manage drop-down menu. b. Click Tailor Solutions on the Manage drop-down menu to display the Tivoli Solutions Management window. OR a. Right-click on a computer or process in the Managed Network View window (left pane) to display a pop-up menu. b. Click Tailor or Tailor Solutions on the pop-up menu. 3. Click the tab in the Solution Sets window (right pane) that is labeled with the name of the solution that contains the variable you want to change. Additional Information: The Variable Display window is below the tab and contains a list of variables used by the solution. For each variable in the list the following information is provided next to the variable name: value, type, units, and description. 4. Edit the variable: a. Click on a variable in the Variable Display window. b. Display the Edit Variable window: 1) Click File on the Tivoli Solutions Management toolbar to display the File drop-down menu. 2) Click Edit Variable on the File drop-down menu. OR 1) Right-click on the variable in the list to display a pop-up menu. 2) Click Edit Variable on the pop-up menu. OR 1) Double-click the variable in the list. 78 IBM Tivoli Management Solution for Exchange: User s Guide

91 Additional Information: The variable to be edited is listed in the drop-down list at the top of the Edit Variable window. c. Click on the Variable Name drop-down list in the Edit Variable window and select another variable to change the variable to be edited. Additional Information: When a different variable is chosen, the information in the Edit Variable window changes to the information that is appropriate for the selected variable. d. Type the desired value for the variable in the Value field. Additional Information: The value of a variable can be changed according to its variable type. For example, if the variable type is integer and you try to change the variable s value to a, an error message is displayed. e. Click Refresh to restore the current settings of the variable and keep the Edit Variable window open to change another variable. OR f. Click Default to restore the predefined value of the variable and keep the Edit Variable window open to change another variable. OR g. Click Apply to apply the change to the current variable and keep the Edit Variable window open to change another variable. h. Click Yes or No in the message box asking if you want to update the changes you made to the current variable. v If yes, click OK in the message box stating that updating was successful. OR v Click OK to apply the change to the current variable and close the Edit Variable window. i. Click Cancel to cancel the changes and close the Edit Variable window. 5. Exit the Tivoli Solutions Manager: a. Click File on the Tivoli Solutions Manager toolbar. b. Click Close. Chapter 6. Managing solutions 79

92 80 IBM Tivoli Management Solution for Exchange: User s Guide

93 Chapter 7. Working with the Tivoli Rule Designer This chapter provides information about Tivoli rules, including how to create and modify rules. Table 10 provides an overview of the procedures for creating and editing rules. Table 10. Guidelines for creating and editing Tivoli rules Goal Refer to Creating New Rules 1. Creating a new rule with the Tivoli Rule Creating a new rule using the New Rule Designer Wizard on page 82 v Using the New Rule Wizard v Using the Tivoli Rule Designer Scheduling rules on page 85 Creating the schedule for a rule Creating the selections for a rule Managing rule selections on page 89 Creating the conditions for a rule Managing rule conditions on page 92 Creating the actions for a rule Creating the documentation for a rule Managing rule actions on page Creating rules manually using the Tivoli Rule Editor Editing Rules 3. Modifying rules with the Tivoli Rule Designer 4. Modifying rules manually using the Tivoli Rule Editor Documenting a rule on page 103 Creating rules manually using the Tivoli Rule Editor on page 105 Editing rules graphically using the Tivoli Rule Designer on page 104 Editing rules manually using the Tivoli Rule Editor on page 107 A Tivoli rule is a named entity that monitors a specific situation and takes appropriate corrective action or performs external notification, or both. A Tivoli rule contains four basic components that you can manage through the Tivoli Rule Designer: Schedule The schedule for a rule determines when the rule executes. Selection A set of selections defines which entities IBM Tivoli Management Solution for Exchange collects and uses to evaluate the rule condition. Examples of entities are disks, files, and processes. Condition The rule condition is an expression that evaluates to true or false. Ifno condition is entered, the rule evaluates to true. A condition can include any of the following items: statistics, user-defined statistics, variables, predefined variables, constants, operators, and functions. Action A Tivoli rule executes actions based on the evaluation of the rule condition. Actions determine how a Tivoli rule operates with other IBM Tivoli Management Solution for Exchange components. Actions also determine how IBM Tivoli Management Solution for Exchange corrects problems found on your computer. A rule must have at least one action. 81

94 Rules reside in rule files. You can place all rules in a single rule file or use several rule files to organize your rules. IBM Tivoli Management Solution for Exchange provides defined rules to which you can add new rules that are relevant to your organization. Rules are written in rule code statements and executed by the Tivoli Rule Engine. Rule code defines the rule name as well as the conditions, actions, schedule, and selections. Rule code is written in ASCII. You can create and edit rules through the Tivoli Rule Designer in the following two ways: v v The Tivoli Rule Designer graphical interface, from which you select the New Rule Wizard to create new rules. OR The Tivoli Rule Editor, an ASCII-based editor in which you type rule definition language code. Creating a new rule using the New Rule Wizard Objective To create a new rule through a graphical interface that satisfies unique requirements such as adding an or paging action. Background information There is a maximum of 50 rule processes per computer. You can give a rule any name, but spaces cannot be included in that name. The rule description is optional and does not affect the execution of the rule. You can use the rule description so other users can understand why the rule was created. Before you begin None. When you finish After completing the four parts of the New Rule Wizard and clicking Finish, you must use the Tivoli Rule Designer to specify at least one action for the rule ( Managing rule actions on page 96). You can also document the rule ( Documenting a rule on page 103), set the rule schedules ( Scheduling rules on page 85), specify rule selections ( Managing rule selections on page 89), and specify rule conditions ( Managing rule conditions on page 92) in the Tivoli Rule Designer. You can complete these operations in any order. Procedure You can perform this procedure from the Development View or Management View in the Tivoli Enterprise Manager window. 1. Start the New Rule Wizard by doing one of the following in the Development View or Management View: v Use the New Rule Wizard in the Development View or Management View: a. Select File from the toolbar to display the File drop-down menu. b. Select New Rule from the drop-down menu to display the New Rule Wizard - Step 1 dialog box. OR 82 IBM Tivoli Management Solution for Exchange: User s Guide

95 v Use the Tivoli Rule Designer in the Development View or Management View: a. Select Run from the toolbar to display the Run drop-down menu. b. Select Tivoli Rule Designer from the Run drop-down menu to display the Tivoli Rule Designer. Additional Information: If you are in Development View, an existing rule is displayed in the Tivoli Rule Designer if your source directory has rules in it. The New Rule Wizard window is displayed in Development View if there are no rules in the source directory. The New Rule Wizard window is always displayed in Management View. c. Do one of the following if the Tivoli Rule Designer window displays an existing rule: Use the menus: 1) Select File from the Tivoli Rule Designer toolbar to display the File drop-down menu. 2) Select New Rule from the File drop-down menu to display the New Rule Wizard - Step 1 dialog box. OR Click the New Rule icon to display the New Rule Wizard - Step 1 dialog box. OR Double-click on white space in the right pane of the Tivoli Enterprise Manager windowdevelopment View. 2. Do the following to name and describe the rule: a. Type the name of the new rule in the text box for the rule name. Chapter 7. Working with the Tivoli Rule Designer 83

96 Additional Information: This name must be unique within its directory. The name must begin with a character of the alphabet. b. Type a rule description. Additional Information: The rule description is optional and does not affect the execution of the rule. c. Do one of the following: v Click Next to display the New Rule Wizard - Step 2 dialog box. OR v Click Cancel to cancel the creation of the new rule. 3. Do the following to specify the statistic domain for the rule: a. Select the rule s statistic domain from the list. Additional Information: A short description of the statistic domain is displayed under the list of statistics. If you want to see a list of the statistics for the domain, click View Statistics to display the Statistics Listing window. Click Close when you finish viewing statistics. See Chapter 8, Working with the Tivoli Statistics Builder on page 111 for more information about statistic domains. b. Do one of the following: v Click Next to display the New Rule Wizard - Step 3 dialog box. OR v Click Back to go back to Step 1 of the New Rule Wizard and change the name or description of the rule. OR v Click Cancel to cancel the creation of the new rule. 4. Do the following to select a type of schedule for the rule: a. Select one of the scheduling options: Interval (e.g. run every 60 minutes) interval-based schedules are the most common type of schedule. For an interval-based schedule, you must specify the interval or frequency you want for rule execution in the Tivoli Rule Designer window after you finish the New Rule Wizard options. Time of day (e.g. run at 8:00 AM and 5:00 PM) Time of day schedules run at one or more times of the day that you specify. You specify or change Time of Day schedules in the Tivoli Rule Designer window after you finish the New Rule Wizard window. Run only once when the Tivoli rule process is started A rule that runs only once executes when you start the Tivoli rule process. This kind of schedule is often used for rules that initialize variables used in other rules or to announce that a Tivoli rule process has started. Run manually (from the user interface or from an action of another rule) A rule that runs manually (asynchronous rule) can be executed only from the Tivoli Enterprise Manager main window, or from another rule using the Execute Rule action. b. Do one of the following: v Click Next to display the New Rule Wizard - Final dialog box. OR 84 IBM Tivoli Management Solution for Exchange: User s Guide

97 Scheduling rules v Click Back to go back to Step 2 of the New Rule Wizard to change the statistic domain. OR v Click Cancel to cancel the creation of the new rule. 5. Review the properties for the rule and display the Tivoli Rule Designer by doing one of the following: v Click Finish to display the Tivoli Rule Designer so you can specify or modify the rule documentation, schedule, selections, condition, or actions. OR v Click Back to go back to Step 3 of the New Rule Wizard to change the type of schedule for the rule. OR v Click Cancel to cancel the creation of the new rule. Objective To set up the schedule that defines when the rule executes. Background information The Schedule window of the Tivoli Rule Designer shows the schedule type you selected in the procedure, Creating a New Rule Wizard (Step 4 on page 84). If you selected an Interval or Time of Day schedule, you can now specify restrictions for these types of schedules. The initial value assigned to an interval-based schedule is one hour, which means the rule executes every hour on the hour. Rules do not execute at the first scheduled interval when the rule is started. The rule s statistics are initialized at the time of the first scheduled interval when the rule is started. In subsequent intervals, the value of statistics that reflect activity during the interval can be calculated for a full interval. Time of Day schedules run at one or more times of the day that you specify. You can specify or change Time of Day schedules in the following two ways: v Type the time or times in the Time of day field of the Schedule window. OR v Access the Times of Day window where you can set times. There are six options for restricting schedules. Interval schedules can be restricted by using the Part of the Day restriction. Both Interval and Time of Day schedules can be restricted by the other five measures of time. Table 11 contains a list of the options and an example of each option for restricting schedules. Table 11. Examples of options for restricting a schedule Options Part of the Day (Interval only) Days of the Week Days of the Month Weeks of the Month Months of the Year Example A rule executes every 15 minutes, but only between the hours of 8:00 AM and 5:00 PM. A rule executes only Monday through Friday. A rule executes only on the first day of the month. A rule executes only on the first week of the month. A rule executes only during June and December. Chapter 7. Working with the Tivoli Rule Designer 85

98 Table 11. Examples of options for restricting a schedule (continued) Dates A rule executes only between March 1, 2002, and May 30, Before you begin Complete the procedure, Creating a new rule using the New Rule Wizard on page 82, which displays the Tivoli Rule Designer. When you finish After scheduling a rule, you must complete all of the other operations in the Tivoli Rule Designer that you have not yet completed, including Selections ( Managing rule selections on page 89), Condition ( Managing rule conditions on page 92), Actions ( Managing rule actions on page 96), and Documentation ( Documenting a rule on page 103). You can complete these operations in any order. At a minimum, you must specify an action for the rule. Procedure You can perform this procedure from the Tivoli Rule Designer only. 1. If the Schedule window is not active in the New Rule Designer window, click the Schedule tab. 2. If you need to change the type of schedule you selected in the New Rule Wizard procedure, Step 4 on page 84, select a different schedule type: v Interval v Time of day v Run only once when the Tivoli rule process is started v Run manually (from the user interface or from an action of another rule) 3. Depending on the schedule type you chose, do one of the following: v If you chose Interval, go to Step 4 on page 87. v If you chose Time of day, go to Step 5 on page IBM Tivoli Management Solution for Exchange: User s Guide

99 4. To specify the interval for an Interval schedule, do one of the following: v Type a value (in the hours:minutes:seconds format) in the field next to the Interval option. OR v Use the arrows to change the value. 5. To specify the time or times of day, do one of the following: v Type a list of times separated by commas in the Time of day field. OR v Click Modify next to the Time of day field to display the Times of Day window. 6. To use the Times of Day window to add a time of day to the current list of times, do the following: a. Do one of the following: v Type a new value in the Time to add field. OR v Use the arrows to change the value. b. Do one of the following: v Click Add to add this time to the list. OR v Click Cancel to close this window and discard any changes. 7. To use the Times of Day window to change a time in the list of current times: a. Click the time value you want to change in the Current times of day field. b. Click Modify. Additional Information: The time you selected is displayed in the Time to add field. c. Do one of the following: v Type a new value. OR v Use the arrows to change the value. d. Click Update to replace the time in the list with the new time. e. Click OK when finished updating the times. OR f. Click Cancel to close this window and discard any changes. 8. To use the Times of Day window to remove a time from the current list of times: a. Click the time value you want to remove in the Current times of day field. b. Click Remove. c. Click OK when finished removing times. OR d. Click Cancel to close this window and discard any changes. 9. To use the Times of Day window to remove all entries from the current list of times: a. Click Remove All. b. Click OK. OR c. Click Cancel to close this window and discard any changes. Chapter 7. Working with the Tivoli Rule Designer 87

100 10. To set restrictions for Interval or Time of day schedules, see Setting part of the day and dates on page 88 or Setting days, weeks, and months on page Save the schedule. a. Click File to display the File drop-down menu. b. Click Save from the drop-down menu to save the choices made in the Tivoli Rule Designer window. Setting part of the day and dates 1. Select Part of the day or Dates in the Restrictions list. Additional Information: When setting part of a day, the measure is a range of hours, minutes, and AM or PM. When setting dates, the measure is a range of months, days, and years. 2. Click Modify to specify the part of the day or date in the Parts of the Day or Dates window. 3. To add a part of the day or date range, do the following: a. Set the desired beginning and ending time or date in the Part of the day to add or Date range to add fields by doing the following: 1) Click the time or date component in either field. 2) Do one of the following: v Type a new value. OR v Use the arrows to change the value of the selected component. b. Click Include or Exclude if you are setting a date range. Note: Parts of the day restrictions do not include these options. For dates, it makes sense to specify only a date range to exclude if it is contained within a wider date range to include. c. Click Add to add the specified range to the list. d. Click OK when you are finished specifying the list of ranges. 4. To change a range, do the following: a. Select the range you want to change in the Current date ranges or Current parts of the day field. b. Click Modify to load the range into the two fields under Date range to add or Part of the day to add. c. Modify one or both of the range fields. d. Click Update to replace the range in the list. e. Do one of the following: v Click OK to apply the change. OR v Click Cancel to cancel the change. 5. To remove a range in the current list: a. Select the range you want to remove. b. Click Remove. c. Click OK. 6. To remove all entries from the list of ranges: a. Click Remove All. b. Click OK. 88 IBM Tivoli Management Solution for Exchange: User s Guide

101 Managing rule selections Setting days, weeks, and months 1. Select a restriction from the following options in the Restrictions list: v Days of the week v Days of the month v Weeks of the month v Months of the year 2. Click Modify under the Restrictions list to display the window appropriate for the restriction. 3. Do one of the following: v Click the days, weeks, or months that you want the rule to run. OR v Click Set All to check all days, weeks, or months. OR v Click Clear All to uncheck all days, weeks, or months. 4. Do one of the following: v Click OK after you select the desired days, weeks, or months to display the selection in the Restrictions list of the Schedule window. OR v Click Cancel to close this window and discard any changes. Objective To define which entities (such as disks, files, and processes) the rule should examine. Background information Selections limit the instances of the statistic domain that are considered for rule execution. Rule selections are meaningful only for rules in one of the enumerated statistic domains. There is a note near the bottom of the Selections window that states, No selections are permitted for a scalar rule if the statistic domain for the rule is scalar. Format for Selections: Selections are a list of values or value ranges separated by commas. A dash ( - ) separates the beginning and ending values of the range. An instance of the statistic domain is selected if the value of the selection statistic is one of the values in the list, or if it is contained within one of the ranges in the list. A selection can have only one item in the list, reducing it to a single value or range. There are three types of selections: v Simple Selections v Selections with Wildcards v Selections with Exceptions Simple selections: Selection statistics contain numeric or alphanumeric string values. The formatting syntax in the examples below applies to both kinds of statistics, but there are a few differences. When a range is specified for numeric statistics, it is evaluated numerically; when a range is specified for string statistics, it is evaluated alphabetically. Therefore, a numeric statistic with a value of 2 falls Chapter 7. Working with the Tivoli Rule Designer 89

102 within the range of However, a string statistic with a value of 2 does not fall within the range of 1-10, since 2 is alphabetically greater than 10. Also, the letters B (for Begin) and E (for End) can be used to refer to the smallest and largest possible values of a range. Therefore, the range B-99 means any number less than or equal to 99. Similarly, the range 1000-E means any number greater than or equal to Examples of simple selections: 1. The value must be The value must be between 1 and 100 TOM,DICK,HARRY The value must be either TOM, DICK or HARRY Selections with wildcards: Two special wildcard characters, * and %, can be used for string selection values, except in ranges. The * character matches any set of characters. For example, the selection value of A* matches any value beginning with an A. The selection value of *XYZ* matches any value containing the characters, XYZ. The % character matches any single character. For example, the selection value of A%CD matches any value containing four characters, where the first character is A, the third character is C, and the fourth character is D. Any character can be second. The all-inclusive wildcard value of * is the only time a wildcard value can be used in a numeric selection. Examples of selections containing wildcards: TOM,DICK,H* A*,CA-F,*X ABC% %_* The value must be either TOM, DICK, or anything beginning with an H The value must either begin with an A, fall in the range between CA and F, orendwithan X The value must be exactly four characters long, beginning with ABC The value must begin with a single character followed by an _ Selections with exceptions: Exceptions can be specified by entering E= followed by a list of values or ranges. When a list is specified in an exception, it must be enclosed in parentheses. A single value in an exception list can also contain wildcard characters if it is for a string statistic. The use of exceptions is meaningful only when a wider selection is also included. An instance of the statistic domain is selected if the value matches one of the non-exception values or ranges, and does not match one of the exception values or ranges. Examples of selections that include exceptions: T*,E=(TOM,TED),DICK AB*,E=(ABC-ABX) A*,E=*X Anything beginning with a T, but excluding TOM and TED, or DICK Anything beginning with AB but excluding anything in the range between ABC and ABX Anything beginning with an A, but not ending with an X 90 IBM Tivoli Management Solution for Exchange: User s Guide

103 E=(10,20-29,33) Everything except the following: 10, anything between 20 and 29, and 33 Before you begin Complete the procedure, Creating a new rule using the New Rule Wizard on page 82, which displays the Tivoli Rule Designer. When you finish After specifying the selections for a rule, you must complete all of the other operations in the Tivoli Rule Designer that you have not yet completed, including Schedule ( Scheduling rules on page 85), Condition ( Managing rule conditions on page 92), Actions ( Managing rule actions on page 96), and Documentation ( Documenting a rule on page 103). You can complete these operations in any order. At a minimum, you must specify an action for the rule. Procedure You can perform this procedure from the Tivoli Rule Designer only. 1. Click the Selections tab. 2. Select a different statistic from the Statistic drop-down list if the statistic domain is enumerated and the desired statistic is not showing. Additional Information: A description of the statistic is displayed under the statistic name. 3. Type the selections for this statistic in the Selection field. Additional Information: See Format for Selections on page Click Add to add the statistic and its associated selection to the Current Selections list. 5. Repeat Steps 2 4 of this procedure to enter additional selections. Note: The instances of the statistic domain considered for rule execution are those that match all selections. Each additional selection that you enter Chapter 7. Working with the Tivoli Rule Designer 91

104 Managing rule conditions has the potential of further reducing the number of instances the rule is considering. You cannot enter more than one selection for the same statistic. If you try to do this, the second entry replaces the existing one in the list. 6. To modify one of the Current Selections, do the following: a. Click an item in the Current Selections list. b. Click Modify to display the statistic and its selection in the Statistic and Selection fields above the list of current selections. c. Modify the selection in the Selection field. d. Click Update to put the modified selection back into the Current Selections list. 7. To remove one of the Current Selections, do the following: a. Click an item in the Current Selections list. b. Click Remove to remove the statistic and its selection from the Current Selections list. Objective To define the conditions for a rule to monitor. Background information The rule s condition is an expression that evaluates to True or False. A rule always evaluates to True if no condition is entered. A rule s condition can include any of the following items: Statistics Value or set of values that your computer collects. A statistic s value (or values) remains unchanged during the execution of the rule. User-defined statistics Statistics that are defined by the user based on the values of Tivoli statistics, constants, and operators. A user-defined statistic s value (or values) remains unchanged during the execution of the rule. Variables Placeholder for a value or set of values that can be changed by the actions of a rule. Variables can be explicitly set to a value or they can be set to the result of an expression. Variables provide programming capabilities. They enable you to pass information between different rules. Predefined variables One of a group of variables that contains information maintained by the executing role, such as status of the last action executed and the number of times the rule detected a problem. IBM Tivoli Management Solution for Exchange includes several predefined variables that contain information about the execution of the rule. Constants Numbers or string literals Operators Arithmetic, logical, and precedence operators such as +, =, and OR Functions Perform various operations 92 IBM Tivoli Management Solution for Exchange: User s Guide

105 The following are examples of a rule condition: v The CPU is more than 85% busy: CPU_BUSY_PCT >85 v A computer is not reachable with TCP/IP: IP_REACHABLE =0 v A service is not running: SERVICE_STATE <> RUNNING v A disk has less than 15% free space or it has less than 30 megabytes free: (DISK_FREE_PCT< 15) OR (DISK_FREE_MB < 30) v A process used no CPU time and has a working set of more than 1 million bytes: (PROCESS_CPU_PCT = 0) AND (PROCESS_WORKING_SET_BYTES > ) v An event in the Windows NT event log has a subtype of ERROR and was generated within the last day (86400 seconds): (EVT_SUBTYPE = ERROR ) AND (EVT_AGE_SECONDS < 86400) Before you begin Complete the procedure, Creating a new rule using the New Rule Wizard on page 82, which displays the Tivoli Rule Designer. When you finish After specifying the conditions for a rule, you must complete all of the other operations in the Tivoli Rule Designer that you have not yet completed, including Schedule ( Scheduling rules on page 85), Selections ( Managing rule selections on page 89), Actions ( Managing rule actions on page 96), and Documentation ( Documenting a rule on page 103). You can complete these operations in any order. At a minimum, you must specify an action for the rule. Procedure You can perform this procedure from the Tivoli Rule Designer only. Chapter 7. Working with the Tivoli Rule Designer 93

106 1. Click the Condition tab. 2. To include the value of a statistic in the expression for the condition, do the following: a. If the statistic you want to select is in a domain that is different from the one in the Domain drop-down list, select a different domain. Note: Other than the rule s statistic domain, only statistics from the scalar domains can be selected. Additional Information: The list of statistics in the Statistic list changes to contain the statistics for the selected domain. b. Do one of the following: v Select the name of the desired statistic in the Statistic list. OR v Type the statistic name in the Expression field. Additional Information: A description of the statistic is displayed below the Statistic list. c. Click Add Statistic to add the statistic to the rule s condition, which is displayed in the Expression field. 3. Include user-defined statistics, variables, and predefined variables by doing the following: a. Select existing User Defined Statistics, Variables, orpredefined Variables from the Class list. Additional Information: A list of items appropriate for the selected class is displayed in the field below the Class list. Note: You are not required to reference variables to be used in the rule condition. You can enter any variable in the rule condition by typing the variable name in the Expression field. 94 IBM Tivoli Management Solution for Exchange: User s Guide

107 b. Select the item you want to add from the list of items under the Class list. Additional Information: A description of the item is displayed below the Statistic list. c. Do one of the following: v Click Add Statistic or Add Variable under the list of user statistics to add the statistic or variable to the rule condition. OR v Type the statistic or variable name in the Expression field. Additional Information: The statistic or variable is displayed in the Expression field. 4. Define or modify user-defined statistics if desired: Note: Forming the expression that defines the statistic is similar to forming the rule condition. The expression for a statistic can include only statistic names, arithmetic operators, parentheses, and constants. A user-defined statistic s value (or values) remains unchanged during the execution of the rule. a. Select User Defined Statistic in the Class drop-down list. Additional Information: A User Statistics description is displayed under the Statistic field. b. Select the name of the statistic in the list under the Class list if you are modifying a previously defined user-defined statistic. c. Click Define User Statistic to display the User Defined Statistics window. d. Do one of the following: v Type the name of the user statistic you want to add in the User statistic name field. OR v Select an existing user statistic to modify. e. Select the desired domain in the Domain field if the statistic you want to add is in a different domain. f. Select the statistic you want to add from the Statistic field. Additional Information: The name of the statistic and a description of the statistic is displayed in the field under the Statistic field. g. Click Add Statistic to display the statistic in the Expression field. h. Do one of the following: v Add other statistics, arithmetic operators, parentheses, and any needed constants to the expression to form the expression that defines the statistic. OR v Type the statistic names, arithmetic operators, parentheses, and constants into the Expression field. i. Do one of the following: v Click Apply to add the user-defined statistic to the User statistic list and define another user-defined statistic. OR v Click OK to add the user-defined statistic to the User statistic list and return to the Condition window. OR Chapter 7. Working with the Tivoli Rule Designer 95

108 Managing rule actions v Click Cancel to cancel defining or modifying the user-defined statistic. 5. Include operators, functions, or constants in the expression for the condition as desired: a. Select Operators, Functions, orconstants from the Class list. Additional Information: A list of available items for the selected class is displayed in the field under the Class list, except for constants. b. Select the desired item from the list under the Class list if you selected Operators or Functions. Additional Information: The name of the operator or function and a description of the item is displayed in the field below the Statistic list. c. Make sure the cursor in the Expression field is in the desired location, and do one of the following to add an operator to the expression as needed: v Click Add Operator. OR v Click the button containing the operator symbol located below the Expression field. OR v Type the operator symbol in the Expression field. d. Do one of the following to add a function to the expression as needed: v Click Add Function. OR v Type the function in the Expression field. e. Type the constant (number or string literal) into the Expression field to add a constant to the expression as needed. Note: String constants must be enclosed in double quotes, and are case-sensitive. Additional Information: Examples of constants: DISK 6. Use the following options as needed while writing the expression: v Click Undo to undo the effect of your last action. v Click Redo to redo the last undo action. v Click Clear to clear the expression. v Click Revert to return the expression to its original form. v Click Test to check the validity of the expression. Objective To specify one or more actions for a rule so you can use the rule to detect and correct system and application problems. Background information Rule actions are divided into the following four categories: 96 IBM Tivoli Management Solution for Exchange: User s Guide

109 Notification actions A Tivoli rule communicates with you and with other IBM Tivoli Management Solution for Exchange components by executing a notification action. For example, you can write a rule to provide notification of an event and send an problem report. The rule action can drop insignificant events, escalate important events, or respond to defined relationships of multiple events. Corrective actions The corrective actions are used to correct problems found on your computer. These actions make changes to your computer. For example, a rule can be written to remove a large unused file. Also, a rule can correct a problem found on your computer by executing an operating system command. Rule control actions The rule control actions are used to control the execution of the current rule and other rules. For example, a rule can detect a problem and enable another rule for further investigation. Also, a rule can conditionally execute its actions by executing the If action. Variable management actions The variable management actions control variables. Variables add programming capabilities to rules. Table 12 contains a list of the actions for each of the four action categories. Table 12. Actions for each action category Action category Notification actions Corrective actions Rule Control actions Variable management actions Actions v Export v Log v Mail v Message Event v Page v Problem Event v SNMP Trap v Windows Event v v v v v v v v Copy Execute OS Command Execute SQL Priority Remove SNMP Set Terminate Working Set v v v v v v v v v v Disable Else Else If Enable End Execute Rule Exit If Action Modify Wait v v v v v v v v v v v Append Calculate Check Bounds Close Create Decrement Delete Increment Read Write Zero Types of actions: Actions are always maintained by action type. The following action types can be applied to a rule action: True True actions execute whenever the rule condition is true. False False actions execute whenever the rule condition is false. New New actions execute the first time the rule condition is true, or if the rule condition is currently true but was false in the previous interval. The use of new actions with different update actions can implement a problem escalation policy that treats problems more seriously after the first time the problem is found. Chapter 7. Working with the Tivoli Rule Designer 97

110 Update Update actions execute if the rule condition is true and was also true in the previous interval. The use of new actions with different update actions can implement a problem escalation policy that treats problems more seriously after the first time the problem was found. Close Close actions execute if the rule condition is false but was true in the previous interval. Close actions close a problem that once existed but is now no longer a problem. Prologue Prologue actions are meaningful only for rules that execute in enumerated statistic domains. The prologue actions execute once regardless of the rule condition before the execution of the rule in the enumerated statistic domain. A common use for prologue actions is to initialize counters or other variables. Epilogue Epilogue actions are meaningful only for rules that execute in enumerated statistic domains. The epilogue actions execute once regardless of the rule condition after the execution of the rule in the enumerated statistic domain. A common use for epilogue actions is to output or analyze summary information. For example, an epilogue action can output the number of processes for which the rule condition is true. Before you begin Complete the procedure, Creating a new rule using the New Rule Wizard on page 82, which displays the Tivoli Rule Designer. When you finish After specifying the actions for a rule, you must complete all of the other operations in the Tivoli Rule Designer that you have not yet completed, including Schedule ( Scheduling rules on page 85), Selections ( Managing rule selections on page 89), Condition ( Managing rule conditions on page 92), and Documentation ( Documenting a rule on page 103). You can complete these operations in any order. After specifying at least one action, you can save the rule. Procedure You can perform this procedure from the Tivoli Rule Designer only. 98 IBM Tivoli Management Solution for Exchange: User s Guide

111 1. Click the Actions tab in the Tivoli Rule Designer window. 2. To add an action to an empty list of actions or to the end of a list of actions, do the following: a. Make sure no existing action is selected. b. Select the desired action from the Action list. Additional Information: See Table 12 on page 97 for a list of actions. Also, notice the description of the selected action in the Actions window next to the Action list. For detailed information about each action, refer to Appendix D, Action list on page 263. c. Select the action type that you want to apply to the action from the Action type drop-down list. d. Click Add to display the window specific to the selected action. e. Complete the options in the action-specific window to add the new action to the end of the list of existing actions for the action type. Additional Information: All action-specific windows do not have the same requirements or options. See the following procedures in this manual for options that are applicable to many of the action-windows: v Setting a single or multiple values across rules in the action-specific window on page 101 v Changing computers from the action-specific window on page 102 v Defining an expression for an action from the action-specific window on page To insert an action in a list of existing actions, do the following: a. Select the action before which you want to insert the new action from the Existing actions list. b. Select the desired action in the Action list. c. Select the desired action type for the action in the Action type list. d. Click Insert to display the action-specific window. Chapter 7. Working with the Tivoli Rule Designer 99

112 e. Complete the action-specific window. f. Click OK to display the new action before the selected action in the Existing Actions list. 4. To to change the type of action, do the following: a. Select the action you want to change from the Existing actions list. b. Click Change Type to display the Change Action type dialog box. c. Select the new type of action in the Action type list. d. Click OK. Additional Information: The new action type is displayed next to the action in the Existing actions list. 5. To modify an action, do the following: a. Select the action from the Existing Actions list. b. Click Modify to display the action-specific window. c. Make the desired changes in the action-specific window. d. Click OK to apply the changes. Additional Information: The changes are displayed next to the action in the Existing actions list of the Action window. 6. To activate or inactivate an action, do the following: Additional Information: When an action is initially added, it is active as indicated by the check mark next to the action type. a. To activate an inactive action, do the following: 1) Select the action. 2) Click Activate. Additional Information: The X changes to a check mark. b. To inactivate an action, do the following: 1) Select the action from the Existing actions list. 2) Click Inactivate. Additional Information: The check mark changes to an X. Inactive actions are ignored when the rule executes. When you view the rule code, an inactive action is displayed as a comment. The advantage of inactivating an action over removing it is that it is easier to re-activate it at a later time. Also, you might want to build some capabilities into a rule (such as deleting files or processes) that you do not want to immediately execute. 7. To remove an action, do the following: a. Select the action. b. Click Remove. 8. To undo a removed action and return a previously removed action to the list of existing actions, click Undo Remove. 9. To change the position of an action (within its type) in the Existing Actions list, do the following: Note: You cannot move an action outside of its type when changing the order of actions because actions are always maintained by action type. a. Select the action to move. b. Click Move Up to move the action up in the list. c. Click Move Down to move the action down in the list. 100 IBM Tivoli Management Solution for Exchange: User s Guide

113 Setting a single or multiple values across rules in the action-specific window: Select or clear the Set to global scalar for all rules check box. Additional Information: If you check Set to global scalar for all rules, the variable has a single value across all rules executing in the same rule process. If not checked, the behavior depends on the rule statistic domain. For enumerated domains, the variable has a value for each instance of the statistic domain in which the rule executes. For scalar domains, the variable has a single value. Formatting symbols from the action-specific window: 1. Do one of the following: v If you need to insert a symbol and the symbol buttons are present and active, click Insert Symbol. v If you need to edit a previously inserted symbol, do the following: a. Select a symbol you want to edit. b. Click Edit Symbol to display the Symbol Formatting window. 2. If the statistic for which you want to substitute a symbol is in a domain that is different from the one in the Domain drop-down list, select a different domain. Note: Other than the rule statistic domain, only statistics from scalar domains can be selected. Additional Information: The list of statistics in the Statistic field changes to contain the statistics for the selected domain. 3. Do one of the following: v Select the name of the statistic from the Statistic list. Additional Information: A description of the statistic is displayed below the Statistic list, and the statistic name is moved to the Symbol to format field in the lower portion of the window. OR v Type the statistic name in the Symbol to format field. 4. Select Predefined Symbols, Predefined Variables, User Defined Statistics, or Variables from the Class list. Additional Information: A list of items appropriate for the selected class is displayed under the Class drop-down list. Note: Variables do not have to be referenced in the rule to enable symbol substitution. 5. Do one of the following: v Select the desired item from the list under the Class list. OR v Type the name of the statistic, symbol, or variable into the Symbol to format field. Additional Information: The name of the item and a description of the selected item is displayed below the Statistic list, and the item name is moved to the Symbol to format field in the lower portion of the window. 6. Select the desired format option from the Format list: v Natural (string or number) v Date v Time v Date and Time Chapter 7. Working with the Tivoli Rule Designer 101

114 7. Select the desired option for explicit length, explicit precision, zero fill, and digit separators from the Options list: v v v Explicit Length specifies the number of characters to allocate for the value of the symbol. If the length of the symbol is more than this number, it is truncated. If it is less than this number, space is added to equal Explicit Length (unless Zero Fill is also selected). Explicit Precision is valid for numeric values when the Format is Natural. Explicit Precision is the number of digits displayed to the right of the decimal point. If this value is zero, the decimal point is not displayed. For example, a value of 3.1 with an explicit precision of two is displayed as Zero Fill pertains to naturally formatted numbers only if the Explicit Length option is selected. If specified, the Zero Fill number is padded with zeroes rather than spaces. For example, a value of twenty that is right justified and zero filled to an explicit length of three and a precision of zero is displayed as 020. v Insert Digit Separators pertains to naturally formatted numbers only. If specified, the number is displayed with a digit separator (usually a comma) every three digits. For example, a value of one million is displayed as 1,000, Select one of the following desired justification options in the Justify list if the Explicit Length formatting option is selected: v Left v Center v Right Note: The justification option is available only when the Explicit Length option is selected. 9. Click OK when you are finished selecting options. Changing computers from the action-specific window: 1. Click Change Computer if the Change Computer button is active and you need to change the computer that is set to run the rule. Additional Information: The Computer Selection window is displayed. 2. Click Local Computer or Remote Computer in the Computer Selection window. Note: Symbol substitution, which allows you to substitute the current value of a symbol (such as a statistic or variable) in text, is supported for the Remote Computer selection. 3. Type the name of the desired remote computer in the Remote Computer field if you selected Remote Computer. 4. Click Insert Symbol or Edit Symbol to go to the Symbol Formatting window. 5. Click OK when finished. Defining an expression for an action from the action-specific window: 1. Click Define Expression if the Define Expression button is active and you need to write an expression. 102 IBM Tivoli Management Solution for Exchange: User s Guide

115 Documenting a rule Note: The method to define an expression for an action is identical to defining an expression for a rule condition. In the Tivoli Rule Designer, the Define an Expression window for an action is almost identical to the Condition window. 2. Use the following steps of the procedure, Managing rule conditions: v To include statistics, Step 2 on page 94 v To include user-defined statistics, variables, or predefined variables, Step 3 on page 94 v To define or modify user-defined statistics, Step 4 on page 95 Objective To provide information about a rule for future reference. Background information A rule s documentation consists of the description and the author. If you typed a description when you created the rule (New Rule Wizard Step 1), that information is displayed in the Description field of the Documentation window. The Class field indicates the domain name. Before you begin Complete the procedure, Creating a new rule using the New Rule Wizard on page 82, which displays the Tivoli Rule Designer. When you finish After documenting a rule, you must complete all of the other operations in the Tivoli Rule Designer that you have not yet completed, including Actions ( Managing rule actions on page 96), Schedule ( Scheduling rules on page 85), Selections ( Managing rule selections on page 89), and Condition ( Managing rule conditions on page 92). You can complete these operations in any order. At a minimum, you must specify an action for the rule. Procedure You can perform this procedure from the Tivoli Rule Designer only. Chapter 7. Working with the Tivoli Rule Designer 103

116 1. Click the Documentation tab. 2. Type or revise information about what the rule is checking, what actions it is set to take, and any dependencies with other rules in the Description field. 3. Type the name of the person, group, or organization that wrote the rule in the Author field. Editing rules graphically using the Tivoli Rule Designer Objective To modify rules by changing the condition, action, schedule, or selection. Background information None. Before you begin None. When you finish None. Procedure You can perform this procedure from the Tivoli Enterprise Manager Development View window only. 1. Do one of the following to select the rule you want to modify and open the Tivoli Rule Designer: v Use the Tivoli Enterprise Manager main toolbar: a. Select the name of the rule you want to modify in the right pane of the Tivoli Enterprise Manager window. b. Select Run from the toolbar to display the Run drop-down menu. c. Select Tivoli Rule Designer to display the Tivoli Rule Designer. 104 IBM Tivoli Management Solution for Exchange: User s Guide

117 OR v Double click on the name of the rule you want to edit in the right pane of the Tivoli Enterprise Manager window. 2. Select any of the five tabs in the Tivoli Rule Designer console to make desired changes in the information in these windows. See the following procedures in this manual for each tab: v Scheduling rules on page 85 v Managing rule selections on page 89 v Managing rule conditions on page 92 v Managing rule actions on page 96 v Documenting a rule on page Do the following to save the modifications: a. Select File from the toolbar to display the File drop-down menu. b. Do one of the following: v Select Save Rule from the drop-down menu to save the rule. OR v Select Save Rule As from the drop-down menu to save the rule with a different name. 4. Do the following to exit the Tivoli Rule Designer: a. Select File from the toolbar to display the File drop-down menu. b. Select Close from the File drop-down menu to close the Tivoli Rule Designer. Creating rules manually using the Tivoli Rule Editor Objective To use internal rule language to write a new rule to satisfy unique requirements. Background information IBM Tivoli Management Solution for Exchange provides defined rules to which you can add new rules that are relevant to your organization. Rules are written in rule code statements and executed by the Tivoli Rule Engine. Rule code defines the rule name as well as the conditions, actions, schedule, and selections. Rule code is written in ASCII. You can create and edit rules through the Tivoli Rule Designer in the following two ways: v v The Tivoli Rule Designer graphical interface, from which you select the New Rule Wizard to create new rules. OR The Tivoli Rule Editor, an ASCII-based editor in which you type rule definition language code. This procedure describes how to use the Tivoli Rule Editor to create new rules. Before you begin You must know how to use rule syntax to write new rules manually. See the online Rule Writing Reference for information about how to use rule syntax, or Appendix C, Rules syntax on page 227. When you finish None. Chapter 7. Working with the Tivoli Rule Designer 105

118 Procedure You can perform this procedure from the Tivoli Enterprise Manager window Development View or Management View. 1. Start the New Rule Wizard by doing one of the following in the Development View or Management View: v Use the New Rule Wizard in the Development View or Management View: a. Select File from the toolbar to display the File drop-down menu. b. Select New Rule from the drop-down menu to display the New Rule Wizard - Step 1 dialog box. v OR Use the Tivoli Rule Designer in the Development View or Management View: a. Select Run from the toolbar to display the Run drop-down menu. b. Select Tivoli Rule Designer from the Run drop-down menu to display the Tivoli Rule Designer. Additional Information: If you are in Development View, an existing rule is displayed in the Tivoli Rule Designer if your source directory has rules in it. The New Rule Wizard is displayed in Development View if there are no rules in the source directory. The New Rule Wizard is always displayed in Management View. c. Do one of the following if the Tivoli Rule Designer displays an existing rule: Use the menus: 1) Select File from the Tivoli Rule Designer toolbar to display the File drop-down menu. 2) Select New Rule from the File drop-down menu to display the New Rule Wizard - Step 1 dialog box. OR Click the New Rule icon to display the New Rule Wizard - Step 1 dialog box. OR v Double-click on white space in the right pane of the Tivoli Enterprise Manager Development View window. 2. Do the following to name and describe the rule: a. Type the name of the new rule in the text box for the rule name. Additional Information: This name must be unique within its directory. The name must begin with a character of the alphabet. b. Type a rule description. Additional Information: The rule description is optional and does not affect the execution of the rule. 3. Select the Manually Edit the Rule check box. 4. To cancel the creation of the new rule, click Cancel. 106 IBM Tivoli Management Solution for Exchange: User s Guide

119 5. Click Finish to display the Tivoli Rule Editor window for writing or editing the rule. 6. Type or edit the rule according to Appendix C, Rules syntax on page Do the following to save the rule while writing or editing the rule and when finished writing or editing the rule: a. Select File from the toolbar to display the File drop-down menu. b. Click Save Rule on the File drop-down menu to save the rule. 8. Do the following to verify the rule syntax: a. Select Run from the toolbar to display the Run drop-down menu. b. Click Verify on the Run drop-down menu. Editing rules manually using the Tivoli Rule Editor Objective To use internal rule language to edit an existing rule to satisfy unique requirements. Background information IBM Tivoli Management Solution for Exchange provides defined rules to which you can add new rules that are relevant to your organization. Rules are written in rule code statements and executed by the Tivoli Rule Engine. Rule code defines the rule name as well as the conditions, actions, schedule, and selections. Rule code is written in ASCII. You can create and edit rules through the Tivoli Rule Designer in the following two ways: v The Tivoli Rule Designer graphical interface, from which you select the New Rule Wizard to create new rules. OR Chapter 7. Working with the Tivoli Rule Designer 107

120 v The Tivoli Rule Editor, an ASCII-based editor in which you type rule definition language code. This procedure describes how to use the Tivoli Rule Editor to edit new rules. Before you begin You must know how to use rule syntax to write new rules manually. See the online Rule Writing Reference, or Appendix C, Rules syntax on page 227 for information about how to use rule syntax. When you finish None. Procedure You can perform this procedure from the Tivoli Enterprise Manager Development View window only. 1. Do one of the following to select the rule to edit, and to open the Tivoli Rule Designer or Tivoli Rule Editor: v Use the Tivoli Rule Designer: a. Select the name of the rule you want to modify in the right pane of the Tivoli Enterprise Manager window. b. Select Run from the toolbar menu to display the Run drop-down menu. c. Select Tivoli Rule Designer from the Run drop-down menu to display the Tivoli Rule Designer. OR v Double-click on the name of the rule you want to edit in the right pane of the Tivoli Enterprise Manager window Development View. Additional Information: If the rule was created manually, it is displayed in ASCII in the Tivoli Rule Editor window. If the rule was created with the Tivoli Rule Designer, it is displayed in the Tivoli Rule Designer. 2. If the rule is displayed in the Tivoli Rule Designer, do the following to convert the rule to ASCII: a. Select Rule from the toolbar to display the Rule drop-down menu. b. Select Convert to ASCII from the drop-down menu to display the Tivoli Rule Editor. Additional Information: A warning is displayed stating that this action will convert the rule to internal ASCII and that if you save the rule later, you cannot modify it graphically with the Tivoli Rule Designer. 3. Click No to keep the Tivoli Rule Designer in view if you do not want to edit the rule manually. 4. To edit the rule manually, do the following: a. Click Yes to display the Tivoli Rule Editor with the rule displayed in ASCII. b. Edit the rule according to the rule syntax in Appendix C, Rules syntax on page 227. c. Do one of the following: v Save the rule in the internal language by doing the following: 1) Select File from the toolbar to display the File drop-down menu. 2) Do one of the following: Select Save from the File drop-down menu to save the rule in the internal language. 108 IBM Tivoli Management Solution for Exchange: User s Guide

121 OR Select Save As to save the rule in the internal language with a different name. OR v Close the window without saving to discard the changes. d. Do the following to verify the rule syntax: 1) Select Run from the toolbar to display the Run drop-down menu. 2) Select Verify from the Run drop-down menu. Chapter 7. Working with the Tivoli Rule Designer 109

122 110 IBM Tivoli Management Solution for Exchange: User s Guide

123 Chapter 8. Working with the Tivoli Statistics Builder IBM Tivoli Management Solution for Exchange can collect a large number of statistics that can be evaluated to determine the health of a software or hardware component. The Tivoli Statistics Builder is used to define Tivoli statistics from the Windows NT Performance Monitor database, an ASCII file, an ODBC database, or SNMP variables. A statistic is a named value that can be used in Tivoli rules. Statistics can contain numeric values or alphanumeric character strings. The Tivoli Statistics Builder enables you to define how certain statistics obtain their values. When a Tivoli rule executes, the value of each statistic referenced is obtained according to this definition. The set of default statistics is fixed. However, additional statistics from the performance monitor, databases, or external files can be defined and added as needed. For example, if a computer is running a third-party product that posted statistics to the performance monitor database, IBM Tivoli Management Solution for Exchange can retrieve and evaluate those statistics when they are added to the Tivoli statistics database. This chapter provides an explanation of the processes and concepts of the Tivoli Statistics Builder and step-by-step instructions for related procedures. Table 13 on page 111 provides an overview of the topics covered in this chapter. Table 13. Guidelines for Managing Statistics Goal 1. Understanding the different statistic domains in the Tivoli Statistics Builder and how to use them 2. Working with statistic domains to control how process rule statistics obtain their values 3. Importing or exporting statistic domains using external definition (.edn) files so that multiple sites can use the same statistic domains. 4. Copying statistic domains so you can use them in at least one additional computer on the network. 5. Adding statistics to, modifying statistics within, and removing statistics from a Performance Monitor Statistic Domain so you can define how the statistics in the domain obtain their values. 6. Adding statistics to, modifying statistics within, and removing statistics from an ASCII file statistic domain so you can define how the statistics in the domain obtain their values. Refer To Understanding statistic domains on page 112 Working with statistic domains on page 113 Importing and exporting statistic domains on page 115 Copying statistic domains on page 115 Working with performance monitor statistic domains on page 116 Working with ASCII file statistic domains on page

124 Table 13. Guidelines for Managing Statistics (continued) Goal Refer To 7. Adding statistics to, modifying statistics within, and removing statistics from an ODBC Database statistic domain so you can define how the statistics in the domain obtain their values. 8. Adding statistics to, modifying statistics within, and removing statistics from an SNMP statistic domain so you can define how the statistics in the domain obtain their values. 9. Adding statistics to, modifying statistics within, or removing statistics from a COM statistic domain so you can define how the statistics in the domain obtain their values. Working with ODBC database statistic domains on page 121 Working with SNMP statistic domains on page 124 Working with COM statistic domains on page 125 Understanding statistic domains A statistic domain is a group of statistics collected from the same source. v The Performance Monitor tab of the Tivoli Statistics Builder window displays the list of statistic domains currently defined from the Windows NT Performance Monitor database. IBM Tivoli Management Solution for Exchange is shipped with statistic domains defined for many of the Windows NT Performance monitor objects. If you have layered or third-party software that creates additional Windows NT Performance monitor objects, you can use the Tivoli Statistics Builder window to define new statistic domains for these objects. v The ASCII File tab on the Tivoli Statistics Builder window displays the list of statistic domains currently defined from ASCII files. The Tivoli Statistics Builder can define additional statistic domains from any ASCII file in tabular format. v The ODBC Database tab displays the list of statistic domains currently defined from ODBC databases. You can define additional statistic domains from any ODBC database from the Tivoli Statistics Builder window. v The SNMP tab displays the list of statistic domains currently defined from SNMP variables. v The COM tab displays the list of statistic domains currently defined from COM objects. You can define additional statistic domains from any COM variable from the Tivoli Statistic Builder window. The left side of the Tivoli Statistics Builder main window shows the view of the network. Click on any computer to define or view Tivoli statistics for that computer. The right side of the Tivoli Statistics Builder main window has five tabs, one for each of the types of statistics domains. The following information displays for each statistic domain: Name Uniquely identifies the statistic domain. Definition This definition is either original or user. If the statistics domain definition is original, it was shipped with IBM Tivoli Management Solution for Exchange. A user definition is either a new statistic domain added by the 112 IBM Tivoli Management Solution for Exchange: User s Guide

125 user or a statistic domain that has been modified. An original definition cannot be removed. A user definition can either be removed or restored to its original definition, depending on whether or not there is an original definition. Type This is normally scalar or enumerated. However, for statistic domains defined from the Windows NT Performance Monitor database, this can also contain Does not exist or Mismatch. Does not exist means that the statistic domain does not exist as an object in the Windows NT Performance Monitor database, and therefore these statistics cannot be collected. Mismatch means that the statistic domain type (Scalar or Enumerated) differs from the object in the Windows NT Performance Monitor database. Use the Fix mismatch operation to change the statistic domain type to match the object in the Windows NT Performance Monitor database. Description The statistic domain description. Working with statistic domains Objective To work with statistic domains so you can control how process rule statistics obtain their values. Background information This procedure provides step-by-step instructions to perform the following tasks: Modify a statistic domain Modifies an existing statistic domain. Remove a statistic domain Removes a statistic domain from the Tivoli Statistics Builder. Restore a statistic domain to the original definition Restores a statistic domain to its original definition if it had an original definition, and was then modified by the user. Automatically fix a statistic domain mismatch A statistic domain mismatch occurs when a statistic domain type (Scalar or Enumerated) differs from the object in the Windows NT Performance Monitor database. A mismatch can occur only in Performance Monitor statistic domains. Before you begin None. When you finish None. Procedure 1. Open the Tivoli Enterprise Manager by doing the following: a. Click Start to display the Start menu. b. Click Programs from the Start menu to display the Programs menu. c. Click Tivoli Enterprise Management Solutions from the Programs menu to display the Tivoli Enterprise Management Solutions menu. d. Click Tivoli Enterprise Manager from the Tivoli Enterprise Management Solutions menu to open Tivoli Enterprise Manager. Chapter 8. Working with the Tivoli Statistics Builder 113

126 2. Open the Tivoli Statistics Builder by doing one of the following: v Click the Tivoli Statistics Builder icon. OR v Use the menu option by doing the following: a. Click Manage to display the Manage drop-down menu. b. Click Statistics from the Manage drop-down menu. 3. Do the following in any order to work with statistic domains: v Modify a statistic domain by doing the following: a. Click the tab for the type of statistic domain you want to work with from the right pane of the Tivoli Statistics Builder. b. Select the statistic domain you want to work with from the list. c. Click Domain from the Tivoli Statistics Builder to display the Domain drop-down menu. d. Click Modify from the Domain drop-down menu to display the General Information tab of the Statistic Domain dialog box. e. Make the modifications to the statistic domain in the General Information tab of the Statistic Domain dialog box. v v v Note: For details on statistic domain modifications, see the following: Working with performance monitor statistic domains on page 116 Working with ASCII file statistic domains on page 118 Working with ODBC database statistic domains on page 121 Working with SNMP statistic domains on page 124 Working with COM statistic domains on page 125 f. Click OK to save the changes. Remove a statistic domain by doing the following: a. Click Domain from the Tivoli Statistics Builder to display the Domain drop-down menu. b. Click Remove from the Domain drop-down menu to remove the selected statistic domain. c. Click OK to close the Remove message box. Restore a statistic domain to the original definition by doing the following: a. Click Domain from the Tivoli Statistics Builder to display the Domain drop-down menu. b. Click Restore Original from the Domain drop-down menu. c. Click OK to close the Statistic domain restored to the original definition message box. Automatically fix a statistic domain mismatch by doing the following: a. Click Domain from the Tivoli Statistics Builder to display the Domain drop-down menu. b. Click Fix Mismatch from the Domain drop-down menu. c. Click OK to close the Mismatch fixed message box. 114 IBM Tivoli Management Solution for Exchange: User s Guide

127 Importing and exporting statistic domains Objective To import or export a statistic domain using.edn (external definition) files so multiple sites can use the same statistic domains. Background information You can import a statistic domain on your hard drive into the Tivoli Statistics Builder or export a statistic domain to your hard drive from the Tivoli Statistics Builder. You might want to use the import feature to import the statistic domain from another site. For instance, you can also export a statistic domain to an external definition file (.edf) on your hard drive and the external definition file to another site. When an IBM Tivoli Management Solution for Exchange user at the other site receives the containing the external definition file (.edf), the user must then import the file to the Tivoli Statistics Builder before using it to create a statistic domain. You can use the import/export feature only with ASCII File, ODBC Database, and SNMP statistic domains. Before you begin None. When you finish None. Procedure 1. Click the tab for the statistic domain that you want to import or export in the right pane of the Tivoli Statistics Builder window. 2. Click Domain from the Tivoli Statistics Builder window to display the Domain drop-down menu. 3. Do one of the following from the Domain drop-down menu: v Select Import to import an.edf file: a. Navigate to the directory where the file you want to import exists. b. Select the.edf file you want to import. c. Click Open to import the file into the Tivoli Statistics Builder and add the new statistic domain. v OR Select Export to export an.edf: a. Navigate to the directory where you want to save the.edf. b. Click Save to create and save the.edf. Copying statistic domains Objective To copy a statistic domain so you can use the statistic domain in at least one additional computer on the network. Background information None. Before you begin None. Chapter 8. Working with the Tivoli Statistics Builder 115

128 When you finish None. Procedure 1. Click the tab for the statistic domain that you want to copy in the right pane of the Tivoli Statistics Builder window. 2. Click Domain from the Tivoli Statistics Builder to display the Domain drop-down menu. 3. Select Copy from the Domain drop-down menu to display the Copy to dialog box. 4. Select one of the following options: v Copy to the entire enterprise Go to Step 5. OR v Copy to each computer in this domain a. Click the down arrow on the text box to display the available domains. b. Select a domain from the list of available domains. c. Go to Step 5. OR v Copy to this computer a. Click the down arrow on the text box to display the available computers. b. Select a computer from the list of available computers. c. Go to Step Click OK to copy the statistic domain to the enterprise, domain, or computer you selected. Working with performance monitor statistic domains Objective To add statistics to, modify statistics within, or remove statistics from a Performance Monitor Statistic Domain so you can define how the statistics in the domain obtain their values. 116 IBM Tivoli Management Solution for Exchange: User s Guide

129 Background information A statistic domain defined from the Windows NT Performance Monitor database corresponds to a Windows NT object. Each counter in the Windows NT object can be defined as a Tivoli statistic. For enumerated domains, the instance name can also be defined as a Tivoli statistic. When these statistics are used in Tivoli rules, IBM Tivoli Management Solution for Exchange obtains a value for them by retrieving the value for the associated counter (or instance name) in the Windows NT object. Before you begin None. When you finish None. Procedure 1. Open the Tivoli Enterprise Manager by doing the following: a. Click Start to display the Start menu. b. Click Programs from the Start menu to display the Programs menu. c. Click Tivoli Enterprise Management Solutions from the Programs menu to display the Tivoli Enterprise Management Solutions menu. d. Click Tivoli Enterprise Manager from the Tivoli Enterprise Management Solutions menu to open Tivoli Enterprise Manager. 2. Open the Tivoli Statistics Builder by doing one of the following: v Click the Tivoli Statistics Builder icon. OR v Use the menu option by doing the following: a. Click Manage to display the Manage drop-down menu. b. Click Statistics from the Manage drop-down menu. 3. Select Performance Monitor to display the Performance Monitor tab. 4. Do the following in any order to work with performance monitor statistics: v Add a statistic in a performance monitor statistic domain by doing the following: a. Click the computer icon for the computer to which you want to add the statistics domain from the Network Display field. b. Click Domain to display the Domain drop-down menu. c. Click Add from the Domain drop-down menu to display thestatistic Domain from the Windows NT Performance Monitor dialog box. d. Click General Information to display the General Information tab. e. Click the down arrow on the Statistic domain name: text box to display the Statistic domain name: list. f. Select a statistic domain from the Statistic domain name: list. Additional Information: The statistic domain type (enumerated or scalar) and the number of Windows NT counters that are not currently associated with Tivoli statistics are displayed. g. Optional: Type a description of the statistic domain in the Description tab. h. Do one of the following: Add a statistic for each unused Windows NT counter, generating the Tivoli statistic name and statistic description. 1) Click Add All. Chapter 8. Working with the Tivoli Statistics Builder 117

130 2) Go to Step 4i. v v OR Add statistics individually by doing the following: 1) Click Statistics to display the Statistics tab. 2) Click the Windows NT Counter: down arrow to display the Windows NT Counter: list. 3) Select a Windows NT Counter from the drop-down list. 4) Optional: Change the statistic name, the statistics description, or the context status. i. Click OK to complete the procedure and close the dialog box. Modify a statistic in the performance monitor statistic domain by doing the following: a. Right-click the statistic domain that includes the statistic you want to modify from the right pane of the Tivoli Statistics Builder window to display a drop-down menu. b. Select Modify from the drop-down menu to display thestatistic Domain from the Windows NT Performance Monitor dialog box. Additional Information: When modifying a statistic domain, you cannot modify the statistic domain name. c. Click Statistics to display the Statistics tab. d. Select the statistic you want to modify from the Current statistics list. e. Click Modify. f. Make changes in either of the following text boxes: Statistic name: Statistic description: g. Click OK to commit the changes. Remove a statistic in the performance monitor statistic domain by doing the following: a. Select a statistic domain from the right pane of the Tivoli Statistics Builder window. b. Click Domain from the Tivoli Statistics Builder toolbar to display the Domain drop-down menu. c. Select Modify from the drop-down menu to display the Statistic Domain from the Windows NT Performance Monitor dialog box. d. Click Statistics tab to display the Statistics text box. e. Select the statistic you want to remove from the Current Statistics list. f. Click Remove to remove the statistic. g. Click OK to commit the changes. Working with ASCII file statistic domains Objective To add statistics to, modify statistics within, or remove statistics from an ASCII file statistic domain so you can define how the statistics in the domain obtain their values. Background information Define statistics from an ASCII file to enable IBM Tivoli Management Solution for Exchange to convert the data from utilities or other applications into Tivoli 118 IBM Tivoli Management Solution for Exchange: User s Guide

131 statistics. In some cases, IBM Tivoli Management Solution for Exchange can be instructed to execute an operating system command that creates this file. In other cases, the file already exists. The ASCII file must be in tabular form, where the columns of the table are delimited by white space (spaces or tabs) or a defined delimiter character (such as a comma or semi-colon). Each column corresponds to a Tivoli statistic, and each record corresponds to an instance of an enumerated statistic domain. When a Tivoli rule references these statistics, it executes for each record in the file. An ASCII file with one record can be used to define a scalar statistic domain. Before you begin None. When you finish None. Procedure 1. Open the Tivoli Statistics Builder. 2. Select ASCII File to display the The ASCII File tab. 3. Do the following in any order to work with ASCII File statistic domains: v Add an ASCII File statistic domain by doing the following: a. Click the computer icon for the computer to which you want to add the statistics domain from the Network Display field. b. Click Domain from the Tivoli Statistics Builder window to display the Domain drop-down menu. c. Select Add from the Domain drop-down menu to display the Statistic Domain from an ASCII File dialog box. d. Click General Information to display the General Information tab. e. Type the name that identifies the statistic domain. Note: The name must be unique across all Tivoli statistic domains. f. Optional: Type an operating system command in the OS Command: text box to specify any operating system command that IBM Tivoli Management Solution for Exchange executes before reading the specified file. g. Specify the path name by doing one of the following: Type the full path name of the ASCII file in the Data file: text box. OR Click Browse to find the file. h. Click the down arrow next to the Delimiter: text box to display the list of delimiters. i. Select a delimiter option. Additional Information: The list includes delimiters you can use to separate the columns in the specified data file. WHITESPACE refers to any number of spaces or tabs. You can type the delimiters in the text box instead of selecting them from the list. If you specify a comma as a delimiter, you must enclose it in quotes. See the following examples:,,,# j. Choose one of the following processing options: Read entire file at each collection Chapter 8. Working with the Tivoli Statistics Builder 119

132 OR Read from end of file after the first collection OR Read from end of file for every collection k. Select Skip options. Additional Information: You can select multiple skip options. If you select Skip Pattern, Skip to Pattern, orskip from Pattern, you must enter a string in the text box indicated next to the skip option. l. Optional: Click the Description tab to enter a description in the description text box. m. Click the Statistics tab to display the Statistics dialog box. n. Do the following in the Statistics dialog box to add a statistics. 1) Type a name in the Statistic name: text box. 2) Click the down arrow next to Data type: text box to display the list of data type options. 3) Select the data type. Additional Information: If you select String for the data type, you must type in a string length in the Length: text box or select a length from the list. 4) Optional: Type a description for the statistic in the Description tab. 5) Select one of the following context options from the Context options: field: Context statistic defined in statistic list Note: Check the Context statistic box next to the Statistic name: text box if the statistic uniquely identifies a record in the file. OR Generate a context statistic OR Scalar domain v Additional Information: The context statistic is the statistic that uniquely identifies the instance of an enumerated statistic domain. For example, process ID is the context statistic for the process statistic domain because process ID is unique across all processes on your computer. o. Click Add to commit the changes and add the statistic. Modify a statistic in the ASCII File Statistic Domain by doing the following: a. Right-click the statistic domain that includes the statistic you want to modify from the right pane of the Tivoli Statistics Builder window to display a drop-down menu. b. Click Modifyfrom the drop-down menu to display the Statistic Domain from the ASCII File dialog box. c. Click Statistics to display the Statistics tab. d. Select a statistic from the Current statistics: list. e. Make changes in any of the following text boxes: Statistic name 120 IBM Tivoli Management Solution for Exchange: User s Guide

133 v Data type Length Statistic description f. Click OK to commit the changes. Remove a statistic in the ASCII file statistic domain by doing the following: a. Select a statistic domain from the right pane of the Tivoli Statistics Builder window. b. Click Domain from the Tivoli Statistics Builder toolbar to display the Domain drop-down menu. c. Select Modify from the drop-down menu to display the Statistic Domain from the ASCII File dialog box. d. Click Statistics to display the Statistics tab. e. Select the statistic you want to remove from the Current statistics list. f. Click Remove to remove the statistic. g. Click OK to commit the changes. h. Click OK to commit the changes and close the Statistic Domain from the Windows NT Performance Monitor dialog box. Working with ODBC database statistic domains Objective To add statistics to, modify statistics within, or remove statistics from an ODBC Database statistic domain so you can define how the statistics in the domain obtain their values. Background information Define statistics from the ODBC database to enable IBM Tivoli Management Solution for Exchange to convert the data retrieved from an ODBC database into Tivoli statistics. Each column retrieved from the database corresponds to a Tivoli statistic, and each row retrieved from the database corresponds to an instance of an enumerated statistic domain. When a Tivoli rule references these statistics, it executes for each row retrieved from the database. Before you begin None. When you finish None. Procedure 1. Open the Tivoli Statistics Builder from the Tivoli Enterprise Manager. 2. Select ODBC Database to display the ODBC Database tab. 3. Do the following in any order to work with ODBC Database statistic domains: v Add an ODBC Database statistic domain by doing the following: a. Click the computer icon for the computer that contains the statistics domain that you want to work with from the Network Display field. b. Click Domain from the Tivoli Statistics Builder window to display the Domain drop-down menu. c. Select Add from the drop-down menu to display the Statistic Domain from an ODBC Database dialog box. d. Do the following from the General Information tab: Chapter 8. Working with the Tivoli Statistics Builder 121

134 1) Type the name in the Statistic domain name text box that identifies the statistic domain. Note: The name must be unique across all of the Tivoli statistic domains. 2) Type a data source name to access the database in the Data source (DSN) text box. 3) Type the statement to query the database in the Select statement text box. 4) Optional: Type the computer name that stores the database in the Computer text box. Additional Information: A blank entry refers to the local computer. This corresponds to the ODBC HOST attribute. 5) Optional: Type the ODBC attribute/value pairs that are required to properly access and process the database in the Connections options: text box. 6) Optional: Type the user identification string that you need to log into the database in the User ID text box. Additional Information: This corresponds to the ODBC UID attribute. If blank, the value from the registry entry for the database is used if one exists. 7) Optional: Type the password associated with the user ID used to log into the database in the Password: field. Additional Information: This corresponds to the ODBC PWD attribute. If you leave this text box blank, the value from the registry entry for the database, if one exists, is used. 8) Click the radio button that corresponds to one of the following Database processing options: Read entire database at each collection Each time a Tivoli rule that references any of the statistics in this statistic domain executes, the query to the database specified in the Select statement is issued and all returned rows are processed. OR Read new rows defined by this date/time column The first time a Tivoli rule that references any of the statistics in this domain executes, the query to the database specified in the Select statement is issued and all returned rows are processed. During subsequent executions of the rule, only newly added rows in the database are processed. You must specify a date/time column in the database that contains the date and time the row was added to the database. e. Optional: Type a description in the Description tab. f. Click Statistics to display the Statistics tab. g. Do the following in the Statistics tab: 1) Type a name in the Statistic name: text box. 2) Click the down arrow next to Data type: text box to display the list of data type options. 3) Select the data type. 4) Optional: Type a description for the statistic the Description text box. 122 IBM Tivoli Management Solution for Exchange: User s Guide

135 5) Select one of the following context options from the Context options: field: Context statistic defined in statistic list Additional Information: Check the Context statistic box next to the Statistic name: text box if the statistic uniquely identifies a record in the file. OR Generate a context statistic v v Additional Information: The context statistic is the statistic that uniquely identifies the instance of an enumerated statistic domain. For example, process ID is the context statistic for the process statistic domain because process ID is unique across all processes on your computer. h. Click Add to commit the changes and add the statistic. Modify a statistic in the ODBC data source statistic domain by doing the following: a. Right-click the statistic domain that includes the statistic you want to modify from the right pane of the Tivoli Statistics Builder to display a drop-down menu. b. Click Modifyfrom the drop-down menu to display the Statistic Domain from an ODBC Database dialog box. c. Click Statistics to display the Statistics tab. d. Select a statistic from the Current statistics list. e. Make changes in any of the following text boxes: Statistic name Data type Statistic description Context options f. Optional: Move the selected statistic up or down in the list of Current statistics by doing one of the following: Click Move Up to move the selected statistics up. OR Click Move Down to move the selected statistics down. g. Click OK to commit the changes. Remove a statistic in the ODBC data source statistic domain by doing the following: a. Select a statistic domain from the right pane of the Tivoli Statistics Builder window. b. Click Domain from the Tivoli Statistics Builder toolbar to display the Domain drop-down menu. c. Select Modify from the drop-down menu to display the Statistic Domain from an ODBC Data Source dialog box. d. Click Statistics to display the Statistics tab. e. Select the statistic you want to remove from the Current statistics list. f. Click Remove to remove the statistic. g. Click OK to commit the changes. Chapter 8. Working with the Tivoli Statistics Builder 123

136 Working with SNMP statistic domains Objective To add statistics to, modify statistics within, or remove statistics from an SNMP statistic domain so you can define how the statistics in the domain obtain their values. Background information Define statistics from SNMP variables to enable IBM Tivoli Management Solution for Exchange to convert the data in the SNMP variables into Tivoli statistics. Each defined SNMP variable corresponds to a Tivoli statistic. This is the first of two steps required to monitor SNMP variables. In this step, you associate SNMP variables with Tivoli statistics, independent of the IP address of the SNMP device. The second step is the creation of a rule that uses these statistics with the Tivoli Rule Designer. You specify the IP addresses of the SNMP devices you want to monitor in the rule s selections. The selection statistic is the name of the statistic domain followed by _IP_NAME. For example, the selection statistic for a statistic domain named CISCO is CISCO_IP_NAME. Before you begin None. When you finish None. Procedure 1. Open the Tivoli Statistics Builder from the Tivoli Enterprise Manager. 2. Select SNMP to display the SNMP tab. 3. Do the following in any order to work with SNMP statistics: v Add a statistic to an SNMP statistic domain by doing the following: a. Click the computer icon for the computer to which you want to add the statistics domain from the Network Display field. b. Click Domain from the Tivoli Statistics Builder window to display the Domain drop-down menu. c. Select Add from the drop-down menu to display the Statistic Domain from SNMP dialog box. d. Type a name for the statistic in the General Information tab. Note: The name must be unique across all of the Tivoli statistic domains. e. Optional: Type a description in the Description tab. f. Click Statistics to display the Statistics tab. g. Do the following in the Statistics tab: 1) Type a name in the Statistic name: text box. 2) Type the object identifier of the SNMP variable in the OID: text box. 3) Type a community name in the Community: text box. 4) Click the down arrow next to the Data type: text box to display the list of data type options. 5) Select the data type. 6) Type the timeout value in milliseconds used to retrieve the SNMP variable in the Timeout (milliseconds): text box. 7) Optional: Type a description for the statistic the Statistic description: text box. 124 IBM Tivoli Management Solution for Exchange: User s Guide

137 v v h. Click Add to commit the changes and add the statistic. Modify a statistic in an SNMP Statistic Domain by doing the following: a. Right-click the statistic domain that includes the statistic you want to modify from the right pane of the Tivoli Statistics Builder window to display a drop-down menu. b. Click Modify from the drop-down menu to display the Statistic Domain from SNMP dialog box. c. Click Statistics to display the Statistics tab. d. Select a statistic from the Current statistics: list. e. Make changes in any of the following text boxes: Statistic name: OID: Community: Data type: Timeout (milliseconds): Statistic description: f. Click OK to commit the changes. Remove a statistic in an SNMP Statistic Domain: a. Select a statistic domain from the right pane of the Tivoli Statistics Builder window. b. Click Domain from the Tivoli Statistics Builder toolbar to display the Domain drop-down menu. c. Select Modify from the drop-down menu to display the Statistic Domain from SNMP: dialog box. d. Click Statistics to display the Statistics tab. e. Select the statistic you want to remove from the Current statistics: list. f. Click Remove to remove the statistic. g. Click OK to commit the changes. Working with COM statistic domains Objective To add statistics to, modify statistics within, or remove statistics from a COM statistic domain so you can define how the statistics in the domain obtain their values. Background information Define statistics from a COM object to enable IBM Tivoli Management Solution for Exchange to convert the parameters of one or more methods of the COM object into Tivoli statistics. Each parameter corresponds to a Tivoli statistic. When you define Tivoli statistics for a parameter of a method, you must define Tivoli statistics for all of the parameters of the method. Parameters are either passed to or returned from a method of a COM object (or both). When a parameter is passed to a method, you must define the value passed as a constant or a variable enclosed in braces, for example, {VALUE1}. When a variable is passed, it must be defined in the rule process default variable file at the time the rule executes. For parameters that are used only to pass input to the method, the value of the corresponding Tivoli statistic is equal to the value passed. For parameters that return a value from the method, the value of the corresponding Tivoli statistic is the returned value from the method. Chapter 8. Working with the Tivoli Statistics Builder 125

138 Build the list of statistics for the currently selected method. You must define one statistic for each parameter of the method. The current number of parameters defined and the total number of parameters for the selected method are displayed in the upper right corner of the window. The currently defined statistics for the method are listed under Current statistics in the lower portion of the window. Before you begin None. When you finish None. Procedure 1. Open the Tivoli Statistics Builder from the Tivoli Enterprise Manager. 2. Click COM to display the COM statistic domains tab. 3. Do the following in any order to work with the COM statistic domains: v Add a COM statistic domain by doing the following: a. Click the computer icon for the computer that contains the statistics domain that you want to work with from the Network Display field. b. Click Domain from the Tivoli Statistics Builder window to display the Domain drop-down menu. c. Select Add from the drop-down menu to display the Statistic Domain from a COM Object dialog box. d. Do the following from the General Information tab: 1) Type the statistic domain name in the Statistic domain name text box. Note: The name must be unique across all of the Tivoli statistic domains. 2) Type a program ID in the COM program ID: text box. Additional Information: Click Browse to browse a list of program IDs for the COM objects on your computer. After you type or select or a program ID, all the methods for the COM object display. 3) Select a method from the Methods: list. 126 IBM Tivoli Management Solution for Exchange: User s Guide

139 Additional Information: For each method you select, you must define a Tivoli statistic for all of its parameters. The current number of parameters defined and the total number of parameters for the selected method display under the list of methods. You can click Remove to remove all Tivoli statistics for the method if you decide not to define any statistics for the method. e. Optional: Type a description in the Description tab. f. Click Statistics to display the Statistics tab. g. Do the following in the Statistics tab: 1) Click the down arrow next to the Parameters text box to display the parameters you must specify for the statistic. Additional Information: Only those parameters not currently associated with Tivoli statistics are available. The following displays when you select a parameter: Statistic name Data type Passing mechanism 2) Optional: Change the statistic name in the Statistic name: text box. 3) Type the value to pass for parameters with a passing mechanism of In or In/Out. v v Note: If the value is a variable, enclose the name of the variable in braces. 4) Optional: Type a description for the statistic the Statistic description text box. h. Click Add to commit the changes and add the statistic. Modify a statistic in the COM object source statistic domain by doing the following: a. Right-click the statistic domain that includes the statistic you want to modify from the right pane of the Tivoli Statistics Builder window to display a drop-down menu. b. Click Modify from the drop-down menu to display the Statistic Domain from a COM Object dialog box. c. Click Statistics to display the Statistics tab. d. Select a statistic from the Current statistics list. e. Make changes in any of the following text boxes: Parameter name Statistic name Value Statistic description Context options f. Click OK to commit the changes. Remove a statistic from the ODBC data source statistic domain by doing the following: a. Select a statistic domain from the right pane of the Tivoli Statistics Builder window. b. Click Domain from the Tivoli Statistics Builder toolbar to display the Domain drop-down menu. Chapter 8. Working with the Tivoli Statistics Builder 127

140 c. Select Modify from the drop-down menu to display the Statistic Domain from an ODBC Data Source dialog box. d. Click Statistics to display the Statistics tab. e. Select the statistic you want to remove from the Current statistics list. f. Click Remove to remove the statistic. g. Click OK to commit the changes. 128 IBM Tivoli Management Solution for Exchange: User s Guide

141 Chapter 9. Managing events This chapter explains how to manage events in IBM Tivoli Management Solution for Exchange by using the Tivoli Event Monitor and the Tivoli Event Configuration Manager. Table 14 provides an overview of the topics covered in this chapter. Table 14. Guidelines for Managing Events in IBM Tivoli Management Solution for Exchange Goal Refer to 1. Understanding how events are managed in the Tivoli Event Monitor 2. Understanding how to use the Tivoli Event Monitor graphical interface to view and monitor events 3. Configuring the Tivoli Event Monitor to display selected events by using a monitor or view filter. 4. Setting an alert severity in the Tivoli Event Monitor so you can have audible alert sounds for specified events. 5. Configuring settings and filters in the Tivoli Event Configuration Manager window so you can manage events and reduce network traffic. 6. Sending and receiving events between computers so you can manage events throughout the network. 7. Managing events using Tivoli Web Event Monitor so you can monitor events from an Internet browser. Understanding events in the Tivoli Event Monitor on page 129 Accessing and understanding the Tivoli Event Monitor window on page 130 Filtering events in Tivoli Event Monitor on page 134 Setting event alerts in Tivoli Event Monitor on page 145 Configuring settings and filters in the Event Configuration Manager on page 150 Sending and receiving events between computers on page 159 Managing events with Tivoli Web Event Monitor on page 165 Understanding events in the Tivoli Event Monitor An event is a notification of any significant change in the state of a system resource, network resource, or network application. It carries information about itself, including the class, identity, severity, location, and description. Tivoli rules create events and write performance data on the local computer. An event can be generated for a problem, for the resolution of a problem, or the successful completion of a task. The Tivoli Event Monitor is a graphical user interface used to view events. You can configure the monitor to display only the events you wish to view. The IBM Tivoli Management Solution for Exchange reads events from event databases. Each computer running IBM Tivoli Management Solution for Exchange has a local Tivoli Event Database where the events generated by that computer are stored. IBM Tivoli Management Solution for Exchange installs a Microsoft Jet Open DataBase Connectivity database with the Data Source Name of RoboMon Event Database. Tivoli provides files if it is necessary to convert Microsoft Jet to SQL Server. 129

142 The local Tivoli Event Database collects events that are forwarded from other computers in addition to those generated locally. The database is also used to temporarily store events to be forwarded if the target machine is not available to receive those events. See Configuring settings and filters in the Event Configuration Manager on page 150 for information on configuring the collection of events from other computers into one Tivoli Event Database. The Event Server is a central server that routes events between computers so that events can be consolidated for centralized monitoring or for remote actions. Events are routed in real time with guaranteed delivery using remote procedure call (RPC) along with a store and forward technology to ensure initially undeliverable events are eventually delivered. The Event Server creates an entry for each incoming event and evaluates the event against a rule base to determine whether it can respond to or modify the event automatically. The Event Server also updates the event monitor with the current event information. The Event Server: v v v v Uses a push mechanism to send data across the network only when there is a problem to report, making it scale well. Sends events to one or multiple destinations. Sends events to multiple destinations using either a flat configuration (all events go to A and B) or hierarchical forwarding structure (events go to the local/regional center, all regional centers send events on to the corporate center). Works out of the box using an Access database, but can use any Open DataBase Connectivity-compliant database for event/performance data storage (note Jet limit). The Tivoli Event Configuration Manager controls how IBM Tivoli Management Solution for Exchange routes events throughout the network. It also controls Event Server operational behaviors. The Tivoli Event Configuration Manager enables you to consolidate events and performance data from multiple computers. Accessing and understanding the Tivoli Event Monitor window Objective To access and understand the Tivoli Event Monitor so you can monitor events. Background information The Tivoli Event Monitor is a graphical user interface used to view and monitor events stored in a Tivoli Event Database. For more information about the Tivoli Event Monitor, see Understanding events in the Tivoli Event Monitor on page 129. Before you begin None. When you finish None. Procedure 1. Open IBM Tivoli Management Solution for Exchange. 2. Open the Tivoli Event Monitor by doing one of the following: v Click the Run Tivoli Event Monitor icon in the toolbar of IBM Tivoli Management Solution for Exchange. OR 130 IBM Tivoli Management Solution for Exchange: User s Guide

143 v Use the menu option by doing the following: a. Click Run to display the Run menu. b. Click Tivoli Event Monitor from the Run menu. 3. Choose which event database you want to view by doing the following: a. Click File to display the File menu. b. Click Open DSN from the File menu to display the available event databases. c. Click on an event database from the Open DSN menu to display that event database. 4. Optional: Create additional event databases by doing the following: a. Open the Control Panel. b. Optional: For Windows 2000 systems, double-click Administrative Tools. c. Double-click Data Sources (ODBC). d. Click Add to display the available drivers. e. Click a driver to use that driver for the database. f. Click Finish. Additional Information: One reason to create additional databases is to view a Tivoli Event Database on another computer. When viewing events on another computer, go to Tools Option Mark As Read. Uncheck Mark As Read so you do not inadvertently mark events as read in a database belonging to someone else. 5. Choose which monitor view to display by doing the following: a. Click Monitor to display the Monitor menu. b. Click Open from the Monitor menu to display the available monitor views. c. Click on a monitor view from the Monitor menu to display the selected monitor view. 6. Choose the events to view by doing one of the following: v Use the menu option by doing the following: a. Click View to display the View menu. b. Click Current View from the View menu to display the View options. c. Click on a view option from the Current View menu to display the events for that view. OR v Click on a view icon as defined in Table 15. Table 15. Tivoli Event Monitor View Icons Icon Represents Type SubType FixedState Class Open problems. Tivoli events. P (problem) N (new) or U (updated) N (not) or A (acknowledged) None Work in progress. Tivoli events. P (problem) N (new) or U (updated) P (progress) or F (fixed) None Closed problems. Tivoli events. Tivoli messages. Tivoli events. P (problem) C (closed) None None M (message) R None None Chapter 9. Managing events 131

144 Table 15. Tivoli Event Monitor View Icons (continued) Icon Represents Type SubType FixedState Class Tivoli SNMP traps. SNMP trap events that were generated by IBM Tivoli Management Solution for Exchange. Windows NT application messages. Windows NT security messages. Windows NT system messages. Other SNMP traps. SNMP trap events that were not generated by IBM Tivoli Management Solution for Exchange. OPCOM security messages. OPCOM system messages. M (message) S (SNMP) None None M (message) E (event) None Application M (message) E (event) None Security M (message) E (event) None System M (message) S (SNMP) None None M (message) O (OPCOM) None Security M (message) O (OPCOM) None System 7. Mark an event as read by doing one of the following: v Double-click on the event. OR v Use the right-click feature: a. Right-click on the event. b. Click Mark All As Read. v OR Use the menu: a. Click Event to display the Event menu. b. Click Mark All As Read from the Event menu to mark an event as read. Additional Information: Events that have not been read are displayed in bold. 8. Mark an event as unread by doing one of the following: v Use the right-click feature: a. Right-click on the event. b. Click Mark All As Unread. v OR Use the menu: a. Click Event to display the Event menu. 132 IBM Tivoli Management Solution for Exchange: User s Guide

145 b. Click Mark All As Unread from the Event menu to mark an event as unread. 9. Mark all events as read in the Monitor or View menus by doing the following: a. Do one of the following to choose all the events to mark as read: v Click View to display the View menu. OR v Click Monitor to display the Monitor menu. b. Click Mark All as Read to mark all events in that monitor or view read. 10. Acknowledge an event by doing the following: a. Click Event to display the Event menu. b. Click Acknowledge All in the Event menu to mark an event as acknowledged. Additional Information: Unacknowledged events are potential alert events. Tivoli Event Monitor records the date and time of the event acknowledgement, and the user name of the logged in account. The user name can be changed through Tools Option Username. 11. Acknowledge all events in either Monitor or View display by doing the following: a. Do one of the following to choose the grouping of events to mark as read: v Click View to display the View menu. OR v Click Monitor to display the Monitor menu. b. Click Acknowledge All from the Monitor or View menu. c. Click Yes on the confirmation screen to acknowledge all events in that monitor or view. 12. Automatically acknowledge events when read by doing the following: a. Click Tools to display the Tools menu. b. Click Option from the Tools menu to display the Option menu. c. Click Acknowledge from the Option menu to automatically acknowledge events that are displayed in the detail pane. 13. Type an update to the progress of an event by doing the following: a. Click Event to display the Event menu. b. Click Update Progress from the Event menu to display the Update Progress text box. c. Type update information in the Update Progress text box. d. Click OK to record the update. Additional Information: The text is displayed in the FixText field of the event that is not yet fixed. The event is acknowledged at this time, and left in a work-in-progress state. The text box records the user name, date, and time of the entry. 14. Update an event as a complete fix by doing one of the following: v Use the right-click feature: a. Right-click on the event. b. Click Complete Fix to display the Complete Fix text box. c. Type the fix information in the Complete Fix text box. d. Click OK to record the fix and leave the event in a fixed state. Chapter 9. Managing events 133

146 v OR Use the menu: a. Click Event to display the Event menu. b. Click Complete Fix from the Event menu to display the Complete Fix text box. c. Type the fix information in the Complete Fix text box. d. Click OK to record the fix and leave the event in a fixed state. Filtering events in Tivoli Event Monitor Objective To filter events by monitor or view so you can choose only the events you want to view. Background information Tivoli Event Monitor is a graphical user interface that you can use to view events. You can configure the Tivoli Event Monitor to display events of your choice by using a monitor or view filter. Events continue to be stored in the Event Database, but the Tivoli Event Monitor enables you to select only a portion of them to view. Setting an event filter is temporary, enabling you to select only a subset of records or history based on a view. Temporary filters stop when you select a different view. Before you begin None. When you finish None. Procedure 1. Open the Tivoli Event Monitor as described in Accessing and understanding the Tivoli Event Monitor window on page Do one of the following: v Filter a monitor by doing the following: a. Choose the monitor you want to filter by doing the following: 1) Click Monitor to display the Monitor menu. 2) Click Open from the Monitor menu to display the monitor options. 3) Click on the monitor from the Open menu to select that monitor for filtering. 134 IBM Tivoli Management Solution for Exchange: User s Guide

147 b. Click Monitor to display the Monitor menu. c. Click Filter from the Monitor menu to display the Filter screen. v OR Filter events by view by doing the following: a. Choose which view you want to filter by selecting one of the view icons. For icon definitions, see Table 15 on page 131. Chapter 9. Managing events 135

148 b. Click View to display the View menu. c. Click Filter in the View menu to display the Filter window. 3. Apply the filter to specific computers in the Computer tab by doing one of the following: v Type the computer names separated by commas. OR v Search for computers by doing the following: a. Click Browse. b. Click any check boxes next to the computers to filter. 136 IBM Tivoli Management Solution for Exchange: User s Guide

149 Additional Information: The filter is restricted to the computers specified. An empty computer field means the filter is unrestricted and returns all computers. 4. Click Days/Time to display the Days/Time tab. 5. Type the following information in the Days/Time tab to define when the event is active: Event Days: Set the number of days before the current day to display events for the current and prior days. The default is 30 days for the monitor filters and 0 days (today only) for the view filters. History Days: Set the number of additional days that events will be displayed when the temporary history filter is invoked. The default for this value is 1 day. From: Set the time of day the filter activates each day. Chapter 9. Managing events 137

150 To: Set the time of day the filter ends each day. 6. Click EventType/Class to display the EventType/Class tab. 7. Enter the following information: EventType: v Click Problem to accept incoming problem events. v Click Message to accept incoming message events. EventSubType: v Click New to accept new events. v Click Updated to accept updated events. v Click Closed to accept closed events. v Click Tivoli to accept Tivoli events. v Click NT Event to accept NT Events. v Click SNMP to accept SNMP events. v Click OPCOM to accept OPCOM events. Class: Type the class identification generated by the IBM Tivoli Management Solution for Exchange rule. Additional Information: Class should be an alphanumeric string that is no longer than 32 characters. Class is filtered using a universal string. SubClass: Type the subclass identification generated by the IBM Tivoli Management Solution for Exchange rule. Additional Information: Subclass should be an alphanumeric string that is no longer than 32 characters. SubClass is filtered using a universal string. 138 IBM Tivoli Management Solution for Exchange: User s Guide

151 8. Click Severity to display the Severity tab. Additional Information: Hold the cursor over a severity abbreviation to display the full name of the abbreviated severity. 9. Check any box to accept incoming events of a certain severity in the Severity tab. 10. Click Description to display the Description tab. 11. Enter the following information next to the corresponding radio button: BriefText: Type the brief text to accept any event containing that text. FullText: Type the full text to accept any event containing that text. Both: Type the text that is both brief and full to accept any event containing that text. Chapter 9. Managing events 139

152 12. Click Fix/Acknowledge to display the Fix/Acknowledge tab. 13. Restrict which events are displayed based on the database fields relating to fix and acknowledge in the Fix/Acknowledge tab: Fix Type Available: v Click None to accept events that have no specified fix type. v Click Manual to accept events that have a manual fix type. v Click Automatic to accept events that have an automatic fix type. Fixed State: v Click (N)ot Fixed to accept events in a not fixed state. v Click (A)cknowledged to accept events in an acknowledged state. v Click Work in (P)rogress to accept events in a work in progress state. v Click (F)ix Completed to accept events in a fix completed state. Acknowledged by: Type the user name who acknowledged the event. Fixer: Type the user name who is responsible for fixing the event. Fix Text: Type notes about the event fix for documentation. 140 IBM Tivoli Management Solution for Exchange: User s Guide

153 14. Click Advanced to display the Advanced tab. 15. Type the following information: UserName Type the account used to log into the network to accept events from that user name. RuleName Type the name of the IBM Tivoli Management Solution for Exchange rule that captured the event to accept events containing that rule name. EntityContext Type any identification generated by the IBM Tivoli Management Solution for Exchange rule to accept events containing that entity context. Source Type the process from which an event was captured to accept events containing that source. Additional Information: Source is most often used with Windows NT Events. Handle Type a name to be associated with the problem to accept events containing that handle. Additional Information: If this is not specified, a default one is formed by the rule engine. The default handle name includes the rule name, context, and the creation date and time of the event. Handle is most often used with Windows NT Events. 16. Click OK to save your filter settings. 17. Optional: Arrange the view of the Monitor display by doing the following: a. Click Monitor to display the Monitor menu. b. Click Open from the Monitor menu to display the list of event categories. c. Click the event category to view events for that category. d. Click View to display the the View menu. Chapter 9. Managing events 141

154 e. Click Show Fields from the View menu to display the Show Fields screen. f. Double-click on an available field to move that field to the Show these fields in this order field. Additional Information: Click on a field in the Show these fields in this order field and click Remove to move that field to the Available fields column. g. Click on a field in the Show these fields in this order field. h. Do one of the following to change the order in which the fields are displayed: v Click Move Up to move the field up in order of display. OR v Click Move Down to move the field down in order of display. Additional Information: Fields in parentheses indicate an icon rather than text field. Severity is the severity text while (Severity) is the severity icon. i. Click OK to save your changes and close the Show Fields screen. 18. Optional: Sort the event display by doing the following: 142 IBM Tivoli Management Solution for Exchange: User s Guide

155 a. Click View to display the View menu. b. Click Sort from the View menu to display the Sort screen. c. Double-click on an available field to move that field to the Sort order column. Additional Information: Click on a field in the Sort order column and click Remove to move that field to the Available fields column. d. Click on a field in the Sort order column. e. Move the field by doing one of the following: v Click Move Up to move the field up in order of display. OR v Click Move Down to move the field down in order of display. Additional Information: Click Ascending to display the field in ascending order. Click Descending to display the field in descending order. f. Click OK to save your changes and close the Sort screen. Chapter 9. Managing events 143

156 19. Optional: Choose a different view icon by doing the following: a. Click on the icon you wish to change. The example below shows the Open Problems icon selected. b. Click View to display the View menu. 144 IBM Tivoli Management Solution for Exchange: User s Guide

157 c. Click Choose Icon from the View menu to display the Choose Icon screen. d. Choose a different icon for the view by doing one of the following: v Click on the icon button. OR v Scroll through the list of icons. Additional Information: Click Delete to delete the selected view icon from the list of available view icons. Delete is not available for the standard icons. If you delete an icon that is in use by any monitor definition, the icon displays as the Generic icon. Click Add to add icons to the list of available icons using the Add View Icon screen. e. Click OK to select the icon for the specified view and close the Choose View Icon screen. The selected icon appears in place of the previous icon. Setting event alerts in Tivoli Event Monitor Objective To set an alert severity in the Tivoli Event Monitor so you can have audible alert sounds for specified events. Chapter 9. Managing events 145

158 Background information An alert event is an unacknowledged event that matches the alert severity criteria for the displayed view. Alert events are marked with an exclamation point icon. Any view icon containing an alert event is marked with a red box around the icon. Before you begin None. When you finish None. Procedure 1. Open the Tivoli Event Monitor as described in Accessing and understanding the Tivoli Event Monitor window on page Choose a group of events for which you want to set alerts by doing one of the following: v Set event alerts for a monitor by doing the following: a. Click Monitor to display the Monitor menu. b. Click Open from the Monitor menu to display the monitor options. c. Click on the monitor from the Open menu to select that monitor to set alerts. OR v Select a view icon for which you want to set alerts. For icon definitions, see Table 15 on page Click View to display the View menu. 146 IBM Tivoli Management Solution for Exchange: User s Guide

159 4. Click Alert Severities from the View menu to display the Alert Severities screen. 5. Click on a severity check box to create an alert state for all unacknowledged events for that severity. 6. Optional: Choose an alert sound by doing the following: a. Click Monitor to display the Monitor menu. Chapter 9. Managing events 147

160 b. Click Alert Sounds from the Monitor menu to display the Alert Sounds screen. c. Click radio buttons for any of the nine severity levels to choose a sound alert for that event. d. Optional: Choose an alternate sound by clicking Choose Sound to display a selection of sounds. 7. Optional: Choose the event text color and icon for severities by doing the following: a. Click Monitor to display the Monitor menu. 148 IBM Tivoli Management Solution for Exchange: User s Guide

161 b. Click Format Severity in the Monitor menu to display the Format Severity screen. c. Click on a severity check box to select the severity for modification. d. Optional: Click Choose Color to select a different text color for the severity. e. Optional: Click Choose Icon to select a different icon for the severity from the Choose Severity Icon screen. f. Enable the sound function by doing the following: 1) Click Tools to display the Tools menu. 2) Click Option in the Tools menu to display the Options menu. 3) Click Alert Sound Enabled to display a check mark next to the option to enable the sound function. g. Optional: Choose to set an interval between alert sounds by doing the following: 1) Click Tools to display the Tools menu. 2) Click Option in the Tools menu to display the Options menu. 3) Click Alert Play Interval to display the Alert Play Interval screen. 4) Type the number of seconds to occur between alert sounds. Chapter 9. Managing events 149

162 Additional Information: The minimum is 10 seconds. At the end of this interval the event monitor determines whether a more severe alert has occurred and plays the sound, if any, associated with that severity level provided that Alert Sound Enabled is on. h. Optional: Choose to set an alert snooze interval by doing the following: 1) Click Tools to display the Tools menu. 2) Click Option in the Tools menu to display the Options menu. 3) Click Alert Snooze Interval to display the Alert Snooze Interval screen. 4) Type the minimum number of seconds before an alert sound for a severity level can repeat. Additional Information: At the end of this interval, a previously played sound for a severity level expires. If there are still alerts of this severity level, the sound is eligible to play again. Configuring settings and filters in the Event Configuration Manager Objective To configure settings and filters in the Tivoli Event Configuration Manager window so you can manage events and reduce network traffic. Background information The Tivoli Event Configuration Manager is designed to enable complete management and control of the Event Server from anywhere on the network. The Event Server provides reliable event delivery using database store and forward and remote procedure call (RPC). The Event Server uses Open DataBase Connectivity to operate on its local event database. The Event Server provides an event forwarding architecture. This gives IBM Tivoli Management Solution for Exchange the ability for a computer to receive an event from another computer and forward it to a third computer. The forwarding ability handles looping by incrementing the hops counter on each forward. An event is discarded when the hops counter exceeds the allowable number of hops (defined by a registry key, normally three). One of the debugging levels log events that are dropped if there are too many hops. Within the event forwarding architecture, the originating computer and event sequence number is preserved. This value forms the event record primary key. It prevents the posting of duplicate events to the same computer through two or more forwarding paths. This originating number and computer name is generated when an event is loaded into the Local Inbox Database. The Open DataBase Connectivity event database must support the identity characteristic on a column (SQL Server terminology). Writing an event to the Local Inbox Database generates an incrementing sequence number. Note: For Access, the identity characteristic is called auto numbering. The Tivoli Event Configuration Manager is used to edit different Event Server configuration categories across the Enterprise. The Tivoli Event Configuration Manager represents the network using the Windows NT domain and computer networking hierarchy. Event Server configuration settings are all of the miscellaneous forwarding, timing, retention, and optimization parameters for the Event Server. 150 IBM Tivoli Management Solution for Exchange: User s Guide

163 Before you begin None. When you finish None. Procedure 1. Open IBM Tivoli Management Solution for Exchange. 2. Open the Tivoli Event Configuration Manager by doing one of the following: v Click the Tivoli Event Configuration Manager icon. v OR Use the menu by doing the following: a. Click Manage to display the Manage menu. Chapter 9. Managing events 151

164 b. Click Event Server from the Manage menu to display the Tivoli Event Configuration Manager screen. 3. Configure settings by typing the following: Maximum hops: Type the maximum number of times an event can be forwarded from computer to computer before it is discarded. Inbox timer: Type the number of seconds the Event Server waits before polling the Inbox for new events. Outbox timer: Type the number of seconds the Event Server waits before retrying the sending of undeliverable remote events. Log file age: Type the number of days to retain Event Server daily log files. Debug mode: Type the level of debugging information that should be included in the events. Additional Information: Debugging information is written to a daily log file in the IBM Tivoli Management Solution for Exchange\logs directory. The file is named Event_server_yyyy_mm_dd.LOG, where yyyy is the year, mm is the month and dd is the day. The levels of debugging range from 0 (no debugging) to 4 (full debugging). Level 1 is the normal level for debugging. Debugging levels are synonymous with logging levels. Maintain events for (Auto Clean Filter): Type the number of days to automatically remove events from the local event database. Additional Information: The filter thread runs once daily at midnight to remove events from the local event database that match the filter specification. The filter specification normally includes an event age filter, so that events are cleaned based on age. 152 IBM Tivoli Management Solution for Exchange: User s Guide

165 Maintain perf. data for (Performance Data Retention Age): Type the number of days to automatically remove performance data from the Performance database. Additional Information: The filter thread runs once daily at midnight to remove events from the Performance database that match the filter specification. Performance routing timer: Type the number of seconds the Event Server waits before retrying to send remote performance data. 4. Select Windows NT event filter in the Network Display field to display the Windows NT filter. 5. Enter the following information: Receive Windows NT Events v Click System to receive system events. v Click Security to receive security events. v Click Application to receive application events. v Type the number days in Attempt redelivery for to indicate how many days the system attempts redelivery of events. UserNames: Type the account used to log into the network to accept events from that user name. Source: Type the process that an event was captured from to accept events containing that source. Sub Class: Type the subclass identification generated by the IBM Tivoli Management Solution for Exchange rule. Additional Information: The subclass should be an alphanumeric string that is no longer than 32 characters. Chapter 9. Managing events 153

166 Handle: Type a name to be associated with the problem to accept events containing that handle. Additional Information: If this is not specified a default one is formed by the rule engine. The default handle name includes the rule name, context, and the creation date and time of the event. 6. Click SNMP trap filter in the Network Display field to display the SNMP Trap filter. 7. Type the following information: SNMP Traps: Click to accept SNMP Trap events. Attempt redelivery for Type the number days the system attempts redelivery of events. UserNames: Type the account used to log into the network to accept events from that user name. Class: Type the class identification generated by the IBM Tivoli Management Solution for Exchange rule. Additional Information: The Class should be an alphanumeric string that is no longer than 32 characters. Class is filtered using a universe string. Sub Class: Type the subclass identification generated by the IBM Tivoli Management Solution for Exchange rule. Additional Information: The subclass should be an alphanumeric string that is no longer than 32 characters. RuleName: Type the name of the IBM Tivoli Management Solution for Exchange rule that captured the event to accept events containing that rule name. 154 IBM Tivoli Management Solution for Exchange: User s Guide

167 EntityContext: Type the entity context identification generated by the IBM Tivoli Management Solution for Exchange rule. 8. Click Local event filter in the Network Display field to display the Local event filter. Additional Information: The local event filter is used to exclude Windows NT events from being transferred to the current computer from any other source. 9. Apply the filter to specific computers in the Computer tab by doing one of the following: v Enter the computer names in the universal string. OR v Search for computers by doing the following: a. Click Browse. b. Check boxes next to the any computer to filter. Additional Information: The filter is restricted to the computers specified in the universal string in the Computer field of the Computers tab. An empty computer field means the filter is unrestricted and returns all computers. Chapter 9. Managing events 155

168 10. Click EventType/Class tab to display the EventType/Class filter. 11. Check or type information as appropriate for the following options: EventType: v Click Problem to accept incoming problem events. v Click Message to accept incoming message events. EventSubType: v Click New to accept new events for the selected EventType events. v Click Updated to accept updated events for the selected EventType events. v Click Closed to accept closed events for the selected EventType events. v Click Tivoli to accept Tivoli events for the selected EventType events. v Click Event Log to accept Event Log events for the selected EventType events. v Click SNMP to accept SNMP events for the selected EventType events. v Click Opcom to accept Opcom events for the selected EventType events. Class Type the class identification generated by the IBM Tivoli Management Solution for Exchange rule. Additional Information: The Class should be an alphanumeric string that is no longer than 32 characters. Class is filtered using a universal string. SubClass Type the subclass identification generated by the IBM Tivoli Management Solution for Exchange rule. Additional Information: The subclass should be an alphanumeric string that is no longer than 32 characters. SubClass is filtered using a universal string. 156 IBM Tivoli Management Solution for Exchange: User s Guide

169 12. Click Severity to display the Severity tab. 13. Check any severities you want to view. Additional Information: The Severity tab enables you to restrict the events to certain severity levels. For example, you might want to remove the VMS (OpenVMS all) check box to filter out any event with a VMS severity. Note that the Windows NT, VMS, and ISO severity levels are arranged to show their mapping to the corresponding IBM Tivoli Management Solution for Exchange severity. 14. Click Description to display the Description tab. 15. Enter the following information next to the corresponding radio button: Brief Text: Type the brief text to accept any event containing that text. Full Text: Type the full text to accept any event containing that text. Both: Type the text that contains both brief and full text to accept any event containing that text. Chapter 9. Managing events 157

170 16. Click Advanced to display the Advanced tab. 17. Type in this information: UserName Type the account used to log into the network to accept events from that user name. RuleName Type the name of the IBM Tivoli Management Solution for Exchange rule that captured the event to accept events containing that rule name. EntityContext Type the entity context identification generated by the IBM Tivoli Management Solution for Exchange rule. Source Type the process from which an event was captured to accept events containing that source. Handle Type a name to be associated with the problem to accept events containing that handle. Additional Information: If this is not specified a default one is formed by the rule engine. The default handle name includes the rule name, context, and the creation date and time of the event. 18. Optional: Enable or disable the Tivoli Event Configuration Manager to require confirmations before performing specific classes of operations by doing the following: a. Click View to display the View menu. 158 IBM Tivoli Management Solution for Exchange: User s Guide

171 b. Click Options from the View menu to display the Tivoli Event Server Configuration Option screen. c. Do one of the following to enable or disable operation confirmation notices: v Select Confirm all update operations to require confirmation before performing an operation. OR v Deselect Confirm all update operations to perform all operations without confirmation. d. Do one of the following to enable or disable operation completion notices: v v Select Display success messages to have Tivoli Event Configuration Manager inform you when the operation was successfully performed. OR Deselect Display success messages to have Tivoli Event Configuration Manager perform operations without notifying you of completion. Sending and receiving events between computers Objective To send events to another computer and receive events from another computer so you can manage events throughout the network. Background information For an understanding of events, see Understanding events in the Tivoli Event Monitor on page 129. Before you begin None. When you finish None. Procedure 1. Open IBM Tivoli Management Solution for Exchange. 2. Open the Tivoli Event Configuration Manager by doing one of the following: v Click the Tivoli Event Configuration Manager icon. v OR Use the menu by doing the following: Chapter 9. Managing events 159

172 a. Click Manage to display the Manage menu. b. Click Event Server from the Manage menu to display the Tivoli Event Configuration Manager screen. 3. Do the following to send events to another computer: a. Click Sending events to in the Network Display field. 160 IBM Tivoli Management Solution for Exchange: User s Guide

173 b. Click Send/Receive to display thesend/receive menu. c. Click Add/Remove from the Send/Receive menu to display the Sending events to screen. d. Select computers to which to send events by doing one of the following: v Type the names of the computers in the Choose Computers field separated by commas. OR Chapter 9. Managing events 161

174 v Click Browse to select computers from a display of available computers. e. Click OK to display the confirmation screen. Additional Information: Click Apply to apply the computers without leaving the Sending events to screen. f. Click Yes to confirm the computers to receive events. 162 IBM Tivoli Management Solution for Exchange: User s Guide

175 g. Click OK to select the computers to receive events. 4. Remove a computer from receiving events by doing the following: a. Right-click on the computer icon that you wish to remove to display the Remove pop-up menu. b. Click Remove to display the remove confirmation box. c. Click OK to remove the computer receiving events list. 5. Send performance data to other computers by doing the following: Chapter 9. Managing events 163

176 a. Click Sending Performance Data To in the Network Display field. b. Click Send/Receive to display the Send/Receive menu. c. Click Add/Remove from the Send/Receive menu to display the Sending performance data to screen. d. Choose computers to send performance data to by doing one of the following: v Type the names of the computers in the Choose Computers field separated by commas. OR v Click Browse to select computers from a display of available computers. e. Click OK to send performance data to the selected computers. 6. Receive Open VMS or UNIX events from other computers by doing the following: 164 IBM Tivoli Management Solution for Exchange: User s Guide

177 a. Click Receiving (OpenVMS or UNIX) events from in the Network Display field. b. Click Send/Receive to display the Send/Receive menu. c. Click Add/Remove from the Send/Receive menu to display the Receiving (OpenVMS or UNIX) events from screen. d. Choose computers to receive OpenVMS or UNIX events from by doing one of the following: v Type the names of the computers in the Choose Computers field separated by commas. OR v Click Browse to select computers from a display of available computers. e. Click OK to receive OpenVMS or UNIX events from the selected computers. Managing events with Tivoli Web Event Monitor Objective To manage events using Tivoli Web Event Monitor so you can monitor events from an Internet browser. Chapter 9. Managing events 165

178 Background information For an understanding of events, see Understanding events in the Tivoli Event Monitor on page 129. Before you begin Install Tivoli Web Event Monitor as described in Installing Tivoli Web Event Monitor on page 29. When you finish None. Procedure 1. Open Internet Explorer 4.0 Web browser. 2. Type the following in the address field: where [SERVER] is the fully qualified domain name system (DNS) of the Microsoft Internet Information Services server. Additional Information: Do the following to determine the SERVER name: a. Open the Control Panel. b. Do one of the following to open the list of Data Sources: v Windows NT : 1) Click ODBC Data Sources. 2) Click System DSN to display the System DSN tab. OR v Windows 2000: 1) Click Administrative Tools. 2) Click Data Sources (ODBC). 3) Click System DSN to display the System DSN tab. c. Click RoboMon Event Database in the System Data Sources list. d. Click Configure to display the Microsoft SQL Server DSN Configuration screen. The SERVER name displays in the text box labeled Which SQL Server do you want to connect to? If (local) appears, then SERVER is the name of the computer on which you are working. 166 IBM Tivoli Management Solution for Exchange: User s Guide

179 3. Click one of the Server Health icons to view the following information: Server Health Overall View Displays the overall health status of all computers known to the central event consolidator. Server Health Detail View Problem Machines Only Displays the open problem events. Server Health Detail View All Machines Displays the severity of the events. 4. Click one of the Enterprise Views icons to view the following information: Open Problem Displays all events in an open problem status. Closed Problem Displays all events that are in a closed status. Tivoli Messages Displays all Tivoli messages. Event Log System Messages Displays all event log system messages. Event Log Application Events Displays all event log application events. Event Log Security Messages Displays all event log security messages. SNMP Traps Displays all SNMP Trap events. UNIX and VMS Events Displays all UNIX and VMS events. 5. Click one of the Application Views icons to view the following information: Chapter 9. Managing events 167

180 Exchange Server Events Displays events relating to Exchange. SQL Server Events Displays events relating to SQL Server. 6. Filter a view by doing the following: a. Click the Filteringicon in the left pane to display the Event Filtering screen. b. Click selections to filter out all events except the selected categories. Additional Information: Select multiple selections within each of the filtering categories by holding down the CTRL key and clicking on each selection. When moving to the next category, release the CTRL key until after the first selection has been made within that list box, holding the CTRL key for subsequent selections within that list box. Holding the CTRL key down between list boxes causes default selection of All Events to remain selected, negating all filtering for that field. The default selection of All Events indicates that no filtering is performed for that category. c. Click Filter to save the settings. 168 IBM Tivoli Management Solution for Exchange: User s Guide

181 7. Click the Security Settings icon in the left pane to display the Security Functions screen and set the following security settings v Do the following to add user roles or permissions: a. Click the Add a New Event Monitor User icon (top left icon in the left pane) to display the Add New Users screen. b. Type the DOMAIN\NAME for the user in the text box where NAME is the Windows user login name. c. Choose permissions for the user based on the following choices: Security Admin Allows the user to edit Security settings. Chapter 9. Managing events 169

182 Administrator Allows the user to access all views in the Tivoli Event Monitor, but not add other users. Enterprise Allows the user to access all Enterprise views (Open Problems, Closed Problems, Tivoli messages, Event Log messages, SNMP traps, and VMS and UNIX events). v Admin Allows the user to access Admin events displayed in the Tivoli Event Monitor. Exchange Allows the user to access Exchange events displayed in the Tivoli Event Monitor. SQL Server Allows the user to access SQL Server events displayed in the Tivoli Event Monitor. d. Click Add User to add the user to Tivoli Event Monitor and display the new user successfully added screen. Additional Information: Click the Edit Event Monitor user security settings icon (top right icon in the left pane) to change user roles and permissions at any time. Do the following to delete a Tivoli Event Monitor user: a. Click the Delete Event Monitor user icon (bottom left icon in the left pane) to display the Delete Existing Users screen. v b. Click the down arrow in the Select User Name text box to display the list of current Tivoli Event Monitor users. c. Click the user name to delete. d. Click Delete User to delete the user from roles and permissions in the Tivoli Event Monitor. Do the following to edit user preferences: 170 IBM Tivoli Management Solution for Exchange: User s Guide

183 a. Click the Edit my preferences icon (bottom right icon in the left pane) to display the Preferences screen. b. Select the number of seconds for the main Tivoli Event Monitor window to refresh from the drop-down menu. c. Click one of the following severity color preferences: Show all severities as same color: Displays all event text in black and can speed up performance. OR Use colors to designate severity: Displays event text in colors according to severity: - Severity 1 or 2 = red - Severity 3 or 4 = amber - Severity 5 = blue - Severity 6 or greater = green d. Click any of the following views to display as icons in the Tivoli Event Monitor Toolbar: Enterprise Admin Exchange SQL Server e. Click Update Preferences to save user settings. Chapter 9. Managing events 171

184 172 IBM Tivoli Management Solution for Exchange: User s Guide

185 Chapter 10. Reporting and graphing This chapter explains how to create reports and graphs using Tivoli Reporting and Graphing in IBM Tivoli Management Solution for Exchange. Table 16 provides an overview of the topics covered in this chapter. Table 16. Guidelines for reporting and graphing in IBM Tivoli Management Solution for Exchange Goal Refer to 1. Understanding the Tivoli Reporting and Graphing Manager functions and options Understanding reports and graphs in the Tivoli Reporting and Graphing Manager on page Generating a report from specified data Creating a report on page Exporting a report for use in a Web site Exporting a report on page Generating a graph from specified data Creating a graph on page Working with graphs to display specific Customizing graphs on page 186 data or type of graph 6. Exporting a graph for use in a Web site Exporting a graph on page Creating batch reports and graphs to run automatically Creating batch reports and graphs on page Managing folders by batch Managing the batch folders on page Changing reports and graphs to display information in a specific manner Customizing views of reports and graphs on page 193 Understanding reports and graphs in the Tivoli Reporting and Graphing Manager Tivoli Reporting and Graphing provides the ability to: v Graph or create reports on data consolidated from multiple computers v Customize report columns and summarization groupings v Graph by time, hour summary, computer, or entity (such as disk, database, file, process, and enterprise) v Save customized report and graph user definitions v Export a report or graph in Hypertext Markup Language (HTML), Excel, or Word format v Run reports and graphs as a batch and automatically forward as an The Tivoli Reporting and Graphing creates reports and graphs from data archived in a database. Most of the reports and graphs work with IBM Tivoli Management Solution for Exchange performance rules. The performance rules archive performance data at regular intervals to a database and must be running to create that data necessary for reporting and graphing. The Tivoli Performance Database contains the performance data used for reporting and graphing. IBM Tivoli Management Solution for Exchange performance rules populate the database. The Open Database Connectivity (ODBC) system data source name (DSN) uses RoboMon Performance Reporting as the name for the 173

186 performance database that is accessed by the reports and graphsfor the performance database accessed by the reports and graphs. The IBM Tivoli Management Solution for Exchange installation creates this data source name to reference the performance database on your local computer. You can access the performance database on a different computer by changing this data source name. Tivoli Reporting and Graphing has three different views: CIO, Management, and Sysadmin. The CIO view contains reports and graphs that are of interest to a Chief Information Officer. The Management view contains the full set of management reports and graphs. The Sysadmin view contains detailed reports and graphs that are of interest to a system administrator. The CIO and Management views include the following reports and graphs: Summary report Displays a monthly activity summary for each hour of the day, excluding Saturdays and Sundays. Computer bar graph Displays computer data summarized in a bar graph format. Each bar represents computer activity for the current month between the hours of 9:00 AM and 5:00 PM, excluding Saturdays and Sundays. Entity bar graph Displays entity data summarized in a bar graph format. Each bar represents entity activity for the current month between the hours of 9:00 AM and 5:00 PM, excluding Saturdays and Sundays. Hourly summary bar graph Displays computer and entity data summarized in a bar graph format. Each bar represents activity or usage data for each hour of the day in the current month, excluding Saturdays and Sundays. Summary pie graph Displays computer and entity data summarized in a pie chart format. Each pie slice represents computer and entity data for the current month between the hours of 9:00 AM and 5:00 PM, excluding Saturdays and Sundays. The Sysadmin view includes the following reports and graphs: Detail reports Displays detailed activity data in report format. Time line graphs Displays detailed activity data in a time line graphical format. CIO, Management, and Sysadmin views provide the following reports and graphs: Product CIO and Management Views Sysadmin Views Exchange Summary Management Summary Report Detail Report Computer Summary Bar Graph Exchange Storage Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Detail Report 174 IBM Tivoli Management Solution for Exchange: User s Guide

187 Exchange Internet Exchange IMC Activity Exchange Site Activity Exchange Server Activity Exchange User Activity Exchange Domain Activity Exchange 2000 General Exchange 2000 Chat Exchange 2000 Conferencing Exchange 2000 Storage Exchange 2000 MTA Connections Exchange 2000 Domain Activity Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Connector Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Site Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Server Summary Bar Graph Hourly Summary Bar Graph Management Summary Report User Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Domain Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Domain Summary Bar Graph Hourly Summary Bar Graph Detail Report Time Line Graph Time Line Graph Time Line Graph Time Line Graph Time Line Graph Time Line Graph Detail Report Detail Report Detail Report Detail Report Detail Report Time Line Graph Time Line Graph Chapter 10. Reporting and graphing 175

188 Exchange 2000 IMC Activity Management Summary Report Time Line Graph Exchange 2000 Site Activity Exchange 2000 Server Activity Exchange 2000 User Activity Exchange 2000 Simple Mail Transfer Protocol (SMTP) Activity SQL Server 6.5 Summary SQL Server 6.5 input/output (I/O) SQL Server 6.5 Replication SQL Server 6.5 Activity SQL Server 6.5 Procedure Cache SQL Server 6.5 Database SQL Server 6.5 Device Connector Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Site Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Server Summary Bar Graph Hourly Summary Bar Graph Management Summary Report User Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Domain Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Database Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Device Summary Bar Graph Hourly Summary Bar Graph Time Line Graph Time Line Graph Time Line Graph Time Line Graph Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph 176 IBM Tivoli Management Solution for Exchange: User s Guide

189 SQL Server 6.5 Log File SQL Server 7 Summary SQL Server 7 Memory SQL Server 7 Replication SQL Server 7 Access Methods SQL Server 7 Buffer Manager SQL Server 7 Process SQL Server 7 Database Usage Management Summary Report Log File Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Database Summary Bar Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Hourly Summary Bar Graph SQL Server 7 Database Logs Management Summary Report Database Summary Bar Graph Detail Report Time Line Graph SQL Server 7 Locks SQL Server 2000 System CPU SQL Server 2000 Statistic Hourly Summary Bar Graph Management Summary Report Lock Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Computer Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Instance Summary Bar Graph Hourly Summary Bar Graph Detail Report Time Line Graph Time Line Graph Detail Report Time Line Graph Chapter 10. Reporting and graphing 177

190 SQL Server 2000 Backup SQL Server 2000 Logins SQL Server 2000 Latch SQL Server 2000 Memory SQL Server 2000 Replication Distribution SQL Server 2000 Logreader Replication SQL Server 2000 Replication Merge SQL Server 2000 Access Methods SQL Server 2000 Buffer Manager SQL Server 2000 Process SQL Server 2000 Database Usage SQL Server 2000 Database Logs Management Summary Report Instance Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Instance Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Instance Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Instance Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Instance Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Instance Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Instance Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Instance Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Instance Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Instance Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Database Summary Bar Graph Hourly Summary Bar Graph Management Summary Report Database Summary Bar Graph Hourly Summary Bar Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph Detail Report Time Line Graph 178 IBM Tivoli Management Solution for Exchange: User s Guide

191 SQL Server 2000 Locks Management Summary Report Lock Summary Bar Graph Hourly Summary Bar Graph Detail Report Time Line Graph Creating a report Objective To create a report in the Tivoli Report and Graph Manager so you can view performance data in a graphical format. Background information None. Before you begin You must be running the IBM Tivoli Management Solution for Exchange performance rules to collect report and graph data. When you finish None. Procedure 1. Open IBM Tivoli Management Solution for Exchange. 2. Open the Tivoli Report and Graph Manager by doing one of the following: v Click the Run Tivoli Reporting and Graphing icon. v OR Use the menu options by doing the following: a. Click Run to display the Run menu. b. Click Tivoli Reporting and Graphing from the Run menu. 3. Choose the report topic by doing one of the following: v Click the report on the left pane to display the criteria for that report. Chapter 10. Reporting and graphing 179

192 v OR Double-click the report on the right pane to display the report criteria. 4. Customize the report criteria by doing the following: a. Define the following fields on the Main tab: Title: Type in a title to display at the top of the report. Include graph Do one of the following: v Select this check box to include a bar graph in the report. OR v Deselect this check box to omit a bar graph from the report. Additional Information: Double-click on any bar in the graph to display report information for that value. A new tab appears in the left pane of the window. Fields used: Select fields to display as columns in the report. Additional Information: You can change the order of the fields by clicking the up or down arrow to the left of the field. Groups: Select groups to define how the report is sorted and summarized. Additional Information: You can change the sort order of the groups by clicking the up or down arrow to the left of the field. Computers: Select computers to include in the report. Additional Information: The computers listed are all computers found in the database table associated with this report. 180 IBM Tivoli Management Solution for Exchange: User s Guide

193 Additional Information: Some reports display a list of entities in the Main tab. Entities refer to computer components for which there can be many occurrences, such as disks, processes, services, and databases. The list includes all entities found in the database table associated with the report. Check any entities to include in the report. b. Click Dates/Times to display the Dates/Times tab. c. Click one of the following radio buttons in the Dates field. Enter additional information for the selections below: Days back: Type the number of days to report. Date Type the date to report. Date range Type the beginning and ending dates to report. d. Click the check boxes to display report data for days of the week in the Days of the week field. e. Define the following information in the Times field: All Times Displays all times in the report. Time range: Type a beginning and ending time of day for the report. 5. Click Run to run and display the report. Additional Information: Reports display in a separate report window. You can go back to the Report and Graph Manager to do other tasks while the report Chapter 10. Reporting and graphing 181

194 displays. Exporting a report 6. Optional: Save the report by doing the following: a. Click Save. b. Type a name for the version of this report. 7. Optional: Refresh report data by clicking the refresh data icon in the toolbar. The report is recreated using the data at the time of the refresh. 8. Optional: Search for any text within a report by doing the following: a. Enter the text in the search text box in the report window toolbar. b. Click the search icon (binoculars). 9. Optional: Navigate the report information by doing the following: Click on a computer name or date The report jumps to the beginning of this grouping. Click on the arrows in the window toolbar The report pages forward, backward, or jumps to either the first or last page of the report. Pass the cursor over any value displayed in the report The cursor changes to a magnifying glass. Double-click to show values for only the grouping under the cursor. A new tab appears in the left pane of the window. Click any of the tabs to display its associated report. To remove a tab and its associated report, click the X in the report window toolbar. Objective To export a report so you can create the report in HTML format to use in a Web site. 182 IBM Tivoli Management Solution for Exchange: User s Guide

195 Creating a graph Background information None. Before you begin None. When you finish Point an URL to the Web server directory that contains the exported report. If required, add security. Procedure 1. Open the report. 2. Do one of the following to display the Export screen: v Click the Export Report icon in the report window toolbar. OR v Use the menu option by doing the following: a. Click File to display the File drop-down menu. b. Click Export from the File drop-down menu. 3. Click the down-arrow for the Format text box to display the format options. 4. Select a format from the list. Additional Information: Rich Text enables you to include the report as an attachment. HTML enables you to read the report in a Web page. Crystal Reports (.rpt) enables you to import the report into Crystal reports. 5. Click the down-arrow for the Destination text box to display the destination options. 6. Select a destination from the list. 7. Click OK. Objective To create a graph so you can view the performance data in a graphical form. Background information Graphs display in a separate graph window. You can go back to the Report and Graph Manager to do other tasks after displaying the graph. Before you begin None. When you finish None. Procedure 1. Open IBM Tivoli Management Solution for Exchange. 2. Open the Tivoli Report and Graph Manager by doing one of the following: v Click the Run Tivoli Reporting and Graphing icon. v OR Use the menu options by doing the following: a. Click Run to display the Run menu. Chapter 10. Reporting and graphing 183

196 b. Click Tivoli Reporting and Graphing from the Run menu. 3. Choose your graph topic by doing one of the following: v Choose your graph topic on the left pane. OR v Double-click the graph topic on the right pane. 4. Choose your criteria for the graph by doing the following: 184 IBM Tivoli Management Solution for Exchange: User s Guide

197 a. Define the following criteria on the Main tab: Fields used: Select fields to display as columns in the graph. Additional Information: Change the order of the fields by clicking the up or down arrow to the left of the field. Computers: Select computers to include in the graph. Additional Information: The list includes all computers found in the database table associated with this graph. b. Click Dates/Times to display the Dates/Times tab. c. Define the following information on the Dates/Times tab: Dates Click an option to define the date or date range of the graph. Complete the information for the following options: Days back Type the number of days to graph. Date Type the date to graph. Date range Type the beginning and ending dates to graph. Days of the week Type the days of the week to include in the graph. Times Select an option to define the times of day you want to graph. For Time range:, enter the beginning and ending times of day to graph. 5. Click Run to run the graph. 6. Optional: Save the graph by doing the following: a. Click Save. b. Type a name for the version of this graph. 7. Optional: Refresh graph data by doing the following: Chapter 10. Reporting and graphing 185

198 Customizing graphs a. Click View to display the View menu. b. Click Refresh Graph from the View menu to recreate the graph using the data at the time of the refresh. 8. Optional: Search for any text within a report by doing the following: a. Enter the text in the search text box in the report window toolbar. b. Click the search icon (binoculars). Objective To customize a graph so you can tailor the appearance of a graph. Background information None. Before you begin None. When you finish None. Procedure 1. Open the graph. 186 IBM Tivoli Management Solution for Exchange: User s Guide

199 2. Click any of the icons in the graph window toolbar to display the Graph Control screen. 3. Do any of the following to change the appearance of your graph: v Change the Graph Type by doing the following: a. Click one of the following: 2D Gallery tab OR 3D Gallery tab b. Click the desired graph type. c. Do one of the following: Click Apply Now to see the changes in your graph without closing the graph control window. OR Click OK to make the changes in the graph and close the graph control window. v Change the 3D Appearance by doing the following: a. Click 3D to display the 3D tab. b. Click the desired option. c. Do one of the following: Click Apply Now to see the changes in your graph without dismissing the graph control window. OR Click OK to make the changes in the graph and dismiss the graph control window. v Add Trend Lines to a 2D Line Graph by doing the following: a. Click Trends to display the Trends tab. b. Click one of the following statistic lines: Mean Chapter 10. Reporting and graphing 187

200 OR Minimum and maximum OR Standard deviation c. Click one of the following: best fit line or curve. d. Do one of the following: Click Apply Now to see the changes in your graph without dismissing the graph control window. OR Click OK to make the changes in the graph and dismiss the graph control window. v v Additional Information: For 2D line graphs, you can use the mouse to zoom in to any part of the graph. Click on an icon in the upper left corner of the graph, and drag the mouse forming the rectangle to enlarge. When you release the mouse button, the graph enlarges the selected rectangle into the total size of the graph. Repeat the process for further enlargement of a graph section. Return the graph to its original full view by selecting View Full. Change Colors in your graph by doing the following: a. Click Markers to display the Markers tab. b. Click on each data set and select a color. c. Do one of the following: Click Apply Now to see the changes in your graph without dismissing the graph control window. OR Click OK to make the changes in the graph and dismiss the graph control window. Change titles in your graph by doing the following: a. Click Titles to display the Titles tab. b. Type the text of the titles to display with the graph. c. Do one of the following: Click Apply Now to see the changes in your graph without dismissing the graph control window. OR Click OK to make the changes in the graph and dismiss the graph control window. Exporting a graph Objective To export a graph so you can format the graph for use in a Web site. Background information None. Before you begin None. 188 IBM Tivoli Management Solution for Exchange: User s Guide

201 When you finish Point an URL to the Web server directory that contains the exported graph. If required, add security. Procedure 1. Open the graph. 2. Click File to display the File menu. 3. Click Export from the File menu to display the Export output screen. 4. Type a name for the JPEG file that will contain the graph in the Name of JPEG File text box. Additional Information: Graphs are available as a.jpeg which is compressed and suitable for s or Web pages. 5. Optional: Do the following to export the graph to HTML for use in a Web page: a. Select the Export to HTML check box. b. Optional: Type a title to appear above the graph in the HTML Title above graph text box. c. Optional: Type comments to appear above the graph in the HTML comments above graph text box. d. Optional: Type comments to appear below the graph in the HTML comments below graph text box. 6. Click OK. Chapter 10. Reporting and graphing 189

202 Creating batch reports and graphs Objective To create reports and graphs in batches so you can save time by running them automatically. Background information Reports and Graphs can run automatically in batch. Four Admin rules (Hourly_Reports, Nightly_Reports, Weekly_Reports, and Monthly_Reports) run at the appropriate interval to create reports and graphs that you specified in the corresponding batch folder. Batch reports and graphs automatically export to a file in the format specified. You can choose to send this file in an to one or more recipients. Before you begin Admin rules must be running for automatic batch reports and graphs to generate. When you finish None. Procedure 1. Select the report or graph in the hierarchical tree in the left pane of the Tivoli Reporting and Graphing. 2. Click Edit to display the Edit menu. 3. Click Add to Batch from the Edit menu. 4. Complete batch information for a report or graph in the following fields: Title Type the name that is displayed for this report or graph when managing the batch folders. 190 IBM Tivoli Management Solution for Exchange: User s Guide

203 Managing the batch folders Additional Information: Choose a unique title to identify the report or graph in the batch facility. When modifying the batch information for a report or graph, you cannot change its title. Batch folder Type the frequency to create the report or graph. Additional Information: Choose from the available list or click Add Folder to create a new batch folder. Populating a new batch folder also requires you to add a new Admin rule associated with this folder. When modifying the batch information for a report or graph, you can not change its batch folder. Output directory Type the destination disk and directory for the report or graph. Click the box that contains... to browse. Output format Type the format of the exported report or graph..rpt Used by Crystal Reports to translate information..rdf Report definition file..gdf Graph definition file..udf User defined file..view Stored in RM directory & user profile..brg Batch Reports and Graphs. Output file name Type the name of the exported file. The file extension appears as the output format specified. to Type the address of the recipients to receive the exported file in an . Note: To reports and graphs, you must configure IBM Tivoli Management Solution for Exchange to use Microsoft Exchange as its mail service. In Tivoli Enterprise Manager, go to Manage Configuration. In the Mail Information tab of the Tivoli Configuration Manager, select Microsoft Exchange as the mail service and enter a Profile name. If you enter at least one recipient, you can specify the Subject and the Body of the message. You can also specify to delete the file after it is ed. If you want to temporarily suspend the creation of the report or graph, check Exclude from batch cycle. Uncheck the box to resume the creation of the report. 5. Click OK. Objective To add, modify, or remove reports and graphs from the batch folder so you can manage reports and graphs. Chapter 10. Reporting and graphing 191

204 Background information None. Before you begin None. When you finish None. Procedure 1. Click Edit to display the Edit drop-down menu. 2. Click Manage Batch from the Editdrop-down menu to display the Batch Reports and Graphs screen. 3. Optional: Click Add Folder to create a new batch folder. Note: Populating a new batch folder also requires you to add a new Admin rule associated with this folder. 4. Click on a title from the list. 5. Do one of the following: v Add the selected report or graph to the selected batch folder by doing the following: a. Click Add. b. Enter the batch information for the report or graph. c. Click OK. v Modify the batch information for a report or graph by doing the following: a. Click Modify. b. Make any desired modifications to the batch information for the report or graph. c. Click OK. v Remove a report or graph from batch by doing the following: a. Click Remove. b. Click Close to return to the main Report and Graph Manager window. 192 IBM Tivoli Management Solution for Exchange: User s Guide