泛微云橋e-Bridge 安裝手冊(cè)一、 概述泛微云橋（e-Bridge ）是上海泛微公司在”互聯(lián)網(wǎng) ”的背景下研發(fā)的一款用于橋接互聯(lián)網(wǎng)開(kāi)放資源與企業(yè)信息化系統(tǒng)的系統(tǒng)集成中間件。截止自本手冊(cè)編制之日e-

泛微云橋e-Bridge 安裝手冊(cè)

一、 概述

泛微云橋（e-Bridge ）是上海泛微公司在”互聯(lián)網(wǎng) ”的背景下研發(fā)的一款用于橋接互聯(lián)網(wǎng)開(kāi)放資源與企業(yè)信息化系統(tǒng)的系統(tǒng)集成中間件。截止自本手冊(cè)編制之日e-Bridge 已實(shí)現(xiàn)了騰訊微信及阿里釘釘開(kāi)放接口的封裝，企業(yè)可以通過(guò)e-Bridge 快速實(shí)現(xiàn)基于微信及釘釘?shù)囊苿?dòng)辦公應(yīng)用接入。對(duì)于泛微協(xié)同辦公產(chǎn)品e-cology 更是實(shí)現(xiàn)了可視化的配置接入。后續(xù)e-bridge 將整合更多的互聯(lián)網(wǎng)信息化資源，讓企業(yè)能夠更加便利的利用開(kāi)放的互聯(lián)網(wǎng)資源進(jìn)行企業(yè)信息化建設(shè)。

本手冊(cè)基于e-Bridge20150910版本編制，之前版本產(chǎn)品名稱為【泛微微信&釘釘集成平臺(tái)】本手冊(cè)同樣適用于之前的版本，之前的版本下文說(shuō)明中涉及的目錄ebridge 均為ewechat 。

二、 安裝環(huán)境要求

1.

2.

3.

4.

5. 適用操作系統(tǒng)：windows xp、7、8、2003、2008、2012、Linux 系列 使用的web 服務(wù)：tomcat （安裝包已包含無(wú)需單獨(dú)安裝） 使用的數(shù)據(jù)庫(kù)：mysql （安裝包已包含無(wú)需單獨(dú)安裝） 標(biāo)準(zhǔn)安裝包支持64位操作系統(tǒng)，非64位操作系統(tǒng)需要單獨(dú)處理 網(wǎng)絡(luò)環(huán)境要求：

a) e-Bridge 需要開(kāi)通外網(wǎng)訪問(wèn)，安裝e-Bridge 的服務(wù)器可訪問(wèn)外網(wǎng)

b) e-Bridge 需要能夠與被集成的系統(tǒng)之間相互訪問(wèn)

6.

7. PC 端訪問(wèn)瀏覽器要求：支持IE8及以上、谷歌、360，建議用360極速模式 如果集成微信企業(yè)號(hào)：手機(jī)微信版本必須是6.2及以上，并且只支持安卓和IOS

三、 產(chǎn)品基本安裝

您可以通過(guò)泛微云橋網(wǎng)站下載最新的安裝包和補(bǔ)丁包進(jìn)行安裝，下載地址，如下圖所示

上海泛微網(wǎng)絡(luò)科技股份有限供公司

www.weaver.com.cn

上海耀華支路39弄9號(hào)（通耀路濟(jì)明路路口) 200127

電話： 021-68860398傳真：021-50942278 第1頁(yè)共9頁(yè)

●

●

● 安裝程序：windows 版、Linux 版請(qǐng)根據(jù)自己的服務(wù)器操作系統(tǒng)選擇其一下載 e-Bridge 補(bǔ)丁包：e-Bridege 的通用升級(jí)補(bǔ)丁包，可用于任何版本的e-Bridege 進(jìn)行升級(jí) e-cology 端升級(jí)文件：需要集成泛微e-cology 產(chǎn)品時(shí)需要在泛微e-cology 系統(tǒng)上升級(jí)的，

具體請(qǐng)查閱泛微e-cology 產(chǎn)品與微信、釘釘集成相關(guān)的手冊(cè)

1. Windows 版本程序安裝

