Websphere部署与配置手册.doc

Websphere 部署与配置手册 1 WEBSPHERE 安装 1、 WebSphere 包括集群和单机两种方式，单机安装选择“./WAS/install.exe”; 2、 大部分安装过程都可按默认选择的，点“下一步”即可完成；主要需要修改的如 下图，选择所需安装目录（没有特殊要求，按个人习惯选择）后，再下一步时选择“应用 程序服务器” 。 第 2 页 3、 安装完成，建议进行第一次验证和启动，验证完毕建议将验证的所有配置拷贝下 来； 第 3 页 4、 启动命令：D:IBMWebSphereAppServerbinstartServer.bat server1 （备注：默 认为 server1，根据安装具体情况修改） 5、 停止命令：D:IBMWebSphereAppServerbinstopServer.bat server1 6、 控制台：https:/localhost:9043/ibm/console，控制台可以对 WebSphere 进行所有 的控制和配置 2 WEBSPHERE 配置 2.1 数据源配置 1、 配置 oracle 驱动程序路径 进入方式：环境WebSphere 变量，选择“ORACLE_JDBC_DRIVER_PATH” ； 输入 ojdbc14.jar 所在的路径，如：D:oracleora92jdbclib； 确认后保存到主配置； 第 4 页 2、 配置 jdbc 进入方式：资源jdbcjdbc 提供程序 作用域选择为需要使用此 jdbc 的节点 点击“新建”按钮，步骤 1 按如下选择，之后下一步至完成即可； 第 5 页 注意：oracle9i 及 10g 一般用的驱动是 ojdbc14.jar； 确认后保存到主配置； 3、 配置数据源 进入方式：资源jdbc数据源 作用域选择为需要使用此数据源的节点 点击“新建”按钮，步骤 1 按下图填写， “数据源名 ”按个人习惯填写， “JNDI 名 称”填入项目对应 JNDI 名； 第 6 页 步骤 2：提供程序为先前配置的 jdbc 提供程序 步骤 3：URL 根据实际情况填写，例如： jdbc:oracle:thin:199.3.8.252:1521:ora92；数据库的 helper 按默认选择即可； 第 7 页 确认完成后保存到主配置； 4、 配置 JAAS-J2C 认证数据 进入方式：资源jdbc数据源，点击上一步所配置的数据源进入配置页面 点击“JAAS J2C 认证数据”进入 第 8 页 点击“新建”按钮， “别名”按个人习惯填写， “用户标识”为指定数据库的用户 名， “密码”为指定用户的密码； 确认完成后保存到主配置； 第 9 页 重新执行本配置的第一步进入数据源配置页面，选择刚配置的认证名称，确定后 保存到主配置； 在数据源列表勾选中所配置的数据源，点击“测试连接” ，根据页面上方的提示结 果判断连接是否正常； 第 10 页 2.2 JVM 参数配置 进入方式：服务器应用服务器server1java 管理和进程进程定义 java 虚拟机 第 11 页 设置内容： 初始堆大小：256，最大堆大小：512 通用 JVM 参数：-Ddefault.client.encoding=GBK -Dfile.encoding=GBK - Duser.language=Zh -Duser.region=CN，这里主要是配置支持中文 第 12 页 第 13 页 2.3 安装应用程序 进入方式：应用程序企业应用程序 默认上下文根”/”已有 DefaultApplication 在使用，与项目冲突，因此在安装系统程 序前将系统自带的 example 全部卸载，勾选后点击“卸载”即可，然后保存到主 配置； 点击“安装” ，选择项目 war 包或 ear 包所在位置， “上下文根”根据具体项目设 置填写，综合运维支撑系统为“/” ； 第 14 页 之后继续点“下一步”执行直到“步骤 3: 将资源引用映射至资源”如下页面， 选择“认证数据条目” ，选择“JNDI”并勾选，点击“应用 ”，将将资源引用映射 至资源； 第 15 页 继续执行“下一步”操作，直至“完成” ，然后保存到主配置； 2.4 启动应用程序 进入企业应用程序，勾选指定项目，点击“启动” ，看是否正常进入“已启动”状 态； 第 16 页 进入连接：http:/localhost:9080/，如能正常显示系统登陆界面，说明系统已部署 成功。 2.5 停止系统自动加载 安装完成后，启动操作系统后会自动启动 web sphere 服务，可按如下方法去除。 进入：控制面板管理工具服务 右键选择“IBM WebSphere Application Server V6.1 - regaltec-126c88Node01”服务（后 半部分为节点名，各机器不同） ，将“启动类型”设置为“手动” ，确认即可。 3 ECLIPSE 及 WEBSPHERE 配置 3.1 ECLIPSE 配置 1、 进入：window-preperences-myeclipse-application servers-WebSphere6.1 如果没有找到 WebSphere6.1，只有 WebSphere6 的选项，说明 myeclipse 版本过旧， 请安装新版 myeclipse。旧版卸载执行文件一般在 myeclipse 安装目录下的 “MyEclipse- UninstallerData”文件夹中。 进入安装路径：F:IBMWebSphereAppServer。注意要选择到 appserver，而不是 WebSphere 目录，其他配置 eclipse 会自动从安装目录获取； 第 17 页 WebSphere 下 JDK 配置：必须选择 IBM 的 JDK，第一次配置需要添加该 JVM 的配 置，见下图，如我的机器：D:IBMWebSphereAppServerjava 第 18 页 3.2 ECLIPSE 发布 1、 选择所要 project 打成 war 包：必须选择 packeted archive 2、 启动 WebSphere，执行 2.3 步骤安装应用程序，选择刚生成的 war 包进行安装， 然后执行 3.3 步骤修改日志路径 注意此时不在 eclipse 中启动 webspere，使用外部命令启动。 3、 在 eclipse 下 newEnterprise application project，web project 选择对应的 Project，注意 Project Name 必须与 WebSphere 安装后的 Project Name 保持一致， 详见下图 第 19 页 第 20 页 第 21 页 第 22 页 第 23 页 4、 确定 WebSphere 服务已停止，删除安装 war 后生成的 ear 包，我安装后所在路径 D:IBMWebSphereAppServerprofilesAppSrv01installedAppsregaltec- 126c88Node01Cell IDA30_war.ear，类似此路径 5、 从 eclipse 发布刚新建的 Enterprise application project，Server 选择 WebSphere6.1，Deploy Type 此时选择 Exploded Archive 第 24 页 6、 编译后，在 eclipse 启动 WebSphere，这个时候可看到 WebSphere 启动的真个过程 和日志，之后可在 eclipse 进行调测开发 3.3 WebSphere 日志配置 进入方式：服务器 应用程序服务器，点击所要修改的 server，例如：server1，进 入编辑页面； 第 25 页 选择：记录和跟踪 server1 JVM 日志 第 26 页 将 System.out 与 System.err 两个地方的日志输出目录修改为：console，确定后保 存到主配置，修改的目的为了在 eclipse 下的 console 可看到 WebSphere 的日志， 以便进行调试； 第 27 页 4 项目配置注意事项 4.1 Web.xml 配置 WebSphere 对 Web.xml 的校验比 Jboss 严格，主要需要注意：1、servlet 节点必须在 listeren 之后；2、servlet 节点下的 display-name 子节点删除。 第 28 页 4.2 数据源配置 项目由于现有结构的原因，无法使用 WebSphere 的数据源，需要使用基础平台自行配 置的数据源。 需要修改 src 下的两个文件： 1、 SystemConfig.properties 将数据库连接方式 linkType 改为 1；/ 由原来的 2 更改为 1；WebSphere 的连接使用 JDBC 可能导致数据连接出错。 2、 ExtraDataSource.xml 文件里面的 FrameWorkDataSource 数据库连接配置为项目的 数据库连接，具体参数按实际情况设置。 4.3 Log4j.xml 配置 修改 src 下的 log4j.xml 配置文件，将日志地址配置为实际应服务器的日志地址。 4.4 WEB-INF 配置 WebSphere 对于代码与 jsp 等都能实现热部署，只要在代码发布路径下更新文件即可， 路径例如：D:IBMWebSphereAppServerprofilesAppSrv01installedAppsregaltec- 126c88Node01CellIDA30_war.earIDA30.war。 但是对于 WEB-INF 配置文件，则除了更新代码发布路径的文件之外，还需更新节点发 布路径的文件，路径例如： D:IBMWebSphereAppServerprofilesAppSrv01configcellsregaltec- 126c88Node01CellapplicationsIDA30_war.eardeploymentsIDA30_warIDA30.warWEB- INF。 此处的配置文件主要包括 web.xml 与 struts 的配置文件。 5 WEBSPHERE 名词解释 单元： 第 29 页 单元是整个分布式网络中一个或多个节点的逻辑分组。单元是一个配置概念，是管理 员将节点间逻辑关联起来的实现方法。管理员根据具体的业务环境，制定对其整体系统集 成环境有意义的条件来定义和组织构成单元的节点。就一般情况来说，可以将单元看作是 最大的作用域。 在 IBM WAS ND 产品中，管理配置数据都存储在 XML 文件中。单元保留了它每个节 点中每台服务器的主配置文件。同时每个节点和服务器也有其自己的本地配置文件。如果 服务器已经属于单元，则对于本地节点或服务器配置文件的更改都是临时的，通过在本地 提交更改生效时，本地更改覆盖单元配置，但是当执行单元配置文档同步到节点的操作时， 在单元级别上对主控服务器和主节点配置文件所作的更改将会替换对该节点所作的任何临 时更改。 节点： 节点是受管服务器（Server）的逻辑分组。节点通常与具有唯一 IP 主机地址的逻辑或 物理计算机系统对应，节点不能跨多台计算机。节点分为受管节点与非受管节点。 关于 Node、Profile 与 Server: 这三个概念比较容易混淆，我们拿出来对比说明：Node=Profile。Node 是管理上使用 的概念，Profile 是实际的概要文件，它们代表同一事物。Server 就是所谓的 Application Server Instance , 这是我们实际要布署 Application 的地方。在 IBM WAS ND 产品中受管节 点的 Node Agent 目的就是让 Deployment Manager Server 可以透过 Node Agent 来管 Node (Profile) 中的 Application Server Instance，一个 Node (Profile) 中可以有多个 Application Server Instance。 如果是非 ND 版本 , 则属于 Single Server 版本，那么一个 Node (Profile) 中只能有一 个 Application Server Instance，如果你希望在一台机器上有多个 Application Server Instance，那就只能透过创建多个 Profile (Node) 来达成，但这些 Node (Porfile) 彼此独立 没有管理上的关系 (RelationShip)，只要使用的 TCP/IP Port 不要冲突即可。