IBM MQ
VMWARE VREALIZE END POINT OPERATIONS FOR
IBM MQ User Guide
TABLE OF CONTENTS 1. Product Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Product Version Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 3. Known Issues/Limitations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 4. System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 5. IBM MQ Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 5.1 Setting the Java Library Path for IBM MQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 5.2 Configure MQ Least Privileged User. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 5.3 Enable Queue Full, Depth High, and Depth Low Events . . . . . . . . . . . . . 4 5.4 Enable Performance Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 6. Installing End Point Operations for IBM MQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 6.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 6.2 Installing the End Point Operations Management Agent . . . . . . . . . . . . . 5 6.3 Uploading the Installation (.pak) file in vRealize Operations. . . . . . . . . 5 6.4 What to do next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 7. Viewing/Modifying Agent Configuration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 7.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 7.2 Procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 7.3 What to do next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 8. IBM MQ End Point Agent Overview Dashboard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 9. Metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 10. Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 11. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 11.1 Viewing Errors in the Agent Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 11.2 Viewing Queue Full, Depth High, and Depth Low Events. . . . . . . . . 10
NOTE: This document supports the version of each product listed, as well as all subsequent versions, until a new edition replaces it. You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com. The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: [email protected]. 2
Blue Medora VMware vRealize End Point Operations for IBM MQ
1. Product Overview Blue Medora VMware vRealize End Point Operations for IBM MQ collects performance data from IBM MQ resources and makes it available within VMware vRealize Operations (vROps).
2. Product Version Information VERSION
RELEASE DATE
DESCRIPTION
6.3.1010000
June 30, 2017
Initial release by Blue Medora
3. Known Issues/Limitations Because Queue Manager Status and Command Server Status are not availability metrics, they will not turn red within the user interface to indicate when they are “down”.
4. System Requirements Before installing the End Point operations for IBM MQ, ensure your system meets the following requirements: Table 1: System Requirements Operating System (OS)
• Windows • Linux
vRealize Operations (vRops)
vRealize Operations 6.3+
IBM MQ
IBM WebSphere MQ 8.0 IBM MQ 9.0
5. IBM MQ Configuration Before installing End Point Operations for IBM MQ, you must configure the following on your IBM Queue Manager: • • • •
Setting the Java Library Path for IBM MQ Configure MQ Least-Privileged User (Optional) Enable Queue Full, Depth High, and Depth Low Events Enable Performance Events
5.1 Setting the Java Library Path for IBM MQ To set the Java Library Path for the IBM MQ agent, ensure the directory containing the IBM MQ Java Native Interface (JNI) libraries (<mq-install-dir>/java/lib64) is included in the LD_LIBRARY_PATH environment variable, or add the following line to the /bundles/agent-/conf/ wrapper.conf file: wrapper.java.library.path.3=<mq-install-dir>/java/lib64
NOTE: is the location where the agent is installed.
is the version of the EP Ops agent.
<mq-install-dir> is the location where MQ is installed.
3
Blue Medora VMware vRealize End Point Operations for IBM MQ
5.2 Configure MQ Least Privileged User The user must have read/write/execute access to the EP Ops base agent directory. Linux Only: • The user running the base agent on the MQ machine must be added to the authorized users list. See the following IBM Support Technote: http://www-01.ibm.com/support/docview.wss?uid=swg21166937.
Example command to run (where the user is EPOpsAgentRunner and the Queue Manager is A1QM):
<MQ_Install_Dir>/bin/setmqaut -m A1QM -n A1QM.LQ -t q -p EPOpsAgentRunner +put
Linux and Windows users: • Non-admin users also must be added to the mqm group, which is created when MQ is installed. Linux: Below is an example command to run (where the user is EPOpsAgentRunner):
sudo usermod -a -G mqm EPOpsAgentRunner
Windows: Follow Microsoft’s Windows Server instructions for Adding a Member to a group: https:// technet.microsoft.com/en-us/library/cc753515(v=ws.11).aspx Linux and Windows users: Next, either 1) restart the Queue Manager, or 2) refresh the security cache by running the following commands (where <MQ_INSTALL_DIR> is the MQ installation directory and is the Queue Manager name): <MQ_INSTALL_DIR>/bin /runmqsc REFRESH SECURITY(*) EXIT
After you’ve restarted or refreshed, log out and log back in with the EPOpsAgentRunner user. 5.3 Enable Queue Full, Depth High, and Depth Low Events Queue Full Events, Depth High Events, and Depth Low Events must be enabled in order to be collected. The easiest way to enable them is to use the MQ Explorer Eclipse plugin shipped with MQ. In Windows this can be accessed by going to {MQ_INSTALL_DIR}\MQExplorer\eclipse and doubleclicking on runWithTrace. NOTE: A tutorial for connecting to a Queue Manager can be found at: https://www.youtube.com/ watch?v=mHIhDJEQGGw. Once you have successfully connected to a Queue Manager, expand the Queue Manager: 1. Click on Queues. 2. Right-click on the Queue for which you want to monitor performance events. 3. Under Events, ensure the following settings are enabled: • depth max events • depth high events • depth low events 4. Restart the Queue Manager to apply the configuration changes. 5.4 Enable Performance Events To enable performance events, you also must run the following commands (where <MQ_INSTALL_DIR> is the MQ installation directory and is the Queue Manager name): <MQ_INSTALL_DIR>/bin ./runmqsc ALTER QMGR PERFMEV (ENABLED) EXIT 4
Blue Medora VMware vRealize End Point Operations for IBM MQ
6. Installing End Point Operations for IBM MQ To successfully install End Point Operations for IBM MQ, you must first install the End Point Operations Management agent on your MQ host machines, then upload the EP Ops for IBM MQ installation file in vROps. 6.1 Prerequisites Obtain the End Point Operations for IBM MQ installation (.pak) file from the VMware Solution Exchange. 6.2 Installing the End Point Operations Management Agent Install the End Point Operations Management agent on your IBM MQ host machines. For instructions, refer to VMware’s online help for your specific version of vRealize Operations: vROps version 6.3: End Point Operations Management Agent Installation and Deployment vROps version 6.4: End Point Operations Management Agent Installation and Deployment vROps version 6.5: End Point Operations Management Agent Installation and Deployment vROps version 6.6: End Point Operations Management Agent Installation and Deployment NOTE: When you install the End Point Operations Management agents on a distributed system, ensure that you install the agent on every machine that you would like to monitor. 6.3 Uploading the Installation (.pak) file in vRealize Operations 1. Save the .pak file in a temporary location. 2. Log in to vRealize Operations as an admin user.
3. In the left pane, select Administration, then click Solutions.
4. In the right panel, the Solutions list will be displayed. 5. Click the Add icon ( click Upload.
5
). In the dialog that appears, browse to the location of the saved .pak file, then
Blue Medora VMware vRealize End Point Operations for IBM MQ
NOTE: When you upload the .pak file, you’ll see a notification regarding the file being unsigned. Ignore this notification and continue the installation process. 6. Read and accept the End User License Agreement (EULA) , then click Next. The upload might take several minutes to complete. Status information appears in the Installation Details text box throughout the installation process. 7. Click Finish when the installation process is complete. 6.4 What to do next After End Point Operations for IBM MQ has been installed, you can view the adapter instance for the agent created in vROps and modify the configuration settings, if needed.
6
Blue Medora VMware vRealize End Point Operations for IBM MQ
7. Viewing/Modifying Agent Configuration Settings After the End Point Operations for IBM MQ .pak file has been installed, you can view the configuration settings for the adapter instance using the Inventory Explorer. 7.1 Prerequisites Wait for vROps to complete one collection cycle so that the installed agent can be discovered. 7.2 Procedure 1. In the left pane of vRealize Operations Manager, click Administration, then Inventory Explorer. 2. Click Adapter Types > EP Ops Adapter. 3. Select the applicable IBM MQ server, then click Edit Object ( ). The Edit Object dialog box will open.
4. The following settings are configurable: • ibmwebspheremq.queuemanager: Enter the Queue Manager specific to this instance (it should be the instance name located after the underscore in the Display Name field.).
• Install path (optional): The install path will be automatically detected; however, you can override the value in this field. NOTE: Once the MQ EP Ops agent is running, any setting changes require the Override agent configuration data setting to be set to True.
7
Blue Medora VMware vRealize End Point Operations for IBM MQ
7.3 What to do next Your End Point Operations for IBM MQ agent should now start returning performance metrics for the server(s) on the configured host. Navigate to your Dashboard List and select the IBM MQ End Point Agent Overview dashboard.
8. IBM MQ End Point Agent Overview Dashboard End Point Operations for IBM MQ includes the following out-of-the-box overview dashboard. Select a server from the IBM MQ Selector widget on the left to view its key performance metrics on the right.
8
Blue Medora VMware vRealize End Point Operations for IBM MQ
9. Metrics The following metrics are collected by the End Point Operations solution for IBM MQ. Table 2: IBM MQ Metrics RESOURCE KIND
RESOURCE ATTRIBUTE
Queue Manager
Queue Manager Status
Queue Manager
Command Server Status
Queue Manager
Number of Connections
Queue Manager
Running Listeners
Queue Manager
Inactive Listeners
Queue Manager
Running Channels
Queue Manager
Channels Disconnected
Queue Manager
Queues with High Depth
Queue Manager
Queues with Low Depth
Queue Manager
Queue Full Events
10. Properties The following properties are collected by End Point Operations for IBM MQ Table 3: IBM MQ Properties RESOURCE KIND
PROPERTY
Queue Manager
Installation path
Queue Manager
PID (Parent process ID)
Queue Manager
Port number
Queue Manager
Version
To view these properties, select the Queue Manager for which you want to view properties from the IBM MQ Selector widget in the dashboard, then select the Object Detail ( ) icon.
In the Summary tab that appears, properties for the selected server are listed in the About Me widget on the right.
9
Blue Medora VMware vRealize End Point Operations for IBM MQ
11. Troubleshooting 11.1 Viewing Errors in the Agent Log File You can review EP Ops agent errors in the agent.log file, which can be viewed in the vROps user interface or in an external log viewer. The log file can be found at $VCOPS_BASE/user/log/agent.log. 11.2 Viewing Queue Full, Depth High, and Depth Low Events Queue Full Events, Depth High Events, and Depth Low Events are viewed from the SYSTEM.ADMIN.PERFM. EVENT queue. The agent currently performs Browse_Only “gets” of this queue. Therefore, the same events will be counted in every subsequent collection. When one of these events occurs, it is recommended that after investigating the cause of the event (the event information will be written to the EP Ops base agent agent.log (requires configuring error logging to debug), the MQ administrator clears the PERFM.EVENT queue, which resets the counts to 0. This can be accomplished by going to the MQ install_dir and running ./bin/runmqsc and then running: clear qlocal (SYSTEM.ADMIN.PERFM.EVENT) If you see an exception in the agent.log with “Caused by: com.ibm.mq.jmqi.local.LocalMQ$4: CC=2;RC=2495;AMQ8598: Failed to load the WebSphere MQ native JNI library: ‘mqjbnd’.” please make sure that you are copying the correct (64-bit or 32-bit) .dll or .so files into the correct location, then restart the agent.
10
Blue Medora VMware vRealize End Point Operations for IBM MQ
You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com. The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: [email protected].
Copyright © 2017 Blue Medora Inc. All rights reserved. U.S. and international copyright and intellectual property laws protect this product. Blue Medora is a registered trademark or trademark of Blue Medora in the United States and/or other jurisdictions. The IBM name (including IBM MQ) and logo are trademarks or registered trademarks of International Business Machines, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. Blue Medora 3225 N Evergreen Dr. NE Suite 103 Grand Rapids, MI 49525 bluemedora.com
IBM MQ User Guide
TABLE OF CONTENTS 1. Product Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Product Version Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 3. Known Issues/Limitations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 4. System Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 5. IBM MQ Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 5.1 Setting the Java Library Path for IBM MQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 5.2 Configure MQ Least Privileged User. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 5.3 Enable Queue Full, Depth High, and Depth Low Events . . . . . . . . . . . . . 4 5.4 Enable Performance Events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 6. Installing End Point Operations for IBM MQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 6.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 6.2 Installing the End Point Operations Management Agent . . . . . . . . . . . . . 5 6.3 Uploading the Installation (.pak) file in vRealize Operations. . . . . . . . . 5 6.4 What to do next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 7. Viewing/Modifying Agent Configuration Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 7.1 Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 7.2 Procedure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 7.3 What to do next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 8. IBM MQ End Point Agent Overview Dashboard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 9. Metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 10. Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 11. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 11.1 Viewing Errors in the Agent Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 11.2 Viewing Queue Full, Depth High, and Depth Low Events. . . . . . . . . 10
NOTE: This document supports the version of each product listed, as well as all subsequent versions, until a new edition replaces it. You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com. The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: [email protected]. 2
Blue Medora VMware vRealize End Point Operations for IBM MQ
1. Product Overview Blue Medora VMware vRealize End Point Operations for IBM MQ collects performance data from IBM MQ resources and makes it available within VMware vRealize Operations (vROps).
2. Product Version Information VERSION
RELEASE DATE
DESCRIPTION
6.3.1010000
June 30, 2017
Initial release by Blue Medora
3. Known Issues/Limitations Because Queue Manager Status and Command Server Status are not availability metrics, they will not turn red within the user interface to indicate when they are “down”.
4. System Requirements Before installing the End Point operations for IBM MQ, ensure your system meets the following requirements: Table 1: System Requirements Operating System (OS)
• Windows • Linux
vRealize Operations (vRops)
vRealize Operations 6.3+
IBM MQ
IBM WebSphere MQ 8.0 IBM MQ 9.0
5. IBM MQ Configuration Before installing End Point Operations for IBM MQ, you must configure the following on your IBM Queue Manager: • • • •
Setting the Java Library Path for IBM MQ Configure MQ Least-Privileged User (Optional) Enable Queue Full, Depth High, and Depth Low Events Enable Performance Events
5.1 Setting the Java Library Path for IBM MQ To set the Java Library Path for the IBM MQ agent, ensure the directory containing the IBM MQ Java Native Interface (JNI) libraries (<mq-install-dir>/java/lib64) is included in the LD_LIBRARY_PATH environment variable, or add the following line to the /bundles/agent-/conf/ wrapper.conf file: wrapper.java.library.path.3=<mq-install-dir>/java/lib64
NOTE: is the location where the agent is installed.
is the version of the EP Ops agent.
<mq-install-dir> is the location where MQ is installed.
3
Blue Medora VMware vRealize End Point Operations for IBM MQ
5.2 Configure MQ Least Privileged User The user must have read/write/execute access to the EP Ops base agent directory. Linux Only: • The user running the base agent on the MQ machine must be added to the authorized users list. See the following IBM Support Technote: http://www-01.ibm.com/support/docview.wss?uid=swg21166937.
Example command to run (where the user is EPOpsAgentRunner and the Queue Manager is A1QM):
<MQ_Install_Dir>/bin/setmqaut -m A1QM -n A1QM.LQ -t q -p EPOpsAgentRunner +put
Linux and Windows users: • Non-admin users also must be added to the mqm group, which is created when MQ is installed. Linux: Below is an example command to run (where the user is EPOpsAgentRunner):
sudo usermod -a -G mqm EPOpsAgentRunner
Windows: Follow Microsoft’s Windows Server instructions for Adding a Member to a group: https:// technet.microsoft.com/en-us/library/cc753515(v=ws.11).aspx Linux and Windows users: Next, either 1) restart the Queue Manager, or 2) refresh the security cache by running the following commands (where <MQ_INSTALL_DIR> is the MQ installation directory and is the Queue Manager name): <MQ_INSTALL_DIR>/bin /runmqsc REFRESH SECURITY(*) EXIT
After you’ve restarted or refreshed, log out and log back in with the EPOpsAgentRunner user. 5.3 Enable Queue Full, Depth High, and Depth Low Events Queue Full Events, Depth High Events, and Depth Low Events must be enabled in order to be collected. The easiest way to enable them is to use the MQ Explorer Eclipse plugin shipped with MQ. In Windows this can be accessed by going to {MQ_INSTALL_DIR}\MQExplorer\eclipse and doubleclicking on runWithTrace. NOTE: A tutorial for connecting to a Queue Manager can be found at: https://www.youtube.com/ watch?v=mHIhDJEQGGw. Once you have successfully connected to a Queue Manager, expand the Queue Manager: 1. Click on Queues. 2. Right-click on the Queue for which you want to monitor performance events. 3. Under Events, ensure the following settings are enabled: • depth max events • depth high events • depth low events 4. Restart the Queue Manager to apply the configuration changes. 5.4 Enable Performance Events To enable performance events, you also must run the following commands (where <MQ_INSTALL_DIR> is the MQ installation directory and is the Queue Manager name): <MQ_INSTALL_DIR>/bin ./runmqsc ALTER QMGR PERFMEV (ENABLED) EXIT 4
Blue Medora VMware vRealize End Point Operations for IBM MQ
6. Installing End Point Operations for IBM MQ To successfully install End Point Operations for IBM MQ, you must first install the End Point Operations Management agent on your MQ host machines, then upload the EP Ops for IBM MQ installation file in vROps. 6.1 Prerequisites Obtain the End Point Operations for IBM MQ installation (.pak) file from the VMware Solution Exchange. 6.2 Installing the End Point Operations Management Agent Install the End Point Operations Management agent on your IBM MQ host machines. For instructions, refer to VMware’s online help for your specific version of vRealize Operations: vROps version 6.3: End Point Operations Management Agent Installation and Deployment vROps version 6.4: End Point Operations Management Agent Installation and Deployment vROps version 6.5: End Point Operations Management Agent Installation and Deployment vROps version 6.6: End Point Operations Management Agent Installation and Deployment NOTE: When you install the End Point Operations Management agents on a distributed system, ensure that you install the agent on every machine that you would like to monitor. 6.3 Uploading the Installation (.pak) file in vRealize Operations 1. Save the .pak file in a temporary location. 2. Log in to vRealize Operations as an admin user.
3. In the left pane, select Administration, then click Solutions.
4. In the right panel, the Solutions list will be displayed. 5. Click the Add icon ( click Upload.
5
). In the dialog that appears, browse to the location of the saved .pak file, then
Blue Medora VMware vRealize End Point Operations for IBM MQ
NOTE: When you upload the .pak file, you’ll see a notification regarding the file being unsigned. Ignore this notification and continue the installation process. 6. Read and accept the End User License Agreement (EULA) , then click Next. The upload might take several minutes to complete. Status information appears in the Installation Details text box throughout the installation process. 7. Click Finish when the installation process is complete. 6.4 What to do next After End Point Operations for IBM MQ has been installed, you can view the adapter instance for the agent created in vROps and modify the configuration settings, if needed.
6
Blue Medora VMware vRealize End Point Operations for IBM MQ
7. Viewing/Modifying Agent Configuration Settings After the End Point Operations for IBM MQ .pak file has been installed, you can view the configuration settings for the adapter instance using the Inventory Explorer. 7.1 Prerequisites Wait for vROps to complete one collection cycle so that the installed agent can be discovered. 7.2 Procedure 1. In the left pane of vRealize Operations Manager, click Administration, then Inventory Explorer. 2. Click Adapter Types > EP Ops Adapter. 3. Select the applicable IBM MQ server, then click Edit Object ( ). The Edit Object dialog box will open.
4. The following settings are configurable: • ibmwebspheremq.queuemanager: Enter the Queue Manager specific to this instance (it should be the instance name located after the underscore in the Display Name field.).
• Install path (optional): The install path will be automatically detected; however, you can override the value in this field. NOTE: Once the MQ EP Ops agent is running, any setting changes require the Override agent configuration data setting to be set to True.
7
Blue Medora VMware vRealize End Point Operations for IBM MQ
7.3 What to do next Your End Point Operations for IBM MQ agent should now start returning performance metrics for the server(s) on the configured host. Navigate to your Dashboard List and select the IBM MQ End Point Agent Overview dashboard.
8. IBM MQ End Point Agent Overview Dashboard End Point Operations for IBM MQ includes the following out-of-the-box overview dashboard. Select a server from the IBM MQ Selector widget on the left to view its key performance metrics on the right.
8
Blue Medora VMware vRealize End Point Operations for IBM MQ
9. Metrics The following metrics are collected by the End Point Operations solution for IBM MQ. Table 2: IBM MQ Metrics RESOURCE KIND
RESOURCE ATTRIBUTE
Queue Manager
Queue Manager Status
Queue Manager
Command Server Status
Queue Manager
Number of Connections
Queue Manager
Running Listeners
Queue Manager
Inactive Listeners
Queue Manager
Running Channels
Queue Manager
Channels Disconnected
Queue Manager
Queues with High Depth
Queue Manager
Queues with Low Depth
Queue Manager
Queue Full Events
10. Properties The following properties are collected by End Point Operations for IBM MQ Table 3: IBM MQ Properties RESOURCE KIND
PROPERTY
Queue Manager
Installation path
Queue Manager
PID (Parent process ID)
Queue Manager
Port number
Queue Manager
Version
To view these properties, select the Queue Manager for which you want to view properties from the IBM MQ Selector widget in the dashboard, then select the Object Detail ( ) icon.
In the Summary tab that appears, properties for the selected server are listed in the About Me widget on the right.
9
Blue Medora VMware vRealize End Point Operations for IBM MQ
11. Troubleshooting 11.1 Viewing Errors in the Agent Log File You can review EP Ops agent errors in the agent.log file, which can be viewed in the vROps user interface or in an external log viewer. The log file can be found at $VCOPS_BASE/user/log/agent.log. 11.2 Viewing Queue Full, Depth High, and Depth Low Events Queue Full Events, Depth High Events, and Depth Low Events are viewed from the SYSTEM.ADMIN.PERFM. EVENT queue. The agent currently performs Browse_Only “gets” of this queue. Therefore, the same events will be counted in every subsequent collection. When one of these events occurs, it is recommended that after investigating the cause of the event (the event information will be written to the EP Ops base agent agent.log (requires configuring error logging to debug), the MQ administrator clears the PERFM.EVENT queue, which resets the counts to 0. This can be accomplished by going to the MQ install_dir and running ./bin/runmqsc and then running: clear qlocal (SYSTEM.ADMIN.PERFM.EVENT) If you see an exception in the agent.log with “Caused by: com.ibm.mq.jmqi.local.LocalMQ$4: CC=2;RC=2495;AMQ8598: Failed to load the WebSphere MQ native JNI library: ‘mqjbnd’.” please make sure that you are copying the correct (64-bit or 32-bit) .dll or .so files into the correct location, then restart the agent.
10
Blue Medora VMware vRealize End Point Operations for IBM MQ
You can find the most up-to-date technical documentation on the Blue Medora support site at: http://support.bluemedora.com. The Blue Medora website also provides the latest product updates. If you have comments about this documentation, submit your feedback to: [email protected].
Copyright © 2017 Blue Medora Inc. All rights reserved. U.S. and international copyright and intellectual property laws protect this product. Blue Medora is a registered trademark or trademark of Blue Medora in the United States and/or other jurisdictions. The IBM name (including IBM MQ) and logo are trademarks or registered trademarks of International Business Machines, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. Blue Medora 3225 N Evergreen Dr. NE Suite 103 Grand Rapids, MI 49525 bluemedora.com
