- 至少需要 1.5 GB 磁盘空间用于安装 WebSphere Application Server - Express，并且还应具有额外的磁盘空间用于存放开发资源。
- 如果下载电子映像来安装 WebSphere Application Server - Express，则还需要额外的 1.5 GB。
-
至少使用 800 x 600 显示器（建议使用 1024 x 768）
-
至少使用 1024 x 768 显示器
第 1 章 IBM WebSphere Application Server - Express 的安装需求
第 2 章 在 Windows 上安装 WebSphere Application Server - Express
第 3 章 在 Linux 上安装 WebSphere Application Server - Express
第 4 章 在 AIX 上安装 WebSphere Application Server - Express
第 5 章 在 Solaris 上安装 WebSphere Application Server - Express
第 6 章 在 HP-UX 上安装 WebSphere Application Server - Express
第 9 章 安装 WebSphere Application Server - Express 以便在小组环境中工作
本《安装指南》第 6 版（2003 年 11 月）包含 WebSphere Application Server - Express V5.1 的下列信息：
请参阅产品支持站点 www.ibm.com/software/webservers/appserv/express/support.html 以获取下列修订和支持信息：
例如，从 5.0、5.0.1 或 5.0.2 升级到 5.1。
注意关于 WebSphere Application Server - Express V5.1 的下列信息：
安装 CD 的根目录以及产品安装目录提供了本指南的 HTML 和 Acrobat PDF 版本。这两个版本包含完全相同的信息。可以在任何 Web 浏览器中打开 install.html。要打开 install.pdf，必须已经安装了 Acrobat Reader 软件，可以从 www.adobe.com/products/acrobat/readstep2.html 下载该软件。
在安装 WebSphere Application Server - Express 之前，必须安装下列硬件：
至少使用 800 x 600 显示器（建议使用 1024 x 768）
至少使用 1024 x 768 显示器
对通信适配器的支持
对 TCP/IP 和适配器的支持。
在安装 WebSphere Application Server - Express 之前，必须安装以下软件：
下列操作系统之一：
Windows(R) 2000 Server 或 Advanced Server（带有 Service Pack 4 或更高版本，仅适用于远程服务器组件）
Windows(R) 2003 Server Standard Edition（仅适用于远程服务器组件）
Windows(R) 2000 Professional（带有 Service Pack 4 或更高版本，适用于 WebSphere Studio 工具和服务器组件）
Windows XP SP1a Professional（适用于 WebSphere Studio 工具和服务器组件）
Red Hat V7.2（仅适用于包含单元测试环境的 WebSphere Studio 工具组件）
Red Hat V8.0（仅适用于包含单元测试环境的 WebSphere Studio 工具组件）。
Red Hat 版本 AS（或 EL）2.1（仅适用于远程服务器组件）
SuSE V7.2（仅适用于包含单元测试环境的 WebSphere Studio 工具组件）。
SuSE V8.1（仅适用于包含单元测试环境的 Studio 工具组件）。
United Linux V1.0（Suse SLES 8）（仅适用于远程服务器组件）
AIX 5.2（5200-01 维护级别），仅适用于远程服务器组件，并且从任何受支持的 Studio 工具平台进行远程部署
Solaris 9（带有 2003 年 4 月的建议补丁群集），仅适用于远程服务器组件
HP 11iv1（修订级别为 2002 年 12 月），仅适用于远程服务器组件
表 1. Red Hat 和 SuSE 操作系统支持的本地语言
|
| 仅英语 | 英语以及本地语言 | 单字节字符集（SBCS） | 双字节字符集（DBCS）（请参阅注释 1） |
|---|---|---|---|---|
| Red Hat 7.2 | 是 |
|
|
|
| Red Hat 8.0 |
| 是 | 是 | 是（1） |
| SuSE 7.2 | 是 |
|
|
|
| SuSE 8.1 |
| 是 | 是 |
|
（1）如果要在 Red Hat 8.0 上使用双字节字符集，则需要将 GTK 2.0 升级到 GTK 2.2 或更高版本。请参阅（可选）升级到 GTK 2.2.2 或更高版本。
警告：
如果安装了 WebSphere Application Server - Express 并且安装了任何第三方插件，则需要获取版本 5.1.1 的相应插件并重新安装它们。
此软件包包含两套 CD：
安装使用方案
要点：只能在用于演示、测试和开发应用程序的机器上使用 DB2 通用数据库精简版。不能在生产服务器上安装这两个程序的其中之一。有关更多详细信息，请参阅附带的许可证。
本节包含有关在 Windows 上安装 WebSphere Application Server - Express 的信息。WebSphere Application Server - Express 的 主要组件包括 Application Server、远程代理控制器和 WebSphere Studio Site Developer (WSSD)。可以 选择安装这三个组件中的其中之一，也可以选择全部安装这三个组件。如果您希望能够使用 WSSD 来管理 Application Server，则 需要与 Application Server 一起安装远程代理控制器。可以从 CD-ROM 或从下载的电子映像 安装 WebSphere Application Server - Express。
安装说明：
可以采用交互式控制台方式运行安装程序，而不使用 GUI 向导面板。控制台方式可能更适合于具有易使用性需求的人士。“-accessibility”方式为具有视觉障碍的最终用户提供了附加的可听信息。要以控制台方式运行，请从 WebSphere Application Server - Express 安装 CD 的安装目录中运行此命令：
遵循提示完成安装。注意：“-is:javaconsole”选项至关重要。如果不指定此选项，安装程序将被挂起。“-log @NONE”将关闭记录以消除来自控制台的日志信息。如果在安装期间遇到任何问题，则您可能想除去此选项以便收集日志信息。
要点：不要在先前版本上安装此版本。可以将它安装到另一个目录中 以使它们共存，也可以先卸载先前版本，然后再安装到同一个目录中。如果安装程序检测到应用程序服务器的先前版本，就会向您提供将服务器配置迁移到 5.1 服务器的选项。有关更多详细信息，请参阅《迁移指南》。
要点：如果尝试从版本 5.1.1 Studio Site Developer IDE 打开版本 4.0.x 工作空间，则该工作空间将被转换为版本 5.1.1 工作空间。项目名、项目源文件和项目 Java 构建路径（类路径）将保持不变。但是，用户界面设置、调试设置和大多数首选项将会丢失。有关将现有项目安全地迁移到版本 5.1.1 的指示信息，请参阅《迁移指南》。
作为一项预防措施，建议先生成版本 5.x 的工作空间的备份副本，然后再迁移到版本 5.1.1。
在安装产品之前，请检查下列各项：
要从第一张产品安装 CD 安装 WebSphere Application Server - Express，请遵循下列步骤：
提示：
要点：不要安装到其名称包含双字节字符或特殊字符（如美元 符号）的目录中。这样做可能会导致不期望的结果，例如在 WebSphere 测试环境中产生类路径问题。
WebSphere Application Server - Express 包含多个可下载的部分。所有部分都是自解压归档文件，并且所有部分都是必需的。
安装此产品之前，请检查以下内容：
要安装 WebSphere Application Server - Express 的电子映像，请遵循下列步骤：
在安装了 WebSphere Application Server - Express 之后，在安装期间选择的 <Expressinstallpath> 路径下就应该具有以下目录结构：
如果这些目录中的任何目录包含的文件数明显不同，则您应该怀疑在安装期间发生了问题。查看 <Expressinstallpath>\logs 目录中的 expressInstallLog.txt 文件以诊断问题。
如果安装成功完成，则通过开始 > 程序 > IBM WebSphere Application Server - Express 5.1 > Studio Site Developer 菜单项启动 Site Developer。一旦启动了 Site Developer，就遵循“欢迎”页面上的链接来装入和运行 Express 示例。
IBM 代理控制器总是作为 Windows 服务安装的，并且是 自动启动的。IBM 代理控制器提供了 Site Developer 与 Application Server 之间的通信信道。请检查“控制面板”> “管理工具”>“服务”以了解是否列示了 IBM 代理控制器并且它是否正在运行。如果怀疑出现了问题，则查看 <Expressinstallpath>\RAC\config 目录中的 servicelog.log 文件。
如果安装未成功完成，则查看 <Expressinstallpath>\logs 目录中的 racInstallLog.txt。如果 racInstallLog.txt 文件 不存在，则可能意味着系统上已经安装了另一个版本的 IBM 代理控制器。卸载其它版本，然后重试安装。
可以通过从“第一步”应用程序运行“验证服务器安装”来验证 Application Server 安装的基本操作。“第一步”是在安装结束时启动的，也可以从“开始”>“程序”> IBM WebSphere Application Server - Express 5.1 >“第一步”来启动它。
或者，您可以通过运行 <Expressinstallpath>\Express\bin\testServer.bat 文件验证 Application Server 的操作。此批处理文件将指导您使用其缺省配置来启动和停止 Application Server。注意，此批处理文件只用于测试服务器安装。
运行 setupwin32.exe 将会启动 Java 安装程序而后将控制权返回给命令提示符。安装实际上在后台继续运行。这里有几个简单方法来验证静默安装已完成：
运行安装程序的另一方法是发出命令来直接运行 Java 安装程序。必须将几个命令行参数传递到安装程序中，安装程序才能正确运作。在第一张 CD 的 util 目录中，有一个称为 syncInstall.bat 的示例批处理文件，可用来同步运行安装 － 这意昧着在安装完全结束之后，控制权才会返回给命令提示符。可以如 setupwin32.exe 的情况那样将参数传递给 syncInstall.bat 命令。此批处理命令对于静默安装方案尤其有用。
如果希望将 WebSphere Application Server - Express 与您自已的产品捆绑到一起，则可以静默方式运行 此安装程序。要以静默方式安装 WebSphere Application Server - Express，请 使用 -silent 命令行选项。在静默安装期间，在调用了安装命令之后将看不到向导面板。
要使用所有缺省值以静默方式运行安装，请使用类似如下的命令：
setupwin32.exe -silent
如果要更改缺省的 Express 安装位置（IBM/WebSphere/Express），则使用：
setupwin32.exe -silent -P waseBean.installLocation=c:\<yourdirectory>
还可以使用响应文件为静默安装设置附加选项。查看安装 CD 上的响应文件示例以获取模板。要使用响应文件来运行静默安装，请使用类似如下的命令：
setupwin32.exe -silent -options <fully qualified path>\responsefile
注意：当选择 WebSphere Studio Site Developer 功能部件时，WebSphere Application Server - Express 不支持从 CD 的静默安装。原因是此功能部件需要第二张 CD，而安装程序在静默运行时不提示放置第二张 CD。要静默安装 WebSphere Studio Site Developer 功能部件，可以将第二张 CD 复制到硬盘，或者在另一个 CD 驱动器中安装该 CD，然后使用“-media 2=<path to second CD>”选项来告知安装程序在何处找到第二张 CD 映像。
随 Express 附带包括了样本响应文件，它的位置是 \util\responsefile.txt。可以将此文件用作模型响应文件。
要卸载 WebSphere Application Server - Express：
要完全除去 WebSphere Application Server - Express，手工删除保留的目录。
当运行 WebSphere Application Server - Express 的卸载时，除了安装期间显示的功能部件之外，显示的功能部件面板还会显示几个附加功能部件。这些附加功能部件是显示为 Studio Site Developer 功能部件的子功能部件。如果想要选择或取消选择 Studio Site Developer 功能部件，则确保选择或取消选择所有子功能部件。
IBM 代理控制器提供 Studio Site Developer 与 Application Server 之间的通信机制。代理控制器是作为 Windows 服务安装的，并且将它配置为以本地系统（LocalSystem）帐户运行。如果您希望的话，可以使用“Windows 服务”管理器面板 来更改此配置以使 IBM 代理控制器在另一个用户帐户下运行。因为代理控制器是用来启动 Application Server 的，所以运行代理控制器所采用的帐户也是运行 Application Server 所采用的帐户。
存在各种用来保护 Studio Site Developer 与代理控制器之间的链接的选项。安装将配置该链接以允许任何 Studio Site Developer 用户与代理控制器进行连接。如果在生产服务器环境中使用代理控制器，则您会希望更改此安全性缺省值。
可以使用 <Expressinstallpath>\RAC\bin\RACSecurityOn.bat 和 RACSecurityOff.bat 文件来启用和禁用基本登录安全性。当启用了安全性时，Studio Site Developer 用户在连接至代理控制器时必须提供 有效的用户名和密码组合（这是操作系统的用户名和密码）。代理控制器将用户名和密码转发给操作系统以进行认证。在 Windows 上，不对域名密码进行认证。必须提供本地用户名和密码对。
要运行 IBM 代理控制器的 SetConfig 实用程序，在您的执行路径中必须存在 Java。
如果在已经有 WebSphere Application Server - Express 5.0 副本的机器上安装 WebSphere Application Server - Express 5.1，则 IBM 代理控制器将被更新为 5.1.1 版本且被配置为指向 5.1 Express 服务器。如果后来想要除去 WebSphere Application Server - Express 5.1 并恢复 5.0 环境，则需要重新安装 5.0 Application Server 或 Studio Site Developer 组件才能恢复 5.0 版本的 IBM 代理控制器。这两个 5.0 功能部件中的任何一个都会安装“IBM 代理控制器 5.0”。
本节讨论有关在 Windows 上安装和卸载 WebSphere Application Server - Express 的已知问题和限制。有关影响产品实际使用的问题和限制的信息，请参阅自述文件。
如果映射至网络驱动器，但没有指定设备名（例如，\\computername\sharename），则您尝试安装 WebSphere Application Server - Express 时可能会接收到以下消息：由于以下错误，向导不能继续：无法装入 /wizard.inf 中指定的向导（104）。变通方法是通过指定设备名以本地方式映射至网络驱动器（例如，x:\sharename）。
不要安装到 Novell NetWare 驱动器。在 Novell NetWare 驱动器上的安装将失败。
在开始安装 WebSphere Application Server - Express 之前，您应作为管理员登录。
安装故障偶尔会导致 _uninst 目录中的卸载文件不完整。此问题的症状是尝试运行卸载程序时显示一条消息，该消息指出找不到适当的 JVM。应按如下所示手工运行卸载程序：
如果安装失败，则必须除去任何已安装的 WebSphere Application Server - Express 文件。如果您打算 安装 WebSphere Application Server - Express 的目录是空的，则表示安装过程除去了所有已安装的文件，并且 您可以删除空目录（如果您愿意的话）。
安装失败时应该执行的步骤：
本节包含有关在 Linux 上安装 WebSphere Application Server - Express 的信息。WebSphere Application Server - Express 的 主要组件包括 Application Server、远程代理控制器 和 WebSphere Studio Site Developer (WSSD)。可以 选择安装这三个组件中的其中之一，也可以选择全部安装这三个组件。如果您希望能够 使用 WSSD 来管理 Application Server，则需要与 Application Server 一起安装远程代理控制器。
可以从 CD-ROM 或者从您下载的电子映像来安装 WebSphere Application Server - Express。
安装说明：
可以采用交互式控制台方式运行安装程序，而不使用 GUI 向导面板。控制台方式可能更适合于具有易使用性需求的人士。“-accessibility”方式为具有视觉障碍的最终用户提供了附加的可听信息。要以控制台方式运行，请从 WebSphere Application Server - Express 安装 CD 的安装目录中运行此命令：
遵循提示完成安装。注意：“-is:javaconsole”选项至关重要。如果不指定此选项，安装程序将被挂起。“-log @NONE”将关闭记录以消除来自控制台的日志信息。如果在安装期间遇到任何问题，则您可能想除去此选项以便收集日志信息。
不要在先前版本上安装此版本。由于共存的原因，可以将它安装到另一个目录中，也可以先卸载先前版本，然后再将该版本安装到同一个目录中。如果安装程序检测到应用程序服务器的先前版本，就会向您提供将服务器配置迁移到 5.1 服务器的选项。有关更多详细信息，请参阅《迁移指南》。
有关将现有项目安全地从 Studio Site Developer 的先前版本迁移到版本 5.1.1 的指示信息，参阅《迁移指南》。
作为一项预防措施，建议先生成版本 4.0.x 和版本 5.0 的工作空间的备份副本，然后再迁移到版本 5.1.1。
要从产品 CD 安装 WebSphere Application Server - Express，请遵循下列步骤：
从命令窗口运行“setupLinux”如果命令窗口的当前工作目录是 /mnt/cdrom，您想要从 CD 安装，则当安装要求您插入第二张安装 CD 时，将不能够从驱动器弹出第一张 CD。会发生这种情况的原因是：命令窗口工作目录正指向 CD，因而 CD 驱动器好象在使用中。要避免此问题，确保不要将命令窗口的工作目录设置为 /mnt/cdrom。这表示不使用命令 ./setupLinux 来启动安装，而使用 CD 的完整路径： /mnt/cdrom/setupLinux。
从命令窗口运行“/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary”：
您可能会报告有关以下内容的错误：“找不到 mqver”和“找不到 wempsservice”。可以忽略这些错误消息。
在 Linux 上运行 Cloudscape
要在 Linux 上使用 Cloudscape，可使用在 /opt/IBM/WebSphere/Express51/Express/bin 目录中提供的 shell 脚本 EXPcview.sh。
安装此产品之前，请检查以下内容：
WebSphere Application Server - Express 的 Linux CD 的映像被分割成多个部分以缩小下载大小。每个部分都是磁带归档（tar）文件，并且所有部分都是必需的。
要安装 WebSphere Application Server - Express 的电子映像，请遵循下列步骤：
在安装 WebSphere Application Server - Express 之后，/opt/IBM/WebSphere/Express51 目录下面应该存在以下目录结构：
如果这些目录中的任何目录包含的文件数明显不同，则您应该怀疑在安装期间发生了问题。查看 /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt 文件以诊断问题。
首先查看 /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt 文件。转至底部并查看安装完成状态。如果安装成功完成，则通过运行 wasexpress51 或 /opt/IBM/WebSphere/Express51/SiteDeveloper/wasexpress51 来启动 Site Developer。一旦启动了 Site Developer，就遵循“欢迎”页面上的链接来装入和运行 Express 示例之一。
如果安装未成功完成，则查看 expressInstallLog.txt 文件以确定原因。
如果安装成功完成，则通过运行 /opt/IBMRAC/bin/RAStart.sh 来启动 IBM 代理控制器。如果您怀疑出现了问题，则查看 /opt/IBMRAC/config/servicelog.log 文件。
如果安装没有成功完成，则查看 racInstallLog.txt 以确定原因。
可以通过从“第一步”应用程序运行“验证服务器安装”来验证 Application Server 安装的基本操作。“第一步”是在安装结束时启动的，也可以从“开始”菜单启动它。
或者，可以通过运行 /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh 脚本来验证 Application Server 的操作。此脚本将使用其缺省配置来逐步启动和停止 Application Server。注意，此脚本只用于测试服务器安装。
如果希望将 WebSphere Application Server - Express 与您自已的产品捆绑到一起，则可以静默方式运行此安装程序。要以静默方式安装 WebSphere Application Server - Express，请 使用 -silent 命令行选项。在静默安装期间，在调用了安装命令之后将看不到向导面板。
要使用所有缺省值以静默方式运行安装，请使用类似如下的命令：
./setupLinux -silent
还可以使用响应文件为静默安装设置附加选项。查看安装 CD 上的响应文件示例以获取模板。要使用响应文件来运行静默安装，请使用类似如下的命令：
./setupLinux -silent -options <fully qualified path>/responsefile
注意：当选择 WebSphere Studio Site Developer 功能部件时，WebSphere Application Server - Express 不支持从 CD 的静默安装。原因是此功能部件需要第二张 CD，而安装程序在静默运行时不提示放置第二张 CD。要静默安装 WebSphere Studio Site Developer 功能部件，可以将第二张 CD 复制到硬盘，或者在另一个 CD 驱动器中安装该 CD，然后使用“-media 2=<path to second CD>”选项来告知安装程序在何处找到第二张 CD 映像。
Express 附带包括了样本响应文件，它的位置是 /util/responsefile.txt。可以将此文件用作模型响应文件。
IBM 代理控制器提供 Studio Site Developer 与 Application Server 之间的通信机制。
存在各种用来保护 Studio Site Developer 与代理控制器之间的链接的选项。安装将配置该链接以允许任何 Studio Site Developer 用户与代理控制器进行连接。在生产服务器环境中使用代理控制器时，您将想更改此安全性缺省值。
可以使用 /opt/IBMRAC/bin/RACSecurityOn.sh 和 RACSecurityOff.sh 脚本来启用和禁用基本登录安全性。 当启用了安全性时，Studio Site Developer 用户在连接至代理控制器时必须提供 有效的用户名和密码组合（这是操作系统的用户名和密码）。代理控制器将用户名和密码转发给操作系统以进行认证。
如果在已经有 WebSphere Application Server - Express 5.0 副本的机器上安装 WebSphere Application Server - Express 5.1，则 IBM 代理控制器将被更新为 5.1.1 版本且被配置为指向 5.1 Express 服务器。如果后来想要除去 WebSphere Application Server - Express 5.1 并恢复 5.0 环境，则需要重新安装 5.0 Application Server 或 Studio Site Developer 组件才能恢复 5.0 版本的 IBM 代理控制器。这两个 5.0 功能部件中的任何一个都会安装“IBM 代理控制器 5.0”。
警告：
如果想要在 Red Hat 8.0 上使用双字节字符集（DBCS），则需要执行下列步骤来将 GTK 升级到 2.2.2 或更高版本。下列指示信息用于 GTK 2.2.2。
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH
rpm -q libtiff-devel
如果没有安装，则从 Red Hat 安装 CD 安装它。
/usr/local/lib
./configure make make install /sbin/ldconfig
缺省情况下，将采用 GTK 2.0.6 安装。要确保应用程序使用 GTK 2.2.2，在启动应用程序前，每次都需要从命令行运行下列示例命令。
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH export PATH=/usr/local/bin/:$PATH /opt/IBM/WebSphereExpress/SiteDeveloper/wasexpress51
有关使用 GTK 的更多信息，请访问 Web 站点 developer.gnome.org/doc/API/2.2/gtk/gtk-building.html。
要在 Linux 上卸载 WebSphere Application Server - Express，请遵循下列步骤：
./uninstaller
要完全除去 WebSphere Application Server - Express，手工删除保留的目录。
本节讨论有关 WebSphere Application Server - Express for Linux 安装和卸载的已知问题和限制。有关影响产品实际使用的问题和限制的信息，请参阅自述文件。
如果安装失败：
安装故障偶尔会导致 _uninst 目录中的卸载文件不完整。此问题的症状是尝试运行卸载程序时显示一条消息，该消息指出找不到适当的 JVM。应按如下所示手工运行卸载程序：
本节包含有关在 AIX 上安装 WebSphere Application Server - Express 的信息。可以在 AIX 上安装的 主要 WebSphere Application Server - Express 组件 是 Application Server 和远程代理控制器。您可以选择安装这两个组件的其中之一，也可以同时 安装两个组件。如果您希望能够在 Windows 或 Linux 上使用 Studio Site Developer 来 管理 AIX 上的 Application Server，则需要与 Application Server 一起安装远程代理控制器。还可以 使用基于浏览器的“管理控制台”来管理 Application Server。
可以从 CD-ROM 或者从您下载的电子映像来安装 WebSphere Application Server - Express。
如果系统上有 WebSphere Application Server - Express 的先前副本，则应在继续进行安装之前将其卸载。
只有一个产品 CD 用于安装。要从产品 CD 安装 WebSphere Application Server - Express，请遵循下列步骤：
安装此产品之前，请检查以下内容：
WebSphere Application Server - Express 的 AIX CD 的映像被分割成多个部分以缩小下载大小。
每个部分都是磁带归档（tar）文件，并且所有部分都是必需的。要安装 WebSphere Application Server - Express 的电子映像，请遵循下列步骤：
在安装 WebSphere Application Server - Express 之后，/opt/IBM/WebSphere/Express51 目录下面应该存在以下目录结构：
如果这些目录中的任何目录包含的文件数明显不同，则您应该怀疑在安装期间发生了问题。查看 /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt 文件。
首先查看 /opt/IBM/WebSphere/Express51/logs/expressracInstallLog.txt 文件。转至底部并检查安装完成状态。如果安装 成功完成，则通过运行 /opt/IBMRAC/bin/RAStart.sh 来启动 IBM 代理控制器。如果您怀疑出现了问题，则查看 /opt/IBMRAC/config/servicelog.log 文件。
如果安装没有成功完成，则查看 racInstallLog.txt 以确定原因。
可以通过从“第一步”应用程序运行“验证服务器安装”来验证 Application Server 安装的基本操作。“第一步”是在安装结束时启动的，也可以通过运行 /opt/IBM/WebSphere/Express51/Express/bin/launchFirstSteps.sh 脚本来启动它。
或者，可以通过运行 /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh 脚本来验证 Application Server 的操作。此脚本将使用其缺省配置来逐步启动和停止 Application Server。注意，此脚本只用于测试服务器安装。
如果希望将 WebSphere Application Server Express 与您自已的产品捆绑到一起，则可以静默方式运行此安装程序。要以静默方式安装 WebSphere Application Server - Express，请使用 -silent 命令行选项。在静默安装期间，在调用安装命令之后将看不到向导面板。
要使用所有缺省值以静默方式运行安装，使用类似如下的命令：
./aix/setupAIX -silent
还可以使用响应文件为静默安装设置附加选项。请参阅安装 CD 上的响应文件示例以获取模板。要使用响应文件来运行静默安装，请使用类似如下的命令：
./aix/setupAIX -silent -options <fully qualified path>/responsefile
Express 附带包括了样本响应文件，它的位置是 /util/responsefile.text。可以将此文件用作模型响应文件。
IBM 代理控制器提供 Studio Site Developer 与 Application Server 之间的通信机制。
存在各种用来保护 Studio Site Developer 与代理控制器之间的链接的选项。安装将配置该链接以允许任何 Studio Site Developer 用户与代理控制器进行连接。在生产服务器环境中使用代理控制器时，您将想更改此安全性缺省值。
可以使用 /opt/IBMRAC/bin/RACSecurityOn.sh 和 RACSecurityOff.sh 脚本来启用和禁用基本登录安全性。当启用了安全性时，Studio Site Developer 用户在连接至代理控制器时必须提供 有效的用户名和密码组合（这是操作系统的用户名和密码）。代理控制器将用户名和密码转发给操作系统以进行认证。
要在 AIX 上卸载 WebSphere Application Server - Express，请执行下列步骤：
./uninstaller
本节讨论有关 WebSphere Application Server - Express for AIX 的安装和卸载的已知问题和限制。有关影响产品实际使用的问题和限制的信息，请参阅自述文件。
如果安装失败：
安装故障偶尔会导致 _uninst 目录中的卸载文件不完整。此问题的症状是尝试运行卸载程序时显示一条消息，该消息指出找不到适当的 JVM。应按如下所示手工运行卸载程序：
如果系统上有 WebSphere Application Server - Express 的先前副本，则应在继续进行安装之前将其卸载。
要从产品 CD 安装 WebSphere Application Server - Express，请遵循下列步骤：
安装说明：
如果从命令窗口运行命令“/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary”，则可能会报告有关以下内容的错误：“找不到 mqver”和“找不到 wempsservice”。可以忽略这些错误消息。
安装此产品之前，请检查以下内容：
WebSphere Application Server - Express 的 Solaris CD 的映像被分割成多个部分以缩小下载大小。每个部分都是磁带归档（tar）文件，并且所有部分都是必需的。
要安装 WebSphere Application Server - Express 的电子映像，请遵循下列步骤：
在安装 WebSphere Application Server - Express 之后，/opt/IBM/WebSphere/Express51 目录下面应该存在以下目录结构：
如果这些目录中的任何目录包含的文件数明显不同，则您应该怀疑在安装期间发生了问题。查看 /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt 文件。
如果想要将此产品与自已的产品捆绑到一起，则 WebSphere Application Server - Express 安装程序可以静默运行。要静默安装 WebSphere Application Server - Express，使用 -silent 命令行选项。在静默安装期间，在调用安装命令之后将看不到向导面板。
要使用所有缺省值以静默方式运行安装，使用类似如下的命令：
./solaris/setupSolaris -silent
还可以使用响应文件为静默安装设置附加选项。请参阅安装 CD 上的响应文件示例以获取模板。要使用响应文件来运行静默安装，请使用类似如下的命令：
./solaris/setupSolaris -silent -options <fully qualified path>/responsefile
要在 Solaris 上卸载 WebSphere Application Server - Express，请执行下列步骤：
./uninstaller
本节讨论有关 WebSphere Application Server - Express for Solaris 的安装和卸载的已知问题和限制。有关影响产品实际使用的问题和限制的信息，请参阅自述文件。
如果安装失败：
安装故障偶尔会导致 _uninst 目录中的卸载文件不完整。此问题的症状是尝试运行卸载程序时显示一条消息，该消息指出找不到适当的 JVM。应按如下所示手工运行卸载程序：
本节包含有关在 HP-UX 上安装 WebSphere Application Server - Express 的信息。只有 WebSphere Application Server - Express 的 Application Server 组件能在 HP-UX 上安装。使用基于浏览器的“管理控制台”在 HP-UX 上管理 Application Server。
可以从 CD-ROM 或者从您下载的电子映像来安装 WebSphere Application Server - Express。
如果系统上有 WebSphere Application Server - Express 的先前副本，则应在继续进行安装之前将其卸载。
要从产品 CD 安装 WebSphere Application Server - Express，请遵循下列步骤：
安装说明：
如果从命令窗口运行命令“/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary”，则可能会报告有关以下内容的错误：“找不到 mqver”和“找不到 wempsservice”。可以忽略这些错误消息。
安装此产品之前，请检查以下内容：
WebSphere Application Server - Express 的 HP/UX CD 的映像被分割成多个部分以缩小下载大小。每个部分都是磁带归档（tar）文件，并且所有部分都是必需的。
要安装 WebSphere Application Server - Express 的电子映像，请遵循下列步骤：
在安装 WebSphere Application Server - Express 之后，/opt/IBM/WebSphere/Express51 目录下面应该存在以下目录结构：
如果这些目录中的任何目录包含的文件数明显不同，则您应该怀疑在安装期间发生了问题。查看 /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt 文件。
可以通过从“第一步”应用程序运行“验证服务器安装”来验证 Application Server 安装的基本操作。“第一步”是在安装结束时启动的，也可以通过运行 /opt/IBM/WebSphere/Express51/Express/bin/launchFirstSteps.sh 脚本来启动它。
或者，可以通过运行 /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh 脚本来验证 Application Server 的操作。此脚本将使用其缺省配置来逐步启动和停止 Application Server。注意，此脚本只用于测试服务器安装。
如果希望将 WebSphere Application Server - Express 与您自已的产品捆绑到一起，则可以静默方式运行此安装程序。要以静默方式安装 WebSphere Application Server - Express，请 使用 -silent 命令行选项。在静默安装期间，在调用安装命令之后将看不到向导面板。
要使用所有缺省值以静默方式运行安装，请使用类似如下的命令：
./hpux/setupHPUX -silent
还可以使用响应文件为静默安装设置附加选项。查看安装 CD 上的响应文件示例以获取模板。要使用响应文件来运行静默安装，请使用类似如下的命令：
./hpux/setupHPUX -silent -options <fully qualified path/responsefile
要在 HP-UX 上卸载 WebSphere Application Server - Express，请执行下列步骤：
./uninstaller
本节讨论有关 WebSphere Application Server - Express for HP-UX 的安装和卸载的已知问题和限制。有关影响产品实际使用的问题和限制的信息，请参阅自述文件。
如果安装失败：
安装故障偶尔会导致 _uninst 目录中的卸载文件不完整。此问题的症状是尝试运行卸载程序时显示一条消息，该消息指出找不到适当的 JVM。应按如下所示手工运行卸载程序：
欢迎使用 WebSphere Application Server - Express 的 Web 服务器插件功能部件。
Web 服务器插件允许用户分隔 Web 服务器和 Express Application Server 以增强安全性和性能。这种分隔还使得 Web 站点的体系结构从总体上来说可以更为灵活。
这些插件通过 HTTP(S) 与 WebSphere Application Server - Express 通信。
Web 服务器插件安装包括在支持下列 Web 服务器的平台上自动配置这些服务器所需的所有组件。
| Apache Web Server |
|
| IMB HTTP Web Server |
|
| Microsoft Internet Information System (IIS) |
|
| iPlanet (Sun ONE) Web Server |
|
| Lotus Domino Web Server |
|
| WebSphere Application Server - Express |
注释 #1
|
注释：
| Apache Web Server |
|
| IMB HTTP Web Server |
|
| Microsoft Internet Information System (IIS) |
|
| iPlanet (Sun ONE) Web Server |
|
| Lotus Domino Web Server |
|
| WebSphere Application Server - Express |
请参阅下面的注释 #1
|
注释：
这是将要安装 Web 服务器插件文件和库的位置。如果机器上 已安装 WebSphere Application Server - Express，则缺省位置是 <ExpressInstallDir>/Plugins。
注意：安装目录就是安装了许可证文件、产品文件、JVM 和卸载程序的位置。在运行时需要的 Web 服务器插件文件安装在 <InstallDir>/../AppServer 中。
示例目录结构：
C:\
- Program Files
-IBM
-WebSphere
- Plugins
- AppServer
在单层环境（Web 服务器与 Express Application Server 安装在同一机器上）中，Web 服务器插件位于以下 WebSphere Application Server - Express 目录中：<ExpressInstallDir>/AppServer。这将提供 Web 服务器插件与 Express Application Server 的无缝集成。这将导致重新生成的 plugin-cfg.xml 的缺省目录与 Web 服务器被配置来使用的目录为同一位置。因此，在重新生成 plugin-cfg.xml 文件后，不必手工复制或移动该重新生成的文件。
这是运行 WebSphere Application Server - Express 的机器的主机名。收集此信息的目的是 将适当的值插入到插件配置文件（plugin-cfg.xml）中。缺省值是本地主机的主机名。如果 WebSphere Application Server - Express 在另一台机器上运行，则输入远程服务器的主机名。
对于选择安装的每个 Web 服务器插件，将提示您输入其配置文件的位置。该文件必须存在才能继续进行安装。
参阅小节 4.0『对 Web 服务器配置作了哪些更改』以获取详细信息。
参阅小节 4.0『对 Web 服务器配置作了哪些更改』以获取详细信息。
本节描述在安装期间对 Web 服务器配置文件作出的修改（作为可手工完成的任务）。这些步骤是由安装过程自动执行的，列示在此处以供参考。
修改包括添加对 Web 服务器插件库的引用和对 Web 服务器插件配置文件（plugin-cfg.xml）的位置的引用。
这些任务的步骤
将下列条目用作配置文件的模型。注意：<pluginsInstallRoot> 是 WebSphere Application Server - Express 插件的安装根目录。
LoadModule ibm_app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/ mod_ibm_app_server_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
注意：对于每个操作系统平台，安装根目录可以不同。例如，对于版本 5，AIX 安装根目录为 /opt/IBM/WebSphere/Express51/Plugins/。
LoadModule ibm_app_server_http_module <pluginsInstallRoot>\bin\ mod_ibm_app_server_http.dll WebSpherePluginConfig <pluginsInstallRoot>\config\cells\plugin-cfg.xml
将下列条目用作配置文件的模型。
LoadModule was_ap20_module/opt/IBM/WebSphere/Express51/Plugins/bin/mod_was_ap20_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/plugins/config/cells/plugin-cfg.xml
注意：对于每个操作系统平台，安装根目录可以不同。例如，对于版本 5，AIX 安装根目录为 /opt/IBM/WebSphere/Express51/Plugins/。
LoadModule was_ap20_module <pluginsInstallRoot>\bin\mod_was_ap20_http.dll WebSpherePluginConfig <pluginsInstallRoot>\config\cells\plugin-cfg.xml
注意：如果 IBM HTTP Server 1.3.26 伪指令 LoadModule ibm_app_server_http_module 出现在 IBM HTTP Server 2.0 httpd.conf 文件中，则 IBM HTTP Server 不能启动。必须注释掉或删除该伪指令才能启动版本 2 服务器。
将下列条目用作配置文件的模型。
LoadModule app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/ mod_app_server_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
大部分 Apache Web 服务器都不是使用扩展 API（EAPI）支持编译的。如果在使用 mod_app_server_http.so 插件模块启动 Web 服务器时看到类似如下的一条消息，则使用该模块的 EAPI 版本。
[Tue Jul 2 13:20:14 2002] [警告] 已装入的 DSO /opt/IBM/WebSphere/AppServer/bin/ mod_app_server_http.so 使用普通 Apache 1.3 API，此模块在 EAPI 下可能崩溃！ （请使用 -D EAPI 重新编译它）
要使用 EAPI 模块，将 httpd.conf 文件配置为指向 mod_app_server_http_eapi.so 而不是指向 mod_app_server_http.so：
LoadModule app_server_http_module/opt/IBM/WebSphere/Express51/Plugins/bin/ mod_app_server_http_eapi.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
注意：对于每个操作系统平台，安装根目录可以不同。例如，对于版本 5，AIX 安装根目录为 /opt/IBM/WebSphere/Express51/Plugins/。
LoadModule app_server_http_module <pluginsInstallRoot>\bin\ mod_app_server_http.dll WebSpherePluginConfig <pluginsInstallRoot>\config\cells\plugin-cfg.xml
大部分 Apache Web 服务器都不是使用扩展 API（EAPI）支持编译的。如果在使用 mod_app_server_http.so 插件模块启动 Web 服务器时看到类似如下的一条消息，则使用该模块的 EAPI 版本。
[Tue Jul 2 13:20:14 2002] [警告] 已装入的 DSO C:\WebSphere\AppServer\bin\ mod_app_server_http.so 使用普通 Apache 1.3 API，此模块在 EAPI 下可能崩溃！ （请使用 -D EAPI 重新编译它）
要使用 EAPI 模块，将 httpd.conf 文件配置为指向 mod_app_server_http_eapi.dll 而不是指向 mod_app_server_http.dll：
LoadModule app_server_http_module <pluginsInstallRoot>\bin\ mod_app_server_http_eapi.dll WebSpherePluginConfig <pluginsInstallRoot>\config\cells\plugin-cfg.xml
遵循此过程以使 HTTP 传输插件能够使用 Domino V5.05 或 5.06。安装向导不执行此修改。执行此手工过程。
注意：如果已经有指定的“Domino Web 服务器应用程序编程接口”（DSAPI）过滤器文件，则使用空格来对 WebSphere Application Server 插件文件定界。
将 WAS_HOME 环境变量设置为指向 WebSphere Application Server 安装根目录。
将变量 Plugin Config 添加至注册表的路径 HKEY_LOCAL_MACHINE > SOFTWARE > IBM > WebSphere Application Server > 5.1.0.0 下面。将此变量的值设置为 plugin-cfg.xml 文件的位置，即 <pluginsInstallRoot>\config\cells\plugin-cfg.xml。
其中 <pluginsInstallRoot> 是 WebSphere Application Server - Express 插件的安装根目录。
02/12/2001 03:05:09 PM JVM：Java 虚拟机已初始化 WebSphere Application Server DSAPI 过滤器已装入 02/12/2001 03:05:10 PM HTTP Web 服务器已启动
将下列条目用作配置文件的模型。
将下列伪指令包括在 obj.conf 文件中：
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib= "/opt/IBM/WebSphere/Express51/Plugins/bin/libns41_http.so" Init fn="as_init" bootstrap.properties= "/opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml" Service fn="as_handler"
注意：对于每个操作系统平台，安装根目录可以不同。例如，对于版本 5，AIX 安装根目录为 /opt/IBM/WebSphere/Express51/Plugins/。
将一个伪指令添加至 obj.conf 文件的 "<Object name=default>" 后面：
Service fn="as_handler"
将两个伪指令添加至 magnus.conf 文件的结尾：
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib= "/opt/IBM/WebSphere/Express51/Plugins/bin/libns41_http.so" Init fn="as_init" bootstrap.properties= "/opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml"
注意：对于每个操作系统平台，安装根目录可以不同。例如，对于版本 5，AIX 安装根目录为 /opt/IBM/WebSphere/Express51/Plugins/。
将下列伪指令包括在 obj.conf 文件中：
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib= "<pluginsInstallRoot>\bin\libns41_http.dll" Init fn="as_init" bootstrap.properties= " <pluginsInstallRoot>\config\cells\plugin-cfg.xml" Service fn="as_handler"
将一个伪指令添加至 obj.conf 文件的 "<Object name=default>" 后面：
Service fn="as_handler"
将两个伪指令添加至 magnus.conf 文件的结尾：
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib= "<pluginsInstallRoot>\bin\libns41_http.dll" Init fn="as_init" bootstrap.properties= " <pluginsInstallRoot>:\config\cells\plugin-cfg.xml"
遵循此过程以手工重现安装向导如何配置 Internet Service Manager（IIS）Web 服务器：
其中 <pluginsInstallRoot> 是 WebSphere Application Server - Express 插件的安装根目录。
在将应用程序部署至 WebSphere Application Server - Express 之后，需要重新生成 Web 服务器插件配置文件 plugin-cfg.xml。
对于 WebSphere Application Server - Express V5.1.0，使用 genPluginCfg 脚本来基于 WebSphere Express Application Server 的当前配置重新生成 plugin-cfg.xml 文件。
其中 <ExpressInstallDir> 是 WebSphere Application Server - Express 的安装根目录。
其中 <PluginInstallRoot> 是 WebSphere Application Server - Express 插件的安装根目录。
下列情况需要手工编辑 plugin-cfg.xml 文件：
<?xml version="1.0" encoding="ISO-8859-1" ?> <Config> <Log LogLevel="Error" Name="C:\Program Files\IBM\WebSphere\Express51\Plugins\logs\ http_plugin.log" /> <VirtualHostGroup Name="default_host"> <VirtualHost Name="*:7080" /> <VirtualHost Name="*:80" /> <VirtualHost Name="*:7443" /> </VirtualHostGroup> <ServerCluster Name="server1_DefaultNode_Cluster"> <Server Name="DefaultNode_server1"> <Transport Hostname="myHostname.raleigh.ibm.com" Port="7080" Protocol="http" /> <Transport Hostname="myHostname.raleigh.ibm.com" Port="7443" Protocol="https"> <Property name="keyring" value=" C:\Program Files\IBM\WebSphere\Express51\Plugins\etc\plugin-key.kdb" /> <Property name="stashfile" value=" C:\Program Files\IBM\WebSphere\Express51\Plugins\etc\plugin-key.sth" /> </Transport> </Server> <PrimaryServers> <Server Name="DefaultNode_server1" /> </PrimaryServers> </ServerCluster> <UriGroup Name="default_host_server1_DefaultNode_Cluster_URIs"> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/UTC/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name= "/CustomHomePageExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name= "/YourCoExpressExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name= "/CustomerServiceExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name= "/DocumentMgmtExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name= "/SurveyExample/*" /> </UriGroup> <Route ServerCluster="server1_DefaultNode_Cluster" UriGroup= "default_host_server1_DefaultNode_Cluster_URIs" VirtualHostGroup="default_host" /> </Config>
当 Web 服务器与 WebSphere Application Server - Express 安装在不同的机器上时，生成的 plugin-cfg.xml 文件必须移至位于 Web 服务器上的 <PluginsInstallRoot>/config/cells 目录。因此，在 plugin-cfg.xml 文件中引用的路径可能需要手工编辑。以后使用 genPluginCfg 脚本时将合并更新并保留对路径条目的手工更新。
示例：export SHLIB_PATH=/usr/lib:/lib
产品 CD-ROM 采用具有 Rockridge 扩展的 ISO-9660 格式。可能必须手工安装该 CD-ROM。安装或卸下 CD_ROM 需要 root 特权。
遵循在 HP-UX 上安装 CD_ROM 的下列指示信息
/usr/sbin/pfs_mountd &
/usr/sbin/pfsd &
<device_file> <mount_point> <filesystem_type> <translation_method>
示例： /dev/dsk/c0t0d0 /cdrom pfs-rrip ro,suid 0 0
/usr/sbin/pfs_mount /cdrom
/usr/sbin/pfs_umount /cdrom
示例： export WAS_HOME=/opt/IBM/WebSphere/Express51/Plugins
WebSphere Application Server - Express V5.1 包括一个名为 Snoop 的预先安装的应用程序，该应用程序可用来验证正确安装和配置了 Web 服务器插件。Web 服务器插件配置文件 plugin-cfg.xml（它是在安装 Web 服务器插件期间安装的）被预配置来测试 Snoop 应用程序。但是，您还是可以按此文档中所描述的那样重新生成 Web 服务器插件。
提示：在重新生成插件配置文件后，应重新启动 Web 服务器。
测试 Web 服务器插件的过程
http://yourHostName:7080
提示：如果 Web 服务器无法启动，则参阅本文档的『故障诊断提示』一节以了解如何解决该问题。
注意：不要指定 WebSphere Express Application Server 的内部传输端口 7080。Web 服务器插件将使用内部传输端口 7080 来充当“服务器”（即 WebSphere Express Application Server）的代理。以下 url 假定 Web 服务器在缺省 HTTP 端口 80 上进行侦听：
http://yourHostName
如果正确安装和配置了 Web 服务器插件，则 WebSphere Application Server 缺省应用程序 Web 页面将显示在浏览器中。
首先尝试此操作：Web 服务器在配置 Web 服务器插件后无法启动的最常见原因是 plugin-cfg.xml 文件包含无效的或不正确的信息，Web 服务器不能解析它。通常，该问题是由下列其中一种情况导致的：
如果 HTTP 插件组件（将请求从 HTTP Server，例如：IBM HTTP Server、Apache 或 IIS，发送至 Websphere Application Server - Express 的组件）存在问题，尝试执行下列步骤：
如果这些文件未揭示导致问题的原因，遵循下列附加步骤。
插件问题确定步骤
插件提供可读性很好的跟踪，这对帮助查明问题非常有用。通过将 config/plugin-cfg.xml 文件中的 LogLevel 属性设置为 Trace，就可跟踪请求的处理来了解是什么地方出了问题。在较高级别：
可通过对单个请求的跟踪非常清楚地了解此过程：
[Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: --------------------System Information-------------------- [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Bld date: Jul 3 2002, 15:35:09 [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Webserver: IIS [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Hostname = SWEETTJ05 [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: OS version 4.0, build 1381, 'Service Pack 6' [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: ---------------------------------------------------------------
ws_common: websphereGetStream：未能连接至应用程序服务器：OS err=%d
其中 %d 是特定于操作系统的与 connect() 调用失败的原因有关的错误代码。发生这种情况可能有各种原因。
重新生成 plugin-cfg.xml 文件可通过基于浏览器的“管理控制台”完成，或通过使用位于 <ExpressInstallDir>/AppServer/bin 中的 GenPluginCfg 脚本来完成。
用法：GenPluginCfg [[-option.name optionValue]...]
有效选项：
-config.root configroot_dir
（缺省为环境变量 CONFIG_ROOT）
-cell.name cell
（缺省为环境变量 WAS_CELL）
-node.name node
（缺省为环境变量 WAS_NODE）
-server.name server
（是生成单个服务器插件所必需的）
-output.file.name file_name
（缺省为 configroot_dir/plugin-cfg.xml）
-destination.root root
（配置将在其上使用的机器的安装根目录）
-destination.operating.system windows/unix
（配置将在其上使用的机器的操作系统）
-debug yes/no
（缺省为 no）
示例：
IBM HTTP Server
技术文章和样本代码
对文档的更新
除了联机帮助系统中包括的信息之外，有关 WebSphere Application Server - Express 的最新信息，请参阅下列 Web 站点：
本节描述如何安装 WebSphere Application Server - Express 的 Web 服务器安全性插件功能部件。应该从 WebSphere Application Server - Express V5.1.1 附带包括的 Web 服务器安全性插件 CD 安装 Web 服务器插件功能部件。
Web 服务器安全性插件允许用户将 Web 服务器机器与 Express 应用程序服务器机器分隔开以提高安全性和性能。这种分隔还使得 Web 站点的体系结构从总体上来说可以更为灵活。
这些安全性插件通过 HTTP(S) 与 WebSphere Application Server - Express 通信。
“Web 服务器”插件的安装包括所有必需的组件，这些组件将在支持平台上自动配置下列 Web 服务器。
Web 服务器安全性插件必须与 HTTP Web 服务器安装在同一台机器上。因此，在安装 HTTP Web 服务器插件之前，确保 HTTP Web 服务器已经安装在机器上。
有关下列主题的详细信息，请参阅 Web 服务器插件 CD 上的自述文件：
要从 CD 安装 HTTP Web 服务器安全性插件，请遵循下列步骤：
这是将要安装 Web 服务器插件文件和库的位置。如果机器上 已安装 WebSphere Application Server - Express，则缺省位置是 <ExpressInstallDir>/Plugins。
注意：安装目录就是安装了许可证文件、产品文件、JVM 和卸载程序的位置。在运行时需要的 Web 服务器插件文件安装在 <InstallDir>/../AppServer 中。
示例目录结构：
C:\ Program File\IBM\WebSphere\Plugins
C:\ Program File\IBM\WebSphere\Appserver
在单层环境（Web 服务器与 Express Application Server 安装在同一机器上）中，Web 服务器插件位于以下 WebSphere Application Server - Express 目录中：<ExpressInstallDir>/AppServer。这将提供 Web 服务器插件与 Express Application Server 的无缝集成。这将导致重新生成的 plugin-cfg.xml 的缺省目录与 Web 服务器被配置来使用的目录为同一位置。因此，在重新生成 plugin-cfg.xml 文件后，不必手工复制或移动该重新生成的文件。
这是 运行 WebSphere Application Server - Express 的机器的主机名。收集此信息的目的是 将适当的值插入到插件配置文件（plugin-cfg.xml）中。缺省值是本地主机的主机名。如果 WebSphere Application Server - Express 在另一台机器上运行，则输入远程服务器的主机名。
对于您选择安装的每个 Web 服务器插件，将提示您输入它的 配置文件的位置。该文件必须存在才能继续进行安装。
如果希望将 WebSphere Application Server - Express 插件与您自已的产品捆绑到一起，则可以静默方式运行此安装程序。要以静默方式安装 WebSphere Application Server - Express 插件，请 使用 -silent 命令行选项。在静默安装期间，在调用安装命令之后将看不到向导面板。
应该使用响应文件为静默安装设置适当的选项。请参阅安装 CD 上的响应文件示例以获取模板。要使用响应文件来运行静默安装，使用类似如下的命令：
对于 Windows：
install.exe -silent -options <fully qualified path>/responsefile
对于 Linux 和 Unix：
linux/setupLinux -silent -options <fully qualified path>/responsefile
Unix 平台的一些示例：
WebSphere Application Server - Express V5.1 包括一个名为 Snoop 的预先安装的应用程序，该应用程序可用来验证正确安装和配置了 Web 服务器插件。Web 服务器插件配置文件 plugin-cfg.xml（它是在安装 Web 服务器插件期间安装的）被预配置来测试 Snoop 应用程序。但是，您还是可以按此文档中所描述的那样重新生成 Web 服务器插件。
提示：在重新生成插件配置文件后，应重新启动 Web 服务器。
测试 Web 服务器插件的过程
http://yourHostName:7080
提示：如果 Web 服务器无法启动，则参阅本文档的『故障诊断提示』一节以了解如何解决该问题。
注意：不要指定 WebSphere Express Application Server 的内部传输端口 7080。Web 服务器插件将使用内部传输端口 7080 来充当“服务器”（即 WebSphere Express Application Server）的代理。以下 url 假定 Web 服务器在缺省 HTTP 端口 80 上进行侦听：
http://yourHostName
如果正确安装和配置了 Web 服务器插件，则 WebSphere Application Server 缺省应用程序 Web 页面将显示在浏览器中。
要卸载 WebSphere Application Server - Express 的 HTTP Web 服务器安全性插件，请遵循下列步骤：
要在 Linux 和 Unix 平台上卸载 WebSphere Application Server - Express 的 HTTP Web 服务器插件，请遵循下列步骤：
./uninstaller
缺省情况下，“并发版本控制系统”（CVS）插件是随 WebSphere Application Server - Express 一起自动安装的。可从 www.cvshome.org 获取 CVS 服务器的最新版本。不需要安装 CVS 客户机来使用 CVS，只需要 CVS 服务器。 有关安装和使用 CVS 的更多信息，请参阅小组联机帮助。同时，在 www.ibm.com/websphere/developer/library/ techarticles/0108_karasiuk/0108_karasiuk.html 中有一篇文章，介绍了 WebSphere Application Server - Express 中的 CVS 小组支持。
如果不使用 CVS，则可以使用 Rational(R) ClearCase(R) 作为软件配置管理（SCM）系统。有关 Rational ClearCase 的更多信息，参阅 www.ibm.com/software/awdtools/clearcase/
CVS 服务器和 Rational ClearCase 客户机或服务器都不是自动安装的。必须与 WebSphere Studio 分开来安装它们。
其它几个 SCM 资源库可以通过 SCM 小组适配器（在 Eclipse 中称为小组提供程序）与 WebSphere Application Server - Express 集成。要查找“IBM 业务合作伙伴”提供的 SCM 产品和适配器列表，请访问 www-3.ibm.com/software/awdtools/studioappdev/about/ 并从 Further reading 部分选择 SCM Adaptor Vendors。从此列表中，可以访问 SCM 产品供应商的 Web 站点来下载所选的 SCM 适配器。IBM 不保证或担保这些适配器。有关支持或进一步的信息，请直接与 SCM 产品供应商联系。
Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
本信息是为在美国提供的产品和服务编写的。IBM 可能在其它国家或地区不提供本文档中讨论的产品、服务或功能特性。有关您当前所在区域的产品和服务的信息，请向您当地的 IBM 代表咨询。任何对 IBM 产品、程序或服务的引用并非意在明示或暗示只能使用 IBM 的产品、程序或服务。只要不侵犯 IBM 的知识产权，任何同等功能的产品、程序或服务，都可以代替 IBM 产品、程序或服务。但是，评估和验证任何非 IBM 产品、程序或服务，则由用户自行负责。
IBM 公司可能已拥有或正在申请与本文档内容有关的各项专利。提供本文档并未授予用户使用这些专利的任何许可证。您可以用书面方式将许可证查询寄往：
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
有关双字节（DBCS）信息的许可证查询，请与您所在国家或地区的 IBM 知识产权部门联系，或用书面方式将查询寄往：
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
IBM 可以按它认为适当的任何方式使用或分发您所提供的任何信息而无须对您承担任何责任。
本条款不适用英国或任何这样的条款与当地法律不一致的国家或地区：国际商业机器公司以“按现状”的基础提供本出版物，不附有任何形式的（无论是明示的，还是默示的）保证，包括（但不限于）对非侵权性、适销性和适用于某特定用途的默示保证。某些国家或地区在某些交易中不允许免除明示或默示的保证，因此本条款可能不适用于您。
本信息中可能包含技术方面不够准确的地方或印刷错误。此处的信息将定期更改；这些更改将编入本资料的新版本中。IBM 可以随时对本资料中描述的产品和／或程序进行改进和／或更改，而不另行通知。
本程序的被许可方如果要了解有关程序的信息以达到如下目的：（i）允许在独立创建的程序和其它程序（包括本程序）之间进行信息交换，以及（ii）允许对已经交换的信息进行相互使用，请与下列地址联系：
Lab Director
IBM Canada Ltd. Laboratory
8200 Warden Avenue
Markham, Ontario, Canada L6G 1C7
只要遵守适当的条件和条款，包括某些情形下的一定数量的付费，都可获得这方面的信息。
本资料中描述的许可程序及其所有可用的许可资料均由 IBM 依据 IBM 客户协议、IBM 国际程序许可证协议或任何同等协议中的条款提供。
涉及非 IBM 产品的信息可从这些产品的供应商、其出版说明或其它可公开获得的资料中获取。IBM 没有对这些产品进行测试，也无法确认其性能的精确性、兼容性或任何其它关于非 IBM 产品的声明。有关非 IBM 产品性能的问题应当向这些产品的供应商提出。
本信息中对非 IBM Web 站点的任何引用都只是为了方便起见才提供的，不以任何方式充当对那些 Web 站点的保证。那些 Web 站点中的资料不是 IBM 产品资料的一部分，使用那些 Web 站点带来的风险将由您自行承担。
本信息包含在日常业务经营中使用的数据和报告的示例。为了尽可能完整地说明这些示例，这些示例中可能会包括个人、公司、品牌和产品的名称。所有这些名称都是虚构的，如与实际商业企业所使用的名称和地址有任何雷同，纯属巧合。
版权许可：
本信息包括源语言形式的样本应用程序，这些样本说明不同操作平台上的编程方法。如果是为按照在编写样本程序的操作平台上的应用程序编程接口（API）进行应用程序的开发、使用、经销或分发为目的，您可以任何形式对这些样本程序进行复制、修改、分发，而无须向 IBM 付费。这些示例并未在所有条件下作全面测试。因此，IBM 不能担保或暗示这些程序的可靠性、可维护性或功能。用户如果是为了按照 IBM 应用程序编程接口开发、使用、经销或分发应用程序，则可以任何形式复制、修改和分发这些样本程序，而无须向 IBM 付费。
凡这些样本程序的每份拷贝或其任何部分或任何衍生产品，都必须包括如下版权声明：
(C)（贵公司的名称）（年）。此部分代码是根据 IBM 公司的样本程序衍生出来的。
(C) Copyright IBM Corp. 2000, 2003. All rights reserved.
编程接口信息用来帮助您使用此程序来创建应用软件。
通用编程接口允许您编写获取此程序工具的服务的应用软件。
然而，本信息还可能包含诊断、修改和调整信息。诊断、修改和调整信息用来帮助您调试应用软件。
警告：不要将此诊断、修改和调整信息用作编程接口，因为它是会更改的。
下列各项是国际商业机器公司在美国和／或其它国家或地区的商标或注册商标：
Java 和所有基于 Java 的商标和徽标是 Sun Microsystems,Inc. 在美国和／或其它国家或地区的商标或注册商标。
ActiveX、Microsoft、Windows、Windows NT 和 Windows 徽标是 Microsoft Corporation 在美国和／或其它国家或地区的商标或注册商标。
UNIX 是 The Open Group 的注册商标。
其它公司、产品或服务名称（可能用双星号（**）表示）可能是其它公司的商标或服务标记。
(C) Copyright IBM Corporation 2000, 2003. All Rights Reserved.