PDF《致远 M3 移动工作平台 V3.0.0》

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

1 /

42 www.

seeyon.com 致远 M3 移动工作平台 V3.0.0 安装维护手册 北京致远互联软件股份有限公司

2 /

42 www.seeyon.com 前言 本手册对致远 M3 移动工作平台 V2.1.1 的安装及维护相关事宜进行说明,本手册适用于 A6+/A8+企业/A8+集团的 V7.0sp1 版本 . 如对安装维护手册中相关问题存在疑问,请 与公司客户服务人员联系. 北京致远互联软件股份有限公司

3 /

42 www.seeyon.com 目录

1 系统环境要求.6 1.1 服务端硬件环境.6 1.2 服务端软件环境.7 1.3 客户端操作系统.7 1.4 M3 支持注册和并发数.8

2 M3 部署图

8 2.1 分离部署拓扑图.8 2.2 集中部署拓扑图.9

3 加密注册和认证.9 3.1 说明.9

4 Windows 服务端安装.9 4.1 前提条件.9 4.2 M3 服务安装

9 4.3 配置 M3 单机服务器.12 4.4 启动停止.14 4.5 M3 卸载

14 5 Linux 服务端安装.16 北京致远互联软件股份有限公司

4 /

42 www.seeyon.com 5.1 前提条件.16 5.2 安装 M3 服务

16 5.3 配置 M3 单机服务器.17 5.4 启动停止.18 5.5 M3 卸载

19 6 系统集群配置.19 6.1 概要说明.19 6.2 应用集群配置.20 6.2.1 集群应用服务器配置.21

7 Apache 部署及配置

22 7.1 Apache 部署

23 7.2 Apache 启动

25 7.3 Apache 配置

25 7.3.1 配置 httpd.conf.26 7.3.2 配置 workers.properties

26 7.3.3 参数调优.28 7.4 Apache 启用 HTTPS 配置.28

8 移动安全支持.30 北京致远互联软件股份有限公司

5 /

42 www.seeyon.com 8.1 SSL 加密数据传输通道支持

30 8.2 VPN 支持

30 8.3 安全解决方案.31

9 产品版本支持.32

10 常见问题问答.33 10.1 客户端登录失败.33 10.2 检测 M3 服务端是否正确安装并正常启动.33 10.3 应用包下载与更新.34 10.3.1 初次使用,应用包下载.34 10.3.2 应用包的更新

34 10.3.3 部分应用包更新失败.36 10.3.4 无法下载应用包

37 10.4 代理服务器启动.38 10.5 客户端进入致信提示失败.38 10.6 华为手机收不到消息推送.39 10.7 HTTPS 加密算法不可用,提示无法连接

39 10.8 Weblogic 环境证书导入.40 北京致远互联软件股份有限公司

6 /

42 www.seeyon.com

1 系统环境要求 1.1 服务端硬件环境 M3 服务端运行硬件环境 配件 推荐配置 北京致远互联软件股份有限公司

7 /

42 www.seeyon.com CPU 主频 2.5GHz 以上、4 核CPU、二级缓存 2M 以上 硬盘 16M 缓存、7200 转、500G 以上 内存 DDR

3、4G 以上 1.2 服务端软件环境 M3 服务端运行软件环境 分类 详细信息 操作系统 Windows Windows Server 2003/2008/2012 Enterprise 32/64 Edition Linux Red Hat Enterprise edition 5.5 以上 SUSE Linux Enterprise

11、12 中间件 Tomcat Apache Tomcat 6.0.35 1.3 客户端操作系统 分类 支持版本 iOS 操作系统 iOS8 及以上 北京致远互联软件股份有限公司

8 /

42 www.seeyon.com Android 操作系统 Android4.4 及以上 1.4 M3 支持注册和并发数

1、M3 注册数受限于 PC 的注册数

2、M3 注册数不能大于 PC 的注册数

3、M3注册(并发)数与 PC 端并发(注册)发数之和,不能超过协同应用服务器的最大承 受范围

2 M3 部署图 2.1 分离部署拓扑图 北京致远互联软件股份有限公司

9 /

42 www.seeyon.com 2.2 集中部署拓扑图

3 加密注册和认证 3.1 说明 为了更好的保证用户的权利,M3 V2.1.1产品采用PC加密集中认证方式,启动M3不再需要 加密文件,只需要PC的加密文件里面包含M3插件即可.

4 Windows 服务端安装 4.1 前提条件 系统已经正确安装了 A6+/A8+企业/A8+集团的 V7.0sp1 版本. 4.2 M3 服务安装 第1步:将安装文件拷贝到系统中 第2步:右键以管理员方式运行 SeeyonM3Install.bat 北京致远互联软件股份有限公司

