润乾报表在J2EE下的部署

1、润乾报表在j2ee下的部署2007年第2页培训内容一、部署流程和步骤 二、 WEB应用配置 三、应用服务器简介四、常见部署问题 五、编程接口入门第3页前题安装WEB服务器Tomcat拷贝安装目录Weblogic安装创建domainWebSphere安装第4页练习：安装应用服务器选择一种你关注的应用服务器并安装常见问题分析第5页一、部署流程和步骤配置应用服务器的数据库连接池创建新应用拷 贝 润乾 报 表w e b 发布包配 置 润乾 相 关的 配 置文件发布报表应用打w ar包Web应用配置应用配置不同服务器配置方式不一样润乾报表核心配置文件web.xml第6页1.1配置应用服务器的连接池1.部

2、署JDBC驱动2.创建数据库连接池3.各服务器部署差异第7页1.1.1部署JDBC驱动Tomcat拷贝JDBC驱动到common/libWeblogic修改cmd文件添加jdbc到classpathWebsphere拷贝文件AppServerlib第8页1.1.2创建数据库连接池Tomcat修改配置文件Weblogic控制台Webspher控制台第9页Tomcat4.0数据源name项是JNDI的名称定义，程序通过JNDI才能找到此对象auth项即连接池管理权属性，这里取值Container，申明为容器管理type项即对象的类型，这里取值javax.sql.DataSource，申明为数据库连

3、接池user、password、driverClassName、driverName，依次为数据库的用户名、密码、JDBC驱动和数据库地址第10页1.1.3各服务器部署差异JNDI前缀不同Websphere需要以WAR文件方式发布服务器JNDI前缀说明Tomcatjava:comp/env4.1修改server.xmlWeblogic无Websphere无Resinjava:comp/envConf.xmlOracle IASjdbc第11页练习：创建连接池在您关注的应用服务器下创建连接池常见问题分析1.url 、dirver2.找不到数据源3.tomcat5.0 及以上版本如何配置连接池4.

4、设计器和服务器数据源名称是否需要一致第12页二、 WEB应用配置 创建应用创建应用 复制文件复制文件 配置日志配置日志 配置引擎配置引擎 发布应用发布应用第13页前提了解web应用目录结构第14页2.12.1创建应用创建应用应用目录WEB-INFclasseslibweb.xml第15页练习：创建应用练习：创建应用创建名为runqian的应用 必须含有WEB-INF目录WEB-INFclasseslib第16页2.2复制报表引擎文件程序包10个jar程序包配置文件三个配置文件第17页练习：复制润乾报表引擎复制报表引擎10个jar包3个配置文件 第18页2.3复制报表打印程序程序包runqian

5、ReportApplet.jar第三方插件j2re-1_4_1-windows-i586-i.exej2re-1_4_2_08-linux-i586.rpm复制位置应用根目录第19页练习：复制打印程序程序包runqianReportApplet.jar widonws ：j2re-1_4_1-windows-i586-i.exe Linux：j2re-1_4_2_08-linux-i586.rpm第20页Tomcat中文乱码Tomcat_HOME/conf/server.xml 第21页2.4相关的配置文件1、web.xml 配置2、runqianReportLperties日志配

6、置第22页2.4.1基本配置通过Servlet方式配置配置授权文件报表模板位置JNDI前缀数据库配置第23页练习：xml的基本配置license20070530windows.dat 授权文件授权文件reportFileHome/reportFiles 报表模板文件位置报表模板文件位置JNDIPrefixjava:comp/env JNDI前缀前缀dataSourcepubs,sqlsvr,gbk,0; 数据库配置数据库配置第24页2.4.2缓存配置1.报表参数缓存时间2.报表缓存临时目录3.报表缓存时间4.缓存位置第25页练习：xml的缓存配置cachedParamsTimeout120 参

