Tivoli Manager for Message Queue Server Release ... - Support - IBM

Tivoli Manager for Message Queue Server Release Notes April 1999 Version 1.0

ii

Version 1.0

Tivoli Manager for Message Queue Server Release Notes (April 1999) Copyright Notice Copyright  1999 by Tivoli Systems, an IBM Company, including this documentation and all software. All rights reserved. May only be used pursuant to a Tivoli Systems 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 Tivoli Systems. Tivoli Systems 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 Tivoli Systems copyright notice. No other rights under copyright are granted without prior written permission of Tivoli Systems. 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. Note to U.S. Government Users—Documentation related to restricted rights—Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation. Trademarks The following product names are trademarks of Tivoli Systems or IBM Corporation: AIX, IBM, OS/2, RS/6000, Tivoli, Tivoli Enterprise Console, Tivoli Management Framework, and Tivoli Global Enterprise Manager. Microsoft Windows, Windows NT, and the Microsoft logo are trademarks or registered trademarks of Microsoft Corporation. UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Limited. Notice 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 Tivoli Systems’ or IBM’s valid intellectual property or other legally protectable right, 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 Manager for Message Queue Server: Release Notes April 1999

iii

Tivoli Manager for Message Queue Server Release Notes (April 1999)

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 10504-1785 USA.

iv

Version 1.0

Contents Tivoli Manager for Message Queue Server Release Notes (April 1999) Release Notes Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Information . . . . . . . . . . . . . . . . . . . . . . . . . System Requirements . . . . . . . . . . . . . . . . . . . . . . . Tivoli Management Region Server . . . . . . . . . . . . . Tivoli Managed Nodes . . . . . . . . . . . . . . . . . . . . . Tivoli Endpoints . . . . . . . . . . . . . . . . . . . . . . . . . . Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tivoli GEM Instrumentation for Manager for MQS Release Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Information . . . . . . . . . . . . . . . . . . . . . . . Run-time Requirements . . . . . . . . . . . . . . . . . . . .

Tivoli Manager for Message Queue Server: Release Notes April 1999

. . . . . . . . . . . . . . . . . . . . . .

1 2 2 2 3 3 4 5 5 5 6

v

Contents

vi

Version 1.0

Release Notes This Release Notes document provides important information about Tivoli Manager for Message Queue Server (Manager for MQS), Version 1.0. These notes are the most current information for the product and take precedence over all other documentation. Please review these notes thoroughly before installing or using this product. Note: If a readme file is included on the Manager for MQS CD-ROM, its contents take precedence over all other documentation.

Introduction Manager for MQS provides a centralized system management tool for MSMQ on the Tivoli platform. The Manager for MQS facilitates the management of MSMQ servers on Tivoli-managed nodes and installed MSMQ client software. You can optionally use the Manager for MQS with Tivoli Global Enterprise Manager (Tivoli GEM) and Tivoli GEM Instrumentation for Tivoli Manager for Message Queue Server (Tivoli GEM instrumentation) to obtain a graphical topology display of each Microsoft Message Queue (MSMQ) server, their status, and a list of tasks that can be run against each MSMQ server. For more information on Tivoli GEM instrumentation, see “Tivoli GEM Instrumentation for Manager for MQS Release Notes” on page 5.

Tivoli Manager for Message Queue Server: Release Notes April 1999

1

Related Information

Related Information For task, monitor, and other user information, refer to the Tivoli Manager for Message Queue Server User's Guide.

System Requirements This section describes the architectures supported by Manager for MQS.

Tivoli Management Region Server This section describes the system requirements for the Tivoli Management Region (TMR) server.

Software Requirements Manager for MQS can be used to manage MSMQ servers from the following: Operating Systems: ■

Windows NT, Version 4.0, with Service Pack 3

■

HP-UX, Version 10.x

■

AIX ¹ ¹ ¹

AIX, Version 4.1.x AIX, Version 4.2 AIX, Version 4.3

Note: Tivoli's support of AIX is limited to AIX on IBM systems. Tivoli is not supported for AIX on other hardware. ■

Sun Solaris, Version 2.5.1 or 2.6

Tivoli Products: ■ ■ ■

2

Tivoli Management Framework, Version 3.6 (required) Tivoli Distributed Monitoring, Version 3.6 (required) Tivoli Enterprise Console (TEC), Version 3.6

Version 1.0

System Requirements

Tivoli Managed Nodes This section describes the system requirements for Tivoli managed nodes.

Software Requirements Manager for MQS can be used to manage MSMQ servers running on the following: Operating System: ■

Windows NT, Version 4.0 with Service Pack 3

Message Queue Server: ■

Version 1.0

Tivoli Products: ■

Tivoli Management Framework, Version 3.6 (required; installed as a managed node)

