WebSphereMessageBroker命令合集.doc

WebSphere Message Broker命令Broker命令指的是由WebSphere Message Broker运行环境提供的各种管理命令，具体见表 B-2。由于运行这些命令需要设置一些环境变量， Message Broker提供了一个脚本 rnqsiprofile.crnd (Windows)或rnqsiprofile (Linux和UNIX)，在窗口中首先执行脚本设定环 境，然后可以任意执行Broker命令。 Windows平台上也可以执行开始程序IBM WebSphere Message Broker 6.0 命令控制台命令，其效果与执行bin目录下的rnqsiprofile.crnd相同。 表B-1 Broker命令一览表命令 说明 组件操作mqsicreatebroker 创建Broker mqsichangebroker 更改Broker参数 mqsideletebroker 删除Broker mqsicreateconfigmgr 创建Configuration Manager mqsichangeconfigrngr 更改Configuration Manager参数 mqsideleteconfigmgr 删除Configuration Manager mqsbackupconfigmgr 备份Configuration Manager mqsrestoreconfigmgr 恢复Configuration Manager mqslcreateusernameserver 创建User Name Server mqsichangeusernameserver 更改User Name Server参数 mqsideleteusernameserver 删除User Name Server mqslmlgratecomponents 迁移WebSphere Message Broker组件 命令 说明对象及属性操作 mqsideploy 部署对象 mqsilist 显示部署的对象 mqsicreateexecutiongroup 创建Execution Group mqsideleteexecutiongroup 删除Execution Group mqslreportproperties 显示对象属性 mqsichangeproperties 更改对象属性 启动和停止mqsistart 启动WebSphere Message Broker组件 mqsistop 停止WebSphere Message Broker组件 mqsireload 重启Broker或Execution Group mqsistartmsgflow 启动消息流 mqsistopmsgflow 停止消息流 数据库命令 mqsicreatedb 创建数据库 mqsideletedb 删除数据库 mqsichangedbimgr 更改DatabaseInstanceManager的用户名和口令 mqsi_setupdatabase 设置数据库类型及安装目录 mqsisetdbparms 设置消息流使用的数据源的用户名和口令 安全控制 mqsicreateaclentry 创建ACL条目 mqsideleteaclentry 删除ACL条目 mqsiIistaclentry 列出ACL条目 mqslsetsecurity 设置用户名和用户组 mqsichrreport 检查基于内容路由(CBR)的主题 Trace操作 mqsireporttrace 显示Trace设置 mqsichangetrace 更改Trace设置 mqsireadlog 将Trace内容导出到文件 mqsiformatlog 将Trace内容格式化 统计操作 mqsireportflowstats显示消息流统计设置 mqsichangeflowstats 更改消息流统计设置 MQ Broker mqsijoinmqpubsub 将Broker加入MQ Broker网络 mqsiclearmqpubsub 将Broker移出MQ Broker网络 mqsilistmqpubsub 列出Broker相邻的MQ Broker 用户出口 mqsichangetlowuserexits 更改消息流的用户出口列表 mqsireporttlowuserexits 显示消息流的用户出口列表 其他 mqsiservlce 显示产品安装及配置信息 mqsicmrv 显示Configuration Manager存储内容 mqsicmdt 显示Configuration Manager配置表中的内容 mqsibrowse 显示Broker配置表中的内容 B.2.1 mqsicreatebrokerl 语法格式 mqsicreatebroker brokerName -i serviceUserId运行Broker的用户-a servicePassword 运行Broker的密码-q queueManager Broker将使用的WebSphere MQ队列管理器。如果不存在， 则创建它-n dataSourceNameBroker的数据源名称-u dataSourceUserIdBroker用于访问其数据库的用户标识-p dataSourcePasswordBroker数据库用户标识的密码-s unsQMgrName用户名称服务器的WebSphere MQ队列管理器-j为Broker启用发布/预订访问控制，必须与-s合用-g configurationTimeout允许Broker处理己部署的消息的最大时间(单位:秒)，取值 范围是10-3600，缺省为300-k configurationDelayTimeout 允许Broker处理己部署的最小消息的最大时间(单位:秒)， 取值范围是10-3600，缺省为60-w workPath放置跟踪日志的目录-1 userLilPathBroker搜索用户所提供库的目录，可以有多个，用;(Windows) 或:(UNIX)分隔-t以MQ信任应用(Trusted Application)方式启动Broker-m表明需要从WebSphere MQ Publish/Subscribe Broker迁移到 WebSphere Message Broker-v statisticsMajorInterval 用于收集统计信息归档记录的时间间隔的持续时间单位: 分钟) ，取值范围是10-14400，缺省为60-P httpListenerPort代理HTTP侦昕器将使用的端口，缺省为7080-c icuConve，rterPath搜索ICU代码页转换器或转换器包的路径的分隔列表，可以有多个，用;(Windows)或:(UNIX)分隔-y IdapPnncipalLDAP主体(用户标识) ， -y与-z必须合用 -z ldapCredentiaIsLDAP凭证(密码) ， -y与-z必须合用-x userExitPath用户出口目录，可以有多个，用;何Tindows)或.何NIX)分隔。 该目录会被执行组进程添加到系统库搜索路径中(PATH、LIBPATH、LD LIBRARY PATH、SHLIBPATH)l 功能说明 该命令创建代理(Broker)，同时会在-n指定的数据库中创建相应的表并插入数据记录，在-q指定的队列管理器中创建相应的队列。-i和-a选项指定运行Broker的 用户及密码，这里指的是操作系统用户。-u和-p选项指定Broker访问其数据库的用 户及密码，这里指的是数据库用户。 为了安全起见，密码可以不以明码方式暴露在命令参数中。如果命令中指定了-i 但未指定-a，或者指定了-u但未指定-p，则命令在执行过程中会以隐密的形式让用户输入相关密码。注意: （1）该命令的执行用户在Windows上必须是Administrators组用户，在UNIX上必须是 mqbrkrs组用户。 （2）数据库必须先于代理创建，而队列管理器则不一定。如果创建代理的时候队列管理器 尚不存在，会由该命令一并创建，同时指定队列管理器的死信队列为SYSTEM.DEAD.LETTER.Q。 ( 3 )一i选项指定的用户必须是mqbrkrs纽用户。如果指定-t选项，则Broker作为Web Sphere MQ信任应用(Trusted Application)运行，那么对于Windows， -i指定的用户也必须是mqm 纽用户，对于HP-UX和Solaris， -i指定的用户必须就是mqm，对于AIX， -i无效。 （4）如果命令中不指定-u和-p选项，则缺省会使用-i和-a的值。对于SQLServer，必须 先在数据库中手工创建相应的用户名和口令，对于Windows平台的DB2，该命令会自动创建。 （5） -g指的是执行纽接受部署并更新的起时阅值，如果部署时执行纽中的消息流尚未结 束，则会等待结束后再史新。-k指的是代理接受部署的超时值，如果网络阻塞或队列管理器过载，则可能起时。一般来说，去的值应该远小于-g的值，两者之和表示代理接受部署并更新的超时阀值。 （6） Broker中的消息流可能会用到LDAP，比如JMSInput节点和JMSOutput节点设定 JNDI绑定时可以指定LDAP的位置。这时使用的LDAP用户名和口令是由创建Broker时的-y 和-z选项指定的。l 使用举例 例: mqsicreatebroker WBRK -i userid -a passwd -q WBRKQM -n WBRKDBB.2.2 mqsichangebrokerl 语法格式Mqsichangebroker brokerName-I serviceUserId运行Broker的用户 -a servicePassword运行Broker的密码-p dataSourcePasswordBroker数据库用户标识的密码-s unsQMgrName用户名称服务器的WebSphereMQ队列管理器，如果unsQMgrName为空，则表示除去主题安全控制-j | -d-j:为Broker启用发布/预订访问控制-d:为Broker禁用发布/预订访问控制-t | -n-t:以MQ信任应用方式启动Broker-n:不以MQ信任应用方式启动Broker-g configurationTimeout允许Broker处理己部署的消息的最大时间(单位:秒) ，取值范 围是10-3600，缺省为300-k configurationDelayTimeout允许Broker处理己部署的最小消息的最大时间(单位:秒) 取值范围是10-3600，缺省为60-I userLilPathBroker搜索用户所提供库的目录，可以有多个，用;(Windows) 或:(UNIX)分隔-v statisticsMajorInterval用于收集统计信息归档记录的时间间隔的持续时间(单位:分钟) 取值范围是10-14400，缺省为60-P httpListenerPort代理HTTP侦昕器将使用的端口，缺省为7080-c icuConverterPath搜索ICU代码页转换器或转换器包的路径的分隔列表，可以有多个，用;(Windows)或:(UNIX)分隔-y ldapPrincipalLDAP主体(用户标识) ， -y与-z必须合用-z ldapCredentialsLDAP凭证(密码) ， -y与-z必须合用-x userExitPath用户出口目录，可以有多个，用;(Windows)或:(UNIX)分隔。 该目录会被执行组进程添加到系统库搜索路径中(PATH、LIBPATH、LD LIBRARY PATH、SHLIBPATH)-e activeUserExits活动的用户出口名，可以有多个并用冒号分隔。缺省情况下，用户出口是非活动的，该选项将指定的用户出口改成缺省活动的l 功能说明该命令用于更改Broker的参数，创建Broker时的参数大部分可以更改，另一小部分则无法更改，除非重建Broker。在执行该命令之前必须先用mqsistop停止Broker 的运行，命令完成后再用mqsistart启动Broker，使更改后的参数生效。相关参数的注意事项参见mqsicreatebroker中的说明。l 使用举例例1 :指定用户名服务器所在的队列管理器，启用主题安全控制mqsichangebroker WBRK -s UNS_ QM例2:不使用用户名服务器，禁用主题安全控制 mqsichangebroker WBRK -sB.2.3 mqsideletebrokerl 语法格式mqsideletebroker brokerName -q同时删除Broker所在的队列管理器 -w同时删除Broker工作目录中的相关文件 l 功能说明 该命令用于删除一个Broker 0 -q选项可以指定一并删除Broker的相关队列管理器，否则只删除队列管理器上的相关队列。如果队列管理器上还有组件，比如配置管理器(Configuration Manager)或用户名服务器(User Name Server)，则队列管理 器此时不能被一并删除，-q选项会导致出错。l 使用举例 mqsideletebroker WBRK -q B.2.4 mqsicreateconfigmgr l 语法格式mqsicreateconfigmgr configMgrName-i serviceUserId运行ConfigMgr的用户-a servicePassword运行ConfigMgr的密码-q queueManagerConfigMgr将使用的WebSphere MQ队列管理器。如果不存在，则创建它-n dataSourceName迁移ConfigMgr的数据源名称-u dataSourceUserId迁移ConfigMgr的数据库用户名-p dateSourcePassword迁移ConfigMgr的数据库密码-s unsQMgrName用户名称服务器的WebSphere MQ队列管理器-w workPath放置跟踪日志的目录l 功能说明该命令用于创建配置管理器( ConfigMgr ) ，同时会在-n指定的数据库中创建相 应的表并插入数据记录，在-q指定的队列管理器中创建相应的队列。在Windows中， 可以不指定configMgrName，这时缺省为ConfigMgr。在其他平台上则必须指定。注意:( 1 )该命令的执行用户在Windows上必须是Administrators组用户，在UNIX上必须是 nqbrkrs组用户。( 2 )数据库必须先于代理创建，而队列管理器则不一定。如果创建代理的时候队列管理器 与不存在，会由该命令一并创建，同时指定队列管理器的死信队列为SYSTEM.DEAD.LETTER.Q。( 3 )斗选项指定的用户必须是mqbrkrs组用户，同时也必须是mqm组用户或 ldministrators组用户。( 4 )在WebSphere Business Integrator Message Broker v5中，配置管理器的信息是记录在DB2数据库中的，在WebSphere Message Broker v6中，它们是记录在内置的Derby数据库中， 通常在C:Documents and SettingsAll UsersApplication DataIBMMQSIcomponentsConfigMgr 录中。如果创建的配置管理器信息需要从v5迁移到v6，则可以通过-n， -u、-p选项来访问原数据库。l 使用举例mqsicreateconfigmgr eM -i user -a passwd -q WBRK一CM_QMB.2.5 mqsichangeconfigmgr l 语法格式mqsichangeconfigmgr configMgrName-i serviceUserID 运行ConfigMgr的用户-a servicePassword 运行ConfigMgr的密码-p dataSourcePassword 迁移ConfigMgr的数据库密码-s unsQMgrName 用户名称服务器的WebSphere MQ队列管理器-j maxJVMHeapSize 最大Java虚拟机堆大小(单位: MB，缺省值为256，最小值为64)l 功能说明 该命令用于更改配置管理器的参数，在执行该命令之前必须先停止配置管理器的运行，命令完成后再启动，使更新生效。在Windows中，可以不指定configMgrName， 这时缺省为ConfigMgr。在其他平台上则必须指定。 相关参数的注意事项参见mqsicreateconfigmgr中的说明。 l 使用举例 例1 :指定用户名服务器所在的队列管理器，启用主题安全控制 mqsichangeconfigmgr CM -s UNS_QM 例2:不使用用户名服务器，禁用主题安全控制 mqsichangeconfigmgr CM -s B.2.6 mqsideleteconfigmgr l 语法格式 mqsideleteconfigmgr configMgrName -q同时删除ConfigMgr所在的队列管理器 -w同时删除ConfigMgr工作目录中的相关文件 -n同时删除ConfigMgr的数据库 l 功能说明 该命令用于删除一个配置管理器。-q选工页可以指定一并删除配置管理器的相关 队列管理器，否则只删除队列管理器上的相关队列。如果队列管理器上还有其他组 件，比如代理(Broker)或用户名服务器(User Name Server)，则队列管理器此时不 能被一并删除， -q选工页会导致出错。-n选项可以同时删除配置管理器的数据库，但 是使用时要相当谨慎，因为配置记录中含整个代理域的全部内容，如果删除时仍然 存在其他代理，则会造成这些代理不可用。配置记录也可以事后手工删除，在Windows中配置记录在C:Documents and SettingsAll UsersApplication DataIBMMQSI目录 下，在UNIX平台中配置记录在/var/mqsi目录中。 在Windows中，可以不指定configMgrName，这时缺省为ConfigMgr。在其他 平台上则必须指定。 l 使用举例 mqsideleteconfigmgr CM -q B.2.7 mqsibackupconfigmgr l 语法格式 mqsibackupconfigmgr configMgrName -d archiveDirectory备份文件所在的目录，必须事先创建 -a archiveFileName备份文件名 -w workPath配置管理器存储库的工作路径 l 功能说明该命令用于备份配置管理器的数据库。用configMgrName指定配置管理器名， d和-a选项指定备份文件存放的位置。如果未指定-a，备份文件名格式缺省为 .一一 .zip，比如: ConfigMgr _060223一111933.zipo workPath 为配置管理器存储库的工作路径， Windows中缺省为C:Documents and SettingsAll UsersApplication DataIBMMQSI目录，在UNIX中缺省为/var/mqsi目录。注意:该命令必须在配置管理器停止时才可以使用。l 使用举例mqsibackupconfigmgr CM -d D:backupB.2.8 mqsrestoreconfigmgr l 语法格式 mqsirestoreconfigmgr configMgrName -d archiveDirectory备份文件所在的目录 -a archiveFileName备份文件名 l 功能说明 该命令用于恢复配置管理器的数据库。用configMgrN ame指定配置管理器名， -d和-a选项指定备份文件存放的位置。 注意:该命令必须在自己置管理器停止时才可以使用。 l 使用举例 mqsirestoreconfigmgr CM -d D:backup -a ConfigMgr_060223_111933.zip B.2.9 mqsicreateusernameserverl 语法格式 mqsicreateusemameserver-i serviceUserId运行UserNameServer的用户-a servicePassword运行UserNameServer的密码-q queueManagerUserNameServer将使用的WebSphere MQ队列管理器。如果不存在，则创建它-d securi可DomainNameUserNameServer将使用的安全域-r refreshIntervalUserNameServer内部高速缓存每次刷新之间的时间间隔，单位:秒，缺省值为60-w workPath放置跟踪日志的目录-g authProtocolDataSource接入认证所需的数据文件的名称，缺省应该在home目录下-j认证数据文件中含组信息，缺省表示只含用户和密码信息l 功能说明该命令用于创建用户名服务器(UserNameServer) ，同时会在-q指定的队列管理器中创建相应的队列。注意:(1)该命令的执行用户在Windows上必须是Administrators组用户，在UNIX上必须是 mqbrkrs组用户。(2)如果创建代理的时候队列管理器尚不存在，会由该命令一并创建并启动，同时指定队列管理器的死信队列为SYSTEM.DEAD.LETTER.Q。 (3) -i选项指定的用户必须是mqbrkrs组用户，同时也必须是mqm组用户或Administrators组用户。 (4)虽然-g是可选工页，但如果找不到authProtocolDataSource指定的文件，则认证服务无法正常工作。 (5)由于在Toolkit设计中缺省才表示使用操作系统用户，打开Topics会列出所有的操作 系统用户，但用户名服务器实际加载的是只含用户和密码信息的文件。为了保证设计和运行环 境一致，这时的认证数据文件应该手工添加所需的操作系统用户及密码，并妥善保存。 l 使用举例 例1 :创建用户名服务器 mqsicreateusernameserver -i user -a passwd -q WBRK _ UNS _ QM 例2:创建用户名服务器，使用pwgroup.dat文件中定义的用户和组实现接入安全控制 mqsicreateusernameserver -i user -a passwd -q WBRK _ UNS _ QM -g c:/temp/pwgroup.dat -j 例3:创建用户名服务器，使用password.dat文件中定义的用户实现接入安全控制 mqsicreateusernameserver -i user -a passwd -q WBRK_ UNS _ QM -g c:/temp/password.dat B.2.10 mqsichangeusernameserverl 语法格式-i serviceUserId运行UserNameServer的用户-a servicePassword运行UserNameServer的密码-d securityDomainName用户名称服务器将使用的安全域-r refreshInterval用户名称服务器内部高速缓存每次刷新之间的时间间隔， 单位:秒，缺省值为60-g authProtocolDataSource认证协议所需的数据源的名称-j | -o-j 含组和组成员信息-o 只含组成员信息l 功能说明 该命令用于更改用户名服务器(UserNameServer )的参数，在执行该命令之前必 须停止用户名服务器的运行，命令完成后再启动，使更新生效。 相关参数的注意事项参见mqsicreateusemameserver中的说明。 l 使用举例 mqsicreateusernameserver -i user -a passwd -r 2000 B.2.11 mqsideleteusernameserverl 语法格式mqsideleteusernameserver-q同时删除UserNameServer所在的队列管理器-w同时删除UserNameServer工作目录中的相关文件l 功能说明该用于命令用于删除用户名服务器。-q选项可以指定一并删除配置管理器的相关队列管理器，否则只删1除队列管理器上的相关队列。如果队列管理器上还有其他组件，比如代理(Broker)或配置管理器( Configuration Manager) ，则队列管理器此时不能被一并删除，-q选项会导致出错。l 使用举例mqsideleteusemameserver -qB.2.12 mqsimigratecomponentsl 语法格式1. Checkmqsimigratecomponents-c检查，确认是否可以迁移-s source Version源版本-t targetVersion目标版本componentName组件名，可以有多个-q安静模式(Quiet) ，不需要返回执行中的所有信息2. Migratemqslmigratecomponents -1 | -2 | -3迁移，可以组合但-1、-2、-3必须按次序进行 -1: 相关文件的迁移-2: MQ队列的迁移-3:数据库表的迁移-t targetVersion目标版本componentName组件名，可以有多个-q安静模式(Quiet) ，不需要返回执行中的所有信息3. Undomqslmigratecomponents -u回滚，取消原先的迁移操作-1 | -2 | -3迁移，可以组合但-1、-2、-3必须按次序进行 -1: 相关文件的迁移-2: MQ队列的迁移-3:数据库表的迁移-t targetVersion目标版本componentName组件名，可以有多个-q安静模式(Quiet) ，不需要返回执行中的所有信息4. Verfiymqsimlgratecomponents-v验证，检验迁移的结果是否成功-t targetVersion目标版本componentName组件名，可以有多个-q安静模式(Quiet) ，不需要返回执行中的所有信息l 功能说明该命令用于将原先v2.1或v5版本的组件迁移到v6环境中，含四种形式:检查、 迁移、回滚、验证。 运行该命令的用户必须是mqbrkrs组用户。 l 使用举例 命令: mqsimigratecomponents -c BROKER1 mqsimigratecomponents BROKER1 mqsimigratecomponents -v BROKER1 B.2 .13 mqsideploy l 语法格式mqsideploy-n connectionFileName允许命令与远程ConfigMgr通信的.configmgr文件-i ipAddress -p port -q qMgrName配置管理器的地址、端口、队列管理器名，不能与-n合用 -b broker -e executionGroup -a barFileName -m | -d deployObjects | -c-b指定代理名-e指定执行组名-a指定BAR文件名-d指定部署对象名，多个对象之间用冒号分隔，比如top.cmf: bar .dictionary-1 -m I-t -m I-c -1表示Topology，部署拓扑结构-t表示Topics，部署主题-w waitTime 执行该命令的等待响应时间(单位:秒，取值范围: 1-999，999)-v logFileName执行过程的记录文件l 功能说明该命令用于将内容部署到Broker运行环境中，部署过程是通过配置管理器执行 的，可以用-n选项指定* .configmgr文件，在该文件中有配置管理器的地址、端口、 队列管理器信息。也可以用-i、-p、-q选项显式地指定相关信息。部署的对象可以是 针对代理或执行组的，也可以是针对整个代理域的。其中，消息流和消息集是针对 前者的，拓扑结构和主题是针对后者的。因此，-b和-l、-t不能使用。部署的内容可以先由mqsicreatebar创建*.bar文件，由-a选项部署，也可以由-d选项跳过打包过程直接部署。-m表示完全部署，缺省为增量部署。-c表示取消原先的部署，即配置管理器不必再等待部署结果。l 使用举例mqsideploy -n cm1.configmgr -b B1 -e default -d top.cmf:bar.dictionary mqsideploy -i localhost -p 1414 -q WBRKQM -b WBRK-tmqsideploy -i localhost -p 1414 -q WBRKQM -b WBRK -1B.2.14 mqsilistl 语法格式mqsilist-a缺省，列出系统中的所有组件brokerName -e executionGroupName列出代理中的执行组，或执行组中的消息流l 功能说明该命令用于列出系统中所有的组件，也可以列出brokerName代理中所有的执行组，或是executionGroupName中所部署的所有消息流。-a 选项可以缺省，有没有效果相同。运行该命令的用户必须是mqbrkrs组用户。l 使用举例mqsilistmqsilist WBRKmqsilist WBRK e EGB.2.15 mqsicreateexecutiongroupl 语法格式mqsicreateexecutiongroup-b brokerName代理名-e executionGroup执行组名-n connectionFileName允许命令与远程ConfigMgr通信的.configmgr文件-i ipAddress -p port -q qMgrName配置管理器的地址、端口、队列管理器名，不能与-n合用-w waitTime执行该命令的等待响应时间(单位:秒，缺省: 60)-v logFileName执行过程的记录文件l 功能说明该命令用于创建指定代理中的执行组。该命令会通过配置管理器执行，可以用-n 选项指定* .configmgr文件，在该文件中有配置管理器的地址、端口、队列管理器信息。也可以用-i、-p、-q选项显式地指定相关信息。执行该命令的用户必须是mqm组用户，同时必须能通过配置管理器中的ACL检查。l 使用举例mqsicreateexecutiongroup -i -p 1414 -q QMGR -b BROKER -e EG1mqslCreateexecutiongroup -n domain1.configmgr -b BROKER -e EG2B.2.16 mqsideleteexecutiongroupl 语法格式mqside1eteexecutiongroup-b brokerName代理名-e executionGroup执行组名-n connectionFileName允许命令与远程ConfigMgr通信的.configmgr文件-i ipAddress -p port -q qMgrName配置管理器的地址、端口、队列管理器名，不能与-n合用-w waitTime行该命令的等待响应时间(单位:秒，缺省: 60)-v logFileName执行过程的记录文件l 功能说明该命令用于删除指定然程中的执行组。该命令会通过配置管理器执行，可以用-n选项指定* .configmgr文件，在该文件中有配置管理器的地址、端口、队列管理器信 息。也可以用-i、-p、-q选项显式地指定相关信息。 执行该命令的用户必须是mqm组用户，同时必须能通过配置管理器中的ACL 检查。l 使用举例 mqsideleteexecutiongroup -i fred.ab