使用 WebSphere Application Server Community Edition 中的 Web 控制台

引言

WAS CE 资源推荐 下载 WebSphere Application Server Community Edition Java 应用开发源动力：快速启动开发 开源 J2EE 应用服务器 WAS CE 专栏 WebSphere 家族主要产品概览

IBM WebSphere Application Server Community Edition（以下称为 Community Edition）是基于 Apache Geronimo 的开放源代码 Java® 2 Platform Enterprise Edition (J2EE) 应用程序服务器。Community Edition 是一个轻量级应用程序服务器，资源占用非常小，并且可以免费使用。

Community Edition 的基于 JSR-168 的管理控制台本质上是 Community Edition 中部署的一个 Web 应用程序，它为管理本地或远程服务器的许多方面提供了用户友好的基于 Web 的界面。虽然并非所有管理任务都能使用该控制台来执行，但是本文将描述究竟有多少管理任务可以使用这个易用的用户界面来完成。

本文描述的任务包括：

• 启动服务器
• 运行管理控制台
• 检查控制台导航窗格
• 配置端口
• 添加存储库文件
• 使用 Cloudscape 数据库
• 创建数据库池
• 创建 JMS 连接工厂
• 创建控制台领域

回页首

启动服务器

启动服务器是那些不能使用该管理控制台来执行的任务之一。要启动服务器，您可以：

• 选择“开始”=>“程序”=>“IBM WebSphere”=>“Application Server Community Edition”=>“Start the server”，或者：
• 执行 <wasce_home>\bin 文件夹中的 startup.bat/sh 文件，其中 <wasce_home> 是 Community Edition 的安装目录。

在图 1 中，Geronimo Application Server 的服务器启动消息显示了与该服务器一起启动的应用程序模块和 Web 应用程序列表。这里要注意的重点行是：

在 Started Application Modules 下面：

EAR: geronimo/webconsole-tomcat/1.0/car

在 Web Applications 下面：

http://localhost:8080/console
http://localhost:8080/console-standard

这些消息表明 Community Edition 中部署的控制台应用程序已成功启动。您可以使用所显示的 URL 来访问应用程序。若要访问远程计算机中的服务器，请使用 http://hostname:portnumber/console。

回页首

运行管理控制台

若要运行管理控制台，请在 Web 浏览器中转到 http://localhost:8080/console，或者选择“开始”=>“程序”=>“IBM WebSphere”=>“Application Server Community Edition”=>“Administrative Console”。

在登录页（图 2）上，输入有效的 Username 和 Password 值。缺省 Username 为 system，缺省 Password 为 manager。

一旦成功登录该控制台，则会出现欢迎页（图 3）。您可以从该页执行所有面向控制台的管理任务。

管理控制台中每个 Portlet 的右上角都有指向 Help 和 View 模式的链接。有关每个 Portlet 的简要信息可以从 Help 获得

Console Navigation 窗格位于控制台页面的左侧，工作区域位于中心。单击导航窗格中的任何主题将在工作区域中打开对应的视图。每个视图由一个或多个 Portlet 构成。在工作区域中，Common Console Actions 面板链接到常见服务器相关的任务，Online Resources 面板链接到在线可用的重要资源。

回页首

检查控制台导航窗格

导航区域中的类别包括：

• Server
• Services
• Applications
• Security
• Miscellaneous

Server

Server 任务用于访问统计信息，以及用于配置和管理各个服务器。表 1 描述了导航窗格的 Server 部分中的可用链接。

Services

此类别使管理员能够管理服务。表 2 描述了导航窗格的 Services 部分中的可用链接。

Application

您可以从这里安装新应用程序或管理现有应用程序。这个部分提供了用于卸载或停止/启动服务器中部署的任何应用程序的特性。表 3 描述了导航窗格的 Application 部分中的可用链接。

Security

这个部分帮助您查看和管理所有安全相关的配置。表 4 描述了导航窗格的 Security 部分中的可用链接。

Miscellaneous

