# 致远协同管理软件信创环境部署手册V9.1
北京致远互联软件股份有限公司 2025年6月
# 修订记录
| 修订内容 | 修订时间 |
|---|---|
| V9.1初始修订版 | 2025-6-26 |
# 前言
本手册对协同管理系统的信创部署升级工具相关事宜进行说明。如对手册存在疑问，可与致远互联的客户服务人员联系。
# 标准产品适配范围
标准产品主系统支持的信创环境如下：
| 分类 | 信创适配范围 | 备注 |
|---|---|---|
| 协同产品版本 | A8-N 或 G6-N 9.1 | |
| 服务器CPU | 飞腾、鲲鹏、海光、龙芯（MIPS）、兆芯 | 推荐飞腾、鲲鹏、海光 |
| 服务器操作系统 | 麒麟V10、统信UOS 2.0 | 支持部署到Linux系统 |
| 服务器中间件 | 东方通7.0.4、金蝶V9 V10、宝兰德952 955（参考单独的部署手册） | 支持使用Tomcat中间件 |
| 服务器数据库 | 达梦8、（人大）中电科金仓V8 R6（Oracle模式）、神舟通用7、南大通用Gbase8s致远专版 | 支持使用MySQL、SQLServer、Oracle数据库 |
如客户选型的产品不在标准范围内，则存在项目化适配成本及风险，请谨慎选型。
# 环境资源准备清单
进行信创环境主系统部署时，需要准备如下物料：
| 物料名称 | 备注 | 提供方 |
|---|---|---|
| XinChuang.zip安装包 | 协同-N系列产品安装程序，通过商务公布的产品下载地址下载 | 致远 |
| 服务器 | 准备满足服务运行的服务器 | 客户 |
| 操作系统 | 准备与-N标准产品适配的操作系统并安装在服务器内 | 客户 |
| 数据库 | 准备与-N标准产品适配的数据库 | 客户 |
| 中间件 | 准备与-N标准产品适配的信创中间件 | 客户 |
| JDK | 准备兼容对应信创系统的openjdk，要求jdk8（如openjdk 1.8.0 372） | 客户 |
| 客户端 | 准备客户端电脑及浏览器 客户端功能兼容性见商务公布的产品下载地址-文档-产品功能清单.xlsx | 客户 |
| 代理服务 | Nginx之类的代理服务（按实际场景判断是否需要） | 客户或授权致远建设 |
| 缓存服务 | Redis之类的集中式缓存服务（仅集群环境需要） | 客户或授权致远建设 |
| 文件存储 | 单机可本机磁盘存储，集群需要NFS存储，支持华为OBS对象存储 | 客户或授权致远建设 |
# 部署结构和硬件配置
产品支持多种部署模式，不同模式所需资源不同，可以根据用户需求自由选择对应的方案。
# 简单部署模式
单机部署，即常规单服务部署模式，保证基本功能可用，适合在线用户不多的客户。
- 面向中小型客户（同时在线1000人以下）
- 资源成本需求低（服务器台数和硬件配置都要求较小）
- 运维操作门槛低
# 集群部署模式
集群部署模式，为了提升高并发用户在线体验，将协同主应用部署成集群，通过负载来实现请求分发，分担服务器压力。集群模式下，为保证缓存一致性，需要部署Redis服务。
- 面向中大型客户（同时在线1000人以上）
- 满足高性能、主应用高可用部署要求，资源成本可控
- 易于运维维护
# 高可用集群部署模式
如果客户有完全高可用要求，产品也提供了高可用部署方案，协同应用、Redis、全文检索、音视频等都有对应的高可用解决方案。
- 面向可用性要求高的客户
- 满足高性能、高可用部署要求
- 对服务器资源有一定要求，服务运维数量较多
共享存储和数据库的高可用不在本产品支持范围，需要寻找专业厂商的方案支持。
# 服务器硬件注意事项
1、服务器申报时通常都是8C16G500G这样的格式，意思是申请8核心CPU、16G内存、500G硬盘的服务器，项目上需要根据客户的在线人数以及部署模式（单机或集群）来测算所需的服务器数量和硬件配置。
2、推荐只取服务器总内存的50%~70%的给协同使用，剩余内存需要用来支撑操作系统正常运行。
3、网络要求：服务与服务之间要求在同一局域网内，避免网络波动，保证1Gbps以上的网络传输要求。
商务公布的产品下载地址-文档-产品功能清单.xlsx-信创运行环境有对服务器带宽的推荐
4、推荐分离部署模式，即每个服务都单独部署到独立的服务器上，避免多个服务部署在同一服务器引发资源争抢。
5、如个两个服务一定要在一台服务器集中部署，则硬件资源必须是两个服务硬件资源之和。
如A服务4C8G+B服务8C16G=集中部署服务器12C24G。
6、部署架构图只是示例，图上的节点数量不代表真正服务器数量，项目上需要结合用户实际场景来准备相应的服务器资源。
7、服务器支持物理实体机、VM虚拟机（如超融合），标准产品不支持Docker容器化
# 服务器软件注意事项
1、数据库必须是关系型数据库，不支持分布式分片存储，不支持读写分离，数据库硬件配置、高可用方案以数据库厂商专业意见为准
2、仅协同应用集群时，才需要Redis服务，如不能使用Redis，则可参考采购东方通TongRDS、宝兰德BES cacheserver等类Redis缓存方案
3、协同应用集群时，需要使用Nginx这样的负载均衡服务，如不能使用Nginx，可参考采购东方通TongHttpServer、宝兰德DB-Proxy或硬件负载。
4、协同应用需要在中间件下运行，产品支持信创下部署开源的Tomcat中间件，也可以采购产品适配的信创中间件。信创需要采购中间件套数：协同单机就1套中间件，协同双机集群就2套中间件，依次类推。
5、协同和中间件依赖Java JDK8，信创环境下请联系操作系统厂商提供与系统相匹配的jdk8。要求版本不低于1.8.0.212，推荐尽量与协同产品验证的JDK一致：openjdk_1.8.0_372_B07。
# 服务器软硬件阶梯配置
如下是根据系统平均在线人数的硬件配置参考。配置不是绝对，不同客户的使用场景不同，可根据生产实际运行状况来做增、降配操作。
如使用Nginx服务做负载均衡、反向代理、SSL管理，需要至少准备1台2C4G（或4C8G）服务器给Nginx使用
| 在线人数 | 部署方式 | 信创协同服务器配置参考 | 协同服务器数量 | 中间件套数（信创） | Redis服务器参考（单机） |
|---|---|---|---|---|---|
| 200以下 | 单机 | CPU12核以上/内存24G以上/硬盘320G以上 | 1 | 1 | 不涉及 |
| 200~500 | 单机 | CPU12核以上/内存32G以上/硬盘320G以上 | 1 | 1 | 不涉及 |
| 500~1000 | 单机 | CPU24核以上/内存48G以上/硬盘320G以上 | 1 | 1 | 不涉及 |
| 1000~2000 | 1主1从 | CPU24核以上/内存64G以上/硬盘320G以上 | 2 | 2 | CPU4核/内存12G |
| 2000~3000 | 1主2从 | CPU32核以上/内存64G以上/硬盘320G以上 | 3 | 3 | CPU4核/内存16G |
| 3000~5000 | 1主2从 | CPU32核以上/内存96G以上/硬盘320G以上 | 3 | 3 | CPU8核/内存24G |
| 5000~10000 | 1主3从 | CPU64核以上/内存128G以上/硬盘320G以上 | 4 | 4 | CPU8核/内存24G |
# 产品部署包说明
# XinChuang部署包
信创部署包通过商务公布的产品下载地址下载当前版本最新的程序，信创下载命名为“版本号_XinChuang.zip”的部署包，示意图如下：
将XinChuang.zip解压后，XinChuang部署包每个目录的功能说明：
- deploytools：信创环境部署工具目录，本手册按不同中间件分类做了部署使用方法说明：
- deploytools/deployGUI-for-9.1-A8N.sh：A8N图形化安装脚本
- deploytools/deployGUI-for-9.1-G6N.sh：G6N图形化安装脚本
- deploytools/deploycli-for-9.1-A8N.sh : A8N命令行安装脚本
- deploytools/deploycli-for-9.1-G6N.sh : G6命令行安装脚本
- FileService：文件下载服务目录，部署方法见对应的手册
- java：信创部署工具依赖的jdk，适用于X86环境，其它环境可能不适用（需联系系统厂商提供）
- MediaService：音视频服务目录，部署方法见对应的手册
- needcopy：某些特殊环境下无法使用打印服务时使用，部署过程中如手册有提及此目录再按要求操作
- OfficeTrans：在线预览服务目录，部署方法见本手册“在线预览服务部署”章节。
- S1：运维服务工具，支持在线打补丁等功能，部署方法见对应的手册
- Search：全文检索服务目录，部署方法见对应的手册
- V5/ApacheJetspeed.7z：协同应用压缩包，切勿删除，信创部署工具或纯手工部署依赖此包
# 各中间件部署快捷链接
| 中间件 | 快捷链接 |
|---|---|
| 东方通7.0.4 | 【东方通7.0.4部署协同】 |
| 金蝶V9 | 【金蝶V9部署协同】 |
| 金蝶V10 | 【金蝶V10部署协同】 |
| Tomcat中间件 | 【Tomcat中间件部署协同】 |
| 宝兰德 | 见独立的宝兰德部署手册 |
| 东方通8 | 信创工具不支持，项目化支持 |
# 达梦数据库集成注意事项
# 达梦集成-项目组注意事项
如客户使用达梦数据库，请项目组按如下要求配合达梦、客户多方完成集成部署：
1、产品不提供达梦数据库本身的安装部署、维护、调优、转库详细解决方案，此类方案以数据库厂商专业支持为准
2、产品对达梦数据库有一些基本配置和字段类型要求，初始化数据库前请将“达梦方注意事项”说明转给达梦厂商，避免集成部署异常
3、新客户使用达梦数据库的部署路线：达梦厂商准备一个空库，致远侧按对应中间件手册部署协同系统，工具部署时会自动向达梦空库写入初始化脚本
4、老客户转达梦数据库的部署路线：
- 第一步，达梦厂商准备一个空库，致远侧按对应中间件手册部署协同应用系统，先确保一个初始化环境能部署、启动、登录成功
- 第二步，老客户原环境升级协同到当前版本，达梦侧进行数据库转库，第一步部署的协同应用数据库URL地址指向本步转库后的数据库地址
- 第三步，迁移老客户原环境的附件、资源文件到信创环境，随后启动、登录、验证功能完整性
5、协同应用系统基于Java JDBC连接数据库，需要联系达梦厂商提供与当前达梦库版本相匹配的驱动jar，然后按手册要求放置到对应位置
6、注意检查达梦版本和产品线，根据标准支持范围选择达梦数据库版本型号。不推荐达梦标准版产品线作为生产数据库 (opens new window)。
# 达梦集成-达梦方注意事项
1、不支持分布式分片存储，不支持读写分离，高可用可以用主备模式
2、标准产品支持默认的达梦库，不要选择任何兼容模式（不要选择兼容Oracle、兼容MySQL之类的选项）
3、达梦建库标准：新建一个给产品用的用户，达梦会自动创建用户同名的库名，确保连接URL上的数据库名与用户同名，功能就不会有什么问题。示例如：
-- 创建给协同使用的用户并设置密码
CREATE USER seeyon_oa IDENTIFIED BY "3S33c414574265d";
-- 授予读写权限
GRANT RESOURCE TO seeyon_oa;
GRANT soi TO seeyon_oa;
4、主键类型必须设置为默认非聚集（聚集键和大字段无法共存），此问题配置错误对转库后功能使用影响很大
5、转达梦库时不要重命名原库的INDEX索引名称，产品是根据索引名称判断索引是否存在
6、V8.2之后协同应用就未使用过存储过程、视图、触发器、函数，转达梦库时如涉及这些东西，可能是客户、客开、第三方加的（如LEXMIS_开头的存储过程是致迈插件），标准产品不涉及这些
7、转达梦库后最常见的问题一是丢失索引，直接表现是系统部分功能卡顿，致远项目组可尝试用环境检查工具扫描缺失的索引，或者取XinChuang部署包中的初始化SQL给达梦老师协助，里面有全套索引可做补齐，初始SQL位置：XinChuang\deploytools\file\sql\init\A8N-2\DM目录
8、转达梦库后最常见问题二是字段映射错误，直接表现是部分功能正常，部分功能页面各种报错。必须按照如下字段映射关系做转库（非常关键，请务必将图片转给达梦）：
| MYSQL | ORACLE | SQLSERVER | POSTGRESQL | DM | KINGBASE（兼容Oracle） | OSCAR | GBASE | HBM文件 | POJO类型 | 场景 |
|---|---|---|---|---|---|---|---|---|---|---|
| BIGINT | INTEGER | BIGINT | INT8 | BIGINT | INT8 | BIGINT | BIGINT | long | java.lang.Long | 主键 |
| DATE | DATE | DATETIME | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | timestamp | java.util.Date | 日期 |
| DATETIME | DATE | DATETIME | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | timestamp | java.util.Date | 日期时间 |
| DECIMAL | NUMBER | NUMERIC | NUMERIC | NUMBER | NUMERIC | NUMBER | NUMBER | double | java.lang.Double | 小数 |
| INT | INTEGER | INT | INT4 （Oracle用INT8） | INT （Oracle用BIGINT） | INT4 （Oracle用INT8） | INTEGER | INT | integer | java.lang.Integer | 整数 |
| LONGBLOB | BLOB | IMAGE | BYTEA | BLOB | BYTEA | BLOB | BLOB | string | java.lang.String | 二进制对象 |
| LONGTEXT | CLOB | NTEXT | TEXT | CLOB | TEXT | CLOB | CLOB | string | java.lang.String | 大文本 |
| SMALLINT | NUMBER(4) | SMALLINT | INT2 | SMALLINT | INT2 | SMALLINT | SMALLINT | integer | java.lang.Integer | 数字枚举 |
| VARCHAR | VARCHAR2 | NVARCHAR | VARCHAR | VARCHAR | VARCHAR | VARCHAR | VARCHAR | string | java.lang.String | 文本 |
9、部分数据库参数要求配置如下：
- 页大小建议32K，如厂商有更好的建议可参考数据库厂商意见
- 字符集要求UTF-8
- “字符串比较大小写敏感”建议取消勾选，如勾选会导致系统内输入小写英文词组查询不到大写词组（反之亦然）的问题（如高版本无相关配置可忽略此选项）
10、若从Oracle数据库迁移数据至达梦，需要调整达梦数据库dm.ini（位于创建数据库时，指定数据库目录/具体服务名下）以下参数：
COMPATIBLE_MODE=2
并重启达梦服务后，再进行数据迁移。
迁移任务执行时，勾选"以文本方式显示执行任务"，如下所示：
11、如项目是取XinChuang\deploytools\file\sql\init\A8N-2\DM目录ALL-IN-ONE，手工向达梦数据库导入SQL，则要求执行命令行导入数据前先执行set define off;，不要对我们初始化SQL做任何的变量解析。下图是导入命令最常见的错误：
12、产品集成达梦V8 2025年版本，在进行安装部署时可能遇到异常，需要设置忽略MODEL关键字，问题现象和解决方案详见【信创部署工具+达梦数据库安装报错：[MODEL]附近出现错误】 https://open.seeyoncloud.com/#/faq/faq/v1/share?url=Z2JySmU+NDgzNw==
13、在进行了版本升级、数据库转库、数据库迁移、数据库还原操作后，请对数据库做一次统计信息更新，减少性能问题出现概率。
14、请针对客户的环境情况，编写定期自动收集统计信息的脚本，避免使用一段时间后数据库整体性能降低。
# 人大金仓数据库集成注意事项
人大金仓现更名为中电科金仓（简称电科金仓），英文名为Kingbase。
# 金仓集成-项目组注意事项
如客户使用金仓数据库，请项目组按如下要求配合金仓、客户多方完成集成部署：
1、产品不提供金仓数据库本身的安装部署、维护、调优、转库详细解决方案，此类方案以数据库厂商专业支持为准
2、产品对金仓数据库有一些兼容类型、基本配置和字段类型要求，初始化数据库前请将“金仓方注意事项”说明转给金仓厂商，避免集成部署异常
3、新客户使用金仓数据库的部署路线：金仓厂商准备一个空库，致远侧按对应中间件手册部署协同系统，工具部署时会自动向金仓空库写入初始化脚本
4、老客户转金仓数据库的部署路线：
- 第一步，金仓厂商准备一个空库，致远侧按对应中间件手册部署协同应用系统，先确保一个初始化环境能部署、启动、登录成功
- 第二步，老客户原环境升级协同到当前版本，金仓侧进行数据库转库，第一步部署的协同应用数据库URL地址指向本步转库后的数据库地址
- 第三步，迁移老客户原环境的附件、资源文件到信创环境，随后启动、登录、验证功能完整性
5、协同应用系统基于Java JDBC连接数据库，需要联系金仓厂商提供与当前金仓库版本相匹配的驱动jar，然后按手册要求放置到对应位置
# 金仓集成-金仓方注意事项
1、不支持分布式分片存储，不支持读写分离
2、自R6版本开始，金仓初始化时必须选择“兼容Oracle模式”，产品不支持其它兼容模式
客户原库是SQLServer，也必须是SQLServer转金仓Oracle兼容模式！
3、转金仓库时不要重命名原库的INDEX索引名称，产品是根据索引名称判断索引是否存在
4、V8.2之后协同应用就未使用过存储过程、视图、触发器、函数，转金仓库时如涉及这些东西，可能是客户、客开、第三方加的（如LEXMIS_开头的存储过程是致迈插件），标准产品不涉及这些
5、转金仓库后最常见的问题一是丢失索引，直接表现是系统部分功能卡顿，致远项目组可尝试用环境检查工具扫描缺失的索引，或者取XinChuang部署包中的初始化SQL给金仓老师协助，里面有全套索引可做补齐，初始SQL位置：XinChuang\deploytools\file\sql\init\A8N-2\KingBase目录
6、金仓数据库连接格式要求jdbc:kingbase8://金仓IP:端口/SEEYON?clientEncoding=UTF-8这种形式，不要在URL带¤tSchema=指定schema这种信息，如果金仓指定了Schema（如指定dbo是OA的库），需要在数据库中设置search_path='"$user",dbo,public'，确保默认连接的Schema模式是OA的库。
7、转金仓库后最常见问题二是字段映射错误，直接表现是部分功能正常，部分功能页面各种报错。必须按照如下字段映射关系做转库（非常关键，请务必将图片转给金仓）：
| MYSQL | ORACLE | SQLSERVER | POSTGRESQL | DM | KINGBASE（兼容Oracle） | OSCAR | GBASE | HBM文件 | POJO类型 | 场景 |
|---|---|---|---|---|---|---|---|---|---|---|
| BIGINT | INTEGER | BIGINT | INT8 | BIGINT | INT8（对应bigint） | BIGINT | BIGINT | long | java.lang.Long | 主键 |
| DATE | DATE | DATETIME | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0)（对应date） | TIMESTAMP(0) | TIMESTAMP(0) | timestamp | java.util.Date | 日期 |
| DATETIME | DATE | DATETIME | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0)（对应date） | TIMESTAMP(0) | TIMESTAMP(0) | timestamp | java.util.Date | 日期时间 |
| DECIMAL | NUMBER | NUMERIC | NUMERIC | NUMBER | NUMERIC （对应decimal） | NUMBER | NUMBER | double | java.lang.Double | 小数 |
| INT | INTEGER | INT | INT4 （Oracle转INT8） | INT （Oracle转BIGINT） | INT4 （对应int） （Oracle转INT8） | INTEGER | INT | integer | java.lang.Integer | 整数 |
| LONGBLOB | BLOB | IMAGE | BYTEA | BLOB | BYTEA （对应longblob） | BLOB | BLOB | string | java.lang.String | 二进制对象 |
| LONGTEXT | CLOB | NTEXT | TEXT | CLOB | TEXT （对应longtext） | CLOB | CLOB | string | java.lang.String | 大文本 |
| SMALLINT | NUMBER(4) | SMALLINT | INT2 | SMALLINT | INT2 （对应smallint） | SMALLINT | SMALLINT | integer | java.lang.Integer | 数字枚举 |
| VARCHAR | VARCHAR2 | NVARCHAR | VARCHAR | VARCHAR | VARCHAR | VARCHAR | VARCHAR | string | java.lang.String | 文本 |
8、部分数据库参数要求配置如下：
- 如涉及选择兼容数据库，必须勾选兼容Oracle，其余不支持
- 字符集要求UTF-8
- 勾选CASE-INSENSITIVE：执行字符串比较和搜索操作时，数据库不区分大小写
- 是否支持空字符串插入参数设置为off：修改kingbase.conf中的参数ora_input_emptystr_isnull=off
# 神舟通用数据库集成注意事项
# 神通集成-项目组注意事项
如客户使用神通数据库，请项目组按如下要求配合神通、客户多方完成集成部署：
1、产品不提供神通数据库本身的安装部署、维护、调优、转库详细解决方案，此类方案以数据库厂商专业支持为准
2、产品对神通数据库有一些兼容类型、基本配置和字段类型要求，初始化数据库前请将“神通方注意事项”说明转给神通厂商，避免集成部署异常
3、新客户使用神通数据库的部署路线：神通厂商准备一个空库，致远侧按对应中间件手册部署协同系统，工具部署时会自动向神通空库写入初始化脚本
4、老客户转神通数据库的部署路线：
- 第一步，神通厂商准备一个空库，致远侧按对应中间件手册部署协同应用系统，先确保一个初始化环境能部署、启动、登录成功
- 第二步，老客户原环境升级协同到当前版本，神通侧进行数据库转库，第一步部署的协同应用数据库URL地址指向本步转库后的数据库地址
- 第三步，迁移老客户原环境的附件、资源文件到信创环境，随后启动、登录、验证功能完整性
5、协同应用系统基于Java JDBC连接数据库，需要联系神通厂商提供与当前神通库版本相匹配的驱动jar，然后按手册要求放置到对应位置
# 神通集成-神通方注意事项
1、不支持分布式分片存储，不支持读写分离
2、神通数据库必须选择选择兼容oracle模式，产品不支持其它兼容模式
3、转神通库时不要重命名原库的INDEX索引名称，产品是根据索引名称判断索引是否存在
4、V8.2之后协同应用就未使用过存储过程、视图、触发器、函数，转神通库时如涉及这些东西，可能是客户、客开、第三方加的（如LEXMIS_开头的存储过程是致迈插件），标准产品不涉及这些
5、转神通库后最常见的问题一是丢失索引，直接表现是系统部分功能卡顿，致远项目组可尝试用环境检查工具扫描缺失的索引，或者取XinChuang部署包中的初始化SQL给神通老师协助，里面有全套索引可做补齐，初始SQL位置：XinChuang\deploytools\file\sql\init\A8N-2\Oscar目录
6、转神通库后最常见问题二是字段映射错误，直接表现是部分功能正常，部分功能页面各种报错。必须按照如下字段映射关系做转库（非常关键，请务必将图片转给神通）：
| MYSQL | ORACLE | SQLSERVER | POSTGRESQL | DM | KINGBASE（兼容Oracle） | OSCAR | GBASE | HBM文件 | POJO类型 | 场景 |
|---|---|---|---|---|---|---|---|---|---|---|
| BIGINT | INTEGER | BIGINT | INT8 | BIGINT | INT8 | BIGINT | BIGINT | long | java.lang.Long | 主键 |
| DATE | DATE | DATETIME | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | timestamp | java.util.Date | 日期 |
| DATETIME | DATE | DATETIME | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | timestamp | java.util.Date | 日期时间 |
| DECIMAL | NUMBER | NUMERIC | NUMERIC | NUMBER | NUMERIC | NUMBER | NUMBER | double | java.lang.Double | 小数 |
| INT | INTEGER | INT | INT4 （Oracle转INT8） | INT （Oracle转BIGINT） | INT4 （Oracle转INT8） | INTEGER | INT | integer | java.lang.Integer | 整数 |
| LONGBLOB | BLOB | IMAGE | BYTEA | BLOB | BYTEA | BLOB | BLOB | string | java.lang.String | 二进制对象 |
| LONGTEXT | CLOB | NTEXT | TEXT | CLOB | TEXT | CLOB | CLOB | string | java.lang.String | 大文本 |
| SMALLINT | NUMBER(4) | SMALLINT | INT2 | SMALLINT | INT2 | SMALLINT | SMALLINT | integer | java.lang.Integer | 数字枚举 |
| VARCHAR | VARCHAR2 | NVARCHAR | VARCHAR | VARCHAR | VARCHAR | VARCHAR | VARCHAR | string | java.lang.String | 文本 |
7、部分数据库参数要求配置如下：
- 必须选择兼容oracle模式
- 库字符集要求UTF-8，字符排序和字符分类选择en_US.UTF-8
- 数据页面大小建议选择32k
# 南大通用数据库安装配置
# 南通集成-项目组注意事项
如客户使用南通数据库，请项目组按如下要求配合南通、客户多方完成集成部署：
1、产品不提供南通数据库本身的安装部署、维护、调优、转库详细解决方案，此类方案以数据库厂商专业支持为准
2、新客户使用南通数据库的部署路线：南通厂商准备一个空库，致远侧按对应中间件手册部署协同系统，工具部署时会自动向南通空库写入初始化脚本
3、老客户转南通数据库的部署路线：
- 第一步，南通厂商准备一个空库，致远侧按对应中间件手册部署协同应用系统，先确保一个初始化环境能部署、启动、登录成功
- 第二步，老客户原环境升级协同到当前版本，南通侧进行数据库转库，第一步部署的协同应用数据库URL地址指向本步转库后的数据库地址
- 第三步，迁移老客户原环境的附件、资源文件到信创环境，随后启动、登录、验证功能完整性
4、协同应用系统基于Java JDBC连接数据库，需要联系南通厂商提供与当前南通库版本相匹配的驱动jar，然后按手册要求放置到对应位置
# 南通集成-南通方注意事项
1、必须选择南大通用Gbase8s致远专版
2、转南通库时不要重命名原库的INDEX索引名称，产品是根据索引名称判断索引是否存在
3、V8.2之后协同应用就未使用过存储过程、视图、触发器、函数，转南通库时如涉及这些东西，可能是客户、客开、第三方加的（如LEXMIS_开头的存储过程是致迈插件），标准产品不涉及这些
4、转南通库后最常见的问题一是丢失索引，直接表现是系统部分功能卡顿，致远项目组可尝试用环境检查工具扫描缺失的索引，或者取XinChuang部署包中的初始化SQL给南通老师协助，里面有全套索引可做补齐，初始SQL位置：XinChuang\deploytools\file\sql\init\A8N-2\Gbase目录
5、转南通库后最常见问题二是字段映射错误，直接表现是部分功能正常，部分功能页面各种报错。必须按照如下字段映射关系做转库（非常关键，请务必将图片转给南通）：
| MYSQL | ORACLE | SQLSERVER | POSTGRESQL | DM | KINGBASE（兼容Oracle） | OSCAR | GBASE | HBM文件 | POJO类型 | 场景 |
|---|---|---|---|---|---|---|---|---|---|---|
| BIGINT | INTEGER | BIGINT | INT8 | BIGINT | INT8 | BIGINT | BIGINT | long | java.lang.Long | 主键 |
| DATE | DATE | DATETIME | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | timestamp | java.util.Date | 日期 |
| DATETIME | DATE | DATETIME | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | TIMESTAMP(0) | timestamp | java.util.Date | 日期时间 |
| DECIMAL | NUMBER | NUMERIC | NUMERIC | NUMBER | NUMERIC | NUMBER | NUMBER | double | java.lang.Double | 小数 |
| INT | INTEGER | INT | INT4 （Oracle转INT8） | INT （Oracle转BIGINT） | INT4 （Oracle转INT8） | INTEGER | INT | integer | java.lang.Integer | 整数 |
| LONGBLOB | BLOB | IMAGE | BYTEA | BLOB | BYTEA | BLOB | BLOB | string | java.lang.String | 二进制对象 |
| LONGTEXT | CLOB | NTEXT | TEXT | CLOB | TEXT | CLOB | CLOB | string | java.lang.String | 大文本 |
| SMALLINT | NUMBER(4) | SMALLINT | INT2 | SMALLINT | INT2 | SMALLINT | SMALLINT | integer | java.lang.Integer | 数字枚举 |
| VARCHAR | VARCHAR2 | NVARCHAR | VARCHAR | VARCHAR | VARCHAR | VARCHAR | VARCHAR | string | java.lang.String | 文本 |
# 信创部署工具使用说明
XinChuang/deploytools是信创部署升级工具，能自动部署协同程序，并且自动向中间件写入配置。
只要使用信创部署工具安装OA，后续OA版本升级，也可以用信创部署工具一键平滑升级。
工具支持图形界面和静默两种方式，两种方式二选一：
- 图形化部署：使用命名含GUI的可执行文件
deployGUI-for-版本号-产品线.sh - 命令行部署：使用命名含cli的可执行文件
deploycli-for-版本号-产品线.sh
不同版本文件名称会有差异，请执行实际版本文件。例如：
- 图形化部署A8N，请使用deployGUI-for-9.1-A8N.sh
- 命令行部署G6N，请使用deploycli-for-9.1-G6N.sh
# 一、东方通7.0.4协同应用部署
# 东方通7.0.4准备
使用东方通前，通过java -version命令检查当前系统是否已经安装openjdk8。如未安装请自行安装或联系系统厂商准备合适的jdk8（小版本号推荐1.8.0_372），并配置JAVA_HOME、PATH、CLASSPATH环境变量：
上传并解压东方通7.0.4安装介质：
# 本例是将东方通7.0.4压缩包放置到/data目录并解压
cd /data
# 解压后一般是/data/TongWeb7.0.4.9_M4_Enterprise_Linux这样的目录
tar -zxvf TongWeb7.0.4.9_M4_Enterprise_Linux.tar.gz
东方通7.0.4从第一次启动开始，就需要授权文件（一般为license.dat），我们需要将授权文件放置到名为TongWeb程序根目录下，参考命令mv license.dat /data/TongWeb7.0.4.9_M4_Enterprise_Linux
# 东方通7.0.4初始化
放置授权文件后，到TongWeb7.0.4程序目录/bin进行启动，请使用后台启动脚本：./startservernohup.sh命令启动（Ctrl+C不会导致东方通程序退出）。
生产环境禁止使用前台启动方式： ./startsever.sh 使用该命令启动时，如果客户端会话断开，会导致东方通进程停止.
cd /data/TongWeb7.0.4.9_M4_Enterprise_Linux/bin
./startserver.sh
浏览器输入http://东方通服务IP:9060/console）访问东方通7.0.4控制台，默认值账号密码thanos/thanos123.com，初次登录按要求修改好密码。能登录到控制台则说明启动正常。
如无法访问控制台，首先确认服务是否启动，然后确认防火墙是否放开了对应端口！
登录后，首页菜单能看到东方通的基本信息，控制台配置-服务器选择文件可选目录需要进行手动设置，本次计划将OA相关程序全部安装在/data目录下，故手动填入/data即可，这样操作后，后续选择驱动jar、部署应用选择OA路径时就可以从/data目录下可视化选择。
# 东方通7.0.4部署OA
准备XinChuang.zip包：
从致远商务公布的安装程序下载地址中，下载对应版本的XinChuang.zip部署包，并解压到系统中：
# 同样将XinChuang.zip解压到/data/目录进行操作
mv 2.V9.1_XinChuang.zip /data/
cd /data
unzip 2.V9.1_XinChuang.zip
信创部署工具部署模式：
OA信创部署工具位于XinChuang/deploytools目录下，支持图形界面部署和命令行静默部署两种方式，如果有图形化界面，建议优先使用图形界面方式。
- 图形化部署：使用命名含GUI的
deployGUI-for-版本号-产品线.sh程序启动 - 命令行部署：使用命名含cli的
deploycli-for-版本号-产品线.sh程序启动
# 方法一东方通7.0.4-图形化安装
本小节适用于带图形化的Linux或信创操作系统。
安装前，首先确定一个OA程序的安装路径，通过mkdir -p /data/Seeyon命令创建目录，以后OA程序就在/data/Seeyon目录下维护。
安装前，还要确保中间件已经处于启动状态，程序会针对程序目录写入配置。
安装前，确认好客户使用什么数据库，如果是当前版本标准产品支持的数据库，则只需要初始化一个空库（即使是老客户转信创也建议先建空库测试启动），信创工具会自动写入SQL数据。
以上准备就绪后，参考如下命令启动图形化部署工具：
# 到XinChuang部署目录deploytools
cd /data/2.V9.1_XinChuang/deploytools
# 先赋予可执行权限（如果是G6则操作G6N结尾的可执行文件）
chmod +x deployGUI-for-V9.1-A8N.sh
# 再启动GUI可执行程序（如果是G6则操作G6N结尾的可执行文件）
./deployGUI-for-V9.1-A8N.sh
图形化参数说明：
安装 / 升级： 由信创工具自动判断安装还是升级，如检测到没有安装就自动安装，检测到已安装则自动升级
CPU： 目前支持 ARM、MIPS、x86 三类，根据当前系统实际情况选择
系统： 只有 CPU 类型为 ARM 时才需要选择，支持选项：统信 uos、麒麟 kylin
中间件： 根据实际情况选择，东方通7.0.4选择TongWeb
协同路径： 必须提前创建固定的协同目录，比如本例设置为 /data/Seeyon ，通过 mkdir -p /data/Seeyon 命令创建目录
中间件路径： 对应东方通程序根目录，如本例安装地址/data/TongWeb7.0.4.9_M4_Enterprise_Linux
协同产品线、在线人数： 根据实际情况选择，不同在线人数，工具会给不同的 JVM 配置
数据库： 下拉列表中能选到的就是标准支持的库，需要提前准备好空库，工具会自动向空库中写入 协同 初始化 SQL；如数据库不在标准支持范围，则下拉列表选择“不初始化数据库”，这类“不初始化数据库”场景，在工具部署完成后，需要手动初始化数据。
标准产品支持：达梦、人大金仓、神通、MySQL、Oracle、SQLServer、Gbase南大通用数据库初始化，Postgresql仅支持升级。
JDBCDriver： 根据选择的数据库自动生成，无需修改
JDBC URL： 需要修改 IP、端口、库名（数据库空库需要提前创建）
数据库用户、密码： 根据实际情况填写
宝兰德密码： 对应宝兰德管理控制台admin的密码，非宝兰德中间件无需配置
宝兰德端口： 对应宝兰德管理控制台的端口，非宝兰德中间件无需配置
以上填写完整后，先进行“验证参数”，通过后再“安装/升级”，部署需要一定时间，请耐心等待。
信创部署工具日志文件位于：XinChuang/deploytools/logs目录下，可通过日志查看。
完成部署后，手工关闭安装程序退出。
注意：部署工具安装完成后，必须重启中间件：
# 通过kill进程（注意如果当前服务器还启动了其它java应用，需要区别，别误杀了）
ps -ef | grep java
kill -9 进程ID
# 启动中间件
cd /data/TongWeb7.0.4.9_M4_Enterprise_Linux/bin
./startservernohup.sh
# 查看日志进度
cd /data/TongWeb7.0.4.9_M4_Enterprise_Linux/logs/
tail -f server.log
# 方法二东方通7.0.4-命令行安装
如操作系统无图形化界面，则使用命令行静默安装。
A8N升级通过修改信创部署目录 XinChuang/deploytools/cfgHome/installConfig.properties文件，配置必要的参数。
不同产品线修改的配置文件不同，G6N修改名为installConfigG6N.properties的配置文件。
# 到 XinChuang 部署目录 deploytools/cfgHome
cd /data/2.V9.1_XinChuang/deploytools/cfgHome/
# 修改 installConfig.properties 文件参数
vim installConfig.properties
installConfig.properties 配置文件中的参数与图形化部署界面一模一样，这里面的参数直接参考图形化部署章节填写。
再次提醒：请不要凭感觉填写配置，认真参考“图形化升级”章节，熟悉每一个配置和注意事项后再操作！
如下是一个示例截图：
第三步：执行命令行部署 sh 脚本：
# 到 XinChuang 部署目录 deploytools
cd /data/2.V9.1_XinChuang/deploytools
# 先赋予可执行权限，再执行 sh 脚本
chmod +x deploycli-for-V9.1-A8N.sh
./deploycli-for-V9.1-A8N.sh
提示“安装成功”即可退出命令模式，进行后续部署配置操作：
信创部署工具日志文件位于：XinChuang/deploytools/logs目录下，如遇到部署异常可通过日志分析问题。
注意：部署工具安装完成后，必须重启中间件：
# 通过kill进程（注意如果当前服务器还启动了其它java应用，需要区别，别误杀了）
ps -ef | grep java
kill -9 进程ID
# 启动中间件
cd /data/TongWeb7.0.4.9_M4_Enterprise_Linux/bin
./startservernohup.sh
# 查看日志进度
cd /data/TongWeb7.0.4.9_M4_Enterprise_Linux/logs/
tail -f server.log
# 东方通7.0.4WEB容器配置
上一步信创部署工具进行产品部署后，必须重启一次中间件，否则配置无法生效：
cd /data/TongWeb7.0.4.9_M4_Enterprise_Linux/bin
# 先停
./stopserver.sh
# 后启
./startservernohup.sh
重启东方通中间件后，管理员账号thanos登录东方通控制台（http://东方通服务IP:9060/console）：
WEB容器配置-容器配置：
东方通7.0.4系列版本需要设置默认应答容器的字符集为UTF-8，设置默认请求参数解码字符集修改为ISO-8859-1，并重启东方通服务。重启后检查容器配置中字符集是否已调整，若未调整可修改东方通的配置文件tongweb.xml。
WEB容器配置-HTTP通道管理：
找到WEB容器配置>HTTP通道管理>tong-http-listener：
1、调整io模式为nio
2、线程池属性调整初始线程数为100，调整最大线程数为4096
3、其它设置-uri处理：不要勾选
WEB容器配置-虚拟主机管理：
WEB容器配置菜单找到虚拟主机管理下的server：在最底部属性列表检查是否存在cacheMaxSize属性，值为1000000，不存在或值过低就按需调整。
# 东方通7.0.4启动参数（JVM配置）调整
继续通过东方通管理控制台，访问“启动参数配置”菜单，进行JVM相关配置检查和调整：
JVM参数（配置内存和垃圾回收方法）：
- 垃圾回收方法：必须选择
G1GC - 最大/最小堆内存：配置（最大和最小的数字都保持一致避免JVM波动），信创部署工具会根据设置的在线人数自动写入推荐值，如需调整直接在此修改即可。
一般行业通用标准，堆内存取服务器的50%-70%总内存，如果在线人数不高，也不必申请过高内存
| 在线人数 | 部署方式 | 信创协同服务器配置参考 | 堆内存配置推荐 |
|---|---|---|---|
| 200以下 | 单机 | CPU12核以上/内存24G以上/硬盘320G以上 | 12G |
| 200~500 | 单机 | CPU12核以上/内存32G以上/硬盘320G以上 | 16G |
| 500~1000 | 单机 | CPU24核以上/内存48G以上/硬盘320G以上 | 24G |
| 1000~2000 | 1主1从 | CPU24核以上/内存64G以上/硬盘320G以上 | 32G |
| 2000~3000 | 1主2从 | CPU32核以上/内存64G以上/硬盘320G以上 | 32G |
| 3000~5000 | 1主2从 | CPU32核以上/内存96G以上/硬盘320G以上 | 48G |
JVM参数（检查external.vmoptions）
直接访问东方通程序目录/bin/external.vmoptions文件，确保包含如下JVM配置，其中-Xmx和-Xms对应堆内存（根据实际情况调整），-Xloggc路径指向协同OA程序的目录，尽量确保-XX:+UnlockExperimentalVMOptions配置在-XX:+UseG1GC之前：
-Xmx16G
-Xms16G
-XX:+UnlockExperimentalVMOptions
-XX:+UseG1GC
-Xloggc:/data/Seeyon/V5/ApacheJetspeed/logs/gc.log
-XX:+PrintGCDateStamps
-XX:+PrintGCTimeStamps
-XX:+PrintGCDetails
-XX:+UseGCLogFileRotation
-XX:NumberOfGCLogFiles=8
-XX:GCLogFileSize=10m
-XX:ReservedCodeCacheSize=1G
-XX:MaxMetaspaceSize=2G
-XX:MetaspaceSize=2G
-Djava.awt.headless=true
-Dibm.stream.nio=true
-Djava.net.preferIPv4Stack=true
-Dsun.zip.disableMemoryMapping=true
JVM参数（可视化检查）
除了通过命令行的形式检查JVM参数外，也可以通过东方通控制台-启动参数配置可视化检查所有JVM参数（参数分布于“jvm参数”、“其他jvm参数”和“服务器参数”），没有就添加：
# 东方通7.0.4HTTP通道管理配置
登录控制台，在"WEB容器配置"-"HTTP通道管理"，将http通道的各个listener进行配置检查和调整：
- "压缩属性"设置为"不使用"压缩
- “其他设置”的“POST请求最大字节数”设置为-1
如果使用信创部署工具部署，这些操作都会默认设置，无需人工操作。
# 东方通7.0.4协同OA打补丁（可选）
此步骤主要面对非标准支持数据库的项目化适配场景，务必提前打好适配代码，再进行数据库连接配置及启动。
注意补丁包打包位置：大部分jar放置于OA程序的seeyon/WEB-INF/lib下，还有少量jar放置在东方通中间件lib下，项目上要根据情况核对清楚并确保打包正确。
# 东方通7.0.4检查数据库驱动jar
访问中间件lib目录，检查数据库驱动已经正确放置，数据库驱动jar放置于中间件lib目录下：
cd /data/TongWeb7.0.4.9_M4_Enterprise_Linux/lib
如果lib目录下项目连接的数据库放置了多个版本的驱动jar，会导致程序无法使用合适的驱动，从而建立数据库连接失败。需要确保lib目录只能有一个与数据库相匹配的驱动jar。
如达梦V8数据库，仅保留DmJdbcDriver8.jar（2024第3季度修改），其余以DmJdbcDriver开头的驱动jar全部剪切到别处：
如金仓数据库，V8R3版本确保仅保留kingbase8-8.2.0.jar、V8R6版本仅保留kingbase8-8.6.0.jar：
# 东方通7.0.4JNDI数据源
全新安装场景不再使用中间件自带的JDBC数据库连接池，而是改用JNDI资源，JNDI资源使用协同自主设计的数据库连接池。
协同自主数据库连接池性能优越、支持连接保活、连接可用性检测、连接监控、慢查询日志
1、访问JNDI下的JNDI资源菜单，如列表存在名称为jdbc/ctpDataSource的JNDI资源配置，则说明本次通过JNDI走协同自主连接池：
- JNDI资源名称：
jdbc/ctpDataSource - JNDI资源类型：
javax.sql.DataSource - JNDI工厂类：
com.seeyon.v3x.dbpool.datasource.DataSourceConProviderFactory - JNDI资源默认勾选“启用”
2、协同自主数据库连接池配置存放于协同程序base/conf/datasourceCtp.properties文件里，通过中间件JVM-DA8.datasource.properies.filepath参数可以看到详细路径：
# 东方通7.0.4 部署启动应用
接下来就是准备部署应用启动，部署启动前，先在OA程序/base/license目录放置-N加密授权（本手册部署位置位于/data/Seeyon/V5/base/license/）。
注册加密授权见《新加密授权注册更新手册》。
OA目录放置授权完成后，开始部署启动应用，登录东方通控制台，在"应用管理"中，点击[部署应用]，进行协同应用额部署，如下图示：
我们需要依次部署ROOT、seeyon、static、sportal这几个应用，参考如下方式操作：
1、部署ROOT： 部署ROOT时，部署应用选择“服务器”，地址指向OA程序目录webapps/ROOT：
ROOT的应用前缀设置为/（不是/ROOT），部署这个路径之后，浏览器通过IP端口就能自动跳转到/seeyon的OA登录页
部署超时统一修改为最大的3600，后续其它几个应用均采用这个超时配置：
虚拟主机统一选择下拉列表中的server：
部署seeyon： ROOT部署后，后其它应用部署都是类似的，部署路径先选择协同OA程序webapps下的同名目录：
后续几个应用的应用前缀保持默认，应用名称是什么，前缀就是什么，只需要统一修改部署超时时间为3600即可，配置如下图所示：
首次部署seeyon需要等待几分钟左右，因为部署的时候就等于在执行seeyon的启动，需要等待服务启动完成。
启动日志检查： 首次部署seeyon应用时，务必通过东方通的日志来观察部署进度：
cd /data/TongWeb7.0.4.9_M4_Enterprise_Linux/logs/
# 到东方通logs日志目录下，查看日志进度
tail -f server.log
如果配置存在错误，还会导致部署失败，东方通进程退出，我们需要结合上面东方通的server.log日志和OA启动日志分析原因：
协同OA的日志存放于OA程序ApacheJetspeed/logs_sy目录下，启动日志通过ctp.log和error.log等日志结合分析：
如果遇到部署失败导致东方通控制台都无法访问，此时可能是OA异常导致中间件进程退出，我们需要先根据日志排查分析解决问题后再重新东方通服务，重新部署seeyon。直至seeyon启动成功，并且东方通下seeyon保存成功为止。
如果遇到了启动报错等问题，无从下手，可以调到下面“常见部署问题”部分，对照检查是否有解决方案。
再往后，static、sportal应用目录就参照seeyon配置一遍即可：
| 部署顺序 | OA安装程序路径（示例） | 应用前缀 | 应用程序名称 | 部署超时 | 选择虚拟主机 |
|---|---|---|---|---|---|
| 1 | /data/Seeyon/V5/ApacheJetspeed/webapps/ROOT | / | ROOT | 3600 | server |
| 2 | /data/Seeyon/V5/ApacheJetspeed/webapps/seeyon | /seeyon | seeyon | 3600 | server |
| 3 | /data/Seeyon/V5/ApacheJetspeed/webapps/static | /static | static | 3600 | server |
| 4 | /data/Seeyon/V5/ApacheJetspeed/webapps/sportal | /sportal | sportal | 3600 | server |
以上应用都出现在应用管理列表时，就表示部署基本成功：
如果OA处于启动状态，我们可以通过应用管理列表ROOT或seeyon的“http访问”链接打开协同OA登录页：
协同OA登录页，东方通给应用的默认端口是8088，我们可以记住这个地址，后续通过URL地址访问。
新客户可以使用账户密码init-admin/123456登录系统初始化基础数据，老客户使用原账号密码登录即可。
常见部署问题：
1、首次部署/seeyon点击“下一步”卡住：这个是正常现象，正在启动OA，如果卡住超过10分钟则不是正常现象，要看日志排查！
2、首次部署/seeyon时，东方通控制台页面突然无法访问：原因是部署启动/seeyon报错了，需要到中间件logs/server.log和OA程序ApacheJetspeed/logs_sy目录下根据日志分析排除故障，然后kill东方通进程，重新启动东方通再重新部署/seeyon。
3、首次部署/seeyon时，超过10分钟无反应：参考问题2，排查日志。并且关注中间件日志和OA日志是否在暴增，注意及时停止服务，清理异常的日志，防止磁盘空间占满。
4、如果东方通7.0.4.9_M3及更高版本遇到OA启动报错问题，需要设置server jsf="true"，可参考这个在线解决方案尝试处理 https://open.seeyoncloud.com/#/faq/faq/v1/share?url=Z2JySmU+MjQ6OA==
5、PC可以预览，但移动端不行，移动端M3查看正文预览显示net::ERR_BLOCKED_BY_RESPONSE，需要删除东方通jvm配置-Dtongweb.X_Frame_Options=SAMEORIGIN，解决方案参考在线文档 https://open.seeyoncloud.com/#/faq/faq/v1/share?url=Z2JySmU+MzEy
6、信创部署启动提示Name "jdbc/ctpDataSource" not found，解决方案参考在线文档 https://open.seeyoncloud.com/#/faq/faq/v1/share?url=Z2JySmU+NDMyNQ==
# 东方通7.0.4日常运维
# 东方通7.0.4修改数据库配置
如需调整数据库连接URL、帐号、密码、最大最小连接数，都需在协同程序base/conf/datasourceCtp.propertie文件中调整：
- ctpDataSource.url：数据库连接URL
- ctpDataSource.driverClassName：数据库驱动类名
- ctpDataSource.username：数据库连接账号
- ctpDataSource.password：数据库连接密码，数据库密码可以明文，如需密文存放，可在其它环境使用SeeyonConfig应用配置器保存数据库密码，将加密后的密码串替换到当前环境中
- ctpDataSource.minCount：初始化连接数
- ctpDataSource.maxCount：允许最大连接数
调整datasourceCtp.properties配置后不仅需要重启协同OA，还需要重启中间件才能保证配置生效。以下为电科金仓数据库连接池的配置示例：
# 东方通7.0.4启停中间件和启停OA
可视化启停： （如果东方通处于启动状态）可以通过中间件控制台进行启动和停止（主要是启停/seeyon应用）：
命令启动中间件： 如果可视化启动不行，可以到东方通/bin目录下执行./startservernohup.sh，启动中间件的同时OA也自动启动了：
# 启动中间件，并自启动协同
cd /data/TongWeb7.0.4.9_M4_Enterprise_Linux/bin
./startservernohup.sh
# 查看日志进度
cd /data/TongWeb7.0.4.9_M4_Enterprise_Linux/logs/
tail -f server.log
命令停止中间件： 如果可视化停止不行，可通过kill与东方通相关的java进程停止东方通：
# 通过kill进程（注意如果当前服务器还启动了其它java应用，需要区别，别误杀了）
ps -ef | grep java
kill -9 进程ID
# 东方通7.0.4访问中间件管理控制台
浏览器输入http://东方通服务IP:9060/console）访问东方通7.0.4控制台，默认账号名为thanos，密码都会重新修改，请务必记录好密码。
如无法访问控制台，首先确认服务是否启动，然后确认防火墙是否放开了对应端口！
# 东方通7.0.4 OA集群部署
中间件下部署协同集群，需要先参考本手册部署第一套环境，确保单机运行正常，再参考 《致远协同管理软件集群部署手册》 (opens new window) (opens new window)进行集群配置。
# 东方通7.0.4 配置协同HTTPS
默认协同通过http协议访问，如客户需要https访问协同，则需要单独部署配置：
- 首先，中间件不做任何调整，保持默认http
- 然后，部署Nginx，由Nginx管理https，通过Nginx+SSL反向代理到协同http
- 最终，系统运行模式为：客户端===>Nginx（https）===>协同（http）
Nginx 部署、参数配置及 SSL 配置可参考《Nginx部署配置手册 (opens new window) (opens new window)》。
# 东方通7.0.4 协同程序升级
如果早期使用信创部署工具安装部署的协同，后期协同存在升级需求，则参考信创升级手册操作即可。
# 二、金蝶V9协同应用部署
# 金蝶V9产品准备
金蝶V9 SP9版本（AAS-V9.0-SP9）调整太大，实测部署后无法启动，请选择金蝶 SP8版本部署（AAS-V9.0-SP8）。
上传并解压金蝶V9安装介质，本例统一放置程序到/data目录：
cd /data
unzip AAS-V9.0-SP8.zip -d AASV9.0/
金蝶V9授权文件： 金蝶使用需要授权文件（一般为license.xml），需将授权文件放置在AAS9.0目录下：
# 金蝶V9创建域
使用信创部署工具安装前，需要先将域创建好 ，后续信创部署时工具会自动向域写入配置。
# 访问AASV9.0下的bin目录，通过config可执行程序创建域
cd /data/AASV9.0/bin/
./config
按文字提示初始化金蝶V9域：
- 输入1，创建一个新的Apusic域
- 输入1，选择系统默认模板
- 输入1，选择标准标准模板，即使协同集群也选标准模板，协同集群与金蝶集群无关
- 域安装目录保持默认，记住这个路径，后续有用
- 自定义一个新的域名称，如seeyon
- 监听端口全部保持默认
- 是否希望配置一些高级选项？输入N
初始化域日志如下：
-----------------------------------------------------------
| 欢迎进入Apusic域配置向导 |
| 版本 :Apusic Application Server 9.0 |
| |
| 深圳市金蝶中间件有限公司 |
| 版权所有 |
-----------------------------------------------------------
选择任务 ...
------------
您希望执行下面的哪一个任务?
1- 创建一个新的Apusic域
2- 删除一个现有的Apusic域
3- 构建一个新的Apusic域模板
请选择相应的数字: 1
欢迎进入域创建向导中心
----------------------
该向导将会帮助您创建一个全新的Apusic域，同时也会在您的计算机上创建一些相关文件和需要的目录.
按<ENTER>键继续:
选择域来源 ...
--------------
选择将要创建的域的来源.您能够指定一个域模板来创建域,也可以不使用域模板创建域.
->1- 选择系统默认模板
2- 选择自定义模板
请选择相应的数字,或按<ENTER>键接受默认选择:1
选择系统默认模板 ...
--------------------
标准模板与集群模板的区别是: 基于集群模板创建的domain拥有集群服务。
->1- 标准
2- 集群
请选择相应的数字,或按<ENTER>键接受默认选择:1
域配置 ...
----------
您想在哪一位置安装该域?
默认位置 = /data/AASV9.0/domains
请输入一个绝对路径,或按<ENTER>键接受默认位置
安装路径:
请为该域输入一个有效的名称,域名称是该域的有效标识.
已存在的域名称：
1- mydomain
2- samples
域名称: seeyon
服务器配置 ...
--------------
设置服务器监听端口
默认端口 = 6888
请输入您的服务器监听端口,按<ENTER>键接受默认选择
监听端口 :
设置服务器SSL安全监听端口
默认端口 = 6889
请输入您的服务器SSL安全监听端口,按<ENTER>键接受默认选择
SSL监听端口 :
高级选项配置 ...
----------------
这里将会帮助您继续进行数据源配置，J2EE应用程序配置.
默认选择 = 否
请选择,或按<ENTER>键接受默认选择
是否希望配置一些高级选项? (Y|N): N
请稍后...
---------
.......
您所选择的任务成功执行完毕.
初始化域完成后，访问域的根目录（/data/AASV9.0/domains）检查新建的域文件是否创建成功：
# 金蝶V9域首次启动
前一章节创建了名为seeyon的domain域，本次在seeyon域下启动并访问金蝶管理控制台。
1、金蝶V9 2025版本，需要先删除seeyon域下store/users.db文件，否则初次启动无法初始化密码：
cd /data/AASV9.0/domains/seeyon/store/
rm -i ./users.db
rm：是否删除普通文件 './users.db'？yes
2、金蝶V9 2025版本，需要修改seeyon域下的config/vm.opetions文件，增加允许所有客户端访问金蝶中间件的配置 com.apusic.webtool.allowHosts=*
后续如需安全管控，可调整客户端允许访问地址
cd /data/AASV9.0/domains/seeyon/config/
vim vm.options
vm.options最后追加允许远程访问的配置com.apusic.webtool.allowHosts=*
3、访问seeyon域下的bin目录，通过startapusic启动金蝶V9，首次启动会提示初始化密码（如设置成Admin123），记住设置的密码，后续管理控制台需要使用：
注：./startapusic命令是在前台执行，通过Ctrl+C快捷键会导致服务直接退出。后续启动建议采用
nohup ./startapusic &后台启动命令。
cd /data/AASV9.0/domains/seeyon/bin/
# 仅首次登录用这个命令
./startapusic
# 金蝶V9访问管理控制台
金蝶域启动后，通过浏览器访问http://金蝶V9服务器IP:6888/admin登录管理控制台
管理控制台地址示例：http://192.168.188.142:6888/admin
管理员登录名：admin
管理员密码示例：Admin1234 【首次启动服务时录入的密码】
管理控制台首页，能看到具体Domain位置，记住这个地址，后续安装部署需要：
# 金蝶V9信创工具部署
准备XinChuang.zip包：
从致远商务公布的安装程序下载地址中，下载对应版本的XinChuang.zip部署包，并解压到系统中：
# 同样将XinChuang.zip解压到/data/目录进行操作
mv 2.V9.1_XinChuang.zip /data/
cd /data
unzip 2.V9.1_XinChuang.zip
信创部署工具部署模式：
OA信创部署工具位于XinChuang/deploytools目录下，支持图形界面部署和命令行静默部署两种方式，如果有图形化界面，建议优先使用图形界面方式。
图形化部署：使用命名含GUI的
deployGUI-for-版本号-产品线.sh程序启动命令行部署：使用命名含cli的
deploycli-for-版本号-产品线.sh程序启动
# 方法一金蝶V9-图形化安装
本小节适用于带图形化的Linux或信创操作系统。
安装前，首先确定一个OA程序的安装路径，通过mkdir -p /data/Seeyon命令创建目录，以后OA程序就在/data/Seeyon目录下维护。
安装前，还要确保中间件已经处于启动状态，程序会针对程序目录写入配置。
安装前，确认好客户使用什么数据库，如果是当前版本标准产品支持的数据库，则只需要初始化一个空库（即使是老客户转信创也建议先建空库测试启动），信创工具会自动写入SQL数据。
以上准备就绪后，参考如下命令启动图形化部署工具：
# 到XinChuang部署目录deploytools
cd /data/2.V9.1_XinChuang/deploytools
# 先赋予可执行权限（如果是G6则操作G6N结尾的可执行文件）
chmod +x deployGUI-for-V9.1-A8N.sh
# 再启动GUI可执行程序（如果是G6则操作G6N结尾的可执行文件）
./deployGUI-for-V9.1-A8N.sh
图形化参数说明：
安装 / 升级： 由信创工具自动判断安装还是升级，如检测到没有安装就自动安装，检测到已安装则自动升级
CPU： 目前支持 ARM、MIPS、x86 三类，根据当前系统实际情况选择
系统： 只有 CPU 类型为 ARM 时才需要选择，支持选项：统信 uos、麒麟 kylin
中间件： 根据实际情况选择，金蝶V9选择ApusicV9
协同路径： 必须提前创建固定的协同目录，比如本例设置为 /data/Seeyon ，通过 mkdir -p /data/Seeyon 命令创建目录
中间件路径： 对应金蝶V9 Domain域目录，如本例安装地址/data/AASV9.0/domains/seeyon
协同产品线、在线人数： 根据实际情况选择，不同在线人数，工具会给不同的 JVM 配置
数据库： 下拉列表中能选到的就是标准支持的库，需要提前准备好空库，工具会自动向空库中写入 协同 初始化 SQL；如数据库不在标准支持范围，则下拉列表选择“不初始化数据库”，这类“不初始化数据库”场景，在工具部署完成后，需要手动初始化数据。
标准产品支持：达梦、人大金仓、神通、MySQL、Oracle、SQLServer、Gbase南大通用数据库初始化，Postgresql仅支持升级。
JDBCDriver： 根据选择的数据库自动生成，无需修改
JDBC URL： 需要修改 IP、端口、库名（数据库空库需要提前创建）
数据库用户、密码： 根据实际情况填写
宝兰德密码： 对应宝兰德管理控制台admin的密码，非宝兰德中间件无需配置
宝兰德端口： 对应宝兰德管理控制台的端口，非宝兰德中间件无需配置
以上填写完整后，先进行“验证参数”，通过后再“安装/升级”，部署需要一定时间，请耐心等待。
信创部署工具日志文件位于：XinChuang/deploytools/logs目录下，可通过日志查看。
完成部署后，手工关闭安装程序退出。
注意：部署工具安装完成后，必须重启中间件：
# 停止金蝶V9服务
ps -ef | grep java
kill -9 java进程ID
# 后台启动金蝶V9服务
cd /data/AASV9.0/domains/seeyon/bin
nohup ./startapusic &
# 查看启动日志
tail -f nohup.out
# 方法二金蝶V9-命令行安装
如操作系统无图形化界面，则使用命令行静默安装。
A8N升级通过修改信创部署目录 XinChuang/deploytools/cfgHome/installConfig.properties文件，配置必要的参数。
不同产品线修改的配置文件不同，G6N修改名为installConfigG6N.properties的配置文件。
# 到 XinChuang 部署目录 deploytools/cfgHome
cd /data/2.V9.1_XinChuang/deploytools/cfgHome/
# 修改 installConfig.properties 文件参数
vim installConfig.properties
installConfig.properties 配置文件中的参数与图形化部署界面一模一样，这里面的参数直接参考图形化部署章节填写。
再次提醒：请不要凭感觉填写配置，认真参考“图形化升级”章节，熟悉每一个配置和注意事项后再操作！
如下是一个示例截图：
第三步：执行命令行部署 sh 脚本：
# 到 XinChuang 部署目录 deploytools
cd /data/2.V9.1_XinChuang/deploytools
# 先赋予可执行权限，再执行 sh 脚本
chmod +x deploycli-for-V9.1-A8N.sh
./deploycli-for-V9.1-A8N.sh
提示“安装成功”即可退出命令模式，进行后续部署配置操作：
信创部署工具日志文件位于：XinChuang/deploytools/logs目录下，如遇到部署异常可通过日志分析问题。
注意：部署工具安装完成后，必须重启中间件：
# 停止金蝶V9服务
ps -ef | grep java
kill -9 java进程ID
# 后台启动金蝶V9服务
cd /data/AASV9.0/domains/seeyon/bin
nohup ./startapusic &
# 查看启动日志
tail -f nohup.out
# 金蝶V9 JVM配置检查
通过信创工具部署产品后，JVM配置会自动生成，如有参数修改可参考本章节操作。
**方法一：JVM可视化修改： ** 访问管理控制台-系统参数进行JVM检查和调优：
1、启动最小堆内存(MB)和启动最大堆内存(MB)，单位MB（1G=1024MB），根据当前服务器和在线人数推荐配置：
| 在线人数 | 部署方式 | 信创协同服务器配置参考 | 堆内存配置推荐 |
|---|---|---|---|
| 200以下 | 单机 | CPU12核以上/内存24G以上/硬盘320G以上 | 12288M |
| 200~500 | 单机 | CPU12核以上/内存32G以上/硬盘320G以上 | 16384M |
| 500~1000 | 单机 | CPU24核以上/内存48G以上/硬盘320G以上 | 24576M |
| 1000~2000 | 1主1从 | CPU24核以上/内存64G以上/硬盘320G以上 | 32768M |
| 2000~3000 | 1主2从 | CPU32核以上/内存64G以上/硬盘320G以上 | 32768M |
| 3000~5000 | 1主2从 | CPU32核以上/内存96G以上/硬盘320G以上 | 49152M |
2、永久代内存(MB)，设置为2408，单位MB（1G=1024MB）
3、垃圾回收方法，不选择，金蝶V9无法选择产品所需的G1GC垃圾回收器
4、其它配置，产品所需配置均在其中，信创部署工具部署后会自动写入，也可自定义调整
配置修改后，重启一次中间件。
方法二：JVM后台修改： 到产品所用的domain域bin目录下，修改启动文件startapusic的配置：
cd /data/AASV9.0/domains/seeyon/bin/
# 修改启动程序的JVM配置
vim startapusic
1、MEMORY_JVMOPTS设置堆内存和永久代内存，后台修改比较灵活，可用G或MB做单位，规则与可视化方案一致：
- G做单位示例：
-Xms16G -Xmx16G -XX:MaxPermSize=2G - MB做单位示例：
-Xms16384m -Xmx16384m -XX:MaxPermSize=2046m
2、OTHERS_JVMOPTS 和 GC_JVMOPTS配置产品所需参数，规则与可视化方案一致，示例如下：
OTHERS_JVMOPTS="-server -Djava.net.preferIPv4Stack=true -Djava.awt.headless=true -XX:MaxMetaspaceSize=2G -XX:ReservedCodeCacheSize=1G -Djdbcproxydriver.driverclass=com.kingbase8.Driver -Dsun.zip.disableMemoryMapping=true -Djava.security.egd=file:/dev/./urandom -Djava.awt.headless=true"
GC_JVMOPTS="-Xloggc:/data/Seeyon/V5/ApacheJetspeed/logs/gc.log -XX:+PrintGCTimeStamps -XX:+PrintGCDateStamps -XX:+PrintGCDetails -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=8 -XX:GCLogFileSize=10m -XX:+HeapDumpOnOutOfMemoryError -XX:+UseG1GC -XX:HeapDumpPath=$DOMAIN_HOME/logs/heap.dump -DA8.datasource.properies.filepath=/data/Seeyon/V5/base/conf/datasourceCtp.properties"
如通过后台修改，请在金蝶技术指导下操作，配置示例如下：
配置修改后，重启一次中间件。
# 金蝶V9 JNDI数据源检查
全新安装场景不再使用中间件自带的JDBC数据库连接池，而是改用JNDI资源，JNDI资源使用协同自主设计的数据库连接池。
协同自主数据库连接池性能优越、支持连接保活、连接可用性检测、连接监控、慢查询日志
1、中间件管理控制台--JNDI资源，如列表存在名称为jdbc/ctpDataSource的JNDI资源配置，则说明本次通过JNDI走协同自主连接池：
- JNDI资源名称：
jdbc/ctpDataSource - JNDI资源类型：
javax.sql.DataSource - JNDI工厂类：
com.seeyon.v3x.dbpool.datasource.DataSourceConProviderFactory - 是否单例：是
2、协同自主数据库连接池文件存放于协同base/conf/datasourceCtp.properties文件里，通过JVM配置-DA8.datasource.properies.filepath路径。
在中间件中存放JNDI资源配置位于域下的jndi_resource.xml文件：domains/seeyon/config/jndi_resource.xml：
<?xml version="1.0" encoding="UTF-8"?>
<resources>
<resource jndi-name="jdbc/ctpDataSource" resource-type="javax.sql.DataSource" factory="com.seeyon.v3x.dbpool.datasource.DataSourceConProviderFactory"/>
</resources>
3、检查数据库驱动jar，如使用信创数据库需要做一次驱动jar的检查（尤其是电科金仓），不同数据库使用的驱动jar不同，相同数据库不同小版本使用的驱动jar也不同。
驱动jar位于金蝶V9 domain域目录 /lib 下，如数据库版本与驱动jar不匹配需要及时更换（删除不匹配的驱动jar，放置匹配的驱动jar），以电科金仓为例：
- 程序默认内置kingbase8-8.6.0.jar驱动jar，适配电科金仓V8R6版本
- 如项目使用V8R3需要删除kingbase8-8.6.0.jar，更换为kingbase8-8.3.0.jar（具体联系金仓获得驱动jar）
- 如项目使用金仓V9版本，则需要删除kingbase8-8.6.0.jar，更换为更高版本的驱动jar（具体联系金仓获得驱动jar）
- lib下不要存在多个驱动jar，如kingbase8-8.6.0.jar和kingbase8-8.3.0.jar共存会出现偶尔不能用的问题
# 金蝶V9 其它配置检查
1、检查域web.xml： 编辑域目录下config/web.xml（如/data/AASV9.0/domains/seeyon/config/web.xml），确保如下内容配置生效：
<mime-mapping>
<extension>cab</extension>
<mime-type>application/vnd.ms-cab-compressed</mime-type>
</mime-mapping>
<context-param>
<param-name>request.charsetencoding</param-name>
<param-value>UTF-8</param-value>
</context-param>
2、检查域vm.options： 编辑域目录下config/vm.options（如/data/AASV9.0/domains/seeyon/config/vm.options），确保如下内容配置生效：
apusic.http.disabledMethods=DELETE,PUT,TRACE,OPTIONS
com.apusic.elite.fnLength=50
配置修改后，重启一次中间件。
# 金蝶V9部署启动应用
# 金蝶V9放置license
部署启动seeyon应用前，将产品授权license注册后（注册使用标准产品安装包中的updateDog），放置在协同安装目录V5/base/license下。
注册加密授权见《新加密授权注册更新手册》。
# 金蝶V9部署应用
金蝶管理控制台，访问“应用管理”菜单。
1、先卸载applications/default默认的应用：
2、部署ROOT： 选择“部署应用”按钮，按如下要求配置：
- 应用名称：root（也可以ROOT）
- 部署方式：服务器应用
- 服务器目录：浏览选择协同程序目录下的ROOT，参考本手册部署后路径为/data/Seeyon/V5/ApacheJetspeed/webapps/ROOT
- 应用基础上下文：
/ - 其余配置保持默认，随后保存
3、依次部署seeyon、static、sportal： root部署之后，参考如下表格顺序，再依次部署seeyon、static、sportal。
- 应用名称：对应表格“应用程序名称”
- 部署方式：服务器应用
- 服务器目录：对应表格“OA安装程序路径”
- 应用基础上下文：对应表格“上下文路径”
部署过程可能异常，尤其是部署seeyon应用，所以在部署时，需要随时检查部署日志：
# 1、若金蝶采用nohup ./startapusic &启动，则中间件日志位于域下面的bin目录
cd /data/AASV9.0/domains/seeyon/bin/
tail -f nohup.out
# 2、协同OA的日志位于协同程序目录V5/ApacheJetspeed/log_sy下
cd /data/Seeyon/V5/ApacheJetspeed/logs_sy
tail -f ctp.log
tail -f error.log
| 部署顺序 | OA安装程序路径（示例） | 上下文路径 | 应用程序名称 |
|---|---|---|---|
| 1 | /data/Seeyon/V5/ApacheJetspeed/webapps/ROOT | / | ROOT |
| 2 | /data/Seeyon/V5/ApacheJetspeed/webapps/seeyon | /seeyon | seeyon |
| 3 | /data/Seeyon/V5/ApacheJetspeed/webapps/static | /static | static |
| 4 | /data/Seeyon/V5/ApacheJetspeed/webapps/sportal | /sportal | sportal |
最终部署效果：
注：金蝶V9 SP9版本（AAS-V9.0-SP9）调整太大，实测部署后无法启动，请选择金蝶 SP8版本部署（AAS-V9.0-SP8）。
金蝶V9 SP9部署seeyon时会遇到如下异常，请更换SP8版本部署：
[apusic.web.seeyon./seeyon-HTTPHandler-45-95] No Spring WebApplicationInitializer types detected on classpath
2025-06-29 16:02:47 错误 [apusic.application.seeyon-HTTPHandler-45-95] 启动失败
java.lang.Exception: java.lang.NoClassDefFoundError: com/fasterxml/jackson/core/type/TypeReference
at com.apusic.deploy.runtime.J2EEApplication.startService(J2EEApplication.java:1133)
at com.apusic.service.Service.start(Service.java:205)
at com.apusic.deploy.runtime.J2EEDeployer.deploy(J2EEDeployer.java:512)
at com.apusic.deploy.runtime.J2EEDeployer.deploy(J2EEDeployer.java:403)
# 金蝶V9登录协同系统
所有协同应用部署并启动成功后，登录协同系统：通过浏览器访问 http://协同服务器IP:6888/seeyon （访问端口即中间件管理控制台端口），如果显示登录页面则部署成功，通过内置的 init-admin 帐号登录系统，进行组织、帐号权限配置：
协同服务地址：http://协同服务器IP:6888/seeyon
首次登录帐号：init-admin
首次登录密码：123456
通过中间件管理控制台-应用管理-通过root或seeyon应用“查看应用模块”也可以访问协同系统首页：
# 金蝶V9部署常见问题
# 1. 配置OA集群时报错，单机正常启动
单机没问题是因为单机根本就不需要运行初始化redis得代码
看起来是jsf初始化扫描配置一些类，结果扫到OA得maincontroller了
OA没有使用jsf，因此可以去掉这个类（修改前注意备份），再重启中间件尝试，启动正常
关联支持单：JSFW-2025-00291
# 金蝶V9日常运维
# 金蝶V9修改数据库配置
如需调整数据库连接URL、帐号、密码、最大最小连接数，都需在协同程序base/conf/datasourceCtp.propertie文件中调整：
- ctpDataSource.url：数据库连接URL
- ctpDataSource.driverClassName：数据库驱动类名
- ctpDataSource.username：数据库连接账号
- ctpDataSource.password：数据库连接密码，数据库密码可以明文，如需密文存放，可在其它环境使用SeeyonConfig应用配置器保存数据库密码，将加密后的密码串替换到当前环境中
- ctpDataSource.minCount：初始化连接数
- ctpDataSource.maxCount：允许最大连接数
调整datasourceCtp.properties配置后不仅需要重启协同OA，还需要重启中间件才能保证配置生效。以下为电科金仓数据库连接池的配置示例：
# 金蝶V9启停协同OA
停止和启动命令如下：
# 停止金蝶V9服务
ps -ef | grep java
kill -9 java进程ID
# 后台启动金蝶V9服务
cd /data/AASV9.0/domains/seeyon/bin
nohup ./startapusic &
# 查看启动日志
tail -f nohup.out
注意：日常观察nohup.out日志的大小，如果日志过大，需要定期清除，避免占用过多磁盘空间。
# 金蝶V9 OA集群部署
中间件下部署协同集群，需要先参考本手册部署第一套环境，确保单机运行正常，再参考 《致远协同管理软件集群部署手册》 (opens new window)进行集群配置。
# 金蝶V9 配置协同HTTPS
默认协同通过http协议访问，如客户需要https访问协同，则需要单独部署配置：
- 首先，中间件不做任何调整，保持默认http
- 然后，部署Nginx，由Nginx管理https，通过Nginx+SSL反向代理到协同http
- 最终，系统运行模式为：客户端===>Nginx（https）===>协同（http）
Nginx 部署、参数配置及 SSL 配置可参考《Nginx部署配置手册 (opens new window)》。
# 金蝶V9 协同程序升级
如果早期使用信创部署工具安装部署的协同，后期协同存在升级需求，则参考信创升级手册操作即可。
# 三、金蝶V10协同应用部署
# 金蝶V10准备
使用金蝶V10前，通过java -version命令检查当前系统是否已经安装openjdk8。如未安装请自行安装或联系系统厂商准备合适的jdk8（小版本号推荐1.8.0_372），并配置JAVA_HOME、PATH、CLASSPATH环境变量：
上传并解压金蝶V10安装介质：
# 本例是将金蝶V10压缩包放置到/data目录
cd /data
unzip AAS-V10.zip -d AASV10
金蝶V10从第一次启动开始，就需要授权文件（一般为license.xml），我们需要将授权文件放置到名为aas目录的下一层，参考命令mv license.xml /data/AASV10/ApusicAS/aas
# 金蝶V10初始化
放置授权文件后，到ApusicAS/bin目录进行第一次启动，初次启动会让你设置三员密码，并自动创建一个名为mydomain的域，控制台会输出Admin Port，记住这个端口号，后面登录用：
cd /data/AASV10/ApusicAS/bin/
./asadmin start-domain
浏览器输入http://金蝶服务器IP:端口（默认6848）访问金蝶V10控制台，主要管理员是admin，使用初始化金蝶时自定义的密码登录。记住这个地址，后续很多操作都是围绕这个地址进行。
# 金蝶V10部署OA
准备XinChuang.zip包：
从致远商务公布的安装程序下载地址中，下载对应版本的XinChuang.zip部署包，并解压到系统中：
# 同样将XinChuang.zip解压到/data/目录进行操作
mv 2.V9.1_XinChuang.zip /data/
cd /data
unzip 2.V9.1_XinChuang.zip
关于XinChuang部署工具：
XinChuang包中有一个信创部署工具，是致远自研产品，工具将很多人工操作的步骤写到程序中，由工具程序来自动完成。包括并不仅限于：配置JVM、调整jar包、设置产品标识、部署OA程序、导入数据库脚本等，极大提升部署效率，减少错误率。
只要使用信创部署工具安装OA，后续OA版本升级，也可以用信创部署工具一键平滑升级。故能用信创部署工具的环境，一定都用工具做部署、升级！
信创部署工具部署模式：
OA信创部署工具位于XinChuang/deploytools目录下，支持图形界面部署和命令行静默部署两种方式，如果有图形化界面，建议优先使用图形界面方式。
图形化部署：使用命名含GUI的
deployGUI-for-版本号-产品线.sh程序启动命令行部署：使用命名含cli的
deploycli-for-版本号-产品线.sh程序启动
# 方法一金蝶V10-图形化安装
本小节适用于带图形化的Linux或信创操作系统。
安装前，首先确定一个OA程序的安装路径，通过mkdir -p /data/Seeyon命令创建目录，以后OA程序就在/data/Seeyon目录下维护。
安装前，还要确保中间件已经处于启动状态，程序会针对程序目录写入配置。
安装前，确认好客户使用什么数据库，如果是当前版本标准产品支持的数据库，则只需要初始化一个空库（即使是老客户转信创也建议先建空库测试启动），信创工具会自动写入SQL数据。
以上准备就绪后，参考如下命令启动图形化部署工具：
# 到XinChuang部署目录deploytools
cd /data/2.V9.1_XinChuang/deploytools
# 先赋予可执行权限（如果是G6则操作G6N结尾的可执行文件）
chmod +x deployGUI-for-V9.1-A8N.sh
# 再启动GUI可执行程序（如果是G6则操作G6N结尾的可执行文件）
./deployGUI-for-V9.1-A8N.sh
图形化参数说明：
安装 / 升级： 由信创工具自动判断安装还是升级，如检测到没有安装就自动安装，检测到已安装则自动升级
CPU： 目前支持 ARM、MIPS、x86 三类，根据当前系统实际情况选择
系统： 只有 CPU 类型为 ARM 时才需要选择，支持选项：统信 uos、麒麟 kylin
中间件： 根据实际情况选择，金蝶V10选择ApusicV10
协同路径： 必须提前创建固定的协同目录，比如本例设置为 /data/Seeyon ，通过 mkdir -p /data/Seeyon 命令创建目录
中间件路径： 对应金蝶V10 Domain域目录，如本例安装地址/data/AASV10/ApusicAS/aas/domains/mydomain
协同产品线、在线人数： 根据实际情况选择，不同在线人数，工具会给不同的 JVM 配置
数据库： 下拉列表中能选到的就是标准支持的库，需要提前准备好空库，工具会自动向空库中写入 协同 初始化 SQL；如数据库不在标准支持范围，则下拉列表选择“不初始化数据库”，这类“不初始化数据库”场景，在工具部署完成后，需要手动初始化数据。
标准产品支持：达梦、人大金仓、神通、MySQL、Oracle、SQLServer、Gbase南大通用数据库初始化，Postgresql仅支持升级。
JDBCDriver： 根据选择的数据库自动生成，无需修改
JDBC URL： 需要修改 IP、端口、库名（数据库空库需要提前创建）
数据库用户、密码： 根据实际情况填写
宝兰德密码： 对应宝兰德管理控制台admin的密码，非宝兰德中间件无需配置
宝兰德端口： 对应宝兰德管理控制台的端口，非宝兰德中间件无需配置
以上填写完整后，先进行“验证参数”，通过后再“安装/升级”，部署需要一定时间，请耐心等待。
信创部署工具日志文件位于：XinChuang/deploytools/logs目录下，可通过日志查看。
完成部署后，手工关闭安装程序退出。
注意：部署工具安装完成后，必须重启中间件：
# 停止和启动服务
cd /data/AASV10/ApusicAS/bin
./asadmin stop-domain
./asadmin start-domain
# 查看域日志
cd /data/AASV10/ApusicAS/aas/domains/mydomain/logs
tail -f server.log
# 方法二金蝶V10-命令行安装
如操作系统无图形化界面，则使用命令行静默安装。
A8N升级通过修改信创部署目录 XinChuang/deploytools/cfgHome/installConfig.properties文件，配置必要的参数。
不同产品线修改的配置文件不同，G6N修改名为installConfigG6N.properties的配置文件。
# 到 XinChuang 部署目录 deploytools/cfgHome
cd /data/2.V9.1_XinChuang/deploytools/cfgHome/
# 修改 installConfig.properties 文件参数
vim installConfig.properties
installConfig.properties 配置文件中的参数与图形化部署界面一模一样，这里面的参数直接参考图形化部署章节填写。
再次提醒：请不要凭感觉填写配置，认真参考“图形化升级”章节，熟悉每一个配置和注意事项后再操作！
如下是一个示例截图：
第三步：执行命令行部署 sh 脚本：
# 到 XinChuang 部署目录 deploytools
cd /data/2.V9.1_XinChuang/deploytools
# 先赋予可执行权限，再执行 sh 脚本
chmod +x deploycli-for-V9.1-A8N.sh
./deploycli-for-V9.1-A8N.sh
提示“安装成功”即可退出命令模式，进行后续部署配置操作：
信创部署工具日志文件位于：XinChuang/deploytools/logs目录下，如遇到部署异常可通过日志分析问题。
注意：部署工具安装完成后，必须重启中间件：
# 停止和启动服务
cd /data/AASV10/ApusicAS/bin
./asadmin stop-domain
./asadmin start-domain
# 查看域日志
cd /data/AASV10/ApusicAS/aas/domains/mydomain/logs
tail -f server.log
# 金蝶V10 JVM检查
通过信创部署工具部署完成后，一定要重启一次金蝶中间件，否则工具部署的参数无效！
系统管理员admin登录金蝶控制台（http://金蝶服务器IP:端口（默认6848）），访问配置管理-server-config-JVM配置-JVM选项，检查必须的JVM配置：
1、垃圾回收器必须选择：G1
2、搜索-Xmx参数，用于分配给OA的最大堆内存，信创部署工具会根据设置的人数自动写入推荐值，如需调整直接在此修改即可，比如申请16G堆内存则配置-Xmx16G
| 在线人数 | 部署方式 | 信创协同服务器配置参考 | 堆内存配置推荐 |
|---|---|---|---|
| 200以下 | 单机 | CPU12核以上/内存24G以上/硬盘320G以上 | 12G |
| 200~500 | 单机 | CPU12核以上/内存32G以上/硬盘320G以上 | 16G |
| 500~1000 | 单机 | CPU24核以上/内存48G以上/硬盘320G以上 | 24G |
| 1000~2000 | 1主1从 | CPU24核以上/内存64G以上/硬盘320G以上 | 32G |
| 2000~3000 | 1主2从 | CPU32核以上/内存64G以上/硬盘320G以上 | 32G |
| 3000~5000 | 1主2从 | CPU32核以上/内存96G以上/硬盘320G以上 | 48G |
3、搜索-Dcom.sun.enterprise.overrideablejavaxpackages=javax.ws,org.apache.taglibs.standard参数，如不存在，则务必将其手动添加到JVM选项中：
4、搜索-Djdbcproxydriver.driverclass，如果是标准产品支持的数据库， 则一定要有此参数，如不存在，务必将其手动添加到JVM选项中，填写规范如下：
达梦填写
-Djdbcproxydriver.driverclass=dm.jdbc.driver.DmDriver金仓填写
-Djdbcproxydriver.driverclass=com.kingbase8.Driver神通填写
-Djdbcproxydriver.driverclass=com.oscar.Driver南大通用填写
-Djdbcproxydriver.driverclass=com.gbasedbt.jdbc.DriverMySQL填写
-Djdbcproxydriver.driverclass=com.mysql.jdbc.DriverSQLServer填写
-Djdbcproxydriver.driverclass=com.microsoft.sqlserver.jdbc.SQLServerDriverOralce填写
-Djdbcproxydriver.driverclass=oracle.jdbc.driver.OracleDriver
如果不是标准产品支持的数据库，则根据对应非标数据库项目化部署手册中的说明来确定是否配置，如无需配置则从JVM中删除此参数！
5、搜索-Dsun.zip.disableMemoryMapping=true，如不存在，则务必将其手动添加到JVM选项中：
6、搜索如下两个JVM选项，如果不存在或值过小，则按如下参数调整并保存：
-XX:MaxMetaspaceSize=2G
-XX:ReservedCodeCacheSize=1G
# 金蝶V10线程池保持默认
配置管理-server-config线程池保持默认的配置即可，不用修改，正常配置如下：
# 金蝶V10协同OA打补丁（可选）
此步骤主要面对非标准支持数据库的项目化适配场景，务必提前打好适配代码，再进行数据库连接配置及启动。
注意补丁包打包位置：大部分jar放置于OA程序的seeyon/WEB-INF/lib下，还有少量jar放置在金蝶中间件lib下，项目上要根据情况核对清楚并确保打包正确。
# 金蝶V10 JNDI数据源
全新安装场景不再使用中间件自带的JDBC数据库连接池，而是改用JNDI资源，JNDI资源使用协同自主设计的数据库连接池。
协同自主数据库连接池性能优越、支持连接保活、连接可用性检测、连接监控、慢查询日志
1、中间件管理控制台--资源管理-JNDI资源菜单，如列表存在名称为jdbc/ctpDataSource的JNDI资源配置，则说明本次通过JNDI走协同自主连接池：
- JNDI资源名称：
jdbc/ctpDataSource - JNDI资源类型：
javax.sql.DataSource - JNDI工厂类：
com.seeyon.v3x.dbpool.datasource.DataSourceConProviderFactory - JNDI状态默认勾选启用
2、协同自主数据库连接池配置存放于协同程序base/conf/datasourceCtp.properties文件里，通过中间件JVM-DA8.datasource.properies.filepath参数可以看到详细路径：
# 金蝶V10部署启动应用
1、接下来就是准备部署应用启动，部署启动前，先在OA程序/base/license目录放置-N加密授权。
注册加密授权见《新加密授权注册更新手册》。
2、OA目录放置授权完成后，开始部署启动应用，进入应用管理菜单，选择部署按钮：
路径：选择“可以从 Apusic Server 访问的本地打包文件或目录”，这里指向OA安装程序部署目录，我们需要按下面列表中的顺序一个一个部署：
| 部署顺序 | OA安装程序路径（示例） | 上下文路径 | 应用程序名称 |
|---|---|---|---|
| 1 | /data/Seeyon/V5/ApacheJetspeed/webapps/ROOT | / | ROOT |
| 2 | /data/Seeyon/V5/ApacheJetspeed/webapps/seeyon | /seeyon | seeyon |
| 3 | /data/Seeyon/V5/ApacheJetspeed/webapps/static | /static | static |
| 4 | /data/Seeyon/V5/ApacheJetspeed/webapps/sportal | /sportal | sportal |
常见部署问题：
1、首次部署/seeyon点击“下一步”卡住：这个是正常现象，正在启动OA，如果卡住超过10分钟则不是正常现象，要看日志排查！
2、首次部署/seeyon时，金蝶控制台页面突然无法访问：原因是部署启动/seeyon报错了，需要到中间件domain/logs/server.log和OA程序ApacheJetspeed/logs_sy目录下根据日志分析排除故障，然后kill金蝶进程，重新启动金蝶再重新部署/seeyon。
3、首次部署/seeyon时，超过10分钟无反应：参考问题2，排查日志。并且关注中间件日志和OA日志是否在暴增，注意及时停止服务，清理异常的日志，防止磁盘空间占满。
4、信创部署启动提示Name "jdbc/ctpDataSource" not found，解决方案参考在线文档 https://open.seeyoncloud.com/#/faq/faq/v1/share?url=Z2JySmU+NDMyNQ==
5、金蝶V10部署OA V9.0以上版本的/seeyon，第一次大概率都无法启动：通过查看日志，能看到Unable to call method addListener on servlet context seeyon这样的错误信息，这个是金蝶中间件未适配好Servlet 3.0的ServletContext.addListener导致。处理方法是联系金蝶分析出补丁包。测试环境临时解决方法：可以从致远公司系统的讨论《【高频咨询】关于金蝶V10中间件部署9.0、9.0SP1系列版本无法启动的问题》下载补丁，补丁文件aas-web-core.jar替换到aas/modules/目录里。
参考资料 https://open.seeyoncloud.com/#/faq/faq/v1/share?url=Z2JySmU+Mzk5Og==
4个应用按顺序部署，部署完成后的效果如下，我们可以点击“访问”按钮访问OA系统：
访问OA系统正常页面如下，新客户可以使用账户密码init-admin/123456登录系统初始化基础数据，老客户使用原账号密码登录即可：
5、浏览器不带/seeyon无法访问到OA登录页，希望通过IP端口就能自动跳转到OA登录页：
解决方案：需要参考“部署启动应用”章节部署ROOT，如果已经部署过则修改或删除重新部署一遍ROOT就能解决问题。
# 金蝶V10日常运维
# 金蝶V10修改数据库配置
如需调整数据库连接URL、帐号、密码、最大最小连接数，都需在协同程序base/conf/datasourceCtp.propertie文件中调整：
- ctpDataSource.url：数据库连接URL
- ctpDataSource.driverClassName：数据库驱动类名
- ctpDataSource.username：数据库连接账号
- ctpDataSource.password：数据库连接密码，数据库密码可以明文，如需密文存放，可在其它环境使用SeeyonConfig应用配置器保存数据库密码，将加密后的密码串替换到当前环境中
- ctpDataSource.minCount：初始化连接数
- ctpDataSource.maxCount：允许最大连接数
调整datasourceCtp.properties配置后不仅需要重启协同OA，还需要重启中间件才能保证配置生效。以下为电科金仓数据库连接池的配置示例：
# 金蝶V10启停中间件和启停OA
启动中间件：到ApusicAS/bin目录下执行./asadmin start-domain，启动中间件的同时OA也自动启动了：
cd /data/AASV10/ApusicAS/bin
./asadmin start-domain
# 查看域日志
cd /data/AASV10/ApusicAS/aas/domains/mydomain/logs
tail -f server.log
启动不了，一般是查看domain下的logs日志。比如数据库连不上会导致金蝶启动失败，需要先确保数据库先启动，然后kill金蝶所有进程再重新启动金蝶。
停止中间件：可执行stop-domain或者kill
# 稳妥方案执行命令停止
cd /data/AASV10/ApusicAS/bin
./asadmin stop-domain
# 如果还有问题，则需要执行kill进程（有多个aas，需要每个都kill掉）
ps -ef | grep aas
kill -9 进程ID
# 金蝶V10-后台修改jvm参数
编辑配置文件：aas/domains/mydomain/config/domain.xml，在以下位置修改或添加
# 金蝶V10协同OA部署HTTPS
默认协同通过http协议访问，如客户需要https访问协同，则需要单独部署配置：
- 首先，宝兰德中间件不做任何调整，保持默认http
- 然后，部署Nginx，由Nginx管理https，通过Nginx+SSL反向代理到协同http
- 最终，系统运行模式为：客户端===>Nginx（https）===>协同（http）
Nginx 部署、参数配置及 SSL 配置可参考《Nginx部署配置手册 (opens new window) (opens new window)》。
# 金蝶V10协同集群部署
金蝶V10中间件下部署协同集群，需要先参考本手册部署第一套环境，确保单机运行正常，再参考 《致远协同管理软件集群部署手册》 (opens new window)进行集群配置。
# 金蝶V10 OA程序升级
如果早期使用信创部署工具安装部署的协同，后期协同存在升级需求，则参考信创升级手册操作即可。
# 四、Tomcat协同应用部署
标准产品支持基于Tomcat中间件部署-N协同应用，无需准备Tomcat中间件，使用标准产品信创部署工具即可自动安装带有Tomcat的协同应用程序。
# Tomcat部署环境准备
部署前，通过java -version命令检查当前系统是否已经安装openjdk8。如未安装请自行安装或联系系统厂商准备合适的jdk8（小版本号推荐1.8.0_372），并配置JAVA_HOME、PATH、CLASSPATH环境变量：
准备XinChuang.zip包：
从致远商务公布的安装程序下载地址中，下载对应版本的XinChuang.zip部署包，并解压到系统中：
# 同样将XinChuang.zip解压到/data/目录进行操作
mv 2.V9.1_XinChuang.zip /data/
cd /data
unzip 2.V9.1_XinChuang.zip
信创部署工具部署模式：
OA信创部署工具位于XinChuang/deploytools目录下，支持图形界面部署和命令行静默部署两种方式，如果有图形化界面，建议优先使用图形界面方式。
图形化部署：使用命名含GUI的
deployGUI-for-版本号-产品线.sh程序启动命令行部署：使用命名含cli的
deploycli-for-版本号-产品线.sh程序启动
# Tomcat-图形化安装
本小节适用于带图形化的Linux或信创操作系统。
安装前，首先确定一个OA程序的安装路径，通过mkdir -p /data/Seeyon命令创建目录，以后OA程序就在/data/Seeyon目录下维护。
安装前，确认好客户使用什么数据库，如果是当前版本标准产品支持的数据库，则只需要初始化一个空库（即使是老客户转信创也建议先建空库测试启动），信创工具会自动写入SQL数据。
以上准备就绪后，参考如下命令启动图形化部署工具：
# 到XinChuang部署目录deploytools
cd /data/2.V9.1_XinChuang/deploytools
# 先赋予可执行权限（如果是G6则操作G6N结尾的可执行文件）
chmod +x deployGUI-for-V9.1-A8N.sh
# 再启动GUI可执行程序（如果是G6则操作G6N结尾的可执行文件）
./deployGUI-for-V9.1-A8N.sh
图形化参数说明：
安装/升级：
- V9.0SP1之前版本，全新部署勾选“安装”选项，已经通过工具安装过OA，升级版本则选“升级”选项
- V9.0SP1 2025年M4版本开始，安装和升级合并为一个按钮：如检测到没有安装就自动安装，检测到已安装着自动升级
CPU： 目前支持ARM、MIPS、x86三类，根据当前系统实际情况选择
系统： 只有CPU类型为ARM时才需要选择，支持选项：统信uos、麒麟kylin
中间件： 根据实际情况选择，Tomcat就选Tomcat，信创部署工具会自动安装Tomcat中间件
协同路径： 可自定义，比如本例设置为/data/Seeyon，此目录需要提前创建，未创建目录会报错
中间件路径： 如中间件选择Tomcat，则无需设置中间件路径，信创工具自动将Tomcat安装在协同路径下
协同产品线、在线人数： 根据实际情况选择，在线人数尽量预估准确，不同在线人数，工具会给不同的JVM配置
数据库： 下拉列表中能选到的就是标准支持的库，只要准备好空库，工具会自动向空库中写入OA初始化SQL；如数据库不在标准支持范围，则下拉列表选择“不初始化数据库”，这类“不初始化数据库”场景，在工具部署完成后，需要手动初始化数据。
JDBCDriver： 根据选择的数据库自动生成，无需修改
JDBC URL： 需要修改IP、端口、库名（数据库空库需要提前创建，见前面章节说明）
数据库用户、密码： 根据实际情况填写
以上填写完整后，先进行“验证参数”，通过后再“部署”，部署需要一定时间，请耐心等待。
如数据库选择“不初始化数据库”，安装结束后提示“未找到对应数据库版本驱动JAR，请手动放置数据库驱动”的提示，可以忽略，部署是成功的。
完成部署后，手工关闭安装程序退出。
信创部署工具日志文件位于：2.V9.1_XinChuang/deploytools/logs目录下，如遇到部署异常可通过日志分析问题。
# Tomcat-命令行静默安装
命令行部署，又叫静默部署，适用于无法通过图形化安装的场景。
第一步：修改installConfig.properties
通过修改信创部署目录XinChuang/deploytools/cfgHome/installConfig.properties配置文件，配置必要的参数：
# 到XinChuang部署目录deploytools/cfgHome
cd /data/2.V9.1_XinChuang/deploytools/cfgHome/
# 修改installConfig.properties文件参数
vim installConfig.properties
installConfig.properties配置文件中的参数与图形化部署界面一模一样，这里面的参数直接参考上一个图形化安装章节填写。
再次提醒：请不要凭感觉填写配置，认真参考“图形化部署”章节，熟悉每一个配置和注意事项后再操作！
如下是一个示例截图，本示例选择安装A8-N集团版、数据库选择DM、提前创建好OA的程序目录mkdir -d data/Seeyon目录：
第二步：执行命令行部署sh脚本：
先赋予可执行权限，再执行sh脚本：
# 到XinChuang部署目录deploytools
cd /data/2.V9.1_XinChuang/deploytools
# 先赋予可执行权限（如果是G6则操作G6N结尾的可执行文件）
chmod +x deploycli-for-V9.1-A8N.sh
# 再启动GUI可执行程序（如果是G6则操作G6N结尾的可执行文件）
./deploycli-for-V9.1-A8N.sh
信创部署工具日志文件位于：2.V9.1_XinChuang/deploytools/logs目录下，如遇到部署异常可通过日志分析问题。
# Tomcat检查部署目录
部署完成后，访问协同目录，可以看到协同程序和Tomcat中间件已经自动安装，目录结构与非信创相同：
访问ApacheJetspeed/bin目录，能看到启停脚本文件：
以上目录无误，则说明部署完成，可进行启停测试。
# Tomcat协同启动和停止
1、首先确保加密授权Lic已经放置到程序目录base/license下。
注册加密授权见《新加密授权注册更新手册》。
2、运行ApacheJetspeed/bin目录下的./startup.sh启动协同服务：
运行ApacheJetspeed/bin目录下的./shutdown.sh停止协同服务。
# Tomcat启动常见问题
1、Kingbase金仓数据库模式，启动协同失败，提示“获取数据库连接失败”，实际SeeyonConfig检查数据库连接正常。检查Tomcat中间件下的驱动jar发现存在两个kingbase驱动jar。
解决方案：kingbase8-8.2.0.jar是Kingbase R3的驱动，kingbase8-8.6.0.jar是Kingbase R6的驱动，需要根据数据库版本情况只保留一个驱动jar。如果项目上的金仓高于R6，则联系数据库厂商提供与数据库匹配的驱动jar（注意移除中间件下多余的kingbase驱动）。
# Tomcat其它运维配置
信创环境Tomcat的日常运维方式与非信创完全一致，参考非信创Linux部署维护手册即可。
如需要进行JVM参数调优、数据库调整、系统插件参数配置，则直接运行ApacheJetspeed/conf/SeeyonConfig.sh配置即可
# 在线预览服务OfficeTrans
# 在线预览概要说明
协同服务安装时预置安装OfficeTrans服务。若需要将OfficeTrans分离部署可通过以下方式进行。
# 在线预览安装配置
在协同服务安装后，预置安装的OfficeTrans服务，位于产品安装目录下OfficeTrans文件夹。
将OfficeTrans、jdk、S1文件夹拷贝至分离部署的服务器。
注册信息导出，并导入到分离部署服务器。注册信息如下：
Linux服务器协同信息注册于 /root/.config/目录下（Officetrans关键字）
# 在线预览参数配置
通过S1进行在线预览参数配置，以及服务启停。
JVM属性设置，其中-Djava.rmi.server.hostname=127.0.0.1配置里的ip地址需要改成转换服务器内网ip，默认端口1097和1098，如果是分离部署需要开放端口让协同服务可以访问。
# 在线预览协同参数配置
自V9.0SP1版本开始，在确保协同服务和OfficeTrans转换服务均启动的情况下，由系统管理员访问“流版签设置”菜单，进行在线预览配置：
在线预览插件： 选择Aspose在线预览（对应OfficeTrans转换服务）
在线预览文件大小限制：单位KB，最大100MB = 102400KB，如果要预览的文件大小大于设置的大小则不显示预览放大镜。
Aspose在线预览IP：如果与OA部署在同一服务器，配置127.0.0.1，如部署在其他服务器，则配置对应服务器ip。
Aspose在线预览缓存文件夹位置：建议配置在ApacheJetspeed文件夹同级目录的base\officetrans目录下，如目录不存在则自行创建。
一定不要配置到OA或Office转换的安装目录中，如果配置到了OA或者Office转换的安装目录，会导致OA或转换的应用文件被删除。Aspose在线预览端口：默认端口1097。
Aspose在线预览缓存文件保留天数：Aspose在线预览缓存文件保留的天数，超过设置天数后将被清理，再次预览时将重新生成缓存，设置0则不清理。
# 在线预览启动
方法一：命令行cd命令到【协同程序目录】/OfficeTrans目录下，用命令启动Office转换服务：
cd 【协同程序目录】/OfficeTrans
nohup ./startup.sh >/dev/null 2>&1 &
方法二：通过S1的服务启停来启动
在多网卡服务器时，可能遇到无法启动的问题，此时需要编辑OfficeTrans服务目录的startup.bat，在JAVA_OPTS值的最后增加（或者修改绑定服务的IP地址）-Djava.rmi.server.hostname=IP地址，其中IP地址设置成当前服务器真实的网络IP：
# 在线预览停止
方法一：通过命令停止OfficeTrans进程：
# ps命令查询officetrans服务进程ID
ps -ef | grep java
# kill对应进程ID
kill -9 进程ID
方法二：通过S1的服务来停止。
# 全文检索部署
全文检索服务所需配置、部署维护手册详见《全文检索部署维护手册》。
# 音视频部署
音视频服务所需配置、部署维护手册详见《音视频部署维护手册》。
# 信创环境下集群部署
信创环境集群部署方式与非信创相同，每个节点需要一套信创中间件做容器，随后配置SeeyonConfig参数即可，详细方法参考《集群部署手册》。
# 静态化登录前门户配置
# 共享目录配置
集群部署时须要将ApacheJetspeed\webapps\sportal目录主从节点进行相互共享，使得主从服务都能访问sportal下的静态文件和目录。可参考【集群部署手册公共资源目录配置】挂载配置方法。
注意：
1、ApacheJetspeed\webapps\sportal\archive目录是静态化文件的存储目录，所有静态化登录前门户的相关数据文件存放在这里，不能随意删除，否则会造成数据丢失和显示异常。
2、如果升级更新服务，建议升级前先将ApacheJetspeed\webapps\sportal\archive目录进行备份，之后再做升级。
# 静态化登录前门户OBS配置
如果文件服务使用了obs对象存储，静态化登录前门户生成的静态资源也需要进行obs配置。
用文本编辑器打开ApacheJetspeed\webapps\sportal\WEB-INF\sportal.properties文件
1将isRemote 属性改为true，开启obs模式。
2修改remoteFilePrefixPath属性的值，为OA系统的webapps文件夹全路径，需要以文件夹分隔符结尾
3修改remoteFilePath属性的值，为登录前门户静态资源存放的最上层文件夹名称。
示例：
# 登录前门户静态化升级选择
版本升级时，可通过SQL选择将登录前门户升级为静态化门户或非静态化门户（原门户），选择不同的登录前门户形态将平台功能造成不同的影响。
# 通过SQL进行登录前门户静态化/非静态化切换
- 转换为静态化的登录前门户
1、升级时自动将登录前门户状态调整为【关闭】:
update portal_set set state = 0 where id = -7779029842361826066
2、将登录前门户默认空间修改为2200000003：
UPDATE portal_global_config SET CONFIG_VALUE='2200000003' where CONFIG_ITEM='-7779029842361826066_defaultTheme'
3、删除guset账户权限状态信息：
delete from ctp_config where CONFIG_ITEM = 'GUESTPERMISSIONSTATUS'
4、删除org_principle表中的guest用户信息：
delete from org_principal where login_name = 'seeyon-guest'
二、转换为非静态化的登录前门户
1、升级时自动将登录前门户状态调整为【关闭】 :
update portal_set set state = 0 where id = -7779029842361826066
2、开启guest账户权限状态：
1、升级时自动将登录前门户状态调整为【关闭】 :
update portal_set set state = 0 where id = -7779029842361826066
2、开启guest账户权限状态：
delete from ctp_config where CONFIG_ITEM = 'GUESTPERMISSIONSTATUS'
INSERT INTO `ctp_config` (`ID`, `CONFIG_CATEGORY`, `CONFIG_CATEGORY_NAME`, `CONFIG_ITEM`, `CONFIG_VALUE`, `CONFIG_DESCRIPTION`, `CREATE_DATE`, `MODIFY_DATE`, `CONFIG_TYPE`, `EXT_CONFIG_VALUE`, `ORG_ACCOUNT_ID`, `SORT`) VALUES (99991111111, 'GUESTPERMISSIONSTATUS', NULL, 'GUESTPERMISSIONSTATUS', 'true', NULL, '2022-05-20 13:32:22', '2022-05-20 13:32:22', NULL, NULL, 1, NULL)
3、创建guest账户：
delete from org_principal where login_name = 'seeyon-guest';
INSERT INTO org_principal (ID, LOGIN_NAME, CREDENTIAL_VALUE, CLASS_NAME, EXPIRATION_DATE, MEMBER_ID, IS_ENABLE, CREATE_TIME, UPDATE_TIME) VALUES
('-4487202475317442573', 'seeyon-guest', 'PantDJFV/3JQUrkAlrjiYSWQRfs=', NULL, '2017-12-19 19:39:42', '-6964000252392685202', '1', '2017-12-19 19:26:22', '2017-12-19 19:39:42')
4、防止guest账户再次被删除：
update org_member set is_deleted = 0 where id = -6964000252392685202
注意：升级为静态化登录前门户后，将会对平台功能造成影响，详见**"静态化登录前门户&非静态化登录前门户影响范围对比说明"**
# 登录前门户静态化
# 新闻公告静态化
# 账号管理影响
# 相关历史数据变更
# 常见问题
- 问题：
集成外部HTTPS系统时，后台异常：
java.lang.RuntimeException: javax.net.ssl.SSLException: java.lang.RuntimeException: Unexpected error: java.security.InvalidAlgorithmParameterException: the trustAnchors parameter must be non-empty
解决方法：
执行以下操作系统命令，更新ssl证书：
sudo rm /etc/ssl/certs/java/cacerts
sudo update-ca-certificates -f
- 问题：
集成外部HTTPS系统时，后台异常：java.security.InvalidKeyException: Illegal key size
解决方法：
打开以下连接：
https://www.oracle.com/java/technologies/javase-jce8-downloads.html
下载jce_policy-8.zip，将压缩包中的jar包替换：
${jdk_home}/jre/lib/security、${jre_home}/lib/security中的文件
- 问题：执行SQL文件后数据库中文乱码
解决方法：
删除该库，将SQL文件转为ANSI编码（以notepad++为例：打开SQL文件->编码->转为ANSI编码），重新执行SQL文件。
问题：启动后ctp.log中出现以下异常：
java.lang.NullPointerException at sun.awt.FontConfiguration.getVersion
解决方法：
安装AWT相关组件，参考以下命令：
yum install fontconfig
fc-cache --force
- 涉密操作系统安装中间件和部署A8N产品请参照以下两种方式进行：
涉密操作系统厂商安装好对应版本的金蝶或东方通后，通过控制台按手册修改中间件参数后进行A8N产品部署；
或者在涉密操作系统厂商提供的非涉密开发版操作系统上安装中间件并部署A8N的产品后，请涉密厂商协助将部署后的中间件和A8N产品重新打包，并通过涉密操作系统中的"安全配置管理"软件安装重新打包后的产品。
- 问题：涉密操作系统部署完成后无法启动应用，日志中出现sqlite异常：
**解决方法：**更新sqllite补丁包。
- 问题：涉密操作系统部署完成功能异常，日志中出现异常：
java.io.IOException: Cannot run program "/opt/V5/ApacheJetspeed/webapps/seeyon/common/phantomjs/bin/phantomjs_linux64": error=13, Permission denied
解决方法：
可执行文件phantomjs_linux64需要通过涉密机专有方式上传，请涉密操作系统厂商处理。
- 问题：全新环境，能启动，但是登录报NullPointerException
分析中间件日志server.log，将日志拖到最后看到如下异常：
java.lang.NullPointerException
at java.util.concurrent.ConcurrentHashMap.putVal(ConcurrentHashMap.java:1011)
at java.util.concurrent.ConcurrentHashMap.put(ConcurrentHashMap.java:1006)
at com.seeyon.ctp.portal.manager.PortalCacheManagerImpl.getLoginSettingBy(PortalCacheManagerImpl.java:2275)
at com.seeyon.ctp.portal.api.PortalApiImpl.getLoginSettingBy(PortalApiImpl.java:736)
at com.seeyon.ctp.login.controller.MainController.index(MainController.java:638)
解决方法：此问题是数据原因，门户初始化数据丢失，造成的原因一般是：在信创数据库导入SQL时导入失败。解决办法是：drop数据库，重新执行初始化导入，完成后重启对应应用服务。注意按照部署手册"执行产品初始化SQL"章节的内容操作。尤其是达梦之类的数据库，一定要按照手册要求，执行SQL之后，使用commit提交。
- 问题：东方通7.0.4.1的阈值配置不合理导致系统卡顿
解决方法：
TongWeb7.0.4.1 --> 管理控制台 --> 监视 --> 阈值配置 --> default1 --> 勾选了快照jmap会在触发时执行fullgc导致卡顿现象。
阈值配置不合理，建议修改方法:
1、将最大线程数10改成300
2、无内存泄漏问题，去掉jmap勾选
- 问题：东方通7.0.4.X页面出现"提示信息系统级错误"；涉及关联文档、修改公文单、表单等；
解决方法：更新东方通补丁包解决，不同版本补丁包联系东方通获取。
东方通7.0.4.X补丁包打包步骤：
补丁包下文件Parser.class替换文件： tongweb安装目录\lib\tongweb.jar打开jar包，注意备份文件，需要替换的文件路径为：com\tongweb\jasper\compiler\Parser.class
修改配置文件：
修改bin目录下external.vmoptions文件，增加一行：
-Dcom.tongweb.jasper.compiler.Parser.STRICT_WHITESPACE=false
修改conf目录下default-web.xml
在com.tongweb.web.jasper.servlet.ThanosJspServlet下增加init参数：
<init-param>
<param-name>strictQuoteEscaping</param-name>
<param-value>false</param-value>
</init-param>
快速跳转
