A.3. Web 子系统迁移操作警告
迁移
操作无法处理所有资源和属性。下表列出了您在为 Web
子系统运行 迁移或
操作时可能会看到的一些警告:
描述迁移
如果您在迁移操作的输出中看到"Can not migrate"或"Can not migrate
"条目,这表示服务器配置迁移成功完成,但无法自动迁移所有元素和属性。您必须遵循"migration-warnings"提供的建议来修改这些配置。
Warning 消息 | 它是什么,如何修复它 |
---|---|
仅允许在 admin 模式中迁移操作 |
EAP_HOME/bin/standalone.sh --admin-only
|
无法迁移资源 X |
此资源在之前的 JBoss EAP 发行版中表现出的行为并未迁移。管理员必须验证 JBoss EAP 7 |
无法从资源 Y 迁移属性 X. |
此资源属性在之前的 JBoss EAP 发行版中表现出的行为并未迁移。管理员必须验证 JBoss EAP 7 如需未迁移的属性列表,请参阅 Web Subsystem Migration Operation Attribute Warnings。 |
无法迁移 SSL 连接器,因为没有定义 SSL 配置 | 该消息包含说明内容。 |
无法将 | 该消息包含说明内容。 |
无法迁移 | 该消息包含说明内容。 |
无法迁移 valve X |
此 valve 在 JBoss EAP 的上一个发行版中表现出的行为并未迁移。管理员必须验证 JBoss EAP 7 以下 valves 中可能会发生这个警告:
|
无法将属性 X 从 valve Y迁出 |
此 valve 属性在 JBoss EAP 的上一个发行版中表现出的行为并未迁移。管理员必须验证 JBoss EAP 7
|
Web 子系统迁移操作属性警告
迁移
操作无法处理所有 JBoss Web 属性。有关如何手动迁移未处理的属性的详情,请参考下表。
Web SSL 连接器属性
以下属性在 JBoss EAP 6 中用于配置 SSL 连接器:JBoss EAP 7 不支持 OpenSSL 原生库,因此没有对应的设置。
属性 | 描述 | Undertow Equient |
---|---|---|
ca-revocation-url | 包含撤销列表的文件或 URL。 | Undertow 中没有等效项。 |
certificate-file | 使用 OpenSSL 加密时,包含服务器证书的文件路径。 | Undertow 中没有等效项。 |
ssl-protocol | SSL 协议字符串. | Undertow 中没有等效项。 |
verify-depth | 在决定客户端没有有效证书前检查的中间证书签发者的最大数量。 | Undertow 中没有等效项。 |
Web 静态资源属性
以下 static-resources
元素属性用于描述如何由 DefaultServlet 或
Webdavlet
处理静态资源。这些属性没有等效项,因为 Undertow 不支持 WebDAV。如需更多信息,请参阅 https://issues.jboss.org/browse/JBEAP-1036。
属性 | 描述 | Undertow Equient |
---|---|---|
disabled | 启用默认的 Servlet 映射。 | Undertow 中没有等同的设置。 |
file-encoding | 在读取静态文件时要使用的文件编码。 | Undertow 中没有等同的设置。 |
max-depth |
| 这是 WebDAV 设置,Undertow 不支持 WebDAV。 |
只读 | 允许写入 HTTP 方法(PUT、DELETE)。 | 这是 WebDAV 设置,Undertow 不支持 WebDAV。 |
Secret | WebDAV 锁定操作的机密。 | 这是 WebDAV 设置,Undertow 不支持 WebDAV。 |
sendfile | 对于大于指定字节大小的文件,如果可能,启用 sendfile。 | 这在 Undertow 中设置为合理的默认值,且不可配置。 |
webdav | 启用 WebDAV 功能。 | Undertow 不支持 WebDAV。 |
Web SSO 资源属性
SSO 的处理方式与上一发行版不同,JBoss EAP 7 中没有等同的属性设置。
JBoss Web Attribute | 描述 | Undertow Equient |
---|---|---|
cache-container | 用于集群 SSO 的缓存容器的名称。 | Undertow 中不再需要此设置。这在分布式集群环境中默认有效。 |
cache-name | 用于集群 SSO 的缓存名称。 | Undertow 中不再需要此设置。这在分布式集群环境中默认有效。 |
重新身份验证 | 每个请求是否应该导致重新身份验证。 |
Undertow 中没有等效的设置,其行为与 JBoss EAP 6 中的 |
Web 访问日志属性
JBoss Web Attribute | 描述 | Undertow Equient |
---|---|---|
resolve-hosts | 是否启用解析主机以用于访问日志记录. | 使用连接器上的 设置来完成相同的行为。 |
Web Connector 属性
JBoss Web Attribute | 描述 | Undertow Equient |
---|---|---|
执行器 | 应用来处理这个连接器的线程的执行器的名称。 |
您现在引用了在 |
proxy-binding | 用于定义发送重定向时使用的主机和端口的套接字绑定。 | 没有直接等效的. 有关可用配置选项,请参阅 JBoss EAP 配置指南 https://access.redhat.com/documentation/en-us/red_hat_jboss_enterprise_application_platform/7.3/html-single/configuration_guide/#https_listener_attributes 中的 https-listener 属性。 |
redirect-port | 用于重定向至安全连接器的端口。 |
此属性已在 JBoss EAP 6 中弃用,并替换为 如需更多信息,请参阅 JBoss EAP 配置指南 https://access.redhat.com/documentation/en-us/red_hat_jboss_enterprise_application_platform/7.3/html-single/configuration_guide/#https_listener_attributes 中的 https-listener 属性。 |