migrateServerMEtoCluster 命令
属于总线的服务器转换至集群时,使用 migrateServerMEtoCluster 命令将服务器中的消息传递引擎 (ME) 迁移至集群范围。在转换期间,总线成员资格不会自动转移至集群范围。如果希望该集群成为总线成员,请使用此命令执行该转移。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin
脚本编制客户机通过 Qshell 运行.
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
仅当与 WebSphere® Application Server V7.0 或更高版本 应用程序服务器配合使用时,此命令才有效。请不要对旧版使用此命令。
- 要获取 Jython 中可用服务集成总线命令的列表以及每个命令的简要描述,请在
wsadmin 提示符处输入以下命令:
print AdminTask.help('SIBAdminCommands')
- 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
AdminConfig.save()
用途
migrateServerMEtoCluster 命令将服务器中的消息传递引擎迁移至集群范围。属于服务集成总线的服务器转换至集群时,会使用此命令。转换至集群不会自动使集群成为总线成员。可使用此命令将总线成员资格转移至集群。要使消息传递引擎具有高可用性,可使用此命令,如果要将其他消息传递引擎添加至集群以实现可伸缩性,也可使用此命令。在此情况下,不能在服务器范围内删除消息传递引擎,也不能在集群范围内重新创建消息传递引擎,原因是消息传递引擎的唯一标识 (UUID) 会丢失,并且消息传递引擎不能使用先前配置的目标。
migrateServerMEtoCluster 命令使新服务器集群成为总线成员。
此命令非常有用时的一个情境示例是,在使用用于包括总线的选项将作为总线成员的服务器联合到单元中后,通过创建一个新集群并将该服务器设置为第一个成员,将该服务器提升为集群成员。
目标对象
消息传递引擎。
将消息传递引擎复制至集群的范围,并且会复制所有目标本地化引用,以确保它对先前配置的目标起作用。将删除服务器范围内的消息传递引擎定义。
必需参数
- -bus bus_name
- 服务器主管要迁移的消息传递引擎时,该服务器所属的服务集成总线的名称。可以使用 listSIBuses 命令来列示现有总线的名称。
- -node node_name
- 服务器主管要迁移的消息传递引擎时,运行该服务器的节点的名称。
- -server server_name
- 主管要迁移的消息传递引擎的服务器的名称。
该服务器必须是指定总线的成员,必须在指定节点上运行,并且必须已转换至命令中指定的集群。
- -cluster cluster_name
- 服务器已转换至并且要将消息传递引擎迁移至的服务器集群的名称。
该集群必须存在,并且该服务器必须是该集群的成员。该集群不能还是该服务器所属的服务集成总线的成员。
可选参数
- -rename TRUE | FALSE
- 是否重命名消息传递引擎和消息点,以及是否使用集群中这些资源所使用的命名约定。例如,服务器上使用命名约定
node_name.server_name-bus_name
的消息传递引擎的名称更改为使用命名约定
cluster_name.nnn-bus_name。
- TRUE
- 消息传递引擎和消息点使用用于集群中这些资源的命名约定重命名。
- FALSE
- 未使用用于集群中这些资源的命名约定重命名消息传递引擎和消息点。
示例
将当前在 node1 上的 server1 中配置的消息传递引擎迁移至 cluster1,并且重命名该消息传递引擎及其所有消息点以使用集群术语。Server1 属于 bus1 并且已转换至 cluster1。Cluster1 还不属于 bus1。
AdminTask.migrateServerMEtoCluster ('-bus bus1 -node node1 -server server1 -cluster cluster1 -rename TRUE')