系统运维

# 致远协同管理软件

# 信创升级工具手册

北京致远互联软件股份有限公司

2022年3月

# 前言

本手册对协同管理系统的信创部署升级工具相关事宜进行说明。如对手册存在疑问，可与致远互联的客户服务人员联系。

# 工具概述

信创部署升级工具支持G6-N产品序列，在信创环境下的数据库自动化升级，支持人大金仓，达梦数据库。

注：当前工具仅适合G6-N V4.0、V5.0、V5.0SP1、V8.1到V8.1SP1信创环境下的升级。

G6-N其它版本请先升至V4.0以上版本

G6-N x86+tomcat请参考《致远 协同管理软件 V8.1SP1 产品升级手册（x86+tomcat端G6-N）》

G6-N 混网环境请参考《致远 G6-N 协同管理软件 V8.1SP1 混网环境升级部署手册.docx》

# 使用工具升级产品

# 产品升级流程

在信创环境下，产品部署的基本流程为：

# 工具升级产品方法

  • deploytools：信创部署所需周边文件目录

    • deploytools/file/info：产品注册信息

    • deploytools/file /jdbc：数据库连接用驱动jar

    • deploytools/file/productiden：产品线标识文件

    • deploytools/file/sql：数据库初始化SQL

  • Java：java运行环境目录

  • MediaService：音视频服务目录

  • NginxServer：nginx服务目录

  • OfficeTrans：在线预览服务目录

  • S1：S1 Agent程序目录

  • Search：全文检索服务目录

  • V5：协同应用目录

V5/ApacheJetspeed/conf/SeeyonConfig为参数配置工具，使用该工具时，需要先编辑

SeeyonConfig.sh中的JAVA_HOME路径为jdk的绝对路径，如图：

{width="5.341336395450568in" height="1.4482174103237095in"}

# 升级步骤

# 停止协同服务，备份数据库

停止协同服务（注意，中间件需要一起停止，不要只停止应用）

人大金仓数据库备份方法：

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:需要备份的数据库（即将要升级的数据库）模式名（一般与用户名一致）

# 拷贝配置文件

取升级前版本安装目录下base/conf/plugin.properties覆盖到升级工具deploytools/base/conf下

# 升级数据库

进入deploytools目录，目录中文件如下：

不同版本文件名称会有差异，请执行实际版本文件。

例如升级8.1SP1，请使用deployGUI-for-V8.1SP1-G6N.sh

支持图形界面和静默两种方式，两种方式二选一即可，不用两个都执行。建议使用图形界面方式。

  • 图形界面使用deployGUI-for-V8.1SP1-G6N.sh 启动。

  • 命令行静默方式使用deploycli-for-V8.1SP1-G6N.sh 启动，但前提条件为先配置对应的参数文件，具体参考后续说明。

Linux环境下启动脚本授权方法：

chmod +x deployGUI-for-V8.1SP1-G6N.sh，授权使deployGUI-for-V8.1SP1-G6N.sh可执行。

chmod +x deploycli-for-V8.1SP1-G6N.sh，授权使deploycli-for-V8.1SP1-G6N.sh可执行。

图形界面方式

./ deployGUI-for-V8.1SP1-G6N.sh启动脚本（注意：如果是通过ssh方式登录的服务器，请用ssh登录的用户启动，否则可能导致安装页面无法弹出）

启动后安装界面如下图：

CPU，中间件，JDK路径，中间件路径，协同路径被置灰，不可选择

在协同产线中选择对应的产线：

选择需要升级的数据库版本（神通只支持G6-N V8.1升级）：

选择完毕后界面如下图：

JDBCDriver不需要修改

JDBC URL修改ip为需要升级的数据库ip，端口对应数据库的端口，人大金仓数据库，请修改后面的数据库名，达梦数据库需根据实际创建的实例名修改SEEYON的值（如果不确定，请参考中间件中的JDBC配置中填写的内容）

数据库用户：需要升级的数据库的用户名

密码：数据库用户的密码

填写后结果点击验证结果，如下图：

确定，点击升级，提示如下：

