createSIBus 命令
使用 createSIBus 命令创建新服务集成总线。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin
脚本编制客户机通过 Qshell 运行.
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
- 要获取 Jython 中可用服务集成总线命令的列表以及每个命令的简要描述,请在
wsadmin 提示符处输入以下命令:
print AdminTask.help('SIBAdminCommands')
- 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
AdminConfig.save()
用途
此命令创建新服务集成总线。
目标对象
无
必需参数
- -bus busname
- 用于标识服务集成总线的名称。请选择唯一的名称。
条件参数
无。
可选参数
- -description text
- 总线的可选描述,供进行管理时使用。
- -secure TRUE | FALSE
- 不推荐对此版本使用此参数。
- interEngineAuthAlias name
- 用于授权总线上各个消息传递引擎相互进行通信的认证别名的名称。
如果总线包含 WebSphere® Application Server V6.x 总线成员,那么必须指定引擎间认证别名。启用总线安全性后,总线使用引擎间认证别名来认证来自其他消息传递引擎的入局连接。未经授权的消息传递引擎不能连接至总线。
- -mediationsAuthAlias name
- -securityGroupCacheTimeout timeout_value
- timeout_value
可为 0 到 99999 之间的值。缺省值为 120。
增加超时可降低用户注册中心上的负载并可改进性能,但会导致系统降低对用户组成员资格的更改的响应性。为了将组高速缓存调整至最优设置,需要在响应性需求与注册表负载之间达到平衡。例如,如果系统必须快速响应用户组成员资格的更改,请指定 15 分钟的超时。如果系统需要降低响应频率(例如,响应隔夜更改),请指定 1440 分钟的超时(24 小时)。如果设置为 0,那么高速缓存中的条目不会超时,所以会保留至服务器下一次重新启动。
对此值的更改将立即生效,并且仅影响对其更改了配置的总线的组高速缓存。
- -protocol protocol
传输链必须与服务器的消息传递引擎入站传输设置中定义的其中一个传输链相对应。所有服务器都自动具有为它们定义的特定数目的传输链,并且也可以创建新的传输链。
缺省传输链为 InboundBasicMessaging。
- -discardOnDelete TRUE | FALSE
- 如果可废弃已删除消息点上的消息,请将此选项设置为 TRUE。如果已删除消息点上的消息应保留在系统异常目标上,请将此选项设置为 FALSE。
- highMessageThreshold number
- 总线上的任何消息传递引擎在其消息点上可放置的最大总消息数。
此值用于在创建消息传递引擎时为其设置缺省消息阈值上限。
- configurationReloadEnabled TRUE | FALSE
- 将此选项设置为 TRUE 以动态重新装入此总线的配置文件。
此选项为 TRUE 时,系统会应用对总线配置的某些更改而不需要重新启动消息传递引擎。系统会在对总线添加或移除目标或调解时应用这些更改。此选项还控制着是否对该总线上的所有消息传递引擎进行自动更新。
- -busSecurity TRUE | FALSE
- 将此选项设置为 TRUE 以对总线实施授权策略,这还要求启用管理安全性。如果要一直禁用总线安全性,请将此选项设置为 FALSE。如果禁用管理安全性,那么总线是不安全的。
- -bootstrapPolicy SIBSERVICE_ENABLED | MEMBERS_AND_NOMINATED | MEMBERS_ONLY
- 设置三个选项中的一个以对总线实施总线成员策略。
- SIBSERVICE_ENABLED
- 启用了 SIB 服务的单元中的任一服务器都可以处理引导程序请求。
- MEMBERS_AND_NOMINATED
- 只有总线成员或指定的引导服务器才能处理引导请求。
- MEMBERS_ONLY
- 只有总线成员才能处理引导请求。
- -useServerIdForMediations TRUE | FALSE
- 如果要使用总线的单个服务器标识来运行调解,请将此选项设置为 TRUE。此选项允许您在多个安全域之间运行调解而不需要对每个域指定调解认证别名。可使用服务器标识对全局域运行调解。如果要使用调解认证别名来运行调解,请将此选项设置为 FALSE。
- -auditAllowed TRUE | FALSE
- 将此选项设置为 TRUE 以对总线启用安全性审计。将此选项设置为 FALSE 以对总线禁用安全性审计。缺省值为 TRUE。必须具有审计管理员特权才能使用此参数。
示例
AdminTask.createSIBus('[-bus bus1 -description [A new bus] -busSecurity false ]')
'bus1(cells/cell01/buses/bus1|sib-bus.xml#SIBus_1213019988044)'