7、数在缓存中保存的时间参数在缓存中保存的时间cachedReportDir E:/work/temp 报表缓存的文件夹报表缓存的文件夹cachedReportTimeout120 报表缓存保存的时间报表缓存保存的时间 cachedToDiskOnlyyes 缓存时是否只保存在硬盘上缓存时是否只保存在硬盘上第26页2.4.3并发配置大报表大报表:当结果报表格子数超过一万个时，可以设为大报表，进行并发控制 1.可同时计算的大报表个数2.等待计算的大报表个数3.可同时计算的普通报表个数4.等待计算的普通报表个数第27页练习：xml的并发配置maxConcurrentForBigReport 2 max

8、WaitForBigReport 0 maxConcurrentForReport 9999 maxWaitForReport 9999 第28页2.4.4配置润乾日志配置日志文件配置日志级别第29页练习：日志配置/日志级别可为OFF,ERROR,WARN,INFO,DEBUG,ALL, 优先级依次降低，若为OFF则不输出任何/日志信息；若为INFO，则只输出ERROR,WARN,INFO等级别的信息，依次类推。log4j.logger.runqianReportLogger=DEBUG,LOG1,LOG2 日志级别日志级别 /输出日志到系统控制台log4j.appender.LOG1=org

9、.apache.log4j.ConsoleAppenderlog4j.appender.LOG1.layout=org.apache.log4j.PatternLayoutlog4j.appender.LOG1.layout.ConversionPattern=%dyyyy-MM-dd HH:mm:ss %c : %-5p %x - %m%n/输出日志到指定文件log4j.appender.LOG2=org.apache.log4j.RollingFileAppender/可以指定LOG2.File的全路径, 若未指明，则为相对WEB服务器启动文件的路径log4j.appender.LOG2.

10、File=runqianReport.log 日志文件日志文件第30页2.5发布web应用Tomcat修改配置文件Weblogic控制台Webspher控制台只能发布war文件第31页Jar命令打war包开始 运行 cmd 进入应用所在的目录jar 查看帮助jar cvf runqian.war *.*第32页练习：把应用打成war用jar命令把配置好的应用打成war包注意事项： 不同应用服务器中注意修改jndi名称应用中尽量不要有中文名称尽量删除web.xml的中文注释第33页三常见应用服务器配置简介3.1、Tomcat4部署3.2、Tomcat5.0部署3.3、Weblogic的部署3.4

11、、Websphere的部署第34页3.1 Tomcat4.0部署安装tomcat创建数据库连接池创建应用修改配置文件部署应用第35页3.1.1安装Tomcat下载Tomcat安装程序安装Tomcat确保Tomcat正常启动第36页3.1.2创建数据库连接池 driverClassName com.newatlanta.jturbo.driver.Driver url jdbc:JTurbo://pubs/charset=GBK username sa password sa 第37页3.1.3创建应用按照web应用的目录结构创建应用复制报表引擎文件复制报表打印程序第38页3.

12、1.4修改web.xmlDateSerlvlet授权文件license报表模板路径reportFileHomeJNDI前缀JNDIPrefix数据源dataSource缓存目录cachedReportDir日志文件logConfig第39页3.1.5修改日志配置文件日志级别log4j.logger.runqianReportLogger=DEBUG,LOG1,LOG2日志文件log4j.appender.LOG2.File=runqianReport.log第40页3.1.5部署应用直接拷贝应用到webapps目录下面修改应用部署文件Tomcat4修改server.xml第41页Tomcat5

13、.0 配置应用 driverClassName com.newatlanta.jturbo.driver.Driver url jdbc:JTurbo://pubs/charset=GBK username sa password sa 第42页3.3、Weblogic的部署拷贝jdbc驱动包拷贝WebLogic81serverlib下修改WebLogic81commonbincommEnv.cmd 配置连接池数据源部署报表应用目录发布War/ear发布第43页3.4、Websphere的部署拷贝jdbc驱动包配置连接池数据源部署报表应用war/ear发布第44页练习：发布应

