Skip Headers
Oracle® Enterprise Manager Cloud Control Getting Started with Oracle Fusion Middleware Management
12c Release 2 (12.1.0.2)

Part Number E24215-04
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

22 Discovering and Monitoring IBM WebSphere MQ

IBM WebSphere MQ is a message oriented middleware and its primary infrastructure is queue based. Message Queue (MQ) clusters are used for high availability, and management and monitoring is supported by a command line tool, user interface, and programmable command format messages.

IBM WebSphere MQ allows administrators to derive instant value, while giving them the flexibility to fine-tune thresholds according to their specific operational requirements.

Note:

IBM WebSphere MQ code is bundled with the Oracle Fusion Middleware plug-in.

The following topics are discussed in this document:

22.1 Introduction

IBM WebSphere MQ offers several key benefits, including the following:

Out-of-Box Availability and Performance Monitoring

The plug-in allows you to realize immediate value through out-of-box availability and performance monitoring. Some of the key areas of the more than 60 performance indicators monitored by the plug-in include queue manager status, channel status, queue depth, bytes sent or received, and messages sent or received.

To further aid administrators with critical tasks, such as problem diagnosis, trend analysis, and capacity planning, the System Monitoring for IBM WebSphere MQ includes various out-of-box reports, summarizing key information about availability and performance. IBM WebSphere MQ System Monitoring Plug-in key features include:

Centralized Monitoring of all Information in a Single Console

IBM WebSphere MQ provides administrators managing Oracle systems and IBM WebSphere MQ with a consolidated view of the entire enterprise, enabling them to monitor and manage all of their components from a central place.

Having such an integrated tool reduces the total cost of ownership by eliminating the need to manually compile critical information from several different tools, thus streamlining the correlation of availability and performance problems across the entire set of IT components.

In addition, System Monitoring for IBM WebSphere MQ complements existing plug-in support for host systems (requires licensing of System Monitoring Plug-in for Hosts), providing administrators with more depth and greater ability to view IBM WebSphere MQ operations directly in the context of operating system activity.

Enhance Service Modeling and Perform Comprehensive Root Cause Analysis

Oracle Enterprise Manager's Service Level Management functionality provides a comprehensive monitoring solution that helps IT organizations achieve high availability, performance, and optimized service levels for their business services. Administrators can monitor services from the end-users' perspective using service tests or synthetic transactions, model relationships between services and underlying IT components, diagnose root cause of service failure, and report on achieved service levels.

The System Monitoring Plug-in for IBM WebSphere MQ enables IT organizations running applications on top of Oracle and IBM to derive greater value from the Service Level Management features of Enterprise Manager in a number of ways:

22.2 Requirements

The following prerequisites must be met before installing the IBM WebSphere MQ plug-in:

Target discovery is performed using Grid Control Agent 10.2.0.3, so this agent must be installed and running. The agent can be installed on the same node as IBM WebSphere MQ (for Local Monitoring) or on another node in the intranet (for Remote Monitoring).

The agent must have a status UP in the Grid Control console and must upload data successfully to the Grid Control OMS (communication from the agent to the OMS). The Preferred Credentials must have been set and successfully tested for the agent node. The Host Credentials to be used for the discovery should be either the Grid Control Agent user or a user part of the same group (primary gid).

22.2.1 About Jar File Requirements for Local Monitoring

For local monitoring, the Grid Control Agent OS user should have read privileges over the following jar files, which are needed for the discovery of the target IBM WebSphere MQ:

  • $MQ_HOME/java/lib/com.ibm.mq.jar

  • $MQ_HOME/java/lib/connector.jar

  • $MQ_HOME/eclipse/plugins/com.ibm.mq.pcf_6.0.0/pcf.jar

Note:

MQ_HOME is the directory used to install MQ setup at installation time.

22.2.2 About Jar File Requirements for Remote Monitoring

For Remote Monitoring, the TCP listener port of the Queue Manager must be open to the Agent Host. The appropriate jar files must be copied on the node where the Grid Control Agent is running and the OS user starting this agent must have read privileges on these files. For example, create a directory <AGENT_ORACLE_HOME>/sysman/mq_jar_files and copy the jar files into this directory.

The following sections provide details on the jar files required to support remote monitoring from IBM Websphere MQ V6 and V7:

IMB WebSphere MQ V6

  • $MQ_HOME/java/lib/com.ibm.mq.jar

  • $MQ_HOME/java/lib/connector.jar

  • $MQ_HOME/eclipse/plugins/com.ibm.mq.pcf_6.0.0/pcf.jar

IBM WebSphere MQ V7

  • $MQ_HOME/opt/mqm/java/lib/com.ibm.mq.jar

  • $MQ_HOME/opt/mqm/eclipse/plugins/com.ibm.mq.pcf.event_7.0.0.1.jar

  • $MQ_HOME/opt/mqm/java/lib/com.ibm.mq.jmqi.jar

  • $MQ_HOME/opt/mqm/java/lib/com.ibm.mq.commonservices.jar

  • $MQ_HOME/opt/mqm/java/lib/com.ibm.mq.headers.jar

