createSIBEngine 命令
通过 wsadmin 工具,使用 createSIBEngine 命令为服务器或集群总线成员创建消息传递引擎。将服务器或集群添加为服务集成总线成员时,系统会自动创建至少一个消息传递引擎。使用 createSIBEngine 命令为集群总线成员创建附加消息传递引擎。
每个服务器总线成员都刚好有一个消息传递引擎,但集群总线成员可支持附加引擎。如果为集群创建附加消息传递引擎,并且您将数据存储器用于消息存储器,那么必须显式配置数据存储器以及消息传递引擎用于与该数据存储器交互的 JDBC 数据源。必须在集群范围(而不是节点范围)中创建该数据源。有关创建消息传递引擎的更多信息,请参阅为集群中运行的消息传递引擎配置数据源。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin
脚本编制客户机通过 Qshell 运行.
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
- 要获取 Jython 中可用服务集成总线命令的列表以及每个命令的简要描述,请在
wsadmin 提示符处输入以下命令:
print AdminTask.help('SIBAdminCommands')
- 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
AdminConfig.save()
用途
createSIBEngine 命令为服务器或集群总线成员创建新消息传递引擎。使用此命令为集群总线成员创建附加消息传递引擎。
如果集群已启用消息传递引擎策略辅助,并且指定了可伸缩性或带有高可用性的可伸缩性策略,那么系统会自动创建消息传递引擎设置以符合指定的策略。
使用此命令后,如果集群已启用消息传递引擎策略辅助,并且指定了定制策略,那么可使用 createMissingSIBEnginePolicy 命令为消息传递引擎创建核心组策略。
目标对象
无。
必需参数
- -bus bus_name
- 配置了该总线成员的服务集成总线的名称。可以使用 listSIBuses 命令来列示现有总线的名称。
条件参数
- -node node_name
- -server server_name
- 要为作为总线成员的服务器创建消息传递引擎,请指定运行服务器的节点的名称以及服务器的名称。
- -cluster cluster_name
- 要为作为总线成员的服务器集群创建消息传递引擎,请指定该集群的名称。
可选参数
- -description text
- 消息传递引擎的可选描述,供进行管理时使用。
- -initialState STARTED | STOPPED
- 初始状态确定消息传递引擎是否在服务器或服务器集群启动时自动启动。
- 已启动
- 当相关联的应用程序服务器启动时,消息传递引擎将启动并且可用于处理消息。
- STOPPED
- 当相关联的应用程序服务器启动时,消息传递引擎将停止并且不可用于处理消息。
- -highMessageThreshold number
- 消息传递引擎在其消息点上可放置的最大总消息数。
在创建消息传递引擎时,将使用总线的消息阈值上限来设置此属性的缺省值。在此消息传递引擎上创建消息点时,将使用此属性的值为该消息点设置缺省消息阈值上限。
- -failover TRUE | FALSE
- 一个参数,用于指定消息传递引擎的主机服务器失效时集群中的消息传递引擎能否故障转移至集群中的另一服务器。此参数有两个可能的值:
- TRUE
- 消息传递引擎可故障转移。
- FALSE
- 消息传递引擎不能故障转移。
缺省值为 FALSE。如果集群已启用消息传递引擎策略辅助,并且指定了定制策略,请使用此参数。为此,请使用 addSIBusMember 或 modifySIBusMemberPolicy 命令。
- -failback TRUE | FALSE
- 一个参数,用于指定首选服务器列表中首选优先级更高的服务器再次变为可用时,集群中已故障转移的消息传递引擎能否故障恢复至该服务器。此参数有两个可能的值:
- TRUE
- 消息传递引擎可故障恢复。如果使用此选项,请提供 -preferredServerList 参数。
- FALSE
- 消息传递引擎不能故障恢复。
缺省值为 FALSE。如果集群已启用消息传递引擎策略辅助,并且设置了定制策略,请使用此参数。为此,请使用 addSIBusMember 或 modifySIBusMemberPolicy 命令。
- -preferredServersOnly TRUE | FALSE
- 一个参数,用于指定集群中的消息传递引擎只能在首选服务器列表中的服务器上运行还是可在集群中的任何服务器上运行。此参数有两个可能的值:
- TRUE
- 消息传递引擎只能在首选服务器列表中的服务器上运行。如果使用此选项,请提供 -preferredServerList 参数。
- FALSE
- 消息传递引擎可在集群中的任何服务器上运行。
缺省值为 FALSE。如果集群已启用消息传递引擎策略辅助,并且设置了定制策略,请使用此参数。为此,请使用 addSIBusMember 或 modifySIBusMemberPolicy 命令。
- -preferredServerList {{node_name server_name}}
- 集群中的消息传递引擎首选在其上运行的服务器列表(按首选优先级顺序)。对于列表中的每个服务器,指定运行该服务器的节点的名称以及该服务器的名称。此参数没有缺省值。如果集群已启用消息传递引擎策略辅助,并且设置了定制策略,请使用此参数。为此,请使用 addSIBusMember 或 modifySIBusMemberPolicy 命令。
- -fileStore
- 创建要用作消息传递引擎的消息存储器的文件存储器。文件存储器是一种消息存储器,它通过操作系统直接使用文件系统中的文件。还可使用数据存储器。有关更多信息,请参阅相关链接。
- -logSize size
- 日志文件的大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -logDirectory directory_name
- 不想使用缺省日志目录时所使用的日志文件目录的名称。如果指定了 -fileStore 参数,请使用此参数。
- -minPermanentStoreSize size
- 永久存储器文件的最小大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -minTemporaryStoreSize size
- 临时存储器文件的最小大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -maxPermanentStoreSize size
- 永久存储器文件的最大大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -maxTemporaryStoreSize size
- 临时存储器文件的最大大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -unlimitedPermanentStoreSize TRUE | FALSE
- 用于指定永久存储器大小是否不受限的参数。此参数有两个可能的值:
- TRUE
- 永久存储器大小不受限。
- FALSE
- 永久存储器大小受限。如果使用此选项,请提供 -maxPermanentStoreSize 参数。
如果指定了 -fileStore 参数,请使用此参数。
- -unlimitedTemporaryStoreSize TRUE | FALSE
- 用于指定临时存储器大小是否不受限的参数。此参数有两个可能的值:
- TRUE
- 临时存储器大小不受限。
- FALSE
- 临时存储器大小受限。如果使用此选项,请提供 -maxTemporaryStoreSize 参数。
如果指定了 -fileStore 参数,请使用此参数。
- -permanentStoreDirectory directory_name
- 不想使用缺省永久存储器目录时所使用的永久存储器目录的名称。如果指定了 -fileStore 参数,请使用此参数。
- -temporaryStoreDirectory directory_name
- 不想使用缺省临时存储器目录时所使用的临时存储器目录的名称。如果指定了 -fileStore 参数,请使用此参数。
- -dataStore
- 创建要用作消息传递引擎的消息存储器的数据存储器。
数据存储器由消息传递引擎将持久数据存储在数据库中时使用的一组表构成。请参阅数据存储器表以获取组成数据存储器的表的列表。数据存储器中的所有表都处于同一数据库模式。通过对每个数据存储器使用不同的模式名称,可在同一个数据库中创建多个数据存储器。
还可使用文件存储器(缺省值)。有关更多信息,请参阅相关链接。 - -createDefaultDatasource TRUE | FALSE
- 用于指定创建消息传递引擎时是否创建缺省数据源的参数。此参数有两个可能的值:
- TRUE
- 创建缺省数据源。
- FALSE
- 不创建缺省数据源。
如果指定了 -dataStore 参数,请使用此参数。如果指定了 -cluster 参数,请不要使用此参数。
- -datasourceJndiName jndi_name
- 数据源的 JNDI 名称,消息传递引擎使用此数据源来访问数据存储器的关系数据库管理系统 (RDBMS)。如果指定了 -dataStore 参数,请使用此参数。
- -authAlias auth_alias
- 认证别名的名称,消息传递引擎使用此认证别名连接至其数据存储器中的数据库。如果指定了 -dataStore 参数,请使用此参数。
- -createTables TRUE | FALSE
- 用于指定是否自动为数据源创建数据库表的参数。此参数有两个可能的值:
- TRUE
- 为数据源创建数据库表。
- FALSE
不为数据源创建数据库表。如果使用此选项,那么数据库管理员必须创建数据库表。
不为数据源创建数据库表。对于 z/OS 操作系统,必须使用此选项,原因是不能创建表。
如果指定了 -dataStore 参数,请使用此参数。
- -restrictLongDBLock TRUE | FALSE
- 这是用于指定活动消息传递引擎是否必须长时间锁定数据库中的
SIBOWNER 表的参数。如果选择了此选项,那么消息传递引擎只会短时间锁定数据库。在活动消息传递引擎不响应数据库的情况下,备用消息传递引擎将能够获得数据库的所有权,这是因为活动消息传递引擎只会短时间锁定数据库。此参数有两个可能的值:
- TRUE
- 限制长时间锁定数据库。
- FALSE
- 不限制长时间锁定数据库。
如果指定了 -dataStore 参数,请使用此参数。
要点: 虽然已选择该属性,但是在使用 WebSphere® Application Server V9.0 和更高版本的 sibDBUpgrade 命令升级数据库表之前,该属性将不会生效。 - -schemaName schema_name
- 不想使用缺省模式名时所使用的数据库模式的名称,该数据库模式包含数据存储器的表。有关缺省模式的详细信息,请参阅在数据库中创建用户和模式。如果指定了 -dataStore 参数,请使用此参数。
根据所选消息存储器及其属性的不同,您将指定不同的参数组合。为了避免在对消息传递引擎指定消息存储器时出现错误,请参阅在使用 wsadmin 工具创建带有文件存储器或数据存储器的消息传递引擎时避免出现错误。
示例
为 bus1 上使用缺省文件存储器的 cluster1 创建消息传递引擎。
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1]')
为 bus1 上使用带有缺省值的文件存储器的 cluster1 创建消息传递引擎。
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -fileStore]')
为 bus1 上使用带有选项的文件存储器的 cluster1 创建消息传递引擎。
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -fileStore
-logSize 3636363 -logDirectory C:\mylogdirectory]')
为 bus1 上使用带有缺省值的数据存储器的 cluster1 创建消息传递引擎。
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -dataStore]')
为 bus1 上使用带有选项的数据存储器的 cluster1 创建消息传递引擎。
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -dataStore
-createDefaultDatasource true -datasourceJndiName myjndi]')
将新的消息传递引擎添加至属于 bus1 且将文件存储器用作该消息传递引擎的消息存储器的 cluster1。
AdminTask.createSIBEngine('[-bus bus1 -cluster cluster1 -fileStore true
-logSize 100 -minPermanentStoreSize 200 -maxPermanentStoreSize 500
-unlimitedPermanentStoreSize false -permanentStoreDirectory C:\myfilestore
-minTemporaryStoreSize 200 -maxTemporaryStoreSize 500
-unlimitedTemporaryStoreSize false -temporaryStoreDirectory C:\myfilestore
-logDirectory C:\myfilestore ]')
将新消息传递引擎添加至属于 bus1 的 cluster1,其中 cluster1 已启用消息传递引擎策略辅助并且指定了定制消息传递引擎策略。将文件存储器用作消息传递引擎的消息存储器。将消息传递引擎设置为故障转移而不是故障恢复,并且仅在 server1 和 server2 上运行。
AdminTask.createSIBEngine('[-bus bus1 -cluster cluster1 -fileStore true
-logSize 100 -minPermanentStoreSize 200 -maxPermanentStoreSize 500
-unlimitedPermanentStoreSize false -permanentStoreDirectory C:\myfilestore
-minTemporaryStoreSize 200 -maxTemporaryStoreSize 500
-unlimitedTemporaryStoreSize false -temporaryStoreDirectory C:\myfilestore
-logDirectory C:\myfilestore -failover true -failback false
-preferredServersOnly true -preferredServerList [[node1 server1] [node2 server2]]]')