A8协同管理软件安装维护手册

Transcription

1 中国协同软件行业连续 11 年市场占有率第一 致远 A8-V5 协同管理软件 V6.0SP1 安装维护手册 北京致远互联软件股份有限公司 2016 年 10 月 北京致远互联软件股份有限公司 1 / 105

2 前言 中国协同软件行业连续 12 年市场占有率第一 本手册对 A8-V5 协同管理系统 ( 以下简称 A8) 的安装及维护相关事宜进行说明 该版本和 以前的版本存在很多安装部署的差异, 因此本手册不适用于早期版本的 A8 产品 若您正在使用 A8 的早期版本, 请参阅对应版本相关参考手册 ( 如 V3.50 V3.20 版本 ) 如对安装维护手册中相关问题存在疑问, 请与致远软件的客户服务人员联系 北京致远互联软件股份有限公司 2 / 105

3 目录 1 系统环境要求 系统网络示意图 服务器端环境说明 软件环境说明 插件说明 服务器运行环境要求 并发数说明 并发 200 以下用户 并发 用户 并发 用户 并发 用户 并发 用户 并发 用户 ( 集群部署 ) 客户端环境要求 客户端硬件配置 客户端软件需求 网络环境要求 系统安装配置 系统端口 加密注册和认证 说明 步骤 软加密文件使用说明 非 Windows 服务器注册认证 无外网服务器注册认证 Office 认证 说明 步骤 非 Windows 服务器 Office 认证 无外网服务器 Office 认证 二维码认证 报表工具 ( 帆软 ) 认证 数据库配置 MySQL 数据库安装及参数配置要点 Oracle 数据库安装及参数配置要点 SQL Server 数据库安装及参数配置要点 应用软件安装 Windows 环境下安装 Linux 环境下安装 日志 北京致远互联软件股份有限公司 3 / 105

4 2.9 系统预置的用户 应用程序启动 / 停止 Windows 启停方式 Linux 启停方式 客户端配置 服务器端基础配置 协同系统配置工具 服务器端口设置 应用服务器 Tomcat 调优 JVM 调优 连接池配置 系统参数配置 系统集群配置 概要说明 应用集群配置 集群主服务器配置 集群从服务器配置 Apache 部署及配置 Apache 部署 Apache 配置 配置 httpd.conf 配置 workers.properties 参数调优 HTTPS 配置 全文检索系统 概要说明 全文检索安装配置 分布式全文检索安装 分布式全文检索配置 全文检索部署常见问题 全文检索功能 小地球 支持的操作系统 致远服务 S 小地球启动与退出 启动 退出 协同服务启动与停止 启动 停止 重新启动 数据库备份与恢复 支持的数据库 备份 北京致远互联软件股份有限公司 4 / 105

5 6.5.3 恢复 其他功能 打开目录 协同系统配置 关于 产品启动说明 启动过程 数据库启动 Office 转换服务启动 全文检索服务启动 应用服务启动 关闭过程 应用服务停止 全文检索服务停止 Office 转换服务停止 停止数据库 产品升级 说明 升级版本确认 注意事项 保存系统原有信息 停止服务 产品备份 检查磁盘环境 加密狗升级 关闭其它程序 数据库调整 升级步骤 升级后操作 管理员操作 普通用户设置 升级失败环境还原 关于 A6 升级 A8-V5 的特殊说明 方式 1: 关联系统设置链接 方式 2: 关联系统设置单点登录 关联系统常见使用问题说明 数据备份与恢复 MySQL 数据备份与恢复 MySQL 数据库的备份 MySQL 数据库的恢复 Oracle 数据备份与恢复 Oracle 数据库备份恢复步骤概述 imp/exp 方式 : Expdp/Impdp 方式 : 北京致远互联软件股份有限公司 5 / 105

6 9.3 SQLServer 数据备份与恢复 物理备份方式 逻辑备份方式 系统安全 Windows 系统安全 Windows 安全补丁 Windows 分区 Windows 帐户 Windows 服务 Windows 策略 网络服务安全管理 其他 环境安全 数据库安全 中间件安全 Apache 安全 操作系统安全 启用 HTTPS 数据信息安全 客户端安全 客户端环境安全 客户端认证安全 迁移方案 说明 应用服务器迁移步骤 数据库服务器迁移 MySQL 数据库迁移方案 SQLServer 数据库迁移方案 Oracle 数据迁移方案 常见问题解答 系统常见问题 数据库常见问题 北京致远互联软件股份有限公司 6 / 105

7 System Storage 1 2 中国协同软件行业连续 12 年市场占有率第一 1 系统环境要求 1.1 系统网络示意图 中低端示意图 : 防火墙 (NAT 映射 ) 应用服务器 APP * Nat: 映射外网如 : 文件服务器 Web 应用服务器 千兆交换机 数据库服务器 磁盘阵列 全文检索服务器 * 高端示意图 : 北京致远互联软件股份有限公司 7 / 105

8 System Storage 1 2 中国协同软件行业连续 12 年市场占有率第一 应用服务器集群主节点 A X NAT 客户端 互联网服务器区 互联网 路由器 Web 集群 外网地址 内网服务器区 NAT 从节点 B Y 应用 VIP 交换机 互联网区防火墙 负载均衡设备 X 核心交换机 千兆交换机 文件服务器 Z 磁盘阵列 外网区防火墙 UC 服务器 Y 全文检索服务器 N 数据库集群 DB 服务器 E DB 服务器 E 说明 : 应用与 DB 服务器连接推荐使用千兆网络 ; 网络环境中必须有信息安全保护措施, 如防火墙 ; 公网访问建议搭建虚拟专用网, 如 VPN; 高端客户建议使用硬件负载均衡, 如 :F5( 隶属 F5 NetWorks 公司的负载均衡设备 ) Radware( 隶属 Radware 公司的负载均衡设备 ); 建议使用 ORACLE 且使用 ORACLE 集群 RAC; 建议使用 LINUX 操作系统 ; 建议使用备份软件进行数据 环境的备份 ; 建议机房配备 UPS 不间断电源 ; 建议使用监控软件对生产环境进行监控, 建立预警机制 ; 不推荐使用安腾 (ITANIUM) 处理器 (ORACLE 不再支持安腾 ) 北京致远互联软件股份有限公司 8 / 105

9 1.2 服务器端环境说明 软件环境说明 分类 A8 中间件单机 A8 中间件集群 操作系统 Windows Windows Server 2003/2008/2012 Enterprise 32/64 Edition Linux Red Hat Enterprise edition 5.5~7 SUSE Linux Enterprise 应用服务器 Tomcat Apache Tomcat WebSphere WebSphere Application Server V 及以上版本 Weblogic Weblogic 11g(10.3.6) 及以上版本 数据库 MySql MySQL 及以上版本, 推荐 说明 : 使用 MySQL5.5 以上版本仅支持 InnoDB 引擎 建议选购企业版 SQLServer SQLServer 2005/2008/2012/2014/2016 Oracle 以上均支持 X64 X32; Oracle12c 版本 Oracle11g 版本, 推荐 11R2; 不支持 Oracle10g 版本,Linux 推荐 ,Windows 推荐 以上均支持中文和英文, 但英文操作系统要安装中文字库 ; 不推荐和其它独立产品部署在同一操作系统下, 包括 : NC GKE AD/LDAP 红杉树 IIS 不支持和其它第三方独立产品部署在同一中间件服务器下 ; 支持虚拟机 : 但不支持加密狗, 需要采用软加密 ; 数据库 推荐 A8 单独一个数据库实例 ; 插件说明 注 : 以下说明为 A8 所支持的第三方插件说明, 非当前版本请参考对应版本的插件说明 插件名称 支持版本 NC 集成类 NC 版本 :V5.5 V5.6 V5.7 V6.3 金迪短信猫插件 JDSmsService_ 高级 Office 套件 V 电子签章插件 V II 北京致远互联软件股份有限公司 9 / 105

10 AD 应用 Windows Sever 2003/2008/2012 LDAP 应用 sun ds.5.2.p4.windows.full 二维码插件 V 服务器运行环境要求 并发数说明 此章节中并发用户数包含 A8 的并发数和 M1 的并发数 ( 以下章节涉及的并发数请参考以下比 率 ), 即 : 单机环境 :A8 并发数 + M1 并发数 <= 3000; 集群环境 :A8 并发数 + M1 并发数 <= 5000; 并发 200 以下用户 类别配置具体参数 应用服务器 数据库服务器 说明 : 硬件 RAM 软件 标准服务 器配置 CPU:2.3GHz 以上,64 位, 三级缓存 10M 以上,4 核以上 硬盘 :SCSI/SAS 硬盘,160G 以上 内存 :8G 以上 网卡 : 千兆网卡 *2 MYSQL:8G/SQLServer:8G/Oracle:8G 操作系统 请参考数据库提供商的硬件配置方案,A8 没有特殊要 求 使用 MySql 数据库可以使用集中部署方式, 使用 Oracle 及 SQL Server 建议分离部署, 数据 库服务器配置请参考数据库供应商要求 ; 推荐致信服务独立部署 ; 应用服务器 数据库服务器必须使用 64 位操作系统 ; 并发 用户 类别配置具体参数 CPU:2.3GHz 以上,64 位, 三级缓存 10M 以上,4 核以 应用服务器 硬件 标准服务器 配置 上硬盘 :SCSI/SAS 硬盘,320G 以上, 建议做镜像 内存 :16G 以上 网卡 : 千兆网卡 *2 数据库服务器 RAM MYSQL:8G/SQLServer:16G/Oracle:16G 北京致远互联软件股份有限公司 10 / 105

11 软件 操作系统 备份服务器硬件 PC 服务器 说明 : 应用服务 数据库服务必须分离部署 ; 推荐致信服务独立部署 ; 中国协同软件行业连续 12 年市场占有率第一 请参考数据库提供商的硬件配置方案,A8 没有特殊要 求 CPU:2.0GHz 以上, 二级缓存 2M 以上,2 核 CPU 硬盘 :SATA 硬盘,8M 缓存,7200 转,320G 以上 ; 内存 :DDR2,800,4G 以上 应用服务器 数据库服务器必须使用 64 位操作系统 ; 并发 用户 类别配置具体参数 应用服务器硬件标准服务器配置 CPU:2.3GHz 以上,64 位, 三级缓存 12M 以上,2 颗 8 核以上 硬盘 :SCSI/SAS 硬盘,320G 以上, 建议做镜像内存 :24GB 以上 网卡 : 千兆网卡 *2 全文检索服务器 硬件 标准服务器配置同应用服务器配置 软件中间件全文检索服务程序 数据库服务器 RAM 软件 SQLServer:32G/Oracle:32G 请参考数据库提供商的硬件配置方案,A8 没有特操作系统殊要求 网络存储 ( 备份 ) 硬件 磁盘阵列 磁盘阵列柜 ( 推荐 ) 文件服务器 硬件 磁盘阵列 磁盘阵列柜 ( 推荐 ) 说明 : 应用服务 数据库服务必须分离部署 ; 应用服务器 数据库服务器必须使用 64 位操作系统 ; 推荐致信服务独立部署 ; 推荐文件服务 全文检索服务分离部署 ; 并发 用户 类别配置具体参数 应用服务器硬件标准服务器配置 CPU:2.3GHz 以上,64 位, 三级缓存 12M 以上,2 颗 8 核以上硬盘 :SCSI/SAS,320G 以上, 建议做镜像内存 :32GB 以上 北京致远互联软件股份有限公司 11 / 105

12 全文检索服务器 硬件 标准服务器配置同应用服务器配置 软件中间件全文检索服务程序 数据库服务器 RAM 软件 Oracle:48G 操作系统 请参考数据库提供商的硬件配置方案,A8 没有特殊 要求 网络存储 ( 备份 ) 硬件磁盘阵列磁盘阵列柜 ( 推荐 ) 文件服务器硬件磁盘阵列磁盘阵列柜 ( 推荐 ) Web 服务器 (HTTPS) 说明 : 硬件 应用服务 数据库服务必须分离部署 ; 标准服务器配置同应用服务器配置 应用服务器 数据库服务器必须使用 64 位操作系统 ; 要求文件服务 全文检索服务分离部署 ; 要求致信服务独立部署 ; 不推荐使用 MYSQL/SQLServer; 并发 用户 类别配置具体参数 应用服务器硬件标准服务器配置 CPU:2.3GHz 以上,64 位, 三级缓存 12M 以上,4 颗 16 核以上 硬盘 :SCSI/SAS,320G 以上, 建议做镜像内存 :64GB 以上 全文检索服务器 硬件标准服务器配置同应用服务器配置 软件中间件全文检索服务程序 数据库服务器 RAM 软件 Oracle:64G 操作系统 请参考数据库提供商的硬件配置方案,A8 没有特殊要 求 网络存储 ( 备份 ) 硬件磁盘阵列磁盘阵列柜 ( 推荐 ) 文件服务器硬件磁盘阵列磁盘阵列柜 ( 推荐 ) Web 服务器 (HTTPS) 说明 : 硬件 标准服务器配置 同应用服务器配置 应用服务 数据库服务必须分离部署 ; 应用服务器 数据库服务器必须使用 64 位操作系统 ; 文件服务 全文检索必须服务分离部署 ; 不推荐使用 MYSQL/SQLServer; 致信服务必须独立部署 ; 北京致远互联软件股份有限公司 12 / 105

