websphere_mq Release Notes All versions

CA Unified Infrastructure Management

Copyright Notice

This online help system (the "System") is for your informational purposes only and is subject to change or withdrawal by CA at any time.

This System may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA. This System is confidential and proprietary information of CA and protected by the copyright laws of the United States and international treaties. This System may not be disclosed by you or used for any purpose other than as may be permitted in a separate agreement between you and CA governing your use of the CA software to which the System relates (the “CA Software”). Such agreement is not modified in any way by the terms of this notice.

Notwithstanding the foregoing, if you are a licensed user of the CA Software you may make one copy of the System for internal use by you and your employees, provided that all CA copyright notices and legends are affixed to the reproduced copy.

The right to make a copy of the System is limited to the period during which the license for the CA Software remains in full force and effect. Should the license terminate for any reason, it shall be your responsibility to certify in writing to CA that all copies and partial copies of the System have been destroyed.

TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS SYSTEM “AS IS” WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS SYSTEM, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE.

The manufacturer of this System is CA.

Provided with “Restricted Rights.” Use, duplication or disclosure by the United States Government is subject to the restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7014(b)(3), as applicable, or their successors.

Copyright © 2014 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.

Legal information on third-party and public domain software used in this product is documented in the Third-Party Licenses and Terms of Use (http://docs.nimsoft.com/prodhelp/en_US/Library/Legal.html).

Contact CA

Contact CA Support

For your convenience, CA Technologies provides one site where you can access the information that you need for your Home Office, Small Business, and Enterprise CA Technologies products. At http://ca.com/support, you can access the following resources:

■ Online and telephone contact information for technical assistance and customer services

■ Information about user communities and forums

■ Product and documentation downloads

■ CA Support policies and guidelines

■ Other helpful resources appropriate for your product

Providing Feedback about Product Documentation

Send comments or questions about CA Technologies product documentation to nimsoft.techpubs@ca.com.

To provide feedback about general CA Technologies product documentation, complete our short customer survey which is available on the support website at http://ca.com/docs.

Contents 5

Contents

Chapter 1: Related Documents

Related Documentation

Documentation for websphere_mq probe in Admin Console

Monitor Metrics Reference Information for CA Unified Infrastructure Management Probes (http://docs.nimsoft.com/prodhelp/en_US/Probes/ProbeReference/index.htm)

Chapter 1: Related Documents 5

Chapter 2: websphere_mq General Overview 7

Chapter 3: Upgrade Considerations 9

Chapter 4: Requirements 11

Hardware Requirements ............................................................................................................................................ 11

Software Requirements ............................................................................................................................................. 11

NAS Subsystem ID Requirements ........................................................................................................................ 12

Alarm Threshold Requirements .......................................................................................................................... 13

Chapter 5: Revision History 15

Chapter 2: websphere_mq General Overview 7

Chapter 2: websphere_mq General Overview

IBM WebSphere MQ is messaging middleware that allows you to share data and messages asynchronously between applications across multiple platforms. WebSphere MQ allows independent and potentially non-concurrent applications on a distributed system to communicate with each other. Applications can put or get data through WebSphere MQ messaging queues.

IBM WebSphere MQ defines logical containers that are named Queue Managers (QMs) for managing the storage and recovery of data. QMs coordinate with the applications that are updating messages on the queues, and perform queue isolation and locking functions to maintain consistency. WebSphere MQ messaging queues are used either to store messages from programs or are pointers to other queues. Channels are defined as a logical communication link between QMs. WebSphere MQ supports the message exchange in both point-to-point and publish/subscribe mode.

The WebSphere MQ Monitoring (websphere_mq) probe is installed locally on a system with the IBM WebSphere MQ. The probe discovers the available QMs and the corresponding messaging queues, channels, topics, and subscriptions. You can monitor and generate alarms for:

■ Queue Managers

■ Queues

■ Channels

■ Topics

■ Subscriptions

Chapter 3: Upgrade Considerations 9

Chapter 3: Upgrade Considerations

In case, you are upgrading the probe from a previous version to 2.00 consider the following points:

■ For viewing the new metrics that are introduced in websphere_mq probe version 2.00 on the Unified Service Management (USM) portlet of the UMP, you can perform any one of the following actions:

■ Upgrade your NMS 7.6 to CA UIM 8.0

■ Install the ci_defn_pack probe version 1.00 and restart the nis_server probe.

■ The Queue metrics generated by an earlier version of the probe will display at the LocalQueue level on the USM in version 2.00. However, the existing metrics already displaying at Queue level remain as is on the USM.

■ The Queue monitors, which are activated on earlier version of the probe will move to the Detached Configuration node after upgrade. You have to activate monitors for each queue again from the LocalQueue node.

■ The earlier version of the probe uses IP address of the system as QoS and alarm source while the 2.00 uses the hostname as the default source. After migration, you can update the Source Override field value at websphere_mq node to IP address else two views will be displayed on the USM for the same metric.

■ The QMs and their corresponding components which are the part of a cluster will start displaying under ClusterQueueManager node and their activated monitors will move to the Detached Configuration node. Earlier, all QMs are displayed under the QueueManager node.

Chapter 4: Requirements 11

Chapter 4: Requirements

This section contains the requirements for the websphere_mq probe.

This section contains the following topics:

Hardware Requirements (see page 11) Software Requirements (see page 11)

Hardware Requirements

The websphere_mq probe should be installed on systems with the following minimum resources:

■ Memory: 2-4GB of RAM. Probe's OOB configuration requires 256MB of RAM

■ CPU: 3GHz dual-core processor, 32-bit or 64-bit

Software Requirements

The websphere_mq probe requires the following software environment:

Probe v1.0 requires:

■ Nimsoft Monitor Server 7.60 or CA Unified Infrastructure Management 8.0 or later

■ Robot 7.60 or later

■ Probe Provisioning Manager (PPM) probe version 2.34 or later (for Admin Console GUI only)

■ Java Virtual Machine 1.7 or later

■ IBM WebSphere MQ versions 7.5.X or 7.0.X (tested on versions 7.5.0.3 and 7.0.1.10)

Probe v2.0 requires:

■ Probe Provisioning Manager (PPM) probe version 2.38 or later.

Note: Other requirements remains same as v1.0.

Software Requirements

12 websphere_mq Release Notes

NAS Subsystem ID Requirements

Alarms are classified by their subsystem ID, identifying which part of the system the alarm relates to. These subsystem IDs are kept in a table that is maintained by the NAS probe.

If you are using NMS 7.6 or earlier, you can add the following subsystem IDs manually using the NAS Raw Configuration menu.

Important! This step is not required if you are using CA UIM 8.0 or later.

Key Name Value

2.3.7. WebSphere_MQ

2.3.7.1 Resource

2.3.7.2. QueueManager

2.3.7.3. Queue

2.3.7.4. Channel

2.3.7.5. Subscription

2.3.7.6. Topic

Software Requirements

Chapter 4: Requirements 13

To update the Subsystem IDs using Admin Console, follow these steps:

1. In the Admin Console, click the black arrow next to the NAS probe, select Raw Configure.

2. Click the Subsystems folder.

3. Click the New Key Menu item.

4. Enter the Key Name in the Add key window, click Add.

The new key appears in the list of keys with a blank value.

5. Click in the Value column for the newly created key and enter the key value.

6. Repeat this process for all of the required subsystem IDs for your probe.

7. Click Apply.

To update the Subsystem IDs using Infrastructure Manager, follow these steps:

1. In Infrastructure Manager, right click on the NAS probe, select Raw Configure.

2. Click the Subsystems folder.

3. Click the New Key... button.

4. Enter the Key Name and Value, Click OK.

5. Repeat this process for all of the required subsystem IDs for your probe.

6. Click Apply.

Alarm Threshold Requirements

The PPM probe maintains a table of subsystem IDs that are mapped to the probes. As of the current release, the subsystem IDs for this probe will default to 1.1.19. If you are using either dynamic or static alarm thresholds, you can change the default entry to the appropriate subsystem ID.

Follow these steps:

1. In the Admin Console, click the black arrow next to the probe, select Configure.

2. Select the monitor that you want to modify from the available list.

3. Change the Static and Dynamic Subsystem (override) fields to 2.3.7.1..

4. Save your settings.

Chapter 5: Revision History 15

Chapter 5: Revision History

This section describes the history of the revisions for this probe.

Date Description State Version

September 2014 ■ Added support for monitoring Topics and Subscriptions.

■ Added new metrics for monitoring in doubt status of the channels.

■ Added support for monitoring Remote, Alias, Model, and Cluster queues.

■ Added support for monitoring inhibit put and inhibit get status of the queue.

■ Added support for Multi-Instance queue manager monitoring.

■ Added support for monitoring WebSphere MQ on Solaris 11 and Windows Server 2012 R2 operating systems.

GA 2.01

June 2014 ■ First release of the probe with Admin Console GUI.

■ The probe configuration is available ONLY through Admin Console GUI and NOT through IM probe GUI.

■ The probe must run with NMS 7.6 or later version and PPM 2.34 or later version.

GA 1.01