前言 本手册对致远 M1 移动协同软件 V2.0.0(A6-m 版 ) 的安装及维护相关事宜进行说明, 本 手册适用于 A6-m V3.0sp2 版 +4 月修复包 如对安装维护手册中相关问题存在疑问, 请与公 司客户服务人员联系 北京致远协创软件有限公司 2 / 33

Transcription

1 致远 M1 移动协同软件 V2.0.0 (A6-m 版 ) 安装维护手册 北京致远协创软件有限公司 1 / 33

2 前言 本手册对致远 M1 移动协同软件 V2.0.0(A6-m 版 ) 的安装及维护相关事宜进行说明, 本 手册适用于 A6-m V3.0sp2 版 +4 月修复包 如对安装维护手册中相关问题存在疑问, 请与公 司客户服务人员联系 北京致远协创软件有限公司 2 / 33

3 目录 1 M1 部署图 分离部署拓扑图 集中部署拓扑图 Windows 服务端安装 前提条件 安装 M1 服务 分离部署 集中部署 M1 加密文件 注册和删除开机自动启动 M1 服务 启动停止 M1 升级 M1 卸载 Linux 服务端安装 前提条件 安装 M1 服务 分离部署 集中部署 M1 加密文件 注册和删除开机自动启动 M1 服务 启动停止 M1 升级 M1 卸载 移动安全支持 SSL 加密数据传输通道支持 北京致远协创软件有限公司 3 / 33

4 4.2 VPN 支持 安全解决方案 产品版本支持 常见问题问答 问题 1: 客户端登录失败 问题 2: 修改 M1 的配置 北京致远协创软件有限公司 4 / 33

5 1 M1 部署图 1.1 分离部署拓扑图 中国协同软件市场连续七年占有率第一 北京致远协创软件有限公司 5 / 33

6 1.2 集中部署拓扑图 2 Windows 服务端安装 2.1 前提条件 系统已经正确安装了 A6-m V3.0SP2+4 月修复包产品 2.2 安装 M1 服务 分离部署分离部署 : 移动应用服务与协同应用服务分别部署在 2 台服务器, 并保持网络互通 移动组件安装 移动组件要安装在 A6 协同应用服务器上 第 1 步 : 关闭其他运行程序, 并停止 A6 服务 第 2 步 : 将 M1 安装包拷贝到 windows 系统下 北京致远协创软件有限公司 6 / 33

7 第 3 步 :M1 安装, 点击文件 M1_A6-m_Setup.exe(08_64 位系统请用管理员身份运行 ) 第 4 步 : 点击 下一步 第 5 步 : 勾选 移动组件, 再点击 下一步 北京致远协创软件有限公司 7 / 33

8 第 6 步 : 确认安装软件生成的 A6 产品中 tomcat 文件夹的路径是否正确, 再点击 下一 步 ;PS: 如果没有检查到路径就手工选择 A6 产品中 tomcat 文件夹的路径 第 7 步 : 点击 完成 北京致远协创软件有限公司 8 / 33

9 M1 服务端安装 M1 服务端安装在其他服务器上, 与 A6 协同服务器保持网络互通 第 1 步 : 将 M1 安装包拷贝到 windows 系统下 第 2 步 :M1 安装, 点击文件 M1_A6-m_Setup.exe(08_64 位系统请用管理员身份运行 ) 第 3 步 : 点击 下一步 第 4 步 : 勾选 M1 服务端, 再点击 下一步 北京致远协创软件有限公司 9 / 33

10 第 5 步 : 选择 M1 服务端安装路径, 再点击 下一步 第 6 步 : 勾选 系统配置, 再点击 完成 北京致远协创软件有限公司 10 / 33

11 第 7 步 : 填写 A6 产品的 IP 地址和访问端口 (HTTP 访问的 IP 和端口 ), M1 服务器访问 端口建议使用默认值 暂不支持链接产品的 HTTPS 访问 配置界面的说明 : A6-m 协同的地址和端口的填写是为了保证 M1 移动服务能链接上 A6-m 产品 移动客户端通过 M1 服务器访问端口连接登陆 A6 协同系统 北京致远协创软件有限公司 11 / 33

12 不论是集中部署或分离部署,Ipad IPhone Android 客户端不能再通过直接连接 A6 协同地址登陆系统, 都必须通过连接 M1 服务端登陆系统 集中部署集中部署 : 移动应用服务与协同应用服务部署在同一台服务器上 第 1 步 : 关闭其他运行程序, 并停止 A6 服务 第 2 步 : 将 M1 安装包拷贝到 windows 系统下 第 3 步 :M1 安装, 点击文件 M1_A6-m_Setup.exe(08_64 位系统请用管理员身份运行 ) 第 4 步 : 点击 下一步 第 5 步 : 勾选 移动组件 和 M1 服务端, 再点击 下一步 北京致远协创软件有限公司 12 / 33

