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


迁移操作无法处理所有资源和属性。下表列出了您在运行 web 子系统的 migratedescribe-migration 操作时可能会看到的一些警告。

注意

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

Expand
警告信息它代表什么/如何修复它

仅在管理员模式中允许迁移操作

迁移操作需要以 admin-only 模式启动服务器,这通过将 --admin-only 添加到 server start 命令中来实现:

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

无法迁移资源 X

JBoss EAP 之前版本中此资源表现出的行为没有迁移。管理员必须验证 JBoss EAP 7 中的新 undertow 子系统能否正确操作,无需该行为,还是必须手动迁移其行为。

无法从资源 Y 迁移属性 X

JBoss EAP 先前版本中此 resource 属性所呈现的行为没有迁移。管理员必须验证 JBoss EAP 7 中的新 undertow 子系统能否正确操作,无需该行为,还是必须手动迁移其行为。

如需未迁移的属性列表,请参阅 Web 子系统迁移操作属性警告

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

消息中包含解释。

无法将 verify-client 属性 X 迁移到对应的 Undertow 属性

消息中包含解释。

无法迁移 verify-client 表达式 X

消息中包含解释。

无法迁移 valve X

前面版本的 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

无法从 valve Y迁移属性 X

JBoss EAP 先前版本中的 valve 属性显示的行为没有迁移。管理员必须验证 JBoss EAP 7 中的新 undertow 子系统能否正确操作,无需该行为,还是必须手动迁移其行为。以下 valve 属性可能会出现这个警告:

  • org.apache.catalina.valves.AccessLogValve

    • resolveHosts
    • fileDateFormat
    • renameOnRotate
    • encoding
    • locale
    • requestAttributesEnabled
    • buffered
  • org.apache.catalina.valves.ExtendedAccessLogValve

    • resolveHosts
    • fileDateFormat
    • renameOnRotate
    • encoding
    • locale
    • requestAttributesEnabled
    • buffered
  • org.apache.catalina.valves.RemoteIpValve

    • httpServerPort
    • httpsServerPort
    • remoteIpHeader

      如果它被定义但没有设置为 "x-forwarded-for"

    • protocolHeader

      如果定义了,但没有设置为 "x-forwarded-proto"

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

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

Web SSL 连接器属性

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

Expand
属性描述Undertow Equivalent

ca-revocation-url

包含撤销列表的文件或 URL。

Undertow 中没有等效的。

certificate-file

使用 OpenSSL 加密时,包含服务器证书的文件的路径。

Undertow 中没有等效的。

ssl-protocol

SSL 协议字符串。

Undertow 中没有等效的。

verify-depth

在决定客户端没有有效证书前检查的中间证书签发者的最大数量。

Undertow 中没有等效的。

Web 静态资源属性

以下 static-resources 元素属性用于描述由 DefaultServletWebdavServlet 处理静态资源的方式。这些属性没有等效的,因为 Undertow 不支持 WebDAV。如需更多信息,请参阅 https://issues.jboss.org/browse/JBEAP-1036

Expand
属性描述Undertow Equivalent

disabled

启用默认的 Servlet 映射。

Undertow 中没有等效的设置。

file-encoding

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

Undertow 中没有等效的设置。

max-depth

PROPFIND 的最大递归。

Undertow 不支持该 WebDAV 设置和 WebDAV。

只读

允许写入 HTTP 方法(PUT、DELETE)。

Undertow 不支持该 WebDAV 设置和 WebDAV。

secret

WebDAV 锁定操作的机密。

Undertow 不支持该 WebDAV 设置和 WebDAV。

sendfile

如果可能,启用 sendfile,对于大于指定字节大小的文件。

这设置为 Undertow 中的可识别的默认值,不可配置。

webdav

启用 WebDAV 功能。

Undertow 不支持 WebDAV。

Web SSO 资源属性

SSO 的处理方式与上一版本中不同,在 JBoss EAP 7 中没有对应的属性设置。

Expand
JBoss Web 属性描述Undertow Equivalent

cache-container

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

Undertow 中不再需要此设置。这在分布式集群环境中默认正常工作。

cache-name

用于集群 SSO 的缓存名称。

Undertow 中不再需要此设置。这在分布式集群环境中默认正常工作。

重新验证

每个请求是否需要重新进行身份验证。

Undertow 中没有对应的设置,它的行为与 JBoss EAP 6 中的 reauthenticate=true 设置相似。在 reauthenticate=false 可能会提高性能时,它也可能会造成安全问题。

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

resolve-hosts

是否启用解析主机来访问日志记录。

使用连接器上的 设置来实现相同的行为。

Web Connector 属性
Expand
JBoss Web 属性描述Undertow Equivalent

executor

应使用的 executor 名称,用于处理这个连接器的线程。

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

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

proxy-binding

套接字绑定,用于定义发送重定向时使用的主机和端口。

没有直接等效的。

有关可用配置选项,请参阅 JBoss EAP 配置指南中的 https-listener 属性

redirect-port

重定向至安全连接器的端口。

此属性在 JBoss EAP 6 中已弃用,并被 redirect-binding 替代。Undertow 在 http-listener 元素上提供 redirect-socket 属性,这是 redirect-binding 的替代。

如需更多信息,请参阅 JBoss EAP 配置指南中的 https-listener 属性

Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2026 Red Hat
返回顶部