A.3. Web 子系统迁移操作警告


迁移 操作无法处理所有资源和属性。下表列出了您在为 Web 子系统运行 迁移或 描述迁移 操作时可能会看到的一些警告:

注意

如果您在迁移操作的输出中看到"Can not migrate"或"Can not migrate "条目,这表示服务器配置迁移成功完成,但无法自动迁移所有元素和属性。您必须遵循"migration-warnings"提供的建议来修改这些配置。

Expand
Warning 消息它是什么,如何修复它

仅允许在 admin 模式中迁移操作

迁移 操作需要以 admin-only 模式启动服务器,具体方法是在 server start 命令中添加参数 --admin-only

$ EAP_HOME/bin/standalone.sh --admin-only
Copy to Clipboard Toggle word wrap

无法迁移资源 X

此资源在之前的 JBoss EAP 发行版中表现出的行为并未迁移。管理员必须验证 JBoss EAP 7 中的新 undertow 子系统是否能够正确运行而无需该行为,或者确定是否必须手动迁移该行为。

无法从资源 Y 迁移属性 X.

此资源属性在之前的 JBoss EAP 发行版中表现出的行为并未迁移。管理员必须验证 JBoss EAP 7 中的新 undertow 子系统是否能够正确运行而无需该行为,或者确定是否必须手动迁移该行为。

如需未迁移的属性列表,请参阅 Web Subsystem Migration Operation Attribute Warnings

无法迁移 SSL 连接器,因为没有定义 SSL 配置

该消息包含说明内容。

无法将 verify-client 属性 X 迁移到 Undertow 等效

该消息包含说明内容。

无法迁移 verify-client expression X

该消息包含说明内容。

无法迁移 valve X

此 valve 在 JBoss EAP 的上一个发行版中表现出的行为并未迁移。管理员必须验证 JBoss EAP 7 中的新 undertow 子系统是否能够正确运行而无需该行为,或者确定是否必须手动迁移该行为。

以下 valves 中可能会发生这个警告:

  • org.apache.catalina.valves.RemoteAddrValve

    必须至少有一个允许或拒绝的值。

  • org.apache.catalina.valves.RemoteHostValve

    必须至少有一个允许或拒绝的值。

  • org.apache.catalina.authenticator.BasicAuthenticator
  • org.apache.catalina.authenticator.DigestAuthenticator
  • org.apache.catalina.authenticator.FormAuthenticator
  • org.apache.catalina.authenticator.SSLAuthenticator
  • org.apache.catalina.authenticator.SpnegoAuthenticator
  • 自定义 valves

无法将属性 X 从 valve Y迁出

此 valve 属性在 JBoss EAP 的上一个发行版中表现出的行为并未迁移。管理员必须验证 JBoss EAP 7 中的新 undertow 子系统是否能够正确运行而无需该行为,或者确定是否必须手动迁移该行为。以下 valve 属性可能会发生此警告:

  • org.apache.catalina.valves.AccessLogValve

    • resolveHosts
    • fileDateFormat
    • renameOnRotate
    • 编码
    • locale
    • requestAttributesEnabled
    • Blocked
  • org.apache.catalina.valves.ExtendedAccessLogValve

    • resolveHosts
    • fileDateFormat
    • renameOnRotate
    • 编码
    • locale
    • requestAttributesEnabled
    • Blocked
  • org.apache.catalina.valves.RemoteIpValve

    • httpServerPort
    • httpsServerPort
    • remoteIpHeader

      如果对其进行定义但未设置为"x-forwarded-for"

    • protocolHeader

      如果将其定义为"x-forwarded-proto",则将其设置为"x-forwarded-proto"

Web 子系统迁移操作属性警告

迁移 操作无法处理所有 JBoss Web 属性。有关如何手动迁移未处理的属性的详情,请参考下表。

Web SSL 连接器属性

以下属性在 JBoss EAP 6 中用于配置 SSL 连接器:JBoss EAP 7 不支持 OpenSSL 原生库,因此没有对应的设置。

Expand
属性描述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

Expand
属性描述Undertow Equient

disabled

启用默认的 Servlet 映射。

Undertow 中没有等同的设置。

file-encoding

在读取静态文件时要使用的文件编码。

Undertow 中没有等同的设置。

max-depth

PROPFIND 的最大递归数.

这是 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 中没有等同的属性设置。

Expand
JBoss Web Attribute描述Undertow Equient

cache-container

用于集群 SSO 的缓存容器的名称。

Undertow 中不再需要此设置。这在分布式集群环境中默认有效。

cache-name

用于集群 SSO 的缓存名称。

Undertow 中不再需要此设置。这在分布式集群环境中默认有效。

重新身份验证

每个请求是否应该导致重新身份验证。

Undertow 中没有等效的设置,其行为与 JBoss EAP 6 中的 reauthenticate=true 设置类似。虽然 reauthenticate=false 可能会提高性能,但也可能导致安全问题。

Web 访问日志属性
Expand
JBoss Web Attribute描述Undertow Equient

resolve-hosts

是否启用解析主机以用于访问日志记录.

使用连接器上的 设置来完成相同的行为。

Web Connector 属性
Expand
JBoss Web Attribute描述Undertow Equient

执行器

应用来处理这个连接器的线程的执行器的名称。

您现在引用了在 io 子系统中定义的 worker。

如需更多信息,请参阅迁移线程子系统配置

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 中弃用,并替换为 redirect-binding。Undertow 在 http -listener 元素上提供 redirect- socket 属性,它取代 redirect-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 属性

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat