【旧版Jetty学工】部署手册

huangzhenpeng

1.前言
        此文档不拘泥于格式，以实用为主，如有建议请联系研发二部负责人。
2.工具准备
        当现场人员部署系统出现问题的时候会经常需要研发人员协助部署，为了在协助的过程中达到最高的效率，请现场人员准备一下部署工具，因为我们的研发人员并不专门从事部署工作会使用的工具也有局限性。所以请先准备好一下的工具：
1.PLSQL（最好是版本12）
2.Notepad++
3.Xftp 和XShell（最好是版本5）
3.平台部署
        全量部署是指现场没有部署过综合学工的任何产品，完全是从无到有的部署过程！项目的不是第一次部署跳过此步骤
3.1环境检查
1.提供的远程环境PC应安装了oracle 11g版本
2.服务器使用的数据库版本也应该是oracle 11g版本
a)如果学校是oracle 12c也可以
b)但是绝对不能使用oracle 10g
3.服务器应该安装的是JDK1.7或者其子版本，1.6或者1.8都不行
3.2第一步：部署运行平台
部署综合学工产品之前应该已经从测试部申请到了公司的统一开发平台V1.14版本，测试部发的平台版本名称如下：
3.2.1解压（拷贝）运行平台到服务器
1.windows环境服务器可以解压到容量最大硬盘的根目录下
2.linux服务器建议解压到/usr/local 文件夹下
3.将运行平台根目录命名为：ly_platform_businessV1.14-zhxg-80（原本名称就是这个）
3.2.2修改配置文件
以下的路径均基于ly_platform_businessV1.14-zhxg-80根目录而言（也就是说所有的路径写法都是针对此相对路径而言）：
1.服务器IP：/conf/platform.properties
a)将platform.host设置为服务器ip，如下图：

2.附件服务器地址（负责存储系统上传的各种文件）： /modules/repository /conf/conf.properties

a)修改属性1：repository.home
b)修改属性2：repository.fileDataStorePath
c)上面两个属性就是附件服务器的路径，请按照服务器类型配置一个可用的路径。（window路径有盘符，linux路径没有盘符）就是在xftp平台上放文件，新建一个文件夹
d)★不要把路径配置在平台根目录下，会影响项目备份，尽可能放在显眼的位置。
3.JETTY服务器配置：/modules/web_jetty/conf/jetty/jetty.xml

a)查找关键语句：<Property name=”jetty.port” default=”8080”>
b)Default属性记录的内容就是平台的端口号，修改为需要的内容即可
4.配置webservice数据源：/modules/web_jetty/conf/conf.properties

3.2.3部署运行平台数据库：(到这)
1.创建lyzhxg表空间，programmer表空间（后面部署会用到，提前创建吧）

2.使用下面的sql语句创建lyzhxg用户：

3.查找路径/etc/schema下面的两个文件，按照编号一次在lyzhxg用户下运行，在command命令窗口，copy以下脚本，执行：

3.2.4清空日志
清空/logs目录下的文件
3.2.5启动项目
部署项目前请注意，下面所有的路径是基于项目部署路径的相对路径，项目部署路径为：
/ ly_platform_businessV1.14-zhxg-80
1.首先/bin路径下
a)Windows环境下直接点击run.bat就可以启动项目
b)Linux环境下，使用XShell进入到/bin目录下，然后使用命令（./run.sh &）来启动项目（此处有可能出现“未授权chmod”的情况，此情况请自行查询相关资料解决）chmod a+x *.sh
2.启动项目的工程中请注意控制台打印的信息，是否有报错信息（如下面第二个黑图），一般来说如果启动不报错，控制台的输出内容一般是比较规范的语句代码，如下图：第一部分是打日志的类，第二部分是分隔符，第三部分是日志内容，这就是正常的日志信息。

                错误的日志信息如下，一般来说有很多“at”字样，是指错误出现在代码的哪个位置：

如果出现错误日志，请参照本文档附录里的Q & A来自行解决问题，如果无法自己解决可以联系研发人员。联系研发人员时请将logs文件加下的日志打包发给研发人员。
数据源修改详情请见第五章
3.平台正常启动后可以用一下的地址访问测试一下：服务器IP:端口/system，如果出现以下界面就部署成功了！

