《Weblogic9.2安装配置手册》

1、weblogic92 安装配置手册安装配置手册 目录目录 1.简介简介.5 1.1目的.5 1.2范围.5 1.3定义、首字母缩写词和缩略语.5 1.4参考资料.5 1.5概述.5 2.weblogic9.2 的安装的安装.5 2.1运行安装程序.5 2.2欢迎窗口界面.6 2.3授权协议界面.6 2.4选择安装 bea 根目录.6 2.5选择安装类型.6 2.6选择需要安装的部件.7 2.7是否安装可选工具.7 2.8选择weblogic安装目录.8 2.9选择是否安装为window服务.8 2.10选择安装window系统菜单.8 3.创建创建 weblogic 域域(domain).9

2、3.1运行配置向导.9 3.2选择 domain source.9 3.3输入管理员用户名称和密码.10 3.4选择weblogic启动模式和 jdk .10 3.5选择定制配置.10 3.6配置管理节点.11 3.7其他配置.11 3.8创建weblogic域.12 3.9启动weblogic域.13 3.10停用weblogic域.13 4.配置配置 weblogic 域域.13 4.1为什么需要配置？.13 4.2配置bouncycastle jce .13 4.3复制apache xml解析器.14 4.4复制wlcommons-logging.jar.14 4.5复制 fmis 第三

3、方jar文件.15 4.6删除weblogic自带的ojdbc14.jar.15 4.7更新数据库驱动.15 4.8删除有冲突的weblogic提供的类文件.15 4.9调整 jvm 内存 .16 5.配置系统运行日志配置系统运行日志.16 5.1.1设置weblogic域日志.16 5.1.2设置weblogic服务节点日志.17 5.1.3设置服务节点的http日志.19 5.1.4weblogic日志说明.20 6.安装部署安装部署 fmis 服务端程序服务端程序.20 6.1配置 fmis 数据源.20 6.1.1切换至数据源配置窗口.20 6.1.2选择正确的数据库和数据库驱动.21

4、 6.1.3事务属性配置窗口.21 6.1.4数据库连接配置窗口.22 6.1.5测试数据库窗口中.22 6.1.6选择数据源所属的服务节点.23 6.1.7修改数据源属性.23 6.1.8配置ygfmisconfig.xml中的数据源.25 6.2设置事务超时.25 6.3部署 fmis 服务程序包.26 6.3.1把ear包中的ygfmisweb解压为目录.26 6.3.2选择需要fmis服务包.26 6.3.3选择安装类型.27 6.3.4安装服务属性设置.27 6.3.5启动服务.28 6.3.6更新服务.29 7.常见问题常见问题(faq) .29 7.1为什么无法修改weblogi

5、c控制台中的参数？.29 7.2为什么在weblogic中部署 fmis 服务端程序后，客户端无法访问？ .29 7.3为什么提示找不到jdbc/fmismain数据源？.29 7.4为什么没有生成 fmis 日志？.29 7.5如何调整 fmis 日志配置方式？.29 7.6屏幕窗口什么没有打印日志信息？.30 7.7如何把标准输出流的日志信息全部保存到日志文件中？.30 7.8如何将一个weblogic服务节点绑定多个端口？.31 7.9修改 fmis b/s 单据格式后，为什么无法立即生效？ .31 7.10其他.31 8.附录附录 a：如何把：如何把 fmis b/s ear 程序包中

6、的程序包中的 ygfmisweb.war 解压缩为目录解压缩为目录.32 weblogic92weblogic92 安装配置手册安装配置手册- -初级初级 1.1.简介简介 本文档是对以前的 weblogic9.2 安装配置手册的整理和总结，包括在日常维护过程中常出现的问题 及解决方法。 1.11.1目的目的 1.21.2范围范围 weblogic9.2 的安装与配置，不包括 weblogic8.1.x 的安装与配置。 1.31.3定义、首字母缩写词和缩略语定义、首字母缩写词和缩略语 1.41.4参考资料参考资料 1.51.5概述概述 2.2.weblogic9.2weblogic9.2 的安