13 不推荐使用安腾 CPU; 并发 用户 ( 集群部署 ) 类别配置具体参数 应用服务器硬件标准服务器配置 CPU:2.3GHz 以上,64 位, 三级缓存 12M 以上,4 颗 16 核以上 硬盘 :SCSI/SAS,320G 以上, 建议本地做镜像, 使用磁 盘阵列内存 :128GB 以上 全文检索服务器 数据库服务器 硬件标准服务器配置同应用服务器配置 软件中间件全文检索服务程序 RAM 软件 Oracle:64G 以上 操作系统 数据库集群软件 请参考数据库提供商的硬件配置方案,A8 没有特殊要求 建议采用 RAC 网络存储 ( 备份 ) 硬件磁盘阵列 IBM/HP/EMC 磁盘阵列柜 ( 推荐 ) 磁盘 转以上 文件服务器硬件磁盘阵列 IBM/HP/EMC 磁盘阵列柜 ( 推荐 ) 磁盘 转以上 Web 服务器 ( 集群 /HTTPS) 说明 : 硬件标准服务器配置同应用服务器配置 本段并发所有服务必须使用 64 位操作系统及 64 位配套软件 ; 应用服务器 数据库服务器 全文检索服务器必须分离部署 ; 必须采用集群方案 ; 推荐使用 ORACLE 集群 RAC; 推荐使用硬件负载均衡 F5 等 ; 推荐使用 LINUX 操作系统 ; 建议使用备份软件进行数据 环境的备份 ; 建议机房配备 UPS 不间断电源 ; 建议使用监控软件对生产环境进行监控, 建立预警机制 ; 不推荐使用安腾 CPU; 1.4 客户端环境要求 客户端硬件配置 配件最低配置推荐配置 CPU 英特尔 奔腾 4 3.0GHz 以上英特尔 奔腾 双核 3.0GHz;Intel core 双核 3.0GHz;AMD 64 位 3.0GHz 北京致远互联软件股份有限公司 13 / 105

14 内存 >=2G Bytes >=4G Bytes 显示器分辨率 1280 以上 1280* * *768 网卡 100M 100M 客户端软件需求 名称版本备注 Windows 操作系统中文 ( 简 / 繁 ) 英文 ; Windows 2000/2003/XP/Vista/7/8/10 浏览器 IE7/8/9/10/11( 推荐 IE8 以上版本 ) Edge FireFox4 以上版本 Safari4/5/6(MAC 系统 ) Chrome12 以上 360 浏览器 ( 极速 安全 ) 无 如果是 64 位系统, 需要使用 32 位兼容浏览器 ( 不支持 64 位浏览器 ); Microsoft Office Office2003/2007/2010/2013 需要 Office 插件 WPS Office 支持 WPS2009 ( ) WPS2012 ( ) 专业版 WPS2013 专业版 需要 Office 插件 永中 office ZH.S1 需要 Office 插件 说明 : 非 IE 浏览器 ( 包含 360 极速浏览器 ) 下以下情况不支持 : 登录页辅助安装程序 表单签章, 后台管理员功能 Office 插件 : 正文格式支持基于 Windows 操作系统下的 IE FireFox ( 及以上版本 ) 浏览器查看并编辑 1.5 网络环境要求 支持 : 局域网 广域网 VPN WAPPush Modem 服务器端 ( 不推荐 ADSL) 假设 10% 用户使用公网,90% 用户使用局域网 并发数 客户端 广域网接入互联网带宽 (bps) 局域网接入带宽 (bps) 并发 >4M >100M 并发 >8M >1G 并发 >15M >1G 并发 >25M >1G 并发 >40M >1G 带宽要求与上传 下载附件大小有密切关系, 若业务中需要大量的附件, 请适当增加带宽 广域网接入带宽 (bps) 局域网接入带宽 (bps) 北京致远互联软件股份有限公司 14 / 105

15 最低带宽 1M 10M 推荐带宽 2M 100M 中国协同软件行业连续 12 年市场占有率第一 北京致远互联软件股份有限公司 15 / 105

16 2 系统安装配置 2.1 系统端口 注 :A8 服务器若启动了 OS 防火墙, 请将 A8 的 HTTP 端口增加在例外端口中 (HTTP 默认为 80) 系统常见端口如下表 : 服务端口用途端口开放规则备注 Tomcat 80 Tomcat Http 端口对所有客户端开放 SeeyonConfig 中 配置 8951 Tomcat Ajp 端口对 Web 服务器开放不可更改 8105 Tomcat 服务端口不需对外开放不可更改 1097 Office 转换服务端口不需对外开放不可更改 1099 全文检索服务端口对全文检索开放不可更改 Oracle 1521 Oracle 监听默认端口对 TomCat 服务器开放 netca 中配置 1158 Oracle EM 默认端口不需对外开放 emca 中配置 MySQL 3306 MySQL 服务端口对 TomCat 服务器开放 My.ini 中可配置 SQLServer 1433 SQLServer 服务端口对 TomCat 服务器开放 SQLServer 应用配 置器中配置 Web 服务器 80 HTTP 端口对所有客户端开放 Apache 修改 httpd.conf 全文检索服 务 ( 分布式 ) 443 HTTPS 端口对所有客户端开放 Apache 修改 httpd.conf 1099 全文检索服务端口对 TomCat 开放不可更改 8009 全文检索 TomCat Ajp 端口不需对外开放不可更改 致信 5222 移动端介入端口需要对外开放可以更改 5280 WEB 端介入端口需要对外开放可以更改 7777 文件传输端口需要对外开放可以更改 5269 与 A8 服务数据交互端口不需要对外开放可以更改 40011/ 55331/ 与 A8 服务配置交互端口对 TomCat 服务器开放不可更改 若系统使用电子邮件功能, 请将服务器设置正确的 DNS, 且保证可以与电子邮件服务的端口 通信 ( 常见的电子邮件端口 :25 110) 北京致远互联软件股份有限公司 16 / 105

17 2.2 加密注册和认证 说明 在启动 A8 之前需先完成加密的注册和认证 ; 加密信息与应用服务器绑定 ( 如有移机等需要找商务或者实施人员申请重新注册 ); 加密信息与产品版本绑定 ; 硬件加密狗只支持 Windows Linux 系统, 其他系统可通过软加密文件方式解决 ; 一个物理狗只支持一个逻辑上的 APP 服务 ; 加密支持多网卡服务器 ; 加密注册与更新程序只支持在 Windows 系统下运行 ; 步骤 运行注册认证程序 插入加密狗或将软加密文件放置在当前服务器任意位置 ; 机器与外网保持连接 ; 双击运行光盘根目录 updatedog 中的 UpdateDog.exe 程序 ; 选择产品线为 A8V5; 图 注册认证工具 注册与更新 注册及更新硬件加密狗或软加密文件, 硬件加密狗及软加密文件由致远商务提供 ; 注册及更新必须连接外网, 以完成加密的注册及更新 ; 注册及更新在使用时将弹出 MAC 地址输入框, 支持绑定其他服务器 MAC 地址 ( 如 : Linux 系统服务器 无法连接外网服务器 ); 北京致远互联软件股份有限公司 17 / 105

18 图 加密狗注册与更新 下载 Office 认证下载 Office 插件的认证信息, 需要验证硬件加密狗或软加密文件, 详细操作见 Office 认证 章节 ; 查看 License 信息 查看硬件加密狗或软加密文件的 License 信息 ; 查看硬件 ID 查看当前服务器的网卡 MAC 信息 ; 读取狗号 读取当前加密狗或软加密文件的狗号 ; 绑定数据库 图 查看 License 信息 将加密狗或加密文件绑定产品数据库 (A8 用户不需要绑定 ); 北京致远互联软件股份有限公司 18 / 105

19 2.2.3 软加密文件使用说明 对于使用软加密文件的情况, 在完成了软加密文件 ( 一般为.seeyonkey 后缀的文件 ) 的注册后, 软加密文件将自动更名为 a8v5.seeyonkey, 请将该文件拷贝至 A8 安装目录的 base/license 下 (license 不存在则新建目录 ) 非 Windows 服务器注册认证 对于非 windows 服务器的硬件加密狗 ( 或软加密文件 ) 的注册认证, 可在 Windows 平台下运 行安装程序的 UpdateDog.exe, 在注册时填写需绑定的非 Windows 服务器的 MAC 地址 注 : 加密狗绑定的 MAC 地址请用 - 做分段, 不能使用 : 无外网服务器注册认证 对于无外网服务器的硬件加密狗 ( 或软加密文件 ) 的注册认证, 在可访问外网的 Windows 平台下运行安装程序的 UpdateDog.exe, 注册时填写需绑定的无外网服务器的 MAC 地址 2.3 Office 认证 说明 需先完成加密注册, 再进行 Office 认证 ; Office 认证为 Office 插件授权的认证, 认证后 Office 插件的授权信息将显示为加密 狗 ( 或加密文件 ) 绑定的企业信息 ; 下载的 Office 认证文件不可修改文件名 ( 含后缀 ), 否则将无法正确授权 ; 步骤 运行注册认证程序 ; 插入加密狗或将软加密文件放置在当前服务器任意位置 ; 机器与外网保持连接 ; 双击运行光盘根目录 updatedog 中的 UpdateDog.exe 程序 ; 点击下载 Office 认证 ; 如果为软加密文件, 请在弹出窗口中选择软加密文件 ; 保存生成的 Office 认证文件, 若未连接外网则无法下载 Office 认证文件 ; 北京致远互联软件股份有限公司 19 / 105

20 图 下载 Office 认证成功 图 下载 Office 认证失败 将生成的 Office 认证文件拷贝至 A8 服务的以下位置 : base\license\officeplugin.office 非 Windows 服务器 Office 认证 对于非 Windows 服务器的 Office 认证, 可将硬件加密狗 ( 或软加密文件 ) 放置在 Windows 平台下, 运行安装程序的 UpdateDog.exe, 下载 Office 认证文件 将生成的 Office 认证文件拷贝至 A8 服务的以下位置 :base\license\officeplugin.office 无外网服务器 Office 认证 对于无外网服务器的 Office 认证, 在可访问外网的 Windows 平台下运行安装程序的 UpdateDog.exe, 下载 Office 认证文件 北京致远互联软件股份有限公司 20 / 105

21 将生成的 Office 认证文件拷贝至 A8 服务的以下位置 :base\license\officeplugin.office 2.4 二维码认证 从致远商务获取二维码插件认证文件 (iwebbarcode.lic), 将认证文件拷贝至 A8 服务的以下位置 :base\license\iwebbarcode.lic 2.5 报表工具 ( 帆软 ) 认证 从致远商务获取报表工具 ( 帆软 ) 的认证文件 (FineReport.lic), 将认证文件拷贝至协同服务的以下位置 :ApacheJetspeed/webapps/seeyonreport/WEB-INF/resource 下 ; 2.6 数据库配置 说明 : 数据库名称请以英文字母开头, 尽量不要使用数字或其他符号作为数据库名称的首字 符 ; 数据库名称中请不要使用特殊符号, 如 # 小数点等特殊字符 ; 数据库的密码不能小于 6 位, 建议字符数字混合 ; 在安装产品前, 请先完成数据库服务的安装及配置 ; MySQL 数据库安装及参数配置要点 注意事项 A8 对 MySQL 服务要求主要有以下几点 ( 可以在 MySQL 配置文件中对其进行设置 ): MySQL 的配置文件 Windows 下为 my.ini 文件,Linux 系统为 my.cnf 文件 数据引擎要求为 InnoDB 检查 MySQL 配置文件的 [mysqld] 项中 default-storage-engine 值, 检查是否为 InnoDB, 若不是则调整为 InnoDB; 字符集要求为 utf8 检查 MySQL 配置文件的 [client] [mysql] 项中 default-character-set 值, 以及 [mysqld] 项中 character-set-server( 或 default-character-set) 值, 检查是否为 utf8, 若 不是则调整为 utf8; 要求不区分表 / 字段大小写 检查 MySQL 配置文件 [mysqld] 项中是否包含 lower_case_table_names=1, 不包含则添加, 包含则保证其值为 1; 安装程序自动创建数据库 可在产品安装的数据库设置界面指定数据库名, 将自动创建对应名称的数据库 ; 北京致远互联软件股份有限公司 21 / 105

22 Windows 下安装 MySQL 安装 MySQL 时选择自定义模式 (Custom), 定制 MySQL 服务数据文件默认存储路径, 如下图 : 安装后建议启动 MySQL 的配置工具, 对数据引擎 字符集 Windows 服务等进行配置, 北京致远互联软件股份有限公司 22 / 105

23 如下图 : MySQL 服务使用 InnoDB 引擎, 否则无法安装 A8 启动 MySQL 的配置工具, 选择详细配置, 进行引擎设置, 如下图 : InnoDB 的数据文件在安装 MySQL 进行配置时, 建议定义至较大磁盘空间, 如下图 : 北京致远互联软件股份有限公司 23 / 105

24 MySQL 数据库使用 UTF8 字符集, 字符集不正确将导致系统中的中文出现乱码 ; 安装时 : 在 MySQL 的配置工具中, 设置字符集为 utf8, 如下图 : 建议添加 Windows 下的 MySQL 服务 ; 在安装时,MySQL 的配置工具中, 设置添加 Windows 服务, 如下图所示 : 北京致远互联软件股份有限公司 24 / 105

25 设置 MySQL 允许远程连接 ; 在安装时,MySQL 的配置工具中, 设置 root 用户密码, 并允许远程连接, 如下图所示 : 创建数据库 ( 数据库名无要求 ), 以进行产品安装 ; 创建数据库命令示例 :CREATE DATABASE V50 DEFAULT CHARACTER SET UTF8; 其中 V50 为数据库名称 北京致远互联软件股份有限公司 25 / 105

