拓普工商综合业务管理系统.doc

拓普工商综合业务管理系统拓普工商综合业务管理系统 配置管理手册配置管理手册 北京拓普丰联信息工程有限公司北京拓普丰联信息工程有限公司 目目 录录 1概述概述-5 1.1阅读对象-5 2安装安装 DB2 V9 及初始化配置及初始化配置 -5 2.1准备-5 2.2安装需求-5 2.3详细安装步骤-5 2.4DB2 的配置与建库-14 3WEBSPHERE 安装及部署安装及部署-15 3.1WEBSPHERE6.1 主程序的安装-15 3.2补丁工具的安装 -20 3.3补丁的安装 -24 3.4WEBSPHERE配置 -28 3.4.1启动控制台 -28 3.4.2配置数据源 -29 3.4.3测试数据源 -41 3.4.4配置 WebSphere 变量-43 3.4.5部署应用程序（应用程序要用 JDK1.5 编译） -46 3.4.6复制配置文件 -52 3.4.7优化配置 -52 4TOCMAT 安装及部署安装及部署 -63 4.1安装准备 -63 4.2安装需求 -63 4.3安装准备 -63 4.4部署报表应用 -67 4.4.1创建 birt 数据表 -67 4.4.2配置 Birt 应用运行参数-67 4.4.3配置 IcisReport 数据源-68 4.5部署 ICISREPORT.WAR和TOPBIRT.WAR-69 4.5.1添加 DB2 的 JDBC 驱动-69 4.5.2执行 birt 应用的数据库脚本和存储过程 -69 4.5.3部署 birt 的报表和查询文件 -69 4.5.4部署 war 包 -70 4.6启动 ICISREPORT应用-70 4.7关键配置 -70 5机构管理机构管理 -70 5.1机构管理 -70 5.2添加菜单 -78 5.3撤消注销机构 -79 5.4业务环节分配 -80 5.5岗位管理 -81 5.6职位代理 -83 5.7撤消职位代理 -83 5.8切换职位 -84 5.9提示 -85 6文书配置文书配置 -86 6.1文书种类配置 -86 6.2业务字典配置 -87 6.3模板管理 -89 6.4文书模板配置 -92 6.5文号配置 -93 6.6文书业务分类配置 -94 7打印配置打印配置 -96 7.1快速添加模板分类 -96 7.1.1什么是模板分类？-97 7.1.2如何添加新的模板分类？-97 7.1.3什么是数据集？ -97 7.1.4如何添加数据集？-98 7.2快速添加模板 -98 7.2.1如何添加模板？ -99 7.3快速编辑模板 -99 7.3.1如何编辑一个新模板？-100 8BIRT RCP DESIGNER 安装部署安装部署 -104 8.1安装前准备-104 8.2配置 BIRT RCP DESIGNER系统 -104 9开发开发 BIRT 查询文件查询文件-107 9.1新建BIRT查询-107 9.2创建数据集-108 9.3创建报表参数-113 9.4选择主页-117 9.5编辑报表-118 9.6参数绑定-120 9.7预览-123 10报表系统安装配置报表系统安装配置-125 10.1TOCMAT安装-125 10.1.1安装准备-125 10.1.2安装需求-125 10.1.3安装准备-125 10.2部署应用-129 10.2.1创建 birt 数据表-129 10.2.2配置 Birt 应用运行参数 -129 10.2.3配置 IcisReport 数据源-130 10.2.4部署 IcisReport.war 和 topbirt.war -131 添加 DB2 的 JDBC 驱动-131 执行 birt 应用的数据库脚本和存储过程 -131 部署 birt 的报表和查询文件 -131 部署 war 包-132 10.2.5启动 IcisReport 应用-132 1概述概述 本文档主要描述了工商业务综合管理系统 （以下简称 TopIcis）的安装配置及系统初始化 的详细步骤。 1.1 阅读对象阅读对象 TopIcis 系统管理员以及系统开发和实施人员。 2安装安装 DB2 V9 及初始化配置及初始化配置 2.1 准备准备 取得 DB2 Enterprise Edition V9.0 for Windows 安装光盘。 2.2 安装需求安装需求 磁盘：至少 1G 的 FAT32 或 NTFS 格式磁盘空间。推荐 3G 的 NTFS 格式磁盘空间。 内存和 CPU：至少 256MB 内存，推荐 2GMB 内存。对于 32 位 DB2 产品，需要有奔腾或 与奔腾兼容的 CPU。对于 64 位 DB2 产品，需要 Itanium 或与 Itanium 兼容的 CPU。 操作系统：Windows 2000/XP/2003，推荐使用 Windows 的各种 server/advance server/data center 版本。 2.3 详细安装步骤详细安装步骤 运行 DB2 光盘，打开并运行 setup.exe 开始安装，如图 1 图 1 如上图，单击【Install a Product】然后选择 DB2 Enterprise Server Edition（服务器端）点击 【Install New】 ，进入图 2 图 2 单击【下一步】 ，如图 3 图 3 选择“我接受许可证协议的全部条款（A） ” ，点击【下一步】 ，如图 4 图 4 建议使用默认典型安装。点击【下一步】 ，如图 5 图 5 建议使用系统默认安装。点击【下一步】 ，如图 6 图 6 默认目录为 C: Program FilesIBMSQLLIB，为了获得更好的性能，改为非操作系统所在的分 区上安装 DB2，并且不在 Program Files 文件夹内安装，目的是避免目录中的空格引起不必要的麻 烦。实施人员可点击“更改”选择程序安装的路径。例子仅供参考。点击【下一步】 ，如图 7 图 7 本例是在非域用户(administrator 用户)环境下安装，用户名为 administrator,密码为该用户登录 系统的密码。如果计算机在域内，则需要输入域用户的用户名和密码。取消“对其余 DB2 服务使 用同一个用户名和密码”选择。点击【下一步】如图 8 图 8 如上图：采用系统默认。点击【下一步】如图 9 图 9 点击【下一步】如图 10 图 10 点击【下一步】如图 11 图 11 本例是在非域用户(administrator 用户)环境下安装，用户名为 administrator,密码为该用户登录 系统的密码。并且选中“对其余 DB2 服务使用同一个用户名和密码（U） ” ，点击【下一步】如图 12 图 12 点击【下一步】如图 13 图 13 取消“设置 DB2 服务器以发送通知”选项。点击【下一步】如图 14 图 14 取消“启用操作系统安全性”选项。点击【下一步】如图 15 图 15 推荐将设置信息复制并保存起来，以供查看。点击【完成】如图 16 图 16 系统会进行文件安装。当安装完毕后进入图 17 图 17 点击【完成】 ，完成 DB2 服务器的安装。DB2 接着会开始启动服务，请看下节的 DB2 的配置。 2.4 DB2 的配置与建库的配置与建库 注意： db2 在创建数据库时候，会自动创建一个模式。 “模式名”会默认为“当前用户名” 。 由于该系统在设计时采用 topicis 模式，所以登陆系统创建数据库的用户，名称必需为“topicis” 。 在本机新建一个 topicis 用户，密码可自定义，但用户名必须为“topicis” .然后用该用户登录 来创建数据库。 在 dbscriptdb2sql 下提供了批处理命令程序，执行命令后程序自动建立数据库、缓冲池、表 空间、数据库表，自动初始化代码表和系统必要数据。操作如下： 在本机新建一个 topicis 用户，登录后在 doc 下执行 dbscriptdb2sql dbSql.bat，本批处理命令 有两个参数，参数 1 为数据库名，参数 2 为库表存放磁盘，只能输入本机存在的盘符字母(例如:D)。 如果不输入参数,默认数据库名为 topicis，默认库表存放磁盘为 D 盘，请参看 dbscriptdb2sql 下 readme。 关于导入打印、文书、知识库数据请参看 dbscriptimportdata 下 DB2 数据导入导出.doc，里面 也提供了批处理命令。 3WebSphere 安装安装及部署及部署 3.1 WebSphere6.1 主程序的安装主程序的安装 点击安装文件，在安装向导初始化完成后，进入安装界面，如下图所示： 点击“启动 WebSphere Application Server Network Deployment 的安装向导”开始安装，如图 18： 图 18 点击【下一步】 ，如图 19： 图 19 选择“我既接受 IBM 条款也接受非 IBM 条款”后，点击【下一步】 ，如图 20： 图 20 系统会进行必备软件检查，当检查成功后，点击【下一步】 ，如图 21： 图 21 推荐采用默认选项（如果选中“安装样本应用程序”程序在安装过程会自动创建几个样本应 用程序） ，然后点击【下一步】 ，如图 22： 图 22 在上图中，点击【浏览】按钮，自定义选择程序安装路径（也可采用默认路径） 。点击【下一 步】 ，如图 23： 图 23 如图 23：选择“应用程序服务器” ，点击【下一步】进入图 24： 图 24 建议选中“启用管理安全性”前面的选择，并输入用户名和密码，此用户用来管理 websphere。点击【下一步】进入图 25： 图 25 点击【下一步】 ，进入组件安装和配置界面，如图 26： 图 26 如上图，当组件安装和配置完成后，进入图 27： 图 27 如图 27，建议取消“启动第一步控制台”选项。到此，已经完成了 WebSphere 主程序的安 装，程序会自动创建一个名字 AppSrv01 的“概要表” ， （注：这里的“概要表”相当于 weblogic 中的一个“domain-server” ） 。点击【完成】完成安装。 3.2 补丁工具的安装补丁工具的安装 接着需要安装 WebSphere6.1 的补丁及打补丁的工具。首先安装补丁工具，点击补丁工具安装 文件，进入安装界面，如图 28 图 28 在图 28 中，点击【下一步】按钮，如图 29： 图 29 选择“我既接受 IBM 条款也接受非 IBM 条款”后，点击【下一步】 ，如图 30： 图 30 系统完成必备软件检查。点击【下一步】 ，如图 31： 图 31 在上图中，点击【浏览】按钮，自定义选择程序安装路径（也可采用默认路径） 。点击【下一 步】 ，如图 32： 图 32 点击【下一步】 ，进入组件安装和配置界面，如图 33： 图 33 如上图，当组件安装和配置完成后，进入图 34 图 34 此时点击【完成】完成“补丁工具”的安装。 3.3 补丁的安装补丁的安装 安装 WebSphere 补丁（注：安装补丁时应关闭 WebSphere 服务） ，打开补丁工具如图 35 图 35 点击【下一步】如图 36 图 36 选择安装路径，建议安装路径和主程序相同。点击【下一步】如图 37 图 37 选择“安装维护包” ，点击【下一步】如图 38 图 38 点击【浏览】 ，选择 WebSphere6.1 补丁文件 6.1.0-WS-WAS-WinX32-FP0000003.pak，然后点 击【下一步】 ，如图 39 图 39 点击【下一步】 ，进入组件安装和配置界面，如图 40 图 40 如上图，当组件安装和配置完成后，进入图 41 图 41 点击【完成】按钮，完成补丁的安装。至此 WebSphere6.1 及其补丁安装完毕。 3.4 WebSphere 配置配置 3.4.1 启动控制台启动控制台 在 cmd.exe 中进入 D:IBMWebSphereAppServerprofilesAppSrv01bin 下，运行 startserver server1,启动后，在 IE 中输入 http:/localhost:9060/ibm/console 进入控制台登陆界面，如图 42 图 42 在文本框中输入用户标识（可以为空） ，然后点击【登录】 ，进入主界面，如图 43 图 43 3.4.2 配置数据源配置数据源 展开控制台左边的树，进入“资源JDBCJDBC 提供程序” ，如图 44 图 44 在作用域中选择自己的节点和服务器。点击【新建】 ，进入如图 45 页面： 图 45 选择数据库类型、选择提供程序类型，选择实施类型，如图 46 图 46 然后点击【下一步】 ，如图 47 图 47 直接点击【下一步】 ，出现如图 48 页面： 图 48 点击【完成】 ，如图 49 图 49 点击【保存】 ，完成“JDBC 提供程序”的创建。进入图 50 图 50 创建数据源，如图 50，点击“DB2 Universal JDBC Driver Provider”进入图 51 图 51 此页面的内容会自动生成，无需修改；在类路径框中需添加 db2jcc.jar、db2jcc_license_cu.jar、db2jcc_license_cisuz.jar 三个 jar 包，并在文本框中指向这三个包。 这三个包位于该项目“第三方包 lib”文件夹中。 方案一：在类路径框中用绝对路径指向三个包。 方案二：如果类路径如图所示的话，必须到“环境WebSphere 变量”中配置 “DB2UNIVERSAL_JDBC_DRIVER_PATH、UNIVERSAL_JDBC_DRIVER_PATH”的路径，使 其指向 db2jcc.jar、db2jcc_license_cu.jar、db2jcc_license_cisuz.jar 三个 jar 包的真实路径 点击【确定】 ，出现如图 52 图 52 点击【保存】进入图 53 图 53 在作用域中选择自己的节点和服务器。点击【新建】 ，进入如图 54 图 54 在“数据源名输入“topicms3ds”,JNDI 名称输入“topicms3ds”.点击【下一步】 ，进入图 55 图 55 选择“选择现有的 JDBC 提供程序”然后在下拉列表中选择刚建的“DB2 Universal JDBC Driver Provider” JDBC 提供程序。点击【下一步】 ，进入图 56 图 56 在数据库名输入“topicis”,驱动程序类型采用默认“4” ，服务器名称根据数据库部署机器有实 施人员决定，这里仅供参考。端口号采用默认“50000” 。注意：取消“将此数据源用于容器管 理的持久性(CMP)选择。点击【下一步】 ，进入图 57 图 57 点击【完成】 ，进入图 58 图 58 点击【保存】 ，进入图 59 图 59 如上图点击“topicms3ds”,进入图 60 图 60 点击【JAAS-J2C 认证数据】 ，如图 61 图 61 点击【新建】 ，如图 62 图 62 如上图：别名可自行定义，用户标识 （数据库用户名）输入“topicis”，密码（数据库密码） 输入“topicisdb2”. 点击【确定】 ，进入图 63 图 63 点击【保存】 ，完成 JAAS-J2C 认证数据的创建。 在数据源中配置“组件管理的认证别名”此步骤只有在完成“完成 JAAS-J2C 认证数据的创 建”后才能进行。如图 59 点击“topicms3ds”,进入图 64 图 64 在“组件管理的认证别”名中选择刚创建的“JAAS-J2C 认证数据” 。点击【确定】完成数 据源的创建和配置。 3.4.3 测试数据源测试数据源 展开控制台左边的树，进入“资源JDBC数据源”如图 65 图 65 选中“topicms3ds”数据源，点击上方的【测试连接】 ，即可测试数据源是否连接成功，如果连 接成功，则会显示如图 66 图 66 3.4.4 配置配置 WebSphere 变量变量 展开控制台左边的菜单树“环境WebSphere 变量” ，进入如图 67 页面： 图 67 如果前面在配置数据源时，用到了“DB2UNIVERSAL_JDBC_DRIVER_PATH”变量，则点 击“DB2UNIVERSAL_JDBC_DRIVER_PATH” ，配置其值，如图 68： 图 68 在“值”一栏中填入此变量的真实路径即可（此处路径仅供实施人员参考，具体实施过程中， 有其 jar 包所在的真实路径决定该值） ，然后点击【应用】 ，页面上方会出现提示信息，如图 69 图 69 点击【保存】 ，完成变量设置。 3.4.5 部署应用程序（应用程序要用部署应用程序（应用程序要用 JDK1.5 编译）编译） 展开主控制台左边的菜单树“应用程序企业应用程序” ，点击进入，如图 70： 图 70 （图中显示的几个是系统自带的） ，下一步安装自己的应用程序，点击【安装】 ，进入如图 71： 图 71 在“新应用程序的路径”一栏中，本地文件系统，点击【浏览】 ，选择路径，然后填写上下文 根，如图 72： 图 72 然后点击【下一步】 ，如图 73： 图 73 建议把“应用程序名”改为 TopIcis，选中“预编译 JavaServer Page 文件” ，其他采用默认设 置。然后点击【下一步】 ，如图 74： 建议选中此项 图 74 选中全部安装模块，点击【下一步】 ，如图 75： 图 75 选中“工商综合管理系统应用”模块，点击【下一步】 ，如图 76： 图 76 直接点击【完成】 ，出现下图安装信息，如图 77： 图 77 出现如图 77 安装信息，则说明安装成功，点击 “保存到主配置” ，即可完成应用程序的安 装。 3.4.6 复制配置文件复制配置文件 首先将 build 目录中 res 子目录中的内容拷贝到 WebSphere 安装目录的AppServerlibext 目 录下面。例如：本机的路径为 D:IBMWebSphereAppServerlibext 如图 78（该例子仅供参考） 。 图 78 注意：这些配置文件会在 WebSphere 服务器启动时候加载，所以第一次部署后，要重新启动 WebSphere 服务器. 3.4.7 优化配置优化配置 配置 JTA 时间 展开主控制台左边的菜单树“服务器应用程序服务器” ，点击进入，如图 79： 图 79 点击“server1” ，进入如图 80 页面： 图 80 展开右侧“容器设置容器服务” ，如图 81： 图 81 点击“事务服务” ，进入如图 82 页面： 图 82 在“常规属性”中有“总计事务生存期超时” ，在此设置 JTA 的时间，在此设置为 3000 秒。 然后点击【应用】 ，如图 83： 图 83 点击上方的【保存】 ，即可完成 JTA 时间的配置工作。 配置 JDBC 时间 展开主控制台左边的菜单树“资源JDBCJDBC 提供程序” ，点击进入，如图 84 图 84 点击蓝色的“DB2 Universal JDBC Driver Provider”,进入如图 85 页面： 图 85 点击右侧的“数据源” ，如图 86 图 86 然后点击“topicms3ds” ，进入如图 87 页面： 图 87 点击右侧的“连接池属性” ，进入如图 88 页面： 图 88 在“连接超时”这一项填写 JDBC 连接超时的时间，这里改为“3000 秒” ，然后点击【应用】 ， 出现如图 89： 图 89 点击上方【保存】 ，即可完成 JDBC 连接时间的配置工作。 配置调试端口 展开主控制台左边的菜单树“服务器应用程序服务器” ，点击进入，如图 90： 图 90 点击“server1” ，进入如图 91 页面： 图 91 点击右侧“其它属性调试服务” ，进入如图 92 页面： 图 92 在这里配置“JVM 调试端口”为“7777” ， “JVM 调试参数”为“-Dwas.debug.mode=true|- Dpiler=NONE -Xdebug -Xnoagent - Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=7777” 然后点击【应用】 ，如图 93： 图 93 点击【保存】 ，即可完成配置调试端口的配置工作。 4Tocmat 安装安装及部署及部署 4.1 安装准备安装准备 获取 apache-tomcat-5.5.20.zip 或者 5.5 系列的其他版本，推荐用 5.5.20 版本。可以去 上直接下载。 说明：apache-tomcat-5.5.20 需要 Java SDK 1.5 的运行环境和报表工具等也需要 1.5 的开发库。 4.2 安装需求安装需求 磁盘：至少 0.5G 的 FAT32 或 NTFS 格式磁盘空间。推荐 1G 的磁盘空间； 内存和 CPU：至少 512MB 内存，推荐 1GMB 内存。 操作系统：Windows 2000/XP/2003，推荐使用 Windows 的各种 server/advance server 版本 4.3 安装准备安装准备 用 WinRAR 打开 apache-tomcat-5.5.20.zip，解压缩到一个目录，假如是 D 盘根目录下（建议 不要安装到 C 盘） ，操作方法如下图： 解压缩后文件的目录如下 如上图，用记事本或者 EditPlus 打开 D:apache-tomcat-5.5.20bincatalina.bat 文件，打开方法 如下： 打开后，如下所示， 如上图，在在红色标识的 42 行处，加入如下信息： set JAVA_HOME=D:j2sdk15 set JAVA_OPTS=-Xms256m -Xmx512m 其中 D:j2sdk15 表示你本机 Java SDK 的安装目录，根据实际情况做相应更改！ 加入后如图： 保存修改，然后打开 D:apache-tomcat-5.5.20confserver.xml，在 77 行处，添加一个属性设置： URIEncoding=“GBK“，这样可以避免页面乱码。设置后如下图所示： 保存修改，然后双击运行 D:apache-tomcat-5.5.20binstartup.bat，启动 tomcat，启动后出现如 下窗口，最后一行提示信息为 “Server startup in xxx ms”时，表示安装 Tomcat 成功！ 4.4 部署报表应用部署报表应用 4.4.1 创建创建 birt 数据表数据表 在 DB2 中，以业务系统 TopIcis 所用的数据库和模式连接 DB2 数据库，执行 birt_db2.sql，完 成 birt 数据表的创建和初始化。 4.4.2 配置配置 Birt 应用运行参数应用运行参数 关闭 tomcat，将 IcisReport-res 目录下的 perties 文件复制到 D:apache-tomcat- 5.5.20commonclasses 目录下，并用记事本打开该文件，该文件内容如下： # 报表工作目录 用于存放.rptdesign 或.rptlibrary 文件 默认为当前 webapp 根目录 birt.viewer.working.folder=D:/topbirtRPT # 报表编译后的.rptdocument 文件存放目录 $birt home/documents birt.viewer.document.folder # 报表图片存储目录 默认为$birt home/report/images birt.viewer.image.dir # 报表日志存储目录 默认为$birt home/logs birt.viewer.log.dir # 报表日志级别 可设置级别：SEVERE WARNING INFO CONFIG FINE FINER FINEST OFF birt.v