WAS Community Edition V1安装与配置

IBM® WebSphere® Application Server Community Edition 是基于 Apache Geronimo 的开放源代码 Java™ 2 Platform Enterprise Edition (J2EE™) 应用服务器。本文将帮助您理解为什么要使用这一新产品,它什么时候会是项目的最佳选择，然后向您介绍要快速上手和运行 WebSphere Application Server Community Edition（从设置环境和选择正确的下载包到部署应用程序）需要了解哪些内容。
IBM WebSphere Application Server Community Edition 是在 Apache Geronimo 之上构建的 Java 2 Platform, Enterprise Edition (J2EE) 应用服务器，由 Apache Foundation 创建的开放源代码应用服务器。

什么时候使用 WebSphere Application Server Community Edition

什么时候应该使用 WebSphere Application Server Community Edition 呢？这取决于您使用应用服务器的计划，有几种情况使用 WebSphere Application Server Community Edition（以下称为 Community Edition）会是您的最佳实现选择；同样，有时使用更健壮的 WebSphere Application Server 产品是合理的，甚至有时使用 Apache Geronimo 更为合适。例如：

如果您需要轻量级的应用服务器作为测试平台来运行 J2EE 应用程序，并且倾向于使用一个相对稳定、经过反复测试和可得到世界级技术支持的产品，则从技术和经济角度来看，Community Edition 将是您的最佳选择。您可以相信该应用服务器能够足够稳定地运行应用程序和原型，另外 Community Edition 还可以免费下载和使用。您可以在短时间内安装并使用它来进行商业评估或原型演示。在您免费使用该产品的同时，可以根据需要购买 IBM 支持（可选），如果需要，还可以迁移到其他 WebSphere Application Server 产品。

如果您打算运行要求高可用性、集群或故障转移的重要应用程序，或者想要通过复杂的管理控制台和工具功能来帮助部署和调试 J2EE 应用程序，则应该考虑其他 IBM WebSphere Application Server 产品。使用 Community Edition，您可以快速开发应用程序并使其以增量的方式发展，同时提供基本的安全性、简单的管理和手动的应用程序部署。Community Edition 的目标用户是单个开发人员、部门员工或小型企业。在此范围之外，您应该考虑其他 WebSphere Application Server 产品。如果您正在寻找的是更加可视化的快速开发工具，则 WebSphere Application Server - Express 可能是更好的选择。如果您需要可伸缩性、在企业范围部署、功能丰富且健壮，或者您有大量事务，想要自动部署应用程序，或者基于商业目标实现应用优先级，则应该考虑 WebSphere Application Server、WebSphere Application Server Network Deployment 或 WebSphere Extended Deployment。

如果您想要改进或自定义应用服务器的实现、添加功能或者修复错误，则使用 Apache Geronimo 可能较为合适，它可以让您获得所有的相关源代码和构建自己的应用服务器。另外，您可以将您的更新发布到 Apache Geronimo 社区，以便您的工作可以被其他人利用。

Community Edition 的附加值

Apache Geronimo 是由 Apache Software Foundation 开发的开放源代码 J2EE 应用服务器项目，它集成了来自广泛的开放源代码社区的领先技术（例如 Apache Jetty、Apache Tomcat、ActiveMQ、Tranql、OpenEJB，等等）以支持 J2EE 堆栈。（完整的技术列表请参阅参考资料中的 Community Edition 文档）。Geronimo 是由 Apache 许可的，它可高度自定义和社区驱动的。

Community Edition 是在 Apache Geronimo Milestone 5 之上构建的轻量级 J2EE 应用服务器，它具有 IBM 添加的关键功能，并可得到 IBM 世界级的支持。Community Edition 主要由 Apache Geronimo M5 组成，并具有包含 IBM 附加值的产品。Community Edition 的关键功能包括：