26 Linux 下安装 MySQL 说明 : 本文档是在 RedHat5.8 上安装 MySQL5.5tar 包, 适用于但不限于以下操作系统 Redhat5.x Redhat6.x 软件下载 打开 选择 Linux - Generic, 如下图所示 : 在查询结果中下载 x86_64 的 tar 包 软件安装 以下操作均需 root 用户权限 建立用户组 [root@wls ~]# groupadd mysql [root@wls ~]# useradd -r -g mysql mysql 将解压 tar 包得到的目录移到 /usr/local/ 目录下 [root@wls ~]# tar zxvf mysql linux2.6-x86_64.tar.gz >/dev/null [root@wls ~]# mv mysql linux2.6-x86_64 /usr/local/ 创建软连接并赋权 [root@wls ~]# cd /usr/local/ [root@wls local]# ln -s mysql linux2.6-x86_64/ mysql [root@wls local]# cd mysql [root@wls mysql]# chown -R mysql. [root@wls mysql]# chgrp -R mysql. 缩小 mysql 用户的权限, 防止被恶意利用 [root@wls mysql]# chown -R root. [root@wls mysql]# chown -R mysql data 北京致远互联软件股份有限公司 26 / 105

27 复制 service 启动脚本到 /etc/init.d/ 目录下 mysql]# cp support-files/mysql.server /etc/init.d/mysqld 将 mysql 的 bin 目录添加到 root 用户坏境变量 PATH 中 ~]# echo "PATH=/usr/local/mysql/bin:$PATH/" >> /root/.bash_profile ~]# echo "export PATH" >> /root/.bash_profile ~]# source.bash_profile 生成配置文件 复制配置文件 (my.cnf) 到 /etc/ 目录下 mysql]# cp /usr/local/mysql/support-files/my-medium.cnf /etc/my.cnf 初始化系统数据库 执行安装脚本 mysql]# scripts/mysql_install_db --user=mysql Installing MySQL system tables... OK Filling help tables... OK To start mysqld at boot time you have to copy support-files/mysql.server to the right place for your system PLEASE REMEMBER TO SET A PASSWORD FOR THE MySQL root USER! To do so, start the server, then issue the following commands:./bin/mysqladmin -u root password 'new-password'./bin/mysqladmin -u root -h wls.com password 'new-password' Alternatively you can run:./bin/mysql_secure_installation which will also give you the option of removing the test databases and anonymous user created by default. This is strongly recommended for production servers. See the manual for more instructions. You can start the MySQL daemon with: cd. ;./bin/mysqld_safe & You can test the MySQL daemon with mysql-test-run.pl cd./mysql-test ; perl mysql-test-run.pl Please report any problems with the./bin/mysqlbug script! 修改字符集和引擎 北京致远互联软件股份有限公司 27 / 105

28 打开 my.cnf 在 [client] [mysql] 下增加如下内容 #v5.0 config start default-character-set=utf8 #v5.0 config end 在 [mysqld] 下增加如下内容 #v5.0 config start default-storage-engine = InnoDB character-set-server = utf8 # 区分大小写参数,Linux 必须设置 中国协同软件行业连续 12 年市场占有率第一 lower_case_table_names = 1 # 注意服务端字符集设置在 5.5 以前的版本 (5.0.x 和 5.1.x) 是 default-character-set=utf8 #v5.0 config end 数据库启动及密码调整 MysSQL 启动命令示例 : Windows 系统 : D:\Mysql\bin>mysqld --defaults-file=..\my.ini Linux 启动 mysql 服务 设置 MySQL 密码 ( 需启动 MySQL 服务 ): 如果原密码为空, 请用命令 D:\MySQL\bin>mysqladmin -uroot password 如果存在密码, 请用命令 D:\MySQL\bin>mysqladmin -uroot -p password 回车后系统提示 Enter password, 这时请输入原密码, 如下图所示 : 北京致远互联软件股份有限公司 28 / 105

29 参数调优 MySQL 的参数调优, 主要为配置文件中参数的调整,MySQL 的配置文件在 Windows 下为 my.ini 文件, 在 Linux 下为 my.cnf 文件 修改 MySQL 事务隔离级别, 在 MySQL 配置文件的 [mysqld] 段增加参数 : transaction-isolation = READ-COMMITTED 以下说明 InnoDB 引擎的在内存优化方面的两个重要参数 innodb_buffer_pool_size: 此参数主要为设置缓存 InnoDB 表的索引 数据 插入 数据时的缓存大小 若 MySQL 为专用服务器, 则此参数最大值可以设置为内存的 70%~80% 此参数不会动态修改, 在数据量较小的情况下, 可以设置为数据大小 +10% 左右的值, 如数据大小 500M, 则可以设置此值为 550M; innodb_additional_mem_pool_size: 此参数为控制除索引 数据外的 InnoDB 内部 目录的大小, 通常设置 16M, 根据表数量的增加 (A8 在运行期间随表单量的增加, 表数量会增加 ), 适当增大 参数配置中另一参数 :max_connections 为控制数据库连接数的参数, 在调整 A8 应用配置 器中数据库连接数时需要同步调整此参数 Oracle 数据库安装及参数配置要点 数据库安装 支持 Oracle10G 的 版及以上版本 (10g 推荐安装 ,11g 推 荐安装 11G R2) A8 要求 Oracle 数据库实例的字符集必须选择 Unicode(AL32UTF8) 编码方式, 连接模式 专用服务器 北京致远互联软件股份有限公司 29 / 105

30 Oracle10G 及后续版本需调整参数 aq_tm_processes 为 1,cursor_sharing 为 SIMILAR;, 调整示例 : Sql> alter system set aq_tm_processes=1 scope=both; Sql> alter system set cursor_sharing = SIMILAR; Oracle11GR2 及后续版本需调整参数 deferred_segment_creation 为 false, 调整示例 : Sql> alter system set deferred_segment_creation=false scope=spfile; 创建数据库实例后, 创建存储 A8 数据的表空间 : 推荐表空间名 :v3xspace; 初始数据文件大小 30720M, 每次自动扩展 200M 数据库在 Windows 下创建脚本用例如下 : Sql> CREATE SMALLFILE TABLESPACE "V3XSPACE" DATAFILE'D:\V3XSPACE.DBF' SIZE 30720M AUTOEXTEND ON NEXT 200M MAXSIZE UNLIMITED LOGGING EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO; 注 :Oracle 数据文件默认最大为 32G, 若数据量增长超过 32G 请为表空间增加数据文件 增 加数据文件可参考如下脚本示例 : Sql> alter tablespace V3XSPACE add datafile 'D:\V3XSPACE01.DBF' size 100M AUTOEXTEND ON NEXT 2000K MAXSIZE UNLIMITED; 新建 A8 数据库管理员用户, 推荐用户名 :v3xuser, 用户角色为 DBA, 用户缺省表空间为 A8 使用的表空间, 如 (v3xspace) SQL 脚本参考 : Sql> CREATE USER "V3XUSER" PROFILE "DEFAULT" IDENTIFIED BY "123456" DEFAULT TABLESPACE "V3XSPACE" TEMPORARY TABLESPACE "TEMP" ACCOUNT UNLOCK ; Sql> GRANT CREATE VIEW,ALTER SESSION,CONNECT,RESOURCE TO V3XUSER; 客户端安装 运行 Oracle 版的 A8 程序, 要求在应用服务器上必须安装 Oracle 客户端 配置过程 : 在 Oracle 客户端软件安装完成后, 也可用 netca 命令打开配置窗口 服务名 A8 用户所在的数据库的全局数据库名, 点击 下一步 选择网络协议 TCP, 点击 下一步 主机名 数据库服务器的 IP 地址, 点击 下一步 北京致远互联软件股份有限公司 30 / 105

31 进行连接测试, 选择 : 是, 进行测试, 点击 下一步 如果连接不成功窗口, 出现以下窗口, 可通过 更改登录 修改正确的用户名和密码, 重新进行连接测试 测试成功将显示 正在连接 测试成功 最后出现如下页面, 点击 完成, 客户端配置结束 参数配置 在安装完 A8 应用程序后 ( 必看 ): Oracle10G 必须拷贝 $ oracle_client_home /client_1/jdbc/lib 下的 classes12.jar 和 ojdbc14.jar 文件到 A8_home /ApacheJetspeed/lib 下 ; 北京致远互联软件股份有限公司 31 / 105

32 Oracle11G 必须必须拷贝 $ oracle_client_home /client_1/jdbc/lib 下的 ojdbc5.jar 文件到 A8_home /ApacheJetspeed/lib 下 ( 如果 A8_home /ApacheJetspeed/lib 存在 classes12.jar 和 ojdbc14.jar, 则必须删除这两个文件, 否则将不能正常运行 ) 如果出现数据库连接数不够的情况, 还需要修改配置 ORACLE 数据库的连接数 (sessions) 和 其进程数 (process): 首先查看系统连接数 : sql> show parameter processes; sql> show parameter sessions; 可根据实际情况增加进程数和连接数 : sql> alter system set processes=300 scope=spfile; sql> alter system set sessions=335 scope=spfile; 重启数据库, 并重新检查连接数和进程数生效情况 参数调整指标参考 并发 物理 内存 Process sessions SGA(MAX) PGA 200 以下 8G G+ 800M-2G 6G G G+ 2G-3G 8G+ 系统临时 G G+ 3G-4G 10G G G+ 7G-8G 20G G G+ 10G-20G 30G+ 说明 : 表空间 TEMP 8G+ 表示 8G 或者 8G 以上 ; SGA 自动调整参数有 : _CACHE_SIZE SHARED_POOL_SIZE LARGE_POOL_SIZE 和 JAVA_POOL_SIZE oracle9i 在 32 位操作系统中最大可管理 1.7G 内存.oracle10G 在 32 位操作系统最大可管理 2.5G; PGA 约为每个用户约占用 10% 的物理内存 ;PGA 总和约为物理内存的 (16%-40%); SGA_target = 物理服务器内存 *(55%-75%); sessions=(1.1*process+5); 需要同步在产品应用配置器中修改产品连接池参数 SQL Server 数据库安装及参数配置要点 数据库安装 Sqlserver 数据库按服务器方式安装, 选择 服务器组件 工具 联机丛书和示例 (C) 服务账户选择 : 使用内置系统账户, 本地系统 北京致远互联软件股份有限公司 32 / 105

33 身份验证模式选择 : 混合模式 (Windows 身份验证和 SQL Server 身份验证 ) SA 用户的密码必须设置 : 北京致远互联软件股份有限公司 33 / 105

34 参数配置 新建数据库时排序规则选择 :Chinese_PRC_90_CI_AI, 其余参数默认 ; 系统数据库 tempdb 空间大小在 200M 以上 ( 在 tempdb 上右键 -- 属性 ); 将 A8 数据库的 READ_COMMITTED_SNAPSHOT 参数开启, 在无用户连接 A8 数据库的情况下, 库名 '; 在 SQLServer 的 master 数据库中执行以下 SQL: ALTER DATABASE [A8 数据库名 ] SET READ_COMMITTED_SNAPSHOT ON; 检查设置是否生效 : select is_read_committed_snapshot_on from sys.databases where name='a8 数据 查出来的值 1 为开启,0 为未开启 SQLServer 的 TCP/IP 服务需启动 动态端口功能需关闭, 图示 : 北京致远互联软件股份有限公司 34 / 105

35 启用动态端口将 TCP Dynamic Ports 设置为 0, 设置为空, 则停用动态端口功能 ; 2.7 应用软件安装 注 : 安装前, 请先设置操作系统时区 A8 应用服务器时区应与 DB 服务器时区一致, 此时区 尽量与 A8 大部分用户所在时区保持一致 A8 应用服务器时区的变化, 将导致系统提示类的数据 异常 Windows 环境下安装 注 : 为了方便启动,A8 安装时, 将注册一些 Windows 服务项 ( 包含 SeeyonA8Service SeeyonOfficeTransSvr), 因此将涉及到服务项 注册表的修改 请遇到安全软件或操作系统提 示警告时, 选择允许修改, 或在 A8 安装前先暂停安全软件 ( 如 360 安全卫士 金山等 ) 安装步骤 : 第一歩 : 双击安装程序 SeeyonA8*Install.bat 文件 (Windows2003 版本以上操作系统, 请右 键以管理员身份运行 ); 第二步 : 开始进行安装 选择 我接受该许可协议条款, 选择 下一步 北京致远互联软件股份有限公司 35 / 105

36 第三步 : 选择软件的安装路径, 选择 下一步 第四歩 : 选择数据库类型, 并配置数据库连接信息 ( 数据库名称 服务器地址 端口 用户 名 密码 ), 选择 下一步 第五步 : 确认安装信息是否正确, 选择 下一步 第六步 : 开始安装, 安装完成后, 出现管理员密码设置界面, 请填写对应帐号新的密码 ( 服务启动后请使用新密码登录对应管理员 ); 第七步 : 点击 完成, 退出安装程序 北京致远互联软件股份有限公司 36 / 105

