1、自动更新系统客户端概要设计说明书 厦门市南方科宇科技有限公司http: Tel: 0592-5953061 Page 1 of 6自动更新系统客户端 2.0设计方案文档编写 卢晓峰编写日期 2011-08-08文档编号文档审核审核日期保密等级编写部门 研发一部自动更新系统客户端概要设计说明书 厦门市南方科宇科技有限公司http: Tel: 0592-5953061 Page 2 of 6修改历史纪录:序号 日期 修改人 审核人 说明自动更新系统客户端概要设计说明书 厦门市南方科宇科技有限公司http: Tel: 0592-5953061 Page 3 of 6需求背景动态监管 2.1 客户端采
2、用 C/S 应用架构,自动更新客户端 1.0 仅支持 WEB 应用更新,无法满足动态监管 2.1 客户端自动更新的需要。更新功能点支持 C/S 应用的自动更新打包方式为 exe 安装包,自动加入启动项。设计思路通过 Socket 与 C/S 应用的端口建立连接发送关闭请求,更新结束后重新启动应用。发送应用关闭指令至端口 2 3 0 1 1关闭成功 线程等待延时还原应用备份及更新应用是是否否检测到更新包并下载至本地重新启动应用版本修改内容1. 在 conf/sys.properties 配置文件增加配置项system.config.startCmd(应用启动 cmd,例:D:Keyusoftst
3、artup.exe)system.config.stopPort(应用停止端口,例:23011)2, 对 service_names.propertiessgn 做处理,当更新客户端无法发现 service_names.properties文件默认更新目标为 C/S 应用。自动更新系统客户端概要设计说明书 厦门市南方科宇科技有限公司http: Tel: 0592-5953061 Page 4 of 63增加关闭应用的网络通讯协议请求代码 7041:51+36+8=95bytes;说明 占用位数(bytes)客户端 ID 36密码 8响应代码 7042:51+2=53bytes;说明 占用位数(
4、bytes)停止应用标志:00 停止成功,01 停止失败 2补充说明 通讯协议头网络通讯协议头共定义 51 位。说明 占用位数(bytes)报文总大小:如果有附件,则不包括附件大小 12报文代码:标识报文类别的代码 4压缩标志:0 未压缩 1 已压缩 1加密标志:0 不加密、1RSA、2DES、3Base64 1包校验类型:0 不校验、1CRC16、2CRC32、3ADLER32、4MD5 1自动更新系统客户端概要设计说明书 厦门市南方科宇科技有限公司http: Tel: 0592-5953061 Page 5 of 6说明 占用位数(bytes)包校验码 32sys.properties 配
5、置文件说明配置项 说明system.config.singleton 是否只能打开(值为 true 或 false)system.config.checkport 唯一性检测端口,默认为 23222system.config.viewTimer 检查是否有更新包轮循时间(秒)system.config.target 更新应用的安装 Home 目录物理地址system.config.startCmd 应用启动命令路径,Web 应用请删除此项system.config.stopPort 应用停止命令端口,Web 应用请删除此项更新客户端手动安装布骤1. 导入客户密钥文件 key.ky 将文件拷贝至
6、需要更新的应用安装目录。2. 修改 conf/app.xmla) ProductId 产品标识b) Version 已布署产品目前版本号c) IpAddress 更新服务器 IP(默认 192.168.1.152)d) Port 更新服务器端口(默认 23000)e) ClientId 在更新程序启动时自动从 key.ky 读取写入。f) isAutoUpdate 设置为 true3. 修改 conf/database.properties(更新应用的数据库连接配置,用于更新 SQL 脚本)a) dbURL 数据库连接字符串b) userName 数据库连接用记c) userPwd 数据库连接
7、帐号自动更新系统客户端概要设计说明书 厦门市南方科宇科技有限公司http: Tel: 0592-5953061 Page 6 of 6d) driverName 数据库驱动4. 修改 conf/service_names.propertiesTomca t 注册 windows 服务名,如果更新应用为 C/S,则删除该文件。通常四个选项配置名相同,个别特例不同。a) service.stop 服务停止名称b) service.start 服务启动名称c) service.status 查看服务状态名称d) service.config 查看服务配置信息名称5. 修改 conf/sys.properties参见 sys.properties 配置说明6. 注册为开机启动项并启动客户端(uprc.jar)