Tivoli Manager for ExchangeUser’s GuideVersion 2.0

Tivoli Manager for Exchange User’s Guide(December 1999)Copyright NoticeCopyright 1998, 1999 by Tivoli Systems, an IBM Company, including this documentationand all software. All rights reserved. May only be used pursuant to a Tivoli Systems SoftwareLicense 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 retrievalsystem, or translated into any computer language, in any form or by any means, electronic,mechanical, magnetic, optical, chemical, manual, or otherwise, without prior writtenpermission of Tivoli Systems. Tivoli Systems grants you limited permission to make hardcopyor other reproductions of any machine-readable documentation for your own use, provided thateach such reproduction shall carry the Tivoli Systems copyright notice. No other rights undercopyright are granted without prior written permission of Tivoli Systems. The document is notintended for production and is furnished “as is” without warranty of any kind. All warrantieson this document are hereby disclaimed including the warranties of merchantability andfitness for a particular purpose.Note to U.S. Government Users—Documentation related to restricted rights—Use, duplicationor disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBMCorporation.TrademarksThe following product names are trademarks of Tivoli Systems or IBM Corporation: AIX,IBM, OS/2, RS/6000, Tivoli, Tivoli Enterprise Console, Tivoli Management Framework, andTivoli Global Enterprise Manager.Microsoft Windows, Windows NT, and the Microsoft logo are trademarks or registeredtrademarks of Microsoft Corporation.Tivoli Manager for Exchange User’s Guidev

Tivoli Manager for Exchange User’s Guide (December 1999)UNIX is a registered trademark in the United States and other countries licensed exclusivelythrough X/Open Company Limited.NoticeReferences in this publication to Tivoli Systems or IBM products, programs, or services do notimply that they will be available in all countries in which Tivoli Systems or IBM operates. Anyreference to these products, programs, or services is not intended to imply that only TivoliSystems or IBM products, programs, or services can be used. Subject to Tivoli Systems’ orIBM’s valid intellectual property or other legally protectable right, any functionally equivalentproduct, 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 thoseexpressly designated by Tivoli Systems or IBM, are the responsibility of the user.Tivoli Systems or IBM may have patents or pending patent applications covering subjectmatter in this document. The furnishing of this document does not give you any license to thesepatents. You can send license inquiries, in writing, to the IBM Director of Licensing, IBMCorporation, North Castle Drive, Armonk, New York 10504-1785 USA.viVersion 2.0

ContentsTivoli Manager for Exchange User’s Guide (December 1999) .vPreface.xvChapter 1—Introducing Manager for Exchange. . . . . 1Operations Management .2Event Management .2Software Distribution and Installation .3Integration with Tivoli Management Framework.3Chapter 2—Installing Manager for Exchange. . . . . . . 5Pre-Installation Considerations .8Tivoli Management Region Configuration .8NT Event Adapter Requirements .8Event Server Configuration.8UNIX Platform Requirements.9Application Proxy Availability .9Installation Overview.9Installation Log Files .11Upgrade and Migration Considerations .11Installing the Application Proxy .12From the Tivoli Desktop .12Using the winstall Command .13Installing Manager for Exchange.14From the Tivoli Desktop .15Using the winstall Command .18Chapter 3—Getting Started . . . . . . . . . . . . . . . . . . . . 21Assigning Manager for Exchange Authorization .21Assigning TMR Roles to a Tivoli Administrator.22Assigning Resource Roles to a Tivoli Administrator.23Configuring and Distributing Client File Packages .23Tivoli Manager for Exchange User’s Guidevii

Configuring TEC Event Handling .23Managing Microsoft Exchange Servers.24Creating Microsoft Exchange Server Instances .24Determining Server Status .30Subscribing Servers to a Profile Manager.31Deleting a Microsoft Exchange Server .32Chapter 4—Distributing Clients . . . . . . . . . . . . . . . . . 33Creating File Packs .33Distributing File Packs .37Before and After Installation Processing .38Chapter 5—Monitoring Exchange Servers . . . . . . . . 39Adding Monitors.39Understanding the Monitors .43Microsoft Exchange Monitoring Collections.43Additional Microsoft Exchange-Specific Monitors .44Available Memory.44Database/Log Usage.44Disk Space Available .45Disk Space Usage .45Event Adapter Status .45MailPing Listener .45Configuring and Testing the MailPing Listener Monitor.46TivoliMailPing Service .52Removing Test Messages .53Performance Counters .53Server Status.53Predefined Monitors.53Chapter 6—Tasks for Managing Resources . . . . . . . 55Listing Tasks.55viiiVersion 2.0