37 2.7.2 Linux 环境下安装 安装准备 给安装包里的文件赋可执行权限 $ chmod -R 777 安装包路径 修改 Linux 参数 1 在 /etc/sysctl.conf 中添加 : # Decrease the time default value for tcp_fin_timeout connection net.ipv4.tcp_fin_timeout = 30 # Decrease the time default value for tcp_keepalive_time connection net.ipv4.tcp_keepalive_time = 1800 # Turn off tcp_window_scaling net.ipv4.tcp_window_scaling = 0 # Turn off the tcp_sack net.ipv4.tcp_sack = 0 #Turn off tcp_timestamps net.ipv4.tcp_timestamps = 0 2 然后执行命令 : $service network restart 这些都和 TCP sockets 有关的优化 3 在 /etc/rc.d/rc.local 里添加 echo "30">/proc/sys/net/ipv4/tcp_fin_timeout echo "1800">/proc/sys/net/ipv4/tcp_keepalive_time echo "0">/proc/sys/net/ipv4/tcp_window_scaling echo "0">/proc/sys/net/ipv4/tcp_sack echo "0">/proc/sys/net/ipv4/tcp_timestamps 4 如果使用 Oracle 数据库, 在 /root/.bash_profile 添加 export ORACLE_HOME= Oracle 客户端安装路径 export LD_LIBRARY_PATH=$ORACLE_HOME/instantclient 系统安装 第一步 : 执行 SeeyonA8*Install.sh 进行安装, 双击 SeeyonA8*Install.sh 文件, 选择 运行, 或者打开一个终端, 找到安装包所在目录, 执行如下命令 : $./ SeeyonA8*Install.sh 第二歩 : 根据提示开始进行安装 选择 我接受该许可协议条款, 点下一步 第三步 : 选择软件的安装路径, 如 :/home/seeyon/a8 点击下一步 第四歩 : 选择安装版本的数据库类型, 并配置数据库连接信息 ( 数据库名称 服务器地址 端口 用户名 密码 ), 点 下一步 北京致远互联软件股份有限公司 37 / 105

38 第五步 : 确认安装信息是否正确, 选择 下一步 第六步 : 开始安装, 安装完成后, 出现管理员密码设置界面, 请填写对应帐号新的密码 ( 服 务启动后请使用新密码登录对应管理员 ); 第七步 : 点击 完成, 退出安装程序 2.8 日志 安装日志存放在安装后目录的 Logs 文件夹, 如 :C:\Seeyon\A8\Logs; 启动日志存放在安装后产品的 ApacheJetspeed/logs logs_sy 目录 北京致远互联软件股份有限公司 38 / 105

39 2.9 系统预置的用户 角色 用户名 密码 ( 安装过程中可设置 ) 系统管理员 ( 所有版本 ) system 默认为 system 集团管理员 ( 集团版 ) group-admin 默认为 单位管理员 ( 企业版 ) admin1 审计管理员 ( 所有版本 ) audit-admin 默认为 seeyon 应用程序启动 / 停止 Windows 启停方式 启动 使用 A8 主目录的 ApacheJetspeed/bin/startup.bat 启动 A8 服务, 启动后的命令窗口不可关闭 ; 使用 A8 主目录的 OfficeTrans/bin/startup.bat 启动 Office 转换服务, 启动后的命令窗口 不可关闭 ; 停止 用 A8 的 system 用户登录, 使用 A8 的服务停止通知, 时间到后自动停止服务 ; Linux 启停方式 启动用 cd 命令到 A8 主目录 /ApacheJetspeed/bin/ 目录下, 启动 A8 服务 :./startup.sh 用 cd 命令到 A8 主目录 /OfficeTrans 目录下, 启动 Office 转换 (& 表示后台运行 ) nohup./startup.sh >/dev/null 2>&1 & 停止 方法一 : 用 A8 的 system 用户登录, 使用 A8 的服务停止通知, 时间到后服务自动停止 ; 方法二 : 结束 java 进程, 在终端命令行执行以下命令 : ps ef grep java 找到在 A8 主目录 的 java 进程 pid 号, 执行以下命令 : Kill -9 进程 pid 号 2.11 客户端配置 系统访问 应用服务器 IP 地址, 如果端口号不是 80, 则在 IP 地址后面加端口号 例如 : 北京致远互联软件股份有限公司 39 / 105

40 配置 IE 环境 中国协同软件行业连续 12 年市场占有率第一 打开登录页, 点击登录页的 辅助程序安装, 根据向导, 依次安装所需要的客户端插件 2.12 服务器端基础配置 协同系统配置工具 启动工具方式 : Windows:.. \A8 \ApacheJetspeed\conf\SeeyonConfig.cmd Linux:.. \A8 \ApacheJetspeed\conf\SeeyonConfig.sh 界面示例 : 北京致远互联软件股份有限公司 40 / 105

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

42 以下简称 A8 应用配置器 服务器端口设置 http 访问端口默认为 80, 可以通过运行 A8 应用配置器 来更改 如下图 应用服务器 Tomcat 调优 打开 A8 应用配置器 : 根据需要, 选择 单机 单机 (HTTPS) HTTPS 的配置详见 HTTPS 部署章节 其它参数配置见 下表 : 并发 总线程数 最小空闲数 最大空闲数 200 以下 北京致远互联软件股份有限公司 42 / 105

43 JVM 调优 打开 A8 应用配置器 : 各项参数对应不同并发数的配置标准 : 并发系统物理 200 以下推荐 Windows X64 Linux X Windows X64 Linux X Windows X64 Linux X Windows X64 Linux X Windows X64 Linux X64( 推荐 ) 内存 Xms Xmx NewSize MaxNewSize MaxPermSize 8G 2G 4G 1024M 1024M 512M 8G 2G 4G 1024M 1024M 512M 12G+ 4G 6G 1024M 1024M 512M 16G+ 6G 8G 1024M 1024M 512M 24G+ 12G 16G 1024M 1024M 512M 3000 以上推荐 Linux X64 24G+ 12G 16G 1024M 1024M 512M 注意 : 由于在 32 位下操作系统 JVM 内存最大值有上限, 所以不能随便增大内存, 否则可能导致 系统不能启动 连接池配置 打开 A8 应用配置器 : 北京致远互联软件股份有限公司 43 / 105

44 连接数最大最小值的参考标准 : 并发 最小 最大 200 以下 以上 请采用集群部署, 单节点参考 2000~3000 参数配置 说明 : 如果是 Oracle 数据库, 需要同步修改 Oracle 相关参数, 参考本文 Oracle 参数配置章节 系统参数配置 通过 A8 应用配置器 来进行配置 配置 A8 访问地址 名称 :internet.site.url 值 : URL 地址, 如 http(s)://a8.***.com 描述 : 用于消息通知到邮件系统, 在邮件正文中直接点击打开协同正文的链接地址 GKE 消息直接点击打开协同正文的链接地址 配置上传附件大小 名称 :fileupload.maxsize 值 : 描述 : 允许上传文件的大小 : 单位是 byte 配置正文中上传图片的大小 名称 :fileupload.image.maxsize 值 : 描述 : 允许上传图片的大小 : 单位是 byte 配置每条短信支持的最大字节数 名称 :mobile.largestnum 值 :120 描述 : 根据当前的短信服务商, 每条短信支持的最大字节数, 单位 bytes 配置邮件目录 名称 :webmai.savepath 北京致远互联软件股份有限公司 44 / 105