13 第 6 步 : 确认安装软件生成的 A6 产品中 tomcat 文件夹的路径是否正确, 再点击 下一 步 ;PS: 如果没有检查到路径就手工选择 A6 产品中 tomcat 文件夹的路径 第 7 步 : 勾选 系统配置, 再点击 完成 北京致远协创软件有限公司 13 / 33

14 第 8 步 : 填写 A6 产品的 IP 地址和访问端口 (HTTP 访问的 IP 和端口 ), M1 服务器访问 端口建议使用默认值 暂不支持链接产品的 HTTPS 访问 配置界面的说明 : A6-m 协同的地址和端口的填写是为了保证 M1 移动服务能链接上 A6-m 产品 北京致远协创软件有限公司 14 / 33

15 移动客户端通过 M1 服务器访问端口连接登陆 A6 协同系统 不论是集中部署或分离部署,Ipad IPhone Android 客户端不能再通过直接连接 A6 协同地址登陆系统, 都必须通过连接 M1 服务端登陆系统 2.3 M1 加密文件 加密文件 : 使用 M1 移动协同软件, 需要移动加密文件 mobile.key 在启动 A6 服务前, 请检查加密文件是否正确安装 加密文件存放路径 : \OA\tomcat\webapps\yyoa\ext\mobile 文件夹 图 - 移动加密文件存放路径 2.4 注册和删除开机自动启动 M1 服务 进入 M1 安装目录 ( 如 : 路径 C:\A6\UFSeeyon\M1\service) 注册服务 : 点击文件 regm1service.bat(08_64 位系统请用管理员身份运行 ) 北京致远协创软件有限公司 15 / 33

16 删除服务 : 点击文件 unregm1service.bat(08_64 位系统请用管理员身份运行 ) 2.5 启动停止 前提 : 注册了 M1 服务 启动 M1 服务 : 点击文件 startm1service.bat 停止 M1 服务 : 点击文件 stopm1service.bat 2.6 M1 升级 前提 : 停止 M1 服务如果之前安装过低版本的 M1 服务器端, 升级到 V2.0.0 的方法同直接安装 V2.0.0 版本的方法 2.7 M1 卸载 前提 : 停止 M1 服务 卸载 M1 服务 : 点击文件 uninstallm1.exe(08_64 位系统请用管理员身份运行 ) 北京致远协创软件有限公司 16 / 33

17 3 Linux 服务端安装 3.1 前提条件 系统已经正确安装了 A6-m V3.0SP2+4 月修复包产品 3.2 安装 M1 服务 分离部署分离部署 : 移动应用服务与协同应用服务分别部署在 2 台服务器, 并保持网络互通 移动组件安装 移动组件要安装在 A6 协同应用服务器上 第 1 步 : 关闭其他运行程序, 并停止 A6 服务 第 2 步 : 将 M1 安装包拷贝到 linux 系统下 ( 如 : 路径 home/m1a6/)ps: 切换到管理员 账号执行安装, 如 root 账户 第 3 步 : 给安装包中的所有文件赋权限 北京致远协创软件有限公司 17 / 33

18 第 4 步 :M1 安装, 执行命令 第 5 步 : 点击 下一步 第 6 步 : 勾选 移动组件, 再点击 下一步 北京致远协创软件有限公司 18 / 33

19 第 7 步 : 确认安装软件生成的 A6 产品中 tomcat 文件夹的路径是否正确, 再点击 下一 步 ;PS: 如果没有检查到路径就手工选择 A6 产品中 tomcat 文件夹的路径 第 8 步 : 点击 完成 北京致远协创软件有限公司 19 / 33

20 M1 服务端安装 M1 服务端安装在其他服务器上, 与 A6 协同服务器保持网络互通 第 1 步 : 将 M1 安装包拷贝到 linux 系统下 ( 如 : 路径 home/m1a6/)ps: 切换到管理员 账号执行安装, 如 root 账户 第 2 步 : 给安装包中的所有文件赋权限 第 3 步 :M1 安装, 执行命令 北京致远协创软件有限公司 20 / 33

21 第 4 步 : 点击 下一步 第 5 步 : 勾选 M1 服务端, 再点击 下一步 第 6 步 : 选择 M1 服务端安装路径, 再点击 下一步 北京致远协创软件有限公司 21 / 33

22 第 7 步 : 勾选 系统配置, 再点击 完成 第 8 步 : 填写 A6 产品的 IP 地址和访问端口 (HTTP 访问的 IP 和端口 ), M1 服务器访问 端口建议使用默认值 暂不支持链接产品的 HTTPS 访问 北京致远协创软件有限公司 22 / 33

