fteMigrateConfigurationOptions: ： 7.0迁移到 7.5 或更高版本

fteMigrateConfigurationOptions 命令从 IBM® WebSphere® MQ File Transfer Edition 7.0 迁移一组配置选项，并将其复制到 IBM WebSphere MQ 7.5 或更高版本，前提是这些文件在目标版本上尚不存在。 如果这些文件已存在，那么会输出一条消息，而且命令无法继续。

注: 如果要从 IBM WebSphere MQ File Transfer Edition 7.0进行迁移，并且想要继续使用 FTE_CONFIG 环境变量，那么可以在不更改 FTE_CONFIG 值的情况下执行此操作。 您可以执行标准迁移，但不能设置 BFG_DATA ，并且必须按 IBM WebSphere MQ File Transfer Edition 7.0中的用法设置 FTE_CONFIG。
重要说明：
[UNIX、Linux、Windows]在 UNIX, 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环境变量中没有设置任何值。

Syntax

fteMigrateConfigurationOptions

Read syntax diagramSkip visual syntax diagramfteMigrateConfigurationOptions -config configuration_directory -credentialPath credentials_path-configurationOptionsName configuration_options_name

参数

-config (configuration_directory)
必需。 要从中进行迁移的安装的配置目录路径。 例如，C:\Documents and Settings\All Users\Application Data\IBM\WMQFTE\config

-credentialPath (凭据路径)
必需。 定义要将凭证信息迁移到的位置。 此参数可以是现有凭证文件存在于的目录路径，也可以是接收新凭证文件的新位置。

此参数用于将 agent.properties， coordination.properties和 command.properties 文件中存在的 SSL/TLS 密钥库和信任库属性的密码属性从 IBM WebSphere MQ 7.5 之前的产品版本迁移到 7.5 或更高版本。

在 IBM WebSphere MQ 7.5之前，密码属性 (例如 coordinationSslTrustStorePassword) 曾经存在于 coordination.properties 文件中，但已移至 IBM WebSphere MQ 7.5中的 MQMFTCredentials.xml 文件。 要将密码属性从 coordination.properties 文件移至 MQMFTCredentials.xml 文件，请使用 -credentialsPath 。 使用该选项时，fteMigrateConfigurationOptions 命令会在 coordination.properties 文件中查找“coordinationSslTrustStorePassword”，如果存在此内容，那么会将该属性迁移到 MQMFTCredentials.xml 文件。

[z/OS]对于 z/OS 平台，这可以是预先存在的分区数据集扩展（PDSE），要么更新现有成员，要么在没有现有成员的情况下为这些凭据添加新成员。

注: 如果使用 PDSE ，那么它必须是变量块。
- -configurationOptionsName（configuration_options_name）
必需。 要迁移的配置选项集的名称。 您可以通过使用星号字符 (*) 来表示零个或零个以上字符，以迁移多个配置选项集。 您可以将星号与字符串结合使用。 例如，要迁移名称以 IBM 开头的所有配置选项集，请按如下方式使用该参数：-configurationOptionsName IBM*。

示例

在此示例中，将迁移目录 C:\Documents and Settings\All Users\Application Data\IBM\WMQFTE\config 中的所有配置。 目录路径用双引号括起：
fteMigrateConfigurationOptions -config "C:\Documents and Settings\All Users\Application Data\IBM\WMQFTE\config" 
-credentialPath "C:\Documents and Settings\user1\configurationoptions" -configurationOptionsName *

返回码

0
命令成功完成。
1
命令结束但未成功。