A.3. Web 子系统迁移操作警告
迁移操作无法处理所有资源和属性。下表列出了您在运行 web 子系统的 migrate 或 describe-migration 操作时可能会看到的一些警告。
如果您在迁移操作输出中看到 "Could not migrate" 或 "Can not migrate " 条目,这表示成功完成了服务器配置,但无法自动迁移所有元素和属性。您必须遵循"migration-warnings"提供的建议来修改这些配置。
| 警告信息 | 它代表什么/如何修复它 |
|---|---|
| 仅在管理员模式中允许迁移操作 |
EAP_HOME/bin/standalone.sh --admin-only
|
| 无法迁移资源 X |
JBoss EAP 之前版本中此资源表现出的行为没有迁移。管理员必须验证 JBoss EAP 7 中的新 |
| 无法从资源 Y 迁移属性 X。 |
JBoss EAP 先前版本中此 resource 属性所呈现的行为没有迁移。管理员必须验证 JBoss EAP 7 中的新 如需未迁移的属性列表,请参阅 Web 子系统迁移操作属性警告。 |
| 无法迁移 SSL 连接器,因为未定义 SSL 配置 | 消息中包含解释。 |
|
无法将 | 消息中包含解释。 |
|
无法迁移 | 消息中包含解释。 |
| 无法迁移 valve X |
前面版本的 JBoss EAP 出示的行为没有迁移。管理员必须验证 JBoss EAP 7 中的新 对以下 valves 可能会出现这个警告:
|
| 无法从 valve Y迁移属性 X |
JBoss EAP 先前版本中的 valve 属性显示的行为没有迁移。管理员必须验证 JBoss EAP 7 中的新
|
Web 子系统迁移操作属性警告
迁移操作无法处理所有 JBoss Web 属性。有关如何手动迁移未处理属性的信息,请参见以下参考表。
Web SSL 连接器属性
JBoss EAP 6 中使用以下属性来配置 SSL 连接器。JBoss EAP 7 不支持 openssl 原生库,因此没有对应的设置。
| 属性 | 描述 | Undertow Equivalent |
|---|---|---|
| ca-revocation-url | 包含撤销列表的文件或 URL。 | Undertow 中没有等效的。 |
| certificate-file | 使用 OpenSSL 加密时,包含服务器证书的文件的路径。 | Undertow 中没有等效的。 |
| ssl-protocol | SSL 协议字符串。 | Undertow 中没有等效的。 |
| verify-depth | 在决定客户端没有有效证书前检查的中间证书签发者的最大数量。 | Undertow 中没有等效的。 |
Web 静态资源属性
以下 static-resources 元素属性用于描述由 DefaultServlet 或 WebdavServlet 处理静态资源的方式。这些属性没有等效的,因为 Undertow 不支持 WebDAV。如需更多信息,请参阅 https://issues.jboss.org/browse/JBEAP-1036。
| 属性 | 描述 | Undertow Equivalent |
|---|---|---|
| disabled | 启用默认的 Servlet 映射。 | Undertow 中没有等效的设置。 |
| file-encoding | 读取静态文件时要使用的文件编码。 | Undertow 中没有等效的设置。 |
| max-depth |
| 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 中没有对应的属性设置。
| JBoss Web 属性 | 描述 | Undertow Equivalent |
|---|---|---|
| cache-container | 用于集群 SSO 的缓存容器的名称。 | Undertow 中不再需要此设置。这在分布式集群环境中默认正常工作。 |
| cache-name | 用于集群 SSO 的缓存名称。 | Undertow 中不再需要此设置。这在分布式集群环境中默认正常工作。 |
| 重新验证 | 每个请求是否需要重新进行身份验证。 |
Undertow 中没有对应的设置,它的行为与 JBoss EAP 6 中的 |
Web 访问日志属性
| JBoss Web 属性 | 描述 | Undertow Equivalent |
|---|---|---|
| resolve-hosts | 是否启用解析主机来访问日志记录。 | 使用连接器上的 设置来实现相同的行为。 |
Web Connector 属性
| JBoss Web 属性 | 描述 | Undertow Equivalent |
|---|---|---|
| executor | 应使用的 executor 名称,用于处理这个连接器的线程。 |
现在,引用在 如需更多信息,请参阅迁移线程子系统配置。 |
| proxy-binding | 套接字绑定,用于定义发送重定向时使用的主机和端口。 | 没有直接等效的。 有关可用配置选项,请参阅 JBoss EAP 配置指南中的 https-listener 属性。 |
| redirect-port | 重定向至安全连接器的端口。 |
此属性在 JBoss EAP 6 中已弃用,并被 如需更多信息,请参阅 JBoss EAP 配置指南中的 https-listener 属性。 |