WebSphere Application Server部署war包项目

一、前言
1.编写目的
本文是描述war包项目在websphere application server(was)上的安装及部署步骤。按照此文档提供的内容进行操作，能够顺利的完成was上部署war包项目

2.预期的读者和阅读建议
本文主要面向项目经理。设计人员，开发人员。

3.词汇表
序号 术语 解释
1 Db2数据库 IBM开发的一种大型关系型数据库平台
2 Websphere application sercer Websphere Application Server(WAS)是一个JVM容器+WEB容器+EJB容器

二、环境准备
1.环境准备
序号 名称 安装系统软件
1 数据库服务器 Db2数据库
2 Web服务器 Websphere application server 8.5.15版本
Websphere自带集成jdk环境

2.中间件安装配置
1.下载websphere application server
A.下载ibm installation manager下载器
B.选定需要下载的对应的was版本，下载was8.5.15，具体安装步骤如下

三、Was下载器Installation Manager 的安装
1.下载器安装
自WAS8以后安装包不再区别OS，指针对Installation Manager 进行了操作系统的区分 ,进入IBM的官网https://www-01.ibm.com/marketing/iwm/iwm/web/download.do?S_PKG=500005026&source=swerpws-wasbaseim85&transactionid=454880327&pageType=urx进行下载，下载前需要先进行注册ibm用户账号如下图

注册完后登录，页面会自动重定向到Installation Manager下载界面，如下图所示，按照自己的系统版本下载对应下载器

下载对应OS下的安装包后解压

      点击install.exe安装
     选择Next

配置安装目录

   点击安装以后开始安装

    此过程需要等待一段时间 安装成功以后显示

   在开始菜单看到

四、WAS的安装
1.下载WAS安装包

    安装包中存在三个压缩文件

     解压到J:\was目录下

  解压后目录如下

  启动Installation Manager（IM）

选择  文件-->  首选项

添加存储库

注意这里选择的是WAS解压路径中的 repository.config （这和WAS6 7 安装双击exe截然不同）
测试连接

成功后确定 回到IM界面 点击安装

选中复选框

Next

继续Next，

注意修改安装路径

选择语音安装包

不要选择样本应用程序 ，我们用不到

点击开始安装

 安装中...

安装成功以后选择 无 然后完成完成 。
在开始菜单中看到

 2.2 配置概要文件
     WAS中的概要文件和WebLogic中的domain类似，是WAS中的服务 。     

点击 【概要管理工具】


点击 【创建】 来建立一个概要文件
选择【应用程序服务器】 后Next
选择【高级概要文件创建】
配置【概要文件名】已经对应的目录 ，默认走就可以
这里要注意【主机名】的配置 为本机计算机名次 （保证能Ping通） 在实际生产中配置服务器的IP地址

输入用户名和密码 admin/admin
默认走

默认端口信息 注意我圈红圈的信息 以后需要用到
将复选框中的勾去掉，不需要添加到系统服务中
默认走 这里的Web服务在以后手动创建
最后预览一下配置 后点击【创建】
概要文件开始创建
去掉对勾后点完成

至此概要文件配置完成.

  概要文件配置完成以后其目录结构如下： 

2.运行WAS
命令行进入概要文件目录下的bin目录，执行 startServer -help 查看该命令对应的帮助（其他命令的用法也可通过同样的操作得到）

执行命令启动WAS
startServer server1 -profileName AppSrv01

表示WAS成功启动 （可通过stopServer命令来停止）
这里也可以通过was8.5.15提供的可视化界面来进行was的控制启动和停止，如下

直接点击管理控制台或打开浏览器输入 http://localhost:9043/ibm/console


到这里，完成websphere application server安装，并且启动成功

五、项目部署前准备
1.配置数据源 : 配置db2数据源
1、 打开websphere控制台

2、进入websphere变量页面

4、 在websphere的安装目录下的AppServer下新建一个自己的存放db2的jar包的文件夹mydb2lib
5、将db2链接需要的jar包放到mydb2lib中，这里jar包已经收集好，直接取出放进去就行

6、在DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH变量设置画面里面需要将值指向刚刚设定的jar包的位置，在这里”${WAS_INSTALL_ROOT}/”指的就是”D:\software\IBM\WebSphere\AppServer\”(也就是was的安装目录下的AppServer)，因为不知道这里可不可以使用”D:\software\IBM\WebSphere\AppServer\”指向路径

7、设定好之后点击应用-》保存
8、DB2UNIVERSAL_JDBC_DRIVER_PATH变量也是重复第6步设定变量值
9、进入JDBC提供程序页面，应用范围选择节点即可

10、点击新建，进入新建画面，数据库类型选择DB2，提供程序类型选择DB2 Universal JDBC Driver Provider， 实现类型选择连接池数据源。然后就是点击下一步，剩下的就默认即可不用改动其他的东西了，一直到完成，点击保存

11、进入数据源画面，应用范围选择节点

12、点击新建进入新建画面，设置数据源名和JDNI名

13、点击下一步，选择刚刚新建的JDBC提供程序

14、点击下一步，填写数据库名和服务器名称（也就是数据库所在机器的IP地址）
15、点击下一步，进入页面，在点击下一步，然后然后点击完成-》保存

16、进入数据源页面

17、进入刚刚新建的数据源设置页面

18、点击”JAAS－J2C认证数据”链接

19、点击新建填写数据的用户名和密码，然后点击应用-》保存

20、然后再进入刚刚新建的数据源的设置画面，在安全性设置里面选择刚刚新建的jaas安全设置，然后点击应用-》保存

