[长期支持]

fteMigrateLogger (将 数据库记录器迁移到 或更高版本） 仅限 WMQFTE 7.0.1 IBM WebSphere MQ 7.5 LTS

如果要将现有独立数据库记录器的配置从 IBM® WebSphere® MQ File Transfer Edition 7.0.1 或更高版本迁移到 IBM WebSphere MQ 7.5 或更高版本，请使用 fteMigrateLogger 命令。

[MQ 9.2.1 2020 年 12 月]注： 对于 Continuous Delivery ， fteMigrateLogger 命令在 IBM MQ 9.2.1 删除。

[长期支持]该命令仍可用于 IBM MQ 9.2 Long Term Support。

不能使用 fteMigrateLogger 命令迁移 JEE 数据库记录仪：而应使用将 WebSphere Application Server V7 JEE 数据库记录仪从 WMQFTE V7.0 迁移到 WMQ V7.5 或更高版本中的信息。

[Windows]如果已将独立数据库记录仪配置为作为 Windows 服务运行，则无法使用 fteMigrateLogger 命令迁移该记录仪的配置。 如果在配置为作为 Windows 服务运行的记录仪上运行 fteMigrateLogger 命令，该命令会产生错误，并且不会继续运行。 或者，如果包含 -f 参数 ，命令会执行完毕，但会发出警告。

重要说明：
[AIX、Linux 和 Windows]在 AIX®, Linux®, and Windows 系统上，如果使用的是 IBM MQ 服务器安装镜像，则必须同时满足这两个条件才能运行该命令：
  • 成为 IBM MQ 管理员。
  • 是 mqm 组的成员（如果在系统上定义了 mqm 组）。
否则，您将收到错误信息BFGCL0502E: You are not authorized to perform the requested operation。如果您使用的是 Redistributable Managed File Transfer Agent 存档，则不受此限制。
[z/OS]在 z/OS® 系统上，必须至少满足其中一个条件才能运行该命令：
  • 是 mqm 组的成员（如果在系统上定义了 mqm 组）。
  • 成为 BFG_GROUP_NAME环境变量 （如果已命名）中指定的群组成员。
  • 运行命令时 ，BFG_GROUP_NAME环境变量中没有设置任何值。
注: 如果要从 IBM WebSphere MQ File Transfer Edition 7.0 或更高版本进行迁移，并且要继续使用 FTE_CONFIG 环境变量，那么可以在不更改 FTE_CONFIG 值的情况下执行此操作。 您可以执行标准迁移，但不能设置 BFG_DATA ，并且必须按 IBM WebSphere MQ File Transfer Edition 7.0中的用法设置 FTE_CONFIG。

在运行 fteMigrateLogger 命令之前，请停止要在 IBM WebSphere MQ File Transfer Edition 7.0上迁移其配置的数据库记录器。

如果运行带有 -f 参数的命令，那么将仅刷新有关记录器的信息。 如果缺少必需的文件，那么该命令将失败。 具体而言，将迁移以下与记录器配置关联的属性文件和 .mqsc 文件：

表 1. fteMigrateLogger 命令迁移的文件
fteMigrateLogger 命令迁移的文件的名称 信息
wmqfte.properties wmqfte.properties 文件基于 IBM WebSphere MQ 7.5 或更高版本中的 installation.properties
command.properties  
coordination.properties  
coordination_queue_manager.mqsc  
databaselogger.properties 或使用 -file 参数指定的其他属性文件 databaselogger.properties 用于在 IBM WebSphere MQ 7.5 或更高版本中创建 logger.properties 文件。
fteMigrateLogger 命令用于迁移安装，协调和命令队列管理器的文件，并将这些文件复制到 IBM WebSphere MQ 7.5 或更高版本，前提是这些文件在目标版本上尚不存在。 如果这些文件已存在，那么它们不会作为该命令的一部分被复制。

Syntax

fteMigrateLogger

Read syntax diagramSkip visual syntax diagram fteMigrateLogger -loggerName logger_name -config configuration_directory -credentialPath credentials_path  -file properties_file  -f -pconfiguration_options

参数

- 记录器名称 logger_name
必需。 要在 IBM WebSphere MQ 7.5 或更高版本中提供给已迁移记录器配置的名称。 有关 IBM WebSphere MQ 7.5 新增的日志记录器名称的更多信息，请参阅 logger_name 参数。
-config 配置目录
必需。 要从中迁移记录器配置的安装的配置目录路径。
- credentialPath credentials_path
必需。 定义要将凭证信息迁移到的位置。 此参数可以是现有凭证文件存在于的目录路径，也可以是接收新凭证文件的新位置。 对于 z/OS 平台，这可以是预先存在的扩展分区数据集 (PDSE)，具有要更新的现有成员，或者无现有成员，以针对这些凭证包含一个新成员。
注: 如果使用 PDSE ，那么它必须是变量块。
-file 属性文件
可选。 指定要迁移的数据库记录器属性文件。 仅当属性文件不使用以下缺省名称和路径时，该参数才必需：configuration_directory/coordination_qmgr_name/databaselogger.properties
-f
可选。 即使一般情况下迁移的某些配置文件与现有配置冲突，也强制进行迁移。 例如，如果 IBM WebSphere MQ File Transfer Edition 上的数据库记录器属性文件与 IBM WebSphere MQ 7.5 或更高版本上的属性文件不匹配，那么指定 -f 参数意味着将忽略此不匹配。
- -p 配置选项
可选。 该参数确定用于查找要迁移的记录器配置的配置选项集。 将一个配置选项集的名称用作 -p 参数的值。 按照约定，这是协调队列管理器的名称。 如果未指定该参数，那么会使用缺省的配置选项集。 更多信息，请参阅配置选项。
-? 或 -h
可选。 显示命令语法。

示例

在此示例中，位于 /var/ibm/WMQFTE/config 中的独立数据库记录器的配置将迁移到 IBM WebSphere MQ 7.5 并命名为 FTELOGGER1:
fteMigrateLogger -loggerName FTELOGGER1 -config /var/ibm/WMQFTE/config 
-credentialPath /home/user1/FTELOGGER1

返回码

0
命令成功完成。
1
命令结束但未成功。
有关返回代码的更多信息，请参阅 MFT 返回代码。

运行 fteMigrateLogger 命令之后

要验证迁移，请在成功运行 fteMigrateLogger 命令后，使用 fteStartLogger （启动 MFT 记录仪） 命令，在 IBM WebSphere MQ 7.5 或更高版本上启动已迁移配置的数据库记录仪。