23 配置界面的说明 : A6-m 协同的地址和端口的填写是为了保证 M1 移动服务能链接上 A6-m 产品 移动客户端通过 M1 服务器访问端口连接登陆 A6 协同系统 不论是集中部署或分离部署,Ipad IPhone Android 客户端不能再通过直接连接 A6 协同地址登陆系统, 都必须通过连接 M1 服务端登陆系统 集中部署集中部署 : 移动应用服务与协同应用服务部署在同一台服务器上 第 1 步 : 关闭其他运行程序, 并停止 A6 服务 第 2 步 : 将 M1 安装包拷贝到 linux 系统下 ( 如 : 路径 home/m1a6/)ps: 切换到管理员 账号执行安装, 如 root 账户 第 3 步 : 给安装包中的所有文件赋权限 北京致远协创软件有限公司 23 / 33

24 第 4 步 :M1 安装, 执行命令 第 5 步 : 点击 下一步 第 6 步 : 勾选 移动组件 和 M1 服务端, 再点击 下一步 北京致远协创软件有限公司 24 / 33

25 第 7 步 : 确认安装软件生成的 A6 产品中 tomcat 文件夹的路径是否正确, 再点击 下一 步 ;PS: 如果没有检查到路径就手工选择 A6 产品中 tomcat 文件夹的路径 第 8 步 : 勾选 系统配置, 再点击 完成 北京致远协创软件有限公司 25 / 33

26 第 9 步 : 填写 A6 产品的 IP 地址和访问端口 (HTTP 访问的 IP 和端口 ), M1 服务器访问 端口建议使用默认值 暂不支持链接产品的 HTTPS 访问 配置界面的说明 : A6-m 协同的地址和端口的填写是为了保证 M1 移动服务能链接上 A6-m 产品 北京致远协创软件有限公司 26 / 33

27 移动客户端通过 M1 服务器访问端口连接登陆 A6 协同系统 不论是集中部署或分离部署,Ipad IPhone Android 客户端不能再通过直接连接 A6 协同地址登陆系统, 都必须通过连接 M1 服务端登陆系统 3.3 M1 加密文件 加密文件 : 使用 M1 移动协同软件, 需要移动加密文件 mobile.key 在启动 A6 服务前, 请检查加密文件是否正确安装 加密文件存放路径 :\tomcat\webapps\yyoa\ext\mobile\ 文件夹 图 - 移动加密文件存放路径 3.4 注册和删除开机自动启动 M1 服务 进入 M1 安装目录 ( 如 : 路径 /usr/local/ufseeyon/m1/service) 注册服务的命令 :./regm1service.sh 北京致远协创软件有限公司 27 / 33

28 PS: 如果是集中部署会出现如 图 1, 就多执行一条命令如 图 2 : SUSE LINUX 系统的命令 : chkconfig -f -s m1service 35 REDHAT LINUX 系统的命令 : chkconfig --level 35 m1service 图 1 删除服务的命令 :./unregm1service.sh 图 2 北京致远协创软件有限公司 28 / 33

29 3.5 启动停止 前提 : 注册了 M1 服务 启动 M1 服务, 命令 :./startm1service.sh 停止 M1 服务, 命令 :./stopm1service.sh 3.6 M1 升级 前提 : 停止 M1 服务如果之前安装过低版本的 M1 服务器端, 升级到 V2.0.0 的方法同直接安装 V2.0.0 版本的方法 3.7 M1 卸载 前提 : 停止 M1 服务 卸载 M1 服务, 命令 :./uninstallm1.sh 北京致远协创软件有限公司 29 / 33

30 4 移动安全支持 致远 M1 产品提供了多种安全防护解决方案供您选择, 以下是对上述方案的安全技术说明, 并提出关于如何加强信息安全保护的最佳实践和建议 4.1 SSL 加密数据传输通道支持 M1 产品基于 Https 传输协议, 提供端到端的加密数据传送方式, 数据在传送之前, 移动设备需和服务器端建立安全通道, 之后所有传输数据均经过 RSA DES 加密算法加密, 有效防止通讯过程中数据的泄密和被篡改 4.2 VPN 支持 由于 M1 的运行环境是移动设备, 所以对于 VPN 的支持取决于移动终端的系统环境以及 VPN 厂家的客户端支持, 以下为您列举截止 M1 发版时已知 VPN 支持情况 : 1 PPTP( 点对点隧道协议 ) VPN PPTP 协议属于数据链路层协议, 具有较强的通用性, 目前 Ipad Iphone Android 对其均有良好的支持, 所以市面上所有 PPTP 类型 VPN 产品我们均可兼容 注 : 由于我们没有在所有品牌设备上进行过测试, 所以建议实际上线前针对您选用的设备进行验证 注意 : 个别地区 3G 网络不支持 PPTP 类型 VPN, 只能通过 wifi 连接 2 L2TP( 第二层隧道协议 ) VPN 北京致远协创软件有限公司 30 / 33