21、再返回数据源列表页面进行连接测试，如果成功那就是成功了，没有成功的画面再重复一遍上述步骤，还是不行的话就自己去查资料吧

到这里数据源就已经配置完成了
2.共享库配置
a.在weesphere安装目录下建立项目jar包与was里的jar包冲突时的共享库（一般为盘符/Websphere/AppServer），一个是存放service部署启动需要的jar包，命名为servicelib

b.将冲突的jar包丢进去，需要放进去的jar包已经收集好，分别将对应文件夹里的jar包丢到上一步配置好的servicelib里就行

c.建好共享库文件夹之后，需要去webspehre配置好引用，具体步骤如下
c.1：先打开was控制台—>环境—>共享库—>新建

C.2：这里先配置service部署时需要用到的共享库，在配置里自定义名称，这里先配置的是service模块部署时要用到的共享库，所以类路径填写为a步骤里建立的servicelib的路径，点击应用，保存

六、开始部署项目
1.初步部署操作
1.准备部署war包
准备好应用war包，这里以service.war包示范

2.启动was服务
打开控制台—>应用程序---->WebSphere 企业应用程序---->安装

3.选择war包
选择需要安装的应用war包—>下一步------>准备应用程序安装,默认选择—>下一步

4.安装新的应用程序
一直按照默认选择的选项下一步----->步骤2:模块映射至服务器，记得勾选前面的选择框----->步骤3，为web模块映射虚拟主机，记得也要勾上前面选择框，如下图

5.到步骤四
为web模块映射上下文根，这里上下文根填写，这里不需要填写，直接默认下一步就行

6.下一步到步骤5：按默认选项—>下一步---->摘要---->点击完成----保存配置----完成安装

2.配置共享库和类装入顺序
A.进入websphere控制台主页面—>选择应用程序----->WebSphere 企业应用程序---->点击刚刚安装好的模块

B.引用---->共享库引用—>选择应用程序前面的复选框，然后点击共享库引用

C.根据安装的模块选定前面配置好的共享库，这里是service_war，因此选定前面配置好的service共享库，如下图---->点击确定---->下面的模块service.war重复前面的前面的操作也选定好service共享库---->点击确定---->保存配置

D.设置好共享库后，需要设置类装入器顺序，同前面A步骤，选定好对应需要设置的应用程序，如下图，点击类装入和更新策略----->类装入器顺序勾选类已装入并且是先使用本地类装入器（父类最后）选项----->点击应用---->保存配置
在这里插入图片描述

3.文件上传下载路径修改
文件上传下载功能配置的文件和路径在项目里的application.properties文件里，如果需要修改的话步骤如下:
A.找到项目部署在webspehre下的文件夹，打开application.properties文件

B.修改上传下载路径，如下图

C.根据修改好的路径，去本地建好对应的文件夹，如图上这边配置的导出的模板路径为E:/project/core/sundi-czb/01code/dip-bdinput-core/service/src/main/resources/public，那么就需要在本地建好这个目录，上传的目录为E:/project/core/sundi-czb/01code/dip-bdinput-core，这里也已经建好

D.将下载导出模板需要用到的文件放到你设定好下载导出文件的文件夹下，这里设置的导出路径为E:/project/core/sundi-czb/01code/dip-bdinput-core/service/src/main/resources/public，那么就是把文件模板放到public文件夹下，如下图，需要用到的文件也已经在发过去的项目部署包里备好，直接把文件夹放到设定好的public文件夹下就好

G.访问路径为http://本机ip:9080/index.html,9080为前面安装概要服务时设定的端口，默认为9080

七、安装部署结果验证以及常见问题处理
1.部署结果验证
1.验证是否安装部署成功，点击启动按钮后，应用程序状态为红色部分的则为启动失败，绿色的即为启动成功，启动失败时，页面上方会弹出红色提示信息，这里可以看到，当启动失败时，首先可以先去was的启动日志里查找失败

2.部署失败常见问题处理
1.首先可以通过查找was服务器的启动日志来排查是哪里的错误，如下图，每次启动部署的项目时，日志信息一般会打印在systemout.log文件中和systemerr.log两个日志文件中，可以通过查看这两个日志文件来定位错误的位置和信息

2.可能存在的问题
2.1问题一:共享库没有设置好，没有完整地将项目里存在的和was本身的冲突的jar包放到共享库，导致项目启动失败，如下图所示，这里错误产生的原因即为项目里的一个jar包和was本身的jar包产生了冲突，项目里引用到这个jar包的地方默认地加载了was上的jar包，因此报错，这里就需要将项目里的这个jar包丢到共享库里.

解决方案:
先查看日志，查看具体冲突jar包的位置，然后定位到项目里具体冲突的jar包，将jar包复制丢到was项目jar包共享库里，再次重启项目

2.2.问题二:内存溢出问题:通过war包的方式进行部署，使用was的dmgr管理台进行上传war时，上传界面卡死，判断问题可能为内存溢出，如果是Dmgr内存溢出，则可在…/WebSphere/AppServer/profiles/Dmgr01/目录下发现以下文件javacore.***.txt 、heapdump.***.phd、core.***.dmp、Snap.***.trc；若有则证明是dmgr内存溢出。

解决方案：
在was控制台上选择System administration-Nodes,在出现的节点里面选择控制节点（一般带有的Manager为管理节点），点击管理节点-》Local Toplolgy，点击打开出现的节点树，选择名为dmgr的叶子节点，点击java and Process Management-》Process definition，再点击出现的新页面右边的 Java Virtual Machine，设置出现的页面中的 Initial heap size（初始堆）和Maximum heap size（最大堆）设置为256和1024，默认的最大堆是256m，根据需求调大即可。