將e-Bridge 的windows 版本安裝包進(jìn)行解壓，解壓后的文件應(yīng)該包含以下內(nèi)容：

jdk64

mysql

--64位JDK 目錄（32位版本是JDK32） --mysql 程序及數(shù)據(jù)庫(kù)目錄 --Tomcatweb 服務(wù)及程序文件 tomcat

install64.bat --e-Bridge 服務(wù)安裝文件（32位版本是

install32.bat ）

start.bat --e-Bridge 啟動(dòng)服務(wù)啟動(dòng)文件

stop.bat --e-Bridge 停止服務(wù)停止文件

restart.bat --e-Bridge服務(wù)重啟文件

將以上文件放置到：d:?ridge目錄下（也可以是其他目錄但不能包含中文空格及特殊上海泛微網(wǎng)絡(luò)科技股份有限供公司

www.weaver.com.cn

上海耀華支路39弄9號(hào)（通耀路濟(jì)明路路口) 200127

電話： 021-68860398傳真：021-50942278 第2頁(yè)共9頁(yè)

符號(hào)）如果不是這個(gè)目錄需要修改mysqlmy.ini 中的以下路徑

basedir=D:?ridgemysql

datadir=D:?ridgemysql?ta

Server=D:?ridgemysqlbinmysqld-nt.exe

系統(tǒng)需要占用mysql （4706） tomcat （8088 8444 8044 8045）端口

需要映射到外網(wǎng)的端口是8088（如有修改請(qǐng)按實(shí)際開(kāi)放映射）

如果這幾個(gè)端口被占用，請(qǐng)根據(jù)需要進(jìn)行修改，修改方式

mysql 端口修改：

mysqlmy.ini 中的 port = 4706

tomcatwebappsROOTWEB-INFclassesinit.properties中

# 使用mysql 數(shù)據(jù)庫(kù)

mysql.jdbcUrl = jdbc:mysql://127.0.0.1:4706 的數(shù)字

tomcat 端口修改： tomcatconfserver.xml

如果有補(bǔ)丁包則需升級(jí)補(bǔ)丁包文件

解壓補(bǔ)丁包文件得到ebridge 目錄，上傳覆蓋到ebridge 即可

如果是win2008、win7及以上系統(tǒng)請(qǐng)右鍵點(diǎn)擊 install64.bat 以管理員身份運(yùn)行進(jìn)行程序安裝 其他低版本的windows 系統(tǒng)直接雙擊運(yùn)行，安裝完成后會(huì)生成兩個(gè)服務(wù)

ebridge_tomcat：應(yīng)用服務(wù)，以后重啟應(yīng)用就是重啟這個(gè)服務(wù)

ebridge_mysql：數(shù)據(jù)庫(kù)服務(wù)，以后重啟數(shù)據(jù)庫(kù)就是重啟這個(gè)服務(wù)

2. Linux 版本程序安裝

將您獲得的e-Bridge 的Linux 版本安裝包進(jìn)行解壓，解壓后的文件應(yīng)該包含以下內(nèi)容： 上海泛微網(wǎng)絡(luò)科技股份有限供公司

www.weaver.com.cn

上海耀華支路39弄9號(hào)（通耀路濟(jì)明路路口) 200127

電話： 021-68860398傳真：021-50942278 第3頁(yè)共9頁(yè)

ebridge.tar.gz --ebridge 所有程序壓縮文件

init.sh --e-Bridge 初始化（解壓）執(zhí)行文件

install.sh --e-Bridge 安裝執(zhí)行文件

restart.sh --e-Bridge 重啟服務(wù)執(zhí)行文件

stop.sh --e-Bridge 停止服務(wù)執(zhí)行文件

uninstall.sh

在系統(tǒng)中創(chuàng)建ebridge 目錄

mkdir /usr/ebridge

上傳所有文件至ebridge 目錄下

cd /usr/ebridge

初始化安裝程序（解壓文件）

chmod x init.sh

./init.sh

--------------------------------------------------------

如果有補(bǔ)丁包則上傳補(bǔ)丁包文件

解壓補(bǔ)丁包文件得到ebridge 目錄，上傳覆蓋到 /usr/ebridge即可 --------------------------------------------------------

執(zhí)行安裝程序

./install.sh