这个部分帮助管理员查看和管理 Community Edition 中嵌入的 Cloudscape (Derby) 数据库。表 5 描述了导航窗格的 Miscellaneous 部分中的可用链接。

回页首

配置端口

管理控制台应用程序运行在 Tomcat Web 容器中的缺省端口 8080 上。若要从控制台更改端口号，请转到 Common Console Actions Portlet，并选择 Web Server Ports。图 4 显示了 Edit 连接器 Portlet。

若要使此更改生效，您需要重新启动服务器。服务器启动消息（图 1）将显示更新后的端口号。

回页首

添加存储库文件

从 Console Navigation 窗格中，单击 Services 下面的 Common Libraries 类别。在对应的视图中：

1. 查找并选择需要添加到存储库的文件。
2. 指定该文件的 Group, Artifact, Version 和 Type 值。
3. 单击 Install 安装该文件。

为便于复制文件，存储库的布局与 Apache Maven 所使用的布局相同。若要在应用程序中使用某个构件，可将依赖元素添加到应用程序部署计划中。例如，若要使用 Castor XML，可将如清单 1 所示的 XML 添加到该计划中。

<dependency>
	<uri>castor/jars/castor-0.9.5.3.jar</uri>
</dependency>

回页首

使用 Cloudscape 数据库

Community Edition 附带了 Cloudscape Version 10.1.X。从 Console Navigation 窗格中，您可以使用 Miscellaneous 类别的 Embedded DB 部分中的 DB Info 链接来查看简要数据库信息。

DB Manager

通过使用 DB Manager 链接（也在 Embedded DB 部分中），您可以创建、列出和使用现有数据库。DB Manager 视图由两个 Portlet 构成：DB Viewer 和 Run SQL（图 5）。DB Viewer 显示现有数据库。若要查看对应数据库中可用的表和表的内容，可以使用 View Tables 链接。

假设您希望从 Run SQL Portlet 中创建一个新数据库和表：

1. 对于 Create DB，指定数据库名称，例如，student，然后单击 Create。当创建成功时，将会在 Result 下面出现消息 Database created: student。
2. 对于 UseDB，从下拉列表选择 Student，并将如清单 2 所示的 SQL 粘贴到 SQL Command 字段中。单击 Run SQL。
3. 当事务成功时，结果区域中将显示消息 SQL command/s successful。

create table student(rollno VARCHAR(30), name VARCHAR(50), dob VARCHAR(40));

回页首

创建数据库池

若要从 Console Navigation 窗格创建新数据库池，请选择 Services category 下面的 Database Pools。

您将看到对应的视图在右侧工作区中打开。该 Portlet 显示服务器中可用的数据库池的数量。通过 Actions 下面提供的链接，您可以 “编辑” (edit) 该池或查看部署描述符的“使用” (usage) 信息。若要创建新数据库池，您可以使用 Geronimo 数据库池向导，或者从 JBoss 4/WebLogic 8.1 导入重要配置文件。

使用 Geronimo 数据库池向导

图 6 显示了数据库池创建向导。

若要创建新数据库池：

1. 单击 Geronimo database pool wizard。
2. 将该数据库池的名称指定为 studentpool，即与我们的示例应用程序中指定的名称相同。
3. 将数据库类型指定为 Derby Embedded 以使用嵌入的 Derby 中提供的数据库。
4. 选择数据库类型之后，对应的 JDBC driver class 将自动填充 JDBC Driver Class 字段。
5. 在 Driver JAR 字段中，输入 org.apache.derby/derby/10.1.2.ibm/jar。
6. 提供数据库的 Username 和 Password；这些字段是可选的。
7. 在 Database 字段中，输入数据库名称；例如，student。
8. 对应的 URL 将自动在 JDBC Connect URL 字段中生成（格式为：jdbc :< database type> :< database name>），并且您应该收到表明驱动程序已成功加载的消息。
9. 将其余字段保留原样。
10. 单击 Test Connection 以测试到数据库的连接。
11. 单击 Deploy 以将该池部署到服务器。
12. 单击 Usage 以了解如何在部署描述符中指定该池。

部署示例应用程序