31 与 PPTP VPN 情况相同, 目前 Ipad Iphone Android 对 L2TP VPN 均有良好的支持, 所以市面上所有 L2TP 类型 VPN 产品我们均可兼容 注 : 由于我们没有在所有品牌设备上进行过测试, 所以建议实际上线前针对您选用的设备进行验证 3 IPSec(Internet 安全协议 ) VPN IPSec VPN 一般分为 RSA 预置共享密钥和基于证书的安全认证两种, 目前 Ipad Iphone Android 对其均有支持, 可兼容市面主流产品 注 : 由于我们没有在所有品牌设备上进行过测试, 所以建议实际上线前针对您选用的设备进行验证 4 SSL VPN SSL VPN 基于传输层协议, 具有效率高 成本低 无客户端等优势, 各厂商都在主打此类产品替代传统 IPSec VPN 但是由于 SSL VPN 基于浏览器, 所以存在很多兼容性问题, 各厂商对于非 IE 浏览器和非 windows 系统的支持情况不一, 导致目前在移动设备上无法支持所有厂商的 SSL VPN 产品, 且此问题主要依赖厂商解决, 从我们的产品角度只能依赖系统平台 目前已知可支持移动设备的 SSL VPN 厂商包括 : Cisco F5 Juniper 深信服 SSL VPN 注 : 由于我们目前仅测试了深信服 SSLVPN 可以使用, 没有其他相关设备进行测试, 所以建议针对您选用的设备与 VPN 厂商取得联系确认 4.3 安全解决方案 1. 服务器防火墙开放 9943 端口 ( 配置设置的值 ), 移动端采用 HTTPS 连接安全级别 : 中优点 : 部署简单 管理成本低 兼容性好, 实现了数据安全加密传输 缺点 : 用户身份认证依赖于协同系统账号验证, 如果您对 VPN 有强烈需求, 此方案难以满足 2. 使用 VPN 接入内网安全级别 : 中高优点 : 安全级别较高 部署较简单 认可度高 缺点 : 管理成本较高 依赖 vpn 厂商对移动平台的支持 部分地区目前 3G 网络不 北京致远协创软件有限公司 31 / 33

32 支持数据链路层 VPN 5 产品版本支持 以下是对本次发布的致远 M1 移动协同软件 V2.0.0 所支持的 A6-m 产品版本的说明 : 支持产品 A6-m V3.0 sp2+4 月修复包 支持版本 企业版 规格 Windows Server 2003/2008 X32 SUSE LinuxX32 REDHAT LinuxX32 MySQL5 企业版 Windows Server 2003/2008 X64 SUSE LinuxX64 REDHAT LinuxX64 MySQL5 政务版 Windows Server 2003/2008x32 SUSE LinuxX32 REDHAT LinuxX32 MySQL5 政务版 Windows Server 2003/2008 X64 SUSE LinuxX64 REDHAT LinuxX64 MySQL5 6 常见问题问答 6.1 问题 1: 客户端登录失败 原因 1: 服务器地址或端口没有设置, 或者设置错误 原因 2: 未被授权移动应用, 请系统管理员 (system) 进行移动授权 原因 3: 致远 M1 移动套件未正确安装, 或服务端 A6 版本不匹配 北京致远协创软件有限公司 32 / 33

33 原因 4: 服务器端无移动加密文件, 或加密文件与加密狗号不匹配 6.2 问题 2: 修改 M1 的配置 原因 1:A6 产品服务器地址或端口的改变, 或者设置错误 修改文件路径 :M1\tomcat\webapps\seeyon\WEB-INF\classes\com\seeyon\m1\resources 修改文件中的红色部分 ( 为 A6 产品的 IP 地址和端口 ): 文件 urlprocess.properties 里的 A6A8=http\:// \:80 原因 2: 修改移动客户端访问端口 修改文件路径 :M1\tomcat\conf 修改文件中红色部分 ( 依次为移动客户端连接使用的普通连接于安全连接的端口 ): 文件 server.xml 里的 <Connector port="9999" protocol="http/1.1" connectiontimeout="20000" redirectport="9943" /> <Connector port="9943" protocol="org.apache.coyote.http11.http11nioprotocol" scheme="https" secure="true" SSLEnabled="true" clientauth="false" sslprotocol="tls" keystorefile="keystore/serverkeystore.jks" keystorepass="seeyon"/> 北京致远协创软件有限公司 33 / 33