# 致远协同管理软件安装维护手册-Linux

北京致远互联软件股份有限公司 2025年4月

# 前言

本手册对V9.0SP1版本协同管理系统的安装及维护相关事宜进行说明。

本手册适用于Linux服务器环境部署，如需信创或Windows环境部署请参考其它手册。

如对安装维护手册中相关问题存在疑问，请与致远互联的客户服务人员联系。

维度	支持范围
手册适用版本	A6、A8+、G6+ 9.0SP1
手册适用系统	Linux详细支持范围见《产品服务器环境准备》手册
手册适用数据库	详见《产品服务器环境准备》手册
服务器资源准备和要求	详见《产品服务器环境准备》手册

# 修订记录

修订内容	修订时间
重新梳理Linux部署手册章节及内容，确保结构易读、易懂	2025-4-10

# 环境准备

协同管理软件对服务器软硬件、数据库、网络等均有明确要求，在进行软件部署前，请务必阅读《产品服务器环境准备》手册，并进行相关环境准备。

# 操作系统相关准备

安装基本的命令组件：

安装部署前，先确保当前系统已经安装了最基础的命令，（能连接互联网服务器）可执行如下语句做预装：

如服务器无法连接互联网，请要求操作系统厂商预装必要的命令组件

# Red Hat系列（如CentOS），使用yum命令安装，如当前系统提示yum不可用，则尝试使用apt
sudo yum update -y
sudo yum install tar curl telnet vim unzip -y

# 基于Debian的系统（如Ubuntu）使用apt预装组件
sudo apt update -y
sudo apt upgrade -y
sudo apt install tar curl telnet vim unzip -y

# 基于欧拉openEuler、龙蜥Anolis OS等系统使用dnf安装
sudo dnf update -y
sudo dnf install tar curl telnet vim unzip -y

安装图形命令组件：

确保当前系统安装了必要的字体、图形组件，否则会影响后续程序使用：

# Red Hat系列（如CentOS），使用yum命令安装，如当前系统提示yum不可用，则尝试使用apt
sudo yum install freetype libX11 libXrender libXtst libXi fontconfig -y

# 基于Debian的系统（如Ubuntu）使用apt预装组件
sudo apt install libfreetype6 libx11-6 libxrender1 libxtst6 libxi6 fonts-config -y

# 基于欧拉openEuler、龙蜥Anolis OS等系统使用dnf安装
sudo dnf install freetype libX11 libXrender libXtst libXi fontconfig -y

在进行安装部署前，先按照如下配置优化Linux相关系统参数：

修改Linux内核参数：

# 编辑配置文件，并在文件末尾添加参数配置
vim /etc/sysctl.conf

net.ipv4.tcp_fin_timeout = 30
net.ipv4.tcp_keepalive_time = 1800
net.ipv4.tcp_window_scaling = 0
net.ipv4.tcp_sack = 0
net.ipv4.tcp_timestamps = 0

# 读取 /etc/sysctl.conf 文件中的设置，使其立即生效
sysctl -p

修改Linux最大进程数最大文件打开数：

通过 vim /etc/security/limits.conf 命令编辑此文件添加以下内容

# open files  (-n)
* soft nofile 65535
* hard nofile 65535
# max user processes  (-u)
* soft nproc 65535
* hard nproc 65535

# 设置当前会话中立刻生效
ulimit -n 65535  # 设置最大打开文件数量
ulimit -u 65535  # 设置最大进程数

以上配置完成后，执行 ulimit -a 命令检查open files和max user processes是否都变成65535

时区配置： 安装或升级前，请先设置操作系统时区。确保协同应用服务器时区应与数据库服务器时区一致。此时区尽量与协同大部分用户所在时区保持一致。协同应用服务器时区的变化，将导致系统提示类的数据异常。

数据库准备： 安装或升级前，确保数据库已经准备到位，并且协同服务器能正常连接到数据库，数据库配置及要求参考《产品服务器环境准备》中的数据库注意事项。

启动安装程序之前环境检查项： 在进行安装升级前，确保Linux服务器环境配置符合要求，如不符合，安装程序无法继续运行。

1、检查当前是否为支持的操作系统类型

2、检查是否64位

3、检查cpu内存是否达到最低配置要求8c16g

4、检查虚拟内存是否不低于10240M

5、检查磁盘可用空间是否不低于100G

6、检查网卡速率是否符合基线要求1000M

7、已部署各项服务内存之和，加上即将安装的产品内存配置（默认4G)不得超过物理内存80%

8、当前服务器可用内存不得低于物理内存60%

9、Linux系统，ulimit -a检查open files和max user processes都不得低于60000

如当前系统配置较低，程序仅用作个人或演示使用，可酌情修改按照程序SeeyonInstall/inst/check.yml配置文件，降低环境检查基线

# 安装程序准备

从商务公布的对应版本安装程序下载地址下载名为“SeeyonInstall.zip”的文件，此文件是X86环境标准安装程序。

将SeeyonInstall.zip文件上传到Linux服务器，并通过解压到指定目录，如解压到/data下：

mkdir /data
# 解压安装程序
unzip 0.SeeyonInstall.zip -d /data
# 查看解压后的程序目录
cd /data/0.SeeyonInstall/
ls

赋予安装包里的文件可执行权限： chmod -R 777 【安装包路径】

chmod -R 777 /data/0.SeeyonInstall

安装程序提供了不同产品线的脚本，阅读readme.txt文件，按照文档引导选择对应的启动脚本进行安装或升级。

全新安装、修复安装或升级均使用同一入口文件（安装程序会根据服务器环境自动识别执行安装还是升级）。