#安裝后tomcat 默認(rèn)端口8088 ,mysql默認(rèn)端口4706

如果這幾個(gè)端口被占用，請(qǐng)根據(jù)需要進(jìn)行修改，修改方式 mysql 端口修改：

上海泛微網(wǎng)絡(luò)科技股份有限供公司

www.weaver.com.cn 上海耀華支路39弄9號(hào)（通耀路濟(jì)明路路口) 200127

電話： 021-68860398傳真：021-50942278 第4頁(yè)共9頁(yè) --e-Bridge 卸載執(zhí)行文件

/etc/my.cnf中的 port = 4706

/usr/ebridge/tomcat/webapps/ROOT/WEB-INF/classes/init.properties中

# 使用mysql 數(shù)據(jù)庫(kù)

mysql.jdbcUrl = jdbc:mysql://127.0.0.1:4706 的數(shù)字

tomcat 端口修改： /usr/ebridge/tomcat/conf/server.xml

以上執(zhí)行后、安裝過(guò)程全部完成。

--------------------------------------------------------

注意事項(xiàng)

此安裝包適合64位的linux

如需在32位的linux 下使用需單獨(dú)安裝32位jdk 及32位mysql

linux 注意事項(xiàng)

檢測(cè)selinux 是否關(guān)閉

vi /etc/selinux/config

SELINUX = disabled

防火墻是否允許端口訪問(wèn)，或關(guān)閉防火墻

serviceipables stop

四、 License 提交

安裝完成之后訪問(wèn)：http://服務(wù)器IP:8088 (請(qǐng)用實(shí)際安裝的tomcat 端口) 登陸系統(tǒng)：賬號(hào) sysadmin 密碼1，用戶可以自行修改賬號(hào)密碼

根據(jù)License 識(shí)別碼，向泛微客服人員申請(qǐng)license 授權(quán)文件（系統(tǒng)安裝完可以直接點(diǎn)擊頁(yè)面上的【獲取臨時(shí)License 】得到1個(gè)月的授權(quán)）

上海泛微網(wǎng)絡(luò)科技股份有限供公司

www.weaver.com.cn

上海耀華支路39弄9號(hào)（通耀路濟(jì)明路路口) 200127

電話： 021-68860398傳真：021-50942278 第5頁(yè)共9頁(yè)

e-Bridge 的License 控制包含幾個(gè)方面

1、 使用時(shí)間：驗(yàn)收之前只會(huì)給到1至2個(gè)月的使用期限，驗(yàn)收后給到永久期限

2、 用戶數(shù)：注冊(cè)用戶數(shù)，能夠在微信或者釘釘中使用e-Bridge 提供的功能的注冊(cè)用戶

賬號(hào)數(shù)量

3、 公眾號(hào)：能夠通過(guò)e-Bridge 管理多少個(gè)公眾號(hào)（根據(jù)合同約定給予，如果是微信公

眾號(hào)集成合同，合同未注明個(gè)數(shù)的只提供1個(gè)）

4、 企業(yè)號(hào)：能夠通過(guò)e-Bridge 管理多少個(gè)企業(yè)號(hào)（根據(jù)合同約定給予，如果是微信公

眾號(hào)集成合同，合同未注明個(gè)數(shù)的只有

1個(gè)）

5、 釘釘號(hào)：能夠通過(guò)e-Bridge 管理多少個(gè)企業(yè)號(hào)（根據(jù)合同約定給予，如果阿里釘釘

集成合同，合同未注明個(gè)數(shù)的只有1個(gè)）

6、 識(shí)別碼：和服務(wù)器硬件標(biāo)識(shí)綁定，一個(gè)license 只能在一個(gè)服務(wù)器上使用

7、 模塊License ：針對(duì)非標(biāo)配的模塊進(jìn)行單獨(dú)的License 控制，具體根據(jù)約同約定，合

同未約定的只提供與泛微e-cology 產(chǎn)品相關(guān)的模塊

五、 開(kāi)通外網(wǎng)

因?yàn)楸鞠到y(tǒng)需要調(diào)用微信或者釘釘開(kāi)放的接口，并且最終用戶是通過(guò)微信或者釘釘來(lái)使用集成的功能，所以本系統(tǒng)部署的服務(wù)器必須要求