J2EE 1.4 认证，它支持性能在整个行业领先的 IBM Java Virtual Machine (JVM)；其他 WebSphere Application Server 产品也附带相同的 JVM。
使用 Apache Tomcat 作为缺省 Web 容器（Geronimo 使用 Jetty）。
IBM Cloudscape V10.1 数据库嵌入 Community Edition，并支持在开发和生产中使用。
支持 DB2®、Oracle® 数据库、Microsoft® SQL Server 和 MySQL 数据库服务器。
采用 InstallShield 安装，下载包占用空间小。Community Edition 通常可以在五分钟内安装完毕；ISV 供应商可以轻松地嵌入 Community Edition。
IBM WebSphere 产品外观。
有助于从 Gluecode Standard Edition、Apache Geronimo 和 Apache Tomcat 迁移到 Community Edition，以及从 Community Edition 迁移到其他 WebSphere Application Server 产品。
IBM LDAP 集成。
详细而完整的文档资产。
没有产品许可限制；用户可以在开发、测试和部署中免费使用 Community Edition。
一个版本可以得到一年半的 IBM 世界级产品支持。（IBM Apache Geronimo 支持需要频繁更新，因为它与 Apache Geronimo 社区结合得很紧密。）

下载和安装 Community Edition

Community Edition 系统的先决条件：

支持的操作系统：
Intel® 体系结构 - 32 位 (IA-32) 处理器上的 Windows® 平台
Microsoft Windows Server 2003，带有 Service Pack 1 (SP1)
Microsoft Windows XP Professional Edition，带有 Service Pack 2 (SP2)（只用于开发，不用于生产）
Intel 体系结构 - 32 位 (IA-32) 处理器上的 Linux® 平台
Red Hat Enterprise Linux Version 3 Update 5（Work Station (WS)、Entry Server (ES) 或 Advanced Server (AS)）
Red Hat Enterprise Linux Version 4 Update 1（Work Station (WS)、Entry Server (ES) 或 Advanced Server (AS)）
Novell® SuSE Linux Enterprise Server 9 Service Pack 2 (SP2)
RedFlag Data Center 5.0
Community Edition 可以运行在其他平台上，但如果需要获得支持，则必须使用这些环境之一：

支持的 Java 环境：
IBM Java 2 Standard Edition (J2SE) Software Development Kit (SDK) Version 1.4.2 build cn142ifx-20051109 (142SR3+97115+97198+97199+97509) 或更高版本，以及 IBM Java ORB build orb142ifx-20051109 (142SR3+97115+97198+97199+97509) 版本 1420:1 或更高版本
IBM Java 2 Standard Edition (J2SE) Java Runtime Environment (JRE) Version 1.4.2 build cn142ifx-20051109 (142SR3+97115+97198+97199+97509) 或更高版本，以及 IBM Java ORB build orb142ifx-20051109 (142SR3+97115+97198+97199+97509) 版本 1420:1 或更高版本
Sun® Microsystems Java 2 Standard Edition (J2SE) Software Development Kit (SDK) Version 1.4.2 build 1.4.2_09 或更高版本
Sun Microsystems Java 2 Standard Edition (J2SE) Java Runtime Environment (JRE) Version 1.4.2 build 1.4.2_09 或更高版本
如果您还没有一个支持的 Java 环境，则可以下载包含支持的 JRE 的安装包。

下载和安装

下载和安装 Community Edition 相当简单。您可以从 developerWorks 免费下载 Community Edition 软件。Community Edition 有四种可用的版本；下载哪种版本取决于您的平台以及您是否已经安装支持的 Java Runtime Environment (JRE)。如果您还没有支持的 JRE，请确保选择标签为“plus JRE”的一种包。

如果您已经有了支持的 Java 环境，则只需要通过运行 setup-wasce 文件安装 Community Edition。否则，需要展开（untar 或 unzip，取决于您的平台）wasce10_ibm142jre 文件并运行 setup-ibm-jre-142 来创建支持的 JRE，然后才能运行 setup-wasce 文件。

启动和停止服务器

启动服务器的操作

在 Windows 2003 或 XP 服务器上，通过选择 Start => Programs => IBM WebSphere => Application Server Community Edition => Start the server 来启动服务器。这将启动位于 C:\Program Files\IBM\WebSphere\AppServerCommunityEdition\bin\startServer.exe（假设您使用缺省安装位置）的 Startup Launcher。在 Linux 上，通过运行 /opt/IBM/WebSphere/AppServerCommunityEdition/bin 上的 startServer.sh 来启动服务器（假设您使用缺省安装位置）。显示了当服务器成功启动时会显示的 Geronimo Application Server started 消息。

Community Edition 服务器已启动