举例：Linux服务器需要安装G6单组织版则双击运行SeeyonG6-1Install.sh；同理，安装A8+集团版则双击运行SeeyonA8-2Install.sh文件

启动脚本说明：

SeeyonA6-1Install（A6+企业版安装入口文件）

SeeyonA8-1Install（A8+企业版安装入口文件）

SeeyonA8-2Install（A8+集团版安装入口文件）

int1_SeeyonA8-1Install（A8+企业版（英语）安装入口文件）

int1_SeeyonA8-2Install（A8+集团版（英语）安装入口文件）

SeeyonA8TX-1Install（国有资产运营监管系统企业版安装入口文件）

SeeyonA8TX-2Install（国有资产运营监管系统集团版安装入口文件）

SeeyonN6-1Install（内控管理软件单组织安装入口文件）

SeeyonN6-2Install（内控管理软件多组织安装入口文件）

SeeyonG6-1Install（G6单组织安装入口文件）

SeeyonG6-2Install（G6多组织安装入口文件）

SeeyonG6NV5-1Install（G6-N单组织x86+tomcat安装入口文件）

SeeyonG6NV5-2Install（G6-N多组织x86+tomcat安装入口文件）

SeeyonG6SCV5-1Install（数智化会议单组织安装入口文件）

SeeyonG6SCV5-2Install（数智化会议多组织安装入口文件）

SeeyonG6SUV5-1Install（督查督办单组织x86+tomcat安装入口文件）

SeeyonG6SUV5-2Install（督查督办多组织x86+tomcat安装入口文件）

SeeyonS1AgentInstall（独立部署S1Agent安装入口文件）

SeeyonS1AgentInstall_en（独立部署S1Agent（英语）安装入口文件）

注：bat文件为Windows系统下安装脚本，sh文件为Linux系统下安装脚本。

# 加密授权注册准备

产品全新安装或跨版本升级涉及加密狗注册或更新操作，请从商务侧申请与版本相匹配的加密狗授权文件，商务分发的加密授权文件格式一般是xx环境.seeyonkey。

注意：

安装升级过程无需加密授权，但在启动协同服务之前需先完成加密的注册和认证，否则无法启动；
加密信息与应用服务器绑定（如有移机等服务器变更，请联系致远商务更新加密信息）；
加密信息与产品版本绑定；
硬件加密只支持实体机，其他系统请使用软加密文件；
一个加密只支持一个逻辑上的协同服务；
加密支持多网卡服务器；
加密注册与更新程序只支持在Windows系统下运行；
协同集群环境，只需要在主服务器放置加密授权，即授权注册绑定主服务器硬件信息

# 授权注册与更新详细步骤

加密注册与更新程序只支持在Windows系统下运行， 故需要先在Windows电脑注册更新授权，随后上传到Linux系统。

第一步，将加密授权.seeyonkey上传到Windows电脑，检查文件属性，确保不要勾选“只读”：

第二步，Windows电脑同样下载SeeyonInstall.zip并解压，找到安装程序SeeyonInstall下的updateDog文件夹，双击UpdateDog.exe打开客户注册认证工具：

第三步，执行注册与更新操作

注意：

注册与更新涉及访问外网，服务器需与外网保持连接，如服务器无外网访问条件，需要换一台可连外网机器注册，详细操作见后续小节
注意选择对应产品线，G6产品线请选择G6V5
如果是注册更新.seeyonkey，统一选择“2软加密文件”

注册及更新将弹出MAC地址输入框，协同部署在哪台服务器就用哪台服务器的MAC地址。

由于我们需要部署在Linux服务器，故需要获取Linux服务器的MAC地址，尝试通过ip link show之类的命令取服务器的MAC（多MAC建议取协同服务使用的网卡配置），将其拷贝到Windows电脑注册：

查看license信息： 注册更新成功的文件，可以查看硬件加密或软加密文件的License信息：

查看硬件ID： 查看当前服务器的网卡MAC信息

读取狗号： 读取当前硬件加密或软加密文件的编号

绑定数据库： 将硬件加密或加密文件绑定产品数据库，正常产品无需操作，仅特定场景需要

软加密文件使用说明：

安装过程无需加密文件，需要安装升级完成后，访问服务器协同程序目录，将注册后的文件放置到协同程序目录的base/license下（license目录不存在则新建目录）。

再次提醒：不是放置到SeeyonInstall安装程序中

# 无外网操作系统注册认证

对于无外网操作系统，硬件加密（或软加密文件）的注册认证，需要换一台可连外网的windows机器运行安装程序的UpdateDog.exe，注册时弹出的硬件ID，必须更改为部署启动协同的服务器MAC地址。

# 协同服务安装部署

本章节介绍协同服务全新安装部署步骤。

# 安装部署流程概述

协同服务的安装基本流程为：硬件环境准备--->安装操作系统--->安装数据库服务--->安装协同服务--->注册加密--->其他认证--->启动服务--->客户端访问。

# 安装部署详细步骤

再次提醒：安装部署前，先通过命令赋予安装包权限chmod -R 777 【安装包路径】

安装第一歩：SeeyonInstall安装程序目录下，参照readme.txt文件，寻找匹配的产品线程序，通过命令直接执行.sh文件

cd /data/0.SeeyonInstall/
# 本示例为安装部署A8+集团版
./SeeyonA8-2Install.sh

安装程序会进行环境校验，当前服务器环境不满足安装要求会拒绝安装，先将不通过项进行调整后再继续，详细检查项见【启动安装程序之前环境检查项】章节说明。

注意：Linux系统必须安装X11图形化组件，否则无法弹出安装程序UI界面！

