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

泛微云橋e-Bridge 安裝手冊

一、 概述

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

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

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

1.

2.

3.

4.

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

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

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

6.

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

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

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

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

www.weaver.com.cn

上海耀華支路39弄9號（通耀路濟明路路口) 200127

電話： 021-68860398傳真：021-50942278 第1頁共9頁

●

●

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

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

1. Windows 版本程序安裝

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

jdk64

mysql

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

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

install32.bat ）

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

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

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

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

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

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

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

如果這幾個端口被占用，請根據(jù)需要進行修改，修改方式

mysql 端口修改：

mysqlmy.ini 中的 port = 4706

tomcatwebappsROOTWEB-INFclassesinit.properties中

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

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

tomcat 端口修改： tomcatconfserver.xml

如果有補丁包則需升級補丁包文件

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

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

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

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

2. Linux 版本程序安裝

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

www.weaver.com.cn

上海耀華支路39弄9號（通耀路濟明路路口) 200127

電話： 021-68860398傳真：021-50942278 第3頁共9頁

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

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

如果有補丁包則上傳補丁包文件

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

執(zhí)行安裝程序

./install.sh

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

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

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

www.weaver.com.cn 上海耀華支路39弄9號（通耀路濟明路路口) 200127

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

/etc/my.cnf中的 port = 4706

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

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

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

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

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

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

注意事項

此安裝包適合64位的linux

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

linux 注意事項

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

vi /etc/selinux/config

SELINUX = disabled

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

serviceipables stop

四、 License 提交

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

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

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

www.weaver.com.cn

上海耀華支路39弄9號（通耀路濟明路路口) 200127

電話： 021-68860398傳真：021-50942278 第5頁共9頁

e-Bridge 的License 控制包含幾個方面

1、 使用時間：驗收之前只會給到1至2個月的使用期限，驗收后給到永久期限

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

賬號數(shù)量

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

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

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

眾號集成合同，合同未注明個數(shù)的只有

1個）

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

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

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

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

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

五、 開通外網(wǎng)

因為本系統(tǒng)需要調(diào)用微信或者釘釘開放的接口，并且最終用戶是通過微信或者釘釘來使用集成的功能，所以本系統(tǒng)部署的服務(wù)器必須要求

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

www.weaver.com.cn

上海耀華支路39弄9號（通耀路濟明路路口) 200127

電話： 021-68860398傳真：021-50942278 第6頁共9頁

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

a)

b)

c) d) 企業(yè)號接口測試：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 服務(wù)器用服務(wù)器上的瀏覽器訪問上述地址，如果是Linux 服務(wù)器，則執(zhí)行curl 命令檢測上面的地址，如curl https://qyapi.weixin.qq.com/cgi-bin/menu/get看看返回的數(shù)據(jù)看看是否返回41001錯誤，例如

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

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

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

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

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

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

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

溫馨提示：

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

www.weaver.com.cn

上海耀華支路39弄9號（通耀路濟明路路口) 200127

電話： 021-68860398傳真：021-50942278 第7頁共9頁

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

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

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

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

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

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

址一樣

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

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

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

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

● 升級提醒：啟用了這個開關(guān)，一旦本系統(tǒng)有新版本管理員登陸系統(tǒng)的時候會提醒管理員

進行升級，建議開啟升級提醒，并進行升級確保您的平臺是最新版本

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

七、 集成平臺升級

您可以通過泛微網(wǎng)站下載最新的e-Bridge 最新的補丁包進行升級

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

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 服務(wù)管理器重啟ebridge_tomcat服務(wù)

2. Linux 上的升級操作

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

●

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

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

【e-cology 端升級文件】

編制：康淵炎

SubmitBy Weaver

2015/09/10

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

www.weaver.com.cn

上海耀華支路39弄9號（通耀路濟明路路口) 200127

電話： 021-68860398傳真：021-50942278 第9頁共9頁