Booting Geronimo Kernel (in Java 1.4.2_10)...
Started configuration 1/15 0s geronimo/rmi-naming/1.0/car
Started configuration 2/15 2s geronimo/j2ee-server/1.0/car
Started configuration 3/15 1s geronimo/j2ee-security/1.0/car
Started configuration 4/15 6s geronimo/activemq-broker/1.0/car
Started configuration 5/15 1s geronimo/activemq/1.0/car
Started configuration 6/15 0s geronimo/system-database/1.0/car
Started configuration 7/15 4s geronimo/tomcat/1.0/car
Started configuration 8/15 0s geronimo/geronimo-gbean-deployer/1.0/car
Started configuration 9/15 2s geronimo/j2ee-deployer/1.0/car
Started configuration 10/15 0s geronimo/tomcat-deployer/1.0/car
Started configuration 11/15 0s geronimo/welcome-tomcat/1.0/car
Started configuration 12/15 4s geronimo/webconsole-tomcat/1.0/car
Started configuration 13/15 1s geronimo/uddi-tomcat/1.0/car
Started configuration 14/15 0s geronimo/remote-deploy-tomcat/1.0/car
Started configuration 15/15 1s geronimo/hot-deployer/1.0/car
Startup completed in 26 seconds
Listening on Ports:
1099 0.0.0.0 RMI Naming
1527 0.0.0.0 Derby Connector
4201 0.0.0.0 ActiveIO Connector EJB
4242 0.0.0.0 Remote Login Listener
8009 0.0.0.0 Tomcat Connector AJP
8080 0.0.0.0 Tomcat Connector HTTP
8443 0.0.0.0 Tomcat Connector HTTPS
61616 0.0.0.0 ActiveMQ Message Broker Connector

Started Application Modules:
WAR: geronimo/welcome-tomcat/1.0/car
EAR: geronimo/webconsole-tomcat/1.0/car
RAR: geronimo/activemq/1.0/car
EAR: geronimo/uddi-tomcat/1.0/car
WAR: geronimo/remote-deploy-tomcat/1.0/car
RAR: geronimo/system-database/1.0/car

Web Applications:
http://server:8080/
http://server:8080/console
http://server:8080/console-standard
http://server:8080/juddi
http://server:8080/remote-deploy

Geronimo Application Server started

停止服务器的操作

要停止服务器，请在服务器启动窗口中按下 Ctrl-C。会显示消息 Server shutdown begun，然后服务器立即关闭。

部署您的第一个应用程序

当您下载 Community Edition 时其中有一个文件是包含 J2EE 示例应用程序的 ZIP 文件。使用这些示例是开始使用 Community Edition 的一个很好方式。通过部署其中最简单的应用程序——Hello 示例，您可以快速掌握将自己的应用程序部署到 Community Edition 的基本知识。要使用这些示例和部署 Hello 应用程序，您应该执行以下操作：

从产品下载页面下载 wasce10_samples.zip 文件，并将其解压缩到一个已知位置。

在 samples 目录下，hello 目录包含应用程序的源代码和二进制两种形式。如果您导航至 src/webapp，您将看到这是一个非常简单的 Web 应用程序。主文件是一个 Java ServerPages 文件 index.jsp（清单 1）。

清单 1. index.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<jsp:useBean id="datetime" class="java.util.Date" />
<title>Hello IBM WebSphere Application Server Community Edition Version 1</title>
</head>
<body>
<h2>Welcome to IBM WebSphere Application Server Community Edition Version 1</h2>
<p>Congratulations on running this very simple demo application on ${datetime}.</p>
</body>
</html>
Hello 应用程序也有一个遵循标准 J2EE 的部署描述符（清单 2）。Hello 应用程序是一个标准的 Web 应用程序，所以应该不需要做任何更改就可以在 Community Edition 或其他任何 J2EE 应用服务器上运行。

清单 2. web.xml

<?xml version="1.0" encoding="UTF-8" ?>
<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" />
在部署应用程序之前启动服务器。

打开另一个命令提示符并导航至 wasce_install 目录。

执行命令：

java -jar bin\deployer.jar --user system --password manager deploy samples_home\hello\bin\hello.war

当部署命令完成时，将会显示此消息以指示部署成功：

Deployed hello @ http://localhost:8080/hello