45 值 :${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 北京致远互联软件股份有限公司 45 / 105

46 3 系统集群配置 3.1 概要说明 V5.1 及之后版本支持集群环境, 集群支持多节点 水平集群, 不支持垂直集群 ( 多节点部 署在同一服务器 ) 说明 : 集群环境, 只需在主服务器放置硬件加密狗 主从服务器的说明请阅读以下章节 ; 硬件配置参考 系统环境要求 章节 ; 应用程序安装参考 应用软件安装 章节 ; 集群支持 Oracle SQLServer 数据库 ; 集群支持 TomCat WebSphere Weblogic 中间件 (WebSphere Weblogic 的集群部署请 参考其独立文档 ); 集群环境请部署分布式全文检索服务 ( 全文检索安装及配置, 请参考 全文检索系统 章节 ); 配置集群各应用版本说明 服务 Apache HTTP Server 版本 或以上版本 A8-V5 V5.1 以上 ( 非 V5.1 版本, 请先按标准产品升级 ) Oracle 10g 11g 12c SQLServer 集群的网络拓扑结构图 北京致远互联软件股份有限公司 46 / 105

47 外部网络 Apache 服务器 ( 或 F5 负载均衡器 ) 内部千兆网络 全文检索服务器 ( 主 )App1 ( 从 )App2 ( 从 )AppN 内部千兆网络 光纤交换机 UC 服务器 文件磁盘阵列 数据库服务器 1 数据库服务器 N 数据库磁盘阵列 集群配置主要分两部分 : 应用集群配置 Apache 部署及配置 以下分章节说明两部分的配置 3.2 应用集群配置 应用的集群配置在应用配置工具 ( 以下简称为 SeeyonConfig) 中进行,SeeyonConfig 的启动 参考章节 2.11 集群配置主要分为 3 个步骤 : 主服务器配置, 所谓主服务器为集群环境中需放置硬件加密狗 生成集群标识的服务器 集群环境启动时, 需先启动主服务器才可启动从服务器 从服务器配置, 所谓从服务器为集群环境中启动不需硬件加密狗 集群标识采用主服务 器集群标识的服务器 集群环境启动时, 从服务器的加密及部分配置信息读取主服务器对应信息 Web 服务器配置, 所谓 Web 服务器为集群环境中支持 Web 访问的服务器,A8 支持 Apache F5( 隶属 F5 NetWorks 公司的负载均衡设备 ) 作为 Web 服务器 关于 Apache 的配置可 参考第 4 章节, 关于 F5 的配置请咨询 F5 公司的技术人员 集群配置及启动时需注意事项 : 主 从服务器的系统时间要求相差不超过 3 秒 主 从服务器的 IP 地址必须在相同网段, 即 IP 地址前 3 段需一致 北京致远互联软件股份有限公司 47 / 105

48 SeeyonConfig 中涉及目录的配置项, 主 从服务器该目录的物理存储位置必须一致 包含以下目录 ( 括号中为配置项名称 ): 邮件保存目录 (webmail.savepath) Office 转换文件目录 (officetarns.cache.folder) 注 : 物理存储位置必须一致, 值不一定相同 主 从服务器的 BUG 补丁包及修复包情况必须一致 ( 以主服务器为准 ) 即更新补丁时需将集群中所有节点一并更新, 若从服务器与主服务器代码不一致则无法启动 集群主服务器配置 集群主服务器的配置, 步骤如下 : 运行 SeeyonConfig, 在 服务器设置 页签, 选择 服务器设置 项中 集群 / 双机 选项 ; 勾选 集群 / 双机配置 项中 设置当前机器为主服务器, 此时 集群 / 双机标识 项 将自动生成集群标识 ( 生成的标识需填写至集群其他从服务器节点 ); 在 节点配置 项中, 填写集群用到的所有节点 IP 地址, 并勾选 当前节点 对应至 当前服务器 IP; 在 系统参数设置 页签, 配置 webmail.savepath officetarns.cache.folder 信息 ; 进行 SeeyonConfig 其他基础配置, 可参考 2.11 章节 ; 主服务器的 SeeyonConfig 图示 : 北京致远互联软件股份有限公司 48 / 105

49 3.2.2 集群从服务器配置 集群从服务器的配置, 步骤如下 : 运行 SeeyonConfig, 在 服务器设置 页签, 选择 服务器配置 项中 集群 / 双机 选项 ; 不勾选 集群 / 双机配置 项中 设置当前机器为主服务器, 在 集群 / 双机标识 项中填写主服务器生成的集群标识 ; 在 节点配置 项中, 填写集群用到的所有节点 IP 地址, 并勾选 当前节点 对应至当前服务器 IP; 在 系统参数设置 页签, 配置 webmail.savepath officetarns.cache.folder 信息 ( 需与 主服务器对应目录的物理存储位置一致 ); 进行 SeeyonConfig 其他基础配置, 可参考 2.11 章节 ; 从服务器的 SeeyonConfig 图示 : 集群其他从服务器节点, 可依次按照上述步骤进行配置 注 :SeeyonConfig 的 节点配置 中需填写集群用到的所有节点 IP 北京致远互联软件股份有限公司 49 / 105

50 4 Apache 部署及配置 说明 : Apache 部署可以实现 web 挂接 https 双机热备或集群负载均衡方案 产品安装包中预置的 Apache 为 版本, 可以根据客户实际需求调整 Apache 版本 以下 Apache 部署及配置的说明以 版本为基础 ; Apache 的 exe 程序不支持 windows2003, 若使用 windows2003 可换用 Apache2.2 系列 使用 https 需在 SeeyonConfig 中设置服务器配置为 : 单机 (HTTPS) 或集群 / 双机, 如图 : 4.1 Apache 部署 部署步骤 : Windows 系统部署 安装 vc-redist 程序 运行安装程序根目录 Apache/Windows 下对应操作系统位数的 vc-redist 的 exe 程序 拷贝安装程序根目录 Apache/Windows 下对应操作系统位数文件夹下的文件, 至预放置 Apache 的目录, 如 D:/Apache 调整 Apache/conf/httpd.conf 文件中默认的 Apache 路径为实际 Apache 所在绝对路径 即替换 httpd.conf 中 c:/apache24 为 D:/Apache 在命令提示符中, 执行以下命令注册 Apache 为 Windows 服务 : cd /d D:\Apache\bin httpd -k install Linux 系统部署 安装 pcre 拷贝安装程序根目录 Apache/Linux 下 pcre-8.37 至 /home 目录, 执行以下 命令进行 pcre 的安装 : cd /home/pcre-8.37./configure --prefix=/usr/local/pcre make make install 安装 apr 拷贝安装程序根目录 Apache/Linux/apr1.5.2 至 /home 目录, 执行以下命令 进行 apr 的安装 : cd /home/apr1.5.2 北京致远互联软件股份有限公司 50 / 105

51 ./configure --prefix=/usr/local/apr make make install 中国协同软件行业连续 12 年市场占有率第一 安装 apr-util 拷贝安装程序根目录 Apache/Linux/apr-util1.5.4 至 /home 目录, 执 行以下命令进行 httpd 的安装 ( 注意红色标注的为一条命令 ): cd /home/apr-util1.5.4./configure --prefix=/usr/local/apr-util make make install 安装 httpd 拷贝安装程序根目录 Apache/Linux/httpd 至 /home 目录, 执行以 下命令进行 httpd 的安装 ( 注意红色标注的为一条命令 ): cd /home/httpd /configure --prefix=/usr/local/apache --with-apr=/usr/local/apr --with-apr-util=/usr/local/apr-util --with-pcre=/usr/local/pcre cp /usr/local/apache/bin/apachectl /etc/init.d/httpd 拷贝安装程序根目录 Apache/Linux/ Patch4Linux 下文件夹至 /usr/local/apache 文件夹下 4.2 Apache 启动 Windows 系统 : 在 Windows 服务项中启动 / 停止 Apache 服务 ( 服务项名称默认为 Apache2.4) Linux 系统 : 执行 service httpd start 启动 Apache 执行 service httpd stop 停止 Apache 4.3 Apache 配置 注意 : 在进行以下配置前, 需先进行 Apache 的部署 配置 httpd.conf Linux 系统 (Windows 系统不需要此步骤 ) 下修改 conf/httpd.conf, 在该文件最后增加 LoadModule filter_module modules/mod_filter.so LoadModule deflate_module modules/mod_deflate.so Include conf/mod_jk.conf AddOutputFilterByType DEFLATE text/html text/plain text/xml 配置 workers.properties Apache 的 conf /workers.properties 文件内容如下, 红色粗体是需要修改的部分 修改说明 : worker.sy***.host 值为对应 A8 服务器的 IP; 北京致远互联软件股份有限公司 51 / 105

52 worker.sy*** 中 *** 为 A8 服务器 IP 的最后一段 worker.list = controller,status worker.status.type=status worker.controller.type=lb 中国协同软件行业连续 12 年市场占有率第一 # 与 tomcat 的 server.xml 中 jvmroute 的值一致 #<Engine name="catalina" defaulthost="localhost" jvmroute="sy1"> worker.controller.balance_workers=sy144,sy217 worker.controller.sticky_session=1 worker.controller.sticky_session_force=0 # 与 tomcat 的 server.xml 中协议为 AJP/1.3 的 Connector 端口一致 #<Connector port="8009" protocol="ajp/1.3" /> worker.sy144.port=8951 worker.sy144.host= worker.sy144.type=ajp13 worker.sy144.lbfactor=1 worker.sy144.retries=3 集群的其他节点请依次按照上述内容格式添加信息, 需添加点如下 : worker.controller.balance_workers= 请在已有的 SY 后添加 SY*** worker.sy***.port=8951 worker.sy***.host= 请填写节点 IP 地址 worker.sy***.type=ajp13 worker.sy***.lbfactor=1 worker.sy***.retries= 参数调优 修改 conf/httpd.conf, 在该文件最后增加 ( 若已存在对应参数, 则修改对应数值, 以确保 不小于示例中数值 ) <IfModule mpm_winnt.c> ThreadsPerChild 150 MaxRequestsPerChild 1000 AcceptFilter http None AcceptFilter https None </IfModule> 4.4 Apache 启用 HTTPS 配置 说明 : 若不使用 Apache 的 HTTPS 功能, 可以不进行以下步骤 启用 Apache 的 https 需要基于 Apache 配置章节内容再进行配置 北京致远互联软件股份有限公司 52 / 105

53 若为单机环境, 则在 Apache 的 conf /workers.properties 中只需配置一个 tomcat 节点 使用 https 需在 SeeyonConfig 中设置服务器配置为 : 单机 (HTTPS) 集群 / 双机 启用支持 openssl 版本 Apache 的 HTTPS 功能步骤如下 : (Apache2.4.x 版本配置 ) 编辑 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 Include conf/ httpd-ssl.conf 在 Apache/conf/ssl 目录中放置 CA 的.crt key 文件, 注意文件名分别为 :oasvr.crt oasvr.key;.crt.key 文件可由致远商务提供 ; 致远提供免费的服务器证书, 如果服务器对互联网开放, 为了取得更好的安全性, 强烈建议使用经过国家安全机构认证过的第三方证书 重启 Apache 即可使用 http https 方式访问 Web 服务 北京致远互联软件股份有限公司 53 / 105

54 5 全文检索系统 配置 此章节用于远程全文检索的情况, 使用本地全文检索或不使用全文检索插件的不需要此章节 5.1 概要说明 V5 版本 A8 系统只支持 V5 版本的全文检索服务 ; V5 版的全文检索支持 Windows Linux 系统 ; 全文检索服务器支持集成部署 ( 即全文检索本地模式 ), 集成部署的全文检索直接集成在 A8 服务中, 无需单独安装 ; 全文检索服务支持分布式部署, 分布式部署需采用全文检索安装程序安装全文检索服务 A8 和全文检索安装在不同的服务器上并通过局域网连接在同一 IP 网段 5.2 全文检索安装配置 分布式全文检索安装 第一步 : 在全文检索服务器上双击 SeeyonSearchInstall.bat ( Linux 执行 SeeyonSearchInstall.sh) 运行安装程序 ; 第二步 : 开始安装, 选择安装路径, 如 :D: \search, 依次点击下一步 ; 分布式全文检索配置 第一步 : 启动全文检索服务 Windows 双击 全文检索目录 /Search/startup.bat; Linux 执行 全文检索目录 /Search /startup.sh 第二步 : 使用 A8 系统管理员登录 A8 系统, 进入 全文检索设置 界面, 选择 远程模式, 并且填入全文检索服务器的 IP 地址和 A8 服务器的 IP 地址, 如下图所示 设置好后重启 A8 服务 ; 北京致远互联软件股份有限公司 54 / 105

55 第三步 : 将 A8 系统分区所在磁盘阵列挂载到全文检索服务器 ( 推荐 ) 或者将 A8 系统所在 的分区文件夹进行网络共享,IP 地址和网络共享名即组成 A8 分区管理配置中的 网络共享 路径 ( 如 :\\ IP 地址 \ 共享名 ); 挂载命令示例 : Windows 如把 \\ \shareName 映射为 I:/ 命令如下 : Linux 如把 \\ \shareName 网络共享路径, 映射为 /mnt/upload, 命令如下 ( 假设访问附件分区文件夹 sharename 的用户名为 user1, 密码为 pwd1), 使用 root 用户, 执行 : mount -t cifs -o username=user1,password=pwd1 // 附件分区所在服务器 / 网络共享路径 /mnt/upload 用 root 用户, 编辑 vi /etc/fstab, 在最后面加入 : // 附件分区所在服务器 / 网络共享路径 /mnt/uploa d/smbfs defaults,auto,username=user1,password=pwd1 0 0 第四步 : 进行 A8 系统分区设置, 根据实际情况参考以下图示 : 若 A8 系统分区所在磁盘阵列已挂载至全文检索服务器, 则可直接进行 A8 的分区管理配置 如下图 : 北京致远互联软件股份有限公司 55 / 105

56 图 A8 系统分区与 A8 全文检索应用在同一磁盘阵列 若 A8 系统分区需设置共享, 则网络共享路径填写 \\IP 地址 \ 共享名 的格式, 分区路径填写根据操作系统不同 磁盘与应用关系不同有所区别, 如以下各图所示 : 图 A8 系统分区与全文检索应用不在同一磁盘阵列 图 A8 系统分区与各应用不在同一磁盘阵列之 Windows 系统 北京致远互联软件股份有限公司 56 / 105

57 图 A8 系统分区与各应用不在同一磁盘阵列之 Linux 系统 参数含义 : 分区名称 : 存放附件的系统分区名称 分区路径 : A8 访问系统分区的路径 通常为本地磁盘文件夹路径 ( 如 : 图 ) 网络共享路径 ( 如 : 图 ) 或 Linux 下的 samba 挂载路径 ( 如 : 图 ) 分区状态 : 发布时间和截止时间段内的分区状态 ( 停用 / 启用 ) 发布时间 : 系统分区的启用时间 截止时间 : 系统分区的停用时间 网络共享路径 : 系统分区的网络共享路径, 远程全文检索服务访问系统分区的路径 第五步 : 重启 A8 服务 第六步 : 重启全文检索服务器 5.3 全文检索部署常见问题 问题一 : 全文检索服务安装在 Linux 时,A8 配置时无法连接全文检索服务, 后台日志报 org.springframework.remoting.remoteconnectfailureexception: Cannot connect to remote service 解决方法 : 请配置 Linux 的 hostname, 以英文字母开头, 避免纯数字 ; 修改 Linux 的 /etc/hosts 文件, 增加 hostname 对应 IP 问题二 : 全文检索服务安装在多网卡服务器时, 需要做以下配置 : Shell 启动 : 编辑 Search 目录的 startup.bat(linux 为 startup.sh), 在 JAVA_OPTS 值的最后增加 : -Djava.rmi.server.hostname=IP 地址 Windows 示例 : 北京致远互联软件股份有限公司 57 / 105

58 Linux 示例 : 服务项启动 ( 仅 Windows 下 ): 第一步 : 编辑 Search 目录的 RegSearch.bat, 在 JAVA_OPTS 值的最后增加 : -Djava.rmi.server.hostname=IP 地址示例 : 第二步 : 在命令行切换目录至 Search 目录, 执行以下命令对服务进行重装 : RegSearch.bat remove RegSearch.bat install 第三步 : 在 Windows 服务项中右键 SeeyonSearchService, 选择 属性 - 登录 页签, 选择登录身份为 此账户, 点击 浏览, 在弹出的窗口中依次点击 高级 立即查找, 选择 administrator 用户, 并依次确认 在返回到 SeeyonSearchService 的属性界面输入 administrator 用户的密码, 并确认保存 ; 第四步 : 重启 SeeyonSearchService 服务 ; 5.4 全文检索功能 用户可在各空间页面选择不同的应用范围输入不同的关键字进行检索 北京致远互联软件股份有限公司 58 / 105

59 6 小地球 6.1 支持的操作系统 Windows Server 2003/2008/2012 Enterprise 32/64 Edition 6.2 致远服务 S1 致远服务 S1 是以客户为中心的 基于 SLA( 服务级别协议 ) 的致远在线运维服务中心, 为致远客户提供在线自助服务以及丰富的服务工具 S1 默认服务端口号与密码为 :60001/00000, 安装完毕后请及时修改 修改步骤 : 步骤 1 : 打开致远服务 S1 桌面 步骤 2 : 点击 菜单 - 设置中心, 进入 基础设置 页面, 在服务端口设置模块 : 填写未被占用的端口号和密码 北京致远互联软件股份有限公司 59 / 105

60 6.3 小地球启动与退出 启动 小地球运行路径 协同安装目录 \seeyonearth\seeyonearth.exe, 启动后在右下角任务栏中 出现小地球图标 退出 鼠标右键单击小地球, 弹出小地球菜单, 选择 退出 北京致远互联软件股份有限公司 60 / 105

61 6.4 协同服务启动与停止 启动 鼠标右键单击小地球, 选择 启动服务 协同服务 停止 鼠标右键单击小地球, 选择 停止服务 协同服务 北京致远互联软件股份有限公司 61 / 105

62 6.4.3 重新启动 鼠标右键单击小地球, 选择 重新启动 协同服务 6.5 数据库备份与恢复 支持的数据库 与协同服务集中部署的 MySql 标准版 以上版本 for Win32 Win64 北京致远互联软件股份有限公司 62 / 105

63 6.5.2 备份 鼠标右键单击小地球, 选择 数据库备份设置, 弹出数据库自动备份设置窗口 第一步 : 选择 Mysql 安装目录 第二步 : 选择备份目录, 该目录为自动备份的数据包存放的目录, 默认未 { 安装路径 }\backup 第三步 : 按一周七天设置备份的日期 第四步 : 添加备份的时间,24 小时制, 范围 00:00~23:59 第五步 : 确定保存 注意事项 : 每次备份数据开始之前会自动停止协同服务, 在备份完成后自动启动协同服务! 恢复 鼠标右键单击小地球, 选择 数据库备份设置, 弹出数据库自动备份设置窗口 北京致远互联软件股份有限公司 63 / 105

64 第一步 : 选择备份目录下备份的数据文件 第二步 : 选择 开始恢复数据 注意事项 : 每次恢复数据开始之前会自动停止协同服务, 在恢复完成后自动启动协同服务! 6.6 其他功能 打开目录 可以打开协同安装路径, 小地球启动日志和备份日志路径 北京致远互联软件股份有限公司 64 / 105

65 6.6.2 协同系统配置 参见 章节协同系统配置工具 关于 显示产品基本信息 北京致远互联软件股份有限公司 65 / 105

66 7 产品启动说明 包含协同 OfficeTrans 致信 数据库的启动说明 7.1 启动过程 数据库启动 Oracle11GR2 数据库启动 Windows 启动 只需启动如下 3 个服务 Linux 启动 #su oracle $lsnrctl start $sqlplus / as sysdba Sql> startup Sql> exit SQLServer 数据库启动 在 Windows 环境下启动如下服务即可 : 北京致远互联软件股份有限公司 66 / 105

67 MYSQL 数据库启动 Windows 系统启动示例 : D:\Mysql\bin>mysqld --defaults-file=..\my.ini Linux 系统启动示例 : # mysqld_safe defaults-file=/etc/my.cnf Office 转换服务启动 Windows 环境 启动 方法一 : 使用 A8 主目录的 OfficeTrans/bin/startup.bat 启动 Office 转换服务, 启动后的命令窗口 不可关闭 ; 方法二 : 通过小地球来启动, 参考 小地球 章节 ; Linux 启动方式 启动 用 cd 命令到 A8 主目录 /OfficeTrans 目录下, 启动 Office 转换 (& 表示后台运行 ) nohup./startup.sh >/dev/null 2>&1 & 全文检索服务启动 远程全文检索服务需要执行此过程 本地模式的全文检索或无全文检索插件的情况, 不需要 执行此过程 北京致远互联软件股份有限公司 67 / 105

68 Windows 环境 Windows 双击 全文检索目录 /Search/startup.bat; Linux 环境 Linux 执行 全文检索目录 /Search /startup.sh 应用服务启动 Windows 环境 启动 批处理 : 在 A8 目录的 ApacheJetspeed/bin 文件夹, 执行 startup.bat 启动 ; 小地球 : 参考 小地球 章节 ; Linux 环境 启动 用 cd 命令到 A8 主目录 /ApacheJetspeed/bin/ 目录下, 启动 A8 服务 :./startup.sh 7.2 关闭过程 应用服务停止 Windows 环境 停止 方法一 : 用 A8 的 system 用户登录, 使用 A8 的服务停止通知, 时间到后自动停止服务 ; 方法二 : bat 启动的可以关闭启动后产生的命令窗口停止服务 ; 方法三 : 使用 小地球 的停止功能 北京致远互联软件股份有限公司 68 / 105

69 Linux 环境 停止 方法一 : 用 A8 的 system 用户登录, 使用 A8 的服务停止通知, 时间到后服务自动停止 ; 方法二 : 结束 java 进程, 在终端命令行执行以下命令 : ps ef grep java 找到在 A8 主目录 的 java 进程 pid 号, 执行以下命令 : Kill -9 进程 pid 号 全文检索服务停止 远程全文检索服务需要执行此过程 本地模式的全文检索或无全文检索插件的情况, 不需要 执行此过程 Windows 环境 停止 bat 启动的可以关闭启动后产生的命令窗口停止服务 ; Linux 环境 停止结束 java 进程, 在终端命令行执行以下命令 : ps ef grep java 找到在 全文检索目录 的 java 进程 pid 号, 执行以下命令 : Kill -9 进程 pid 号 Office 转换服务停止 Windows 环境 停止 bat 启动的可以关闭启动后产生的命令窗口停止服务 ; 亦可通过 小地球 来停止服务 ; 北京致远互联软件股份有限公司 69 / 105

70 Linux 环境 停止结束 java 进程, 在终端命令行执行以下命令 : ps ef grep java 找到在 A8 主目录 /OfficeTrans 的 java 进程 pid 号, 执行以下命令 : Kill -9 进程 pid 号 停止数据库 Oracle 数据库停止 只需停掉如下 3 个服务 Linux 关闭数据 #su oracle $lsnrctl stop $sqlplus / as sysdba Sql> shutdown immediate Sql> exit SQLServer 数据库停止 在 Windows 环境下启动如下服务即可 北京致远互联软件股份有限公司 70 / 105

71 MySQL 数据库停止 停止命令 :mysqladmin uroot ppassword shutdown 北京致远互联软件股份有限公司 71 / 105

72 8 产品升级 8.1 说明 请务必仔细阅读本章节, 便于更流畅完整的进行升级操作 尤其注意升级版本 升级前准备 及升级后的操作 升级版本确认阅读注意事项升级前准备升级步骤升级后操作 8.2 升级版本确认 说明 : 产品升级路径, 须严格按照以下步骤进行 ; 除以下路径外, 不支持其他方式 其他版本直接升级到 A8-V5; V6.0 适配的帆软报表版本为 升级客户, 若使用帆软报表, 请联系致远商务更新帆软 license 到 版本 并更新帆软报表设计器到 版本 升级 : 支持以下版本平滑升级 :V3.5SP1 V5 版本 ; V3.2SP1 及更早版本需先升级到 V3.5SP1; 8.3 注意事项 在升级前, 一定要注意将环境变化告知用户, 并完成升级前准备工作 A8-m V3.5SP1 升级至 A8-V5 后, 产品应用层面调整点见发布文档, 完整的环境要求, 请见本文档系统环境要求章节 在进行具体升级操作前, 务必按照以下步骤, 做好升级前准备工作 保存系统原有信息 由于应用变化调整, 须对以下内容进行手动保存 : 北京致远互联软件股份有限公司 72 / 105

73 序号分类操作说明 升级后登录页将使用系统默认登录页, 要使用原有登 1 登录页 系统管理员登录, 手动保存用户自定义的登录页图片 录页图片, 须升级前保存升级后重新设置 ( 不建议进行此操作, 建议使用系统默认的多图切换式登录页, 再根据 A8 新登录页进行新的登录图片设 置 ) 升级后首页风格将使用系统默认风格, 要使用原有横 2 首页风格 单位管理员登录, 手动保存用户自定义的首页横幅图片 幅图片, 须升级前保存升级后重新设置 ( 不建议进行此操作, 建议使用系统默认首页风格, 再根据 A8 新风格进行新的首页横幅图片设置 ) 停止服务 停止 A8 使用 system 用户登录, 在 [ 系统维护 ]-[ 服务停止通知 ] 中发送系统停止通知, 并设置系统停止预留时间, 勾选 [ 时间到后自动关闭服务 ] 在预留时间结束后服务将自动关闭 停止其他服务若有 Office 转换 全文检索 M1 服务, 请逐一停止 产品备份 数据库备份在 A8 服务停止后, 进行对应数据库类型的备份操作 产品备份将 A8 目录的 ApacheJetspeed jdk base/conf base/license 文件夹进行拷贝备份 注册信息备份 V5( 不包含 V5) 之前版本请备份以下信息 : Windows 系统导出产品注册表信息 : 32 位 :HKEY_LOCAL_MACHINE\SOFTWARE\ ufida\a8installinfo 64 位 :HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ufida\a8installinfo Linux 系统备份注册信息文件 : /root/.config/a8installinfo.conf V5( 含 V5) 之后版本请备份以下信息 : Windows 系统导出产品注册表信息 : 北京致远互联软件股份有限公司 73 / 105

74 32 位 :HKEY_LOCAL_MACHINE\SOFTWARE\SEEYON\A8 64 位 :HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SEEYON\A8 Linux 系统备份注册信息文件 : /root/.config/seeyoninstall_a8.info 检查磁盘环境 检查 A8 服务所在目录 系统临时目录 (Windows 为操作系统所在分区 Linux 为 /tmp 目录 ) 是否有 2G 以上剩余空间, 来完成升级时临时文件的存取操作 加密狗升级 需要联系致远商务将加密狗中信息更新为 V5 对应版本, 否则无法启动升级后的 V5 产品 关闭其它程序 升级耗时较长, 请关闭服务器 ( 应用服务器 DB 服务器 ) 其他暂不使用的程序, 以释放物 理资源, 缩短升级时间 数据库调整 MySQL 数据库 对于 MySQL 数据库的用户, 需要调整 MySQL 服务的默认存储引擎为 InnoDB 非 InnoDB 引擎 将无法升级及正常使用 A8 在执行了数据库备份后, 调整 MySQL 配置文件 (Windows 为 my.ini Linux 为 my.cnf) 中 [mysqld] 项的 default-storage-engine 值, 调整为 InnoDB, 并重启 MySQL 服务 Oracle 数据库 对于 Oracle 数据库的用户, 需要确保数据库的字符集为 UTF8, 不为 UTF8 会导致升级失败 及后续 A8 使用过程中的异常 在执行了数据库备份后, 请检查数据库的字符集是否为 UTF8 检查方法 : 使用 sys 用户连 接 Oracle 服务, 并执行以下 SQL: select value$ from props$ WHERE NAME='NLS_CHARACTERSET'; 若结果不为 AL32UTF8 或 AL32UTF16, 则需先将字符集调整为 UTF8, 调整字符集可以使用以下示例 SQL: update props$ set value$='al32utf8' WHERE NAME='NLS_CHARACTERSET'; 调整字符集后, 重启 Oracle 服务 恢复备份的数据, 再执行后续的升级步骤 若结果为 AL32UTF8 或 AL32UTF16, 则可进入升级步骤, 进行升级 北京致远互联软件股份有限公司 74 / 105

75 8.4 升级步骤 升级准备内容完毕后, 请按照以下步骤, 进行升级操作 : 启动数据库服务 ; 将 V5 版本的安装程序拷贝至协同应用程序所在的服务器 ; 执行安装程序根目录的 SeeyonA8*Install.bat(sh) 文件, 启动安装程序, 如图 : 接受许可协议 ; 确认升级程序读取的产品安装目录是否正确, 如图 : 确认数据库连接信息是否正确, 如图 : 北京致远互联软件股份有限公司 75 / 105

76 点击下一步进行目录 数据库的匹配检测及反馈, 如图 : 点击下一步执行升级 ( 程序 数据库将被升级 ); 升级完毕后, 检查升级日志是否有 错误, 升级日志在安装后程序根目录 Logs 下 若升级过程中无报错信息, 则启动 A8 服务 ; (V3.50SP1 版本执行此步骤 ) 执行表单 URL 升级, 此步骤必须执行完成后用户才可正 常登陆 A8 A8 服务启动完毕后, 访问以下 URL 地址 : 其中 :ip:port 为 A8 的访问 IP 及端口 ( 端口为 80 则不需输入 ) 访问结果如下图 : 北京致远互联软件股份有限公司 76 / 105

77 点击 表单样式升级, 执行表单的 URL 升级 注 : 此页面其他按钮不要随意点击, 用于升级出现异常时修复表单数据 ( 由致远开发人员操作 ) 表单 URL 升级的日志将记录在 A8 的 ApacheJetspeed/logs_sy/form.log 中 在提示升级成功后, 则可正常登陆 A8( 不需要再重启服务 ), 成功提示如图 : 至此 A8 升级完毕 8.5 升级后操作 升级操作完成后, 为用户操作更为流畅, 请按照以下方式进行具体操作 : 管理员操作 调整访问端口启动应用配置器 ( 安装后程序目录的 ApacheJetspeed/conf 中的 SeeyonConfig 文件 ), 设置 http 端口, 默认不修改时为 80 安装 / 配置致信服务参考本文档的 致信服务 章节, 对致信服务进行安装 / 配置, 若致信与 A8 分离部署, 则需要客户端将致信服务地址添加到浏览器信任站点中 北京致远互联软件股份有限公司 77 / 105

78 8.5.2 普通用户设置 更新辅助程序 点击登录页 辅助程序安装, 在弹出窗中, 更新 IE/windows 插件 Office 控件 常用的 插件等辅助程序, 如下图 : 配置致信 将致信服务地址添加到浏览器信任站点中, 若致信与 A8 在同一服务器部署则不需添加 北京致远互联软件股份有限公司 78 / 105

79 8.6 升级失败环境还原 若升级过程中出现异常需要还原环境重新进行升级, 请执行以下内容 : 还原备份的数据库 ; 还原备份的注册信息 ; Windows 系统恢复导出的产品注册表信息 : 32 位恢复后在 :HKEY_LOCAL_MACHINE\SOFTWARE\ ufida\a8installinfo 64 位恢复后在 :HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\ufida\a8installinfo Linux 系统恢复备份的注册信息文件 : 恢复至 :/root/.config/a8installinfo.conf 删除 V5 版本的注册信息 ; Windows 系统删除产品注册表信息 : 32 位 :HKEY_LOCAL_MACHINE\SOFTWARE\SEEYON\A8 64 位 :HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SEEYON\A8 Linux 系统删除注册信息文件 : /root/.config/ seeyoninstall_a8.info 还原应用程序的 ApacheJetspeed jdk base/conf base/license 文件夹 ; 重新执行升级步骤 ; 北京致远互联软件股份有限公司 79 / 105

80 8.7 关于 A6 升级 A8-V5 的特殊说明 老 A6 升级 A8-V5 / A6-V5, 提供以下四种方式 中国协同软件行业连续 12 年市场占有率第一 方式 3 和方式 4: 1) 如上所述, 支持 A6-m V3.0Sp2/Sp3/Sp4 通过升迁工具升至 A8-m V3.2SP1, 再升级至 A8-m V3.5SP1, 最后升级至 A8-V5SP1 或 A6-V5 SP1 2) 升迁工具的使用请查看该工具对应的文档 升级至 A8-m V3.5SP1 后, 通过本文档第八章节进行 V5 升级操作 方式 1 和方式 2 的具体操作说明如下描述 方式 1: 关联系统设置链接 描述及注意事项 : 1. 方式 : 在 V5 中设置关联系统, 建立链接 用户通过链接进入老 A6 登录页 无需升级 2. 支持版本 : 支持 A6 V3.0Sp4 及其之前的任何版本 3. 前提 : 老 A6 能正常启动, 用户能正常登录与使用 具体操作描述 : 1. 系统管理员登录 V5 系统后台, 进入信息集成配置 - 关联系统管理页面, 在常用链接下 -- 新建关联系统, 填写名称 A6 的 url 访问地址 授权给相应人员 北京致远互联软件股份有限公司 80 / 105

