管理

本节介绍已知的管理问题和相应的解决方法。

如果不存在 domain1，package-appclient 脚本将不起作用。(ID 6171458)

说明

默认情况下，在 $INSTALL/lib/package-appclient.xml 中有一个用于 domain1（由 asenv.conf 来指向）的 AS_ACC_CONFIG 变量的硬编码值。如果删除 domain1 并创建新域，将不会用新域名更新 AS_ACC_CONFIG 变量，从而导致 package-appclient 脚本失败。

解决方法

执行以下操作之一：

• 保持 domain1 不变，围绕它创建其他域。

• 删除 domain1 并用新域名替换 $INSTALL/lib/package-appclient.xml 中用于 domain1 的硬编码值。如果 domain1 不存在，则每次创建新域时，都必须执行此操作。

安装负载平衡插件将覆盖现有插件。 (ID 6172977)

说明

如果在已安装负载平衡器插件的 Application Server 版本（例如 7.1EE）上安装负载平衡插件，则 8.2EE 插件将无提示替换任何现有负载平衡器（即使已创建可在其中运行此插件的新服务器实例）。

默认情况下，插件文件将安装在 install_dir/plugins/lbplugin 目录下，这表示每个版本的 Application Server 仅可以使用一个版本的插件。请注意，控制台安装程序会显示消息，表明将进行卸载，但有时很容易将此消息忽略。

解决方法

并非任何用户都会遇到此问题。如果遇到此问题，请删除旧的 Application Server 版本并进行新安装而非升级安装。

与 JES2 AS7 相比，对 JES3 Application Server 8.2 中的 asadmin 脚本进行了某些更改（ID 6189433、6189436）

与 Application Server 7.x 相比，对 Application Server 8.2 中的 asadmin 命令进行了某些更改。例如，在 7.x 中，用于启动服务器实例的命令为：

asadmin start-instance

在 8.2 中，等效命令为：

asadmin start-domain --user admin domain1

有关最新的 asadmin 命令语法的完整信息，请参阅以下文档：

• 《Sun Java System Application Server Enterprise Edition 8.2 管理指南》

• 《Sun Java System Application Server Enterprise Edition 8.2 Reference Manual》

• 《Sun Java System Application Server Enterprise Edition 8.2 Upgrade and Migration Guide》

Application Server 中的默认端口已更改 (ID 6198555)

说明

从 JES2/Application Server 7. x 升级到 JES5/Application Server 8.2 时，由于默认端口已更改，因此可能会遇到不兼容问题或错误。

解决方法

有关 Application Server 8.2 中使用的默认端口列表，请参阅本说明前面部分中的其他要求。

无法恢复具有其他名称的备份域。(ID 6196993)

说明

无法使用 backup-domain 和 restore-domain 命令镜像同一 Application Server 安装上的域，这是由于使用不同于原始名称的其他名称不能恢复域，即使 asadmin restore-domain 命令提供了重命名域的选项。重命名备份域似乎已经成功，但尝试启动重命名的域却会失败，因为没有更改域配置中的条目，并且 startserv 和 stopserv 仍然使用原始域名来设置路径。

解决方法

用于 restore-domain 的域名必须与用于原始 backup-domain 命令的域名相同。Application Server 8.2 中的 backup-domain 和 restore-domain 命令仅用于在同一台计算机上备份和恢复同一个域。

不支持启动带有附加 JMX 代理的 Application Server。(ID 6200011)

说明

可以在 Application Server 上配置 J2SE 1.4.x, 5.0 或更高版本。J2SE 5.0 平台的完整功能是可以启动 JMX 代理。在服务器启动时，如果您明确设置了系统属性，此功能将被激活。

示例值包括：

name="com.sun.management.jmxremote" value="true"
name="com.sun.management.jmxremote.port" value="9999"
name="com.sun.management.jmxremote.authenticate" value="false"
name="com.sun.management.jmxremote.ssl" value="false"

在配置了 JMX 属性并启动服务器之后，将在 Application Server VM 中启动新的 jmx-connector 服务器。此过程的副作用是会对管理功能造成不利影响，并且 Application Server 管理 GUI 和 CLI 可能会产生异常结果。出现此问题的原因在于内置 jmx-connector 服务器与新的 jmx-connector 服务器之间存在一些冲突。

解决方法

如果使用 jconsole（或任何其他 JMX 兼容客户机），请考虑重新使用标准的 JMX Connector Server，它在 Application Server 启动时启动。

当服务器启动时，server.log 中将显示类似于以下所示的内容。您可以连接到其中指定的 JMXServiceURL，并在成功提供证书后执行相同的管理/配置操作，例如：