上海泛微網(wǎng)絡(luò)科技股份有限供公司

www.weaver.com.cn

上海耀華支路39弄9號(hào)（通耀路濟(jì)明路路口) 200127

電話： 021-68860398傳真：021-50942278 第6頁(yè)共9頁(yè)

能夠訪問(wèn)外網(wǎng):就開(kāi)通這臺(tái)服務(wù)器上上網(wǎng)權(quán)限，讓這個(gè)服務(wù)器能夠訪問(wèn)互聯(lián)網(wǎng)（如果貴公司對(duì)網(wǎng)絡(luò)安全要求較高，至少需要讓這個(gè)服務(wù)器能夠訪問(wèn)*.weixin.qq.com * *.dingtalk.com*的地址 *號(hào)表示任意字符），檢測(cè)方式, 訪問(wèn)以下地址

a)

b)

c) d) 企業(yè)號(hào)接口測(cè)試：https://qyapi.weixin.qq.com/cgi-bin/menu/get 公眾號(hào)接口測(cè)試1：https://api.weixin.qq.com/cgi-bin/menu/get 公眾號(hào)接口測(cè)試2：http://file.api.weixin.qq.com/cgi-bin/media/get 釘釘號(hào)接口測(cè)試：https://oapi.dingtalk.com/user/get

如果是windows 服務(wù)器用服務(wù)器上的瀏覽器訪問(wèn)上述地址，如果是Linux 服務(wù)器，則執(zhí)行curl 命令檢測(cè)上面的地址，如curl https://qyapi.weixin.qq.com/cgi-bin/menu/get看看返回的數(shù)據(jù)看看是否返回41001錯(cuò)誤，例如

{"errcode":41001,"errmsg":"XXXXXXXX"}，如果返回的是這個(gè)則證明是可以的。

2、 外網(wǎng)能夠訪問(wèn)到本系統(tǒng)：請(qǐng)網(wǎng)絡(luò)管理員將本系統(tǒng)的訪問(wèn)地址映射到外網(wǎng)（為了后續(xù)能夠

使用更多的微信及釘釘開(kāi)放的接口，外網(wǎng)地址建議使用經(jīng)過(guò)ICP 備案的域名來(lái)訪問(wèn)，比如泛微公司的地址：http://wx.weaver.com.cn或者h(yuǎn)ttp://wx.weaver.com.cn:8088）

六、 基礎(chǔ)參數(shù)設(shè)置

設(shè)置入口：【系統(tǒng)設(shè)置】→【基礎(chǔ)參數(shù)設(shè)置】

根據(jù)企業(yè)實(shí)際環(huán)境設(shè)置一下幾個(gè)參數(shù)，然后點(diǎn)擊【保存】按鈕進(jìn)行保存

● 本系統(tǒng)外網(wǎng)地址：e-Bridge 的外網(wǎng)訪問(wèn)地址，即在公網(wǎng)上可以訪問(wèn)e-Bridge 的網(wǎng)址

溫馨提示：

上海泛微網(wǎng)絡(luò)科技股份有限供公司

www.weaver.com.cn

上海耀華支路39弄9號(hào)（通耀路濟(jì)明路路口) 200127

電話： 021-68860398傳真：021-50942278 第7頁(yè)共9頁(yè)

如果涉及到和微信公眾號(hào)（服務(wù)號(hào)、訂閱號(hào)）的集成則外網(wǎng)訪問(wèn)的地址必須是沒(méi)有端口的，需要讓客戶網(wǎng)絡(luò)管理員開(kāi)通不帶端口可以的公網(wǎng)訪問(wèn)地址否則無(wú)法接入微信公眾號(hào)（服務(wù)號(hào)、訂閱號(hào)）的接入，如果只做企業(yè)號(hào)的集成則無(wú)所謂端口，只要外網(wǎng)可以訪問(wèn)即可

外網(wǎng)地址盡量設(shè)置成域名而且是經(jīng)過(guò)ICP 備案的域名，這樣用戶在web 頁(yè)面輸入內(nèi)容的時(shí)候不會(huì)存在風(fēng)險(xiǎn)提示，而且后續(xù)可以用到更多的微信及釘釘提供的接口