14、用在您关注的应用服务器下发布应用常见问题第45页四、常见部署问题版本升级 应用服务器的差异 操作系统的差异数据库的连接问题 性能优化第46页4.1、版本升级新旧包混用更新不全 授权文件不正确 第47页4.1.1、新旧包混用旧包未删除runqianReport3_0.jar；runqianReport3_5.jar；runqianReport3_5_5.jar 缓存未删除 多个路径下存在旧包 搜索 runqian*.jar，然后把可疑的jar全部删除，再部署新版本。 第48页4.1.2、更新不全同时多个包需要更新，但是只更新其中的一部分 runqianReport*.jar poi.jar(导出

15、Excel)、itext_099.jar (导出Word)、runqianReportApplet.jar (打印)需要同时更新配置文件，如web.xml, tld文件等runqianReport.tld文件版本太旧导致的常见错误信息：org.apache.jasper.JasperException: /reportJsp/showReport.jsp(140,0) Attribute scale invalid according to the specified TLD Web.xml的变动，主要源于配置项的增加，以及servlet的增加 授权文件没有相应更新 两次升级是：3.03.53

16、.53.5.5第49页、授权文件不正确 3.5.5版程序+3.5版授权错误信息：2006-10-09 11:54:06 runqianReportLogger : INFO - 报表证书错误! Null 解决办法：更新授权第50页、授权文件不正确3.5版程序+3.5.5版授权 错误信息：2006-10-09 11:48:19 : INFO - 报表证书错误! Illegal character java.lang.IllegalArgumentException: Illegal character at com.runqian.base.util.Base64._

