WAS5的安装及其常见问题

本文试着通过介绍WebSphere应用服务器5基础版的安装过程及其注意事项，来使更多用户能够顺利地安装上她，从而扫除使用WebSphere应用服务器的第一道障碍。
WebSphere应用服务器5版本（包括5.0.x和5.1）的安装相对于她以前版本，可以说是简化了很多。其中最为明显的一点就是我们不再需要事先安装一个数据库来存放应用服务器的管理配置信息。即便如此，还是有相当一部分用户在安装WebSphere应用服务器时忽略了一些问题。我们在实际工作中发现，有一些应用服务器在运行中存在的问题其实际根源在于安装时犯下的错误。本文试着通过介绍WebSphere应用服务器5基础版的安装过程及其注意事项，来使更多用户能够顺利地安装上她，从而扫除使用WebSphere应用服务器的第一道障碍。

您的环境符合要求吗？


WebSphere应用服务器能否顺利安装成功首先取决于目标平台是否满足她安装的条件，包括系统的软件条件和硬件条件。比如，WebSphere应用服务器5.0x在Windows 2000服务器上安装需要SP3，而WebSphere应用服务器5.1版本在Windows 2000服务器则需要打上SP4。虽说WebSphere应用服务器的安装程序在安装的时候能够检测系统的环境，但是最好的办法还是在安装之前首先确认一下环境。

安装前的准备


除了上面基本的软硬件条件之外，安装WebSphere应用服务器之前还要确认环境的几个配置问题。

1． 一般地，WebSphere应用服务器需要您作为 root 用户（Unix/Linux系统）或 Administrator 组（Windows系统）的一部分进行安装。

2． 磁盘空间的分配

在考虑硬盘空间分配的时候要周全一些，尤其是在一些不能动态分配磁盘空间的系统（比如Solaris）上。如果是在生产环境上安装WebSphere应用服务器，一般要从以下几个方面来计算要预留的空间。

WebSphere应用服务器自身代码的占用空间。这个空间一般在400M左右，在不同的系统平台上略有差异。
如果WebSphere的部署管理器（Deployment Manager）也安装在同一台服务器上，则还要加上300M左右的空间。
如果WEB服务器也安装在同一台服务器上，则要算上它的空间。WebSphere应用服务器中带IBM HTTP服务器一般占用50M左右的空间。
用户发布到WebSphere应用服务器上所有应用程序的占用空间。这个大小与实际应用相关，而且不同应用可以差别很大。
系统日志的占用空间。这里日志主要是指WebSphere应用服务器的日志。如果有WEB服务器则还要考虑WEB服务器的日志空间。日志空间的估算要结合系统对日志的配置情况。如果日志配置没有设置好，多大的空间都有可能耗尽。我们在实际项目中就遇到有客户没有关闭WEB服务器的访问日志，因而导致几天之内WEB服务器就生成一个超过1G的日志文件。这么大的日志文件，不但耗费空间，而且影响性能。WebSphere应用服务器可以设置日志文件的大小和保存的文件数量，从而可以估算出其需要空间。
一些备份文件需要的空间。WebSphere应用服务器提供了一个备份命令（backupConfig.bat/sh），用来备份应用服务器的配置及其上应用。我们建议在系统稳定之后及时备份。对于一个典型生产系统，WebSphere应用服务器这个配置文件经常超过100M，而对于网络部署版，我们在实际项目中遇到过700多兆的备份文件。不过这个文件不一定要放在应用服务器的安装目录（如UNIX上的/opt或/usr），而且您也可以及时把它们备份到别的地方。
系统出错时日志，如core文件占用的空间。
安装程序还需要在系统的临时目录中有100M以上的空闲空间。/var目录需要有50M以上空闲空间。
3． 端口有没有冲突？

