mqsimigratecomponents 命令

支持的平台

  • Windows
  • Linux 和 UNIX 系统
  • z/OS

用途

mqsimigratecomponents 命令可将组件从先前安装的产品版本(仅 V2.1 或 V5)移动到另一个版本。该命令必须在已安装产品的最新版本上运行,无论是源版本还是目标版本。
注:
  1. 对于 V2.1 的产品,支持的最早产品发行版为 V2.1 CSD02(2.1.0.3)。(请参阅迁移和升级获取更多信息。)
  2. 对于 V5 的产品,支持的最早产品发行版为 V5.0.0.4。

必须已安装具有必需组件代码的 V6.0 产品,即在需要时安装代理组件,等等。

开始迁移前,停止控制中心中的任何调试会话。无法迁移正在调试的消息流。

您可以在调用命令时使用相应的选项来执行以下某项操作:
  • 在不作任何更改的情况下检查组件,确保其适合必需的迁移(-c)。
  • 将组件(全部或部分)移动到其他版本(-s-t)。
  • 撤销失败的迁移步骤(-u)。
  • 验证移动是否已成功(-v)。

mqsimigratecomponents 命令可更新注册表和文件系统、WebSphere MQ 定义和数据库定义。如果发出该命令的用户不具有执行所有这些步骤的权限,则一次只能运行该命令的一部分。不同的用户可以运行其具有权限的部分以获得全部结果。 这称为分流迁移并使用 -1-2-3 参数执行。

如果将 mqsimigratecomponents 命令用于 Sybase 数据库,则必须通过执行以下操作来修改该数据库:
  1. 使用系统管理员帐户登录 ISQL。
  2. 发出下列一系列命令:
    1> use master                    
    2> go
    1> sp_dboption "BROKER1","ddl in tran",TRUE
    2> go
    Database option 'ddl in tran' turned ON for database 'BROKER1'.
    Run the CHECKPOINT command in the database that was changed.
    (return status = 0)
    1> use BROKER1
    2> go
    1> checkpoint
    2> go
    其中 BROKER1 是 Sybase 代理数据库的名称。

语法

参数

-c
(可选)对指定的组件进行迁移前检查以确保:
  • 代理的自动检测版与命令行中指定的任何版本匹配
  • 如果从 V6.0 迁移到先前的发行版,则不存在 64 位执行组
  • 要从先前发行版复制的数据库表不包含违反 V6.0 索引要求的任何行。
如果正在迁移的代理与其他代理共享数据库模式,则会发出警告消息 BIP8678,并且检查失败。因此,共享数据库模式的所有代理必须一起迁移:
  1. 停止共享数据库模式的所有代理。
  2. 迁移第一个代理。这将为所有代理迁移数据库表,并且仅为第一个代理迁移文件系统和注册表以及 WebSphere MQ 定义;例如:
    mqsimigratecomponents FIRSTBROKER -t 6.0.0.1
  3. 迁移其他每个代理的文件系统和注册表,以及 WebSphere MQ 部分;数据库部分已被迁移。 通过一个或两个步骤,使用 -1-2 参数进行迁移:
    • 通过一个步骤:
      mqsimigratecomponents BROKERB -1 -2
    • 通过两个步骤:
      mqsimigratecomponents BROKERB -1
      mqsimigratecomponents BROKERB -2

迁移检查可以对正在运行的组件进行。这对组件没有影响,但是会略微影响性能。注:在 UNIX 系统上,因为检查命令需要能访问代理数据库,所以在可以运行检查前,需要先迁移 odbc.ini 文件(即,新格式的 odbc.ini 文件需要使用与旧文件相同的数据源集合来创建)。

检查命令成功或失败,并且会将有关迁移是否应该成功的消息打印出来,但在此过程中不会进行任何修改。

-v
(可选)对指定的组件进行迁移后检查以确保:
  • 指定的版本具有正确的数据库表和队列。
  • 指定的版本具有格式正确的注册表。
-q
(可选)操作期间打印少数状态消息。
-1
(可选)仅对注册表和文件系统进行操作。
  • 当迁移到 V6.0 时,在 -2-3 参数前使用 -1 参数。
  • 当向后迁移到先前的版本时,在 -1 参数前使用 -2-3 参数。