22.3 Understanding Discovery

IBM WebSphere MQ supports the discovery of entire Queue Manager Clusters from a single Queue manager. Administrators can derive instant value, while giving them the flexibility to fine-tune thresholds according to their specific operational requirements. Some of the key areas of the more than 60 performance indicators being monitored, including queue manager status, channel status, queue depth, bytes sent and/or received, and messages sent and/or received.

To further aid administrators with critical tasks such as problem diagnosis, trend analysis, and capacity planning, plug-in includes various out-of-box reports, summarizing key information about availability and performance.

22.3.1 Discovery Parameters

The following parameters are required for MQ discovery:

  • Host name (where the queue manager is running)

  • Port number

  • JAR path

  • MQ administration username

  • MQ administration password

  • Agent host

The following parameters are required for agent discovery:

  • Host name

  • Host credentials

22.3.2 Discovery Prerequisites for Local Agent

To enable discovery for the local agent the queue manager must be running and the TCP listener must be up. In addition, the following jar files are required for discovery and should therefore be accessible to agent:

  • com.ibm.mq.jar (present under MQ_HOME/java/lib)

  • connector.jar (present under MQ_HOME/java/lib)

  • pcf.jar (present under MQ_HOME/eclipse/plugins/com.ibm.mq.pcf_<version>)

The Agent Host Credentials to be used for discovery should be either Oracle Agent User or should be part of the same group. The SYSTEM.DEF.SERVERCON channel should also be available.

22.3.3 Discovery Prerequisites for Remote Agent

To enable discovery for the remote agent the queue manager must be running and the TCP listener must be up. The TCP listener port of the Target Queue Manager must also be accessible to the agent. In addition, the following jar files are required for discovery and should therefore be accessible to agent:

  • com.ibm.mq.jar (present under MQ_HOME/java/lib)

  • connector.jar (present under MQ_HOME/java/lib)

  • pcf.jar (present under MQ_HOME/eclipse/plugins/com.ibm.mq.pcf_<version>)

The Agent Host Credentials to be used for discovery should be either Oracle Agent User or should be part of same group. The SYSTEM.DEF.SERVERCON channel should also be available.

22.3.4 Queue Manager Cluster Discovery

A cluster will be discovered automatically If the queue manager is part of a cluster. To discover other members of cluster, those queue managers should be running. If the queue manager is part of more than one cluster then all clusters will be discovered.

To following points outline the logic involved in cluster discovery:

  • To discover the entire cluster you first discover any member of cluster

  • Get connection details of all other queue managers along with cluster name

    If the queue manager is part of multiple clusters then repeat the step for each cluster

  • Connect to each queue manager using the connection details

    If the queue manager is part of multiple clusters then repeat the step for each cluster

  • Get the name of the queue manager (queue manager should be running)

  • Once the cluster is added to Grid Control, you cannot explicitly remove any member queue managers from that cluster.

The MQ to be discovered can be either local or remote to the host where the Enterprise Manager Agent resides. To manually add targets, complete the following:

  1. From the Enterprise Manager Setup menu, select Add Target, then select Add Target Manually.

    discovery1
  2. Select the Add Targets Using Guided Process (Also Adds Related Targets) option.

    discovery2
  3. Select IBM WebSphere MQ Queue Manager from Target Types and click Add Using Guided Process....

    discovery3
  4. Provide the following required information for discovery and click Next.

    1. Host on which IBM MQ is running.

    2. Port number of the queue manager you want to discover (associated cluster and all queue manager in this cluster will also be discovered).

    3. Jar path location (location must be accessible to the OEM agent).

    4. Provide the agent host details used to monitor IBM WebSphere MQ.

    5. MQ administration credentials.

    required information for discovery
  5. Select the cluster you want to discover and click Next.

    select cluster

    The following image shows a Queue Manager cluster:

    standalone qm
  6. Click OK to finish discovery.

    image6

22.3.5 Standalone Queue Manager Discovery

Standalone queue manager discovery is also supported. The steps to manually add a standalone queue manager are the same as those described for cluster queue manager discovery. see Queue Manager Cluster Discovery for more information. The only difference is that you select a standalone queue manager from the list of possible targets on the Add IBM WebSphere MQ Targets: Available Targets page, as shown below:

standalone

22.4 Monitoring

The following illustrates some of the different methods used to monitor the performance of the IBM WebSphere MQ plug-in:

22.5 IBM WebSphere MQ Metrics

For information on all IBM WebSphere MQ metric categories, including tables that list and describe associated metrics for each category, see the IBM WebSphere MQ Metrics chapter in Oracle® Enterprise Manager System Monitoring Plug-in Metric Reference Manual for Non-Oracle Middleware Management. This can be found at the following location:

http://docs.oracle.com/cd/E11857_01/em.111/e10115/middleware_mq.htm#sthref127