在新的浏览器窗口中打开 http://localhost:8080/hello。您应该能看到一条祝贺您应用程序部署成功的消息（图 2）。

图 2. Hello 应用程序

您已经成功部署并运行了该应用程序。这再简单不过了。然而，如果您查看启动服务器的窗口，您将看到这段消息：

WARN [TomcatModuleBuilder] Web application does not contain a WEB-INF/geronimo-web.xml deployment plan.
This may or may not be a problem, depending on whether you have things like resource references that
need to be resolved. You can also give the deployer a separate deployment plan file on the command line.

因为这是一个简单的应用程序，它不需要额外的信息就可以部署成功，所以这不是问题。如果您部署一个更复杂的应用程序（例如，依赖于外部库的应用程序，或者需要将任何资源引用映射成实际资源的应用程序），则需要在部署时提供额外信息。对于 Community Edition，这一信息是以部署计划的形式提供的。

作为简单的示例，让我们将 Hello 应用程序的上下文根 (context root) 更改为 simpledemo 而非 hello。

在可以用新的上下文根部署 Hello 应用程序之前，您必须将它解除部署。在 wasce_install 目录中执行以下命令：

java -jar bin\deployer.jar --user system --password manager undeploy hello

您应该能看到一段消息，表明您已成功解除部署应用程序。（您可能会忘记包含应用程序的模块的名称，对于这种情况，您可以执行 list-modules 命令来查看当前部署在服务器上的所有模块。）

将清单 3 中的代码复制到名为 hello-plan.xml 的文件中来部署计划。

清单 3. hello-plan.xml

<?xml version="1.0"?>
<web-app
xmlns="http://geronimo.apache.org/xml/ns/web"
xmlns:naming="http://geronimo.apache.org/xml/ns/naming"
configId="HelloApp">

<context-root>/simpledemo</context-root>

</web-app>

通过执行此命令再次部署应用程序——这次也提供部署计划的位置：

java -jar bin\deployer.jar --user system --password manager deploy samples_home\hello\bin\hello.war
path_to_hello_plan\hello-plan.xml

当部署完成时，您应该能看到一段消息表明部署成功：

Deployed HelloApp @ http://localhost:8080/simpledemo

不仅上下文根改变了，连模块名称现在都与部署计划中指定的配置 ID 相同。

故障排除

当您遇到问题时，首先要查看的地方是日志。

安装日志

Windows：wasce_install.log 可以在用户的主目录中找到（例如 C:\Documents and Settings\userID，其中 userID 替换为用于登录的用户名称）。
Linux：wasce_install.log 可以在公共 log 目录 /var/log 中找到。
服务器日志

Community Edition 服务器日志可以在 installDir/var/log 目录中找到，其中 installDir 是服务器的安装目录。

server.log 是包含服务器启动、部署、配置、应用程序运行和服务器关闭数据的日志。
deployer.log 是当服务器没有运行时，执行脱机部署时的活动日志。如果服务器正在运行，部署信息就会转到服务器日志上。
client.log 是 J2EE 客户端容器日志。
缺省数据库日志

IBM Cloudscape Version 10.1 是缺省的系统数据库，它的日志 derby.log 可以在 installDir/var/log 目录中找到，其中 installDir 是服务器的安装目录。

接下来的步骤

试验示例应用程序

示例下载 ZIP 文件中提供了其他示例应用程序。已证明使用这些示例是继续学习应用服务器的一种好方式。其他示例应用程序包括：

CViewer - 一个Web 应用程序包含了一个 JSP 和它调用的一个servlet。它为用户提供一个表单，让其输入完全有效的类名称。表单提交后，该 Servlet 会“映射”到该类名称并将结果返回给用户。

DBDemo1 - 一个访问 Derby 数据库中的 WASCE_USERS 数据库表的 Web 应用程序。

EMPdemo - 一个表明如何访问 Derby 数据库以及如何配置访问外部 Oracle 数据库的示例应用程序。它通过一个 WAR 文件部署。

Daytrader - 一个枚举股票交易情况的示例应用程序。用户可以查看投资组合、获得报价以及买卖股票。这是一个高级的应用程序，它使用许多 J2EE 功能，包括 JSP、Servlet、Enterprise JavaBeans、JDBC 和 JMS