-2
(可选)仅对 WebSphere MQ 进行操作。
-3
(可选)仅对数据库进行操作。
-u
(可选)撤销失败的迁移步骤;您还必须至少指定 -1-2-3 中的一个。 迁移失败且无法自动恢复(例如分流迁移中出现的失败)时,应该仅使用此选项。
-s 源版本
(可选)组件的先前版本。
  • 如果不指定,将自动检测该值。
  • 分流迁移到 V6.0 时,如果运行了带 -1 参数的 mqsimigratecomponents 命令,则 -s 是必需的。分流迁移示例中对此进行了描述。
  • 请参阅用途以获得对受支持的产品版本号的限制。
-t 目标版本
(可选)组件的目标版本。
  • 如果不指定,则视该值为当前版本。
  • V6.0 分流迁移到先前版本时,-t 参数是必需的。分流迁移示例中对此进行了描述。
  • 请参阅用途以获得对受支持的产品版本号的限制。
组件名称
(可选)要迁移的组件名称。

权限

运行单步迁移时,用于调用该命令的用户标识必须可以:
  • 写入产品的注册表和文件系统
  • 修改与组件关联的数据库
  • 修改队列定义
对于分流迁移,用于调用该命令的用户标识必须可以阅读产品注册表,并且具有完成每个步骤的特定权限:
  • -1 要求可以写入产品的注册表和文件系统
  • -2 要求可以修改队列定义
  • -3 要求可以修改与组件关联的数据库

响应

更新开始根据不同操作的结果,该命令可能产生大量的响应。注:在产生消息的方式上该命令与其他命令有所不同,消息是按需显示,而非在程序结尾处成批产生。迁移数据库表时,z/OS 产生的输出多于分布式系统。更新结束

示例

以下示例将检查 BROKER1 从 V2.1V6.0 的迁移:

更新开始
mqsimigratecomponents –c BROKER1
BIP8849I: 代理“BROKER1”(V2.1)已为迁移指定了队列管理器“brkqm1”和数据源“brkdb1”。
BIP8791I: 重复行检查已启动。
BIP8794I: 表 BRMINFO 没有重复行。
BIP8794I: 表 BRMRTDDEPINFO 没有重复行。
BIP8794I: 表 BROKERRESOURCES 没有重复行。
BIP8794I: 表 BRMRTDINFO 没有重复行。
BIP8794I: 表 BRMWFDINFO 没有重复行。
BIP8792I: 通过重复行检查。
BIP8791I:重复行检查已启动。
BIP8800W: 表 BSUBSCRIPTIONS 中未检测到无效主题语法。
BIP8800W:表 BPUBLISHERS 中未检测到无效主题语法。
BIP8800W: 表 BRETAINEDPUBS 中未检测到无效主题语法。
BIP8797I: 主题语法检查已成功。
BIP8680I: 预迁移检查已成功。
BIP8071I: 命令成功完成。
更新结束

以下示例将进行 BROKER1 从 V2.1V6.0 的自动迁移:

