6.3. 将 JBoss EAP 6.4 主机配置迁移到 JBoss EAP 7.4
默认情况下,JBoss 服务器迁移工具在将主机服务器配置从 JBoss EAP 6.4 迁移到 JBoss EAP 7.4 时执行以下任务。
6.3.1. 迁移参考模块
从源服务器迁移到目标服务器的配置可能会引用或依赖目标服务器上未安装的模块。JBoss 服务器迁移工具可检测并自动迁移所引用的模块,以及它们的依赖模块(从源服务器到目标服务器)。
使用以下步骤迁移由主机服务器配置引用的模块。
- 由安全域配置引用的模块将迁移为插件模块。
控制台会记录一个信息,指出迁移的任何模块的模块 ID。通过在 modules.excludes
环境属性中指定模块 ID,可以排除特定模块的迁移。如需更多信息 ,请参阅配置模块迁移。
6.3.2. 迁移参考路径
从源服务器迁移到目标服务器的配置可能会引用或依赖必须迁移到目标服务器的文件路径和目录。JBoss 服务器迁移工具不会迁移绝对路径参考。它只会迁移配置为相对于源配置的文件和目录。控制台会记录一条消息,指出迁移的每个路径。
JBoss 服务器迁移工具自动迁移以下路径参考:
- Vault 密钥存储和加密的文件的目录。
要跳过引用路径的迁移,请将 path .migrate-paths-requested-by-configuration.vault.skip
环境属性设置为 true
。
6.3.3. 添加核心管理子系统
JBoss EAP 7.4 core-management
子系统提供与管理相关的资源,这些资源之前是在管理核心服务中配置的。这些资源的示例包括能够查看对服务器进行配置更改的历史记录,以及监控服务器生命周期事件的能力。JBoss 服务器迁移工具会自动将默认 核心管理
子系统配置添加到迁移的配置文件中。
要跳过添加 core-management
子系统配置,请将 subsystem.core-management.add.skip
环境属性设置为 true
。
6.3.4. 添加 Elytron 子系统
JBoss EAP 7.4 elytron
子系统提供了一个统一的安全框架,可以管理并配置单机服务器和受管域的访问。它还可用来为部署到 JBoss EAP 服务器的应用程序配置安全访问。JBoss 服务器迁移工具会自动将默认的 elytron
子系统配置添加到迁移的配置文件中。
要跳过添加 elytron
子系统配置,请将 subsystem.elytron.add.skip
环境属性设置为 true
。
6.3.5. 将 JMX subsystem 添加到主机配置中
JBoss EAP 7.4 jmx
子系统提供管理和监控系统的功能。JBoss 服务器迁移工具会自动将这个子系统添加到迁移的配置文件中。
要跳过添加 jmx
子系统配置,请将 subsystem.jmx.add.skip
环境属性设置为 true
。
6.3.6. 删除不安全的接口
JBoss 服务器迁移工具自动删除与 JBoss EAP 7.4 默认配置一致的 非安全
接口配置。
要跳过删除 未安全
接口,将 interface.unsecure.remove.skip
环境属性设置为 true
。
6.3.7. 设置 HTTP 升级管理
在 JBoss EAP 7.4 中添加 Undertow,增加了 HTTP 升级,允许通过单一端口多协议进行多路复用。这意味着管理客户端可以通过 HTTP 进行初始连接,但会发送请求来将那个连接升级到另一个协议。JBoss 服务器迁移工具会自动更新配置来支持 HTTP 升级管理。
要跳过 HTTP 升级管理的配置,请将 management.setup-http-upgrade.skip
环境属性设置为 true
。
6.3.8. 从 JVM 配置中删除 PermGen Attributes
在 JBoss EAP 7 中弃用了 JVM 配置中的 PermGen
属性。JBoss 服务器迁移工具会自动从所有服务器组的所有 JVM 配置中删除。
要跳过删除 PermGen
属性,请将 jvms.remove-permgen-attributes.skip
环境属性值设置为 true
。
6.3.9. 迁移兼容的安全性 Realms
由于 JBoss EAP 7.4 安全域配置与 JBoss EAP 6.4 安全域配置完全兼容,因此它们不需要通过 JBoss 服务器迁移工具进行更新。但是,如果 application-users.properties
、application-roles.properties
、mgmt-users.properties
和 mgmt-groups.properties
文件不会被引用,工具会使用迁移的配置文件预期的路径。
要跳过安全域迁移,请将 security-realms.migrate-properties.skip 环境
属性设置为 true
。
6.3.10. 将默认 SSL 服务器身份添加到 ApplicationRealm
JBoss EAP 7.4 默认配置包含默认的 ApplicationRealm
安全域的 SSL 服务器身份。JBoss 服务器迁移工具自动将此身份添加到迁移的配置文件中。
要跳过这个身份的添加,请将 security-realm.ApplicationRealm.add-ssl-server-identity.skip
环境属性设置为 true
。