安装第二步：开始进行安装。阅读软件许可协议，选择【接受】之后才能选择【下一步】；

安装第三步：选择产品的安装目录，建议安装在空间较大的盘符下，本例安装在/data/Seeyon/A8，选择【下一步】；

安装第四歩：选择数据库类型，并配置数据库连接信息（数据库类型、数据库名称、服务器地址、端口、用户名、密码），选择【下一步】；

注意：

不同产品线支持的数据库类型不同，详见《产品服务器环境准备》手册说明
不同数据库有对应的基线要求，详见《产品服务器环境准备》手册数据库注意事项章节
A6产品线支持选择PostgreSQL数据库，该数据库由安装程序自动安装内置
数据库类型为MySQL，输入数据库名称可以自动创建该数据库，无需手工创建，其余数据库类型需要根据《产品服务器环境准备》手册提前创建数据库

如遇“检测到当前数据库存在性能问题”的提醒，请参考《产品服务器环境准备》手册数据库注意事项章节对数据库进行配置调优，确保数据库在最佳状态后继续安装：

A6+版本安装时，如果选PostgreSQL数据库进行安装，可自定义PostgreSQL数据库服务安装路径，将数据库放置在磁盘空间足够大的盘符下，并且记住这个地址，方便后续维护：

安装第五步：确认安装信息是否正确，选择【下一步】，随后进行自动安装，安装过程会将程序放置到协同安装目录下、向数据库写入初始化SQL、写入注册表等动作：

安装第六步：开始安装，安装完成后，出现账号密码设置界面，请填写初始化管理员账号登录名以及密码：

特别注意： 自9.0版本开始，账号密码设置界面新增了“初始化账号和密码设置”动作， 请务必记住设置的账号和密码 。安装完成后只有此账号可以登录系统，通过登录初始化账号来完成初始组织建立和初始管理员角色分配，分配的管理员作为标准系统中正常使用的管理员，并且初始化账号完成设置退出系统后账号会失效。如是升级安装则原系统中的管理员会无效，同样通过初始化账号重新分配管理员。

安装第七步：初始化安装时，出现【IP访问控制】设置页面，设置是否开启【ip限制】（默认不勾选）。

注意：

开启后，仅ip地址范围内的客户端可访问协同服务。
若需设置，勾选【ip限制】，ip地址范围填写允许访问ip信息。请谨慎操作，避免出现安装后客户端无法访问系统的情况。
无需配置则保持默认不勾选。
仅初始化安装时有此页面，修复和升级无此页面信息。

安装第八步：完成确认页面，点击【完成】，退出安装程序。

# 安装部署后续检查

1、安装程序会向Linux操作系统 /root/.config/seeyoninstall*.info 文件写入产品信息，查看信息是否正常：

2、访问协同服务程序目录\ApacheJetspeed\conf，目录下的SeeyonConfig是运维高频使用工具，确保该工具能打开：

3、安装部署过程日志存放于协同服务程序目录\Logs目录下，如存在异常，可分析日志文件：

4、通过数据库连接工具，检查协同相关数据库表是否正常写入：

# 安装部署后放置加密授权

安装过程无需加密文件，安装升级完成后，将注册后的文件放置到协同服务程序目录的base/license下：

注意：

加密授权需要从商务侧申请并自行注册更新，详细操作步骤见【加密授权注册准备】章节
base/license下要求仅存在一个.seeyonkey文件，如需备份，请将备份文件放置在别处
如未放置加密授权，协同服务将无法启动

# 安装部署后启动协同服务

以上完成后，找到协同程序目录/ApacheJetspeed/bin/startup.sh文件，运行startup.sh启动协同服务：

cd /data/Seeyon/A8/ApacheJetspeed/bin
./startup.sh

通过协同程序目录/ApacheJetspeed/logs/catalina.out日志文件查看服务启动进度：

tail -f ../logs/catalina.out

出现“[xxx]毫秒后服务器启动”字样则表示启动完成：

常见问题：

启动不了，重点检查：加密授权是否放置、数据库是否连接成功
其它启动问题，通过分析ApacheJetspeed\logs\localhost.xxx.log、ApacheJetspeed\logs_sy\ctp.log、ApacheJetspeed\logs_sy\error.log日志文件查明原因

访问协同系统：

启动完成后，使用一台能连接协同服务器的客户端，通过浏览器访问http://协同服务器IP:80，如出现登录页面，则说明服务可用：

首次登录系统：

自9.0版本开始，如使用安装程序自动部署，账号密码设置界面新增了“初始化账号和密码设置”动作， 请务必记住设置的账号和密码 。首次登录系统，只能通过初始化管理员账号密码登录，进行用户和权限分配。

如采用特殊手段将初始化数据ALL-IN-ONE.SQL脚本导入空库并启动，则默认管理员账号/密码为init-admin/123456。

# 安装部署后其它运维说明

如安装部署完成，并且初次能启动成功，则说明程序安装完成。

后续协同服务的配置、调优、日常运维见后续章节专项说明。

# 协同服务修复安装

本章节介绍协同服务修复安装步骤，修复安装即：协同服务已经安装部署，因某些原因导致已安装的环境程序异常（如webapp/seeyon被误删除），此时可以通过修复安装更新完整的程序。修复安装不会修改base\conf配置文件和数据库中的数据。

修复安装详细步骤如下：

修复安装第一步：停止协同所有相关服务

修复安装第二歩：SeeyonInstall安装程序目录下，参照readme.txt文件，寻找匹配的产品线程序，通过 ./Seeyon***Install.sh 命令直接启动程序

