汇文应用服务程序Java版安装使用说明（ver:0.0.1.6）
江苏汇文软件有限公司
2014年10月
一．服务器部署
·
1．服务器环境需求（如果部署在OPAC服务器，请参看特别说明）
服务器需安装jre6.0最新版本(windows下需安装jre-6u17或以上版本)，tomcat 5.0或以上版本；
·
2．在\Tomcat\webapps目录下创建一个新目录HwAppServer，解压缩HwAppServer.zip文件中所有文件及文件夹到该目录下（注意目录大小写,以及目录是否重复）；
·
3．配置数据库连接
a．汇文数据库配置工具打开方式：双击【
\HwAppServer\WEB-INF\classes\config\数据库设置.BAT】（在win2008+或者win7+的系统中右击以管理员的身份运行），
b．如果要使用opac或者libacs等外部程序的数据库配置，在汇文数据库配置工具中选择【使用opac等外部程序现有的数据库配置文件】这个tab,如下图：
![K8J_I@R0]`U6Z$5}Z00V{9X](help.files/image001.jpg)
填入opac的数据库配置文件（config.properties）的绝对目录，点击一键关联使用即可。
注意事项：关联配置文件名称请不要修改。
c．如果要使用安全级别更高的本地数据库配置，在汇文数据库配置工具中选择【生成并使用自己程序的数据库配置文件】这个tab,
填入数据库IP,端口号，实例名(sid)，用户名，密码对应信息，然后点击一键生成使用即可。
注意事项：关联配置文件名称请不要修改。
·
4．重启TOMCAT服务
·
5．可以通过http://IP:PORT/HwAppServer/访问服务管理页面（如果部署在OPAC服务器上，则默认端口号为8081）
（请注意，访问时，必须是http://IP:PORT/HwAppServer/，大小写必须完全一致）
·
6．使用汇文图书馆管理系统sys用户登录(工作人员工号)（目前仅支持sys用户登录）
·
7．根据实际情况设置相关参数及邮件服务配置
（如果邮件发不出去，在确认邮件参数设置正确的前提下，请检查看防火墙相关设置）
·
8．邮件模板文件在 HwAppServer\WEB-INF\template\目录下
o 每组邮件模板分为2种格式 txt格式 和 html 格式，可以修改成自己学校个性化的邮件
如： mail_base.ftl和mail_base_txt.ftl
o HwAppServer\WEB-INF\template目录下除了4组邮件模板，其余是页面模板，可以修改成自己学校个性化的页面
o 邮件主题等配置的修改 HwAppServer\WEB-INF\template\template.xml
o 修改发件人名称： 修改\HwAppServer\WEB-INF\classes\AppServer.xml中 systemName的值
o 如果邮件历史页面打开比较慢,可以libsys用户登录oracle的sqlplus 执行：CREATE INDEX IDX_MAIL_SEND_DATE ON MAIL_SEND(SUBSTR(SEND_TIME,1,10));
另建议可选择删除部分旧的邮件历史。
【特别说明】
如服务部署在汇文OPAC服务器上则无需重复安装tomcat及jre，按以下步骤处理：
o a)．在\hwopac\Tomcat\webapps目录下创建一个新目录HwAppServer，解压缩HwAppServer.zip文件中所有文件及文件夹到该目录下(注意大小写和目录重复情况)
o b)．配置数据库连接：如果是windows系统，那么无须配置；如果是其他系统，按照上文服务器部署第3步配置数据库进行。
o c)．可以通过 http://IP:8081/HwAppServer/ 访问服务管理页面（默认端口为8081）
o d)．重启Apachetomcat服务
o e)．请注意，访问时，必须是http://IP:8081/HwAppServer/，大小写必须完全一致。
二．部分参数解释
o 1．只给验证过的Email发送邮件：如果勾选，表示只给完成邮箱验证的读者发送邮件，建议勾选。
o 2．借阅信息到期提醒：如果勾选，表示读者借阅的书刊即将到期时，将发送提醒邮件
提前天数：提醒邮件首先在图书应还日期前N天发送
每天都发、只发一次：表示提醒邮件是只发一次，还是从第一次提醒日到（读者还书后或应还日当天）每天都发送。
o 3．预约委托相关：
预约到书提醒：如果勾选，表示读者预约的书刊到馆后，将发送提醒邮件
委托到馆提醒：如果勾选，表示读者委托的书刊到馆划到后，将发送提醒邮件
预约、委托到书延迟通知天数：是为了给跨校区，跨馆藏地的图书物流预留时间，在划到后等待相应天数，发送提醒邮件，可以设置为零
o 4．持续天数：表示预约到书、委托到书邮件提醒将持续发送的天数（多次提醒，每天一次），该参数设置为零将不发送提醒邮件
o 5．超期催还：如果勾选，表示读者借阅的图书超期未还，将发送催还邮件
间隔天数：表示读者借阅的图书超期未还后，收到催还邮件的频率（隔N-1天被催还1次），从读者最后一本超期图书的超期当天开始催还，该参数不能设置为零，如果设置为1，超期未还的读者将每天收到催还邮件。
o 6．预约催还：如果勾选，表示当读者借阅的图书被其他读者预约时，将发送书被预约的提醒邮件。
是否改借期：如果勾选，表示当读者借阅的图书被其他读者预约时，将按照流通规则更改读者的应还日期，并通知相应读者。
o 7．删除超期预约到书记录：如果勾选，表示当读者预约的书刊到馆后，未办理借阅且已经超过规定保留时间，那么应用服务将删除该到书记录，释放图书资源，如果图书有被其他读者预约，将自动给预约读者划到（即转预约）
延迟天数：表示预约到书超期几天后，进行删除处理。（超期后如果未删除，读者依然可以来馆借阅，删除以后，图书资源将被释放）
三．常见问题解答
o
1．邮箱所有参数都配置正确，可是邮件始终发不出去，怎么查看防火墙配置？
各大防火墙基本都有邮件检测服务，比如macfee, 在MCAFEE控制台中，右键“访问保护”-属性-防病毒标准保护，取消掉禁止群发邮件蠕虫发送邮件前方的两个勾，比如诺顿，各种版本基本都是取消邮件相关检测就可以了。还有一种比较特殊的情况是邮件服务默认端口25被其他程序占用了也会导致邮件发不出去。
o
2．如何测试后台服务？
区分为两种情况：
§ 1．系统当天未执行过后台服务：修改\HwAppServer\WEB-INF\classes\config\quartz.properties文件的内容，例子：【quartz.trigger.cronExp=0 30 10 ? * *】括号中内容表示，早上10点30启动，保存后，重启tomcat,等时间到了以后，通过网页管理端 运行日志 模块或者HwAppServer\logs\目录下hwAppServer.log 文件 查看系统运行状况。
§ 2．系统当天已经执行过后台服务：数据库执行 update SERVICE_CONFIG t set t.content = '2013-08-28' where t.type_code = '01'; 其中2013-08-28必须满足yyyy-MM-dd格式，实际值必须在测试日期之前，后面的就和未执行的流程一样。
o
3．密码取回邮件收到的密码不正确，是一串乱码？
这个情况是由汇文5.0客户端于OPAC5.0刚开始加密方式不同导致的，后来已经修改一致了。如果咱们馆系统升级5.0以后，又更新过OPAC,那么只要在客户端或opac修改一下（收到乱码密码邮件的）学生的密码，即可解决；如果opac未升级，那么麻烦升级一下，再修改即可。（快速升级办法：替换c:/hwopac/hwweb/reader/redr_mail.php文件）
o
4．系统才运行几天，所在磁盘就快满了？
一般来说是由于程序错误日志文件过大导致的，这种情况下，首先要做的事，停止TOMCAT服务，把HwAppServer 文件夹从 \Tomcat\webapps\ 目录下剪切到其他地方备份，再启动TOMCAT（为了不影响其他程序）。使用文本编辑器打开HwAppServer\logs\hwAppServer.log文件，查看其中的内容，找出错误原因进行解决。目前已知的原因主要有：
§ 1.邮件参数配置不正确，或者防火墙设置或者25端口被占用导致邮件发送不成功引发错误日志暴增；
§ 2.汇文系统3.0升级至3.5，或者直接安装3.5系统时数据库有部分内容没有安装执行（2007-09-01table.sql），请联系汇文的客服协助解决；
§ 3.其他错误，请汇文的客服协助解决。
5．opac密码重置升级，更新邮件模板
使用新的密码重置模板文件替换原来的密码重置模板文件。
模板文件为\HwAppServer\WEB-INF\template\目录下的mail_get_password.ftl和mail_get_password_txt.ftl。
如何确定咱们馆适用密码取回版还是密码重置版？
取回的意思是 重置了新密码，直接邮件发给读者
重置的意思是 邮件里有个修改密码的链接
要用你的账号测试一下opac密码取回，才知道适用什么版本
6．汇文数据库配置器打不开
错误场景：双击后英文提示java 运行环境版本不正确、冲突等
常见原因：
a.
没有安装jar程序需求版本的jre
b.
用户机器的环境变量中path的值里面，未设置jre的bin路径，或者有低版本的bin路径放在jre版本的bin路径前面。
解决方案：
1.
对于原因a
安装对应版本jre。
2.
对于原因b
在环境变量path的值里面添加jre的bin路径或更改jre的bin路径的顺序。
四．版本更新说明
任意版本更新至0.0.1.6的方法
o 保留原目录\HwAppServer\WEB-INF\classes\AppServer.xml文件；
o 保留原目录\HwAppServer\logs\文件夹下所有文件;
o 覆盖新版程序；
o 修改数据库配置，启动tomcat服务。
0.0.1.5版更新至0.0.1.6的方法
o 保留原目录\HwAppServer\WEB-INF\classes\config\applicationContext.xml文件;
o 保留原目录\HwAppServer\WEB-INF\classes\config\config.properties文件;
o 保留原目录\HwAppServer\logs\文件夹下所有文件;
o 覆盖其他文件后启动tomcat服务即可。
o 版本0.0.1.6更新说明：
修正定期删除过期日志功能；
o 增加bat文件，数据库配置器使用更方便。
任意版本更新至0.0.1.5的方法
o 保留原目录\HwAppServer\WEB-INF\classes\AppServer.xml文件，覆盖新版程序；
o 修改数据库配置，重启tomcat服务。
o 版本0.0.1.5更新说明：
o 增加更多浏览器直接打开日志文件查看的支持；
o 增加定期删除过期日志功能，并由参数控制；
o 邮件模板中增加序号；
o 数据库配置文件采用加密方案；
o 支持使用OPAC等外部数据库配置文件；
o 解决在邮件参数未正确设置或数据库环境有问题或网络环境有问题时日志量过大的问题。
任意版本更新至0.0.1.4的方法
o 保留原目录\HwAppServer\WEB-INF\classes\AppServer.xml文件；
o 保留原目录\HwAppServer\WEB-INF\classes\config\jdbc.properties文件；
o 版本0.0.1.4更新说明：
o 增加读者荐购图书入藏优先借阅提示以及对应参数控制；
o 参数配置页面增加证件到期提醒相关参数管理。
任意版本更新至0.0.1.3的方法
o 保留原目录\HwAppServer\WEB-INF\classes\AppServer.xml文件；
o 保留原目录\HwAppServer\WEB-INF\classes\config\jdbc.properties文件；
o 版本0.0.1.3更新说明：
o 修正了邮件发送间隔修改保存后不能立即生效的BUG；
o 修正了超期催还的计算规则，以最后一本超期图书来计算间隔催还；
o 修正了使用说明链接；
o 直接显示内部版本信息，去掉框框；
o 邮件历史增加读者姓名、证件号、email地址、邮件发送结果4个检索条件；
o 邮件历史增加了最近一周发送结果报表查看功能；
o 邮件历史增加了指定时间区间发送结果报表查看功能；
o 邮件历史删除功能迁移到指定时间区间发送结果报表查看页面中；
o 进入应用服务后台后，index页面变为邮件发送情况报表，而不是参数配置页面；
o 点击发送失败总数后，能够看到发送失败的明细，便于查找发送失败的原因。
任意版本更新至0.0.1.2的方法
o 保留原目录\HwAppServer\WEB-INF\classes\AppServer.xml文件；
o 保留原目录\HwAppServer\WEB-INF\classes\config\jdbc.properties文件；
o 版本0.0.1.2更新说明：
o 修正了200字段中特殊字符引起的处理失败BUG；
o 修正了css代码,支持目前市面上所有的浏览器.
任意版本更新至0.0.1.1的方法
o 保留原目录\HwAppServer\WEB-INF\classes\AppServer.xml文件；
o 保留原目录\HwAppServer\WEB-INF\classes\config\jdbc.properties文件；
o 版本0.0.1.1更新说明：
o 取消了汇文系统数据库定时优化功能.
o 修正了页面上js程序BUG,将支持更多浏览器.
任意版本更新至0.0.1.0的方法
o 保留原目录\HwAppServer\WEB-INF\classes\AppServer.xml文件；
o 保留原目录\HwAppServer\WEB-INF\classes\config\jdbc.properties文件；
o 版本0.0.1.0更新说明：
o 增加了汇文系统数据库定时优化功能.
o 解决预约催还改应还日期功能中程序执行可能的bug.
任意版本更新至0.0.0.9的方法
o 保留原目录\HwAppServer\WEB-INF\classes\AppServer.xml文件；
o 保留原目录\HwAppServer\WEB-INF\classes\config\jdbc.properties文件；
o 版本0.0.0.9更新说明：
o 解决预约到书超期转预约时，未处理预约申请的BUG.
o 解决邮件历史少显示条数一条邮件信息的bug.
任意版本更新至0.0.0.8的方法
o 保留原目录\HwAppServer\WEB-INF\classes\AppServer.xml文件；
o 保留原目录\HwAppServer\WEB-INF\classes\config\jdbc.properties文件；
o 版本0.0.0.8更新说明：
o 解决预约改借期、预约到书超期转预约的BUG.
任意版本更新至0.0.0.7的方法
o 保留原目录\HwAppServer\WEB-INF\classes\AppServer.xml文件；
o 保留原目录\HwAppServer\WEB-INF\classes\config\jdbc.properties文件；
o 版本0.0.0.7更新说明：
o 在配置页面显示程序内部版本号;
o 解决一些参数设置的BUG.
0.0.0.5版 更新至0.0.0.6的方法
o 保留原目录\HwAppServer\WEB-INF\classes\AppServer.xml文件；
o 修改AppServer.xml中的null为false;
o 保留原目录\HwAppServer\WEB-INF\classes\config\jdbc.properties文件；
o 解压完整包，替换保留的文件。
o 任意版本(0.0.0.4版以前)更新至0.0.0.6的方法
o 保留原目录\HwAppServer\WEB-INF\classes\AppServer.xml文件；
o 保留原目录\HwAppServer\WEB-INF\classes\config\jdbc.properties文件；
o 解压完整包，替换保留的文件。
o 版本0.0.0.6更新说明：
o 应对struts2.3.15.1的Freemarker整合BUG.
任意版本更新至0.0.0.5的方法
o 保留原目录\HwAppServer\WEB-INF\classes\AppServer.xml文件；
o 保留原目录\HwAppServer\WEB-INF\classes\config\jdbc.properties文件；
o 解压完整包，替换保留的文件。
o 版本0.0.0.5更新说明：
o 应对struts2.3.15.1的Freemarker整合BUG；
o 优化调整了一些界面显示。
java版0.0.0.3更新至0.0.0.4的方法
o 删除原目录\WEB-INF\lib\下所有文件
o 解压更新包覆盖原目录
o 版本0.0.0.4更新说明：
o 应对struts2.0 - 2.3.15的重大安全漏洞；
o 增加了是否发送邮件参数配置；
o 解决了邮件主题导致的邮件发送失败问题；
o 优化调整了一些界面显示。
java版0.0.0.2更新至0.0.0.3的方法
o 替换原目录\WEB-INF\lib\hwapp.jar
o 替换原目录\WEB-INF\web.xml
o 版本0.0.0.3更新说明：
o 更新控制端邮件历史查看邮件内容时未正显示索书号
java版0.0.0.1更新至0.0.0.2的方法
o 保留原目录\HwAppServer\WEB-INF\classes\AppServer.xml文件；
o 保留原目录\HwAppServer\WEB-INF\classes\config\jdbc.properties文件即可。
o 版本0.0.0.2更新说明：
o 1.增加预约催还改应还日期功能，并完善了相应邮件模板；
o 2.对预约到书过期转预约功能进行了完善，增加了闭馆日等因素的判断；
o 3.修改抓取数据服务开始时间限定到凌晨；
o 4.合并停借处理服务到抓取数据服务中