17、$21634(Base64.java:151) at com.runqian.base.util.Base64._$21288(Base64.java:127) at com.runqian.base.util.Base64.base64ToByteArray(Base64.java:100) at com.runqian.base.util.LLObject.get(LLObject.java:33.解决办法：更新程序，或者删除旧的jar包（java类路径和缓存路径）第51页、授权文件不正确web.xml中没有配置授权文件名 错误信息：2006-10-09 11:44:18 r

18、unqianReportLogger : INFO - 报表证书错误!授权文件错误: 未发现授权文件E:润乾报表网上演示实例bin.webappsROOTWEB-INFxrq_license_server.dat, 请检查是否在类路径或绝对路径上注意：xrq_license_server.dat是系统默认的缺省授权文件名，如果web.xml中没有配置，就默认为xrq_license_server.dat解决办法：在web.xml里配置授权文件 第52页、授权文件不正确web.xml文件中授权文件名配置错误，和实际名称不符 错误信息：2006-10-09 11:40:30 runq

19、ianReportLogger : ERROR - 授权文件错误java.lang.RuntimeException: 未发现授权文件E:润乾报表网上演示实例bin.webappsROOTWEB-INF355开发版服务器061231.dat, 请检查是否在类路径或绝对路径上解决办法：仔细核对web.xml中授权文件名的配置，看是否和实际的相符，大小写是否一致 第53页4.2应用服务器的差异JNDI前缀JDK版本中文的支持Servlet的 版本第54页4.2.1应用服务器的JNDI差异Datasource的前缀(web.xml中JNDIPrefix属性值)服务器TomcatresinJBOSSw

20、eblogicwebsphereJNDIPrefixJava:comp/envJava:comp/envJava:第55页4.2.2 jdk的版本比较容易导致jdk版本困扰的应用服务器一般是websphere，由于websphere本身是IBM的产品，因此其自带的JDK也是IBM的，虽然也符合J2EE的标准，但是在个别地方和SUN的还是有区别，例如其JIT(即时编译器)就有问题，如果这个选项不关闭，程序有时候会出问题。 另外，和oracle ERP集成时必须注意，其自带的jdk版本是jdk1.3，而且oracle ERP往往会在客户端安装一些程序，因此导致了客户端的jdk版本为jdk1.3。但

21、是润乾的打印applet要求jdk1.4，两者会造成冲突。因此如果遇到这种情况，请联系润乾的技术支持，要一个专门在jdk1.3下编译的打印applet包。 第56页4.2.3中文的支持不同的应用服务器，对中文的支持不一样，例如tomcat4和tomcat5就有区别，此时如果参数是程序员自己接收并传递给tag标签的，那么要记得转码，尤其是报表模板文件名，否则容易出现莫名其妙的错误，例如报表模板找不到等等。 在websphere下，对中文的支持也比较差，打war包时不能有中文名的文件，web.xml文件中所有中文注释要删掉，且web.xml中的第一句关于文件字体的定义要写成UTF-8，如下所示：

22、第57页4.2.4 Servlet的版本一般由于servlet的版本导致的错误很少见，润乾支持的servlet版本是servlet2.3，低于此版本servlet就不支持。一般来说比较早期的应用服务器，其servlet版本比较低，可能会低于servlet2.3。 我们目前为止仅仅遇到过websphere4.0，其servlet版本比较低，但是也有解决办法，就是把websphere5.0里的相关jar包拷贝过去替换掉，即可解决问题，websphere4.0本身往高版本兼容。 第58页4.3操作系统的差异中文问题图形问题第59页4.3.1中文问题现象：如果含有带斜线的单元格或者统计图的报表在网页上

23、发布时，统计图或斜线单元格里的汉字会变成小方框，此时往往是服务器端操作系统的中文安装包没有装全，导致报表里用到的字体在服务器端的操作系统里找不到，因此成了小方块第60页解决方法1.拷贝中文字体1、 在启动java的时候加入如下参数，参数值为jdk的安装路径 -Dsun.java2d.fontpath=/j2se/jre/lib/fonts 2、 操作系统安装完整的中文安装包，然后把操作系统的中文字体文件拷贝到/j2se/jre/lib/fonts目录下 3、打开/j2se/jre/lib目录下的perties文件，把新添加的字体文件的对照信息加进该文件即可 4、重

24、起webserver 第61页解决方法2.安装中文包1、操作系统安装完整的中文安装包 2、卸载jdk，重新安装，让jdk读取新的中文字体文件 第62页4.3.2图形问题现象：含有带斜线的或自动换行的单元格或者统计图的报表在网页上发布时，报表不能浏览错误信息：root cause java.lang.NoClassDefFoundError java.lang.Class.forName0(Native Method) java.lang.Class.forName(Class.java:141) java.awt.GraphicsEnvironment.getLocalGraph

25、icsEnvironment(GraphicsEnvironment.java:62)第63页解决方法1.升级jdk把JDK升级到1.4及以上版本由于润乾报表是被集成的，应用中往往还有用户自己的程序，如果服务器先装载用户自己的初始化程序，而该初始化程序的部分代码可能存在干扰，导致润乾报表设置的Djava.awt.headless=true参数不管用。此时必须在用户自己的初始化程序中或者应用服务器的启动java的命令中加入该参数。 第64页解决方法2.启动x-window目的：创建一个图形环境，在xwindow环境下启动服务器命令：startx某些用户的服务器机房不能

26、随便出入，因此对服务器的操作只能通过终端来进行，此时可以在启动服务器的X-WINDOW后，用一个终端连接该X-WINDOW，保持连接，不要断开，然后重起应用服务器即可。如果系统运行过程中，该终端被断开了，就需要重新连接，并重起应用服务器。 第65页解决方法3.部署pja环境下载地址：http:/ 部署pja： 搜索 web服务器名 pja例如：weblogic pja websphere pja第66页4.4数据库的连接问题常见现象原因与解决方法第67页4.4.1数据库连接不上现象客户端现象：表达式ds4.select(typeid,)中数据集未产生,可能因为未连接数据库 服务器

27、现象：、表达式ds4.select(typeid,)中数据集未产生,可能因为未连接数据库 2、没有找到数据源java:comp/env/sqlsvr 请检查服务器的数据库连接池配置!javax.naming.NameNotFoundException: Name sqlsvr1 is not bound in this Context 第68页4.4.2数据库连接不上解决方法1、连接池配置错误（driverurluserpassword等写法有误）2、报表模板的数据集配置中的数据源名称、web.xml中的datasource名称、及应用服务器的jndi名称，三者存在不一致的现象3、web.xml中数据源没有配置4、jdbc包缺失、版本不正确，或者没有正确放在应用服务器的java类路径下 第69页4.4.3字符集配置错误错误信息报表中所有从数据库中取出的中文乱码解决方法将web.xml中dataSource对应的值中第3个选项由GBK改为ISO-8859-1或由ISO-8859-1改为GBK即可 dataSource ora9i,ORACLE,GBK,0; 第70页4.4.3 sql需要转码错误信息带中文的查询语句或更新语句出现乱码解决