第 4 章 Java Web Console

Java Web Console 旨在为 Sun Microsystems 生成一个通用的、基于 Web 的系统管理解决方案。该控制台提供了一种环境，供用户访问具有一致用户界面的系统管理应用程序。

此控制台之所以基于 Web 模型，有许多原因。但主要原因是使系统管理员可以使用 Web 浏览器来访问系统管理应用程序。

Java Web Console 具有以下特点：

• 通用的验证和授权

• 通用日志

• 所有系统管理应用程序通过基于 HTTPS 的同一端口共用一个入口点

• 通用的外观

控制台的优点是，管理员登录一次便可使用控制台中的任何应用程序。

安装

系统要求

Java Web Console 支持多个客户端和服务器操作系统，还支持若干个浏览器。

客户端

• Solaris 10 上的 Netscape^TM 6.2x 和 7.x

• Windows 98、98 SE、ME、2000 和 XP 上的 Netscape 6.2x 和 7.x

• Windows 98、98 SE、ME、2000 和 XP 上的 Internet Explorer 5.5x 和 6.x

• Solaris 上的 Mozilla 1.4x

• Solaris 上的 Firefox 1.0

服务器

• Solaris 10

• Red Hat Application Server 2.1、3.0

• SuSE Linux 8.0 或更高版本

• J2SE^TM 1.4.1_03 或更高版本

  如果在服务器上检测到 J2SE 1.4.1 或更低版本，安装程序将提示您使用 Java Desktop System Management Tools CD 中的 J2SE 版本对已安装产品进行升级。

• Tomcat：4.0.3 或更高版本

  Tomcat 包含在 Java Desktop System Management Tools CD 中

安装 Java Web Console

Java Web Console 2.2.4 是 Solaris^TM 10 操作系统的一部分，但 Desktop Manager 需要 2.2.5 版本。server/console 目录中的 Desktop Manager 归档文件提供了 2.2.5 版本。可以通过在该目录中运行 ./setup 进行安装。

如果已经安装了 Java Web Console 3.0，则需要卸载 3.0 版，然后从 server/console 目录中安装 Java Web Console 2.2.5（如上所述）。

运行控制台

要注册新的应用程序，通常只需停止并重新启动 Java Web Console 服务器。

在首次启动 Java Web Console 之前，请确保已经完成了 Desktop Manager 安装。除非已经在控制台中至少部署了一个应用程序，否则 Java Web Console 将不会成功运行。

• 要启动 Java Web Console，请键入 smcwebserver start。

• 要停止 Java Web Console，请键入 smcwebserver stop。

• 要重新启动 Java Web Console，请键入 smcwebserver restart。

• 要访问 Java Web Console，请在浏览器中输入以下 URL： https://<hostname>.<domainname>:6789

Java Web Console 本身即可支持基于 Unix 的验证和基于角色的访问控制 (Role-Based Access Control, RBAC)。但是，您也可以配置其他验证机制，例如 LDAP 验证。

默认的会话超时时间为 15 分钟。可以使用 smreg 命令配置超时长度。例如，要将超时长度设置为 5 分钟，请键入 smreg add -p -c session.timeout.value=5。

有关 Java Web Console 命令的详细信息，请参见 smcwebserver 和 smreg 的手册页。

删除 Java Web Console

如果使用的是 Solaris，由于 Java Web Console 是操作系统的一部分，因此无法将其删除。

Java Web Console 疑难解答

无法安装 Java Web Console

症状：在安装结束时出现一条消息，指出由于没有注册的应用程序而无法启动 Java Web Console。

可能的原因：安装 Desktop Manager 模块之后，该模块启动了 Java Web Console。

连接被拒绝

症状：尝试打开一个正确的 URL（例如 https://< your.server>:6789），但是连接被拒绝。

可能的原因： Java Web Console 未在服务器上运行。

无法登录

默认情况下不安装 LDAP 登录模块。因此，不会将登录证书与存储在 LDAP 服务器中的登录证书进行比较，只需要常规的系统登录证书。此疑难解答部分仅适用于手动安装 LDAP 登录模块的情况。

症状：已经进入 Web Console 的登录页，但用户名/密码组合被拒绝。

可能的原因：

• 未运行 LDAP 服务器。

• 未正确配置 Web Console LDAP 验证模块。

• LDAP 服务器上不存在此用户。

• 此用户在 LDAP 服务器上具有不同的密码。

无 Desktop Manager 链接

症状：已经登录到 Web Console，但应用程序列表页中未包含 Desktop Manager。

可能的原因：

• 未安装 Desktop Manager 模块

Null 指针异常、Tomcat/Java 错误或显示空白页

症状：打开 Desktop Manager 后未显示任何值，只显示空白页或一些错误消息。

可能的原因：如果错误消息中包含 NoClassDefFoundError:sun/tools/javac/Main ，则说明 Java Web Console 使用了错误的 Java 安装。

其他问题

如果 Web 服务器未正常运行，日志文件可能会提供相关信息。这些日志文件位于 /var/log/webconsole/ 中。可以通过使用 smreg 命令提高日志的详细程度：

smreg add -p debug.trace.level=3
smreg add -p debug.trace.options=tmp

可以使用以下命令恢复原始设置：

smreg add -p debug.trace.level=0
smreg add -p debug.trace.options=m

可以使用以下命令触发配置数据库的完全转储：

smreg list

运行 Desktop Manager 的 Web 服务器有时可能未正确关闭，从而使其端口一直处于使用状态。这将阻止启动新的 Web 服务器。如果 smcwebserver start/restart 命令报告错误消息、执行完 smcwebserver stop 命令后仍可访问 Desktop Manager ，或者新启动的服务器仍按先前方式运行，请检查 6789 端口是否仍处于使用状态（使用 netstat -a | grep 6789 命令），或者检查 Web 服务器是否仍在运行（使用 ps -ef | grep java 命令）。如果出现上述任何一种情况，应该中止相关的进程，不再使用 6789 端口。