潤乾報表在J2EE下的部署

1、潤乾報表在j2ee下的部署2007年第2頁培訓(xùn)內(nèi)容一、部署流程和步驟 二、 WEB應(yīng)用配置 三、應(yīng)用服務(wù)器簡介四、常見部署問題 五、編程接口入門第3頁前題安裝WEB服務(wù)器Tomcat拷貝安裝目錄Weblogic安裝創(chuàng)建domainWebSphere安裝第4頁練習(xí)：安裝應(yīng)用服務(wù)器選擇一種你關(guān)注的應(yīng)用服務(wù)器并安裝常見問題分析第5頁一、部署流程和步驟配置應(yīng)用服務(wù)器的數(shù)據(jù)庫連接池創(chuàng)建新應(yīng)用拷 貝 潤乾 報 表w e b 發(fā)布包配 置 潤乾 相 關(guān)的 配 置文件發(fā)布報表應(yīng)用打w ar包Web應(yīng)用配置應(yīng)用配置不同服務(wù)器配置方式不一樣潤乾報表核心配置文件web.xml第6頁1.1配置應(yīng)用服務(wù)器的連接池1.部

2、署JDBC驅(qū)動2.創(chuàng)建數(shù)據(jù)庫連接池3.各服務(wù)器部署差異第7頁1.1.1部署JDBC驅(qū)動Tomcat拷貝JDBC驅(qū)動到common/libWeblogic修改cmd文件添加jdbc到classpathWebsphere拷貝文件AppServerlib第8頁1.1.2創(chuàng)建數(shù)據(jù)庫連接池Tomcat修改配置文件Weblogic控制臺Webspher控制臺第9頁Tomcat4.0數(shù)據(jù)源name項是JNDI的名稱定義，程序通過JNDI才能找到此對象auth項即連接池管理權(quán)屬性，這里取值Container，申明為容器管理type項即對象的類型，這里取值javax.sql.DataSource，申明為數(shù)據(jù)庫連

3、接池user、password、driverClassName、driverName，依次為數(shù)據(jù)庫的用戶名、密碼、JDBC驅(qū)動和數(shù)據(jù)庫地址第10頁1.1.3各服務(wù)器部署差異JNDI前綴不同Websphere需要以WAR文件方式發(fā)布服務(wù)器JNDI前綴說明Tomcatjava:comp/env4.1修改server.xmlWeblogic無Websphere無Resinjava:comp/envConf.xmlOracle IASjdbc第11頁練習(xí)：創(chuàng)建連接池在您關(guān)注的應(yīng)用服務(wù)器下創(chuàng)建連接池常見問題分析1.url 、dirver2.找不到數(shù)據(jù)源3.tomcat5.0 及以上版本如何配置連接池4.

4、設(shè)計器和服務(wù)器數(shù)據(jù)源名稱是否需要一致第12頁二、 WEB應(yīng)用配置 創(chuàng)建應(yīng)用創(chuàng)建應(yīng)用 復(fù)制文件復(fù)制文件 配置日志配置日志 配置引擎配置引擎 發(fā)布應(yīng)用發(fā)布應(yīng)用第13頁前提了解web應(yīng)用目錄結(jié)構(gòu)第14頁2.12.1創(chuàng)建應(yīng)用創(chuàng)建應(yīng)用應(yīng)用目錄WEB-INFclasseslibweb.xml第15頁練習(xí)：創(chuàng)建應(yīng)用練習(xí)：創(chuàng)建應(yīng)用創(chuàng)建名為runqian的應(yīng)用 必須含有WEB-INF目錄WEB-INFclasseslib第16頁2.2復(fù)制報表引擎文件程序包10個jar程序包配置文件三個配置文件第17頁練習(xí)：復(fù)制潤乾報表引擎復(fù)制報表引擎10個jar包3個配置文件 第18頁2.3復(fù)制報表打印程序程序包runqian

5、ReportApplet.jar第三方插件j2re-1_4_1-windows-i586-i.exej2re-1_4_2_08-linux-i586.rpm復(fù)制位置應(yīng)用根目錄第19頁練習(xí)：復(fù)制打印程序程序包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相關(guān)的配置文件1、web.xml 配置2、runqianReportLperties日志配

6、置第22頁2.4.1基本配置通過Servlet方式配置配置授權(quán)文件報表模板位置JNDI前綴數(shù)據(jù)庫配置第23頁練習(xí)：xml的基本配置license20070530windows.dat 授權(quán)文件授權(quán)文件reportFileHome/reportFiles 報表模板文件位置報表模板文件位置JNDIPrefixjava:comp/env JNDI前綴前綴dataSourcepubs,sqlsvr,gbk,0; 數(shù)據(jù)庫配置數(shù)據(jù)庫配置第24頁2.4.2緩存配置1.報表參數(shù)緩存時間2.報表緩存臨時目錄3.報表緩存時間4.緩存位置第25頁練習(xí)：xml的緩存配置cachedParamsTimeout120 參

