WebSphere6.1安装部署手册.doc

WebSphere6.1安装部署手册1 安装说明Websphere下载地址：/ibmdl/pub/software/tw/trials/downloads/was_cd_6103_trial_express_windows_ia32.zipWebsphere更新程序下载地址：/software/websphere/appserv/support/tools/UpdateInstaller/7.0.x/WinIA32/-WS-UPDI-WinIA32.zipWebsphere更新文件下载地址：/software/websphere/appserv/support/fixpacks/was61/cumulative/cf61037/WinX32/6.1.0-WS-WAS-WinX32-FP0000037.pak/software/websphere/appserv/support/fixpacks/was61/cumulative/cf61037/WinX32/6.1.0-WS-WASSDK-WinX32-FP0000037.pak本手册不包括集群安装方式。本手册也适合WebSphere7.0的安装和部署。表示： Windows：C:Program FilesIBMWebSphereAppServerUnix/Linux：/opt/IBM/WebSphere/AppServer2 安装WebSphere1、 准备安装程序Windows：was.cd.6100.wasdev.nocharge.windows.ia32.zipLinux：was.cd.6100.wasdev.nocharge.windows.ia32.tar.gz2、 检查环境如果是第一次安装，则跳过此步骤；如果是升级到新版本，则请参考第4章先将旧版本的WebSphere进行卸载后再安装新版本。3、 解压缩Windows：使用解压缩软件将was.cd.6100.wasdev.nocharge.windows.ia32.zip解压到某个磁盘的was61目录，was61所在路径不要包含有中文字符，例如：d:was61。Unix/Linux：使用命令mkdir was61在系统的某个暂时目录创建was61文件夹，例如：/soft/was61。将 was.cd.6100.wasdev.nocharge.windows.ia32.tar.gz拷贝到/soft/was61目录下，并输入命令进行解压缩：gunzip was.cd.6100.wasdev.nocharge.windows.ia32.tar.gz | tar xvf解压缩后的was61目录如下：4、 安装Windows：双击d:was61WASinstall.exe运行安装程序Unix/Linux：在/soft/was61/WAS/目录下执行命令./install根据安装向导的指示安装WebSphere。在欢迎界面点击下一步：接受协议并点击下一步：确认通过安装WebSphere的必要检测，然后点击下一步：如果需要安装示例程序则选中“安装样本应用程序”的复选框，点击下一步：输入WebSphere的安装目录，点击下一步：Unix：/usr/IBM/WebSphere/AppServerLinux：/opt/IBM/WebSphere/AppServer如果是WebSphere是Network Deployment版本的，可能还有下面的选择步骤，这时选择Application Server，然后点击下一步：如果选择了None，则在安装完成后不会创建默认的概要文件，需要使用重新运行“概要文件管理工具”来创建新的概要。输入管理控制台的用户名和密码，点击下一步：该用户名和密码用于登录控制台以及停止WebSphere服务。确认安装信息无误后，点击下一步开始安装：默认情况下，安装完成后会自动创建默认的概要文件AppSrv01（/profiles/AppSrv01）：安装成功后启动服务：Windows：WAS_HOME/bin/startServer server1Unix/Linux：/bin/startServer server1如果看到有进程标识号说明启动成功，这时就可以通过以下链接来访问控制台：https:/localhost:9043/ibm/console/logon.jsp 或http:/localhost:9060/ibm/console输入之前的用户名和密码登录控制台：登录后可以在主页的右边看到WebSphere版本号：3 给WebSphere打补丁安装WebSphere成功后的第一件事不是发布应用程序，而是给WebSphere打补丁。1. 准备安装程序升级器：Windows：-WS-UPDI-WinIA32.zipUnix/Linux：-WS-UPDI-WinIA32.tar.gz补丁文件：6.1.0-WS-WAS-WinX32-FP0000025.pak2. 停止服务参考4.1停止服务。3. 如果有旧版本的UpdateInstaller，请先使用UpdateInstaller自带的卸载命令卸载后再安装新版本的UpdateInstaller。4. 将下载的-WS-UPDI-WinIA32.zip解压到某个临时目录，操作步骤与安装WebSphere是一样的，解决后的文件结构如下图：运行UpdateInstaller目录下的install.exe（Unix/Linux：./install.sh），进入向导界面，点击下一步：选择接受条款，点击下一步：通过系统检查，点击下一步：选择UpdateInstaller的安装目录：安装目录最好与前面安装的WebSphere存放在同一级目录里：AppServer和UpdateInstaller在同一目录。如果确认无误后，点击下一步开始安装Update Installer：安装完成后，如果选择“退出时启动IBM UpdateInstaller for WebSphere Software”则在点击完成后会立刻运行Update Installer。如果没有选择也可以在安装后在UpdateInstaller目录下运行update.bat（Unix/Linux：./update.sh）运行UpdateInstaller后进入升级器向导欢迎界面，点击下一步：选择已安装的WebSphere所在路径，点击下一步：选择“安装维护软件包”，点击下一步：选择补丁文件6.1.0-WS-WAS-WinX32-FP0000025.pak所在目录，点击下一步：选择要安装的补丁程序，点击下一步：确定后点击下一步开始安装补丁程序：在安装成功后点击完成结束补丁升级。5. 重新启动服务器并登入控制台，如果看到版本号变化了说明打补丁成功：4 卸载WebSphere4.1 停止服务1、打开命令行提示符，并进入以下目录：/bin2、运行停止服务命令Windows：stopServer server1Unix/Linux：./stopServer.sh server1 username admin -password admin3、停止服务器后，还需要检查系统进程是否还有相关的WebSphere进程还没关闭，例如JAVA，如果有将其停止：Windows：任务管理器Unix/Linux：ps la #查看系统所有进程kill 进程号 #杀死指定的进程 4.2 卸载1、 打开命令行提示符，并进入以下目录：/uninstall2、 运行卸载程序在Windows下：uninstall.exe在Unix/Linux下：./uninstall3、 根据向导提示进行卸载在欢迎界面上，点击下一步：在概要文件删除确认界面，确认选中“删除所有概要”，然后点击下一步：检查卸载界面的摘要信息，然后点击下一步：卸载完成后，点击完成关闭卸载向导。4、 在卸载完成之后，目录下仍然会一些文件存在，手工把目录删除。如果是Windows操作系统，请重启计算机。5、 可以通过安装程序的installRegistryUtils工具来检查卸载是否成功：d:was61WASinstallRegistryUtilsbininstallRegistryUtils listProducts还可以通过给installRegistryUtils命令加入不同的参数来清除注册的IBM软件信息，参数说明可以通过直接输入命令installRegistryUtils了解。5部署WEB应用5.1 配置数据源在控制台主界面依次点击资源-JDBC-JDBC提供程序，在标识3处的下拉框选择“节点”，点击新建创建新的JDBC提供程序：在数据库类型选择要使用的数据库类型（以DB2为例），其他的按照以下列出的选择：设置DB2的JDBC驱动程序所在的目录（请根据实际情况来设置），点击下一步：如果是Unix/Linux系统则使用/home/db2admin/SQLLIB/java类型的路径。确定设置无误后，点击完成：点击红线方框的保存将之前的设置信息保存：分别依照标识15新建数据源：在数据源名和JNDI名称一栏输入相应的名字，其中JNDI的名字是在部署应用时会使用到，点击下一步：在“选择现在的JDBC提供程序”下拉框加选择之前创建的JDBC提供程序，点击下一步：输入数据库的名字、数据库所在的IP地址以及数据库的端口号，驱动程序类型选择“4”，点击下一步：点击完成结束配置：点击保存保存先前的配置：在数据源列表选择新建的数据源，点击链接“tfms_ds”进入：点击链接“JAASJ2C认证数据”：点击新建：在用户标识和密码一栏输入数据库的用户名和密码，点击确定并在接下来的提示点击保存：返回数据源列表，选择之前创建的数据源“tfms_ds”：在修改数据源的界面中的“组件管理的认证别名”和“容器管理的认证别名”下拉框中选择之前创建的“tfms_ca”JAAS认证：点击确定和保存按钮后返回数据源列表，选中“tfms_ds”数据源并点击测试连接：如果提示成功则说明数据源已经配置成功并可以使用了：5.2 部署应用WebSphere部署必须以EAR、WAR、JAR等打包的方式部署且要通过控制台来部署，不支持文件夹的部署方式。注意事项：1. WAR包不能包含有中文字符的文件。使用JAR命令打包过后的WAR包使用winrar解压时会提示出错，这时就可以定位到哪有中文文件。2. WEB-INF目录下的web.xml文件不能有中文字符，即使是注释也不行。最好是将所有的注释删除。3. web.xml文件的格式必须按照标准和顺序来设置，不同类型的元素不能交叉。例如不能先是listener，然后是servlet，接着是listener。4. 必须使用JAR命令或者开发工具来打包，不能使用压缩工具进行打包。tfmsjar cvf tfms.war *5. 将应用程序中引用到数据源的配置文件修改成与JNDI一致的名字。例如：hibernate.cfg.xml里的JNDI引用：java:comp/env/jdbc/tfms。6. 如果打包后的应用程序比较大，且应用服务器所在主机可以运行控制台，则可以先通过远程工具将应用程序包上传到服务器后，再通过控制台的本地部署方式来部署，这样可以减少部署所需的时间。7. 错误EAR 文件可能已损坏和/或不完整。如果经过上述步骤还发生该错误，则先将war包里非WEB-INFO文件删除（即WAR包里只留下WEB-INF文件夹），再进行部署，部署成功之后再将其他文件复制到发布后的WAR包文件夹下。选择应用程序-安装新的应用程序，在打开的界面里的“新应用程序的路径”选择打包好的WAR包，在“上下文根”处输入应用程序的访问名称，点击下一步：在“选择安装选项”界面使用默认值，点击下一步：使用默认值，点击下一步：在接下来的界面里的“指定认证方法”一栏选择“使用缺省方法（多到一映射）”并在“认证数据条目”的下拉框选择之前创建的JAAS认证；然后点击新应用模块列表浏览：选择之前创建的“tfms_ds”数据源并点击应用：按照标识号的顺序进行操作，然后点击应用：这时新应用模块列表中可以看到已经为新应用指定了认证方法，点击下一步：使用默认值，点击下一步：如果需要更改新应用的上下文根，在ContextRoot一栏输入新的值即可，点击下一步：检查新应用的配置项是否正确，如果需要调整则点击上一步，确定无误后点击完成结束配置：当见到如下图的提示后，说明新应用部署成功，点击保存将新应用保存起来：点击应用程序-企业应用程序，在右边列表中已经有新部署的应用程序，如果“应用程序状态”为红色的叉，说明新应用没有启动；选中新应用前的复选框并点击启动：如果看到下面的提示信息则表示新应用启动成功：这时可以通过http:/localhost:9080/tfms来访问新应用程序，其中的tfms就是部署新应用时指定的上下文根。5.3 更新应用部署应用后的WebSphere目录结构：部署完新的应用程序后还得持续的对其进行维护，包括更新JSP页面和实现类、加入新的模块，大多数据情况下是不需要重新打成WAR包然后重新部署的。 1、 更新JSP页面将JSP页面直接覆盖掉上图tfms.war文件夹（tfms.war是测试项目，请根据实际应用调整）中的文件即可。2、 更新JAVA类或加入新的模块（不包括更新web.xml）先将应用程序停止： 将新的类文件和应用配置文件更新到tfms.war对应的文件夹或文件，然后在企业应用程序列表点击要修改的应用程序：在资源引用界面点击资源引用：在引用列表中查看要修改的应用程序的“认证方法”是否为空，如果是重新绑定资源（具体步骤在部署应用里有描述）：更新完成后重新启动应用程序即可。3、 更新web.xml（不包括web.xml中引用的资源，例如JNDI名称引用） 先将应用程序停止，将新的web.xml覆盖tfms.war/WEB-INF目录下的web.xml。 更新config目录下的tfms.war/WEB-INFO目录下的web.xml，目录结构如下图：4、 更新web.xml（包括web.xml中引用的资源，例如更换JNDI名称引用）例：tfmsjdbc/tfms / 如果修改了该值则需要重新打包部署javax.sql.DataSourceContainer将应用程序卸载并重新打成WAR包重新部署。附录A：日志文件日志文件所在目录：日志文件说明：startServer.log：启动服务器事件的日志stopServer.log：停止服务器事件的日志SystemErr.log：记录系统错误SystemOut.log：系统中所有活动的日志对于Unix/Linux系统，可以使用命令：tail f xxx.log来实时查看输出的日志内容。附录B：创建概要文件如果在profiles目录下没有任何文件夹，说明没有创建概要文件，这时可以使用概要文件管理工具来创建新的概要文件：Windows：binProfileManagementpmt.batLinux：/bin/ProfileManagement/pmt.shAIX：没有图形界面向导，需要使用/bin/manageprofiles.sh命令来创建。运行PMT程序后，根据向导来创建新的概要，点击下一步：选择“应用程序服务器”，点击下一步：选择“高级概要文件创建”，点击下一步：全部选中，点击下一步：设置新概要文件的存放目录和名字，点击下一步：设置主机和节点的名称，点击下一步：说明：主机名不要使用中文或者特殊字符。设置管理该概要的用户名和密码，点击下一步：设置新概要的服务端口，点击下一步：设置新概的是否作为系统服务运行，点击下一步：根据需要是否选择创建WEB服务器，点击下一步：最后，查看概要总结界面确保无误后，点击创建完成新概要的创建。附录C：软件下载WebSphere Application Server for Deve