7、装的安装 2.12.1运行安装程序运行安装程序 window 平台中，双击运行安装程序，如 platform921_win32.exe； linux 平台中，在 shell 命令窗口中，切换到安装程序所在目录，通过“./xxx.bin”命令运行安 装程序，如“./platform921_linux32.bin”。 2.22.2欢迎窗口界面欢迎窗口界面 2.32.3授权协议界面授权协议界面 2.42.4选择安装选择安装 beabea 根目录根目录 2.52.5选择安装类型选择安装类型 根据需要选择完全安装还是定制安装，在实施运行环境中，可以通过定制安装方式只安装所需部件。 2.62.6选择需要安

8、装的部件选择需要安装的部件 2.72.7是否安装可选工具是否安装可选工具 一般不选择“mercury profiling tools”。在程序开发调试时可以选择安装。 2.82.8选择选择 weblogicweblogic 安装目录安装目录 2.92.9选择是否安装为选择是否安装为 windowwindow 服务服务 此窗口只在 window 平台中出现，linux 等平台不出显示本窗口。(默认为“no”) 2.102.10选择安装选择安装 windowwindow 系统菜单系统菜单 此窗口只在 window 平台出现。 3.3.创建创建 weblogicweblogic 域域(domain)

9、(domain) 3.13.1运行配置向导运行配置向导 运行“weblogic 安装目录”weblogic92commonbin 中的 config.cmd/config.sh，选择创建新 weblogic domain。 3.23.2选择选择 domaindomain sourcesource 3.33.3输入管理员用户名称和密码输入管理员用户名称和密码 3.43.4选择选择 weblogicweblogic 启动模式和启动模式和 jdkjdk 实施运行环境中，推荐选择开发模式(productionmode)；如果使用 fmis b/s 版程序，为解决修改 单据格式后立即生效，应选择开发模式

10、(developmentmode)。 程序调试环境中，推荐选择开发模式(developmentmode)。 注：这两种模式并没有实质性区别。 jdk: 由于 fmis 在 jrocket jdk 中运行过程中存在不稳定现象(尚未找到原因)，不推荐使用 jrocket jdk，可以使用 sun jdk, ibm jdk, hp jdk。 3.53.5选择定制配置选择定制配置 如果需要修改 weblogic domain 的端口，配置群集及配置数据源等信息时，可以选择“yes”。 3.63.6配置管理节点配置管理节点 可以根据需要修改侦听端口：在单机环境中，侦听端口一般应设置为 9080；在群集环

11、境中，代理 服务节点的侦听端口一般设置为 9080。 3.73.7其他配置其他配置 以下配置主要是针对群集环境，本章节忽略。 3.83.8创建创建 weblogicweblogic 域域 可根据实际需要，输入合适的域名称；域路径一般为默认值。 点击 create 按纽，创建 weblogic 域。 新增一步：weblogicweblogic 破解破解 1、windows 下的使用方法 1）将 license.bea 和 weblog_crack.jar 拷贝到 bea 安装目录下，例如 d:bea 2）修改 d:beauser_projectsdomainsodpsdomain(你建立的域)b

12、instartweblogic.cmd 修改 set classpath=%classpath%;%medrec_weblogic_classp 为： set classpath=d:beaweblogic_crack.jar;%classpath%;%medrec_weblogic_classp 2、linux 下的使用方法 略 3.93.9启动启动 weblogicweblogic 域域 运行“weblogic 域路径binstartweblogic.cmd 或 startweblogic.sh”，运行 weblogic 域。 weblogic 域路径是指在“创建 weblogic 域”步

13、骤中选择的路径，默认值是“bea 安装目录 user_projectsdomains域名称”。 注：若以生产模式运行，在运行过程中可能需要输入管理员的用户名和密码。 3.103.10停用停用 weblogicweblogic 域域 运行“weblogic 域路径binstopweblogic.cmd 或 stopweblogic.sh”，则关闭 weblogic，关闭 过程可以需要几秒至几十秒钟不等。 不推荐使用“结束进程”的方式强制关闭 weblogic 域，强制关闭会导致 weblogic 使用的一些资源 不能正确释放，甚至导致 weblogic 无法再次正常运行。 注：若以生产模式运行，