7、數(shù)在緩存中保存的時間參數(shù)在緩存中保存的時間cachedReportDir E:/work/temp 報表緩存的文件夾報表緩存的文件夾cachedReportTimeout120 報表緩存保存的時間報表緩存保存的時間 cachedToDiskOnlyyes 緩存時是否只保存在硬盤上緩存時是否只保存在硬盤上第26頁2.4.3并發(fā)配置大報表大報表:當(dāng)結(jié)果報表格子數(shù)超過一萬個時，可以設(shè)為大報表，進(jìn)行并發(fā)控制 1.可同時計算的大報表個數(shù)2.等待計算的大報表個數(shù)3.可同時計算的普通報表個數(shù)4.等待計算的普通報表個數(shù)第27頁練習(xí)：xml的并發(fā)配置maxConcurrentForBigReport 2 max

8、WaitForBigReport 0 maxConcurrentForReport 9999 maxWaitForReport 9999 第28頁2.4.4配置潤乾日志配置日志文件配置日志級別第29頁練習(xí)：日志配置/日志級別可為OFF,ERROR,WARN,INFO,DEBUG,ALL, 優(yōu)先級依次降低，若為OFF則不輸出任何/日志信息；若為INFO，則只輸出ERROR,WARN,INFO等級別的信息，依次類推。log4j.logger.runqianReportLogger=DEBUG,LOG1,LOG2 日志級別日志級別 /輸出日志到系統(tǒng)控制臺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服務(wù)器啟動文件的路徑log4j.appender.LOG2.

10、File=runqianReport.log 日志文件日志文件第30頁2.5發(fā)布web應(yīng)用Tomcat修改配置文件Weblogic控制臺Webspher控制臺只能發(fā)布war文件第31頁Jar命令打war包開始 運(yùn)行 cmd 進(jìn)入應(yīng)用所在的目錄jar 查看幫助jar cvf runqian.war *.*第32頁練習(xí)：把應(yīng)用打成war用jar命令把配置好的應(yīng)用打成war包注意事項： 不同應(yīng)用服務(wù)器中注意修改jndi名稱應(yīng)用中盡量不要有中文名稱盡量刪除web.xml的中文注釋第33頁三常見應(yīng)用服務(wù)器配置簡介3.1、Tomcat4部署3.2、Tomcat5.0部署3.3、Weblogic的部署3.4

11、、Websphere的部署第34頁3.1 Tomcat4.0部署安裝tomcat創(chuàng)建數(shù)據(jù)庫連接池創(chuàng)建應(yīng)用修改配置文件部署應(yīng)用第35頁3.1.1安裝Tomcat下載Tomcat安裝程序安裝Tomcat確保Tomcat正常啟動第36頁3.1.2創(chuàng)建數(shù)據(jù)庫連接池 driverClassName com.newatlanta.jturbo.driver.Driver url jdbc:JTurbo://pubs/charset=GBK username sa password sa 第37頁3.1.3創(chuàng)建應(yīng)用按照web應(yīng)用的目錄結(jié)構(gòu)創(chuàng)建應(yīng)用復(fù)制報表引擎文件復(fù)制報表打印程序第38頁3.

12、1.4修改web.xmlDateSerlvlet授權(quán)文件license報表模板路徑reportFileHomeJNDI前綴JNDIPrefix數(shù)據(jù)源dataSource緩存目錄cachedReportDir日志文件logConfig第39頁3.1.5修改日志配置文件日志級別log4j.logger.runqianReportLogger=DEBUG,LOG1,LOG2日志文件log4j.appender.LOG2.File=runqianReport.log第40頁3.1.5部署應(yīng)用直接拷貝應(yīng)用到webapps目錄下面修改應(yīng)用部署文件Tomcat4修改server.xml第41頁Tomcat5

13、.0 配置應(yīng)用 driverClassName com.newatlanta.jturbo.driver.Driver url jdbc:JTurbo://pubs/charset=GBK username sa password sa 第42頁3.3、Weblogic的部署拷貝jdbc驅(qū)動包拷貝WebLogic81serverlib下修改WebLogic81commonbincommEnv.cmd 配置連接池數(shù)據(jù)源部署報表應(yīng)用目錄發(fā)布War/ear發(fā)布第43頁3.4、Websphere的部署拷貝jdbc驅(qū)動包配置連接池數(shù)據(jù)源部署報表應(yīng)用war/ear發(fā)布第44頁練習(xí)：發(fā)布應(yīng)