[#|2004-11-24T17:49:08.203-0800|INFO|sun-appserver-ee8.1|javax.enterprise.
system.tools.admin|_ThreadID=10;|ADM1501: Here is the JMXServiceURL for the 
JMXConnectorServer: [service:jmx:rmi:///jndi/rmi://hostname:8686/management/
rmi-jmx-connector]. This is where the remote administrative clients should 
connect using the JSR 160 JMX Connectors.|#]

有关更多信息，请参阅《Sun Java System Application Server 8.2 Administration Guide》。

在 UNIX 上，过度限制对 Application Server start 和 stop 脚本的执行权限。(ID 6206176)

说明

如果您以用户 "A" 身份登录后运行 asadmin restore-domain 命令，这些脚本将以权限 744 (rwxr--r--) 结束。如果随后尝试以用户 "B" 的身份（即使 "B" 为超级用户）启动或停止域，则会因为只有 "A" 可以执行脚本而失败。

解决方法

更改脚本的权限：

chmod 755 appserv/domains/domain-name/bin/*

负载平衡器配置文件不能随任何 Web 服务的端点 URL 创建。（ID 6236544、6275436）

说明

如果某个应用程序具有可导出 Web 服务 URL 的 EJB 模块，则在用该应用程序设置负载平衡器配置时，Web 服务环境中的超级用户不会包含在结果文件 loadbalancer.xml 中。

解决方法

1. 编辑 loadbalancer.xml 文件，按如下所示添加缺少的 Web 模块：

   <web-module context-root="context-root-name" disable-timeout-in-minutes="30" enabled="true"/>

2. 用作为 EJB 提供的 Web 服务环境中的超级用户名称替换 context-root-name 的值。

配置中的 Java 主目录设置不起作用。(ID 6240672)

说明

Application Server 域/服务器未使用由相关配置的 java-config 元素的 java-home 属性指向的 JDK。

解决方法

对于安装的给定服务器，appserver-installation-dir/config/asenv.conf 文件确定了 Application Server 进程针对所有域使用的 JDK 。该文件中的属性 AS_JAVA 确定了所使用的 JDK，此属性是在安装时设置的。如果安装完成后，Application Server 进程使用的是其他 JDK，则可以将该值改为指向所需的 JDK。请注意，安装的此服务器中的所有域均会受此更改影响。

不会检查对 asenv.conf 文件的手动更改的有效性，因此更改时应谨慎行事。修改 AS_JAVA 的值时，请检查产品文档以了解最低的 JDK 版本要求。

用 sun-appserv-admin 重新启动 Application Server 会导致 LoginException 错误。(ID 6288893)

说明

此问题由错误的 %CONFIG_HOME% 值引起。

解决方法

1. 重命名现有 asant.bak。

2. 将 <as_install>/lib/install/templates/ee（适用于 SE/EE 版本）中的 asant.template 文件复制到 <as_install>/bin/ 目录中，并将其重命名为 asant。

3. 编辑新复制的 <as_install>/bin/asant 脚本，用 <as_install>/config 替换 %CONFIG_HOME% 标记。

4. 如果对原始 asant.bak 文件进行了任何手动更改，请将其并入新的 asant 脚本。

Application Server 文档中未介绍 .asadmintruststore 文件。(ID 6315957)

说明

如果服务器管理员的主目录中不包含此文件，在升级该服务器上的某些应用程序时可能会出现严重错误。

解决方法

• 如果可能，应该由安装服务器的用户运行 asadmin start-domain domain1 命令。

• 如果不是由该用户运行的，应将 .asadmintruststore 从安装用户的主目录移动或复制到运行用户的主目录中。

• 请注意，如果将该文件从安装用户的主目录移动（而非复制）到运行用户的主目录，可能会出现错误 6309079、6310428 和 6312869 所述的应用程序升级问题，原因是升级/安装用户（通常是 Java ES 中的超级用户）的主目录中不再具有 .asadminstruststore 文件。

create-domain 主密码具有特殊字符时，域无法启动。(ID 6345947)

说明

域的主密码包含百分比 (%) 字符时，域无法启动。

解决方法

域的主密码不应包含百分比字符 (%)。创建新域或更改现有域的主密码时亦如此。

magnus.conf 和 obj.conf 中的负载平衡器配置更改被覆写 (ID 6394181)

说明

创建安全的 http-listener 并安装 lbplugin 后，将修改 webserver_instance_dir/config 下的 magnus.conf 和 obj.conf 文件，并删除 lbplugin 的内容。

安装程序修改了 Application Server 上的 magnus.conf 和 obj.conf 配置文件，这些文件是负载平衡器安装程序插件的一部分。如果登录到 Application Server 管理控制台，并尝试为已安装负载平衡器的实例管理实例配置，则 Application Server 将显示警告消息，报告已检测到在配置中进行了手动编辑。事实上，此警告是指安装程序所做的更改。

解决方法

验证安装程序所做的更改是否被覆写。