# 致远协同管理软件安装维护手册
北京致远互联软件股份有限公司
2022年03月
前言
本手册对V8.1SP1版本协同管理系统的安装及维护相关事宜进行说明。
本版本手册不适用于早期版本的协同产品。若您正在使用协同系统的早期版本，请参阅对应版本相关手册（如V3.50、V3.20、V3.0版本）。
如对安装维护手册中相关问题存在疑问，请与致远互联的客户服务人员联系。
# 1 协同服务环境要求
# 1.1 客户端环境要求
# 1.1.1 客户端硬件配置
| 配件 | 最低配置 | 推荐配置 |
|---|---|---|
| CPU | 英特尔® 奔腾®4 3.0GHz以上 | 英特尔® 奔腾®双核 3.0GHz；Intel core双核3.0GHz；AMD 64位3.0GHz |
| 内存 | >=4G Bytes | >=8G Bytes |
| 显示器分辨率 | 1280以上 | 1920*1080 |
| 网卡 | 100M | 100M |
# 1.1.2 客户端软件需求
| 版本 | 备注 | |
|---|---|---|
| Windows操作系统 | Windows 7~11 | 无 |
| 浏览器 | IE8~11（推荐IE9以上版本）；Edge；FireFox4以上版本；Safari4以上版本（MAC系统）；Chrome12以上版本；360浏览器（极速、安全） | 如果是64位系统，需要使用32位兼容浏览器（辅助程序不支持64位浏览器）； |
| Microsoft Office | Office2003~2016/2019 | 需要Office插件 |
| WPS Office | WPS2009~2016/2019专业版 | 需要Office插件 |
说明：
非IE浏览器（包含360极速浏览器）以下情况不支持：登录页辅助安装程序、表单签章。
Office插件/电子签章：Office插件及电子签章支持的环境，请参考《金格插件适配环境要求》。
注：所有的插件都不要安装在中文目录下，特别是office插件不能安装到中文目录下。
- 应用定制平台（cap4应用）：
前端用户（使用应用）： IE10及以上、 chrome、 safari、 360（兼容IE10及以上、极速）、firefox
后台设计师（制作应用）：IE11及以上、chrome、 safari
Windows XP前端用户可使用chrome49 访问应用定制平台应用
# 1.2 网络环境要求
客户端：
| 广域网接入带宽（bps） | 局域网接入带宽（bps） | |
|---|---|---|
| 最低带宽 | 5M | 50M |
| 推荐带宽 | 10M | 100M |
| 注：带宽要求与上传、下载附件大小、音视频流量有密切关系，以上参数仅针对协同管理软件正常使用做参考。 |
# 2 协同服务安装启动配置
# 2.1 安装流程概述
协同服务的安装基本流程为：硬件环境准备--->安装操作系统--->安装数据库服务--->安装协同服务--->注册加密--->其他认证--->启动服务--->客户端访问。
以下对操作系统、数据库服务等相关流程中的注意事项进行说明。
# 2.2 操作系统准备
# 2.2.1 Windows环境安装准备
为了方便启动，协同安装时，将注册一些Windows服务项（一般为Seeyon**Service、SeeyonOfficeTransSvr等），将涉及到服务项、注册表的修改。请遇到安全软件或操作系统提示时，选择允许修改，或在协同安装前先暂停安全软件（如360安全卫士、金山等）。
# 2.3 协同服务安装
# 2.3.1 注意事项
安装前，请先设置操作系统时区。协同应用服务器时区应与数据库服务器时区一致。此时区尽量与协同大部分用户所在时区保持一致。协同应用服务器时区的变化，将导致系统提示类的数据异常。
协同服务安装程序入口文件说明：
| 序号 | 安装程序文件 | 说明 |
|---|---|---|
| 1 | SeeyonA6-1Install | A6+企业版安装入口文件 |
| 2 | SeeyonA8-1Install | A8+企业版安装入口文件 |
| 3 | SeeyonA8-2Install | A8+集团版安装入口文件 |
| 4 | intl_SeeyonA8-1Install | A8+企业版（英语）安装入口文件 |
| 5 | intl_SeeyonA8-2Install | A8+集团版（英语）安装入口文件 |
| 6 | SeeyonG6-1Install | G6单组织安装入口文件 |
| 7 | SeeyonG6-2Install | G6多组织安装入口文件 |
| 8 | SeeyonG6NV5-1Install | G6-N单组织x86端安装入口文件 |
| 9 | SeeyonG6NV5-2Install | G6-N多组织x86端安装入口文件 |
| 10 | SeeyonG6SUV5-1Install | 督查督办单组织安装入口文件 |
| 11 | SeeyonG6SUV5-2Install | 督查督办多组织安装入口文件 |
| 12 | SeeyonS1Install | 独立部署S1/BS安装入口文件 |
| 13 | SeeyonS1Install_en | 独立部署S1/BS（英语）安装入口文件 |
# 2.3.2 安装步骤
安装步骤：
第一歩：双击安装程序Seeyon**Install.bat文件(**根据购买的产品线进行选择)。
第二步：开始进行安装。选择【我接受该许可协议条款】,选择【下一步】；
第三步：选择软件的安装路径，选择【下一步】；
第四歩：选择数据库类型，并配置数据库连接信息（数据库类型、数据库名称、服务器地址、端口、用户名、密码），选择【下一步】；
第四步注意事项：
1、数据库类型为MySQL，输入数据库名称可以自动创建该数据库，无需手工创建，其余数据库类型需要根据手册内容提前创建数据库；
2、数据库类型为MySQL，名称禁止使用系统数据库关键字，比如mysql、temp，推荐字母开头，纯字母或者字母加数字的数据库名称，如seeyonoa、seeyondb、oav8x；
3、数据库类型为Oracle，用户名禁止使用sys、system等系统数据库用户名。
第五步：确认安装信息是否正确，选择【下一步】；
第六步：开始安装，安装完成后，出现账号密码设置界面，请填写初始化管理员账号登录名以及密码（服务启动后请使用填写的密码登录进行系统初始化）；
说明：8.1版本在安装过程中会设置一个初始化账号和密码，安装完成后只有此账号可以登录系统，通过登录初始化账号来完成初始组织建立和初始管理员角色分配，分配的管理员作为标准系统中正常使用的管理员，并且初始化账号完成设置退出系统后账号会失效。（如是升级安装则原系统中的管理员会无效，同样通过初始化账号重新分配管理员）；
- 第七步：初始化安装时，出现【ip限制】设置页面，确认是否开启【ip限制】（默认不勾选）。开启后，仅ip地址范围内的机器可访问协同服务。
若需设置，勾选【ip限制】，ip地址范围填写允许访问ip信息。
无需配置则取消勾选。
注意：仅初始化安装时有此页面，修复和升级无此页面信息。
- 第八步：点击【完成】，退出安装程序。
# 2.3.3转换服务多网卡jvm配置调整
在多网卡服务器时，需要做以下配置：
编辑OfficeTrans服务目录的startup.bat，在JAVA_OPTS值的最后增加（或者修改绑定服务的IP地址）：-Djava.rmi.server.hostname=IP地址
Windows示例：
保存修改。
# 2.4 加密注册和认证
# 2.4.1 说明
在启动协同之前需先完成加密的注册和认证；
加密信息与应用服务器绑定（如有移机等服务器变更，请联系致远商务更新加密信息）；
加密信息与产品版本绑定；
硬件加密只支持Windows、Linux系统，其他系统请使用软加密文件；
一个加密只支持一个逻辑上的协同服务；
加密支持多网卡服务器；
加密注册与更新程序只支持在Windows系统下运行；
# 2.4.2 步骤
运行注册认证程序
插入硬件加密或将软加密文件拷贝至当前服务器；
服务器需与外网保持连接；
运行安装程序updateDog中的UpdateDog.exe；
选择对应产品线；G6产品线请选择G6V5；
图2.2.2-1注册认证工具
注册与更新
致远商务提供硬件加密及软加密文件；
注册及更新必须连接外网；
注册及更新在使用时将弹出MAC地址输入框，支持绑定其他服务器MAC地址（如：Linux系统服务器、无法连接外网服务器）；
图2.2.2-2加密注册与更新
- 下载Office认证
下载Office插件的认证信息，需要验证硬件加密或软加密文件；
- 查看License信息
查看硬件加密或软加密文件的License信息；
图2.2.2-3查看License信息
- 查看硬件ID
查看当前服务器的网卡MAC信息；
- 读取狗号
读取当前硬件加密或软加密文件的编号；
绑定数据库
将硬件加密或加密文件绑定产品数据库（A6、A8产品不需要绑定）；
# 2.4.3 软加密文件使用说明
对于使用软加密文件的情况，在完成了软加密文件（一般为.seeyonkey后缀的文件）的注册后，请将注册后的软加密文件拷贝至协同安装目录的base/license下（license目录不存在则新建目录）。
| 序号 | 软加密文件名（区分大小写） | 版本 |
|---|---|---|
| 1 | a6v5.seeyonkey | A6+企业版 |
| 2 | a8v5.seeyonkey | A8+企业版/A8+集团版 |
| 3 | g6v5.seeyonkey | G6+单组织版/G6+多组织版 |
| 4 | a8nv5.seeyonkey | A8-N企业版/A8-N集团版 |
| 5 | g6nv5.seeyonkey | G6-N单组织版/G6-N多组织版 |
| 6 | g6suv5.seeyonkey | 督查督办单组织版/督查督办多组织版 |
# 2.4.4 无外网操作系统注册认证
对于无外网操作系统，硬件加密（或软加密文件）的注册认证，在可访问外网的Windows平台下运行安装程序的UpdateDog.exe，注册时填写需绑定的无外网操作系统的MAC地址。
# 2.5 转换服务认证
自V7.0SP1版本产品加密狗中已合并OfficeTrans认证，无需再单独下载。
# 2.6 二维码认证
将二维码插件认证文件（iWebBarcode.lic文件）拷贝至协同服务的以下位置：base\license\iWebBarcode.lic
# 2.7 报表工具（帆软）认证
从致远商务获取报表工具（帆软）的认证文件（FineReport.lic），将认证文件拷贝至协同服务的以下位置：ApacheJetspeed/webapps/seeyonreport/WEB-INF/resource下。
# 2.8 服务端配置
协同服务配置可通过S1进行配置（详见S1手册），也可使用协同服务目录的配置工具进行配置（要求图形界面）。
# 2.8.1 协同系统配置工具
启动工具方式：
Windows：【协同主目录】\ApacheJetspeed\conf\SeeyonConfig.cmd
- 界面示例：
# 2.8.2 服务访问端口设置
http访问端口默认为80，可以通过运行【协同系统配置工具】来更改。如下图。
# 2.8.3 协同服务Tomcat调优
打开【协同系统配置工具】：
根据需要，选择"单机"、"集群/双机"。集群配置详见集群部署手册。
总线程数4096，最小空闲数100。无特殊要求无需修改。
# 2.8.4 协同服务JVM调优
打开【协同系统配置工具】：JVM属性
对应不同并发在线用户数的JVM配置标准：
| 在线 | 系统 | 物理内存 | -Xmx |
|---|---|---|---|
| 200以下 | Windows X64 Linux X64 | 16G+ | 8G |
| 200-500 | Windows X64 Linux X64 | 32G+ | 16G |
| 500-1000 | Windows X64 Linux X64 | 48G+ | 32G |
| 1000-2000 | 推荐Linux X64 | 64G+ | 48G |
| 2000-3000 | 推荐Linux X64 | 96G+ | 64G |
| 3000以上集群部署 | 推荐Linux X64 | 128G+ | 64G |
注意：针对Oracle数据库12c以及以上版本，需在协同服务部署后的ApacheJetspeed/bin/ catalina_custom.bat脚本中增加以下两项jvm参数：
-Doracle.jdbc.useNio=false -Doracle.jdbc.javaNetNio=false
# 2.8.5 连接池配置
打开【协同系统配置工具】：
连接数最小、最大值的参考标准：
| 并发 | 最小 | 最大 |
|---|---|---|
| 200以下 | 50 | 500 |
| 200-500 | 50 | 500 |
| 500-1000 | 50 | 500 |
| 1000-2000 | 50 | 500 |
| 2000-3000 | 50 | 500 |
| 3000以上 | 50 | 500 |
说明：需要同步修改数据库连接数参数。
连接池配置文件位于【产品安装目录】/base/conf/datasourceCtp.properties
V8.1版本新增以下优化内容，无特殊要求无需修改。
# 连接池1秒的新建连接数量，单位是连接个数。达到该数量触发日志跟踪
ctpDataSource.rateLimit=300
# 连接池日志debug级别是否开启，true表示打开，false表示debug级别日志不打印
ctpDataSource.log.isDebug=false
# 连接池日志路径，如果不填写，则打印到控制台
ctpDataSource.log.filepath=../logs/dbpool
# 在获取连接前是否做连接检测，0表示不检测，1表示在距离上次检测到本次{ctpDataSource.validateInterval}参数时间外才检测，2表示每次获取连接都检测
ctpDataSource.validateOnGet=1
# 做连接检查使用的sql，默认不用配置，使用jdbc自带的ping来检查，效率高
# ctpDataSource.validateQuery=select 1
# 单位秒，做连接检查socket的读超时时间，在{ctpDataSource.validateOnGet}参数为1、2时候有效
ctpDataSource.validateTimeout=5
# 单位毫秒，在获取连接前，距离上次检测连接超过多少毫秒，做连接检测。在{ctpDataSource.validateOnGet}参数为1时候有效
ctpDataSource.validateInterval=6000
# 单位毫秒，当空闲连接总数大于{ctpDataSource.minCount}时，会去清理空闲连接，空闲连接当前时间到上次被执行sql时间大于本参数，则该空闲连接会被清理
ctpDataSource.timeBetweenEvictionRunsMillis=60000
# 2.8.6 加密共享
正式环境加密信息支持共享，支持同一产品多套测试环境。配置入口在协同系统配置工具。
默认为正式环境，且共享加密信息仅允许本机访问。若需其他服务器访问，则填写对应服务器的ip地址，多个ip地址间用逗号隔开。变更配置后需要重启服务后生效。
测试环境，勾选【连接生产环境】的【设置为测试环境】选项，填写正式环境的访问方式，启动服务即可从正式环境获取加密信息。
# 2.8.7 系统参数配置
通过【协同系统配置工具】来进行系统参数配置，示例如下：
配置协同访问地址
名称：internet.site.url
值： URL地址，如http://a8.***.com https://a8.***.com
描述：用于消息通知到邮件系统，在正文中等直接点击打开协同正文的链接地址
配置上传附件大小
名称：fileUpload.maxSize
值：52428800
描述：允许上传文件的大小：单位是byte
配置正文中上传图片的大小
名称：fileUpload.image.maxSize
值：1048576
描述：允许上传图片的大小：单位是byte
配置每条短信支持的最大字节数
名称：mobile.largestNum
值：120
描述：根据当前的短信服务商， 每条短信支持的最大字节数，单位bytes
配置邮件目录
名称：webmai.savePath
值：${ctp.base.folder}/webmail
描述：邮件保存目录，如D:/data/mail（注：${ctp.base.folder}是系统缺省路径），系统默认值是${ctp.base.folder}/webmail
配置Office转换目录
名称：officeTarns.cache.folder
值：${ctp.base.folder}/officetrans
描述：Office转换文件目录，存放Office文件的HTML缓存，系统默认值${ctp.base.folder}/officetrans
# 2.9 启动协同服务
# 2.9.1 Windows启动
使用协同主目录的ApacheJetspeed/bin/startup.bat启动协同服务，启动后的命令窗口不可关闭；
使用协同主目录的OfficeTrans/bin/startup.bat启动Office转换服务，启动后的命令窗口不可关闭；
# 2.10 客户端配置
- 系统访问
http://应用服务IP地址。如果端口号不是80，则在IP地址后面加端口号。例如：http://172.20.2.20:8080
- 配置IE环境
打开登录页，点击登录页的"辅助程序安装"，依次安装所需要的客户端插件。
# 2.11 系统预置的用户
| 角色 | 登录名（安装过程中可设置） | 密码（安装过程中可设置） |
|---|---|---|
| 初始化管理员（所有版本） | init-admin | 默认为123456 |
# 2.12 日志
安装日志存放在安装后产品目录下Logs文件夹，如：D:\Seeyon\A8\Logs；
启动日志存放在安装后产品的ApacheJetspeed/logs、logs_sy目录。
# 2.13 移动端访问说明
移动端App可直接访问协同服务，端口同pc端访问端口。
若需要分离部署移动服务，则安装产品提供的Nginx程序，并通过S1进行移动端访问配置。
# 3 致远服务S1
S1支持协同及相关服务的服务启停、参数配置、运维监控及相关运维工具，产品安装后预置S1程序。详细的说明见S1的安装维护手册和用户操作手册。
# 4 服务启动停止
本章节简要说明协同服务、OfficeTrans、数据库服务的启动、停止。
# 4.1 启动过程
# 4.1.1 数据库启动
# 4.1.1.1 Oracle11GR2 数据库启动
- Windows启动
只需启动如下3个服务
# 4.1.1.2 SQLServer数据库启动
在Windows环境下启动如下服务即可：
# 4.1.1.3 MYSQL 数据库启动
Windows系统启动示例：
D:\Mysql\bin>mysqld --defaults-file=..\my.ini
# 4.1.1.4 PostgreSQL 数据库启动
- Windows下产品安装后将注册SeeyonPostgreSQL13.3服务，可以通过此服务项启动/停止，如图：
# 4.1.2 转换服务启动
# 4.1.2.1 Windows环境
启动
方法一：
使用协同主目录的OfficeTrans/bin/startup.bat启动Office转换服务，启动后的命令窗口不可关闭；
- 方法二：
通过S1的服务启停来启动；
# 4.1.3应用服务启动
# 4.1.3.1 Windows环境
- 启动
批处理：在协同目录的ApacheJetspeed/bin文件夹，执行startup.bat启动；
S1：在服务启停中来启动；
# 4.2 关闭过程
# 4.2.1 应用服务停止
# 4.2.1.1 Windows环境
停止
方法一：
登录系统管理员账号，使用协同的服务停止通知，时间到后自动停止服务；
- 方法二：
bat启动的可以关闭启动后产生的命令窗口停止服务；
- 方法三：
在S1的服务启停中停止。
# 4.2.2 转换服务停止
# 4.2.2.1 Windows环境
- 停止
bat启动的可以关闭启动后产生的命令窗口停止服务；
# 4.2.3 停止数据库
# 4.2.3.1 Oracle 数据库停止
只需停掉如下3个服务
# 4.2.3.2 SQLServer数据库停止
在Windows环境下启动如下服务即可
# 4.2.3.3 MySQL 数据库停止
停止命令：mysqladmin -uroot -ppassword shutdown
# 4.2.3.4 PostgreSQL 数据库停止
- Windows下产品安装后将注册SeeyonPostgreSQL13.3服务，可以通过此服务项启动/停止，如图：
# 5 部署配置各独立服务
协同应用服务之外，可独立部署的服务、最低建议配置（根据实际业务情况，可进行合并或优化调整）及服务用途见以下清单：
| 序号 | 服务名称 | 最低配置 | 主要用途 |
|---|---|---|---|
| 1 | 全文检索服务 | CPU：8C内存：16G | 协同内的全文检索功能支持结构化、非结构化的内容检索 |
| 2 | OfficeTrans服务 | CPU：8C内存：16G | 在线预览服务，支持office类文档的在线查看 |
| 3 | 音视频服务 | CPU：8C内存：16G带宽：10M | 音视频的解码、播放 |
| 4 | 文件下载服务 | CPU：8C内存：16G带宽：10M | 独立的文件下载服务配置后，文件下载时使用此服务 |
| 5 | 数据转储服务 | CPU：8C内存：16G | 历史数据转储时使用的服务 |
| 6 | V-Join泛组织管理平台 | CPU：8C内存：16G | V-Join泛组织管理平台 |
| 7 | WEB服务 | CPU：8C内存：16G | Apache HTTP Server或者nginx反向代理提供以下服务单机/集群https访问集群负载均衡服务 |
| 8 | Redis缓存服务 | CPU：8C内存：16G | 集群缓存服务 |
# 5.1 全文检索服务（必须）
# 5.1.1 概要说明
使用与协同应用服务版本一致的全文检索服务；
全文检索服务支持Windows、Linux系统；
使用全文检索必须部署独立的全文检索服务；
使用全文检索安装程序安装全文检索的独立服务，建议安装在独立的服务器上。
# 5.1.2 安装配置
# 5.1.2.1 安装
双击SeeyonSearchserviceInstall.bat运行安装程序；
开始安装，选择安装路径，如：D:\SearchService，依次点击下一步，完成安装；
# 5.1.2.2 配置
- 第一步：登录系统管理员账号，进入"全文检索设置"界面，选择"远程模式"，查看并记录下服务注册码。
- 第二步：若已安装S1，可在S1的"服务启停配置"中，进行全文检索配置：
非集群环境配置：
server.ip：全文检索服务器的 ip 地址，分离部署需要设置实际ip，如10.5.5.160，集中部署可使用本机地址127.0.0.1
a8.server.url：协同服务的访问地址，注意带应用上下文/seeyon。 如果不是80端口则必须将端口号加上
regsit.code: 注册码，需要与系统管理员账号中的服务注册码保持一致
server.port：全文检索服务的端口，默认9700，如果是分离部署需要开放端口让协同应用服务器可以访问
path_data：索引数据目录，默认是../base/data(即Searchservice\ES\base\data），如需修改需要设置绝对路径
如果产品是分离部署，在协同系统参数设置中需要把index.index_a8Ip设置成协同的实际ip，另外需要开放9601和9603端口让全文检索服务器可以访问；如果集中部署不需要调整
系统管理员账号，系统分区设置：分离部署的情况，"全文检索网络映射路径"设置为协同分区附件所在目录映射到全文检索服务器的网络路径
集群环境配置：
server.ip：全文检索服务器的实际ip，如10.5.5.160
a8.server.url：协同服务的访问地址，注意带应用上下文/seeyon。 如果不是80端口则必须将端口号加上，集群环境配置主节点的地址即可
regsit.code: 注册码，需要与系统管理员账号中的注册码保持一致
server.port：全文检索服务的端口，默认9700
path_data：索引数据目录，默认Searchservice\ES\base\data
配置文件：在全文检索安装目录下SearchService/config/application.properties 配置文件中增加queue_link 属性（8.0版本默认就有，8.0sp1需要手动增加），其值为各节点 ip 地址及端口。
格式：queue_link =(10.5.5.51,9601,9603),(10.5.5.52,9601,9603)
集群各节点协同系统配置ApacheJetspeed/conf/SeeyonConfig，插件参数设置：index.index_a8Ip，其值为当前集群节点的 ip 地址；
系统管理员账号，系统分区设置：全文检索服务器需要能正常访问协同的分区附件，"全文检索网络映射路径"设置为协同分区所在目录映射到全文检索服务器的网络路径
- 第二步：若未安装S1，将注册码配置在全文检索服务安装目录下Searchservice\config\application.properties文件中，并调整其他配置参数：
若全文检索与协同服务是安装部署在同一台服务器，则只需修改注册码，其它可以默认值（如修改协同服务的访问端口，则必须在a8.server.url的值添加对应的修改后的端口，如：http://127.0.0.1:89/seeyon）
若协同服务是集群，则需要在config/application.properties配置文件中增加queue_link属性，其值为各节点ip地址及端口。
格式：queue_link =(10.3.4.206,9601,9603),(10.3.4.207,9601,9603)
- 第三步：将协同系统分区所在磁盘阵列挂载到全文检索服务器（推荐）。或者将协同系统所在的分区文件夹进行网络共享，"网络共享路径"如：\\ IP地址\共享名；
挂载命令示例：
\\192.168.1.3\shareName映射为I:/命令如下：
第四步：进行协同系统分区设置，根据实际情况参考以下图示：
若协同系统分区所在磁盘阵列已挂载至全文检索服务器，则进行协同的分区管理配置。如下图：
图 协同系统分区与全文检索访问同一磁盘(N盘)
参数含义：
分区名称：存放附件的系统分区名称。
分区路径：协同访问系统分区的路径。通常为本地磁盘文件夹路径、网络共享路径或Linux下的挂载路径。
分区状态：发布时间和截止时间段内的分区状态（停用/启用）。
发布时间：系统分区的启用时间。
截止时间：系统分区的停用时间。
网络共享路径：系统分区在全文检索服务上的网络共享路径，远程全文检索服务的操作系统可访问该路径。
第五步：重启协同服务。
第六步：重启全文检索服务器。
# 5.1.3 服务启停
- 使用S1启动全文检索服务，或使用以下shell脚本启动：
Windows双击【全文检索目录】/startup.bat；
- 使用S1停止全文检索服务，或使用以下shell脚本停止：
Windows双击【全文检索目录】/shutdown.bat；
# 5.2 文档中台服务（weboffice）
# 5.2.1 概要说明
WebOffice文档中台服务docker私有化部署操作说明见文档《weboffice组件docker部署文档516》。
# 5.3 在线预览服务（OfficeTrans默认集中部署）
# 5.3.1 概要说明
协同服务安装时预置安装OfficeTrans服务。若需要将OfficeTrans分离部署可通过以下方式进行。
# 5.3.2 安装配置
# 5.3.2.1 安装
在协同服务安装后，预置安装的OfficeTrans服务，位于产品安装目录下OfficeTrans文件夹。
将OfficeTrans、jdk、S1文件夹拷贝至分离部署的服务器。
注册信息导出，并导入到分离部署服务器。注册信息如下：
Windows：HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SEEYON\Officetrans
# 5.3.2.2 在线预览参数配置
通过S1进行在线预览参数配置，以及服务启停。
JVM属性设置，其中-Djava.rmi.server.hostname=127.0.0.1配置里的ip地址需要改成转换服务器内网ip，默认端口1097和1098，如果是分离部署需要开放端口让协同服务可以访问。
# 5.3.2.3 协同参数配置
对协同服务的在线预览相关参数进行配置，主要配置以下参数：
修改"系统参数设置"中的officeTrans.xxx的参数，说明如下（未描述的不必须修改）：
officeTrans.cache.folder：OfficeTrans转换后文件的存放目录，该目录需在OfficeTrans服务器、协同服务器皆可访问。可使用文件目录挂载的方式实现。
officeTrans.rmi.host：OfficeTrans对于协同服务的ip地址，协同服务需要可访问此ip地址
officeTrans.rmi.port：OfficeTrans对于协同服务的端口，与OfficeTrans服务配置的rmi.service.port参数一致
修改配置完成，登录系统管理员账号-系统设置-系统模块管理中启用office转换，重启协同服务；再登录普通账号上传word文件查看转换是否正常。
# 5.3.3 服务启停
- 使用S1启动OfficeTrans服务，或使用以下shell脚本启动：
Windows双击【OfficeTrans服务目录】/startup.bat；
- 使用S1停止OfficeTrans服务，或使用以下shell脚本停止：
Windows双击【OfficeTrans服务目录】/shutdown.bat；
# 5.4 音视频服务（可选）
# 5.4.1 概要说明
使用与协同应用服务版本一致的音视频服务；
音视频服务支持Windows、Linux系统；
# 5.4.2 安装配置
# 5.4.2.1 安装
双击SeeyonMediaServiceInstall.bat运行安装程序；
开始安装，选择安装路径，如：D:\mediaservice，依次点击下一步，完成安装；
# 5.4.2.2 配置
- 使用系统管理员登录协同系统，进入"音视频服务配置"界面，查看服务的注册码及服务注册状态。
- 若已安装S1，可在S1的"服务启停配置"中，进行音视频服务配置：
regist.code：音视频服务注册码，登录系统管理员在微服务配置页面获取。
server.port：音视频服务的端口，默认6080。
server.ip：音视频服务本机的实际ip地址。
a8.server.url：协同服务的访问地址，注意带应用上下文/seeyon。
service.url：音视频服务对外地址（nginx访问地址），不能设置为127.0.0.1，纯内网环境设置局域网地址，涉及外网访问需设置为映射到外网的地址。
media.authorizedIps：音视频服务信任的ip地址，填写协同服务的ip地址，多个地址逗号隔开，127.0.0.1勿删。
media_path：音视频服务存储音视频文件的目录。
- 若未安装S1，将注册码配置在音视频服务目录的config/application.properties文件中，并调整其它配置参数（推荐用S1进行配置，若手工编辑注意文件编码）：
# 5.4.3 服务启停
- 使用S1启动音视频服务，或使用以下shell脚本启动：
Windows双击【音视频服务目录】/startup.bat；
- 使用S1停止音视频服务，或使用以下shell脚本停止：
Windows双击【音视频目录】/shutdown.bat；
# 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：同时下载的最大连接数。
若未安装S1，将注册码配置在全文检索服务目录的config/application.properties文件中，并调整其他配置参数（推荐用S1进行配置，若手工编辑注意文件编码）：
- 系统管理员账号---系统分区设置：分离部署的情况，文件微服务服务器需要能正常访问协同的分区附件，"文件微服务网络映射路径"设置为协同分区附件所在目录映射的网络路径
# 5.5.3 服务启停
- 使用S1启动文件下载服务，或使用以下shell脚本启动：
Windows双击【文件下载服务目录】/startup.bat；
- 使用S1停止文件下载服务，或使用以下shell脚本停止：
Windows双击【文件下载服务目录】/shutdown.bat；
# 5.6 数据转储服务（可选）
# 5.6.1 概要说明
随着时间的推移和业务的发展，协同系统数据库和表中的数据会越来越多，随之带来的是更高的磁盘、IO、系统开销，甚至性能上的瓶颈，而单一数据库服务器的资源终究有限，因此需要对数据库或表进行拆分，从而更好的提供数据服务。
数据转储微服务的基本思想就是把协同系统的数据库水平（横向）切分出一部分历史数据放到另一数据库（分库）服务器上，从而缓解单一数据库的性能问题。
目前支持的数据库类型：MySQL、SQLServer、Oracle。
# 5.6.2 安装配置
# 5.6.2.1 环境准备
准备服务器，该服务器用于运行数据转储微服务，以及存储历史数据的数据库服务。
建议与运行库数据库服务器同网段，保证协同服务能正常连接此数据库。
建议历史数据库版本与运行库数据库版本完全一致。
做任何相关操作之前，先备份生产环境数据，确保备份成功并且可用。
避免使用navicat等第三方工具备份数据库。
在服务器上安装数据库服务，并创建用于存储历史数据的数据库用户。
# 5.6.2.2 安装数据转储服务
双击SeeyonDatatransferInstall.bat运行安装程序；
开始安装，选择安装路径，如：D:\datatransservice，依次点击下一步，完成安装；
# 5.6.2.3 协同服务插件参数配置
- 在S1中配置协同服务，或在协同系统配置工具中启用分库。截图红色部分的分库信息（填写实际信息）：
fk.db.driverClassName、fk.db.hibernateDialect可以下拉选择，根据数据库类型确定不同选项。
fk.db.url可以参考协同系统配置工具，数据库连接中的数据库地址格式，修改ip端口数据库名称信息后手工录入。注意，该处数据库地址为分库地址。
保存配置后，相关信息写入协同系统安装目录base\conf\plugin.properties文件，重启协同系统服务，使之生效。
启动过程可见"初始化连接池：FK"。连接池初始化完成，分库中则已自动创建相关业务数据表。
# 5.6.2.4 启停配置数据转储服务
# 5.6.3 数据迁移任务配置
- 登录协同系统管理员账号，数据转储管理。
数据迁移服务配置，开关，开启。
填入startup脚本绑定IP地址，或者数据转储微服务服务器唯一的内网ip地址。
端口默认8086。
执行方式自由选择，迁移数据量较大时每天定时执行，迁移数据量较小、较短时间迁移完成可选择立即执行。
迁移日期必须选择为当前日期两年前的一个日期。
设置成功后，符合任务执行条件的时间内，历史数据迁移已在进行。
控制台显示"批量迁移任务执行开始"。
日志位于数据转储微服务安装目录下，日志文件为 Logs/data_transfer.log。
数据迁移完成，数据转储微服务控制台显示"批量迁移任务执行结束"。
# 5.6.4 查看转储数据
- 已发、已办事项多出"转储数据"按钮。点击按钮才可以查看转储的数据。
点击"转储数据"按钮之前：
点击"转储数据"按钮之后：
- 新建事项，关联转储数据。
# 5.6.5 升级转储数据
协同系统升级以后，数据转储微服务需要升级，转储数据也需要手工升级。
数据转储微服务服务器上，升级数据转储微服务（需与协同应用版本一致）。
登录协同系统管理员账号，数据转储管理，点击"升级"按钮。
# 5.7 V-join泛组织管理平台
# 5.7.1 概要说明
使用与协同应用服务版本一致的V-join服务；
V-join服务支持Windows、Linux系统；
部署配置请参考《V-Join泛组织管理平台安装维护手册》。
# 6 部署配置Web服务
Web服务可以为协同系统的单机环境提供Web访问，为协同系统的集群环境提供Web访问以及负载均衡。
协同系统的集群要求对应的web服务在做负载均衡时支持会话保持机制。
会话保持机制的意义在于，确保将来自相同客户端的请求，转发至后端相同的服务器进行处理。换句话说，就是将客户端与服务器之间建立的多个连接，都发送到相同的服务器进行处理。这种机制，可以识别客户端与服务器之间交互过程的关联性，在负载均衡的同时，保证一系列相关联的访问请求分配到同一台服务器上。
依据实际情况，可自由选择Nginx（产品提供了标准安装程序，也可自主安装）、Apache、F5或其他web服务软硬件设施。
以下章节对web服务部署及配置时的注意事项进行说明。
# 6.1 部署及配置Nginx
Nginx支持协同系统的Web代理及集群部署的Web分发。
集群模式下，负载均衡且会话保持，需要用到nginx-sticky-module模块，此模块目前仅支持Linux系统，因此用Nginx做为集群模式的web服务时需要Linux操作系统的服务器。
产品提供了标准的Nginx安装程序，也可自行下载安装配置，详见以下章节。
# 6.1.1 部署概要拓扑图
Nginx服务常见的部署模式见以下部署示意图：
# 6.1.2 使用Nginx安装程序安装配置
# 6.1.2.1 安装Nginx
产品提供了可视化的Nginx安装程序，执行安装包中的SeeyonNginxInstall（Windows为.bat，Linux为.sh）启动安装程序。
选择软件的安装路径，执行安装后即可完成软件安装。
# 6.1.2.2 配置Nginx
安装后通过S1，在"服务启停配置"进行Nginx配置：
服务器环境设置，http端口和https端口是指nginx服务监听的端口；
配置后台服务信息，协同服务地址，其中的地址和端口是指协同服务的访问地址和端口；
根据Nginx需要代理的后端服务进行设置，支持协同集群模式的负载均衡、移动服务的独立分发。
当开启HTTPS时，需要修改后端tomcat服务的server.xml，增加以下配置：
编辑配置文件 ApacheJetspeed/conf/server.xml
找到Connector这一栏配置，在port后增加 proxyPort="443" scheme="https" 这个2个配置，其中443是实际访问https使用的端口，需要根据客户实际情况配置
修改并保存后，按顺序重启所有oa节点
# 注意
# 如果客户需要同时保留http与https访问，那么http与https对应的后端oa监听端口应该分开，也就是oa监听2个端口，分别对应http与https访问；我们在配置第4步时，应该重新复制一行Connector,在新复制这行上，修改port监听端口，并增加 proxyPort="443" scheme="https" ，保证在通过http访问时，重定向不会到https上 
# 6.1.2.3 启停Nginx
安装后通过S1可启停Nginx服务：
启动成功以后提示服务状态：已启动；
防火墙中放行nginx服务对应的http端口和https端口，客户端使用浏览器访问nginx服务器ip对应两个端口可打开登录页成功登录，视为配置、启动nginx成功。
# 6.1.3 自主安装配置Nginx
# 6.1.3.1 安装Nginx
Nginx及安装过程中需要的依赖程序的下载链接参考如下：
Nginx，参考下载链接（下载stable version，1.20.2或者以上版本）：
https://nginx.org/en/download.html
nginx-sticky-module，参考下载链接：
https://bitbucket.org/nginx-goodies/nginx-sticky-module-ng/downloads/
pcre，参考下载链接：https://ftp.pcre.org/pub/pcre/
openssl，参考下载链接：https://www.openssl.org/source/
zlib，参考下载链接：https://zlib.net/
若系统未安装gcc，请使用操作系统安装盘（或安装镜像）进行安装，centos系统可以执行yum install -y gcc gcc-c++
以所有的安装程序位于/home/soft下，nginx的安装目录位于/home/nginx下，依次执行以下命令进行nginx的安装（命令中标红的安装包名称，以实际下载的为准）：
# 切换目录至/home/soft
cd /home/soft
# 以实际下载的文件格式选择tar或zip解压
# 解压tar压缩包
tar -zxvf nginx-1.20.2.tar.gz
tar -zxvf pcre-8.40.tar.gz
tar -zxvf zlib-1.2.11.tar.gz
tar -zxvf openssl-1.1.0g.tar.gz
# 解压zip压缩包
unzip nginx-goodies-nginx-sticky-module-ng-08a395c66e42.zip
# 修改解压后文件夹名，便于后续安装
mv nginx-1.20.2 nginx
mv pcre-8.40 pcre
mv nginx-goodies-nginx-sticky-module-ng-08a395c66e42 nginx-sticky-module
mv zlib-1.2.11 zlib
mv openssl-1.1.0g openssl
# 赋权文件夹
chmod -R 777 nginx
chmod -R 777 openssl
chmod -R 777 zlib
chmod -R 777 nginx-stick-module
chmod -R 777 pcre
# 进行nginx的configure
cd nginx
# 注意以下configure命令为一行
./configure --prefix=/home/nginx --with-http_stub_status_module --with-http_ssl_module --with-http_realip_module --with-http_sub_module --with-http_flv_module --with-http_mp4_module --with-http_auth_request_module --with-http_random_index_module --with-http_gzip_static_module --with-pcre=/home/soft/pcre --add-module=/home/soft/nginx-sticky-module --with-openssl=/home/soft/openssl --with-zlib=/home/soft/zlib
注意：如果芯片底层架构为mips，需要进入nginx目录当中，修改objs目录下的Makefile内容，找到其中
&& ./config --prefix=/home/thtf/mircoService/nginx_src/openssl-1.0.2u/.openssl（根据实际目录而定） no-shared no-threads \
修改为
&& ./Configure （注意是Configure不是config） linux64-mips64 no-asm --prefix=/home/thtf/mircoService/nginx_src/openssl-1.0.2u/.openssl no-shared no-threads \
修改后保存。
# 编译、安装
make
make install
# 6.1.3.2 配置Nginx
以nginx安装在/home/nginx下为例，nginx的配置文件为/home/nginx/conf/nginx.conf。配置文件内容示例如下（其中upstream的名称及服务地址依据实际情况进行修改，如不需ipv6访问请去掉listen [::]:80 ipv6only=on;这一行配置）：
worker_processes auto;
worker_rlimit_nofile 20960;
error_log logs/error.log crit;
events {
worker_connections 4096;
multi_accept on;
accept_mutex on;
accept_mutex_delay 500ms;
}
http {
server_tokens off;
sendfile on;
tcp_nopush on;
tcp_nodelay on;
access_log off;
include mime.types;
default_type application/octet-stream;
keepalive_timeout 300;
client_max_body_size 10240M;
gzip on;
gzip_min_length 1k;
gzip_buffers 4 16k;
gzip_comp_level 3;
gzip_types text/xml text/plain text/css text/javascript application/x-javascript application/javascript application/xml;
gzip_disable "MSIE [1-6]\.";
upstream seeyon_v5_cluster{
sticky;
server 192.168.0.1:80 max_fails=300 fail_timeout=30s;
server 192.168.0.2:80 max_fails=300 fail_timeout=30s;
}
server {
listen [::]:80 ipv6only=on;
server_name localhost;
charset utf-8;
location / {
proxy_pass http://seeyon_v5_cluster;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header REMOTE-HOST $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
# proxy_set_header X-Forwarded-Proto $scheme;
proxy_redirect off;
proxy_connect_timeout 300;
proxy_read_timeout 300;
proxy_send_timeout 300;
}
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
}
}
# 6.1.3.3 启动Nginx
以nginx安装在/home/nginx下为例，nginx的启动脚本为/home/nginx/sbin/nginx。启动示例如下：
# 切换命令行到nginx启动脚本目录
cd /home/nginx/sbin
# 启动
./nginx
# 重启
./nginx -s reload
# 指定配置文件重启，一般用于nginx异常停止后的启动
./nginx -c /home/nginx/conf/nginx.conf
# 6.1.3.4 启用https
启用https需要购买ca证书，在购买了证书后，对nginx配置文件（nginx.conf）的server段进行以下调整（其中crt、key文件放在conf/ssl下，文件名以实际为准）：
upstream seeyon_v5_cluster {
sticky;
server 10.3.4.104:80 max_fails=300 fail_timeout=30;
server 10.3.4.108:80 max_fails=300 fail_timeout=30;
}
server {
listen 443 ssl;
server_name localhost;
ssl_certificate ssl/server.crt;
ssl_certificate_key ssl/server.key;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
charset utf-8;
location / {
proxy_pass http://seeyon_v5_cluster;
proxy_set_header Host $http_host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header REMOTE-HOST $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_redirect off;
proxy_connect_timeout 300;
proxy_read_timeout 300;
proxy_send_timeout 300;
}
}
对协同的ApacheJetspeed/conf/server.xml进行以下调整：
编辑配置文件 ApacheJetspeed/conf/server.xml
找到Connector这一栏配置，在port后增加 proxyPort="443" scheme="https" 这个2个配置，其中443是实际访问https使用的端口，需要根据客户实际情况配置
修改并保存后，按顺序重启所有oa节点
# 6.1.3.5 http重定向https
http重定向https，这里是指访问nginx的http端口自动重定向到nginx的https端口。
此场景需要在nginx配置了https访问的条件下进行 编辑nginx.conf配置 在http段落中增加server段，并新增http协议的端口,并实现跳转 return 301 https://$server_name$request_uri;
server {
listen 80;
server_name nginx访问ip或者域名;
charset utf-8;
# http 重定向到 https
return 301 https://$server_name$request_uri;
}
# 6.1.4 参数调优
参数优化需依据nginx的运行情况，及服务器负载情况进行调整。常见的优化参数有以下内容：
worker_processes：nginx的进程数，一般为cpu的倍数，可以为1倍。
worker_rlimit_nofile：nginx的进程打开文件数，可以与ulimit -u的值一致。
worker_connections：每个进程允许的最多连接数。
keepalive_timeout：客户端超时时间，单位秒。
client_max_body_size：客户端连接的最大请求实体，影响协同系统的上传附件大小，建议设置大于或等于运行附件上传的最大值。
access_log：请求日志，建议无需调试时关闭（off）。
Nginx可优化的参数还有很多，建议依据系统实际的运行需求，选择性优化。
# 6.2 部署及配置Apache
可以根据实际情况调整Apache的版本。建议使用Apache对应系列的最新版本。
以下Apache部署及配置的说明以2.4版本为基础。
Apache 2.4系列不再支持Windows Server 2003。
使用https需在SeeyonConfig中设置服务器配置为单机(HTTPS)或集群/双机，如图：
# 6.2.1 部署Apache
# 6.1.1.1 Windows系统部署
- 安装包获取：
从Apache官方合作网站下载：https://www.apachelounge.com/download/ (opens new window)
注意需要下载Win64版本，不建议再使用Win32版本
注意区别下载VS16、VC15版本，二者选其一
需要下载VS16、VC15对应版本的mod_jk，页面上搜索mod_jk
- 依赖包安装
安装对应版本的vc_redist程序，可以从以上合作网站下载
VS16：https://aka.ms/vs/16/release/VC_redist.x64.exe (opens new window)
VC15：https://aka.ms/vs/15/release/VC_redist.x64.exe (opens new window)
- Apache安装
1）解压下载的Apache程序压缩包至WEB服务器，如D:\Apache24
2）调整Apache\conf\httpd.conf文件中Apache所在绝对路径，如：替换httpd.conf中c:/Apache24 为 D:/Apache24，整行配置如下
Define SRVROOT "c:/Apache24"
3）注册Apache为Windows服务（在cmd命令提示符中，执行以下命令）：
cd /d D:\Apache24\bin
httpd -k install
- Apache服务启停
检查配置文件正确性：
d:\apache24\bin\httpd -t
启动服务：
d:\apache24\bin\httpd -k start 或使用Windows服务项中启动Apache服务。
停止服务：
d:\apache24\bin\httpd -k stop 或使用Windows服务项中停止Apache服务。
# 6.2.1.2 Apache启动失败处置
- 查看apache日志
启动失败后查看apache/logs/error日志文件，日志中新增异常信息
- 查看系统日志
1）Windows系统检查操作系统日志-应用程序日志：开始菜单，管理员身份运行eventvwr事件查看器，展开Windows日志，应用程序
2）常见端口占用无法启动，日志记录make_sock: could not bind to address [::]:80
# 6.2.2 配置文件修改
- 端口修改
1）找到Apache安装目录的conf目录下httpd.conf，搜索"Listen 80"修改此80，可以修改http默认端口80
2）找到Apache安装目录的conf/extra/httpd-ssl.conf，搜索"443"批量修改443，可以修改https默认端口443
Windows下配置文件修改：
找到Apache安装目录的conf目录下（如D:\Apache24\conf）找到httpd.conf，取消以下内容注释，并在文件末尾增加配置：
# 去掉以下行前面的注释符号"#"
LoadModule socache_shmcb_module modules/mod_socache_shmcb.so
LoadModule log_config_module modules/mod_log_config.so
LoadModule setenvif_module modules/mod_setenvif.so
LoadModule ssl_module modules/mod_ssl.so
LoadModule filter_module modules/mod_filter.so
LoadModule deflate_module modules/mod_deflate.so
# 配置文件末尾增加如下配置
# 增加mod_jk配置文件
Include conf/mod_jk.conf
# 对指定的内容进行压缩
AddOutputFilterByType DEFLATE text/html text/xml text/css text/javascript text/plain application/javascript application/octet-stream
# 增加Windows系统参数调优配置
<IfModule mpm_winnt.c>
ThreadsPerChild 2000
# 推荐设置：小型网站=1000 中型网站=1000~2000 大型网站=2000~3500
MaxRequestsPerChild 20000
# 推荐设置：小=10000 中或大=20000~100000
AcceptFilter http None
AcceptFilter https None
</IfModule>
# 6.2.3 代理连接器配置
Windows下配置步骤：
mod_jk组件下载：
Windows版本下载地址：
https://www.apachelounge.com/download/ (opens new window)
页面搜索mod_jk，注意区分VS16和VC15不同版本。
- mod_jk组件安装：
将下载的mod_jk.so文件拷贝到Apache安装目录下的modules目录下
mod_jk组件配置：
- 在Apache\conf\httpd.conf中增加以下内容：
Include conf/mod_jk.conf
在Apache\conf下建立mod_jk.conf文件，内容如下：
#mod_jk.conf主要描述了jk模块的位置及相关参数
LoadModule jk_module modules/mod_jk.so
JkWorkersFile conf/workers.properties
JkMountFile conf/uriworkermap.properties
JkLogFile logs/mod_jk.log
JkLogLevel error
#format
JkLogStampFormat "[%a %b %d %H:%M:%S %Y]"
#options
JkOptions +ForwardKeySize +ForwardURICompatUnparsed -ForwardDirectories
JkRequestLogFormat "%w %V %T"
JkMount /* controller
HostnameLookups Off
# Should mod_jk send SSL information to Tomcat (default is On)
JkExtractSSL On
# What is the indicator for SSL (default is HTTPS)
JkHTTPSIndicator HTTPS
# What is the indicator for SSL session (default is SSL_SESSION_ID)
JkSESSIONIndicator SSL_SESSION_ID
# What is the indicator for client SSL cipher suit (default is SSL_CIPHER)
JkCIPHERIndicator SSL_CIPHER
# What is the indicator for the client SSL certificated (default is SSL_CLIENT_CERT)
JkCERTSIndicator SSL_CLIENT_CERT
- 在Apache\conf下建立uriworkermap.properties文件，内容如下：
/*=controller
#所有请求转发到集群服务器上
/jkstatus= status
#jkstatus的请求转发到statusworker上
- 在Apache\conf下建立workers.properties文件，内容如下：
worker.list = controller,status
worker.status.type=status
worker.controller.type=lb
#与tomcat的server.xml中jvmRoute的值一致
#
worker.controller.balance_workers=SY11,SY12
#若增加tomcat节点，请参考以下格式添加
#worker.controller.balance_workers=SY11,SY12
#若增加tomcat节点，请参考上述格式添加
worker.controller.sticky_session=1
worker.controller.sticky_session_force=0
#与tomcat的server.xml中协议为AJP/1.3的Connector端口一致，注意开启了AJP Secret需要填写对应的密码
#<Connector port="8009" … protocol="AJP/1.3" />
worker.SY11.port=8951
worker.SY11.host=192.168.0.11
worker.SY11.type=ajp13
worker.SY11.lbfactor=1
worker.SY11.retries=3
worker.SY11.secret=Seeyon8.0Tomcat8.5AJP1.3
#若增加tomcat节点，请参考以下格式添加
worker.SY12.port=8951
worker.SY12.host=192.168.0.12
worker.SY12.type=ajp13
worker.SY12.lbfactor=1
worker.SY12.retries=3
worker.SY12.secret=Seeyon8.0Tomcat8.5AJP1.3
#若增加tomcat节点为多节点时，请参考上述格式添加
修改说明：
1）红色粗体是需要修改的部分；
2）worker.SY***.host值为对应协同服务器的IP；以上配置案例中集群两个节点服务器为192.168.0.11、192.168.0.12；两个节点服务器需要防火墙中放行8951端口；
3）worker.SY***中***为协同服务器IP的最后一段。
以上配置案例中协同服务ApacheJetspeed/conf/server.xml配置文件对应jvmRoute的值为SY11、SY12；
4）worker.SY***.secret值为对应协同服务ApacheJetspeed/conf/server.xml配置ajp协议连接器访问密钥，默认为Seeyon8.0Tomcat8.5AJP1.3，如图：
若server.xml中修改了密钥，则worker.SY***.secret值需要修改为对应的值。
# 6.2.4 启用HTTPS配置
说明：
若不使用Apache的HTTPS功能，可以不进行以下步骤。
若为单机环境，则在Apache的conf/workers.properties中只需配置一个tomcat节点。
使用https需在SeeyonConfig中设置服务器配置为：单机(HTTPS)或集群/双机。
启用支持openssl版本Apache的HTTPS功能步骤如下：
配置：
编辑conf/httpd.conf文件，取消注释或增加以下内容：
Include conf/extra/httpd-ssl.conf
编辑conf/extra/httpd-ssl.conf文件，取消注释或增加以下内容：
SSLCertificateFile "conf/server.crt"
SSLCertificateKeyFile "conf/server.key"
JkMount /* controller
修改说明：
在Apache/conf目录中放置CA的.crt和.key文件，注意文件名分别为：server.crt、server.key；
为了取得更好的安全性，建议使用经过安全机构认证过的第三方证书。
启用mod_jk模块，并开启https时，httpd-ssl.conf中需要增加JkMount /* controller
重启Apache即可使用http、https方式访问Web服务。
# 6.3 负载均衡F5配置说明
协同系统的集群结构需要web服务做负载均衡时会话保持（或会话粘滞），会话保持机制的意义在于，确保将来自相同客户端的请求，转发至后端相同的服务器进行处理。
因此F5需采用符合会话保持原理的负载均衡策略才可保证协同集群系统的正常运行。
快速跳转
- 致远协同管理软件安装维护手册
- 1 协同服务环境要求
- 2 协同服务安装启动配置
- 3 致远服务S1
- 4 服务启动停止
- 5 部署配置各独立服务
- 6 部署配置Web服务
← 产品安装维护手册-Linux 产品升级手册 →