14、在运行过程中可能需要输入管理员的用户名和密码。 4.4.配置配置 weblogicweblogic 域域 进行配置前，如已运行本 weblogic 域，须关闭。 4.14.1为什么需要配置？为什么需要配置？ 远光 fmis 运行时依赖一部分第三方 jar 文件，需要把这些文件添加到 jvm 的搜索路径 (classpath)中。 远光 fmis 本身包含的一部分程序与 weblogic 自带的一些程序存在类冲突，需要调整。 参数调优 4.24.2配置配置 bouncycastlebouncycastle jcejce fmis 服务端借助 bouncycastle jce 完成数据的加密解密功

15、能。 复制 bcprov-jdk14-137.jar，bcmail-jdk14-137.jar 至 jre 的 libext 目录中。 若使用的若使用的 jdkjdk 是是 ibmibm jdkjdk，则需要修改，则需要修改 java.securityjava.security 文件文件(ibm jdk 之所以需要修改配置文档，是 由于 ibm jdk 存在 bug 引起，其他厂商的 jdk 可省略本步骤)。 打开jre_homelibsecurityjava.security，在配置 jce providers 部分增加如下信息： vider.3=org.bouncy

16、vider.bouncycastleprovider 并修改其后的相应vider.x顺序号。 注：若以前已对此处增加过上述信息，则无需重复增加。 如下分别是修改前后的图片比较： 注意：不能复制至jdk_homelib 中，否则不会生效。只有复制到 weblogic 运行时所使用的 jdk 相关目录中才可生效。 注：如何判断如何判断 weblogicweblogic 运行时使用的运行时使用的 jdkjdk 的目录？的目录？weblogic 运行时使用的 jdk 是配置 weblogic 域时，在“选择 weblogic 启动模式和 jdk”步骤

17、中指定(见“3.4 选择 weblogic 启动模式和 jdk”)。 对于已经配置后的 weblogic 域，可以通过查看“setdomainenv.cmd(sh)”，查看并分析 java_home 变量值；当然也可以通过查看 weblogic 运行日志中，查找“java.home”字符串，也可 以得知使用的 jre 所在的目录。 4.34.3复制复制 apacheapache xmlxml 解析器解析器 weblogic 本身提供一套 xml 解析器，但此解析器在 axis soap 使用时会出现异常(空指针异常)， 需要用 apache xml 解析器替代 weblogic xml 解析器

18、。方法如下： 使用 ibm jdk 复制本文档附件“weblogic 附件.rar”中的 xml.jar，替换 jre/lib 下的同名文件 xml.jar， 如“d:bea92jdk150_06jrelibxml.jar”。 其他 jdk 复制本文档附件“weblogic 附件.rar”中的 xml.jar 至 jre 的 libext 目录，如 “d:bea92jdk150_06jrelibext”。 注：须把上述两文件复制到 weblogic 使用的 jre 相关目录中方可有效，若复制到其他 jre 目录， 则无效。 若不使用 apache xml 解析器，而是使用 weblogic x

19、ml 解析器，则无法使用 c/s 程序的所有功能和 b/s 程序的部分功能。 4.44.4复制复制 fmisfmis 第三方第三方 jarjar 文件文件 复制 fmis 使用的第三方 jar 文件至“bea 安装目录user_projectsdomainsdomain 名称 lib”，如“d:bea92user_projectsdomainsdebug_domainlib”。 4.54.5删除删除 weblogicweblogic 自带的自带的 ojdbc14.jarojdbc14.jar 删除“bea 安装目录weblogic92serverlibojdbc14.jar”。 这是因为 we

20、blogic9.2 自带的 oracle 数据库驱动版本比较旧，删除后，weblogic 运行过程中会自 动使用“bea 安装目录user_projectsdomainsdomain 名称libojdbc14.jar”。 4.64.6更新数据库驱动更新数据库驱动 若使用 oracle 数据库，推荐把 oracle 数据库服务器提供的数据库驱动程序(ojdbc14.jar)覆盖 weblogic 域 lib 目录的同名文件。 在 oracle 数据库服务器，ojdbc14.jar 一般位于“oracle 安装目录jdbclib”，推荐应用服务 器使用的数据库驱动与 oracle 数据库版本保持一

