如何使用Web方式监控IBM WebSphere MQ
Icwri Monitor for IBM WebSphere MQ Version 0.521用户手册

监控IBM WebSphere MQ是一个长久以来的热门话题。老式的telnet加runmqsc的方法以及资源管理器的方法对客户机都有过多的要求,并且步骤繁琐,资源消耗大。商品级的监控系统(比如ITCAM)配置复杂功能强大,但是有些客户可能不愿意支付相关费用。

我这里提供一个我制作的开源、免费的基于Web的监控工具,配置极其简单,且不需要除了WMQ本身以及Java Runtime Environment v1.5(或更高版本)以外的任何产品,可谓是超超轻量级的监控工具。此产品支持Web方式和多并发,资源消耗极低。以下是产品的中文手册:

本手册包括以下的内容:

 

安装

请首先从http://www.lrsolution.com/download.html下载“Icwri Tools for IBM WebSphere MQ”产品。如果您安装了WMQ v7.1,您已经有了“com.ibm.mq.pcf.jar”。如果您使用WMQ v6.0或WMQ v5.1,请从http://www-01.ibm.com/support/docview.wss?rs=171&uid=swg24000668&loc=en_US&cs=utf-8&lang=en下载“com.ibm.mq.pcf.jar”。系统在"samples"目录里面也提供了一个“com.ibm.mq.pcf.jar”文件。

1. 对Unix/Linux用户

1) 展开产品包

$ cd /opt
$ gzip -d ic_wmq_0.521.tar.gz
$ tar vxf ic_wmq_0.521.tar

2) 设置环境变量

CLASSPATH=/opt/ic_wmq_0.521/icwri.jar:/opt/ic_wmq_0.521/ic_wmq.jar:/opt/ic_wmq_0.521/ic_web.jar:/usr/mqm/java/lib/com.ibm.mq.jar:/usr/mqm/java/lib/com.ibm.mq.pcf.jar
export CLASSPATH

#AIX example:
LIBPATH=/usr/mqm/java/lib
export LIBPATH

#Solaris/Linux examples:
LD_LIBRARY_PATH=/usr/mqm/java/lib
export LD_LIBRARY_PATH

#HP-UX example:
SHLIB_PATH=/usr/mqm/java/lib
export SHLIB_PATH

3) 测试应用示例:

$ java lr.icwri.app.RunScript -f /opt/ic_wmq_0.521/samples/test.icw -s !testConnectQM1
Please input the Queue Manager name:
>> VENUS
Return code = 0

注:
"-s" 参数指定服务名
"-f" 参数指定脚本文件


2. 对Microsoft Windows用户

1) 展开产品包到指定的目录,比如:c:\ic_wmq_0.521

2) 设置环境变量

set CLASSPATH=c:\ic_wmq_0.521\icwri.jar;c:\ic_wmq_0.521\ic_wmq.jar;c:\ic_wmq_0.521\ic_web.jar;c:\mq\java\lib\com.ibm.mq.jar;c:\mq\java\lib\com.ibm.mq.pcf.jar
set PATH=c:\mq\bin;c:\mq\java\lib;%PATH%

3) 测试应用示例:

$ java lr.icwri.app.RunScript -f C:/ic_wmq_0.521/samples/test.icw -s !testConnectQM1
Please input the Queue Manager name:
>> VENUS
Return code = 0

注:
"-s" 参数指定服务名
"-f" 参数指定脚本文件

使用WMQ监控

在运行此WMQ监控之前,确保设置正确的环境环境变量 (请参考“安装”章节)。

执行以下的命令来运行WMQ监控:

UNIX示例:

java lr.icwri.app.RunScript -f /opt/ic_wmq_0.521/samples/testMon.icw -s !testMon1
Please input port of the web server used by monitor (default: 80)
>>
Please input the Queue Manager to monitor
>> VENUS
Icwri WebSphere MQ Monitor v0.521
IcWebAs version 0.1

Windows示例:

java lr.icwri.app.RunScript -f C:/ic_wmq_0.521/samples/testMon.icw -s !testMon1
Please input port of the web server used by monitor (default: 80)
>>
Please input the Queue Manager to monitor
>> VENUS
Icwri WebSphere MQ Monitor v0.521
IcWebAs version 0.1

在前3个页面,请选择需要监控的队列、通道、和监听器。软后系统转到监控的主页面:

以下命令使用了远程客户机方式 (注意在使用前配置好安全性):

java lr.icwri.app.RunScript -f /opt/ic_wmq_0.521/samples/testMon.icw -s !testMon2

以下命令使用了REST接口:

java lr.icwri.app.RunScript -f /opt/ic_wmq_0.521/samples/testMonA.icw -s !testMon1

感谢您使用Icwri脚本和系列工具

欢迎联系liurui@lrsolution.com报告错误和提出您的建议。

-- 刘睿