第 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。
