部署手册

Learun.Framework.Ultimate V7/Doc文档/数字化智慧校园3.0部署手册V1.3.docx

@@ -0,0 +1,424 @@
+
+数字化智慧校园3.0
+
+
+
+
+
+
+
+
+
+
+
+
+
+部署手册
+
+
+
+
+
+
+
+
+
+
+
+
+版本号：V1.3
+
+
+
+
+
+
+修订记录
+                                 修订时间
+                                   修订人
+                                   版本号
+                                    变更
+2019-03-19
+梁坤
+V1.0
+新建V1.0
+2019-05-10
+梁坤
+V1.1
+新增系统流程配置说明和飞星上传目录要求说明
+2019-07-04
+梁坤
+V1.2
+新增飞星部署说明，统一身份认证部署说明
+2020-09-09
+梁坤
+V1.3
+1.新增力软706框架升级部署说明
+2.新增海康考勤机连接部署说明
+3.修改授权验证功能说明
+4.修改系统要求软件环境部分
+
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+                                       
+概述
+                                       
+  数字化智慧校园3.0基于.NETMVC技术开发，数据库使用SQL Server，部署在Windows Server系统之上，需要IIS支持。
+  
+系统要求
+硬件
+8GB及以上内存，4核心及以上CPU主频不低于2.0GHz，硬盘空间不低于500GB，其中系统盘剩余空间不低于50GB
+操作系统
+Windows Server2008R2及以上
+软件环境
+.NET FrameWork 4.5及以上（力软705版本开始升级到4.6.1及以上）
+SQL Server2012及以上
+IIS基础模块
+Redis 3.2.100及以上
+
+系统部署
+数据库配置
+第一步
+新建数据库adms7ultimate2和CollegeMISFor30
+
+
+存储路径修改至较大剩余空间硬盘
+
+
+
+第二步
+还原数据库，备份文件如下图
+
+分别还原至对应数据库
+
+还原路径一定要选对
+
+
+选项如下图：
+
+
+第三步
+修改数据库adms7ultimate2中LR_Base_DatabaseLink表内数据，内有连接字符串修改正确。
+
+
+LR_Base_User表内数据只保留system帐号，其余做删除处理：
+
+LR_Base_Module表中F_UrlAddress地址替换成后续部署mis系统的端口和ip：
+
+Sql语句：update LR_Base_Module set F_UrlAddress=replace(F_UrlAddress,'192.168.1.126:9000','192.168.60.128:8082')
+Sql语句按实际情况修改
+第四步
+同步学校基础数据到CollegeMISFor30中（使用系统导入、数据库导入功能均可）
+常用表：
+
+排课数据ArrangeLessonTerm
+系CdDept
+专业CdMajor
+课程分类CdLessonSort，CdLessonSortDetail
+课程LessonInfo
+班级ClassInfo
+教学楼ClassroomBuilding
+教室ClassroomInfo
+班主任ClassInfoDiredctor
+教师EmpInfo
+学生StuInfoBasic
+
+注意：学生和教师表内，checkmark必须是true才能生成帐号
+性别1男0女，旧系统一般是1男2女，注意修改数据
+教师表中F_CompanyId和F_DepartmentId分别对应adms7ultimate2库的LR_Base_Company表（学校校区表）的对应id，LR_Base_Department（部门）的对应id
+学生表中F_SchoolId对应adms7ultimate2库的LR_Base_Company表（学校校区表）的对应id，DeptNo对应CollegeMIS库的系CdDept 的DeptNo，否则生成帐号会生成出错！
+
+IIS配置
+网站组成
+全部系统需要部署4个网站如下图：
+
+分别对应：高职20190311web、WebPublish、WebAPIPublish、www四个压缩包。
+网站程序池配置
+Mis系统需要选择2.0集成，且启用32位，图：
+
+
+
+
+其余三个系统需要4.0集成，同样启用32位。
+
+注意：有时还需要配置文件目录权限如下图：
+
+
+配置文件修改
+网站数据库配置：
+新增定时库配置
+<add name="hangfireString" connectionString="Server=192.168.2.126;Initial Catalog=Hangfire;User ID=sa;Password=bjqj@2015!" providerName="System.Data.SqlClient" />
+
+Mis系统修改三处Web.config中，如下图：
+
+以下网站修改xmlconfig目录下的database.config配置：
+
+
+和system.config配置：
+
+workflowapi修改为对应的服务器ip地址，跳转地址指向mis系统ip和端口。
+AnnexesFile 修改为部署服务器的Resource文件夹下，否则会影响飞星。
+
+手机h5网站即站，修改config下config.js文件：
+
+Webapi指向api站，web指向主网站
+系统流程使用配置
+  系统流程是为了配合框架中个人办公-》我的任务-》代办任务中（即工作流）实现一些提交审核数据的功能，系统开发时已经内置了默认的流程，如需修改配套的流程，请详细阅读并按照下面的步骤谨慎修改。
+  
+第一步：了解使用系统流程的功能和对应的路径如如下：
+采购申请
+
+入库申请
+
+出库申请
+
+公文下发
+
+第二步：编辑对应的index.js最下方代码，如图：
+
+修改红圈处模板编号为系统中对应的流程模板编号，流程功能如下图：
+
+
+新建系统调用流程时，要注意选择系统流程，模板编号要和index.js相对应，否则会造成工作流功能工作不稳定甚至紊乱。
+
+第三步：配置各节点的表单，如下图所示：
+开始节点和中间审批节点添加表单，类型选择系统表单，地址填写对应的功能目录的FormView。
+
+最后审批节点需要额外配置【绑定方法】，如下图：
+
+
+绑定方法见下表：（大小写区分且不能有空格）
+                                 系统功能
+                                 绑定方法
+                                    备注
+采购申请
+Ass_PurchaseApplyMethod
+
+入库申请
+Ass_AssetsInfoApplyMethod
+
+出库申请
+Ass_AssetsOutApplyMethod
+
+公文下发
+Sys_SendFileMethod
+
+
+
+
+
+应用程序配置
+配置文件
+WorkFlow下Learun.Application.WorkFlowServer.exe.config文件修改：
+
+
+管理员方式运行Learun.Application.WorkFlowServer.exe开启服务。
+统一身份认证配置
+<!-- ================== 统一身份认证公钥密钥 ================== -->
+<add key="SSOPublicSecret" value="bjquanjiang" />
+<add key="SSOUserSecret" value="123456789" />
+一般情况，公钥不做修改，私钥在对接系统端进行配置。
+统一身份认证工作机制说明
+第一步，在系统中配置统一身份认证的接入系统地址
+第二步，给系统中的用户授权统一认证系统使用权限
+第三步，配置用户接入统一认证系统的用户名、密码
+第四步，系统根据用户填写的信息，使用公钥、密钥双层AES加密后，发送到接入端比对，成功后即可自动登录对接系统。
+
+图中数字化校园统一应用管理模块中私钥应和接入系统私钥匹配。
+
+飞星推送配置
+<add key="CommunicationServeraddress" value="http://127.0.0.1:8866/ChatConnection" />
+数字化校园会自动推送未读邮件消息、公告通知消息到飞星端，需要配置本地址到飞星服务端。
+排课、排考，考试系统数据对接配置
+<!--排课接口-->
+<add key="ArrangeLessonAPI" value="http://demo.bjquanjiang.com:9090/interface/paike/paike" />
+<!--异动排课接口-->
+<add key="ModifyArrangeLessonAPI" value="http://demo.bjquanjiang.com:9090/interface/paike/updatePaike" />
+<!--开课计划接口-->
+<add key="OpenLessonPlanAPI" value="http://demo.bjquanjiang.com:9090/interface/paike/majorInterface" />
+
+<!--选修排课接口-->
+<add key="ArrangeLessonOfElectiveAPI" value="http://demo.bjquanjiang.com:9090/interface/paike/xuanxiupaike" />
+<!--更新选修排课接口-->
+<add key="ModifyArrangeLessonOfElectiveAPI" value="http://demo.bjquanjiang.com:9090/interface/paike/updateXuanXiuPaike" />
+
+<!--排考接口-->
+<add key="ArrangeExamAPI" value="http://demo.bjquanjiang.com:9090/interface/paikao/paikao" />
+<!--选修排考接口-->
+<add key="ArrangeExamOfElectiveAPI" value="http://demo.bjquanjiang.com:9090/interface/paikao/xuanxiupaikao" />
+<!--排考结构接口-->
+<add key="ArrangeExamStructureAPI" value="http://demo.bjquanjiang.com:9090/interface/paikao/geitime" />
+<!--考试成绩接口-->
+<add key="ExamScoreAPI" value="http://123.57.209.16:12203/jeeplus/app/stuScore" />
+
+<!--考试系统学生端-->
+<add key="kaoshisystemurl" value="http://ks.bjquanjiang.com/RereClientConnector" />
+青桔课堂对接配置
+<add key="QingJuurl" value="http://xy.bjquanjiang.com/Student/LoginForSSOHandler.ashx" />
+<add key="QingJuRegisterurl" value="http://xy.bjquanjiang.com/Service/ServiceStudent.ashx" />
+自动备份数据库路径配置
+<add key="dbbackuppath" value="D:\数字化校园\lr7test\Publish\Resource\DataBaseBackup"/>
+将本路径配置指向数字化校园主站根目录下\Resource\DataBaseBackup
+
+Webapi配置变更
+<!-- ==================注意附件上传地址  修改到主网站部署目录下的Resource要不然飞星会报错================== -->
+<add key="AnnexesFile" value="E: \数字化校园\Web\Resource" />
+<!-- ================== 数字化校园主站地址 ================== -->
+<add key="webrootpath" value="http://localhost:20873" />
+有两处需要注意的地方，都需要指向主站。
+
+力软705版本升级注意
+第一步，首先更新版本程序
+第二步，使用Quanjiang.DigitalScholl.DataSync.exe数据库同步工具同步客户数据库到最新（由于数据库操作风险巨大，具体使用时联系开发人员配合同步）
+第三步，参照最新程序修改XmlConfig下system.config、ioc.config，根目录下Web.config文件
+第四步，如果出现授权验证失败，需要重新进行授权。
+飞星部署
+服务端
+飞星服务端属于exe可执行文件，运行前先配置配置文件GoChat.Server.exe.config：
+<add key="serverAddress" value="*:8866" />（一般情况不要动）
+然后以管理员身份运行GoChat.Server.exe后，如下图：
+
+点击服务控制，切换到该选项卡，点击启动即可
+
+
+客户端
+最新客户端安装包，请到公司群文件里下载，注意下载最新版本号的    飞星客户端.exe
+安装后，需要先配置服务器，点击登录界面右上角设置按钮，如下图：
+
+
+
+通信服务器内网（外网）地址：运行飞星服务端程序的服务器ip地址+端口号，例如：
+123.57.209.16:8866    127.0.0.1:8866
+通信服务器数据地址：数字化校园API网站地址+端口号，例如：123.57.209.16:31173  192.168.2.126:8083
+请务必注意配置正确，否则无法正常登录飞星。
+配置完成后，输入数字化校园教师帐号密码即可登录。
+
+软件授权
+泉江授权程序
+程序名称Quanjiang.DigitalScholl.License.exe
+本程序为可执行文件，无需配置
+授权成功后，会在客户机主网站bin目录下，生成后缀为.bjqj的加密授权文件，授权分为永久授权和限时授权，不勾选是否限时即为永久授权。
+
+说明：
+1.首先部署好数字化校园3.0主程序，浏览器打开：http://部署地址/ShowRegister
+2.运行授权器，将上一步得到的机器码填写至注册器机器码文本框内。
+3.如果有使用期限，选择好到期时间，如果没有使用期限，请将限时复选框去掉。
+4.点击授权按钮，将生成的注册码复制到部署机器的http://部署地址/ShowRegister界面注册码内，并点击授权按钮。
+5.重新运行部署的数字化校园。
+6.！！！！严重警告！！！！此软件禁止放在部署机上！！！！此软件严禁外传！！！！
+7. 在力软705版本后增加了网络授权验证，客户机除了要进行上述的本地授权外，还需要进行网络授权
+步骤1：打开授权网站http://123.57.209.16:8061/ 用户名：联系泉江获取 密码：联系泉江获取 并登录。
+步骤2：打开功能并新增授权
+
+步骤3：填写相关信息并保存（机器码即运行数校http://部署地址/ShowRegister获得的机器码）
+
+步骤4：重新访问数字化智慧校园系统验证授权是否正确。
+定时服务部署
+部署
+本程序为Windows服务，即运行在系统底层的程序，可随系统启动，安装后需要手动启动，设置为自动运行，程序名称Quanjiang.DigitalScholl.JobService.exe
+先修改配置文件
+Quanjiang.DigitalScholl.JobService.exe.config中的连接字符串到部署服务器
+<add name="BaseDb" connectionString="Server=192.168.2.126;Initial Catalog=adms7ultimate2;User ID=sa;Password=bjqj@2015!" providerName="System.Data.SqlClient" />
+<add name="CollegeMIS" connectionString="Server=192.168.2.126;Initial Catalog=CollegeMIS;User ID=sa;Password=bjqj@2015!" providerName="System.Data.SqlClient" />
+<add name="HangfireConnString" connectionString="Server=192.168.2.126;Initial Catalog=Hangfire;User ID=sa;Password=bjqj@2015!" providerName="System.Data.SqlClient" />
+备份文件存放路径配置：
+<add key="dbbackuppath" value="主网站部署地址\Resource\DataBaseBackup" />
+如需要部署海康考勤机还需要配置：
+<add key="AttendancePhotoPath" value="主网站部署地址\Resource\AttendancePhoto" />
+部署方法：
+第一步，以管理员身份运行cmd
+第二步，进入服务程序路劲 cd 盘符\目录\Quanjiang.DigitalScholl.JobService\bin\Debug回车
+第三步，盘符 回车
+第四步，%SystemRoot%\Microsoft.NET\Framework\v4.0.30319\installutil.exe Quanjiang.DigitalScholl.JobService.exe 回车，提示安装成功。
+
+第五步，打开Windows服务，找到安装的服务
+
+并点击启动
+
+看到下图证明成功运行
+
+服务的卸载：
+运行cmd，进入服务程序目录，执行  %SystemRoot%\Microsoft.NET\Framework\v4.0.30319\installutil.exe /u Quanjiang.DigitalScholl.JobService.exe 回车
+卸载后，刷新Windows服务 应看不到本服务程序说明卸载成功，否则需要重启。
+
+海康考勤机部署要求
+首先确保数字化校园主站运行正常。
+步骤1 配置考勤机参数。打开功能【考勤设备管理】
+
+步骤2 配置考勤机参数，系统仅对启用设备进行连接操作
+
+步骤3 部署【DigitalSchoolApi】网站，并保证正常运行。
+步骤4 复制【海康考勤机必须文件】下的所有文件、文件夹到Quanjiang.DigitalScholl.JobService.exe所在目录。
+步骤5 复制DigitalSchoolApi内三个文件到Quanjiang.DigitalScholl.JobService.exe所在目录。
+步骤6 运行服务
+检查是否部署
+运行数字化校园主网站ip+端口/hangfire
+查看服务器
+
+显示上图即为服务正常，否则服务没运行正常。
+DigitalSchoolApi部署
+部署
+本程序为Web应用程序,部署方式同数字化智慧校园系统。
+对接考勤机的客户需要修改Web.config下【AttendancePhotoPath】配置节到数字化智慧校园网站根目录下Resource目录（同步修改【定时服务程序下】Quanjiang.DigitalScholl.JobService.exe.config文件的对应配置）
+<add key="AttendancePhotoPath" value="数字化智慧校园网站根目录\Resource\AttendancePhoto"/>
+程序实现了定时任务的新增，是配合【定时服务】运行的必要系统，程序包含如下图所示的功能：
+1.监控功能：部署地址/hangfire
+
+2.任务操作功能：部署地址/swagger
+
+School基础接口包含了几个教务所需的接口，可对外提供使用。
+
+
+YKT接口包含西昌学校门禁一卡通、图书馆系统数据同步定时同步任务，金隅学校一卡通消费记录定时同步任务，海康考勤机连接任务等，可根据不同学校需求具体操作。
+
+
+海康考勤机连接
+第一步，单击展开：
+
+第二步，点击按钮：
+
+第三步，点击执行：
+
+第四步，查看结果：显示返回200 OK即为成功
+
+第五步，确认是否加入定时服务，转到 【DigitalSchoolApi】部署地址/hangfire 查看【周期性作业】
+
+确认作业【HKAttendance】存在部署完成。
+第六步，启动【定时服务】
+第七步，查看数字化智慧校园系统中的考勤设备管理列表，是否布防和最后通讯时间，确认布防状态（是），最后通讯时间接近当前时间为连接成功，否则说明链接设备出现问题
+
+
+考勤机连接日志
+连接日志存储与CollegeMIS数据库，ADR_DeviceLog表中，查看该表数据可以快速判定考勤机部署连接过程中出现的错误、问题。
+