第 5 章 配置 JBoss 服务器迁移工具

5.1. 配置 JBoss 服务器迁移工具属性

您可以使用属性配置 JBoss 服务器迁移工具日志记录和报告输出,并确定要迁移的组件和配置。您可以使用以下任一方法组合配置这些属性。

5.1.1. 使用工具属性配置 JBoss 服务器迁移工具

您可以使用位于 EAP_HOME/migration/configuration/ 目录中的 environment.properties 文件来配置 JBoss 服务器迁移工具。此标准 Java 属性文件为所有有效的属性提供默认值,可在迁移到目标服务器时配置。要更改默认值,请删除在属性前的 # comment 字符,并将其设置为您需要的值。

5.1.2. 使用用户属性配置 JBoss 服务器迁移工具

如果您愿意,您可以创建一个标准 Java 属性文件来定义 JBoss 服务器迁移工具配置属性,并使用 --environment-e 参数在命令行中传递其路径。这个路径可以是绝对路径,也可以是相对于当前目录的路径。

$ EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME --environment path/to/my-server-migration.properties

在命令行中使用 --environment-e 参数定义的属性会覆盖 EAP_HOME/migration/configuration/environment.properties 文件中定义的文件中定义的属性。

5.1.3. 使用系统属性配置 JBoss 服务器迁移工具

您可以通过使用下列语法在命令行中传递系统属性,来配置 JBoss 服务器迁移工具:

$ EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME -Djboss.server.migration.PROPERTY_NAME=PROPERTY_VALUE

系统属性名称应指定为 jboss.server.migration。 与环境属性名称串联。以下示例演示了如何在启动 JBoss 服务器迁移工具时将 XML 报告的名称指定为 migration-report.xml

$ EAP_HOME/bin/jboss-server-migration.sh --source EAP_PREVIOUS_HOME  -Djboss.server.migration.report.xml.fileName=migration-report.xml

命令行中指定的环境属性会覆盖用户配置属性和工具配置属性。

警告

通过在命令行上传递系统属性配置 JBoss 服务器迁移工具目前无法实现以下属性:

  • report.html.fileName
  • report.html.maxTaskPathSizeToDisplaySubtasks
  • report.html.templateFileName
  • report.summary.maxTaskPathSizeToDisplaySubtasks
  • report.xml.fileName

这个问题的一个已知问题应在下一版本的 JBoss EAP 中解决。有关此问题的更多信息,请参阅 JBEAP-12901