mqsimigratecomponents 命令

支持的平台

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

目的

mqsimigratecomponents 命令可将组件从先前安装的产品版本(仅 V2.1 或 V5)移动到另一个版本。该命令必须在已安装产品的最新版本上运行,无论该版本是源版本还是目标版本。
注:
  1. 对于产品的 2.1 版本,受支持的最早发行版为 V2.1 CSD02(2.1.0.3)。(请参阅迁移和升级获取更多信息。)
  2. 对于产品的 5 版本,受支持的最早发行版为 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 要求可以修改与组件关联的数据库

响应

根据不同操作的结果,该命令可能产生大量的响应。注:在产生消息的方式上该命令与其他命令有所不同,消息是按需显示,而非在程序结尾处成批产生。

示例

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

mqsimigratecomponents –c BROKER1
BIP 0001I: Starting migration check for component ‘BROKER1’ to FAD level ‘3’
BIP 0002I: ‘BROKER1’ is version 2.1 (auto-detected)
BIP 0003I: Broker database ‘BKRDB’ and schema ‘WMQIUSER’ are not shared with other components.
BIP 0004I: No invalid rows found in broker database.
BIP 0005I: Migration check passed.
BIP 8071I: Successful command completion.

以下示例将 BROKER1 从 V2.1 自动迁移到 V6.0

mqsimigratecomponents BROKER1
BIP 0001I: Starting migration check for component ‘BROKER1’ to FAD level ‘3’
BIP 0002I: ‘BROKER1’ is version 2.1 (auto-detected)
BIP 0003I: Broker database ‘BKRDB’ and schema ‘WMQIUSER’ are not shared with other components.
BIP 0004I: No invalid rows found in broker database.
BIP 0005I: Migration check passed.
BIP 0020I: Starting registry migration for component ‘BROKER1’.
BIP 0021I: Created top-level ‘CurrentVersion’ key
BIP 0021I: Created ‘DSN’ subkey
BIP 0022I: Created ‘HTTPListener’ subkey
BIP 0023I: Created ‘HTTPListener.HTTPConnector’ subkey
BIP 0024I: Created ‘FADLevel’ value; set to ‘3’
BIP 0025I: Created ‘converters’ value; set to ‘’
BIP 0028I: Moving registry data into ‘CurrentVersion’.
BIP 0029I: Moved value ‘AdminAgentPID’.
[repeat for each value]
BIP 0030I: Completed moving registry data into ‘CurrentVersion’.
BIP 0025I: Finished registry migration for component ‘BROKER1’.
BIP 0011I: Starting database table migration for ‘BKRDB’.’WMQIUSER’.
BIP 0012I: Moving table ’BROKERRESOURCES’ to ’somethingBROKERRESOURCES’.
BIP 0013I: Creating new table ’BROKERRESOURCES’.
BIP 0014I: Copying data from ‘somethingBROKERRESOURCES’ to ’BROKERRESOURCES’.
BIP 0015I: Successfully copied all data (322 rows).
[repeat for each table]
BIP 0016I: Finished database table migration for ‘BKRDB’.’WMQIUSER’.
BIP 0017I: Starting queue migration for ‘BKRQM’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.CONTROL’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.REPLY’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.REQUEST’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.TIMEOUT’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.AGGR.UNKNOWN’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.TIMEOUT.QUEUE’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.WS.ACK’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.WS.INPUT’.
BIP 0018I: Creating new queue ‘SYSTEM.BROKER.WS.REPLY’.
BIP 0026I: Clearing queue ‘SYSTEM.BROKER.ADMIN.QUEUE’.
BIP 0026I: Clearing queue ‘SYSTEM.BROKER.EXECUTIONGROUP.QUEUE’.
BIP 0026I: Clearing queue ‘SYSTEM.BROKER.EXECUTIONGROUP.REPLY’.
BIP 0026I: Clearing queue ‘SYSTEM.BROKER.IPC.QUEUE’.
BIP 0019I: Finished queue migration for ‘BKRQM’.
BIP 0005I: Migration succeeded for component ‘BROKER1’.
BIP 8071I: Successful command completion.

以下示例为前面示例的重复,但指定了 -q 参数:

mqsimigratecomponents -q BROKER1
BIP 0001I: Starting migration check for component ‘BROKER1’ to FAD level ‘3’
BIP 0002I: ‘BROKER1’ is version 2.1 (auto-detected)
BIP 0005I: Migration check passed.
BIP 0020I: Starting registry migration for component ‘BROKER1’.
BIP 0025I: Finished registry migration for component ‘BROKER1’.
BIP 0011I: Starting database table migration for ‘BKRDB’.’WMQIUSER’.
BIP 0016I: Finished database table migration for ‘BKRDB’.’WMQIUSER’.
BIP 0017I: Starting queue migration for ‘BKRQM’.
BIP 0019I: Finished queue migration for ‘BKRQM’.
BIP 0005I: Migration succeeded for component ‘BROKER1’.
BIP 8071I: Successful command completion.
更新开始

以下示例对从 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/05/19
an26150_