迎新协作平台v1.安装及配置手册

1、成术Comsys Information Techenology Co.,研发心产品部迎迎宿产品V1.0_安装及配置手册迎新协作2015 年 5 月 18 日文档属性文档变更文档送呈目的审阅版本修订日期修订人描述1.02015 年 5 月 18日迎新宿管产品组创建属性内容制定部门研发中心迎新产品组作者迎新宿管产品组项目名称迎新协作文档标题迎新协作V1.0_安装及配置手册文档版本1.0文档日期2015 年 5 月 18 日文档状态初稿目录1前言51.1编写目的51.2适用范围51.3文档负责51.4文档说明51.5术语和符号说明51.6参考文档62产品简介73运行环境83.1硬件环境83.2环境

2、84安装包介绍94.1安装包名称94.2安装包结构95安装及配置概述105.1安装概述105.2升级概述105.3配置概述106数据库安装116.1初始化迎新系统数据库数据116.2安装迎新系统运行介质116.3初始化用户数据126.4安装验证127其它配置 tomcat 优化138常见问题 FAQ158.1Tomcat 启动端口已占用159图表目录161 前言1.1 编写目的本文档用于指导技术快速部署迎新协作的开发、测试和生产环境，使其能够根据特定的需求对迎新协作进行配置。1.2 适用范围负责产品安装的，包括实施、测试和二次开发。1.3 文档负责本手册由康赛研发中心迎新离校组负责起草、发布、

3、维护和解释。1.4 文档说明迎新协作是基于UT 框架，针对高校新生入学迎新阶段所开发的一项WEB 应用系统。迎新协作：招生数据处理系统、迎新系统、宿管系统以及支付系统的集合。1.5 术语和符号说明表格1.术语和符号说明1.6 参考文档迎新系统 V2.6.0_安装及配置手册术语描述UT 框架UT(UT Framework3.0)是开发迎新系统的框架。大迎新迎新协作的简称。2 产品简介高校迎新工作往往需要在 2-3 天时间内完成几千新生报到工作，在新生现场报到过程中涉及多个业务科室以及多套业务系统，势必会对学校迎新带来：1、多业务科室工作协调难，数据不能共享；2、多业务系统间的数据不能实现实时同步

4、，导致学生业务办理出错；3、现场报到压力大，工作效率低；4、迎到情况不同实时，学生报到率难统计；在此环境下引入数字化迎新解决方案势在必行，迎新系统 2.0 在部署使用过程中，学校各业务部门对系统提出了各类 2.0 版本外需求，这导致了大量的二开工作。在收集了 12 所学校迎新需求以及竞品功能的基础上，对迎新系统进行了大范围的升级，产出了迎新 3.0。3 运行环境3.1 最低配置要求3.1.1 应用服务器配置CPU：1*el Xeon(R) E5 2620RAM：8GDISK：256GOS：Windows Server 2008 R2（64bit）JDK：jdk-6u24-windows-x64

5、 （64bit）Tomcat：Apache Tomcat 7.0.52 windows（64bit）3.1.2 数据库服务器配置CPU：1*el Xeon(R) E5 2620RAM：8GDISK：512GOS：Windows Server 2008 R2（64bit）DB：5.5 （64bit）3.2配置3.2.1 应用服务器配置CPU：2*el Xeon(R) E5 2620/1*el Xeon(R) E7 4820RAM：16GDISK：512GOS：Windows Server 2008 R2（64bit）JDK：jdk-6u24-windows-x64 （64bit）Tomcat：A

6、pache Tomcat/7.0. 52 windows （64bit）3.2.2 数据库服务器配置CPU：2*el Xeon(R) E5 2620/ 1*el Xeon(R) E7 4820RAM：16GDISK：1TOS： Windows Server 2008 R2（64bit）DB：5.5 （64bit）4 安装包介绍4.1 安装包名称Dyx1.0.rar4.2 安装包结构迎新系统安装包主要是迎新系统安装包 dyx1.0。dyx1.0 安装包结构如下：Tomcat.rar此压缩包为运行迎新系统所需的 Tomcat 应用服务器。数据库备份此文件位于 dyx1.0 文件夹内，包含迎新系统所