81 2. 使用方式 : 可以选择配置到空间导航还是配置成备选栏目使用 3. 配置完成后提交, 前端被授权人员可以在我的工具 - 常用链接下 常用链接栏目 空间 中等地方, 直接点击该链接, 打开 A6 登录页 北京致远互联软件股份有限公司 81 / 105

82 8.7.2 方式 2: 关联系统设置单点登录 中国协同软件行业连续 12 年市场占有率第一 描述及注意事项 : 1. 方式 : 在 V5 中设置关联系统, 建立链接与单点登录, 通过链接无需输入用户名和密码, 直接进入 A6 信息页面 无需升级 2. 支持版本 : 支持 A6 V3.0Sp4 及之后版本, 不支持其他版本 3. 前提 : 老 A6 能正常启动, 用户能正常登录与使用 具体操作描述 : 1. 系统管理员登录 V5 系统后台, 进入信息集成配置 - 关联系统管理页面, 在内部系统 ( 也可以是外部系统 自定义类别下 )-- 新建关联系统 授权给相应人员, 配置方式分为同域部署和不同域部署 不同域 : 即为集成系统 ( 如 V5) 和被集成系统 ( 如 A6) 的 IP 不同的配置方式 针对不同域, 提供代理部署和非代理部署两种方式 同域 : 即为集成系统 ( 如 V5) 和被集成系统 ( 如 A6) 的 IP 相同 ( 端口可不同 ) 的配置方式 2. 新建系统时请阅读新建关联系统旁的操作解释说明 : 北京致远互联软件股份有限公司 82 / 105