修复安装第三歩：阅读软件许可协议，选择【接受】之后才能选择【下一步】

修复安装第四步：安装路径确认。如果当前步骤显示“系统中存在已有的A8服务，将保持原安装路径”的提示，表示当前系统已经安装了协同服务产品，本次将进行升级或修复安装操作，可以进入下一步。

修复安装第五歩：数据库确认。如果是修复安装或升级，此步骤的数据库配置不可修改属于正常现象，确保数据库能连通，点击【下一步】。

修复安装第六步：确认环节。当出现“将进行产品文件修复”提示，则表示本次是修复安装，点击下一步进行安装，等待安装完成，结束安装程序即可。

修复安装第七步：结果检查。安装完成后，可访问协同服务程序目录\Backup文件夹，该文件夹会存放修复安装前的程序文件。

修复安装的日志存放于协同服务程序目录\Logs目录下，如存在异常，可分析日志文件：

访问协同服务程序目录\ApacheJetspeed\conf，其中SeeyonConfig是运维高频使用工具，确保该工具能打开，确保修复安装前的配置未丢失：

检查协同服务程序目录的base/license文件夹，确保.seeyonkey加密授权文件存在（如不存在，则从Backup拷贝修复安装前的授权文件）：

以上确认无误后，找到协同程序目录/ApacheJetspeed/bin/startup.sh文件，运行startup.sh启动协同服务。

# 协同服务目录概览

安装部署协同服务程序后，系统内存在若干目录文件，本章节梳理一份概览供参考：

日常运维重点关注：

A8\base\license 加密授权目录
A8\ApacheJetspeed\bin 启停服务目录
A8\ApacheJetspeed\conf 端口、JVM、数据库、插件配置目录
A8\ApacheJetspeed\logs 中间件日志
A8\ApacheJetspeed\logs_sy 协同自己的日志

A8
├── ApacheJetspeed Tomcat中间件文件
|     └── bin  执行脚本目录
|          └── catalina_custom.bat 执行Java启动时的基础JVM参数配置，Linux下是.sh
|          └── startup.bat 启动服务命令，Linux下是.sh
|          └── shutdown.bat 停止服务命令，Linux下是.sh
|     └── conf
|          └── SeeyonConfig.cmd 可视化应用配置器，配置端口、JVM、数据库连接、插件属性信息
|          └── server.xml  Tomcat中间件的server.xml
|          └── web.xml     Tomcat中间件的web.xml
|     └── lib 中间件相关jar（协同一些平台级jar也在其中）
|     └── logs  中间件日志
|          └── localhost.年-月-日.log 中间件错误日志
|          └── catalina.年-月-日.log 中间件启动日志
|     └── logs_sy  系统应用日志（仅陈列关键日志）
|          └── ctp.log V5常规日志，很多常规模块的日志都在这里
|          └── spring.log V5启动时Spring错误日志
|          └── cap.log CAP应用日志，CAP4的错误、日志行为日志都在这里
|          └── capability.log 用户访问记录及每条访问耗时
|          └── error.log 异常堆栈记录日志
|          └── 年-月-日 *日志归档文件夹，每10M生成一份日志到当天文件夹里
|     └── webapps
|          └── ROOT     负责在用户不输入/seeyon访问路径的时候也能跳转到/seeyon、另外该应用起到一定防爬作用
|          └── sportal  负责用户页面静态化：解决一些公告、新闻信息等在没有登录前也能浏览这些信息
|          └── static   负责转发部分静态资源
|          └── seeyon   应用程序主入口
|               └── apps_res  静态资源目录
|               └── m3files   M3程序资源目录
|               └── m3        移动Html5程序目录（微协同）        
|               └── WEB-INF
|                     └── cfgHome 
|                           └── base
|                                 └── plugin  代码插件配置目录
|                                      └── demo
|                                            └── i18n 国际化目录
|                                            └── spring Spring注册信息目录
|                                            └── pluginCfg.xml 插件定义信息
|                                            └── pluginProperties.xml 插件配置信息，显示于Seeyonconfig
|                     └── classes 常识：当前目录下可以放置.class文件，加载优先级高于lib下同名.class
|                     └── jsp 此目录下放置所有JSP文件，放于WEB-INF下的jsp不可被直接访问，间接提升了安全性
|                     └── lib 应用程序jar
|                          └── seeyon-apps-api.jar 以seeyon开头的都是V5自己的jar
|                          └── seeyon-*.jar
|                     └── web.xml 所有Filter、Listener
|     └── work  中间件编译的JSP文件存放位置
├── Backup 每次升级或覆盖安装都会备份上次的文件，方便还原找回
├── base 配置文件、Licence、默认附件目录
|     └── upload 系统安装后，默认的附件目录，即用户上传的文件存放处
|     └── conf 通过Seeyonconfig配置的数据库、插件参数信息
|     └── license 存放加密授权文件目录
├── jdk 标准JDK文件
|     └── bin
|          └── jstack 导出线程堆栈命令，开发人员必备技能
|          └── jmap 导出内存占用命令，开发人员必备技能
├── Logs 每次升级或覆盖安装过程日志文件存放路径
|     └── all.log *升级操作核心日志文件，记录了升级程序运行全过程，含错误信息
├── OfficeTrans 默认预置的Office在线转换服务
|     └── startup.bat *启动转换服务快捷方式，Linux下是startup.sh
├── S1 默认预置的S1 Agent端服务，Win下默认自启动
└── Uninstall_A8 顾名思义，注意卸载A8前需要先卸载S1

# 协同服务日常运维配置

# 协同服务启动停止

系统后台发送停服通知并自动停服：