7、需的数据库数据备份。Yx2.5.war此文件位于 dyx1.0 文件夹内，在 dyx1.0 下包含了迎新系统产品的运行介质。5 安装及配置概述5.1 安装概述迎新系统以WEB 应用的方式发布，无需安装，仅需解压 dyx1.0.rar。5.2 升级概述只需要将相关文件的版本覆盖原有文件即可完成对迎新系统的升级。5.3 配置概述迎新系统在window 下的配置总体来说分为三个步骤：1、 执行数据库备份文件，创建迎新系统数据库及表结构，并初始化数据。2、 进行产品的 tomcat 应用及数据源相关文件配置。3、 进入 UT 框架管理控制台修改迎新系统的配置。6 数据库安装与应用程序部署安装迎新系统主

8、要分为三步，第一步初始化迎新系统数据库数据，第二步安装迎新系统运行介质。第三步初始化迎新系统用户数据。6.1 初始化迎新系统数据库数据迎新系统数据库准备工作主要有 3 个步骤：1 以系统管理员登录，建立迎新系统数据库，在当前数据库中创建名称为dyx%用户。管理员要授予该用户 dba 的权限，用户要指定应用数据库。创建用户：CREATE USER dyx% IDENTIFIED BY 123456;：GRANT GRANT OPTION ON *.* TO dyx%;GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP,RELOAD, SHUTDO

9、WN, PROS, FILE, REFEREN, INDEX,ALTER, SHOW DATABASES, SUPER, CREATE TEMPORARY TABLES, LOCK TABLES, EXECUTE, REPLICATION SLAVE, REPLICATION CNT, CREATE VIEW, SHOW VIEW, CREATE ROUTINE, ALTER ROUTINE, CREATE USER, EVENT, TRIGGERON *.* TO dyx%;2 创建数据库sys,此名字为默认租户名。3 导入 dyx1.0.sql，引入迎新系统运行所必须的数据库结构和初始化数

10、据。6.2 安装迎新系统运行介质迎新系统是以 WEB 应用的形式发布无需安装，只需按照实际的部署情况调整一下系统配置即可。1.将“dyx1.0.rar”解压,然后把里面的 dyx1.0.war 文件拷贝至webapps 文件夹里。2.根据实际运行环境，对 dyx1.0 WEB-INFclassesdev perties.xml 中关于hibernate的配置做修改（修改数据库的 IP 地址和数据库名），将配置文件中修改为对应的数据连接，用户名，。如图 1 所示。图 1迎新系统数据库配置3.在dyx1.0 WEB-INFclassesdev onfig.xml 中搜索defaultTenant

11、修改为你创建的数据库名字。如图 2 所示。图 2 迎新系统租户配置6.3 初始化用户数据启动迎新系统，进入UT 框架管理控制台，初始化用户数据。1 根据学校的实际情况，创建学校的组织机构。图 3 部门管理界面2 将迎新系统用户数据导入 UT 框架的用户数据库表(UT_USERS)，初始化对应的账号和。3 分配对应的用户权限图 4用户管理界面6.4 安装验证启动迎新系统，用迎新系统的用户账号和，http:/:8080/dyx1.0/login.action (最终用户地址)，如果能到该账号对象的应用视图则说明迎新系统安装部署成功。6.5 迎新系统部分功能配置说明1.现场办理分配宿舍权限配置a)登

12、陆 administrator 到 ut，在组织管理-角色管理中，获得想要分配权限的角色的标示，如图 5 院系老师的标示符为 yxls。图 5 角色管理b)在拿到院系老师标示后，在其前面添加 ROLE_，组成字符串 ROLE_yxls，并在 dyx1.0 WEB-INFclassesdev onfig.xml 中图 6 处进行配置。图 6 表示为教务处和院系老师开放了现场办理分配宿舍的功能。图 6 现场办理分配宿舍的权限配置2.宿舍管理功能权限配置a)与 1 中现场办理分配宿舍同样方式拿到角色标示。b)在 dyx1.0 WEB-INFclassesdev onfig.xml 中图 7 中进行相