10 /

42 www.seeyon.com 第3步:选择接受,下一步 第4步:选择安装目录,并点击下一步 北京致远互联软件股份有限公司

11 /

42 www.seeyon.com 第5步:确认安装信息,并点击安装 第6步:等待安装进度完成,进入第

7 步 北京致远互联软件股份有限公司

12 /

42 www.seeyon.com 第7步:点击完成,结束安装 4.3 配置 M3 单机服务器

1、在安装目录下找到 tomcatconfchdirPathM3.bat 文件

2、填写 OA 服务器的地址及端口、M3 服务的端口、消息推送地址及端口,并点击保存 北京致远互联软件股份有限公司

13 /

42 www.seeyon.com 注意: (1)M3 支持配置连接 OA 的https 协议传输端口,配置 OA 地址时只需要配置成 https://OA 地址:端口. (2)M3 消息推送需要配置页面勾选开启消息推送的开关,然后登录 OA 的系统管理员, 在推送配置页面配置数据.如图: 北京致远互联软件股份有限公司

14 /

42 www.seeyon.com 4.4 启动停止

1、在安装目录下找到 tomcatbinstartup.bat 文件,双击运行,就可以启动 M3 服务器 2/安装目录下找到 tomcatbinshutdown.bat 文件,双击运行,就可以停止 M3 服务器 4.5 M3 卸载

1、在安装目录下找到 Uninstall_M3 uninstallM3.bat 文件,以管理员运行,弹出如下窗 口,点击卸载即可开始卸载. 北京致远互联软件股份有限公司

15 /

42 www.seeyon.com

2、等待卸载进度完成,进入第

3 步.

3、点击完成,机完成 M3 卸载 北京致远互联软件股份有限公司

16 /

42 www.seeyon.com

5 Linux 服务端安装 5.1 前提条件 系统已经正确安装了 A6+/A8-V5 企业版/A8-V5 集团版的 V7.0sp1 版本. 5.2 安装 M3 服务 ? 第1步:关闭其他运行程序,并停止 A6+/A8+企业/A8+集团的 V7.0sp1 版本服务. ? 第2步:将M3 安装包拷贝到 linux 系统下(如:路径/root/Desktop/M3/)PS:切 换到管理员账号执行安装,如root 账户 ? 第3步:给安装包中的所有文件赋权限 chmod