更新开始
mqsimigratecomponents BROKER1
BIP8849I: 代理“BROKER1”(V2.1)已为迁移指定了队列管理器“BROKER1”和数据源“BROKERDB”。
BIP8755I: 已将值“QueueManagerName”复制到新位置
BIP8755I: 已将值“DataSourceName”复制到新位置
BIP8755I: 已将值“DataSourceUserId”复制到新位置
BIP8755I: 已将值“DataSourcePassword”复制到新位置
BIP8755I: 已将值“LilPath”复制到新位置
BIP8755I: 已将值“ConfigurationTimeout”复制到新位置
BIP8755I: 已将值“ConfigurationDelayTimeout”复制到新位置
BIP8755I: 已将值“MigrationNeeded”复制到新位置
BIP8755I: 已将值“MQTrustedQueueManager”复制到新位置
BIP8755I: 已将值“UserNameServerQueueManagerName”复制到新位置
BIP8755I: 已将值“BrokerUUID”复制到新位置
BIP8755I: 已将值“AdminAgentPID”复制到新位置
BIP8763I:已从旧位置删除值“QueueManagerName”
BIP8763I: 已从旧位置删除值“DataSourceName”
BIP8763I: 已从旧位置删除值“DataSourceUserId”
BIP8763I: 已从旧位置删除值“DataSourcePassword”
BIP8763I: 已从旧位置删除值“LilPath”
BIP8763I: 已从旧位置删除值“ConfigurationTimeout”
BIP8763I: 已从旧位置删除值“ConfigurationDelayTimeout”
BIP8763I: 已从旧位置删除值“MigrationNeeded”
BIP8763I: 已从旧位置删除值“MQTrustedQueueManager”
BIP8763I: 已从旧位置删除值“UserNameServerQueueManagerName”
BIP8763I: 已从旧位置删除值“BrokerUUID”
BIP8763I: 已从旧位置删除值“AdminAgentPID”
BIP8768I: 已完成组件“BROKER1”的注册表迁移。
BIP8654I: 文件系统备份正从“”移到“C:\Documents and Settings\AllUsers\Application Data\IBM\MQSI”
BIP8670I: 数据库迁移已启动
BIP8663I: 正在创建临时新表
BIP8664I: 正在从现有表迁移到临时新表
BIP8665I: 正在删除现有表
BIP8666I: 正在创建新表
BIP8667I: 正在将所有行从临时新表复制到新表
BIP8668I: 正在删除临时新表
BIP8669I: 数据库迁移成功
BIP8785I: 正在为组件“BROKER1”启动 WebSphere MQ 队列迁移。
setmqaut 命令成功完成。
BIP8786I: 已创建 WebSphere MQ 队列“SYSTEM.BROKER.AGGR.REQUEST”
setmqaut 命令成功完成。
BIP8786I: 已创建 WebSphere MQ 队列“SYSTEM.BROKER.AGGR.CONTROL”
setmqaut 命令成功完成。
BIP8786I: 已创建 WebSphere MQ 队列“SYSTEM.BROKER.AGGR.REPLY”
setmqaut 命令成功完成。
BIP8786I: 已创建 WebSphere MQ 队列“SYSTEM.BROKER.AGGR.TIMEOUT”
setmqaut 命令成功完成。
BIP8786I: 已创建 WebSphere MQ 队列“SYSTEM.BROKER.AGGR.UNKNOWN”
setmqaut 命令成功完成。
BIP8786I: 已创建 WebSphere MQ 队列“SYSTEM.BROKER.TIMEOUT.QUEUE”
setmqaut 命令成功完成。
BIP8786I: 已创建 WebSphere MQ 队列“SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE”
setmqaut 命令成功完成。
BIP8786I: 已创建 WebSphere MQ 队列“SYSTEM.BROKER.WS.INPUT”
setmqaut 命令成功完成。
BIP8786I: 已创建 WebSphere MQ 队列“SYSTEM.BROKER.WS.REPLY”
setmqaut 命令成功完成。
BIP8786I: 已创建 WebSphere MQ 队列“SYSTEM.BROKER.WS.ACK”
setmqaut 命令成功完成。
BIP8786I: 已创建 WebSphere MQ 队列“SYSTEM.BROKER.IPC.QUEUE”
BIP8787I: 已清除 WebSphere MQ 队列“SYSTEM.BROKER.ADMIN.QUEUE”
BIP8787I: 已清除 WebSphere MQ 队列“SYSTEM.BROKER.EXECUTIONGROUP.QUEUE”
BIP8787I: 已清除 WebSphere MQ 队列“SYSTEM.BROKER.EXECUTIONGROUP.REPLY”
BIP8787I: 已清除 WebSphere MQ 队列“SYSTEM.BROKER.IPC.QUEUE”
BIP8789I: 已完成组件“BROKER1”的 WebSphere MQ 队列迁移。
BIP8071I: 命令成功完成。
更新结束

以下示例对从 V2.1V6.0 的分流迁移进行说明:

mqsimigratecomponents BROKER -1
mqsimigratecomponents BROKER -s 2.1.0.8 -2
mqsimigratecomponents BROKER -s 2.1.0.8 -3

以下示例对从 V6.0V2.1 的分流迁移进行说明:

mqsimigratecomponents BROKER -t 2.1.0.8 -2
mqsimigratecomponents BROKER -t 2.1.0.8 -3
mqsimigratecomponents BROKER -t 2.1.0.8 -1
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
an26150_