润乾报表安装部署快文
润乾报表安装部署快文
此文档适用对象： 1 初次接触润乾报表，又想快速了解润乾部署集成的工程师；
2 某些项目的招投标文件中需要写入润乾报表部署的文档；
此文档可与”润乾报表在J2EE下的部署“文档结合使用
一润乾软件文件
runqian-v4.5.5-install.exe是润乾软件的安装文件
Designer2012-12-31V4.0.lic 设计器使用的授权
Server2012-12-31V4.0Windows.lic 引擎在windows操作系统下使用的授权
Server2012-12-31V4.0Linux.lic引擎在linux操作系统下使用的授权
Server2012-12-31V4.0Other.lic引擎在unix操作系统下使用的授权
二安装润乾软件
1 demo目录结构
双击安装文件，默认安装，一直到完成，安装完后，会生成如下目录结构：
C:\Program Files (x86)\reportHome\webapps\demo
reportFiles 放置报表文件的目录
reportJsp 放置jsp文件的目录
WEB-INF 规定目录，放置应用配置文件、类包等
2 WEB-INF的目录结构
C:\Program Files (x86)\reportHome\webapps\demo\WEB-INF
classes 放置java类文件、授权文件
将第一节中的4个授权文件拷贝到此文件夹下
lib 放置jar文件
lib 下的jar包
3 两个重要的配置文件
reportConfig.xml
web.xml
3.1 reportConfig.xml文件里的主要内容：
<?xml version=”1.0″ encoding=”UTF-8″ ?>
<reportConfig>
<config>
<name>logConfig</name>
<value>/WEB-INF/runqianReportLog.properties</value>
</config>
<config>
<name>license</name>
<value>runqianWindowServer.lic</value>
</config>
<config>
<name>reportFileHome</name>
<value>/reportFiles</value>
</config>
<config>
<name>semanticsFile</name>
<value>/WEB-INF/runqianSemanticFile.xml</value>
</config>
<config>
<name>JNDIPrefix</name>
<value>java:comp/env</value>
</config>
<config>
<name>dataSource</name>
<value></value>
</config>
注释
（1）
<config>
<name>license</name>
<value>runqianWindowServer.lic</value>
</config>
这个配置项，配置的就是授权文件的名称，将runqianWindowServer.lic修改成授权文件的名称就可以了，在此例里，是修改为：Server2012-12-31V4.0Windows.lic
（2）
<config>
<name>JNDIPrefix</name>
<value>java:comp/env</value>
</config>
Jndi环境串前缀，不同的应用服务器前缀不同（比如：tomcat的前缀为：java:/comp/env；weblogic则不需要，将这个配置项的value值置空就可以）
（3）
<config>
<name>dataSource</name>
<value></value>
</config>
数据源jndi的名称，与应用服务器（比如：weblogic）里配置的jndi一致就可以了
3.2 web.xml文件里的内容：
<?xml version=”1.0″ encoding=”UTF-8″ ?>
<!DOCTYPE web-app PUBLIC “-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN” “http://java.sun.com/dtd/web-app_2_3.dtd”>
<web-app>
<servlet>
<servlet-name>SetContextServlet</servlet-name>
<servlet-class>com.runqian.util.webutil.SetContextServlet</servlet-class>
<load-on-startup>2</load-on-startup>
</servlet>
<servlet>
<servlet-name>reportServlet</servlet-name>
<servlet-class>com.runqian.report4.view.ReportServlet</servlet-class>
<init-param>
<param-name>configFile</param-name>
<param-value>/WEB-INF/reportConfig.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet>
<servlet-name>DMServlet</servlet-name>
<servlet-class>com.raq.web.view.DMServlet</servlet-class>
<init-param>
<param-name>configFile</param-name>
<param-value>/WEB-INF/dmConfig.xml</param-value>
</init-param>
<load-on-startup>10</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>reportServlet</servlet-name>
<url-pattern>/reportServlet</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>DMServlet</servlet-name>
<url-pattern>/DMServlet</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>DMServlet</servlet-name>
<url-pattern>/DMServletAjax</url-pattern>
</servlet-mapping>
<taglib>
<taglib-uri>/WEB-INF/runqianReport4.tld</taglib-uri>
<taglib-location>/WEB-INF/runqianReport4.tld</taglib-location>
</taglib>
</web-app>
三部署润乾软件
1 开发好的报表文件放置在reportFiles文件夹
2 页面文件放置在reportJsp文件夹
3 授权文件放置在classes文件夹
4 reportConfig.xml文件中的授权配置项修改一致
将上面4项工作做好了，就可以直接打war包了
打好war包，就可以直接部署到应用服务器上去了
（此例中 ，比如是weblogic服务器，则按照weblogic部署java应用的方法直接部署了）
四嵌入其他软件，与其他软件一起部署
润乾报表也可以嵌入其他软件中，与其他软件一起部署
从第二节的目录结构中，可以看出，润乾报表的demo目录，是一个典型的web应用的目录结构，其他软件的目录结构也是web应用目录结构，则只需要将润乾报表的相应文件拷贝到其他软件的相对应的目录结构中就可以了，下面来拷贝相应的文件
（为了方便理解，在这里，将其他软件的应用名称取作app，润乾的应用叫demo）
1 将demo下的reportFiles文件夹拷贝到app下
2 将demo下的reportJsp文件夹拷贝到app下
3 将demo下的runqianReport4Applet.jar文件拷贝到app下
4 将demo下的j2re-1_4_1-windows-i586-i.exe文件拷贝到app下
5 因为app下也有WEB-INF目录，所以，这个目录就不需要拷贝了，只需要将其里面的文件拷贝过去
6 将demo\WEB-INF\classes下的授权文件拷贝到app\WEB-INF\classes下
7 将demo\WEB-INF\lib下的jar包拷贝到app\WEB-INF\lib下
8 将demo\WEB-INF\下的reportConfig.xml文件拷贝到app\WEB-INF\下（授权文件的名称修改一致）
9 将demo\WEB-INF\下的web.xml文件的内容中的配置项内容复制到app\WEB-INF\web.xml中（因为app应用中，也有web.xml文件，所以，只是从demo中的web.xml中复制配置项的内容到app应用中的web.xml中就可以了）
到此，就将润乾软件与其他软件嵌入好了，直接将app应用打包，部署到应用服务器（比如：weblogic）上就可以了
五永久授权说明
第一节中讲到的4个授权文件，指的是开发时使用的授权文件，它都是有时间限制的，在它限制的时间期内有效（比如：Server2012-12-31V4.0Windows.lic，这个授权在2012年12月31日之前有效），正式服务器中需要用润乾的永久授权
1 永久授权是什么？
永久授权是运行润乾报表的带有机器特征码的没有时间限制的正式授权文件
2 机器特征码是什么？
机器特征码是为了制作永久授权，由润乾公司提供程序从用户的服务器上获取硬件和操作系统信息，生成的一个数字串，将这个数字串制作在永久授权中，这样就绑定了授权与服务器。
3 永久授权怎么获取？
先是用户准备好了服务器（硬件，软件都装好后，稳定使用的），再由润乾公司提供一个程序，运行这个程序得到一个数字串，润乾公司根据这个数字串，会重新制作一个绑定了这串数字串的授权（既为永久授权），再将这个授权发给用户，用户将这个授权拷贝到应用中的classes文件夹下，修改reportConfig.xml文件中的授权配置项的文件名，重新打包发布就可以了。