WebSphere应用服务器缺省占用的端口包括：管理控制台端口9090，管理控制台安全端口9043，HTTP传输端口9080，HTTPS传输端口9443，SOAP通信端口8880（在网络部署版这个端口是8879）等。如果系统中已有应用占用了这些端口，那么应用服务器启动的时候就会报告端口冲突的错误。一般我们可以用netstat命令来查看系统端口的使用情况。

4． 服务器的主机名

根据实际经验，我们推荐用户在安装WebSphere应用服务器之前配置主机名。可以通过hostname命令来查看当前系统的主机名。如果没有配置，则到hosts文件中添加相应的条目。

5． 用户名和用户组的建立

WebSphere应用服务器中内置了一个基于WebSphere MQ的JMS服务器。在UNIX/LINUX平台上安装的时候，如果选择了完全安装或在定制安装的时候选择了安装"嵌入式消息传递"，那么就要在安装开始前先创建两个用户组mqm和mqbrkrs和一个用户mqm。而且需要将用户mqm和root添加到mqm组，还要将root添加到mqbrkrs组。

6． 如果目标安装平台是Solaris，而且选择安装"嵌入式消息传递"，那么我们需要对Solaris系统的内核参数进行修改。具体操作可以参考如下：可以通过编辑系统配置文件（命令为vi /etc/system），将WebSphere应用服务器在Solaris下需要配置的系统参数写入，然后保存退出。编辑配置文件添加的系统参数如下：



*added for websphere
set shmsys:shminfo_shmmax = 4294967295
set shmsys:shminfo_shmseg = 1024
set shmsys:shminfo_shmmni = 1024
set semsys:seminfo_semaem = 16384
set semsys:seminfo_semmni = 1024
set semsys:seminfo_semmap = 1026
set semsys:seminfo_semmns = 16384
set semsys:seminfo_semmsl = 100
set semsys:seminfo_semopm = 100
set semsys:seminfo_semmnu = 2048
set semsys:seminfo_semume = 256
set msgsys:msginfo_msgmap = 1026
set msgsys:msginfo_msgmax = 65535
set rlim_fd_cur=1024

   



由于更新了系统配置文件，所在安装WebSphere应用服务器之前需要重启Solaris服务器。这里要注意一点，那就是如果系统中还有其他软件要求更改同一个内核参数，那么一般就保留值大的那一个配置。

7． 如果目标安装平台是HP-UX，那么在安装WebSphere应用服务器之前，我们也需要对系统的内核参数进行修改。具体修改方法和参数值请参考安装介质上/docs目录下的安装向导（InstallGuide.pdf）文件。如果在HP-UX平台上选择安装"嵌入式消息传递"，那么我们还需要修改下面几个参数：



sema = 1
semaem = 16384
semmns = 16384
semvmx = 32767
shmem = 1

   



有时候没有修改这些参数也能够把WebSphere应用服务器安装上，并且安装完之后能够正常启动和运行。但是，运行一段时间之后，尤其在生产系统上就会由于参数设置不对（主要是缺省值太小）而产生各种问题。因此，建议事先修改好系统的核心参数。

8． 语言环境的设置

WebSphere应用服务器在国内的版本都是支持多种语言的，包括英文，简体/繁体中文等。因此在安装过程中即使选择了英文（实际上是选择了英文的安装界面），WebSphere应用服务器和用户的应用程序还是可以正常显示中文。但是，根据我们经验，在安装之前最好还是把LANG设成中文（在UNIX/LINUX平台上），而不要安装前是en_US，然后等到安装完了之后再切换成中文。我们在实际项目中遇到过由于这样的切换而导致系统的不稳定。


安装的基本步骤


使用图形化安装向导来安装WebSphere应用服务器的基本步骤如下：

1． 启动安装
常见的安装方法是执行LaunchPad.bat/sh，然后在启动板工具上单击安装此产品，就可以启动相应平台的图形化安装向导。WebSphere应用服务器的图形化安装界面是由JAVA语言写的，因此不同平台上的安装界面基本相同。实际上点击安装WebSphere应用服务器等同于直接执行同一目录下的install.bat/install文件。