14、用在您關(guān)注的應(yīng)用服務(wù)器下發(fā)布應(yīng)用常見問題第45頁四、常見部署問題版本升級 應(yīng)用服務(wù)器的差異 操作系統(tǒng)的差異數(shù)據(jù)庫的連接問題 性能優(yōu)化第46頁4.1、版本升級新舊包混用更新不全 授權(quán)文件不正確 第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(導(dǎo)出

15、Excel)、itext_099.jar (導(dǎo)出Word)、runqianReportApplet.jar (打印)需要同時更新配置文件，如web.xml, tld文件等runqianReport.tld文件版本太舊導(dǎo)致的常見錯誤信息：org.apache.jasper.JasperException: /reportJsp/showReport.jsp(140,0) Attribute scale invalid according to the specified TLD Web.xml的變動，主要源于配置項的增加，以及servlet的增加 授權(quán)文件沒有相應(yīng)更新 兩次升級是：3.03.53

16、.53.5.5第49頁、授權(quán)文件不正確 3.5.5版程序+3.5版授權(quán)錯誤信息：2006-10-09 11:54:06 runqianReportLogger : INFO - 報表證書錯誤! Null 解決辦法：更新授權(quán)第50頁、授權(quán)文件不正確3.5版程序+3.5.5版授權(quán) 錯誤信息：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頁、授權(quán)文件不正確web.xml中沒有配置授權(quán)文件名 錯誤信息：2006-10-09 11:44:18 r

18、unqianReportLogger : INFO - 報表證書錯誤!授權(quán)文件錯誤: 未發(fā)現(xiàn)授權(quán)文件E:潤乾報表網(wǎng)上演示實例bin.webappsROOTWEB-INFxrq_license_server.dat, 請檢查是否在類路徑或絕對路徑上注意：xrq_license_server.dat是系統(tǒng)默認(rèn)的缺省授權(quán)文件名，如果web.xml中沒有配置，就默認(rèn)為xrq_license_server.dat解決辦法：在web.xml里配置授權(quán)文件 第52頁、授權(quán)文件不正確web.xml文件中授權(quán)文件名配置錯誤，和實際名稱不符 錯誤信息：2006-10-09 11:40:30 runq

19、ianReportLogger : ERROR - 授權(quán)文件錯誤java.lang.RuntimeException: 未發(fā)現(xiàn)授權(quán)文件E:潤乾報表網(wǎng)上演示實例bin.webappsROOTWEB-INF355開發(fā)版服務(wù)器061231.dat, 請檢查是否在類路徑或絕對路徑上解決辦法：仔細(xì)核對web.xml中授權(quán)文件名的配置，看是否和實際的相符，大小寫是否一致 第53頁4.2應(yīng)用服務(wù)器的差異JNDI前綴JDK版本中文的支持Servlet的 版本第54頁4.2.1應(yīng)用服務(wù)器的JNDI差異Datasource的前綴(web.xml中JNDIPrefix屬性值)服務(wù)器TomcatresinJBOSSw

20、eblogicwebsphereJNDIPrefixJava:comp/envJava:comp/envJava:第55頁4.2.2 jdk的版本比較容易導(dǎo)致jdk版本困擾的應(yīng)用服務(wù)器一般是websphere，由于websphere本身是IBM的產(chǎn)品，因此其自帶的JDK也是IBM的，雖然也符合J2EE的標(biāo)準(zhǔn)，但是在個別地方和SUN的還是有區(qū)別，例如其JIT(即時編譯器)就有問題，如果這個選項不關(guān)閉，程序有時候會出問題。 另外，和oracle ERP集成時必須注意，其自帶的jdk版本是jdk1.3，而且oracle ERP往往會在客戶端安裝一些程序，因此導(dǎo)致了客戶端的jdk版本為jdk1.3。但

21、是潤乾的打印applet要求jdk1.4，兩者會造成沖突。因此如果遇到這種情況，請聯(lián)系潤乾的技術(shù)支持，要一個專門在jdk1.3下編譯的打印applet包。 第56頁4.2.3中文的支持不同的應(yīng)用服務(wù)器，對中文的支持不一樣，例如tomcat4和tomcat5就有區(qū)別，此時如果參數(shù)是程序員自己接收并傳遞給tag標(biāo)簽的，那么要記得轉(zhuǎn)碼，尤其是報表模板文件名，否則容易出現(xiàn)莫名其妙的錯誤，例如報表模板找不到等等。 在websphere下，對中文的支持也比較差，打war包時不能有中文名的文件，web.xml文件中所有中文注釋要刪掉，且web.xml中的第一句關(guān)于文件字體的定義要寫成UTF-8，如下所示：

