泛微云桥e-Bridge安装手册2015V4.0
泛微云桥e-Bridge 安装手册一、 概述泛微云桥（e-Bridge ）是上海泛微公司在”互联网 ”的背景下研发的一款用于桥接互联网开放资源与企业信息化系统的系统集成中间件。截止自本手册编制之日e-
泛微云桥e-Bridge 安装手册
一、 概述
泛微云桥（e-Bridge ）是上海泛微公司在”互联网 ”的背景下研发的一款用于桥接互联网开放资源与企业信息化系统的系统集成中间件。截止自本手册编制之日e-Bridge 已实现了腾讯微信及阿里钉钉开放接口的封装，企业可以通过e-Bridge 快速实现基于微信及钉钉的移动办公应用接入。对于泛微协同办公产品e-cology 更是实现了可视化的配置接入。后续e-bridge 将整合更多的互联网信息化资源，让企业能够更加便利的利用开放的互联网资源进行企业信息化建设。
本手册基于e-Bridge20150910版本编制，之前版本产品名称为【泛微微信&钉钉集成平台】本手册同样适用于之前的版本，之前的版本下文说明中涉及的目录ebridge 均为ewechat 。
二、 安装环境要求
1.
2.
3.
4.
5. 适用操作系统：windows xp、7、8、2003、2008、2012、Linux 系列 使用的web 服务：tomcat （安装包已包含无需单独安装） 使用的数据库：mysql （安装包已包含无需单独安装） 标准安装包支持64位操作系统，非64位操作系统需要单独处理 网络环境要求：
a) e-Bridge 需要开通外网访问，安装e-Bridge 的服务器可访问外网
b) e-Bridge 需要能够与被集成的系统之间相互访问
6.
7. PC 端访问浏览器要求：支持IE8及以上、谷歌、360，建议用360极速模式 如果集成微信企业号：手机微信版本必须是6.2及以上，并且只支持安卓和IOS
三、 产品基本安装
您可以通过泛微云桥网站下载最新的安装包和补丁包进行安装，下载地址，如下图所示
上海泛微网络科技股份有限供公司
www.weaver.com.cn
上海耀华支路39弄9号（通耀路济明路路口) 200127
电话： 021-68860398传真：021-50942278 第1页共9页
,
●
●
● 安装程序：windows 版、Linux 版请根据自己的服务器操作系统选择其一下载 e-Bridge 补丁包：e-Bridege 的通用升级补丁包，可用于任何版本的e-Bridege 进行升级 e-cology 端升级文件：需要集成泛微e-cology 产品时需要在泛微e-cology 系统上升级的，
具体请查阅泛微e-cology 产品与微信、钉钉集成相关的手册
1. Windows 版本程序安装
将e-Bridge 的windows 版本安装包进行解压，解压后的文件应该包含以下内容：
jdk64
mysql
--64位JDK 目录（32位版本是JDK32） --mysql 程序及数据库目录 --Tomcatweb 服务及程序文件 tomcat
install64.bat --e-Bridge 服务安装文件（32位版本是
install32.bat ）
start.bat --e-Bridge 启动服务启动文件
stop.bat --e-Bridge 停止服务停止文件
restart.bat --e-Bridge服务重启文件
将以上文件放置到：d:�ridge目录下（也可以是其他目录但不能包含中文空格及特殊上海泛微网络科技股份有限供公司
www.weaver.com.cn
上海耀华支路39弄9号（通耀路济明路路口) 200127
电话： 021-68860398传真：021-50942278 第2页共9页
,
符号）如果不是这个目录需要修改mysqlmy.ini 中的以下路径
basedir=D:�ridgemysql
datadir=D:�ridgemysql�ta
Server=D:�ridgemysqlbinmysqld-nt.exe
系统需要占用mysql （4706） tomcat （8088 8444 8044 8045）端口
需要映射到外网的端口是8088（如有修改请按实际开放映射）
如果这几个端口被占用，请根据需要进行修改，修改方式
mysql 端口修改：
mysqlmy.ini 中的 port = 4706
tomcatwebappsROOTWEB-INFclassesinit.properties中
# 使用mysql 数据库
mysql.jdbcUrl = jdbc:mysql://127.0.0.1:4706 的数字
tomcat 端口修改： tomcatconfserver.xml
如果有补丁包则需升级补丁包文件
解压补丁包文件得到ebridge 目录，上传覆盖到ebridge 即可
如果是win2008、win7及以上系统请右键点击 install64.bat 以管理员身份运行进行程序安装 其他低版本的windows 系统直接双击运行，安装完成后会生成两个服务
ebridge_tomcat：应用服务，以后重启应用就是重启这个服务
ebridge_mysql：数据库服务，以后重启数据库就是重启这个服务
2. Linux 版本程序安装
将您获得的e-Bridge 的Linux 版本安装包进行解压，解压后的文件应该包含以下内容： 上海泛微网络科技股份有限供公司
www.weaver.com.cn
上海耀华支路39弄9号（通耀路济明路路口) 200127
电话： 021-68860398传真：021-50942278 第3页共9页
,
ebridge.tar.gz --ebridge 所有程序压缩文件
init.sh --e-Bridge 初始化（解压）执行文件
install.sh --e-Bridge 安装执行文件
restart.sh --e-Bridge 重启服务执行文件
stop.sh --e-Bridge 停止服务执行文件
uninstall.sh
在系统中创建ebridge 目录
mkdir /usr/ebridge
上传所有文件至ebridge 目录下
cd /usr/ebridge
初始化安装程序（解压文件）
chmod x init.sh
./init.sh
--------------------------------------------------------
如果有补丁包则上传补丁包文件
解压补丁包文件得到ebridge 目录，上传覆盖到 /usr/ebridge即可 --------------------------------------------------------
执行安装程序
./install.sh
#安装后tomcat 默认端口8088 ,mysql默认端口4706
如果这几个端口被占用，请根据需要进行修改，修改方式 mysql 端口修改：
上海泛微网络科技股份有限供公司
www.weaver.com.cn 上海耀华支路39弄9号（通耀路济明路路口) 200127
电话： 021-68860398传真：021-50942278 第4页共9页 --e-Bridge 卸载执行文件
,
/etc/my.cnf中的 port = 4706
/usr/ebridge/tomcat/webapps/ROOT/WEB-INF/classes/init.properties中
# 使用mysql 数据库
mysql.jdbcUrl = jdbc:mysql://127.0.0.1:4706 的数字
tomcat 端口修改： /usr/ebridge/tomcat/conf/server.xml
以上执行后、安装过程全部完成。
--------------------------------------------------------
注意事项
此安装包适合64位的linux
如需在32位的linux 下使用需单独安装32位jdk 及32位mysql
linux 注意事项
检测selinux 是否关闭
vi /etc/selinux/config
SELINUX = disabled
防火墙是否允许端口访问，或关闭防火墙
serviceipables stop
四、 License 提交
安装完成之后访问：http://服务器IP:8088 (请用实际安装的tomcat 端口) 登陆系统：账号 sysadmin 密码1，用户可以自行修改账号密码
根据License 识别码，向泛微客服人员申请license 授权文件（系统安装完可以直接点击页面上的【获取临时License 】得到1个月的授权）
上海泛微网络科技股份有限供公司
www.weaver.com.cn
上海耀华支路39弄9号（通耀路济明路路口) 200127
电话： 021-68860398传真：021-50942278 第5页共9页
,
e-Bridge 的License 控制包含几个方面
1、 使用时间：验收之前只会给到1至2个月的使用期限，验收后给到永久期限
2、 用户数：注册用户数，能够在微信或者钉钉中使用e-Bridge 提供的功能的注册用户
账号数量
3、 公众号：能够通过e-Bridge 管理多少个公众号（根据合同约定给予，如果是微信公
众号集成合同，合同未注明个数的只提供1个）
4、 企业号：能够通过e-Bridge 管理多少个企业号（根据合同约定给予，如果是微信公
众号集成合同，合同未注明个数的只有
1个）
5、 钉钉号：能够通过e-Bridge 管理多少个企业号（根据合同约定给予，如果阿里钉钉
集成合同，合同未注明个数的只有1个）
6、 识别码：和服务器硬件标识绑定，一个license 只能在一个服务器上使用
7、 模块License ：针对非标配的模块进行单独的License 控制，具体根据约同约定，合
同未约定的只提供与泛微e-cology 产品相关的模块
五、 开通外网
因为本系统需要调用微信或者钉钉开放的接口，并且最终用户是通过微信或者钉钉来使用集成的功能，所以本系统部署的服务器必须要求
上海泛微网络科技股份有限供公司
www.weaver.com.cn
上海耀华支路39弄9号（通耀路济明路路口) 200127
电话： 021-68860398传真：021-50942278 第6页共9页
,
能够访问外网:就开通这台服务器上上网权限，让这个服务器能够访问互联网（如果贵公司对网络安全要求较高，至少需要让这个服务器能够访问*.weixin.qq.com * *.dingtalk.com*的地址 *号表示任意字符），检测方式, 访问以下地址
a)
b)
c) d) 企业号接口测试：https://qyapi.weixin.qq.com/cgi-bin/menu/get 公众号接口测试1：https://api.weixin.qq.com/cgi-bin/menu/get 公众号接口测试2：http://file.api.weixin.qq.com/cgi-bin/media/get 钉钉号接口测试：https://oapi.dingtalk.com/user/get
如果是windows 服务器用服务器上的浏览器访问上述地址，如果是Linux 服务器，则执行curl 命令检测上面的地址，如curl https://qyapi.weixin.qq.com/cgi-bin/menu/get看看返回的数据看看是否返回41001错误，例如
{"errcode":41001,"errmsg":"XXXXXXXX"}，如果返回的是这个则证明是可以的。
2、 外网能够访问到本系统：请网络管理员将本系统的访问地址映射到外网（为了后续能够
使用更多的微信及钉钉开放的接口，外网地址建议使用经过ICP 备案的域名来访问，比如泛微公司的地址：http://wx.weaver.com.cn或者http://wx.weaver.com.cn:8088）
六、 基础参数设置
设置入口：【系统设置】→【基础参数设置】
根据企业实际环境设置一下几个参数，然后点击【保存】按钮进行保存
● 本系统外网地址：e-Bridge 的外网访问地址，即在公网上可以访问e-Bridge 的网址
温馨提示：
上海泛微网络科技股份有限供公司
www.weaver.com.cn
上海耀华支路39弄9号（通耀路济明路路口) 200127
电话： 021-68860398传真：021-50942278 第7页共9页
,
如果涉及到和微信公众号（服务号、订阅号）的集成则外网访问的地址必须是没有端口的，需要让客户网络管理员开通不带端口可以的公网访问地址否则无法接入微信公众号（服务号、订阅号）的接入，如果只做企业号的集成则无所谓端口，只要外网可以访问即可
外网地址尽量设置成域名而且是经过ICP 备案的域名，这样用户在web 页面输入内容的时候不会存在风险提示，而且后续可以用到更多的微信及钉钉提供的接口
● 本系统内网地址：该地址主要用于被集成系统服务器访问使用，举例说明，假设要集成
的系统为泛微e-cology 系统，那么有几种情况
⏹ e-cology 系统与e-Bridge 在同一台服务器上那么地址就是http://127.0.0.1:8088
⏹ e-cology 系统与e-Bridge 在一个局域网内则地址就是e-Bridge 的http://内网IP 端口 ⏹ 如果e-cology 系统与e-Bridge 不在一个网络环境下，那么这个地址设置的和外网地
址一样
总而言之，确保在被集成系统的服务器上能够通过这个地址能够访问到e-Bridge 即可
● 文件存放路径：e-Bridge 中产生的文件存放的位置：
⏹ Windows 下设置例子：d:�ridgefile
⏹ Linux 下设置例子：/user/ebridge/file
● 升级提醒：启用了这个开关，一旦本系统有新版本管理员登陆系统的时候会提醒管理员
进行升级，建议开启升级提醒，并进行升级确保您的平台是最新版本
注意：这里系统会对您设置的内容进行检测，如果保存时有特别提示请务必注意。 至此，泛微云桥e-Bridge 安装完毕，请按照其他配置手册配置具体的功能。
七、 集成平台升级
您可以通过泛微网站下载最新的e-Bridge 最新的补丁包进行升级
上海泛微网络科技股份有限供公司
www.weaver.com.cn
上海耀华支路39弄9号（通耀路济明路路口) 200127
电话： 021-68860398传真：021-50942278 第8页共9页
,
下载地址http://wx.weaver.com.cn/download，如下图所示
请下载【e-Bridge 补丁包】，该升级补丁包，可用于任何版e-Bridge 进行升级
1. windows 上的升级(早期安装的版本以下的ebridge 是ewechat )
● 解压补丁包文件得到ebridge 目录，覆盖到 d:/ebridge
● 通过windows 服务管理器重启ebridge_tomcat服务
2. Linux 上的升级操作
(早期安装的版本以下的ebridge 是ewechat )
●
● 解压补丁包文件得到ebridge 目录，上传覆盖到 /usr/ebridge 切换到/usr/ebridge目录下执行命令./restart.sh 重启集成平台服务
注意：如果通过e-Bridge 集成了其他系统，请务必同步升级被集成系统相关的补丁包，比如集成了泛微的e-cology 产品，那么请在e-cology 产品中同步升级
【e-cology 端升级文件】
编制：康渊炎
SubmitBy Weaver
2015/09/10
上海泛微网络科技股份有限供公司
www.weaver.com.cn
上海耀华支路39弄9号（通耀路济明路路口) 200127
电话： 021-68860398传真：021-50942278 第9页共9页