21、致，尤其是安装 oracle 数据库补丁程序之后。 本步骤为可选步骤，主要是防止 fmis 运行过程中由于 oracle 数据库驱动版本与 oracle 数据库服 务版本不一致，引起一些意想不到的问题，如长时间运行后 weblogic 无法连接 oracle 数据库服务， 或者运行过程中时常出现短暂连接数据库失败。 4.74.7删除有冲突的删除有冲突的 weblogicweblogic 提供的类文件提供的类文件 用 winrar 或 linux 自带工具打开“bea 安装目录weblogic92serverlibweblogic.jar”,删 除“orgmozzila”目录。 删除前： 删除后

22、： 注：上述删除操作均在注：上述删除操作均在 winrarwinrar 或或 linuxlinux 自带工具中进行。禁止用自带工具中进行。禁止用 winrarwinrar 把把 weblogic.jarweblogic.jar 文件解文件解 压缩为目录，删除后再压缩为文件，因为用压缩为目录，删除后再压缩为文件，因为用 winrarwinrar 压缩后生成的是压缩后生成的是 rarrar 格式的压缩文件，其格式格式的压缩文件，其格式 与与 jarjar 压缩格式是两种不同的存储格式。压缩格式是两种不同的存储格式。 4.84.8调整调整 jvmjvm 内存内存 部署和运行 fmis 服务端需要较大

23、内存，一般把 jvm 内存分配 1-2g。 编辑“weblogic 域路径binsetdomainenv.cmd(setdomainenv.sh)”，修改变量 mem_args 内容 为“mem_args=-xms1024m xmx1024m”，若机器空闲内存较多，则最多可以分配 2048m，即 “mem_args=-xms1024m xmx2048m”；推荐把-xx:maxpermsize 改为 256m。 windows: linux: 内存分配不是越多越好，内存分配过多，jvm 管理和回收内存垃圾回收所需时间较长，降低 jvm 响 应时间。 注：在 32 位 window 平台，一般操作

24、系统限制单个进程最多使用 2g 内存，若此时分配 2g 内存，可 能无法正常启动 jvm。 修改 maxpermsize 参数时，注意区分不同的 jdk 类型，sun jdk 与 hp jdk 修改的代码分支是不相 同的。对于 ibm jdk，应不需要配置本参数(ibm jdk 好象没有提供本参数)。 注：配置 maxpermsize 参数主要是防止部署 fmis 程序时出现“java.lang.outofmemoryerror: permgen space”的错误，这是由于 fmis.ear 本身的文件大小已接近 120m，若代码区最大内存分 配不足(maxpermsize)，很容易出现 o

25、utofmemoryerror 的异常。 5.5.配置系统运行日志配置系统运行日志 1.运行 weblogic。 2.在 ie 浏览器中打开 weblogic 管理控制台：http:/serverip:port/console, 如 :7001/console. 5.1.1设置 weblogic 域日志 点击左部菜单的 weblogic 域，打开配置窗口，选择“logging”标签，修改相关的参数，见下图。 5.1.2设置 weblogic 服务节点日志 点击左边菜单树的的“environment”-“servers”，在随后 server 列表中，点击服务实例的

26、名称，打开 server 日志配置页面 general，修改相关参数。 日志文件大小：一般设置为 1024k, 历史文件个数：20， 日志记录级别：info 5.1.3设置服务节点的 http 日志 在上步骤打开的“server 日志配置页面”中，切换 http 请求日志页面，禁止记录 http 请求信息，见下图。 注：http 日志主要记录客户端发送至 weblogic 的请求信息(access.log)，此日志对于系统调试时有所帮助， 正式运行时建议关闭。 5.1.4weblogic 日志说明 按上述说明配置 weblogic 日志后，生成的日志文件均放在weblogic 域路径serve