2． 为向导的界面选择一种语言，并单击下一步。 安装向导打开，并出现欢迎页面。（注：在某些UNIX/LINUX平台上，由于某种原因缺乏中文字体，那么可以选英文界面安装而不会影响应用服务器的使用。）

3． 选择安装类型，并单击下一步。 您可选择安装所有功能部件的完全安装类型，或定制安装类型。定制安装类型允许您选择要安装的功能部件。完全安装一般包括：WebSphere应用服务器，IBM HTTP服务器及其插件，嵌入式消息传递的客户端和服务器端，应用服务器管理控制台，应用服务器例子等。具体内容可以通过下面方法了解：进入定制安装的界面，缺省选中的安装项目即是完全安装的内容。在安装生产环境的时候，我们一般选则定制安装类型，因为这样我们可以避免安装不需要的项目以节省资源。

下面是在定制安装中常见的考虑问题。

要在开发或生产环境中获得较好的性能，建议您不要安装样本。通过省略样本，您可加快 60％ 的应用程序服务器启动时间，并节省 15％ 的磁盘空间和安装时间（您会发现安装样本程序占用了很大一部分安装时间）。但是这里有一点要特别注意，在您取消样本选框的时候应用服务器的管理控制台也会被取消，因此不要忘了再把管理控制台重新选上，否则应用服务器的管理控制台由于没有安装而无法登陆。
如果您的应用程序不使用 JMS 消息传递，建议您不要安装嵌入式消息传递。通过不安装嵌入式消息传递功能部件，您可节省大约 36M的消息排队进程内存。而且，您可潜在地提高另外百分之 5 的应用程序启动时间。如果您选择嵌入式消息传递功能部件，而且缺少先决条件，则安装向导在下一步将显示 mq_prereq.log 错误日志，并将您带回安装类型界面。这里有可能是您没有建立相应的用户组和用户名，也有可能是内核参数没有修改。
如果您计划在另外一台服务器上安装WEB服务器，那么您就不必选IBM HTTP服务器及其相应的插件。当然，在WEB服务器上您需要同样选择定制安装WebSphere应用服务器，并且选中IBM HTTP服务器及其相应的插件来安装它们。如果已安装有WebSphere应用服务器支持的其他WEB服务器软件，那么只需要选择相应的WEB服务器插件即可。
完成选择之后按确定，安装程序自动检测系统环境，如果环境不符合要求将自动回到安装类型选择页面。

4． 指定目的地目录。单击下一步，以继续。如果您正在安装WebSphere应用服务器以及 IBM HTTP 服务器和嵌入式消息传递功能部件，则指定它们的目标目录。在 UNIX 和 Linux 平台上，您不能更改嵌入式消息传递功能部件的缺省安装目录。另外，一般不要用带汉字的目录或带空格的目录。

5． 指定节点信息，并单击下一步。缺省的节点名是服务器的主机名，但是您可指定任何唯一的名称。一般不需要更改，因为用服务器的主机名即可。主机名是安装节点的物理机器的网络名。它必须解析到服务器上的物理网络节点。您用于主机名的值可以是全限定 DNS 主机名、短主机名，或甚至是数字 IP 地址。如果您使用 DHCP或者如果您经常更改 IP 地址，那么我们推荐用主机名。

6． 复查摘要信息，并单击下一步安装产品代码，或单击上一步更改您的规范。

7． 单击下一步注册产品，或取消选择复选框并单击下一步以稍候注册。

8． 安装向导启动"第一步"工具。（注：退出"第一步"工具后，可以重新用firstSteps.bat/sh命令启动。但是在5.0x版本，这个命令在WebSphere应用服务器bin目录下面。在5.1版本，这个命令在firststeps目录下面。）