83 不同域部署 不同域部署的方式一 ( 代理部署 ): 该方式的安全性高于不配置代理的方式 1. 按照操作说明中的描述, 点击代理 URL 部分中的 jsp 模板下载, 将下载后的包解压为文件夹 ssoproxy( 注意 : 必须是文件夹 ), 放入 A6 系统中的 /OA/tomcat/webapps/yyoa 目录下, 即可生成代理地址 : 如 将地址复制到浏览器中访问, 弹出以下提示信息, 说明代理生成成功 后续直接将代理地址直接填写到新建关联系统 -- 基础定义 -- 代理 URL 中 2. 建立关联系统 sso 的基本信息 : 如图所示 :A6 的 url 单点登录的地址和直接访问的地址不同, 需要使用../yyoa/oalogin 如 : 北京致远互联软件股份有限公司 83 / 105

84 3. 高级 - - 配置参数编码以及登录参数, 如下,A6 的集成建议使用 GBK 编码, 如果使用 utf-8 可能出现界面显示乱码, 参数标记必须为 username password, 参数预设值为 A6 系统中某人员的登录名账号 4. 配置为菜单 空间导航 栏目使用, 建议使用新窗口模式 配置为二级菜单使用, 例如配置 A6 的万年历页面作为菜单. 登录 A6, 鼠标右键查看 URL, 复制下来, 就成为了目标 URL 的地址如下, 这个目标页可以是 A6 系统中的任意页面, 可以是登录后的首页, 可以是某个表单查询的列表页面等等 : 北京致远互联软件股份有限公司 84 / 105

85 5. 配置好后, 被授权的前台普通个人的显示 : 6. 新窗口的空间和导航, 点击开直接进入了 A6 某个功能页面. 北京致远互联软件股份有限公司 85 / 105

86 7. 说明 : 在上面的基础定义配置中有个检查内容, 参照说明这是目标页的任意文本内容, 配置的万年历页面有时间 2 个字, 所以这里填写了 时间, 配置其他目标页, 检查内容需要修改为该目标页上任意文本内容 ( 注意 : 由于检查内容和目标页是一一对应关系, 当前版本中一个关联系统仅支持一个相同的目标页 ( 即为 : 如果菜单配置的是 A6 万年历页面, 那么栏目 空间导航的目标页必须和菜单的目标页一致 ) 后续的版本中会开放支持一个关联系统可配置多个不同的目标页, 就可以菜单 栏目 导航配置为不同的被集成目标页面, 当前如果需要使用被集成系统 (A6) 的多个目标页, 那么需要建立多个关联系统, 每个关联系统单独指定自己的目标页面 ) 不同域部署的方式二 ( 非代理部署 ): 此方式不配置代理地址, 仍然能实现不同域下单点登录的功能 : 1. 修改浏览器配置如下 : 北京致远互联软件股份有限公司 86 / 105

87 2. 设置为同域的配置 ( 实际上是不同域的 ) 3. 参数和目标页地址做如常配置即可 设置后的其它步骤与设置代理的步骤相同 北京致远互联软件股份有限公司 87 / 105

88 同域部署 假如 A6 和 A8 在同一个服务器上, 就做同域配置, 配置步骤和不同域部署的方式二 ( 非代理 部署 ) 一致, 只是不需要修改浏览器设置中的启用域的设置 关联系统常见使用问题说明 1. 不管使用方式一还是方式二, 都建议不打开 IE 调试 ( 浏览器默认配置就不开启 ), 如果 打开, 可能存在无法解决的 js 报错问题 北京致远互联软件股份有限公司 88 / 105

89 栏目内配置的 sso 数据集成 功能集成 网页集成都可能存在显示不全, 没有滚动条支持, 因为栏目和被集成系统的页面有一定影响关系, 包含一些代码的页面可能不支持显示滚动条, 推 荐使用新窗口模式 北京致远互联软件股份有限公司 89 / 105

90 9 数据备份与恢复 提醒 : 定期做数据库备份 ; 数据备份包分离存储 ; 9.1 MySQL 数据备份与恢复 Mysql 数据的备份与恢复可手工采用 mysqldump 的方式备份 / 恢复, 亦可采用 小地球 的 备份功能 ( 仅针对集中部署的 MySQL 服务, 请参考 小地球 章节 ) MySQL 数据库的备份 说明 备份前, 请先停止产品服务, 以保证数据的完整性 备份命令示例 Mysqldump uroot -p P3306 -h E R --single-transaction -BV50 > D:\backup\v sql 命令解释 -uroot: 指定备份用户为 root; -p123456: 指定用户的密码, 其中 为密码, 需要输入正确的 root 用户密码 ; -P3306: 大写的字母 P, 指定 mysql 服务的端口, 默认为 3306, 可以不设置 ; -h : 指定 mysql 服务的地址, 默认 , 可以不设置 ; -E: 导出 mysql 的事件 (events), 可以不指定 ; -R: 导出 mysql 的存储过程及函数, 可以不指定 ; --single-transaction: 此参数仅支持 InnoDB 引擎, 此参数将锁表, 为保持事务 / 数据一致 性 ; -B V50: 指定导出的数据库名称, 其中 V50 为数据库名称 ; 目录 > D:\backup\v sql: 指定备份文件的物理路径及文件名 ; 其他说明 执行 mysqldump 命令,Windows 系统需进入 mysql 程序的 bin 目录,Linux 系统需进入 /usr/bin MySQL 数据库的恢复 说明 北京致远互联软件股份有限公司 90 / 105

91 还原前, 请确认当前数据库中与备份数据库名称一致的数据不再使用, 恢复将覆盖对应数据库中的数据 还原命令示例 mysql uroot p P3306 h < D:\backup\v sql 命令解释 -uroot -p P3306 h : 指定用户名 密码 端口 IP 地址 ; < D:\backup\v sql: 指定恢复用 sql 文件的物理路径及文件名 ; 其他说明 执行 mysql 命令, 在 Windows 系统需要进入 mysql 程序的 bin 目录,Linux 系统需进入 /usr/bin 目录 9.2 Oracle 数据备份与恢复 Oracle 数据的备份与恢复采用数据的导出导入方式 Oracle 数据库备份恢复步骤概述 第一步 : 选用 exp Expdp 中其中一种数据导出方法 ( 推荐使用 expdp 方式 ), 备份出原 A8-V5 服务数据 ; 第二步 : 在目标数据库服务器上新建一个与原服务名称一样的表空间及用户 ; 第三步 : 将备份出的 A8-V5 数据拷贝到目标数据库服务器上, 对目标数据库选用 imp Impdp 中其中一种数据恢复方法, 导入备份出来的 A8-V5 数据 ; 第四步 : 在 A8-V5 应用服务器上, 打开 A8-V5 安装目录中的 ApacheJetspeed\conf, 使用 A8-V5 应用配置工具 修改 A8-V5 的数据库链接地址, 指向新的数据库 ; 第五步 : 重新启动 A8-V5 服务 imp/exp 方式 : exp 和 imp 是 Oracle 的工具程序, 在成功安装了 Oracle Client 客户端后就可以执行 imp 或 exp 命令了 它们即可以在数据库客户端使用, 也可以在数据库服务端使用 Windows 数据库服务器 : 在 Windows 中打开命令提示符, 或者在开始 -> 运行中输入 cmd, 回车后进入命令提示符窗口, 在命令行中执行如下格式语句 ( 如下两种语句在 Linux 下格式相同 ): 导入数据格式 :imp < 用户名 >/< 密码 >@ <instance_sid> file=</ 路径 / 文件名 >.dmp full=y 导出数据格式 :exp < 用户名 >/< 密码 >@ <instance_sid> file=</ 路径 / 文件名 >.dmp 如下图所示为 Windows 下导出数据的格式 : 北京致远互联软件股份有限公司 91 / 105

92 注意 : 一定要记下 A8-V5 所使用的表空间名及用户名, 方便在导入时创建表空间及用户 在目标数据库服务器上创建好用户及表空间后, 就可以使用 imp 命令导入备份出来的数据 了 如下图所示为 Windows 下导入数据的格式 : 导入成功后, 在命令行中会有如下提示 : Linux 数据库服务器 : 在 Linux 下打开终端 ( 应用程序 -> 系统工具 -> 终端 ), 在命令行中先用 su Oracle 命令切 换至 Oracle 用户下 (Oracle 用户有写入权限的路径, 否则导出会报错的 ), 如下图 : 导出数据文件的目录最好选择 Oracle 用户的目录, 可以在切换到 Oracle 用户后使用 pwd 命令查看 Oracle 用户的主目录, 如下图 : 在 Oracle 用户下, 才能使用 imp 或 exp 命令 如下图所示为 Oracle 用户下导出数据格式 : 北京致远互联软件股份有限公司 92 / 105

93 成功导出后会有如下提示 : 在目标数据服务器上创建相同名称的数据库表空间及用户后, 可以使用 imp 命令导入数据 ( 导入前必须在目标数据库服务器上创建与原数据库相同名称的表空间及用户 ) 下图为导入数据格式 : 导入成功后会有如下提示 : Expdp/Impdp 方式 : EXPDP 和 IMPDP 是服务端的工具程序, 他们只能在 ORACLE 服务端使用, 不能在客户端使用 Windows 数据库服务器 : 在 Windows 命令提示符下, 用 SQLPLUS 命令登录 sys 用户, 如下图所示 : 执行如下语句, 创建导出 / 导入目录, 并授权 : create or replace directory dumpdir as 导出 / 导入路径 ; grant read,write on directory dumpdir to scott; 注 : Scott 用户不一定是在每个数据库中都存在的, 只有在安装数据库的时候选择安装示例才有, 并改成 public 用户 执行格式及结果如下图所示 : 北京致远互联软件股份有限公司 93 / 105

94 在 Sqlplus 状态下输入 exit, 退出 Sqlplus, 在命令行中执行如下格式语句, 执行导出 导入 : 导出实例 :expdp < 用户名 >/< 密码 >@<instance_sid> DIRECTORY = dumpdir DUMPFILE=< 文件 名 >.dmp 导入实例 :impdp < 用户名 >/< 密码 >@<instance_sid> DIRECTORY= dumpdir DUMPFILE=< 文件 名 >.dmp 导出语句的格式如下图 : 导入语句格式如下图 ( 导入前必须在目标数据库服务器上创建与原数据库相同名称的表空间及用 户 ): Linux 数据库服务器 : 在 Linux 终端中输入 su oracle 切换至 oracle 用户, 用 pwd 命令查看 oracle 用户的目录, 如下图 : 用 Sqlplus 登录要导出数据的账户, 如下图 : 在 Sqlplus 命令行中执行如下语句, 创建导出 / 导入目录, 并授权 : create or replace directory dumpdir as 导出 / 导入路径 ; grant read,write on directory dumpdir to scott; 北京致远互联软件股份有限公司 94 / 105

95 执行结果如下图 : 在 Sqlplus 中输入 exit 退出到 oracle 用户命令行中, 在此命令行中执行如下格式导出 导入语句 : 导出实例 :expdp < 用户名 >/< 密码 >@<instance_sid> DIRECTORY = dumpdir DUMPFILE=< 文件 名 >.dmp 导入实例 :impdp < 用户名 >/< 密码 >@<instance_sid> DIRECTORY= dumpdir DUMPFILE=< 文件 名 >.dmp 执行格式如下图所示 : 导入格式 ( 导入前必须在目标数据库服务器上创建与原数据库相同名称的表空间及用户 ): 9.3 SQLServer 数据备份与恢复 物理备份方式 第一步 : 停止数据库服务 第二步 : 备份数据库对应的数据文件和日志文件, 查看数据库的属性可以看到数据文件和日 志文件的位置. 如下图 : 北京致远互联软件股份有限公司 95 / 105

96 9.3.2 逻辑备份方式 采用 SQLServer 自带的 Maintenance Plan Back Up DatabaseTask 完成, 详细操作步骤参考 SQLServer 数据库备份操作手册 北京致远互联软件股份有限公司 96 / 105