27、rsservername logs”： 1. domainname.logxxx：如 base_domain.log，此类日志为 weblogic 域运行日志；weblogic 域日志保存 的均是 weblogic 运行过程中的全局信息，如各个节点的运行状态，服务部署信息及群集中各个节点之间的 交互信息等。 2. servername.logxxx：如 adminserver.log、server1.log 等等，此类日志包括 weblogic 服务实例的 运行状态及 fmis 运行过程中产生的日志信息。 6.6.安装部署安装部署 fmisfmis 服务端程序服务端程序 安装部署 fmis 程

28、序前，应按上述步骤创建并正确配置 weblogic 域。 6.16.1配置配置 fmisfmis 数据源数据源 6.1.1切换至数据源配置窗口 进入 weblogic 控制台，点击左边菜单树中的“services jdbcdata sources” 进入数据源配置窗口，并点击左边的“lock&edit”按纽切换到修改状态 6.1.2选择正确的数据库和数据库驱动 点击配置窗口中“new(新增)”按纽，打开增加数据源向导，下图是 oracle 数据源配置信息。 注：jndi 必须是“jdbc/fmismain”； 数据库的驱动需选择“oracles driver(thin) versions 9.

29、0.1,9.2.0,10”，选择其他数据库驱 动可能会导致 fmis 运行错误。 6.1.3事务属性配置窗口 保留默认值即可 6.1.4数据库连接配置窗口 根据实际情况输入 oracle 服务器地址、实例名、共享库用户名及口令等信息。 6.1.5测试数据库窗口中 点击“test configuration”按钮验证是否能正常连接到数据库。 6.1.6选择数据源所属的服务节点 在 servers 栏中必须选中所属的服务节点，否则新配置的数据源无法在 fmis 程序中使用。 点击“finish”，完成本次数据的配置。 6.1.7修改数据源属性 打开数据源的 configuration connec

30、tion pool，并点击页面下方的 advanced 超链接，选中 “testtest connectionsconnections onon reservereserve”。如不选中本选项，运行 fmis 过程中会出现连接数据库失 败的错误。 适当增加数据库连接池中连接数，提高程序性能。 注意：上述修改并保存(save)后，必须点击左边的“activate changes”才可生效。 6.1.8配置 ygfmisconfig.xml 中的数据源 请参考 b/s 配置手册进行配置工作流引擎数据源。 6.26.2设置事务超时设置事务超时 选择 weblogic 控制台左部菜单“services

31、”-“jta”，切换至“configuration”-“jta”，打 开事务超时设置页面，如下图： 设置事务超时时间：可以设置为 3600 秒(即 1 小时)。有的实施地由于单位库比较多，在共享库运 行修复对象属性、管理业务或创建会计年度等比较耗时的功能前，可以适当调大事务超时时间(如 2-3 小时)，避免在修复过程中由于超过一小时出现“事务超时异常”。 6.36.3部署部署 fmisfmis 服务程序包服务程序包 6.3.1把 ear 包中的 ygfmisweb 解压为目录 详细见附录 6.3.2选择需要 fmis 服务包 在 weblogic 管理控制台中，点击左边菜单树中的“deploy

32、ments”和左上方的“lock&edit”， 切换至安装部署窗口 点击“install”按纽，打开选择服务窗口 如果 fmis 服务端程序还没有上传，则点击“upload your file(s)”超链接，上传需要安装的 程序；如果服务端程序已上传到服务器上，则找到相关的目录。 6.3.3选择安装类型 6.3.4安装服务属性设置 保留默认值即可。 点击“finish”后，再点击左上方的“activate changes”按钮，花费几分钟后，本次安装信息保存成功。 6.3.5启动服务 打开安装部署服务窗口，点击“start”-“servicing all requests”，启动服务。 刷新页

33、面，如启动成功，则 state 变为 active，否则为 failed。 6.3.6更新服务 安装服务包后，如需更新 fmis 程序，则把正在运行的 fmis 停用、删除，再按装。重新安装服务后， 推荐重启 weblogic。 7.7.常见问题常见问题(faq)(faq) 7.17.1为什么无法修改为什么无法修改 weblogicweblogic 控制台中的参数？控制台中的参数？ 点击左上部分的“lock&edit”按钮后，控制能中的相关参数才允许修改。 修改完毕后，必须点击左上部分的“activate changes”按钮后相关的修改才可生效。 7.27.2为什么在为什么在 weblogi