9． 单击完成，以关闭安装向导。


安装检验


当用安装向导完成WebSphere应用服务器之后，我们可以采用下面的几种方法来检验安装是否成功。

在"第一步"窗口点击"安装检验"。安装检验程序就会自动启动WebSphere应用服务器，并测试各种应用服务器功能，如Servlet, EJB等。检验的结果会在窗口中显示出来。这里要注意，安装检验成功完成之后，WebSphere应用服务器是处于运行状态下的。
如果已经从"第一步"窗口退出了，您也可以通过运行WebSphere应用服务器bin目录下的ivt.bat/sh命令来进行安装检验，这个ivt就是Installation Verification Test。
一般还可以通过手动启动WebSphere应用服务器，然后通过访问管理控制台和缺省例子应用程序来测试应用服务器的安装是否成功。具体操作方法如下：

1． 首先用命令行启动WebSphere应用服务器。进入到WebSphere应用服务的bin目录下，执行startServer server1或./startServer.sh server1。其中server1为缺省的WebSphere应用服务器实例。

2． 然后通过下面URL来访问几个缺省例子应用。http://hostname:9080/snoop, http://hostname:9080/hitcount。

3． 也可以通过http://hostname:9090/admin来访问WebSphere应用服务器的管理控制台。如果成功返回结果，一般情况下说明系统安装成功。

还有一种方法是查看安装日志文件。WebSphere应用服务器的安装日志文件有多个，分别存放在其安装路径下的logs目录下面。WebSphere应用服务器的安装日志文件名称为log.txt。IBM HTTP服务器的安装日志文件名为his_log.txt。嵌入式消息传递的安装日志文件名为mq_install.log。管理控制台的安装日志文件名为installAdminConsole.log等等。

常见问题讨论


1． 在启动WebSphere应用服务器的时候报告端口冲突。
最常见的情况是已有一个应用服务器实例在运行了。这样的话，要么只启动一个实例，要么更改一个实例的端口号。还有一个常见的问题是在AIX 5L环境上报9090端口冲突。其原因是在AIX 5L中缺省会有一个wsmservr启动，并占用9090端口。因此在启动或安装WebSphere应用服务器前，要确认系统wsmserver没有启动。如果这个服务已经启动，我们用下面命令停止wsmserver服务：/usr/websm/bin/wsmserver -disable。如果说需要保留这个占用9090端口的服务，那么我们只能通过更改应用服务器的管理控制台应用的端口。由于控制台本身的端口被占用了，因此我们不能通过控制台来操作，而只能直接修改配置文件。这里我们要修改两个文件。一个是virtualhosts.xml文件，它的路径为WebSphere应用服务器安装目录/config/cells/单元名/。把其中的9090端口改成没有冲突的端口，比如9091。另一个要更改的文件是server.xml，它的路径为WebSphere应用服务器安装目录/config/cells/单元名/nodes/节点名/servers/server1。同样把其中的9090端口更改成9091。注意两个文件的更改需要一致。

2． 在一LINUX平台上安装WebSphere应用服务器5.0。两个用户组mqm和mqbrkrs和一个用户mqm都已经建立了，而且也将用户mqm和root添加到mqm组，将root添加到mqbrkrs组了。但是选择了安装嵌入式消息传递之后，安装程序还是报告用户名和用户组不存在。这个问题出现的原因是在一些LINUX/UNIX中，把root添加到组之后需要重新登陆才能生效。因此，如果碰到这样的情况，您只需要重新登陆一次，然后再进行正常安装即可。

3． 下面是我们一个实际客户向我们咨询的一个问题。他们说WebSphere应用服务器安装完了之后不能正常启动和停止。以下是stopServer.log中的一段异常信息。