Running Tasks .56Microsoft Exchange Server Tasks .58Server Information Tasks .59Display Server Status.59Display Server Info.60Display Exchange Info .60Display Statistics .61Mailbox Information Tasks .61Mailbox Info .61Database and Disk Utility Tasks .61Run ISINTEG .61Run EDBUTIL/ESEUTIL .62Run MTACHECK .63Diagnostic and Control Services Tasks.63Diagnostic Logging-Set and -View .63Start and Stop Services .64Manager for Exchange Utility Tasks .64Discover Exchange Servers.65Set Icon State.66Start Debugging.66Stop Debugging.67List Debug Logs .67Remove Debug Logs .67Migrate Exchange Servers .67Delete Migrated Exchange Objects.69Create Client Filepacks .69Start Monitors.69Stop Monitors .70Configure MailPing Listener Monitor.70Start Stop MailPing Listener Monitor .70Chapter 7—Managing Exchange Server Events . . . 71Tivoli Manager for Exchange User’s Guideix

Configuring the Event Server .72Configuring the Event Console .75Configuring the NT Event Adapter .77Starting and Stopping the NT Event Adapter .78Monitoring the NT Event Adapter.79Filtering Events.79Chapter 8—Tivoli GEM Instrumentation . . . . . . . . . . 81Understanding the Tivoli GEM Server.81Understanding the Tivoli GEM Console .82Tivoli GEM Instrumentation Event Handling .82Instrumentation Files, Libraries, and Profiles.82Tasks .83Monitors.83Preparing to Install Tivoli GEM Instrumentation.84Tivoli Management Regions .84Administrators.84Installation Prerequisites .84Installing and Configuring Tivoli GEM Instrumentation Components.85Copying B*DF, CDF, GDF, and Icon Files.85Installing the Java Development Kit .86Creating User Groups and Logon IDs for the Tivoli GEM Console .88Windows NT .88AIX .88HP/UX .89SUN Solaris .89Setting Security for the Windows NT Operating System .89Installing Tivoli GEM Instrumentation.90Defects, Limitations, and Workarounds .92Chapter 9—Initializing Tivoli GEM Instrumentation . 93Configuring Tivoli GEM Event Handling .93xVersion 2.0

Configuring Microsoft Exchange Servers .95Subscribing to and Distributing the File Packages .95Subscribing to and Distributing the Heartbeat Monitor.96Confirming Resource Discovery.98Chapter 10—Instrumentation Tasks and Monitors . 99Locating and Running Tasks .99Tivoli GEM Instrumentation Tasks.99Microsoft Exchange Server Tasks.99Navigating to Microsoft Exchange Server Resources.101Using the Tear-Away Log.103Starting a Sample Task.103Monitors .104Microsoft Exchange Server Monitors .104Heartbeat Monitor.105State Monitor .105Manager for Exchange-Supported Monitors .105Monitor Operability.106Tasks Available for Monitors.106Appendix A—Command Line Commands . . . . . . . 107wcrtmsxchg .108wgetmsxchg .110wsetmsxchg.111wdel.112Appendix B—Event Classes and Rules . . . . . . . . . 113Manager for Exchange Event Classes.113Distributed Monitoring Events.113NT Event Adapter Events .114Manager for Exchange Event Rules .116NT Event Adapter Rules .116Tivoli Manager for Exchange User’s Guidexi

Distributed Monitor Rules .117GEM Event Rules .117Appendix C—Business and Component Files . . . . 121Installing B*DF, CDF, GDF, and Icon Files .121Business, Component, and Global Description Files .122Icon Files .123Appendix D—GEM Task and Monitor Descriptions 125Tasks .125Tasks for Monitors.126Manager for Exchange Monitors Supported by GEM Instrumentation .127Appendix E—Finding and Correcting Problems. . . 129Installation Questions .129Questions on Using Tasks and Jobs from the Tivoli Desktop.130Questions on Running Tasks from the Tivoli GEM Console.132Questions on Using Monitors .132Questions on Using the TEC .135Questions on Using the Tivoli GEM Client .138Questions on Turning on GEM Instrumentation Debugging .140Icon State .142Helpful Debugging Information .143Manager for Exchange Log Files.143Tivoli GEM-specific Questions and Tips .143Appendix F—Error Messages . . . . . . . . . . . . . . . . . . 147Appendix G—Performance Monitor Counters . . . . 161Appendix H—Registry Information . . . . . . . . . . . . . 177Appendix I—IND Files . . . . . . . . . . . . . . . . . . . . . . . . 179xiiVersion 2.0

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189Tivoli Manager for Exchange User’s Guidexiii