登录系统管理与后台，进入 [系统维护] -> [服务停止通知]，输入停服通知内容并设置预留时间，勾选 [时间到后自动关闭服务]。

服务器直接停服：

使用协同服务程序目录/ApacheJetspeed/bin/shutdown.sh停止协同服务

cd /data/Seeyon/A8/ApacheJetspeed/bin
./shutdown.sh

如无法停止，通过kill命令停止协同服务：

# ps命令查询seeyon服务进程ID
ps -ef | grep java
# kill对应进程ID
kill -9 进程ID

服务器启动：

使用协同服务程序目录/ApacheJetspeed/bin/startup.sh启动协同服：

cd 协同服务程序目录/ApacheJetspeed/bin/
./startup.sh

通过协同程序目录/ApacheJetspeed/logs/catalina.out日志文件查看服务启动进度：

tail -f ../logs/catalina.out

启动前，需要检查协同服务是否存活，如存活需要停止服务再启动

# 协同服务卸载

通过协同服务程序目录/Uninstall_A8/uninstall.bat执行卸载操作。

卸载协同服务前，请确保：协同相关服务已经停止、OfficeTrans和S1相关服务已经卸载。

# 移动端访问地址说明

移动端M3 App可直接访问协同服务，端口同pc端访问端口。

若需要分离部署移动服务（不同端口管理），可以安装移动分离部署服务（SeeyonMobile）或部署Nginx进行单独代理管理。

# 协同服务定期备份

为确保程序和数据安全，建议做好定期灾备，在应对紧急问题（如木马、误删除）时方便做数据回滚恢复。

如服务器采用虚拟管理，可定期进行快照备份。

如服务器采用实体机，可定期对关键目录做备份，备份内容至少包含：

中间件和程序文件：ApacheJetspeed下webapps、bin、conf、lib全部备份
配置文件：ApacheJetspeed同级目录base全部备份
资源文件、附件文件：路径可配置，具体可参考《修改文件存储地址》章节，由于该目录文件占用磁盘空间大，客户需要根据项目实际情况做备份策略
数据库数据：根据不同数据库自行做定期备份
备份注册表：Linux服务器协同信息注册于 /root/.config/seeyoninstall*.info

# 协同服务补丁包管理

协同系统出现功能异常，涉及打BUG补丁包；如存在需求开发，也涉及定制开发补丁包。

平台支持基于S1服务进行补丁安装和卸载，详细打补丁操作见S1用户操作手册：

协同支持通过S1可视化的方式进行补丁包的上传、下载、安装和卸载。
补丁包安装时会自动备份程序，并记录操作日志。
内网用户可以通过离线安装功能上传补丁包。
联网用户可以通过在线下载补丁包功能进行安装。

# 协同服务日志管理

当系统出现故障，需要进行日志分析，可访问如下路径，根据日志分析问题：

协同程序目录\ApacheJetspeed\logs 中间件日志
协同程序目录\ApacheJetspeed\logs_sy 协同全部的日志

A8
├── ApacheJetspeed
|     └── logs  中间件日志
|          └── localhost.年-月-日.log 中间件错误日志
|          └── catalina.年-月-日.log 中间件启动日志
|     └── logs_sy  系统应用日志（仅陈列关键日志）
|          └── ctp.log V5常规日志，很多常规模块的日志都在这里
|          └── spring.log V5启动时Spring错误日志
|          └── cap.log CAP应用日志，CAP4的错误、日志行为日志都在这里
|          └── capability.log 用户访问记录及每条访问耗时
|          └── error.log 异常堆栈记录日志
|          └── 年-月-日 *日志归档文件夹，每10M生成一份日志到当天文件夹里

# 协同服务系统监控

协同服务提供了在线化的服务状态监控能力，使用系统管理员账号切换到系统管理员门户，访问系统维护-系统监控菜单，产品提供了如下可视化监控能力：

PC、M3、IM多端近期在线人数、最高在线人数
协同服务器操作系统、内存信息
JVM参数配置
JVM各区块内存实时占用情况、峰值占用情况
JVM GC统计
数据库连接池总体信息，实时连接信息JDBC Dump
JVM实时线程信息Thread Dump（等同jstack）
插件明细信息Properties Dump

# SeeyonConfig工具使用说明

访问协同服务程序目录\ApacheJetspeed\conf，Linux系统执行SeeyonConfig.sh可打开协同系统配置工具：

# 服务器设置配置说明

服务默认单机，如需部署集群，涉及一系列扩展服务部署操作，参考集群部署手册操作
服务默认HTTP协议，如需启用HTTPS，涉及证书等一系列配置操作，参考HTTPS配置章节
HTTP端口默认80，可按需修改
总线程数默认4096、最小空闲100，如无研发指导不要做调整
集群/双击配置部分，仅集群场景需要，参考集群部署手册操作
JVM属性，根据客户在线人数及服务器情况做调整，参考JVM调整章节
设置保存后，需要重启协同服务才能生效

# 数据库连接配置说明

数据库类型：不要随意调整
数据库地址：仅数据库做了调整时再对应调整（如地址端口变更、SSL开启）
用户名、密码：仅数据库做了调整时再对应调整
连接数：生产环境保持最小50最大500的配置，测试环境和个人环境可酌情降低
连接泄漏监控：如项目遇到连接泄漏问题，可在研发建议下勾选
监控过滤器：不做调整
连接生产环境、共享加密信息：用于同一网段，测试环境复用生产加密授权场景，参考共享加密信息章节
设置保存后，需要重启协同服务才能生效

# 协同服务端口设置