22、第57頁4.2.4 Servlet的版本一般由于servlet的版本導(dǎo)致的錯誤很少見，潤乾支持的servlet版本是servlet2.3，低于此版本servlet就不支持。一般來說比較早期的應(yīng)用服務(wù)器，其servlet版本比較低，可能會低于servlet2.3。 我們目前為止僅僅遇到過websphere4.0，其servlet版本比較低，但是也有解決辦法，就是把websphere5.0里的相關(guān)jar包拷貝過去替換掉，即可解決問題，websphere4.0本身往高版本兼容。 第58頁4.3操作系統(tǒng)的差異中文問題圖形問題第59頁4.3.1中文問題現(xiàn)象：如果含有帶斜線的單元格或者統(tǒng)計圖的報表在網(wǎng)頁上

23、發(fā)布時，統(tǒng)計圖或斜線單元格里的漢字會變成小方框，此時往往是服務(wù)器端操作系統(tǒng)的中文安裝包沒有裝全，導(dǎo)致報表里用到的字體在服務(wù)器端的操作系統(tǒng)里找不到，因此成了小方塊第60頁解決方法1.拷貝中文字體1、 在啟動java的時候加入如下參數(shù)，參數(shù)值為jdk的安裝路徑 -Dsun.java2d.fontpath=/j2se/jre/lib/fonts 2、 操作系統(tǒng)安裝完整的中文安裝包，然后把操作系統(tǒng)的中文字體文件拷貝到/j2se/jre/lib/fonts目錄下 3、打開/j2se/jre/lib目錄下的perties文件，把新添加的字體文件的對照信息加進(jìn)該文件即可 4、重

24、起webserver 第61頁解決方法2.安裝中文包1、操作系統(tǒng)安裝完整的中文安裝包 2、卸載jdk，重新安裝，讓jdk讀取新的中文字體文件 第62頁4.3.2圖形問題現(xiàn)象：含有帶斜線的或自動換行的單元格或者統(tǒng)計圖的報表在網(wǎng)頁上發(fā)布時，報表不能瀏覽錯誤信息：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及以上版本由于潤乾報表是被集成的，應(yīng)用中往往還有用戶自己的程序，如果服務(wù)器先裝載用戶自己的初始化程序，而該初始化程序的部分代碼可能存在干擾，導(dǎo)致潤乾報表設(shè)置的Djava.awt.headless=true參數(shù)不管用。此時必須在用戶自己的初始化程序中或者應(yīng)用服務(wù)器的啟動java的命令中加入該參數(shù)。 第64頁解決方法2.啟動x-window目的：創(chuàng)建一個圖形環(huán)境，在xwindow環(huán)境下啟動服務(wù)器命令：startx某些用戶的服務(wù)器機(jī)房不能

26、隨便出入，因此對服務(wù)器的操作只能通過終端來進(jìn)行，此時可以在啟動服務(wù)器的X-WINDOW后，用一個終端連接該X-WINDOW，保持連接，不要斷開，然后重起應(yīng)用服務(wù)器即可。如果系統(tǒng)運(yùn)行過程中，該終端被斷開了，就需要重新連接，并重起應(yīng)用服務(wù)器。 第65頁解決方法3.部署pja環(huán)境下載地址：http:/ 部署pja： 搜索 web服務(wù)器名 pja例如：weblogic pja websphere pja第66頁4.4數(shù)據(jù)庫的連接問題常見現(xiàn)象原因與解決方法第67頁4.4.1數(shù)據(jù)庫連接不上現(xiàn)象客戶端現(xiàn)象：表達(dá)式ds4.select(typeid,)中數(shù)據(jù)集未產(chǎn)生,可能因為未連接數(shù)據(jù)庫 服務(wù)器

27、現(xiàn)象：、表達(dá)式ds4.select(typeid,)中數(shù)據(jù)集未產(chǎn)生,可能因為未連接數(shù)據(jù)庫 2、沒有找到數(shù)據(jù)源java:comp/env/sqlsvr 請檢查服務(wù)器的數(shù)據(jù)庫連接池配置!javax.naming.NameNotFoundException: Name sqlsvr1 is not bound in this Context 第68頁4.4.2數(shù)據(jù)庫連接不上解決方法1、連接池配置錯誤（driverurluserpassword等寫法有誤）2、報表模板的數(shù)據(jù)集配置中的數(shù)據(jù)源名稱、web.xml中的datasource名稱、及應(yīng)用服務(wù)器的jndi名稱，三者存在不一致的現(xiàn)象3、web.xml中數(shù)據(jù)源沒有配置4、jdbc包缺失、版本不正確，或者沒有正確放在應(yīng)用服務(wù)器的java類路徑下 第69頁4.4.3字符集配置錯誤錯誤信息報表中所有從數(shù)據(jù)庫中取出的中文亂碼解決方法將web.xml中dataSource對應(yīng)的值中第3個選項由GBK改為ISO-8859-1或由ISO-8859-1改為GBK即可 dataSource ora9i,ORACLE,GBK,0; 第70頁4.4.3 sql需要轉(zhuǎn)碼錯誤信息帶中文的查詢語句或更新語句出現(xiàn)亂碼解決