要部署新应用程序，请转到 Console Navigation 窗格，并选择 Applications 类别下面的 Deploy New（图 7）。

• 浏览并选择示例应用程序 StudentWeb（本文附带，请参见下载部分）。
• 单击 Install 按钮。

当安装成功时，您将收到消息 The application was successfully deployed。现在您可以使用 http://localhost:8080/StudentWeb/student.jsp（其基本形式就是： http://<hostname>:<portno>/<context root>）来访问该应用程序。

应用程序需要打包在文件中或保存在单独部署描述符文件中的部署计划。如果部署计划没有随文件一起打包，则需要在 Plan 字段中指定该计划。

卸载应用程序

若要卸载或查看服务器中可用的应用程序，请转到 Console Navigation 窗格中的 Applications 类别。该类别按类型列出了服务器上可用的所有应用程序。

单击 Web App WARs 以查看您刚才部署的 Web 应用程序是否已在其中列出。

若要卸载该应用程序，只需单击与该应用程序对应的 uninstall 链接，然后尝试通过 stop 和 start 链接来停止和启动该应用程序。

回页首

创建 JMS 连接工厂

若要创建新的 JMS 连接工厂（图 8）：

1. 转到 Console Navigation 窗格并选择 Services 类别下面的 JMS。
2. 单击 Add New JMS Connection Factory。
3. 在 Name 字段中指定 ActiveMQ 连接工厂的名称；例如，SampleJMSConnectionFactory。
4. 在 Server URL 字段中指定 ActiveMQ 服务器的 URL；例如，tcp://localhost:61616，即缺省端口号。
5. Username 和 Password 是可选字段。
6. 指定 Pool Max Capacity 的值；例如 10。
7. 指定 Blocking Timeout 的值，例如 0。
8. 单击 Create 创建该 JMS 连接工厂。这将把新工厂添加到 JMS 连接工厂列表。
9. 单击 Test Connection 测试该连接配置。若成功，则应显示为 Connected。
10. 单击 Details 以查看您创建的连接工厂的信息。

回页首

创建控制台领域

Community Edition 的控制台领域包括管理用户和管理组。若要创建新领域，请转到 Console Navigation 窗格并单击 Security 类别下面的 Console Realm。

创建新用户

若要创建新用户，请执行下列操作：

1. 在 Console Realm Users 下面，选择 Create New User。
2. 在 Add User Portlet 中，输入新的 Username 和 Password 的值。
3. 单击 Add 按钮。若创建成功，新用户将出现在列表中。

将用户添加到组

若要将您创建的用户添加到名为 admin 的现有组：

1. 单击 Console Realm Groups 下面的 admin。
2. 选择要添加的用户，然后单击 ADD>>。
3. 单击 Update 按钮以查看 admin 组中的该用户。

从控制台注销，然后用新用户名和密码登录。

密钥存储区

转到 Console Navigation 窗格并单击 Security 下面的 Key store。对应的视图将显示服务器缺省密钥存储区中可用的密钥。

只需单击相关可用链接即可导入信任的证书和生成新密钥对。

故障排除

故障排除信息在 Community Edition 提供的日志文件中。若要查看日志文件，请转到 Console Navigation 窗格并单击 Server 类别下面的 Server Logs。

Server Logs 视图由下列部分组成：

• Log manager
• Server Log Viewer
• Derby Log Viewer
• Web Access Log Viewer

通过这些 Portlet，您可以获得来自服务器、部署、嵌入的 Derby 和本地或远程服务器上部署的 Web 应用程序的日志信息。

缺省 Config 文件是标准 log4j 文件，其中定义了 Geronimo Server 记录 Geronimo 输出的位置。该配置文件还定义了日志级别、最大日志文件大小和其他与日志记录相关联的属性。

回页首

结束语

本文通过演示管理控制台及其使用，向您指出了顺利地开始管理 WebSphere Application Server Community Edition 的途径。请使用下面的参考资料来了解有关 Community Edition 的更多信息，并通过部署可供下载的示例应用程序来获得对 Community Edition 的更深入理解。