http访问端口默认为80，可以通过运行【协同系统配置工具】来更改。如下图。

如客户有Nginx之类的前置代理，客户端均通过代理服务访问系统，则协同本身端口无需调整，端口管理均在代理服务上。

无法唤起协同系统配置工具的环境，可通过ApacheJetspeed\conf\server.xml文件修改端口信息，该配置基于Tomcat中间件标准生成。

# 协同服务Tomcat设置

产品安装时已经默认内置Tomcat中间件，并且将线程配置调整为最优，正常情况不涉及Tomcat配置修改。

如项目上存在Tomcat中间件安全基线要求，可根据情况修改ApacheJetspeed\conf\server.xml等文件，注意做好修改前备份。

# 协同服务JVM调整

打开【协同系统配置工具】：JVM属性

协同服务基于Java语言开发，涉及JVM调优，尤其是内存申请。不同在线用户数，对内存要求不同：

重点调整-Xmx参数，-Xmx8g表示JVM最多申请8G堆内存
JVM属性-Xmx正常情况只能申请服务器总内存的50%~70%，其余内存留给服务器其它软件
以下表为例，客户在线人数1000左右，单机部署，服务器物理内存48G，则将JVM属性-Xmx8g修改为-Xmx24g
以下表为例，客户在线人数3000左右，3台集群部署，每台服务器物理内存64G，则需要在每台服务器上将JVM属性-Xmx8g修改为-Xmx32g

在线人数	推荐模式	X86协同服务器配置参考	JVM配置建议
200以下	单机	CPU8核以上/内存16G以上/硬盘320G以上	-Xmx8g
200~500	单机	CPU8核以上/内存32G以上/硬盘320G以上	-Xmx16g
500~1000	单机	CPU16核以上/内存48G以上/硬盘320G以上	-Xmx24g
1000~2000	1主1从	CPU16核以上/内存64G以上/硬盘320G以上	-Xmx32g
2000~3000	1主2从	CPU16核以上/内存64G以上/硬盘320G以上	-Xmx32g
3000~5000	1主2从	CPU16核以上/内存96G以上/硬盘320G以上	-Xmx48g
5000~10000	1主3从	CPU24核以上/内存128G以上/硬盘320G以上	-Xmx64g

如下是JVM调整后的示例：

JVM调优配置存放于【协同服务程序目录】ApacheJetspeed\bin\catalina_custom.bat（Linux系统对应catalina_custom.sh），无图形系统建议在一台图形系统下进行配置修改，将修改后的文件覆盖到无图形系统对应文件。

注意：如使用Oracle 12c以及以上版本数据库，需在协同服务部署后的ApacheJetspeed/bin/catalina_custom.bat脚本中增加以下两项jvm参数：

-Doracle.jdbc.useNio=false -Doracle.jdbc.javaNetNio=false

# 数据库连接池调整

打开【协同系统配置工具】-【数据库连接】：

生产环境保持最小50最大500的配置，测试环境和个人环境可酌情降低（如最小10，最大100）。

如涉及数据库连接池微调，可在研发指导意见下，修改数据库连接配置参数，连接池配置文件位于【产品安装目录】/base/conf/datasourceCtp.propertie

# 协同服务加密共享

正式环境加密狗信息支持共享，支持多套测试环境复用正式环境授权信息。

注意：

复用授权的测试环境继承正式环境全部插件授权信息
复用授权的测试环境限制5并发数
复用授权的测试环境服务器需要能网络连通生产环境协同服务
需要正式环境处于启动状态，测试环境才能读取到授权
正式环境需要配置IP白名单：设置哪些测试环境IP能共享加密
测试环境需要配置正式环境的HTTP访问地址，确保在启动时连接到正式环境获取授权信息
生产环境配置信任IP后，重启协同服务生效
加密共享数据存放于【协同服务程序目录】\base\conf\env.properties，无图形系统建议在一台图形系统下进行配置修改，将修改后的文件覆盖到无图形系统对应文件

正式环境配置信任的测试环境IP：

正式环境打开SeeyonConfig协同系统配置工具，切换到“数据库连接”页签，随后在“共享加密信息”页签中录入复用授权的测试环境IP地址，保存重启协同服务生效。格式如：127.0.0.1,localhost,192.168.188.138,192.168.188.135

测试环境配置生产访问地址：

复用授权的测试环境打开SeeyonConfig协同系统配置工具，切换到“数据库连接”页签，随后在“连接生产环境”页签中录入生产环境地址，并且勾选“设置为测试环境”。保存，启动协同服务时读取生产授权信息。

# 系统/插件参数设置配置说明

打开【协同系统配置工具】-【系统参数设置】或【插件参数设置】页签：

系统通用配置、插件个性化配置可在此处设置，正常情况不要随意调整，需根据对应手册按需进行设置
设置保存后，需要重启协同服务才能生效
系统参数设置数据存放于协同程序目录\base\conf\systemCtp.properties，无图形系统建议在一台图形系统下进行配置修改，将修改后的文件覆盖到无图形系统对应文件
插件参数设置数据存放于协同程序目录\base\conf\plugin.properties，无图形系统建议在一台图形系统下进行配置修改，将修改后的文件覆盖到无图形系统对应文件

# 协同服务OBS配置（选配）

新版本支持华为OBS对象存储，附件文件可以存储到OBS对象存储服务中，对象存储不是必须配置，仅项目有对象存储需求再配置。

注意：

仅支持华为OBS对象存储，其余OSS需要定制开发
不支持将历史附件迁移至OBS，只支持新部署使用或者新附件存入OBS
OBS服务需要由客户专业团队建设
OBS模式已按照插件方式开发，需要在加密狗中授权OBS模式，当前配置才会生效