34、cweblogic 中部署中部署 fmisfmis 服务端程序后，客户端无法访问？服务端程序后，客户端无法访问？ a.按装或部署 fmis 服务端程序后，有没有通过“activate changes”按钮激活本次操作。 b.部署 fmis 服务后，控制台中 fmis 程序的状态是否是“active”状态。 若 fmis 程序状态为“fail”或“admin”，说明 fmis 运行初始化功能报错，可通过日志检查 错误原因。 若 fmis 程序状态为“prepared”，说明只是完成安装，没有启动 fmis 服务，参见“部署 fmis 服务程序包”章节。 c.检查 weblogic 的 licen

35、se.bea，检查当前使用的 weblogic 是否是试用版。试用版只支持 5 个 客户端连接（是累计 5 个客户端连接，不是并发数为 5 个）。 7.37.3为什么提示找不到为什么提示找不到 jdbc/fmismainjdbc/fmismain 数据源？数据源？ a.检查是否在控制台中配置数据源。参见“配置 fmis 数据源”章节。 b.检查配置数据源时，指定的目标节点（target）与部署 fmis 时指定的目标节点是否一致。 weblogic 9.x 中，配置数据源和部署应用程序时，都与目标节点关联，即确定数据源或应用 程序只在哪些节点中可以使用，即使单节点中，也需要指定节点。 7.47

36、.4为什么没有生成为什么没有生成 fmisfmis 日志？日志？ a.检查是否把 wlcommons-logging.jar 文件复制到指定路径。 应复制到 weblogic 域路径下的 lib 目录，而不是 bea 安装目录的 lib 或其他目录。 b.检查 wlcommons-logging.jar 是否是从本文档“weblogic 附件.rar”获取，如果从其他目录 中复制而来，需要手工修改 wlcommons-logging.jar，详见“配置 weblogic 域复制 wlcommons-logging.jar”章节。 7.57.5如何调整如何调整 fmisfmis 日志配置方式？日

37、志配置方式？ 对于通过以前配置文档配置 weblogic 时，配置 fmis 的日志方式是通过 log4j，fmis 服务端日志保 存在单独日志中（ygfmis.log）。若采用本文档中推荐的 fmis 日志配置方式，可以做如下调整： a.停止 weblogic。 b.复制 wlcommons-logging.jar，详见“配置 weblogic 域复制 wlcommons-logging.jar”章节。 c.修改 startweblogic.cmd/ startweblogic.sh，在未行中，删除 -dlog4j.configuration=” 部分代码。 d.删除相关的 log4j 配置

38、文件，如 log4j.xml 或 log4j-adminserver.xml。 e.删除已生成的 ygfmis.log 及历史日志文件。 f.启动 weblogic。 7.67.6屏幕窗口什么没有打印日志信息？屏幕窗口什么没有打印日志信息？ 在日志文件可以记录日志信息，但在屏幕窗口（dos 窗口或终端窗口）却没有打印出相关日志信息。 这是因为在 weblogic 中，stdout 标准输出流的日志记录级别默认是 notice，调整为 info 或与日 志文件记录级别相同。 可以在“设置 weblogic 服务节点日志”(见“设置 weblogic 服务节点日志”章节)页面中，点击下 方的 ad

39、vanced 链接，打开如下窗口，设置“standard out”的“severity level”为 info 或其他。 注：必须先选中“redirect stdout logging enabled”后，方可设置“standard out”的 “severity level”；设置后点保存(save)按纽，再把“redirect stdout logging enabled”取 消，再保存一次，否则无法正常保存设置的 standard out severity level，这可能是 weblogic 的一个 bug。 7.77.7如何把标准输出流的日志信息全部保存到日志文件中？如何把标准输出流的日志信息全部保存到日志文件中？ 可以在“设置 weblogic 服