97 10 系统安全 10.1 Windows 系统安全 本章节主要描述操作系统环境安全方面的事宜, 请认真阅读 Windows 安全补丁 请定期从微软网站更新最新的安全补丁 Windows 分区 分区要求 系统分区 A8 应用程序所在分区必须为 NTFS 格式 权限要求 系统分区只给 administrator system 权限 ; A8 应用程序所在分区只给 administrator system 权限, 若为 Win2008 Vista Win7 操作系统, 启动 A8 的 startup.bat 时, 请以管理员身份启动 ; C:/Documents and Settings/All Users/Application Data 目录需再次设置权限给 administrator system, 去掉 everyone 用户, 其他分区只给 administrator 用户权限 ; Windows 帐户 尽量不创建其他系统管理用户, 更改 Administrator 用户默认的账户名及描述, 密码最好采 用数字加大小写字母组合且有一定长度, 并定期更改密码 建议新建一个名为 Administrator 的陷阱帐号, 为其设置最小的权限, 然后输入复杂组合的密码 将 Guest 账户禁用并更改名称和描述, 然后输入一个复杂的密码 Windows 服务 在运行中输入 services.msc 回车, 打开 Windows 服务项, 禁用掉一些不需要可能造成安全 隐患的服务 建议禁止服务项有以下几种 : Remote Registry 服务, 远程连接注册表 Task Scheduler 服务, 自动运行程序 Telnet 服务,telnet 远程登录 Workstation 服务, 禁止掉可防止一些系统漏洞 敏感信息的获取 北京致远互联软件股份有限公司 97 / 105

98 Server 服务, 默认共享, 服务器不需要共享可禁止 TCP/IP NetBIOS Helper 服务, 服务器不需要共享可禁止 中国协同软件行业连续 12 年市场占有率第一 IIS 服务, 不需要则停用或卸载,IIS 在操作系统安装时可选择不安装 Windows 策略 在运行中输入 gpedit.msc 回车, 打开组策略编辑器, 选择计算机配置 -Windows 设置 在安全设置 - 帐户策略 - 帐户锁定策略, 将帐户设为 : 三次登陆无效 锁定时间为 30 分钟 复位锁定计数设为 30 分钟 在安全设置 - 本地策略 - 安全选项中, 对以下描述选项做对应操作 : 交互式登陆 : 不显示上次的用户名启用 网络访问 : 可匿名访问的共享全部删除 网络访问 : 可匿名访问的命名管道全部删除 网络访问 : 可远程访问的注册表路径全部删除 网络访问 : 可远程访问的注册表路径和子路径 全部删除 帐户 : 重命名来宾帐户 重命名一个来宾帐户 在安全设置 - 本地策略 - 用户权限分配中, 对以下描述选项做对应操作 : 关闭系统 : 只有 Administrators 组 其它全部删除 ; 通过终端服务拒绝登陆 : 加入 Guests Users 组 ; 通过终端服务允许登陆 : 只加入 Administrators 组其他全部删除 ; 安全设置 - 本地策略 - 审核策略, 在创建审核项目时, 需要注意的是如果审核的项目太多, 生 成的事件也就越多, 那么要想发现严重的事件也越难, 当然如果审核的太少也会影响你发现 严重的事件, 你需要根据情况在这二者之间做出选择 推荐的要审核的项目是 : 登录事件成功失败 账户登录事件成功失败 系统事件成功失败 策略更改成功失败 对象访问失败 目录服务访问失败 特权使用失败 网络服务安全管理 禁止 C$ D$ ADMIN$ 一类的缺省共享打开注册表, 进入 : HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\lanmanserver\parameter s 在右边的窗口中新建 Dword 值, 名称设为 AutoShareServer 值设为 0 解除 NetBios 与 TCP/IP 协议的绑定 在 网络连接 里, 把不需要的协议和服务都删掉, 建议只安装基本的 Internet 协议 北京致远互联软件股份有限公司 98 / 105

99 (TCP/IP), 若要控制带宽流量服务, 则需安装 Qos 数据包计划程序 在高级 TCP/IP 设置里 -- NetBIOS 设置 禁用 TCP/IP 上的 NetBIOS(S) 具体做法是 右击网上邻居 - 属性 - 右击本地连接 - 属性 - 双击 Internet 协议 - 高级 -Wins- 禁用 TCP/IP 上的 NETBIOS 在本地连接属性的 高级 选项里, 使用 Windows 防火墙, 这是 Windows 2003 自带的防 火墙, 这样已经基本达到了一个 IPSec 的功能 其他 系统维护 : 安装防火墙 防病毒木马等必要软件 端口记录 运行服务器, 记录当前的程序和开放的端口, 将当前服务器的进程抓图或记录下来, 将 其保存, 方便以后对照查看是否有不明的程序 启用 Windows 防火墙, 只开放 web 服务 (80 端口 ) 注 : 在 2003 系统里, 不推荐用 TCP/IP 筛选里的端口过滤功能, 譬如在使用 FTP 服务器的时候, 如果仅仅只开放 21 端口, 在进行 FTP 传输的时候, 由于 FTP 特有的 Port 模式和 Passive 模式, 在进行数据传输的时候, 需要动态的打开高端口, 所以在使用 TCP/IP 过滤的情况下, 经常会出 现连接上后无法列出目录和数据传输的问题 所以在 2003 系统上增加的 Windows 连接防火墙能 很好的解决这个问题, 所以都不推荐使用网卡的 TCP/IP 过滤功能 友情提示, 系统运营维护中更多常见问题解决方案请登录自助服务网站 查询 10.2 环境安全 数据库安全 对于使用的相关数据库, 请采取如下措施 : MySQL: 建议使用 MySQL 版本 Oracle: 建议打最新官方补丁包 SQLServer: 建议打最新官方补丁包 中间件安全 对于使用的相关中间件, 请采取如下措施 : WAS: 建议打最新官方补丁包 Weblogic: 建议打最新官方补丁包 北京致远互联软件股份有限公司 99 / 105

100 Apache 安全 使用 Apache 服务的, 需要注意禁用 jk 控制台, 降低相关安全风险 操作系统安全 对于使用的相关操作系统, 请采取如下措施 : Windows 操作系统请参考第一节 Windows 系统安全 Linux: 建议打最新官方补丁包 Unix: 建议打最新官方补丁包 启用 HTTPS 无特殊情况, 建议开启 HTTPS 以保障客户端与服务器端交互的数据传输安全 数据信息安全 需要注意全文检索索引数据 Office 转换数据 系统上传数据和数据库文件的存储安全, 包括 相关硬件和操作系统的安全防护, 加强对可以接触这些敏感数据的人员管理等, 避免不必要的信 息丢失和泄露 10.3 客户端安全 客户端环境安全 对于使用协同产品的客户端 ( 包括 PC 端 移动端 ), 要做好安全防护措施, 安装基本的防病毒 / 木马软件和客户端相关安全产品 客户端认证安全 对于有相关安全需求的客户, 建议使用客户端认证狗, 或更高安全级别的 CA 客户端认证解决方案 北京致远互联软件股份有限公司 100 / 105

101 11 迁移方案 11.1 说明 本章节的迁移是指更换硬件服务器 重做操作系统 重新安装产品或者数据库中间件, 不涉 及异构数据库的迁移 ( 如 : 不涉及 MySQL 迁移 Oracle Tomcat 迁移 WAS 等 ) 11.2 应用服务器迁移步骤 在迁移的新应用服务器上安装 A8, 安装步骤参考 应用软件安装 章节, 数据库信息填写 最终使用的数据库 ; 将原应用服务器下 [A8 安装路径 ]\ApacheJetspeed\webapps\seeyon\USER-DATA main 下的 所有文件拷贝至新的服务器对应目录下 ; 将原应用服务器下 [A8 安装路径 ]\base 下的所有文件拷贝至新的服务器对应目录下 ; 注意 : 更换了硬件服务器, 则需要在新的应用服务器注册加密狗 ; 若附件的存放路径变化了, 需要修改分区设置, 具体操作参照用户操作手册 ; 若应用 数据库服务器 IP 地址改变, 请修改 A8 应用配置器 A8 相关插件中关于 A8 应用 数据库服务器地址的配置 ( 如数据库连接地址 全文检索 Apache NC GKE 金迪短信 ); 11.3 数据库服务器迁移 MySQL 数据库迁移方案 在新服务器上安装 MySQL 服务 ; 停止原 新 A8 的 MySQL 服务 ; 备份原 MySQL 数据库至新的 MySQL 服务并恢复 ; 启动 A8 应用配置器, 修改数据库链接至新数据库地址, 参考 服务器端配置章节 ; 启动新的 MySQL 服务, 启动 A8; SQLServer 数据库迁移方案 本方案采用物理备份方式 物理备份原 SQLServer 数据库, 备份过程参考本手册 SQLServer 数据备份与恢复 章节 ; 将备份的数据文件拷贝至新的 SQLServer 数据库服务器上 ; 使用 SQLServer 的挂载功能, 挂载备份的数据文件, 如下图所示 ; 北京致远互联软件股份有限公司 101 / 105

102 在弹出的 Attach Database 界面, 使用 Add 按钮添加拷贝的备份数据文件, 如下图所示, 选择数据文件 ; 注意 : 挂载时必须保证新的 SQLServer 数据库上无重名数据库 挂载数据库成功后, 启动 A8 应用配置器, 修改数据库链接至新服务器, 参考 服务器端配 置章节 ; Oracle 数据迁移方案 备份 A8 的 Oracle 数据库, 备份方法参考本手册 Oracle 数据备份与恢复 章节 ; 将备份好的数据文件恢复至新的 Oracle 数据库服务器, 恢复方法参考本手册 Oracle 数据 备份与恢复 章节 ; 启动 A8 应用配置器, 修改数据库链接至新服务器, 参考 服务器端配置章节 ; 北京致远互联软件股份有限公司 102 / 105

103 12 常见问题解答 12.1 系统常见问题 问题一. 启动 A8 的时候提示 80 端口被占用 解决方案 查看 \A8 \ApacheJetspeed\logs_sy 中的 ctp, 如果在日志中查看 严重 : Error initializing endpoint java.net.bindexception: Address already in use: JVM_Bind:80, 则需要通过以下方法 进行解决 : 停止 A8 服务, 改变默认端口配置 : 在应用配置管理器 (SeeyonConfig) 中, 将 80 端口修改成其他空闲端口 问题二. 调用 Office 正文的时候显示 北京致远软件 加对应的版本号, 如何显示出客户名称? 解决方案 需要与致远商务联系定制客户方专用的 Office 认证信息 更新操作步骤请参考 Office 认证章节 ; 问题三. 启动 A8 报错, 日志显示报错信息 验证产品加密狗无效 : error:**** 解决方案 常见报错 1001: 未找到加密狗, 请确认服务器是否放置硬件加密狗 常见报错 : 加密狗或软加密文件绑定 MAC 地址与当前服务器已启用的有 IP 地址 的网卡 MAC 不匹配 问题四. 升级后,A8 系统启动失败 解决方案 检查执行的安装程序 lib 下的 all.log error.log 日志文件, 确认在升级过程中是否有报错信息 注意 : 在升级之前, 必须关闭 A8 服务 检测方法是在 任务管理器 中, 确认 A8 服务占用的 java 是否已经关闭 如果安装的是 mysql 数据库, 在升级前, 需要单独启动 mysql 问题五. Apache 服务不能正常启动 解决方案 80,443 端口被占用, 通过 DOS 下,netstat a 检查 问题六. A8 系统迁移后, 全文检索不能正常使用, 在系统迁移之前是正常的 解决方案 全文检索的查询文件默认放置在安装路径 \base\index 文件夹中 如果做系统迁移, 除了做数据 恢复之外, 还需要将 \base 路径下的 index 文件夹拷贝到新的安装目录中, 就可以对历史数据进 行全文检索了 问题七. 重复安装时提示 数据源读取失败, 且配置数据源连接时 URL 无法自动生成 解决方案 检查系统中是否存在产品的注册信息 : Windows 下检查注册表 : 北京致远互联软件股份有限公司 103 / 105

104 (32 位 )HKEY_LOCAL_MACHINE\SOFTWARE \SEEYON\A8; (64 位 )HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\SEEYON\A8 Linux 下检查 /root/.config/seeyoninstall_a8.info 中国协同软件行业连续 12 年市场占有率第一 检查注册信息中 SEEYON_PATH 所示路径下的 A8 是否存在, 且其应用配置器 (SeeyonConfig) 可 以配置连接数据库 12.2 数据库常见问题 问题一. 进行数据库连接测试, 出现报错提示, 如下图所示, 从而导致 A8 启动失败 解决方案 Oracle9i Oracle10g 拷贝 $ oracle_client_home /client_1/jdbc/lib 下的 classes12.jar 和 ojdbc14.jar 文件到 A8_home /ApacheJetspeed/lib 下 ; Oracle11g 拷贝 $ oracle_client_home /client_1/jdbc/lib 下的 ojdbc5.jar 文件到 A8_home / ApacheJetspeed /lib 下 ( 如果 A8_home / ApacheJetspeed /lib 存在 classes12.jar 和 ojdbc14.jar, 则必须删除这两个文件, 否则将不能正常运行 ) 问题二. Oracle 数据库 alter.log 出现 Heap size 3392K exceeds notification threshold (2048K) 告警 解决方案 1 修改此隐含参数 SQL> alter system set "_kgl_large_heap_warning_threshold"= scope=spfile; 2 使用命令重启 Oracle 服务, 或者直接重启 Oracle 服务器操作系统 SQL> shutdown immediate SQL> startup 北京致远互联软件股份有限公司 104 / 105

105 1 修改参数后, 如何用 sys 查看隐藏参数修改是否生效 : select ksppinm, ksppstvl from x$ksppcv cv, x$ksppi pi where cv.indx = pi.indx and pi.ksppinm like '_kgl_large_heap_warning_threshold%'; 原因在于 Oracle 的 Bug, 已经把这个值修改为 50M, 升级 到也可解 决 北京致远互联软件股份有限公司 105 / 105