● 本系統(tǒng)內(nèi)網(wǎng)地址：該地址主要用于被集成系統(tǒng)服務(wù)器訪問(wèn)使用，舉例說(shuō)明，假設(shè)要集成

的系統(tǒng)為泛微e-cology 系統(tǒng)，那么有幾種情況

? e-cology 系統(tǒng)與e-Bridge 在同一臺(tái)服務(wù)器上那么地址就是http://127.0.0.1:8088

? e-cology 系統(tǒng)與e-Bridge 在一個(gè)局域網(wǎng)內(nèi)則地址就是e-Bridge 的http://內(nèi)網(wǎng)IP 端口 ? 如果e-cology 系統(tǒng)與e-Bridge 不在一個(gè)網(wǎng)絡(luò)環(huán)境下，那么這個(gè)地址設(shè)置的和外網(wǎng)地

址一樣

總而言之，確保在被集成系統(tǒng)的服務(wù)器上能夠通過(guò)這個(gè)地址能夠訪問(wèn)到e-Bridge 即可

● 文件存放路徑：e-Bridge 中產(chǎn)生的文件存放的位置：

? Windows 下設(shè)置例子：d:?ridgefile

? Linux 下設(shè)置例子：/user/ebridge/file

● 升級(jí)提醒：?jiǎn)⒂昧诉@個(gè)開(kāi)關(guān)，一旦本系統(tǒng)有新版本管理員登陸系統(tǒng)的時(shí)候會(huì)提醒管理員

進(jìn)行升級(jí)，建議開(kāi)啟升級(jí)提醒，并進(jìn)行升級(jí)確保您的平臺(tái)是最新版本

注意：這里系統(tǒng)會(huì)對(duì)您設(shè)置的內(nèi)容進(jìn)行檢測(cè)，如果保存時(shí)有特別提示請(qǐng)務(wù)必注意。 至此，泛微云橋e-Bridge 安裝完畢，請(qǐng)按照其他配置手冊(cè)配置具體的功能。

七、 集成平臺(tái)升級(jí)

您可以通過(guò)泛微網(wǎng)站下載最新的e-Bridge 最新的補(bǔ)丁包進(jìn)行升級(jí)

上海泛微網(wǎng)絡(luò)科技股份有限供公司

www.weaver.com.cn

上海耀華支路39弄9號(hào)（通耀路濟(jì)明路路口) 200127

電話： 021-68860398傳真：021-50942278 第8頁(yè)共9頁(yè)

下載地址http://wx.weaver.com.cn/download，如下圖所示

請(qǐng)下載【e-Bridge 補(bǔ)丁包】，該升級(jí)補(bǔ)丁包，可用于任何版e-Bridge 進(jìn)行升級(jí)

1. windows 上的升級(jí)(早期安裝的版本以下的ebridge 是ewechat )

● 解壓補(bǔ)丁包文件得到ebridge 目錄，覆蓋到 d:/ebridge

● 通過(guò)windows 服務(wù)管理器重啟ebridge_tomcat服務(wù)

2. Linux 上的升級(jí)操作

(早期安裝的版本以下的ebridge 是ewechat )

●

● 解壓補(bǔ)丁包文件得到ebridge 目錄，上傳覆蓋到 /usr/ebridge 切換到/usr/ebridge目錄下執(zhí)行命令./restart.sh 重啟集成平臺(tái)服務(wù)

注意：如果通過(guò)e-Bridge 集成了其他系統(tǒng)，請(qǐng)務(wù)必同步升級(jí)被集成系統(tǒng)相關(guān)的補(bǔ)丁包，比如集成了泛微的e-cology 產(chǎn)品，那么請(qǐng)?jiān)趀-cology 產(chǎn)品中同步升級(jí)

【e-cology 端升級(jí)文件】

編制：康淵炎

SubmitBy Weaver

2015/09/10

上海泛微網(wǎng)絡(luò)科技股份有限供公司

www.weaver.com.cn

上海耀華支路39弄9號(hào)（通耀路濟(jì)明路路口) 200127

電話： 021-68860398傳真：021-50942278 第9頁(yè)共9頁(yè)