3.2.6申请平台license
        到公司的事物中心上提交license的申请表，拿到license后按照测试的说明部署好license重新启动平台。(测试不管这一部分)
4.产品（业务系统）初始部署
        初始部署是指项目的第一次部署某个产品。()
4.1了解产品更新包结构
1.测试发出单本应该是一个压缩包，压缩包内包含以下内容，具体包含哪些文件夹由申请时填写的内容而定。由于系统之间存在一些依赖，申请一个系统的时候可能会同时获取到他的依赖系统。在执行部署工作的时候，应该按照序号依次部署。
2.打开其中一个文件夹会看到下面的这些文件

3.根据不同的文件类型，在项目部署时进行的操作也不同
a).war文件，部署在/modules/web_jetty/webapps目录下
b)component_xxxx.jar文件，部署在/modules/component/components目录下
c)其他的.jar文件部署在/modules/web_jetty/lib/custom目录下
d)-dbcp.xml文件（）
i.此类文件是数据源配置文件
ii.将其配置修改为现场数据库的真实情况（参照第5章）
iii.将此类文件部署到modules/basis/jdbc目录下
e).sql文件是用来执行数据库脚本，sql文件打开以prompt开头的脚本在PLSQL的command的窗口下，copy脚本贴进来后执行。有的前面有三个问号的，将问号删除掉后再复制过去在command模式下执行即可，如果不是以prompt开头的就在sql窗口模式下执行，dmp文件也可通过plsql导入，如下图：

i..sql文件的命名由3部分组成，如下图：

ii.第一部分是序号，表示sql语句的执行顺序
iii.★第二部分是数据库用户名，标志此sql语句应该在哪个数据库用户下执行（比如图中的sql语句应该在ly_zsxt这个用户下进行）
iv.第三部分是此sql语句的功能描述

f).nar文件是综合学工组件配置数据，部署步骤如下：
i.将除了.nar文件的其他文件都部署完毕
ii.启动运行平台
iii.访问路径“服务器IP：端口/pro”，如果出现下图的页面，则使用导入功能导入.nar文件

iv.如果出现的是登录后的页面，则点击注销后进行导入！

v.导入后需要重新启动运行平台
4.在所有要部署的数据全部部署之后，整个产品就部署成功了，只需要重启运行平台即可！
5.数据源配置
由于综合学工产品比较多，因此数据源配置比较复杂，所以专门这对数据源配置进行说明。
1.如果系统的安装包里有-dbcp.xml（文件安装位置参照：4.1_3_d）_iii节内容），就说明此产品需要一个独立的数据源配置，配置文件如下图：

2.如上图所示的数据源是“综合学工的数据源”，链接的数据库用户是lyzhxg，如果现场还没有了这个数据库用户，那么就需要进行
3.上图红框内的内容需要按照现场的实际数据库情况进行修改，数据库ip地址，数据库实例名，数据库用户密码
4.请尽可能保证用户名按照配置中要求的用户名，否则会出各种不稳定的问题。
5.如果学校强制要求不能使用配置中要求的用户名，也可以，发现问题之后请及时和研发二部沟通解决。
6.按照现场的情况修改完毕后，请将此文件部署到/modules/basis/jdbc目录下。
6.系统初始化
上述的步骤完成后，综合学工基本完成部署，运行平台无报错启动之后需要对系统进行初始化配置。
6.1基础数据初始化
请在lyzhxg数据库用户下寻找下面的表，仔细查看表备注，列备注。找公司的数据交换组按照学校的实际情况将数据补充完整，就可以完成基础数据初始化操作。
WP_KDB_CAMPUS
WP_KDB_CLASS
WP_KDB_DEPARTMENT
WP_KDB_MAJOR
WP_KDB_STUDENT
WP_KDB_TEACHER
6.1.1数据推送之后可以使用下面的sql语句进行基础数据准确性校验
6.2权限角色配置
请查阅文档：学工队伍使用文档V3.0.docx
6.3业务系统初始化配置，请参照各系统的权限建议文档
各业务系统的权限分配基本等同于6.2中的操作，如果又觉得不清楚的地方，欢迎提建议


7.附录
7.1文档更改以及版本更新记录
2018-07-19：
1.【版本更新】更新 /etc/schema/0.数据库对象_kdb.sql 文件，补充了ZHXG_DMK_CCDM建表语句