xivVersion 2.0

PrefaceThis document includes information about planning for, installing, andusing Tivoli Manager for Exchange (Manager for Exchange), previouslyTME 10 Module for Exchange. It describes using monitors and taskswith Manager for Exchange.You can optionally use Manager for Exchange with Tivoli GlobalEnterprise Manager (Tivoli GEM) and Tivoli GEM Instrumentation forExchange to obtain a graphical topology display of the MicrosoftExchange Servers, their status, and a list of tasks which can be runagainst each Microsoft Exchange Server.Who Should Read This DocumentThis document is for system administrators who monitor and manageMicrosoft Exchange Servers. The document requires knowledge ofTivoli and Microsoft Exchange products and, optionally, the TivoliGEM product.Prerequisite and Related DocumentsFor hardware and software requirements, and other release information,refer to the Tivoli Manager for Exchange Release Notes.Related documents include:TME 10 Distributed Monitoring User’s GuideTME 10 Enterprise Console Adapters GuideTME 10 Enterprise Console Rule Builder’s GuideTME 10 Enterprise Console User’s GuideTivoli Manager for Exchange User’s Guidexv

PrefaceTME 10 Framework User’s GuideTME 10 Framework Planning and Installation GuideTME 10 Software Distribution User’s GuideTME 10 Software Installation Service User's GuideRelated documents for Tivoli Global Enterprise Manager include:Tivoli Global Enterprise Manager Installation and User’s GuideTivoli Global Enterprise Manager Instrumentation GuideNote: Tivoli is in the process of changing product names. Productsreferenced in this document may still be available under their oldnames, for example, TME 10 Enterprise Console is now referredto as Tivoli Enterprise Console; Sentry is now referred to asDistributed Monitoring.What This Document ContainsThe Tivoli Manager for Exchange User’s Guide contains the followingsections: “Chapter 1. Introducing Manager for Exchange,” on page 1Introduces the features and functions of Manager for Exchange. “Chapter 2. Installing Manager for Exchange,” on page 5Covers the planning for and installing of Manager for Exchange. “Chapter 3. Getting Started,” on page 21Covers the configuring of Manager for Exchange. “Chapter 4. Distributing Clients,” on page 33Tells you how to create and distribute Microsoft Exchange filepacks to clients. “Chapter 5. Monitoring Exchange Servers,” on page 39Describes how to use the performance monitors that Manager forExchange provides. xvi“Chapter 6. Tasks for Managing Resources,” on page 55Version 2.0

PrefaceDescribes how to locate and use tasks provided by Manager forExchange. “Chapter 7. Managing Exchange Server Events,” on page 71Contains information on configuring and using the NT eventadapter to forward Microsoft Exchange Server events to the TivoliEnterprise Console (TEC) event server. “Chapter 8. Tivoli GEM Instrumentation,” on page 81Covers the planning for and installing of Tivoli GEMinstrumentation. “Chapter 9. Initializing Tivoli GEM Instrumentation,” on page 93Describes configuring and using Tivoli GEM instrumentation. “Chapter 10. Instrumentation Tasks and Monitors,” on page 99Describes Tivoli GEM tasks and monitors which becomeaccessible for operational management of your MicrosoftExchange servers after the Tivoli GEM components have beensuccessfully installed. “Appendix A. Command Line Commands,” on page 107Contains a list of supported command line interface (CLI)commands you can use to create, to change, and to view theattributes of Microsoft Exchange Server instances. “Appendix B. Event Classes and Rules,” on page 113Contains a list of supported event source names and a map of thelabels provided by the Windows NT Event Viewer and the Tivolievent display. “Appendix C. Business and Component Files,” on page 121describes the Tivoli GEM business and component descriptionfiles. “Appendix D. GEM Task and Monitor Descriptions,” on page 125Provides the field entries required when you run Tivoli GEMinstrumentation tasks. “Appendix E. Finding and Correcting Problems,” on page 129Tivoli Manager for Exchange User’s Guidexvii