13、应配置。图 7中表示为大迎新角色和教务处角色分配了该功能。图 7 宿舍管理功能权限配置3.门户首页展示相关配置修改门户首页栏目展示。如图 8 所示，将学在康赛修改为学在理工。图 8 门户首页栏目a)登陆 administrator 账号到 utb)在菜单管理中修改菜单名字。如图 9 中将学在康赛改为学在理工图 9 菜单管理c)在内容管理器中的栏目管理里面，修改对应栏目的名字。如图 10 将学在康赛改为学在理工即可。图 10 栏目管理d)修改后效果如图 11 所示图 11 修改后效果图4.支付接口相关配置在 dyx1.0 WEB-INFclassesyxperties 中，将图 12 中画红线的

14、四个 url 改为支付的地址即可。图 12 支付接口相关配置7tomcat 优化1.根据本机的 jdk 设置，修改文件中的“红色”内容部分。修改 startup.bat 文件，将setJAVA_HOME=C:jdk1.6.0_06中的红色部分改为自己的 JAVA_HOME 信息。2.更改 tomcat 进程名，即在 setclasspath.bat 文件中进行如下设置：set_RUNJAVA=”%JRE_HOME%binYx2.5”3.修改迎新系统confserver.xml 文件，详细信息如下：根据安装宿管系统产品的系统环境，修改上面的“红色”内容部分，即 tomcat 服务器启动所需的相关

15、端口。上面的“蓝色”内容用于设置 tomcat 启动 GZIP 服务，在指定内容输出是进行压缩处理。4.调整内存，在 bin/catalina.bat 文件中添加：setJAVA_OPTS=-server-Xms4096MXmx4096M-XX:+AggressiveOpts -XX:+UseBiasedLocking -XX:PermSize=512M-XX:MaxPermSize=1024M-XX:+UseConcMarkSpGC-XX:+UseParNewGC-XX:+CMSParallelRemarkEnabledpacFullCollection-XX:+UseFastAcsorMe

16、thods -XX:+UseCMSInitiatingOccupancyOnly-Djava.awt.headless=true红色部分为 64 位 jdk 下预设定值。注意： 、 注意要避免与已经运行的ZUSIGZ 的服务器端口重复 、 如果当前文件中没有“蓝色”内容部分，请在相应位置追加上面的“蓝色”内容。8数据备份新建一个 backup_recovery.bat 的批处理文件，文件内容为：echo offsetfilename=yx_%date:0,4%年%date:5,2%月%date:8,2%日_%time:0,2%time:3,2%开始备份数据.expsysucit file=D:

17、数据备份%filename%.dmp log=D:数据备份日志%filename%.log owner=yxdbaecho 备份完毕！将该批处理添加为系统定时任务开始所有程序附件系统工具任务计划程序创建任务9数据恢复在 cmd 下，执行以下语句：impsysucit file=D:数据备份 yx_2014 年 9 月 1 日_0000.dmp full=y；红色标记的为需要恢复的数据库备份文件文件名。10 常见问题 FAQ10.1 上传时， 选择文件按钮不出现？A:所用浏览器了 Flash 插件，或者使用的 Flash 插件版本太低，浏览器自动。启用 Flash 插件后，图标能正常显示。10.2 Tomcat 启动端已占用A:如果系统服务器的系统日志里出现下面的语句：严重: Error starting endpo.BindException: Address alreadyin use: JVM_Bind:80at.JIoEndpo.init(JIoEndpo.java:502)at.JIoEndpo.start(JIoEndpo.java:519)提示端口 80 被占用，需修改启动端口，请参照章节 7 其它配置 tomcat 优化重新启动系统服务。10.3 Tomcat