升级

本节介绍与升级和使用升级工具相关的已知问题和相应的解决方案。

从 Application Server Platform Edition 8 升级到 Application Server Platform Edition 9 时，不会直接升级在自定义路径（而非 install_dir/domains 目录）中创建的域。(ID 6165528)

如果运行升级实用程序并将 install_dir 标识为源安装目录，升级进程只升级在 install_dir/domains 目录下创建的域。在其他位置创建的域不会被升级。

解决方法

启动升级进程前，将所有域目录从不同位置复制到 install_dir/domains 目录中。

在某些 Linux 系统中，单击“启动升级向导”按钮之后，执行“就地升级”的安装程序无法启动升级工具。(6207337)

此问题已在多个 Linux 系统上出现，是 Java Desktop System 2 上最常见的问题，但在 RedHat 版本中也发现了此问题。

在最终安装程序屏幕上单击“启动升级工具”按钮后，安装程序无法启动升级工具以完成升级过程，并且无限期挂起，而不会返回命令提示符。

解决方法

如果使用命令行安装模式来运行就地升级，将不会遇到此问题。

使用命令行安装模式

1. 如果您以 GUI 模式运行就地升级并且遇到此问题，请通过在启动安装程序的终端窗口中按 Ctrl+C 组合键来退出安装程序。

2. 使用以下命令从终端窗口启动升级工具：

   install_dir/bin/asupgrade --source install_dir/domains --target install_dir --adminuser adminuser--adminpassword adminpassword --masterpassword changeit

   adminuser 和 adminpassword 的值应与要升级的安装所使用的值匹配。

3. 在升级工具完成升级过程后，您还可以启动浏览器并输入以下 URL 来查看“关于”页面：

   file://install_dir/docs/about.html

   如果您还选择了用于注册产品的安装选项，请点击产品“关于”页面上提供的指向注册页面的链接。

升级工具不会传送所有 JVM 选项 (ID 6409650)

升级工具不传送 JVM 选项，例如那些与堆栈大小和堆大小相关的选项，这是因为它们应保留安装过程中指定的值。原因是，这些选项的值可能出于某些原因是针对当前版本的产品设置的。升级工具将记录一条消息，指明尚未传送哪些选项。

在升级之后复制 docroot 目录中的静态文档 (ID 6409641)

升级 Application Server 安装之后，将 docroot 目录中的所有静态文档复制到新的 docroot 目录中。如果执行了就地升级，则从安装的 domaindir 下的备份域目录复制文档。

在 Windows 上运行升级工具时必须关闭 Application Server 文件

在 Windows 上运行升级工具时，您必须关闭要升级的安装中的所有文件。如果某个文件仍然打开，则会看到升级工具挂起。

使用 XWSClientProvider 和 XWSServerProvider 时不加密用户名令牌。(ID 6409652)

要在已升级的 Application Server 中使用 XWSCLientProvider 和 XWSServerProvider，必须修改使用这些提供程序的应用程序的部署描述符，以引用 XWSClientProvider 和 XWSServerProvider。

必须更改的部署描述符为 sun-web.xml 和 sun-ejb-jar.xml。如果升级工具在 sun-web.xml 或 sun-ejb-jar.xml 中发现 ClientProvider 和 ServerProvider，它会在升级日志中记录一条消息。