[2/17/04 15:30:22:402 CST] 209b5255 WsServerStop 
E ADMU3002E: Exception attempting to process server server1
[2/17/04 15:30:22:403 CST] 209b5255 WsServerStop 
E ADMU3007E: Exception com.ibm.websphere.management.exception.ConnectorException:
ADMC0016E: Could not create SOAP Connector to connect to host localhost.localdomain at port 8880
[2/17/04 15:30:22:410 CST] 209b5255 WsServerStop 
A ADMU3007E: Exception com.ibm.websphere.management.exception.ConnectorException:
ADMC0016E: Could not create SOAP Connector to connect to host localhost.localdomain at port 8880
at com.ibm.websphere.management.AdminClientFactory.createAdminClient(AdminClientFactory.java:354)
at com.ibm.ws.management.tools.LaunchUtils.getAdminClient(LaunchUtils.java:347)
at com.ibm.ws.management.tools.LaunchUtils.getAdminClient(LaunchUtils.java:287)

       




根据这段异常我觉得是他们没有正确设置主机名的缘故。我叫他们在/etc/hosts中加入相应的主机名后（客户环境为Linux），结果一切正常。下面是他们修改前后的内容对比。

修改前：



127.0.0.1  localhost.localdomain localhost  theirhostname

   



修改后：



127.0.0.1     localhost.localdomain localhost
192.168.131.2  theirhostname

   


（注：这里theirhostname为客户实际设置的主机名。）
4． 下面是我们在一次给客户培训WebSphere应用服务器的安装和管理的过程中遇到的一个问题。当时需要需在红旗Linux DC Server 4.0上安装WAS 5.0。一共有十几台PC服务器，其中有一台遇到问题。其现象是：一是在安装过程中，在应该缺省出现节点名的地方是空的，只能自己定义一个节点名。二是在安装完后不能启动应用服务器。SystemOut.log报初始化成功，但是JMX的连接出错。开始我怀疑没有设置HostName，但是用hostname命令查看发现系统的HostName也设置了。但是后来我发现/etc/hosts文件中没有此主机名的定义。在hosts中加入此主机名的定义后，WebSphere应用服务器启动正常。

5． 当LINUX/UNIX的图形化界面暂时无法工作或者我们安装多个相同配置的服务器的时候，我们还可以选择静默安装（silent installation），即安装过程中不需要人机交互的安装方式。静默安装要使用 -options responsefile 参数，此参数导致安装向导从选项响应文件读取您的响应，而不是从交互式图形化界面读取。您必须在静默安装之前定制响应文件（response file）。在定制文件后，您必须用install命令，以进行静默安装。一般命令格式如下：install -options responsefile.txt。WebSphere应用服务器的安装介质上提供了一个响应文件的例子，用户可以在这个例子的基础上更改符合自己平台和安装要求的响应文件。常见的更改内容实际上就是我们在前面基于图形化安装向导安装时输入的哪些内容。

6． WebSphere应用服务器5.0x的Windows版本在Windows 2003服务器上安装失败。这个问题的出现主要是因为版本问题。由于WebSphere应用服务器5.0.x先于Windows 2003服务器面世，并且由于Windows 2003服务器本身的兼容性问题，因此WebSphere应用服务器5.0.x有一个专门针对Windows 2003服务器平台的版本。对于目前WebSphere应用服务器5.1版本，这个问题已不复存在。5.1版的Windows版本可以在Windows NT, Windows 2000服务器及Windows 2003服务器等平台上运行。


结束语


在安装WebSphere应用服务器的时候，了解目标环境的软硬件情况非常重要。只有首先确认目标环境符合WebSphere应用服务器的安装条件，安装完的系统才能正常稳定地运行。即使在WebSphere应用服务器出现问题之后去寻找IBM的售后技术支持，他们一般也会首先检查用户系统的环境。良好的开端是成功一半，让我们从安装开始我们的WebSphere应用服务器之旅。想了解更多的WebSphere应用服务器的资料，请参考相关的IBM红皮书和WebSphere应用服务器的信息中心（infocenter）。