■

Tivoli Distributed Monitoring, Version 3.6 (required)

■

NT Event Adapter ¹ ¹

Windows NT Event Adapter (shipped with TEC, Version 3.6) Windows NT Event Log Adapter (shipped with TEC, Version 3.6)

Hardware Requirements All systems require a minimum of 10 MB of free disk space and 1 MB of memory. This space requirement is in addition to the space requirements for the management platform.

Tivoli Endpoints This section describes the system requirements for Tivoli endpoints.

Tivoli Manager for Message Queue Server: Release Notes April 1999

3

System Requirements

Software Requirements Manager for MQS can be used to manage MSMQ servers running on the following: Operating System: ■

Windows NT, Version 4.0 with Service Pack 3

Message Queue Server: ■

Version 1.0

Tivoli Products: ■

Tivoli Lightweight Client Framework, Version 3.6

■

NT Event Adapter ¹ ¹

Windows NT Event Adapter (shipped with TEC, Version 3.6) Windows NT Event Log Adapter (shipped with TEC, Version 3.6)

Hardware Requirements All systems require a minimum of 10 MB of free disk space and 1 MB of memory. This space requirement is in addition to the space requirements for the management platform.

Documentation When you install Manager for MQS, files containing browsable and printable versions of the Tivoli Manager for Message Queue Server User's Guide (userguide.pdf and userguide.htm) are automatically placed in the %BINDIR%\..\generic_unix\TME\MSMQ\doc directory. In addition, the files are provided in the \DOC directory on the product's CD-ROM. Use Adobe Acrobat Reader to view or print the \DOC\pdf\userguide.pdf file. Point your browser to \DOC\html\userguide.htm to view the user's guide online.

4

Version 1.0

Tivoli GEM Instrumentation for Manager for MQS Release Notes

Tivoli GEM Instrumentation for Manager for MQS Release Notes This Release Notes document provides important information about the optionally-installed Tivoli GEM Instrumentation for Tivoli Manager for Message Queue Server. Refer to the Tivoli Global Enterprise Manager Release Notes, Version 2.2.1 for the most current information on using that product.

Introduction To manage Microsoft Message Queue (MSMQ) servers from Tivoli GEM's graphical Tivoli GEM console, you must install Tivoli GEM Instrumentation for Tivoli Manager for Message Queue Server (Tivoli GEM instrumentation) in addition to installing Tivoli Manager for Message Queue Server (Manager for MQS). Tivoli GEM instrumentation files on the Manager for MQS CD-ROM include: ■

■ ■ ■

Business description files (BDFs) and component description files (CDFs) found in the /GEMFILES directory. For more information, refer to Appendix C in the Tivoli Manager for Message Queue Server User's Guide. Icon files found in the /GEMFILES directory. AMP file which includes the CDF, BDF, and icon files. Shell script to circumvent a Tivoli Management Framework problem. See “Software Requirements” on page 6 for more information.

Related Information For task, monitor, and other user information, refer to Tivoli Manager for Message Queue Server User's Guide.

Tivoli Manager for Message Queue Server: Release Notes April 1999

5

Tivoli GEM Instrumentation for Manager for MQS Release Notes

Run-time Requirements See the Tivoli Global Enterprise Manager Release Notes for the operating system and software requirements for running Tivoli GEM instrumentation in the Tivoli environment. For Tivoli GEM server prerequisites, refer to the Tivoli Global Enterprise Manager Installation and User's Guide and the Tivoli Global Enterprise Manager Release Notes.

Software Requirements Tivoli GEM instrumentation that runs on endpoints has the following run-time requirements: ■

Manager for MQS

■

Tivoli GEM, Version 2.2.1 ¹

Tivoli GEM Event Enablement (must be installed with the Tivoli Enterprise Console (TEC)) Note: Run the ihsttec command to load the event classes and rules for Tivoli GEM instrumentation. The ihsttec command is located in the %BINDIR%\TDS\EventService directory.

¹ ¹

6

Tivoli GEM console Tivoli GEM server

■

JDK, Version 1.1.7b must be available to the Tivoli environment on the target system.

■

Tivoli Distributed Monitoring, Version 3.6, must be installed on the target system.

■

TEC, Version 3.6, must be available in the Tivoli environment.

■

Tivoli Management Framework, Version 3.6, installed.

■

Tivoli Software Distribution, Version 3.6, and TME 10 Software Distribution Gateway, Version 3.6.

■

TEC Adapter Configuration Facility, Version 3.6

Version 1.0

Tivoli GEM Instrumentation for Manager for MQS Release Notes

Note: When installing Tivoli GEM instrumentation, the following message may be displayed: oserv FAILURE ON TIVOLI MANAGEMENT FRAMEWORK, Version 3.6.