777 /root/Desktop/M3/* ? 第4步:给安装包中的 java 授权 chmod

777 /root/Desktop/M3/java/jre32/bin/java 北京致远互联软件股份有限公司

17 /

42 www.seeyon.com ? 第5步:M3 安装,执行命令 ./SeeyonM3Install.sh ? 后续界面操作参考 widows 的界面操作 5.3 配置 M3 单机服务器

1、在安装目录下找到 tomcatconfchdirPathM3.sh 文件,以管理员身份运行该文件

2、填写 OA 服务器的地址及端口、M3 服务的端口、消息推送地址及端口,并点击保存 注意: 北京致远互联软件股份有限公司

18 /

42 www.seeyon.com (1)M3 支持配置连接 OA 的https 协议传输端口,配置 OA 地址时只需要配置成 https://OA 地址:端口. (2)M3 消息推送需要配置页面勾选开启消息推送的开关,然后登录 OA 的系统管理员, 在推送配置页面,配置数据. 如图: 5.4 启动停止

1、启动 M3 服务,运行安装目录 tomcat/bin/startup.sh.

2、停止 M3 服务,运行安装目录 tomcat/bin/shutdown.sh. 北京致远互联软件股份有限公司

19 /

42 www.seeyon.com 5.5 M3 卸载

1、在安装目录下找到 Uninstall_M3 uninstallM3.sh 文件;

2、执行命令 ./uninstallM3.sh;

3、后续界面操作参考 widows 的界面操作.

6 系统集群配置 6.1 概要说明 M3 服务器集群支持多节点、水平集群,不支持垂直集群(多节点部署在同一服务器). 说明: ? 硬件配置参考 系统环境要求 章节;

? 应用程序安装参考 应用软件安装 章节;

? 集群支持 TomCat;

? 配置集群各应用版本说明 服务 版本 Apache HTTP Server 2.2.14 或以上版本 M3 Server 1.5.4 或以上版本 ? 集群的网络拓扑结构图 北京致远互联软件股份有限公司

20 /

42 www.seeyon.com 集群配置主要分两部分:应用集群配置、Apache 部署及配置. 以下分章节说明两部分的配置. 6.2 应用集群配置 应用的集群配置在应用配置工具(以下简称为 chdirPathM3)中进行,chdirPathM3 的启 动参考章节 4.3 和5.3 章节. ? 集群配置主要分为

2 个步骤: ? 应用节点配置,配置集群各节点参数信息;

? Web 服务器配置,所谓 Web 服务器为集群环境中支持 Web 访问的服务器,M3 支持 北京致远互联软件股份有限公司

21 /

42 www.seeyon.com Apache、 F5 (隶属 F5 NetWorks 公司的负载均衡设备) 作为 Web 服务器. 关于 Apache 的配置可参考第

7 章节,关于 F5 的配置请咨询 F5 公司的技术人员. 6.2.1 集群应用服务器配置 集群应用服务器的配置,步骤如下: ? 运行 chdirPathM3,选择 集群环境 选项;

? 勾选 集群环境 选项后,集群连接器设置部分参数处于可编辑状态;

? 端口、转发端口、引擎、host 默认不做修改. ? 【节点名称】默认为空,根据需要修改为所需名称,如m3server1,其他节点根据实 际集群节点数可设置为 m3server2,m3server3 等;

? 进行 chdirPathM3 其他基础配置,可参考 4.3 和5.3 章节;

chdirPathM3 配置图示: 北京致远互联软件股份有限公司

22 /

42 www.seeyon.com

7 Apache 部署及配置 说明: ? Apache 部署可以实现 web 挂接、https、双机热备或集群负载均衡方案;

? 产品安装包中预置的 Apache 为2.4.23 版本, 可根据客户实际需求调整 Apache 版本;

? 以下 Apache 部署及配置的说明以 2.4.23 版本为基础;

? Apache 2.4.23 的exe 程序不支持 windows2003,若使用 windows2003 可换用 Apache2.2 系列. 北京致远互联软件股份有限公司

23 /

42 www.seeyon.com 7.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:Apachebin httpd -k install ? Linux 系统部署 ? 安装相关组件 yum install autoconf yum install automake yum install libtool 北京致远互联软件股份有限公司

24 /

42 www.seeyon.com ? 安装 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 ./configure --prefix=/usr/local/apr make make install ? 安装 apr-util.拷贝安装程序根目录 Apache/Linux/apr-util1.5.4 至/home 目录,执 行以下命令进行 httpd 的安装(注意红色标注的为一条命令): cd /home/apr-util1.5.4 ./configure --prefix=/usr/local/apr-util --with-apr=/usr/local/apr 北京致远互联软件股份有限公司

25 /

42 www.seeyon.com make make install ? 安装 httpd.拷贝安装程序根目录 Apache/Linux/httpd-2.4.23 至/home 目录,执行 以下命令进行 httpd 的安装(注意红色标注的为一条命令): cd /home/httpd-2.4.23 ./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 文 件夹下. 7.2 Apache 启动 ? Windows 系统:在Windows 服务项中启动/停止 Apache 服务(服务项名称默认为 Apache2.4);

? Linux 系统:执行 service httpd start 启动 Apache.执行 service httpd stop 停止 Apache. 7.3 Apache 配置 注意:在进行以下配置前,需先进行 Apache 的部署. 北京致远互联软件股份有限公司

26 /

42 www.seeyon.com 7.3.1 配置 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 7.3.2 配置 workers.properties Apache 的conf /workers.properties 文件内容如下,红色粗体是需要修改的部分. 修改说明: ? worker.controller.balance_workers 为6.2.1 章节中配置节点名称. ? Worker.节点名称.host 值为对应 M3 服务器的 IP;

worker.list = controller,status worker.status.type=status worker.controller.type=lb #与tomcat 的server.xml 中jvmRoute 的值一致 北京致远互联软件股份有限公司

27 /

42 www.seeyon.com 集群的其他节点请依次按照上述内容格式添加信息,需添加点如下: # worker.controller.balance_workers=m3server1,m3server2 worker.controller.sticky_session=1 worker.controller.sticky_session_force=0 #与tomcat 的server.xml 中协议为 AJP/1.3 的Connector 端口一致 # worker.m3server1.port=8009 worker.m3server1.host=128.2.3.144 worker.m3server1.type=ajp13 worker.m3server1.lbfactor=1 worker.m3server1.retries=3 worker.controller.balance_workers=m3server1,m3server2…… Worker.节点名称.port=8009 worker.节点名称.host= 请填写节点 IP 地址 worker.节点名称.type=ajp13 北京致远互联软件股份有限公司

28 /

42 www.seeyon.com 7.3.3 参数调优 修改 conf/httpd.conf,在该文件最后增加(若已存在对应参数,则修改对应数值,以确保 不小于示例中数值). ThreadsPerChild

150 MaxRequestsPerChild

1000 AcceptFilter http None AcceptFilter https None 7.4 Apache 启用 HTTPS 配置 说明: ? 若不使用 Apach................