Deploy win
恩布Windows服务端安装手册
目录
概述
安装文档说明
本安装文档详细介绍,如何在企业内部部署完整ENTBOOST云通讯平台,包括云通讯平台服务端安装和配置、客户端程序自动打包等。
打包好的客户端程序自动生成zip文件(绿色版本)下载地址,可以提供给企业内部员工使用。
服务端系统要求
WindowsXP、Windows2000/2003、Windows7(或以上),(32/64位)版本;
支持数据库SQLite(恩布协作平台服务端内置集成数据库为SQLite,通常系统都支持);
[可选]PostgreSQL 8.4(32/64位)以上版本;
[可选]MySQL 5.1(32/64位)以上版本;
说明:
如果PostgreSQL数据库跟恩布服务装在同一台服务器,并且版本不一致,导致恩布服务启动时出现"Cannot open library:
PGService.dll '126'!"错误,解决方法,复制PostgreSQL安装bin目录下对应的dll动态库文件,替换ebs目录下对应文件。
准备环境和安装数据库
- 安装Windows32/64操作系统;(已有系统直接跳过)
- 安装并启动PostgreSQL数据库(或MySQL);(内置集成数据库直接跳过)
免安装部署恩布服务端
恩布协作平台服务端1.21以上版本(包括1.21版本),支持免安装自动部署恩布服务端;
恩布协作平台通讯服务目录:ebs;恩布协作平台通讯服务核心程序:ebs\CGCP.exe
双击CGCP.exe直接运行,会在自动部署和运行内置集成数据库版本的恩布协作平台服务端
免安装部署服务端配置和使用说明:
1)服务器地址:服务端运行的电脑的IP地址
2)端口:通讯端口为UDP 18012端口,HTTP端口为TCP 82端口,HTTPS端口为TCP 443端口
3)客户端连接地址设置为:[服务器地址]:18012,如:192.168.1.198:18012
4)IM预置帐号:默认有4个帐号,管理员帐号admin,普通用户帐号user1、user2、user3;帐号登录密码
为:12345678abc;这4个帐号可以用客户端直接登录使用;
其他使用信息请参照本文档其他部分。
安装部署恩布服务端
测试连接数据库
使用恩布内置数据库直接跳过本节内容;
配置entboost服务过程需要连接PostgreSQL或MySQL数据库,请检查启动PostgreSQL或MySQL数据库服务后,客户端工具连接测试正常才开始部署恩布服务端程序;
PostgreSQL连接工具有命令行工具psql和pgAdmin3等客户端程序。
pgsql测试连接命令:psql --host [数据库地址] --port [端口] --username postgres
MySQL连接工具有命令行工具mysql和MySQL-Front等客户端程序。
mysql测试连接命令:mysql –uroot -h[数据库地址] -p[root帐车密码]
进入install目录,双击执行ebs_config_win.exe程序;
所有配置项详细描述如下:
端口配置
通讯端口配置:端口为UDP协议类型端口,默认端口18012;
HTTP端口配置:端口为TCP协议类型端口,默认端口82;
HTTPS端口配置:端口为TCP协议类型端口,默认端口443;
注意:如果默认端口被占用或者与其他程序冲突时,请修改为其他可用的端口;
服务器地址配置
配置服务器地址:服务器地址格式两种:IP地址格式、域名格式;
配置时服务器地址必须为本机的IP地址或者本机域名;
注意:第一次配置,或者服务器地址更换后,会有"不是本机IP"提示;需要修改为正确的地址并保存,
如下图:
服务地址配置错误域名时,提示如下图:
点击"保存"可以打包客户端为zip格式压缩包,并生成在线客服网站嵌入HTML代码,如下图:
客户端正在打包界面,如下图:
打包客户端程序会自动生成zip文件(绿色版本),会部署到HTTP服务下(不需要另外安装APACHE程序),可以提供给企业内部员工使用;
服务端启动后,在浏览器中输入下载地址可以下载绿色版客户端:ebc_install.zip。
下载地址格式为:
http://[服务器地址]:[http端口号]/entboost/ebc_install.zip
举例如下:
IP配置时:http://192.168.1.198:82/entboost/ebc_install.zip
域名配置时:http://www.entboost.com:82/entboost/ebc_install.zip
更换IP功能
"更换IP"功能适用于配置好的服务端,当服务器地址(IP地址或域名)变更时,服务端可以用"更换IP"功能来更新服务器地址的配置;
勾选了左侧自动更换IP时,当本机IP发生变化时,服务端会在下一次启动时自动更换IP地址配置,默认配置一般不勾选,集群环境时自动
更换IP功能失效
使用"更改IP"功能有4个基本步骤,以如下例子进行说明:
服务端已经用IP地址配置好,需要更换服务器地址为域名:entboost.com;
1)退出服务端程序,
2)进入install目录,双击执行ebs_config_win.exe程序
3)在配置界面将"服务器地址"项修改为:entboost.com,
点击"更换IP"在提示的界面下完成配置如下图:
点击确定后会提示打包客户端程序:
4)启动服务端程序,完成配置
数据库配置
恩布协作平台服务端支持3种数据库,分别是:恩布内置数据库(SQLite数据库)、PostgreSQL数据库、MySQL数据库。
安装时可以依据现有环境自行选择,如下图:
以下分别对各数据库的配置进行说明:
1)恩布内置数据库SQLite配置界面如下:
选择内置数据库进行配置时,填写好数据库名,点击"保存"完成配置。
2)PostgreSQL数据库配置界面如下:
选择PostgreSQL数据库进行配置,填写好各项配置信息,点击"保存"完成配置;
注意:数据库PostgreSQL默认使用5432端口,如果手工修改过数据库的端口,"端口"项必须填写正确的
端口。
3)MySQL数据库配置界面如下:
选择MySQL数据库进行配置,填写好各项配置信息,点击"保存"完成配置;
注意:数据库MySQL默认使用3306端口,如果手工修改过数据库的端口,"端口"项必须填写正确端口。
导入初始数据
导入初始数据界面:
注意:第一次初始化必须导入数据,否则服务启动时连接数据库会失败;
警告:已经在正常运营的系统请慎重选择"导入数据"功能,或做好数据库备份,避免导致数据丢失;
导入初始化数据各项说明:
1)"导入数据库"项:此项默认不需要进行修改;
2)"公司名称"项:此项建议填写正确公司名称,配置完成后,客户端不提供修改公司名称功能;
3)"管理员帐号"和"管理员密码"项:服务端配置好后,作为IM管理员帐号的登录帐号和密码,请妥善保存好管理员帐号和密码;
4)各项信息填写正确后,点击"导入数据"进行数据的初始化,如下图:
确定后后台自动初始化数据库,成功后会提示:
"导入数据"操作其他提示说明:
1)SQLite数据库提示信息,界面如下图:
此时为内置数据库,点击确定会自动安装程序会自动备份原来的数据库文件,并且初始化一个新的IM服务端;
2)PostgreSQL数据库导入提示信息,界面如下图:
说明导入的PostgreSQL数据库已经存在;
解决方法:在数据库配置中填写新的数据库名,保存后,再次导入数据。
3)MySQL数据库导入提示信息,界面如下图:
说明导入的MySQL数据库已经存在,
解决方法:在数据库配置中填写新的数据库名,保存后,再次导入数据。
在线客服设置
修改900在线客服浮动条上面的电话号码,如下图:
启动、停止服务命令
恩布协作平台通讯服务目录:ebs;
恩布协作平台通讯服务核心程序:ebs\CGCP.exe;
启动恩布协作平台通讯服务:双击执行CGCP.exe:
客户端连接地址设置为:[服务器地址]:[通讯端口],如:192.168.1.198:18012
恩布协作平台服务端安装后默认有4个帐号,管理员帐号admin,管理员密码为配置中自定义;普通用户帐号user1、user2、user3
,帐号登录密码为:12345678abc;
正常运行的服务端界面,如下图:
注意:如果显示三条CommSslServer/ssl的错误,属于正常现象,不影响使用,
停止恩布云通讯服务:
命令行下,输入"exit"并回车,退出服务:
全部命令:
help打印命令帮助信息;
start启动服务;
stop停止服务
restart重启服务;
exit退出服务;
企业IM客户端软件使用
下载企业IM客户端软件页面
企业IM客户端软件下载页面,如图:
http://服务器域名或IP:http端口/entboost/index.html
如:http://192.168.1.198:82/entboost/index.html
请根据你实际公司环境修改相应的IP地址和端口;
管理公司组织结构
使用公司系统管理员帐号,登录企业IM客户端软件,管理公司组织结构(部门、项目组及部门员工等信息),具体操作见:
《ENTBOOST_IM_Client_PC_Manual.pdf》
分发给企业内部员工
把客户端软件下载地址,以及员工帐号、和密码(默认密码12345678abc)通过邮箱或QQ,发给公司员工
,让公司员工自行下载客户端登录。
建议使用专业安装打包工具,直接打包成安装程序,发给企业员工。
集成恩布900在线客服
功能介绍
成功部署恩布服务端,会默认生成一个9009301234客服号码,和一段在线客服网站内嵌HTML代码,保存在900_code.txt文件,类似以下格式:
<script type="text/javascript" src="http://服务器域名或IP:端口 /webim/js/onlinecall.js?to_account=9009301234"charset="UTF-8"></script>
把该代码(复制900_code.txt文件内容),嵌入到企业网站就可以实现企业网站在线客服功能,如下图:
集成代码例子请看:ebs\conf\web\samples\entboost\index.html文件,如果不需要在线客服功能,修改文件内容,去掉该行代码。
点击在线咨询,打开在线客服界面,如下图:
集成恩布WebIM产品-EntboostWeb
功能介绍
成功部署恩布服务端,会默认集成一个恩布WebIM产品EntboostWeb,访问地址如下:
http://服务器域名或IP:http端口/webim/client.html
如:http://192.168.1.198:82/webim/client.html
登录图片,如下图:
登录成功图片,如下图:
聊天界面:
附录一
防火墙内网IP安装方法
必须使用域名安装(用内网IP或外网IP安装会导致客户端登录失败或超时错误),然后在服务器本机增加一个DNS域名解析,指向本机的
内网IP地址即可。
例如:外网域名test.entboost.com,内网的ip为172.16.1.188;
服务端地址配置时用域名配置:test.entboost.com,同时本地添加DNS外网域名解析至内网IP:
Windows系统下修改C:\Windows\System32\drivers\etc目录下的hosts文件,在文件中添加一行:
172.16.1.188 test.entboost.com
服务器防火墙(机房)设置
如果浏览器或客户端不能正常访问,请检查服务端防火墙设置,是否过滤相应的端口,需要过滤默认端口如下:
HTTP端口:TCP,默认82端口;
HTTPS端口:TCP,默认443端口;
EB端口:UDP,默认18012端口;
远程桌面服务端口:UDP,默认17012端口;
音视频服务端口:UDP,默认17022,17032端口;
部分机房默认屏蔽UDP外网IP访问,如果使用了公网IP,并且不能正常访问,请联系机房运维技术人员沟通,添加UDP通讯权限。
SSL(HTTPS)设置
配置目录:/eb/ebs/conf/CommSslServer/ssl/
配置文件:
private.key:私钥KEY文件,利用工具自己生成;
public.crt:公钥证书文件,商业CA申请购买,或自己用工具签名生成;
(非商业CA购买证书,浏览器访问时会提示不信任,需要手工添加信任;商业购买证书不会提示风险问题;没有
正确配置安全证书,entboost服务启动时会提示443端口启动失败,不影响其他业务正常使用。)
intermediate.crt:[可选]证书合并文件;
测试连接数据库
配置entboost服务过程需要连接PostgreSQL或MySQL数据库,请检查启动PostgreSQL或MySQL数据库服务后,客户端工具连接测试正常才开
始部署恩布服务端程序;
PostgreSQL连接工具有命令行工具psql和pgAdmin3等客户端程序。
pgsql测试连接命令:psql --host [数据库地址] --port [端口] --username
postgres
MySQL连接工具有命令行工具mysql和MySQL-Front等客户端程序。(集成自带MySQL数据库root帐号默认密码为空。)
mysql测试连接命令:mysql –uroot -h[数据库地址]-p[root帐号密码]
检查远程MySQL帐号root@%权限
请检查远程MySQL帐号root@%的Super权限,确保选择Super权限,否则会导致导入函数失败。
权限错误提示:
ERROR 1227 (42000) at line 1374: Access denied; you need (at least one of) the SUPER privilege(s) for this operation
权限设置如图:(采用MySQL-Front工具)
低版本MySQL修改启动参数
如果采用MySQL数据库,建议使用最新5.6以上版本,低版本(如5.1.73版本)有可能会导入函数失败,请搜索my.ini配置文件
thread_stack,把默认128K改成至少256K,如下:
[mysqld]
thread_stack = 256K
修改完成后,请重启MySQL数据库服务;
部分Windows,出现"应用程序配置错误"解决
部分Windows系统(如Windows2008),会出现"应用程序配置错误。"
可以通过安装C++基础库解决:
先安装32位微软运行库:http://pan.baidu.com/s/1qWn8J6G
不能解决再安装64位微软运行库:http://pan.baidu.com/s/1gdzwxaj
部分Windows,服务端程序无法正常启动解决
部分Windows server 2003系统运行CGCP.EXE服务端程序,无法正常启动服务端程序,
解决办法:
运行服务端ebs目录下的CGCP-single-process.bat来启动服务端。
最新安装文档(PDF格式)
文档版本说明
版本日期 | 作者 | 内容 |
2014-05-07 | HD | 文档初稿。 |
2014-08-10 | HD | 增加内置集成PostgreSQL数据库安装说明; |
2014-09-01 | HD | 增加内置集成MySQL数据库安装说明; |
2014-10-24 | HD | 完善MySQL数据库连接参数,优化创建数据库帐号脚本; |
2015-01-16 | HD | 附录:增加防火墙内网IP安装方法。 |
2015-06-17 | HD | 去掉单独视频服务安装,视频服务默认端口改为17022和17032 |
2015-08-24 | HD | 增加内置数据库(SQLite)支持,增加WebIM产品-EntboostWeb使用说明。 |
2016-02-24 | HD | 完善文档说明 |
2016-07-15 | ZY | 增加免安装部署恩布服务端说明 完善服务端配置程序的安装说明 |