# 致远协同管理软件
# 信创升级工具手册
北京致远互联软件股份有限公司
2021年9月
[前言]
本手册对协同管理系统的信创部署升级工具相关事宜进行说明。如对手册存在疑问，可与致远互联的客户服务人员联系。
# 工具概述
信创部署升级工具支持A8-N产品序列，在信创环境下的数据库自动化升级，支持人大金仓，达梦数据库。
注：
A8-N V8.0SP1是第一个信创版本，即当前工具仅适合A8-N V8.0SP1信创环境下的升级。
A8-N V8.0SP2升级A8-N V8.0SP2LTS，无需执行本工具，备份数据库，备份seeyon包，解除V8.0SP2版本seeyon包的部署，重新部署V8.0SP2LTS版本seeyon包完成升级。
# 使用工具升级产品
# 产品升级流程
在信创环境下，产品部署的基本流程为：
# 工具升级产品方法
deploytools：信创部署所需周边文件目录
deploytools/file/dog：加密狗驱动文件
deploytools/file/info：产品注册信息
deploytools/file /jdbc：数据库连接用驱动jar
deploytools/file/productiden：产品线标识文件
deploytools/file/sql：数据库初始化SQL
FileService：文件下载服务目录
MediaService：音视频服务目录
nginx：nginx服务目录
OfficeTrans：在线预览服务目录
S1：S1 Agent程序目录
Search：全文检索服务目录
V5：协同应用目录
V5/ApacheJetspeed/conf/SeeyonConfig为参数配置工具，使用该工具时，需要先编辑
SeeyonConfig.sh中的JAVA_HOME路径为jdk的绝对路径，如图：
# 升级步骤
# 停止协同服务，备份数据库
停止协同服务（注意，中间件需要一起停止，不要只停止应用）
人大金仓数据库备份方法：
Linux：./sys_dump -h 127.0.0.1 -p 54321 -U SYSTEM -W SYSTEM -f /home/v5/seeyondump.dmp SEEYONV5
Windows：sys_dump.exe -h 127.0.0.1 -p 54321 -U SYSTEM -W SYSTEM -f C:\Users\Administrator\seeyondump.dmp SEEYONV5
参数说明：
sys_dump命令位于人大金仓安装目录/Server/bin目录（注意：windows操作系统名称为sys_dump.exe）
-h：数据库的ip
-p：数据库的端口
-U：数据库用户账户
-W：数据库用户密码
-f：备份文件的存储路径，以及名称
SEEYONV5：需要备份的数据库（即将要升级的数据库）
备份结束后备份文件会存放在/home/v5（根据-f中填写的而定）目录，名称为seeyondump.dmp（根据-f中填写的文件名而定）文件
达梦数据库备份方法：
详情请参考：https://blog.csdn.net/fengxiaozhenjay/article/details/104557505
这里以模式导出为例：
+-----------------------------------------------------------------------+ | Linux：./dexp USERID=v80sp2_a82/Seeyon123456@localhost:5236 | | file=v80sp2_a82.dmp DIRECTORY=/home/dmdba/dmdbms/bin | | SCHEMAS=v80sp2_a82 | | | | Windows：dexp.exe USERID=v80sp2_a82/Seeyon123456@localhost:5236 | | file=v80sp2_a82.dmp DIRECTORY=C:\Users\Administrator | | SCHEMAS=v80sp2_a82 | +-----------------------------------------------------------------------+
参数说明：
dexp命令位于达梦数据库安装目录/bin目录下（注意，windows下名称为dexp.exe）
USERID：数据库用户名/数据库密码@数据库服务ip:数据库服务端口
file:数据库备份文件导出名
DIRECTORY：数据库备份文件导出位于的目录
SCHEMAS:需要备份的数据库（即将要升级的数据库）模式名（一般与用户名一致）
# 升级数据库
进入deploytools目录，目录中文件如下：
Linux环境下：
chmod +x deployGUI.sh，授权使deployGUI.sh可执行。
./deployGUI.sh启动脚本（注意：如果是通过ssh方式登录的服务器，请用ssh登录的用户启动，否则可能导致安装页面无法弹出）
启动后安装界面如下图：
CPU，中间件，JDK路径，中间件路径，协同路径被置灰，不可选择
在协同产线中选择对应的产线：
选择需要升级的数据库版本：
JDBCDriver不需要修改
JDBC URL修改ip为需要升级的数据库ip，端口对应数据库的端口，人大金仓数据库，请修改后面的数据库名，达梦数据库需根据实际创建的实例名修改SEEYON的值（如果不确定，请参考中间件中的JDBC配置中填写的内容）
数据库用户：需要升级的数据库的用户名
密码：数据库用户的密码
填写后结果点击验证结果，如下图：
确定，点击升级，提示如下：
点击确定，等待升级，升级后弹出如下提示：
确定即可，至此数据库升级完成。
# 升级seeyon包
进入中间件部署的seeyon包路径（默认为V5/ApacheJetspeed/webapps/目录，若有修改，进入对应目录），修改seeyon文件夹名为seeyon_v8.0sp1_backup，复制V8.0SP2_XinChuang（根据部署的版本而定）/V5/ApacheJetspeed/webapps/seeyon目录至当前目录，将部署包deploytools/file/productiden中的文件，按产品线（A8V5-1：A8企业版、A8V5-2：A8集团版、A8N-1：A8-N企业版、A8N-2：A8-N集团版）拷贝对应文件夹下对应版本的ApacheJetspeed文件夹，然后启动中间件即可。
# 常见问题
# 执行以下终端命令：
+-----------------------------------------------------------------------+ | echo 'export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib' >> | | ~/.bashrc | | | | source ~/.bashrc | +-----------------------------------------------------------------------+
# 人大金仓数据库还原命令：
Linux：./ksql -USYSTEM -WSYSTEM -dSEEYONV5_RECOVERY -p54321 -f /home/v5/seeyondump.dmp Windows：ksql.exe -USYSTEM -WSYSTEM -dSEEYONV5_RECOVERY -p54321 -f /home/v5/seeyondump.dmp
参数说明：
-U：数据库用户账户
-W：数据库用户密码
-d：将被还原的数据库（需提前建好数据库）
-f：还原文件的存储路径 -p：人大金仓数据库端口
# 达梦数据库还原命令：
参考：https://blog.csdn.net/fengxiaozhenjay/article/details/104557505 (opens new window)
以模式还原为例
Linux：./dimp USERID=v80sp2_a82/Seeyon123456@localhost:5236 file=v80sp2_a82.dmp DIRECTORY=/home/dmdba/dmdbms/bin SCHEMAS=v80sp2_a82 Windows：dimp.exe USERID=v80sp2_a82/Seeyon123456@localhost:5236 file=v80sp2_a82.dmp DIRECTORY=/home/dmdba/dmdbms/bin SCHEMAS=v80sp2_a82
参数说明：
dimp命令位于达梦数据库安装目录/bin目录下（注意，windows下名称为dimp.exe） USERID：数据库用户名/数据库密码@数据库服务ip:数据库服务端口
file:数据库备份文件导出名
DIRECTORY：数据库备份文件导出位于的目录
SCHEMAS:需要导出的数据库模式名（一般与用户名一致）