The oserv daemon may fail when installing a module on the Tivoli Management Framework, Version 3.6. You can avoid this problem by running the TMA_check_deps.sh script before installing modules. The TMA_check_deps.sh script is located on the CD-ROM in the /GEMFILES directory. You can also correct the oserv daemon failure problem by installing the 3.6-TMF-0033 patch followed by the 3.6-TMF-0038 patch for the Tivoli Management Framework.

Hardware Requirements The installation of Tivoli GEM instrumentation requires a minimum of 10 MB of free disk space and 10 MB of memory. This space requirement is in addition to the space requirements for the Manager for MQS.

Tivoli Manager for Message Queue Server: Release Notes April 1999

7

GI10-8031-00

/XRL/1 Table Definitions id

File

WQ1

QMM10RNP SCRIPT

WQ2

QMM10RNP SCRIPT

WQ3

QMM10RNP SCRIPT

WQ4

QMM10RNP SCRIPT

WQ5

QMM10RNP SCRIPT

WQ6

QMM10RNP SCRIPT

WQ7

QMM10RNP SCRIPT

WQ8

QMM10RNP SCRIPT

WQ9

QMM10RNP SCRIPT

WQ10

QMM10RNP SCRIPT

WQ11

QMM10RNP SCRIPT

WQ12

QMM10RNP SCRIPT

Page

References

iii

iii

iii

iii

iii

iii

iii

iii

iii

iii

iii

iii

iii

iii

iii

iii

iii

iii

iii

iii

iii

iii

iii

iv

Headings id

File

START

QMM10RNP SCRIPT

RELDOCS

QMM10RNP SCRIPT

SYSREQ

QMM10RNP SCRIPT

DOCCHG

QMM10RNP SCRIPT

STRTGEM

QMM10RNP SCRIPT

GRUNTIM

QMM10RNP SCRIPT

OSERV

QMM10RNP SCRIPT

Page

References

1

Release Notes

2

Related Information

2

System Requirements

4

Documentation

5

Tivoli GEM Instrumentation for Manager for MQS Release Notes 1

6

Run-time Requirements

6

Software Requirements 5

/XRL/2 Processing Options

Runtime values: Document fileid .................................................................................................. Document type ................................................................................................... Document style ................................................................................................... Profile ................................................................................................................. Service Level ...................................................................................................... SCRIPT/VS Release ........................................................................................... Date ..................................................................................................................... Time .................................................................................................................... Device ................................................................................................................. Number of Passes ............................................................................................... Index ................................................................................................................... SYSVAR G ........................................................................................................ SYSVAR X ........................................................................................................

QMM10RNP SCRIPT USERDOC TIVOLI EDFPRF40 0032 4.0.0 99.04.06 11:59:22 PSA 4 YES INLINE YES

Formatting values used: Annotation .......................................................................................................... Cross reference listing ........................................................................................ Cross reference head prefix only ....................................................................... Dialog ................................................................................................................. Duplex ................................................................................................................ DVCF conditions file ......................................................................................... DVCF value 1 .................................................................................................... DVCF value 2 .................................................................................................... DVCF value 3 .................................................................................................... DVCF value 4 .................................................................................................... DVCF value 5 .................................................................................................... DVCF value 6 .................................................................................................... DVCF value 7 .................................................................................................... DVCF value 8 .................................................................................................... DVCF value 9 .................................................................................................... Explode ............................................................................................................... Figure list on new page ..................................................................................... Figure/table number separation .......................................................................... Folio-by-chapter ................................................................................................. Head 0 body text ................................................................................................ Head 1 body text ................................................................................................ Head 1 appendix text ......................................................................................... Hyphenation ........................................................................................................ Justification ......................................................................................................... Language ............................................................................................................ Keyboard ............................................................................................................ Layout ................................................................................................................. Leader dots ......................................................................................................... Master index ....................................................................................................... Partial TOC (maximum level) ........................................................................... Partial TOC (new page after) ............................................................................ Print example id's ............................................................................................... Print cross reference page numbers ................................................................... Process value ...................................................................................................... Punctuation move characters ............................................................................. Read cross-reference file .................................................................................... Running heading/footing rule ............................................................................ Show index entries ............................................................................................. Table of Contents (maximum level) .................................................................. Table list on new page .......................................................................................

NO YES NO LABEL YES (none) (none) (none) (none) (none) (none) (none) (none) (none) (none) NO YES YES NO (none) (none) Appendix NO NO ENGL 395 OFF YES (none) 4 INLINE NO YES (none) ., (none) NONE NO 3 YES

/XRL/3 Title page (draft) alignment ............................................................................... RIGHT Write cross-reference file ................................................................................... (none)