PrefaceProvides installation tips, help on debugging problems, and typicalsymptoms and solutions. “Appendix F. Error Messages,” on page 147Contains a list of the messages that are generated by Manager forExchange. “Appendix G. Performance Monitor Counters,” on page 161Contains a list of the performance monitors and their respectivecounters that are provided by Manager for Exchange. “Appendix H. Registry Information,” on page 177Contains Windows NT registry information that is used by theTivoliMailPing service. “Appendix I. IND Files,” on page 179Contains a list of the IND files associated with the products andpatches on the product CD-ROM.What’s New for Version 2.0 of Manager for ExchangeNew functions provided in Manager for Exchange Version 2.0 include: Support for Microsoft Exchange Server management on endpoints.Manager for Exchange Version 2.0 does not support MicrosoftExchange Server management on managed nodes or distribution toPC managed nodes. Tasks: Migrate Exchange ServersDelete Migrated Exchange ObjectsList Debug LogsRemove Debug LogsConfigure MailPing Listener MonitorStart-Stop MailPing Listener MonitorSee “Manager for Exchange Utility Tasks” on page 64 fordescriptions of these tasks. xviiiSupport on Windows 98.Version 2.0

PrefaceTypeface ConventionsThe document uses several typeface conventions for special terms andactions. These conventions have the following meaning:BoldLower- and mixed-case commands, keywords, authorizationroles, URLs, or other information that you must use literallyappear in bold.Italics Variables that you must provide appear in italics. Words andphrases that are emphasized as well as any new terms alsoappear in italics.Monospace Code examples, output, and system messages appear in amonospacefont.Online Versions of this DocumentOnline versions of the Tivoli Manager for Exchange User’s Guide andthe Tivoli Manager for Exchange Release Notes are available on theproduct CD-ROM and in the following directory: for UNIX: BINDIR/./generic unix/TME/MSExchange/docfor Windows NT:%BINDIR%\.\generic unix\TME\MSExchange\docUse Adobe Acrobat Reader to view or print the usergide.pdf andrelnotes.pdf files located in the \DOC\pdf directory on the product CDROM. Use your browser to view the usergide.htm and relnotes.htm fileslocated in the \DOC\html directory on the product CD-ROM.You can also view the Tivoli Manager for Exchange User’s Guide andTivoli Manager for Exchange Release Notes on our Web site by pointingyour browser ge.html.Contacting Customer SupportFor support for this or any Tivoli product, you can contact TivoliCustomer Support in one of the following ways: Visit our Web site at Manager for Exchange User’s Guidexix

Preface Send e-mail to [email protected] in the United States can also call 1-800-TIVOLI8 (1-800848-6548). International customers should consult the Web site forcustomer support telephone numbers. You can also review theCustomer Support Handbook, which is available on our Web site at you contact Tivoli Customer Support, be prepared to provideidentification information for your company so that support personnelcan assist you more readily. Company identification information mayalso be needed to access various online services available on the Website.The Web site offers extensive information, including a guide to supportservices (the Customer Support Handbook); frequently asked questions(FAQs); and documentation for all Tivoli products, including ReleaseNotes, Redbooks, and Whitepapers. The documentation sets for someproduct releases are available in both PDF and HTML formats.Translated documents are also available for some product releases.You can order documentation by e-mail at [email protected]. Pleaseprovide the part number or order number of the desired document;alternatively, you can provide the document’s title, version number, anddate of publication.We are very interested in hearing about your experience with Tivoliproducts and documentation. We also welcome your suggestions forimprovements. If you have comments or suggestions about ourdocumentation, please contact us in one of the following ways: xxFill out our customer feedback survey at e-mail to [email protected] 2.0

Introducing Manager forExchange1Introducing Manager forExchange1.Tivoli Manager for Exchange (Manager for Exchange) provides acentralized system management tool for Microsoft Exchange servers onthe Tivoli platform. Manager for Exchange facilitates the managementof Microsoft Exchange Servers on endpoints and the installation ofMicrosoft Exchange file packs on clients.Manager for Exchange can be used with the following optionalproducts:Tivoli Enterprise Console (TEC)Receives, filters, and forwards selected events to an event serverfor further processing.TEC event adapter for Windows NT (NT event adapter)Converts Microsoft Exchange events to the TEC format.Tivoli Software DistributionUsed to distribute and deploy software across multi-platformnetworks.Tivoli Global Enterprise Manager (Tivoli GEM) and Tivoli GEMinstrumentationEnables you to obtain a graphical topology display of theMicrosoft Exchange Servers, their statuses, and a list of tasksthat can be run against each Microsoft Exchange Server.Tivoli Manager for Exchange User’s Guide1

Manager for Exchange provides the following features to enable you toperform system management functions for Mi

Exchange to obtain a graphical topology display of the Microsoft Exchange Servers, their status, and a list of tasks which can be run against each Microsoft Exchange Server. Who Should Read This Document This document is for system administrators who monitor and manage Microsoft Exchange Servers. The document requires knowledge of