addSIBusMember 命令
借助 wsadmin 工具,使用 addSIBusMember 命令将成员添加至服务集成总线。总线成员可以是应用程序服务器、WebSphere® MQ 服务器或服务器集群。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin
脚本编制客户机通过 Qshell 运行.
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
- 要获取 Jython 中可用服务集成总线命令的列表以及每个命令的简要描述,请在
wsadmin 提示符处输入以下命令:
print AdminTask.help('SIBAdminCommands')
- 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
AdminConfig.save()
用途
addSIBusMember 命令将新成员添加至服务集成总线。将应用程序服务器添加为总线成员时,将自动创建带有缺省设置的消息传递引擎。
集群添加为总线成员时,如果未启用消息传递引擎策略辅助,那么会自动创建带有缺省设置的消息传递引擎。要为总线成员创建其他消息传递引擎,请使用 createSIBEngine 命令。
将集群添加至总线时,如果已启用消息传递引擎策略辅助并已指定高可用性消息传递引擎策略类型,那么会自动创建带有支持高可用性策略的设置的消息传递引擎。
将集群添加至总线时,如果已启用消息传递引擎策略辅助并已指定可伸缩性或带有高可用性的可伸缩性消息传递引擎策略类型,那么会自动创建支持所选策略的设置的一个消息传递引擎。必须使用 createSIBEngine 命令来创建其他消息传递引擎(为集群中的每个应用程序服务器创建一个)。对于每个新消息传递引擎,会自动创建支持所选策略的设置。
如果在启用了消息传递引擎策略辅助并指定了定制消息传递引擎策略类型的情况下使用 addSIBusMember 命令,那么可设置第一个消息传递引擎的行为,然后使用 createSIBEngine 命令来创建其他消息传递引擎。
将 WebSphere MQ 服务器添加为总线成员时,系统会创建服务器代理,它可覆盖在 WebSphere MQ 服务器中定义的父代连接属性(主机、端口、通道和 SSL 安全性配置别名)。这意味着可以对每个总线成员资格指定一组不同的连接属性。
目标对象
无。
已创建总线成员对象。如果总线成员是服务器或服务器集群,那么还会创建消息传递引擎。
必需参数
- -bus bus_name
- 用于标识服务集成总线的名称。可以使用 listSIBuses 命令来列示现有总线的名称。
条件参数
- -node node_name
- -server server_name
- 要将应用程序服务器添加为总线成员,请指定运行该服务器的节点的名称和该服务器的名称。
如果指定这些参数,那么不要指定 -cluster 或 -wmqServer 参数。
- -cluster cluster_name
- 要将服务器集群添加为总线成员,请指定集群的名称。
如果指定此参数,那么不要指定 -node、-server 或 -wmqServer 参数。
- -wmqServer
- 要将
WebSphere MQ
服务器添加为总线成员,请指定
WebSphere MQ
服务器的名称。这是创建 WebSphere MQ
服务器时在 -name 参数中指定的名称。
如果指定此参数,那么不要指定 -cluster、-node 或 -server 参数。
可选参数
- -description text
- 总线成员的可选描述,供进行管理时使用。
- -virtualQueueManagerName
- WebSphere MQ
服务器虚拟队列管理器的名称的覆盖值。将消息发送至
IBM MQ 时,IBM MQ
网关队列管理器会将总线视为远程队列管理器。虚拟队列管理器名称将作为此远程队列管理器的名称传递至
IBM MQ。缺省值是总线的名称。如果此值对于
IBM MQ
队列管理器并非有效名称,或者另一现有
IBM MQ
队列管理器具有相同名称,那么应将缺省值替换为另一个值,该值是对 IBM MQ
队列管理器有效的唯一名称。该名称必须符合以下条件才有效:
- 它必须包含 1 到 48 个字符。
- 它必须遵循 IBM MQ 队列命名规则(请参阅 IBM MQ 信息中心中的“IBM MQ 对象的命名规则”主题)。
- -host
- WebSphere MQ 服务器总线成员主机属性的覆盖值。此值是与其建立连接以与队列管理器或队列共享组通信的主机的主机名或 IP 地址。如果指定了 -wmqServer 参数,请使用此参数。
- -port
- WebSphere MQ 服务器总线成员端口属性的覆盖值。端口号受队列管理器或队列共享组侦听器(侦听器将侦听连接)监视。缺省值为 1414。如果指定了 -wmqServer 参数,请使用此参数。
- -channel
- WebSphere MQ 服务器总线成员通道属性的覆盖值。这是用于与 IBM MQ 队列管理器或 IBM MQ for z/OS® 队列共享组建立连接的服务器连接通道的名称。缺省值为 SYSTEM.DEF.SVRCONN。如果指定了 -wmqServer 参数,请使用此参数。
- -securityAuthAlias
- WebSphere MQ 服务器总线成员 securityAuthAlias 属性的覆盖值。这是连接至 WebSphere MQ 服务器时提供的认证别名。此参数没有缺省值。 如果指定了 -wmqServer 参数,请使用此参数。
- -transportChain
- WebSphere MQ 服务器总线成员 transportChain 属性的覆盖值。这是与 IBM MQ 通信时传输链使用的名称。缺省值为 OutboundBasicWMQClient。如果指定了 -wmqServer 参数,请使用此参数。
- -trustUserIds TRUE | FALSE
- WebSphere MQ
服务器总线成员 trustUserIds 属性的覆盖值。它将确定在来自
IBM MQ
的消息中接收到的用户标识是否传播至消息。应用程序用户标识始终是通过
jsAppUserIdRFH2 值设置的。如果此值不存在(因为 RFH2 头的
<sib> 文件夹中不存在该键/值对或该消息没有 RFH2 头),那么表示未设置此字段。此参数有两个可能的值:
- TRUE
- 用户标识将传播至消息。
- FALSE
- 用户标识将不会传播至消息。
缺省值为 TRUE。如果指定了 -wmqServer 参数,请使用此参数。
- -enableAssistance TRUE | FALSE
- 指定是否启用消息传递引擎策略辅助的参数。此参数有两个可能的值:
- TRUE
- 启用消息传递引擎策略辅助。必须提供 -policyName 参数。
- FALSE
- 不启用消息传递引擎策略辅助。这是缺省值。如果指定了 -cluster 参数,请使用此参数。
- -policyName HA | SCALABILITY | SCALABILITY_HA | CUSTOM
- 要对集群应用的消息传递引擎策略的类型。此参数具有 4 个可能的值:
- HA
- 对集群应用高可用性消息传递引擎策略。
- SCALABILITY
- 对集群应用可伸缩性消息传递引擎策略。
- SCALABILITY_HA
- 对集群应用带有高可用性的可伸缩性消息传递引擎策略。
- CUSTOM
- 对集群应用定制消息传递引擎策略。
此参数没有缺省值。如果指定了 -cluster 参数并且 -enableAssistance 参数设置为 TRUE,请使用此参数。
- -failover TRUE | FALSE
- 一个参数,用于指定消息传递引擎的主机服务器失效时集群中的消息传递引擎能否故障转移至集群中的另一服务器。此参数有两个可能的值:
- TRUE
- 消息传递引擎可故障转移。
- FALSE
- 消息传递引擎不能故障转移。
缺省值为 FALSE。如果指定了 -cluster 参数并且 -enableAssistance 参数设置为 TRUE,-policyName 参数设置为 CUSTOM,请使用此参数。
- -failback TRUE | FALSE
- 一个参数,用于指定首选服务器列表中首选优先级更高的服务器再次变为可用时,集群中已故障转移的消息传递引擎能否故障恢复至该服务器。此参数有两个可能的值:
- TRUE
- 消息传递引擎可故障恢复。如果使用此选项,请提供 -preferredServerList 参数。
- FALSE
- 消息传递引擎不能故障恢复。
缺省值为 FALSE。如果指定了 -cluster 参数并且 -enableAssistance 参数设置为 TRUE,-policyName 参数设置为 CUSTOM,请使用此参数。
- -preferredServersOnly TRUE | FALSE
- 一个参数,用于指定集群中的消息传递引擎只能在首选服务器列表中的服务器上运行还是可在集群中的任何服务器上运行。此参数有两个可能的值:
- TRUE
- 消息传递引擎只能在首选服务器列表中的服务器上运行。如果使用此选项,请提供 -preferredServerList 参数。
- FALSE
- 消息传递引擎可在集群中的任何服务器上运行。
缺省值为 FALSE。如果指定了 -cluster 参数并且 -enableAssistance 参数设置为 TRUE,-policyName 参数设置为 CUSTOM,请使用此参数。
- -preferredServerList {{node_name server_name}}
- 集群中的消息传递引擎首选在其上运行的服务器列表(按首选优先级顺序)。对于列表中的每个服务器,指定运行该服务器的节点的名称以及该服务器的名称。此参数没有缺省值。如果指定了 -cluster 参数并且 -enableAssistance 参数设置为 TRUE,-policyName 参数设置为 CUSTOM,请使用此参数。
- -fileStore
- 创建要用作消息传递引擎的消息存储器的文件存储器。文件存储器是一种消息存储器,它通过操作系统直接使用文件系统中的文件。还可使用数据存储器。有关更多信息,请参阅相关链接。
- -logSize logsize
- 日志文件的大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -logDirectory logdirectoryname
- 不想使用缺省日志目录时所使用的日志文件目录的名称。如果指定了 -fileStore 参数,请使用此参数。
- -minPermanentStoreSize minpermanentstoresize
- 永久存储器文件的最小大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -minTemporaryStoreSize mintemporarystoresize
- 临时存储器文件的最小大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -maxPermanentStoreSize maxpermanentstoresize
- 永久存储器文件的最大大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -maxTemporaryStoreSize maxtemporarystoresize
- 临时存储器文件的最大大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -unlimitedPermanentStoreSize TRUE | FALSE
- 用于指定永久存储器大小是否不受限的参数。此参数有两个可能的值:
- TRUE
- 永久存储器大小不受限。
- FALSE
- 永久存储器大小受限。如果使用此选项,请提供 -maxPermanentStoreSize 参数。
如果指定了 -fileStore 参数,请使用此参数。
- -unlimitedTemporaryStoreSize TRUE | FALSE
- 用于指定临时存储器大小是否不受限的参数。此参数有两个可能的值:
- TRUE
- 临时存储器大小不受限。
- FALSE
- 临时存储器大小受限。如果使用此选项,请提供 -maxTemporaryStoreSize 参数。
如果指定了 -fileStore 参数,请使用此参数。
- -permanentStoreDirectory permanentstoredirectoryname
- 不想使用缺省永久存储器目录时所使用的永久存储器目录的名称。如果指定了 -fileStore 参数,请使用此参数。
- -temporaryStoreDirectory temporarystoredirectoryname
- 不想使用缺省临时存储器目录时所使用的临时存储器目录的名称。如果指定了 -fileStore 参数,请使用此参数。
- -dataStore
- 创建要用作消息传递引擎的消息存储器的数据存储器。
数据存储器由消息传递引擎将持久数据存储在数据库中时使用的一组表构成。请参阅数据存储器表以获取组成数据存储器的表的列表。数据存储器中的所有表都处于同一数据库模式。通过对每个数据存储器使用不同的模式名称,可在同一个数据库中创建多个数据存储器。
还可使用文件存储器(缺省值)。有关更多信息,请参阅相关链接。 - -createDefaultDatasource TRUE | FALSE
- 用于指定创建消息传递引擎时是否创建缺省数据源的参数。此参数有两个可能的值:
- TRUE
- 创建缺省数据源。
- FALSE
- 不创建缺省数据源。
如果指定了 -dataStore 参数,请使用此参数。如果指定了 -cluster 参数,请不要使用此参数。
- -datasourceJndiName jndiname
- 数据源的 JNDI 名称,消息传递引擎使用此数据源来访问数据存储器的关系数据库管理系统 (RDBMS)。如果指定了 -dataStore 参数,请使用此参数。
- -authAlias authalias
- 认证别名的名称,消息传递引擎使用此认证别名连接至其数据存储器中的数据库。如果指定了 -dataStore 参数,请使用此参数。
- -createTables datasource
- 自动为指定的数据源创建数据库表。如果未指定此选项,那么数据库管理员必须创建这些表。如果指定了 -dataStore 参数,请使用此参数。
- -restrictLongDBLock TRUE | FALSE
- 这是用于指定活动消息传递引擎是否必须长时间锁定数据库中的
SIBOWNER 表的参数。如果选择了此选项,那么消息传递引擎只会短时间锁定数据库。在活动消息传递引擎不响应数据库的情况下,备用消息传递引擎将能够获得数据库的所有权,这是因为活动消息传递引擎只会短时间锁定数据库。此参数有两个可能的值:
- TRUE
- 限制长时间锁定数据库。
- FALSE
- 不限制长时间锁定数据库。
如果指定了 -dataStore 参数,请使用此参数。
要点: 虽然已选择该属性,但是在使用 WebSphere Application Server V9.0 和更高版本的 sibDBUpgrade 命令升级数据库表之前,该属性将不会生效。 - -schemaName schemaname
- 不想使用缺省模式名时所使用的数据库模式的名称,该数据库模式包含数据存储器的表。有关缺省模式的详细信息,请参阅在数据库中创建用户和模式。如果指定了 -dataStore 参数,请使用此参数。
- -initialHeapSize size
- 服务器或集群中每个服务器的初始
Java™
虚拟机 (JVM) 堆大小,以兆字节计。没有缺省值。如果未指定此参数,那么不会做任何更改。如果指定了此参数,那么提供的值必须大于或等于零并且小于或等于 2048。如果提供了参数但未提供值,那么会生成错误消息。
注: 如果作为 addSIBusMember 命令的执行目标的服务器正在 z/OS 上运行,或者目标是集群,该集群中的任何服务器在 z/OS 上运行,那么会忽略此参数。
- -maxHeapSize size
- 服务器或集群中每个服务器的最大 JVM 堆大小,以兆字节计。没有缺省值。如果未指定此参数,那么不会做任何更改。如果指定了此参数,那么提供的值必须大于或等于零并且小于或等于 2048。如果提供了参数但未提供值,那么会生成错误消息。
注: 如果作为 addSIBusMember 命令的执行目标的服务器正在 z/OS 上运行,或者目标是集群,该集群中的任何服务器在 z/OS 上运行,那么会忽略此参数。
示例
将 node1 上的 server1 添加为带有缺省文件存储器的 bus1 成员。
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 ]')
将 server1 添加为 bus1 成员,并使用文件存储器保存消息。
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -fileStore ]')
将 server1 添加为 bus1 成员,使用文件存储器保存消息,并设置一些选项。
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -fileStore
-logSize 100 -logDirectory C:\\filestore1 ]')
将 server1 添加为 bus1 成员,并使用数据存储器保存消息。
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -dataStore ]')
将 server1 添加为 bus1 成员,使用数据存储器保存消息,并设置一些选项。
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -dataStore
-createDefaultDatasource true -datasourceJndiName myjndi]')
在不使用消息传递引擎策略辅助的情况下将 cluster1 添加至 bus1,并使用文件存储器作为消息传递引擎的消息存储器。
AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -fileStore true
-logDirectory C:\\filestore1 -permanentStoreDirectory C:\\filestore2
-temporaryStoreDirectory C:\\filestore3]')
将 cluster1 添加至 bus1,并使用消息传递引擎策略辅助和高可用性消息传递引擎策略。将文件存储器用作消息传递引擎的消息存储器。
AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -enableAssistance true
-policyName HA -fileStore -permanentStoreDirectory C:\\filestore1
-temporaryStoreDirectory C:\\filestore1 -logDirectory C:\\filestore1 ]')
将 cluster1 添加至 bus1 并使用消息传递引擎策略辅助和定制消息传递引擎策略。将文件存储器用作消息传递引擎的消息存储器。将消息传递引擎设置为故障转移而不是故障恢复,并且仅在 server1 和 server2 上运行。
AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -enableAssistance true
-policyName CUSTOM -fileStore -permanentStoreDirectory C:\\filestore1
-temporaryStoreDirectory C:\\filestore1 -logDirectory C:\\temp\filestore
-failover true -failback false -preferredServersOnly true
-preferredServerList [[node1 server1] [node2 server2]]]')
将初始 JVM 堆大小更改为 256,并将最大 JVM 堆大小更改为 512。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1
-initialHeapSize 256 -maxHeapSize 512]')