{

点击确定，等待升级，升级后弹出如下提示：

确定即可，至此数据库升级完成。

命令行静默方式

静默方式必须先配置参数文件，再执行。

  1. 配置参数文件，文件路径为：安装路径下 cfgHome/installConfig.properties

    a. 请按#备注说明进行调整，调整为实际使用的值

    b. 调整完成保存

2、执行脚本

./deploycli-for-V8.1SP1-G6N.sh启动脚本

该形式无图形界面提示，所有信息通过窗口输出日志进行提示。

请注意查看窗口输入日志，根据日志判断是否成功。

成功日志形式如下：

失败日志形式如下：

中间校验出错时会有下面提示

请根据提示再次检查配置文件。

# 升级seeyon包

进入中间件部署的seeyon包路径（默认为V5/ApacheJetspeed/webapps/目录，若有修改，进入对应目录），修改seeyon文件夹名为seeyon_v81，复制V8.1SP1_XinChuang/V5/ApacheJetspeed/webapps/seeyon目录至当前目录，将部署包deploytools/file/productiden中的文件，按产品线（G6N-1：G6-N单组织版、G6N-2：G6-N多组织版）拷贝对应文件夹下对应版本的ApacheJetspeed文件夹。

# 升级ROOT包

进入中间件部署的ROOT包路径（默认为V5/ApacheJetspeed/webapps/目录，若有修改，进入对应目录），修改ROOT文件夹名为ROOT_v81，复制V8.1SP1_XinChuang/V5/ApacheJetspeed/webapps/ROOT目录至当前目录，将部署包deploytools/file/productiden中的文件，按产品线（G6N-1：G6-N单组织版、G6N-2：G6-N多组织版）拷贝对应文件夹下对应版本的ApacheJetspeed文件夹。

# 升级static包

进入中间件部署的static包路径（默认为V5/ApacheJetspeed/webapps/目录，若有修改，进入对应目录），复制V8.1SP1_XinChuang/V5/ApacheJetspeed/webapps/static目录至当前目录。

# 东方通配置升级

2.3.7.1 备份中间件

备份中间件TongWeb文件夹

2.3.7.2 拷贝jar包

将V5\ApacheJetspeed\webapps\seeyon\WEB-INF\lib\下druid.jar、guava.jar、seeyon-ctp-dbpool.jar和seeyon-ctp-jdbcproxydriver.jar复制到TongWeb/lib/目录下。同时删除V5\ApacheJetspeed\webapps\seeyon\WEB-INF\lib\seeyon-ctp-jdbcproxydriver.jar文件。

将所用数据库驱动jar文件放至TongWeb/lib/目录下。

2.3.7.3 配置数据源

2.3.7.3.1 方式一：图形化配置

登录控制台，在"JDBC配置"中点击jdbc/ctpDataSource数据源，如下图示：

（若数据源非该名称，请先删除再新增，注意升级前后数据源的驱动类名不一样）

  • 名称：jdbc/ctpDataSource

  • 资源类型：Datasource

  • Ip类型：ipv4

  • 数据库类型：选择所使用的数据库类型。其中dameng为达梦，Kingbase为人大金仓，oscar为神通数据库。

  • 达梦、人大金仓、神通数据库驱动类名均修改为：com.seeyon.ctp.monitor.perf.jdbcmonitor.proxyobj.JMProxyDriver

  • 连接url：自动生成，需要修改ip地址、端口号、数据库名为实际情况

  • 达梦连接url（示例）：jdbc:dm://10.3.4.206:5236/SEEEYON

  • 人大金仓连接url（示例）：

jdbc:kingbase8://10.3.4.192:54321/SEEYON?clientEncoding=UTF-8

  • 神通数据库连接url（示例）：jdbc:oscar://10.6.8.130:2003/SEEYON(这里填写神通数据库创建时的填写的数据库名)

  • 用户名、密码填写实际情况。

  • 连接参数：暂无修改

  • 驱动路径：点击浏览进行文件选择，选择与数据库版本一致的驱动，建议从安装后的数据库目录中拷贝。

    下一步时将提示数据库连接拒绝，先不处理。

测试SQL可以使用：select 1 from ctp_config

其他配置保持默认，暂无需调整。

完成后，点击测试连接，提示数据库连接成功

2.3.7.3.2 方式二：文件配置

打开TongWeb/conf/tongweb.xml，找到<jdbc-connection-pool书签属性name，内容改为jdbc/ctpDataSource，jdbc-driver内容改成com.seeyon.ctp.monitor.perf.jdbcmonitor.proxyobj.JMProxyDriver

2.3.7.4 JVM参数配置

2.3.7.4.1 方式一：图形化配置（适用于东方通7.0以上，东方通6.1请使用方式二）

登录控制台，在"启动参数配置"中点击"其它jvm参数"，添加数据库驱动类名配置，进行保存，(针对所用数据库配置指定信息)：

人大金仓：-Djdbcproxydriver.driverclass=com.kingbase8.Driver

达梦：-Djdbcproxydriver.driverclass=dm.jdbc.driver.DmDriver

神通：-Djdbcproxydriver.driverclass=com.oscar.Driver

如下图：

2.3.7.4.2 方式二：文件配置

在东方通的bin/external.vmoptions文件中，增加jdbcproxydriver.driverclass数据库驱动类名配置

参数请参照方式一。

2.3.7.5 配置应用

说明：G6-N低版本已经配置好了seeyon/ROOT 等应用，本次升级只需再配置static应用即可。

static应用目录为2.3升级步骤/2.3.6的升级static包存放位置。

2.3.7.5.1 方式一：图形化配置

登录控制台，在"应用管理"中，点击[部署应用]，进行static配置，点击[开始部署]

如下图示：

2.3.7.5.2 方式二：文件配置

TongWeb/conf/tongweb.xml中直接增加static应用，复制原有seeyon应用配置，修改为static

Static应用目录2.3.7.5.1中已做说明。

例如：（仅做参考）

<web-app jsp-compile="false" enabled="true" is-autodeploy="false" dtd-validate="false" object-type="user" deploy-order="100" is-directory="true" vs-names="server" context-root="/static" location="../../ApacheJetspeed/webapps/static" original-location="../../ApacheJetspeed/webapps/static" name="static" delegate="false" version-serial-number="1" retire-timeout="0" retire-strategy="nature" retire-state="none"/>

2.3.7.6 其它配置

请检查中间件相关配置，参考V8.1SP1部署文档《致远 G6-N 协同管理软件 V8.1SP1 信创环境部署手册.docx》。若已按照手册做过配置，请忽略。

# 金碟配置升级

说明：中间件域-致远产品域名统一用seeyon来做示例说明。

2.3.8.1 备份中间件

备份中间件AAS文件夹

2.3.8.2 拷贝jar包

  • 把V5/ApacheJetspeed/webapps/seeyon/WEB-INF/lib

    或V5/ApacheJetspeed/lib下的

seeyon-ctp-jdbcproxydriver.jar、seeyon-ctp-dbpool.jar、seeyon-statistics.jar

剪切到AAS\domains\seeyon\lib下

  • 将V5\ApacheJetspeed\webapps\seeyon\WEB-INF\lib\druid.jar、guava.jar复制到AAS\domains\seeyon\lib下

  • V5/ApacheJetspeed/webapps/seeyon/WEB-INF/lib下一定不能有、不能有、不能有 seeyon-ctp-jdbcproxydriver.jar

    2.3.8.3 配置数据源

2.3.8.3.1 方式一：图形化配置

登录控制台，在seeyon-"数据源"中点击jdbc/ctpDataSource数据源，如下图示：

  • JNDI：jdbc/ctpDataSource

  • 达梦、人大金仓、神通数据库驱动类名均修改为：com.seeyon.ctp.monitor.perf.jdbcmonitor.proxyobj.JMProxyDriver

  • 达梦连接url（示例）：jdbc:dm://10.3.4.206:5236/SEEEYON

  • 人大金仓连接url（示例）：

jdbc:kingbase8://10.3.4.192:54321/SEEYON?clientEncoding=UTF-8

  • 神通数据库连接url（示例）：jdbc:oscar://10.6.8.130:2003/SEEYON(这里填写神通数据库创建时的填写的数据库名)

  • 用户名、密码依据实际情况填写

  • 类路径：点击浏览进行文件选择，选择与数据库版本一致的驱动，建议从安装后的数据库目录中拷贝，建议将驱动jar放置在金蝶域的lib下。人大金仓驱动路径如：

find /home/kingbase/Kingbase -name kingbase8*.jar

2.3.8.3.2 方式二：文件配置

进入AAS/domains/seeyon/config/datasources.xml，找到<datasource下属性driver-class内容改成

com.seeyon.ctp.monitor.perf.jdbcmonitor.proxyobj.JMProxyDriver

driver-classpath内容改成 ..\应用\lib\驱动包

2.3.8.4 JVM参数配置

2.3.8.4.1文件配置（未提供图形化配置）

进入AAS/domains/seeyon/bin/startapusic

在OTHERS_JVMOPTS增加jdbcproxydriver.driverclass数据库驱动类名配置（针对所用数据库配置指定信息，注意前后空格隔开）：

人大金仓：-Djdbcproxydriver.driverclass=com.kingbase8.Driver

达梦：-Djdbcproxydriver.driverclass=dm.jdbc.driver.DmDriver

神通：-Djdbcproxydriver.driverclass=com.oscar.Driver

若没有OTHERS_JVMOPTS参数，请参考V8.1SP1部署文档《致远 G6-N 协同管理软件 V8.1SP1 信创环境部署手册.docx》进行配置。

2.3.8.5 配置应用

2.3.8.5.1 方式一：图形化配置

登录控制台，在seeyon-"应用管理"中进行协同应用（V5/ApacheJetspeed/webapps/static）应用部署。

2.3.8.5.2 方式二：文件配置

进入AAS/domains/seeyon/config/server.xml，参考seeyon的配置方式

示例如下：

<application name="seeyon" base="../../../ApacheJetspeed/webapps/seeyon" start="auto" loadon="104"/>

2.3.8.6 其它配置

请检查中间件相关配置，参考V8.1SP1部署文档《致远 G6-N 协同管理软件 V8.1SP1 信创环境部署手册.docx》。若已按照手册做过配置，请忽略。

# 应用启动及访问

说明：需重新申请加密狗

协同系统预置的用户：

角色 用户名 密码

初始化管理员（所有版本） init-admin 默认为123456

说明：原组织管理员、单位管理员、系统管理员账号失效。升级后会预置一个初始化账号和密码，通过登录初始化账号来完成初始管理员角色分配，分配的管理员作为标准系统中正常使用的管理员，并且初始化账号完成设置退出系统后账号会失效。

# 常见问题

# 执行以下终端命令：

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
R6版本还原：(去掉-W参数)
Linux：./ksql -USYSTEM -dSEEYONV5_RECOVERY -p54321 -f /home/v5/seeyondump.dmp
Windows：ksql.exe -USYSTEM -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:需要导出的数据库模式名（一般与用户名一致）

# 神通数据库恢复命令：

恢复用户与备份脚本用户相同：

osrimp -uv81a82aas/szoscar55 -h192.168.225.40 -p2003 -dSEEYON level=schema file=/home/test.osr log=/home/用户名_LOG_时间.log schema=v81a82aas ignore=true nocheckvalidate=true

恢复用户与备份脚本用户不同：

osrimp -usysdba/szoscar55 -h192.168.225.40 -p2003 -dosrdb level=schema file=/home/.osr log=/home/用户名_LOG_时间.log fromuser=v81a82aas touser=v81a82restore ignore=true nocheckvalidate=true

osrimp位于神通数据库安装目录/bin目录下

file：备份文件的目录

schema：备份文件的模式名（参考备份文件填写的schema）

fromuser：备份文件的模式名，touser=恢复到指定名称的用户模式

# 驱动版本不匹配

现象：驱动报错会在控制台有类似信息：

原因：当前工具内置了数据库其中一个版本的驱动，对于其他版本的数据库需要手工替换对应版本的驱动。并修改启动脚本里引用的jar包名。

解决方法：1、替换lib目录下对应数据库的jdbc驱动。例如：kingbase8-8.6.0.jar

2、修改启动脚本里引用的jar名包名。例如：

# 常见升级日志报错

升级日志中大量的sql报错，提示XX表已存在、XX字段已存在、XX已有数据、XX主键冲突、违反表XX唯一性约束、Duplicate column name/Duplicate column table、此列列表已索引等（不同库的报错描述不一样）

列不存在GOVDOC_LEADER_PERMISSION表CREATE_PERSON/CATEGORY/PERMISSION_ID

列已经存在PISHI_DEAL表PROXY_TIME

列已经存在SUPERVISION_RELATION表REFERENCE_ID/CREATE_ACCOUNT_ID

不能向索引PK_PORTAL_GLOBAL_CONFIG中插入重复键值

不能向索引PK_PORTAL_SPACE_PAGE中插入重复键值

原因：A8与 G6功能重合，G6兼容版多导致重复表或字段

解决方法：不处理，忽略。

# 首页报错进不了登录页

现象：首页报错：

1650608995427.png

原因：1升级脚本出错 2驱动类名没有替换成代理驱动

解决方法：

1 检查升级日志，有没有其它报错，是不是升级失败了

2 信创数据库驱动类名是否替换成代理类名com.seeyon.ctp.monitor.perf.jdbcmonitor.proxyobj.JMProxyDriver

# DM数据库升级过程存储过程报错

原因：可能是DM数据库关键字引起

解决方法：请检查 DM安装目录中dm.ini，WORDS后面是否有设置值，如有则置为空

编撰人：zhangshuang、yangtao

快速跳转

← G6-N信创环境部署手册 →