泛微云橋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頁