打开【协同系统配置工具】-【OBS配置】页签，对于使用OBS的环境，需配置OBS相关参数：

开启远程对象存储：默认false不开启，如明确需要OBS对象存储则将其设置为true启用

Access Key：对象存储的Access Key，由客户提供

Security Key：对象存储的Security Key，由客户提供

URL(endPoint）：对象存储的URL，由客户提供

桶名：对象存储的桶名，由客户提供

路径：原本地文件存储的哪些目录需要OBS对象存储，多个路径由,逗号分隔

系统在进行上传、下载或读取文件目录时，如果文件全路径中包含如下路径，就会使用OBS对象存储，否则只会使用本地存储

OBS配置数据存放于协同程序目录\base\conf\obs.properties，无图形系统建议在一台图形系统下进行配置修改，将修改后的文件覆盖到无图形系统对应文件。

# 修改文件存储地址

协同服务单机默认采用本地磁盘存储附件文件和资源配置文件，如服务器磁盘空间不足或涉及协同集群部署，则存储修改附件存储路径和资源文件配置路径的需求。

# 修改公共资源目录resources

公共资源目录存储门户、云联、cap等应用的配置和资源文件，默认存放于协同程序目录\base\resources下。

修改公共资源目录，可运行SeeyonConfig，在"系统参数设置"页签，找到"ctp.public.folder"选项并修改：

# 修改附件目录upload

附件目录存储用户上传的所有业务文件，默认存放于协同程序目录\base\upload下。

修改附件目录，需要登录协同系统，使用系统管理员账号进行配置：切换到系统管理员门户，在系统管理界面中，找到 [系统分区管理]进行新增或修改附件分区路径：

配置内容包括分区名称、分区路径、分区状态、发布时间、截止时间和全文检索网络映射路径
分区名称：自定义
分区路径：设置为新的附件目录，路径支持本地磁盘目录、Linux系统NFS协议挂载、Windows共享文件夹+SMB 协议挂载
分区状态：选择分区的状态（启用/停用）
发布时间：设置分区的启用时间
截止时间：设置分区的停用时间，只有附件时间在【发布~截止时间之间】的附件才从本分区路径上传、下载
全文检索网络映射路径：全文检索服务器挂载路径

如无法进入系统管理员后台，可以由DBA进入协同数据库查看、新增、修改附件配置：

-- 系统分区管理表
select * from ctp_partition;

# PostgreSQL数据库启动停止

启动PostgreSQL： 针对A6使用程序内置的PostgreSQL客户，Linux下执行PG安装路径/pgsql13.3/bin下的zz_start.sh启动脚本：

cd PG安装路径/pgsql13.3/bin
# 启动pg
./zz_start.sh

停止PostgreSQL： 针对A6使用程序内置的PostgreSQL客户，Linux下执行PG安装路径/pgsql13.3/bin下的zz_shutdown.sh停止脚本：

cd PG安装路径/pgsql13.3/bin
# 停止pg
./zz_shutdown.sh

# 部署配置Web服务

Web服务可以为协同系统的单机环境提供Web访问，为协同系统的集群环境提供Web访问以及负载均衡。

协同系统的集群要求对应的web服务在做负载均衡时支持会话保持机制。

会话保持机制的意义在于，确保将来自相同客户端的请求，转发至后端相同的服务器进行处理。换句话说，就是将客户端与服务器之间建立的多个连接，都发送到相同的服务器进行处理。这种机制，可以识别客户端与服务器之间交互过程的关联性，在负载均衡的同时，保证一系列相关联的访问请求分配到同一台服务器上。

依据实际情况，可自由选择Nginx（推荐）、F5或其他web服务软硬件设施。

以下章节对web服务部署及配置时的注意事项进行说明。

# 部署及配置Nginx

Nginx是一款高性能的开源 Web 服务器和反向代理服务器，同时也可以用作邮件代理和负载均衡器。自其发布以来，Nginx 已经成为全球最流行的 Web 服务器之一，广泛应用于各种规模的网站和应用程序中。

Nginx在生产应用中能实现：

反向代理：让客户端不再直连协同服务器，而是客户端连接Nginx，由Nginx代理到协同服务，提高可管理性
负载均衡：当前协同集群部署时，作为负载均衡服务，分配多个应用服务器之间的流量
管理https：当系统服务需要https访问时，证书和配置可由Nginx集中管理，管理方便、配置简单
网关：利用Nginx代理能力，将其定位为服务群的网关，服务与服务间通过Nginx连接

协同集群环境需要用到nginx-sticky-module模块，此模块目前仅支持Linux系统，因此用Nginx做为集群模式的web服务时需要Linux操作系统的服务器。

用户可自行下载最新稳定版本自主安装配置，详见以下章节。

# Nginx部署概要拓扑图

场景一：部署一套Nginx，实现常规反向代理或负载均衡：

场景二：部署多套Nginx，实现PC、移动端各自管理：

场景三：部署一套Nginx，将其作为统一网关，不同服务器之间有网络互通要求时，全部通过Nginx搭桥，极大提升了维护便捷性：

# Linux安装Nginx

协同集群依赖Sticky模块，故需要下载Nginx二进制文件及相关模块执行编译，可以参照Nginx相关离线文档部署，或参考在线文档部署：《Nginx源码编译安装》 https://open.seeyoncloud.com/#/faq/vuepressFile/v1/share?url=Z2ptZkplPjI6Njk=

# Nginx反向代理配置

Nginx反向代理配置在Windows和Linux下均相同，可以参照Nginx相关离线文档配置，或参考在线文档格式配置：《Nginx反向代理和负载均衡（http）》 https://open.seeyoncloud.com/#/faq/vuepressFile/v1/share?url=Z2ptZkplPjIzMzQ=

# Nginx启用https（ssl配置）

如协同服务或其它服务需要开启https协议，建议全部通过Nginx进行https配置管理，此方案下，协同相关服务不用做任何改动调整。

启用https需要购买ca证书，在购买了证书后，将证书放置到Nginx目录下，通过ssl相关配置即可启用https协议。

Nginx https配置在Windows和Linux下均相同，可以参照Nginx相关离线文档配置，或参考在线文档格式配置：《Nginx反向代理协同配置（https）》 https://open.seeyoncloud.com/#/faq/vuepressFile/v1/share?url=Z2ptZkplPjM0NzM=

http重定向https：

用户早期采用http访问系统，如http://example.com/seeyon，后期为了安全性，要求https访问系统，如https://example.com/seeyon。

用户可能遇到不知情https地址的情况下，还是通过http访问系统，此时可以通过http自动重定向https方案来确保安全性。

相关配置解决方案同样可参考开启ssl配置的手册。

注意：自V9.0SP1版本开始，不用在协同服务中做任何https配置，协同服务保持默认的http，所有https交由Nginx管理即可。

# Nginx负载均衡配置（协同集群）

协同集群环境需要用到nginx-sticky-module模块，此模块目前仅支持Linux系统，因此用Nginx做为集群模式的web服务时需要Linux操作系统的服务器。

故，即使协同服务集群是部署在Windows Server，但Nginx也必须用Linux部署，安装Nginx时需要装载nginx-sticky-module模块。

基于Linux环境的Nginx安装部署、负载均衡配置可见Nginx相关离线文档，或参考在线文档操作《Nginx相关手册》 https://open.seeyoncloud.com/#/faq/vuepressFile/v1/share?url=Z2ptZkplPjMzNzE=

# Nginx健康检测模块

Nginx 的健康检测模块（如 ngx_http_stub_status_module 或第三方模块 nginx-upstream-check-module）主要用于监控后端服务器的健康状态，确保高可用性和负载均衡的可靠性。

如果项目上需要健康检查，可见Nginx相关离线文档，或参考在线文档操作《健康检测模块》 https://open.seeyoncloud.com/#/faq/vuepressFile/v1/share?url=Z2ptZkplPjI5ODg=

# 负载均衡F5配置说明

协同系统的集群结构需要web服务做负载均衡时会话保持（或会话粘滞），会话保持机制的意义在于，确保将来自相同客户端的请求，转发至后端相同的服务器进行处理。

因此F5需采用符合会话保持原理的负载均衡策略才可保证协同集群系统的正常运行。

# 致远服务S1

S1支持协同及相关服务的服务启停、参数配置、运维监控及相关运维工具，产品安装后预置S1程序。

详细的说明见S1的安装维护手册和用户操作手册。

# 在线预览服务OfficeTrans

# 在线预览概要说明

协同服务安装时预置安装OfficeTrans服务。若需要将OfficeTrans分离部署可通过以下方式进行。

# 在线预览安装配置

在协同服务安装后，预置安装的OfficeTrans服务，位于产品安装目录下OfficeTrans文件夹。

将OfficeTrans、jdk、S1文件夹拷贝至分离部署的服务器。

注册信息导出，并导入到分离部署服务器。注册信息如下：

Linux服务器协同信息注册于 /root/.config/目录下（Officetrans关键字）

# 在线预览参数配置

通过S1进行在线预览参数配置，以及服务启停。

office1

office2

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的服务来停止。

# 部署配置其它扩展服务

协同应用服务之外，可独立部署的服务、最低建议配置（根据实际业务情况，可进行合并或优化调整）及服务用途见以下清单：

# 全文检索服务

全文检索服务所需配置、部署维护手册详见《全文检索部署维护手册》，或参考在线化文档《全文检索部署手册X86》 https://open.seeyoncloud.com/#/faq/vuepressFile/v1/share?url=Z2ptZkplPjMzNjU=

# 5.4 音视频服务（可选）

音视频服务所需配置、部署维护手册详见《音视频部署维护手册》，或参考在线化文档《音视频部署手册》 https://open.seeyoncloud.com/#/faq/vuepressFile/v1/share?url=Z2ptZkplPjMxMjM=

# 5.5 文件下载服务（可选）

# 5.5.1 概要说明

使用与协同应用服务版本一致的文件下载服务；
文件下载服务支持Windows、Linux系统；
需在系统管理员用户"系统分区管理"中，配置文件下载微服务所在服务器上分区对应的路径。

# 5.5.2 安装配置

# 5.5.2.1 安装

双击SeeyonFileServiceInstall.bat运行安装程序；
开始安装，选择安装路径，如：D:\fileservice，依次点击下一步，完成安装；

# 5.5.2.2 配置

使用系统管理员登录协同系统，进入"文件下载服务配置"界面，查看服务的注册码及服务注册状态。

若已安装S1，可在S1的"服务启停配置"中，进行文件下载服务配置：

server.port：文件下载微服务的端口，默认8085，如果是分离部署需要开放端口让协同服务和客户端可以访问。

server.ip：文件下载微服务对协同服务及客户端的 ip 地址，需要设置实际ip，如10.5.5.160，或者内外网统一域名。

a8.server.url：协同服务的访问地址，注意带应用上下文/seeyon。

global.authorizedIps：信任的ip地址，填写协同服务的ip地址。

global.maxDownloadNum：同时下载的最大连接数。