Deploy win

来自恩布企业IM,协作平台文档
2017年6月20日 (二) 11:23Admin讨论 | 贡献的版本

(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳转至: 导航搜索


恩布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目录下对应文件。

准备环境和安装数据库

  1. 安装Windows32/64操作系统;(已有系统直接跳过)
  2. 安装并启动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程序;

ENTBOOST Server Setup Windows V2 0 01.png

所有配置项详细描述如下:

端口配置

ENTBOOST Server Setup Windows V2 0 02.png

通讯端口配置:端口为UDP协议类型端口,默认端口18012;

HTTP端口配置:端口为TCP协议类型端口,默认端口82;

HTTPS端口配置:端口为TCP协议类型端口,默认端口443;

注意:如果默认端口被占用或者与其他程序冲突时,请修改为其他可用的端口;

服务器地址配置

配置服务器地址:服务器地址格式两种:IP地址格式、域名格式;

配置时服务器地址必须为本机的IP地址或者本机域名;

注意:第一次配置,或者服务器地址更换后,会有"不是本机IP"提示;需要修改为正确的地址并保存,

如下图:

ENTBOOST Server Setup Windows V2 0 03.png

服务地址配置错误域名时,提示如下图:

ENTBOOST Server Setup Windows V2 0 04.png

点击"保存"可以打包客户端为zip格式压缩包,并生成在线客服网站嵌入HTML代码,如下图:

ENTBOOST Server Setup Windows V2 0 05.png

客户端正在打包界面,如下图:

ENTBOOST Server Setup Windows V2 0 06.png

打包客户端程序会自动生成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功能失效

ENTBOOST Server Setup Windows V2 0 07.png

使用"更改IP"功能有4个基本步骤,以如下例子进行说明:

服务端已经用IP地址配置好,需要更换服务器地址为域名:entboost.com;

1)退出服务端程序,

2)进入install目录,双击执行ebs_config_win.exe程序

3)在配置界面将"服务器地址"项修改为:entboost.com,

点击"更换IP"在提示的界面下完成配置如下图:

ENTBOOST Server Setup Windows V2 0 08.png

点击确定后会提示打包客户端程序:

ENTBOOST Server Setup Windows V2 0 09.png

4)启动服务端程序,完成配置

数据库配置

恩布协作平台服务端支持3种数据库,分别是:恩布内置数据库(SQLite数据库)、PostgreSQL数据库、MySQL数据库。

安装时可以依据现有环境自行选择,如下图:

ENTBOOST Server Setup Windows V2 0 10.png

以下分别对各数据库的配置进行说明:

1)恩布内置数据库SQLite配置界面如下:

ENTBOOST Server Setup Windows V2 0 11.png

选择内置数据库进行配置时,填写好数据库名,点击"保存"完成配置。

2)PostgreSQL数据库配置界面如下:

ENTBOOST Server Setup Windows V2 0 12.png

选择PostgreSQL数据库进行配置,填写好各项配置信息,点击"保存"完成配置;

注意:数据库PostgreSQL默认使用5432端口,如果手工修改过数据库的端口,"端口"项必须填写正确的

端口。

3)MySQL数据库配置界面如下:

ENTBOOST Server Setup Windows V2 0 13.png

选择MySQL数据库进行配置,填写好各项配置信息,点击"保存"完成配置;

注意:数据库MySQL默认使用3306端口,如果手工修改过数据库的端口,"端口"项必须填写正确端口。

导入初始数据

导入初始数据界面:

ENTBOOST Server Setup Windows V2 0 14.png

注意:第一次初始化必须导入数据,否则服务启动时连接数据库会失败;

警告:已经在正常运营的系统请慎重选择"导入数据"功能,或做好数据库备份,避免导致数据丢失;

导入初始化数据各项说明:

1)"导入数据库"项:此项默认不需要进行修改;

2)"公司名称"项:此项建议填写正确公司名称,配置完成后,客户端不提供修改公司名称功能;

3)"管理员帐号"和"管理员密码"项:服务端配置好后,作为IM管理员帐号的登录帐号和密码,请妥善保存好管理员帐号和密码;

4)各项信息填写正确后,点击"导入数据"进行数据的初始化,如下图:

ENTBOOST Server Setup Windows V2 0 15.png

确定后后台自动初始化数据库,成功后会提示:

ENTBOOST Server Setup Windows V2 0 16.png

"导入数据"操作其他提示说明:

1)SQLite数据库提示信息,界面如下图:

ENTBOOST Server Setup Windows V2 0 17.png

此时为内置数据库,点击确定会自动安装程序会自动备份原来的数据库文件,并且初始化一个新的IM服务端;

2)PostgreSQL数据库导入提示信息,界面如下图:

ENTBOOST Server Setup Windows V2 0 18.png

说明导入的PostgreSQL数据库已经存在;

解决方法:在数据库配置中填写新的数据库名,保存后,再次导入数据。

3)MySQL数据库导入提示信息,界面如下图:

ENTBOOST Server Setup Windows V2 0 19.png

说明导入的MySQL数据库已经存在,

解决方法:在数据库配置中填写新的数据库名,保存后,再次导入数据。

在线客服设置

ENTBOOST Server Setup Windows V2 0 20.png

修改900在线客服浮动条上面的电话号码,如下图:

ENTBOOST Server Setup Windows V2 0 21.png

启动、停止服务命令

恩布协作平台通讯服务目录:ebs;

恩布协作平台通讯服务核心程序:ebs\CGCP.exe;

启动恩布协作平台通讯服务:双击执行CGCP.exe:

客户端连接地址设置为:[服务器地址]:[通讯端口],如:192.168.1.198:18012

恩布协作平台服务端安装后默认有4个帐号,管理员帐号admin,管理员密码为配置中自定义;普通用户帐号user1、user2、user3

,帐号登录密码为:12345678abc

正常运行的服务端界面,如下图:

ENTBOOST Server Setup Windows V2 0 22.png

注意:如果显示三条CommSslServer/ssl的错误,属于正常现象,不影响使用,

停止恩布云通讯服务:

ENTBOOST Server Setup Windows V2 0 23.png

命令行下,输入"exit"并回车,退出服务:

ENTBOOST Server Setup Windows V2 0 24.png

全部命令:

help打印命令帮助信息;

start启动服务;

stop停止服务

restart重启服务;

exit退出服务;

企业IM客户端软件使用

下载企业IM客户端软件页面

企业IM客户端软件下载页面,如图:

http://服务器域名或IP:http端口/entboost/index.html

如:http://192.168.1.198:82/entboost/index.html

请根据你实际公司环境修改相应的IP地址和端口;

ENTBOOST Server Setup Windows V2 0 25.png

管理公司组织结构

使用公司系统管理员帐号,登录企业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文件内容),嵌入到企业网站就可以实现企业网站在线客服功能,如下图:

ENTBOOST Server Setup Windows V2 0 26.png

集成代码例子请看:ebs\conf\web\samples\entboost\index.html文件,如果不需要在线客服功能,修改文件内容,去掉该行代码。

点击在线咨询,打开在线客服界面,如下图:

ENTBOOST Server Setup Windows V2 0 27.png

集成恩布WebIM产品-EntboostWeb

功能介绍

成功部署恩布服务端,会默认集成一个恩布WebIM产品EntboostWeb,访问地址如下:

http://服务器域名或IP:http端口/webim/client.html

如:http://192.168.1.198:82/webim/client.html

登录图片,如下图:

ENTBOOST Server Setup Windows V2 0 28.png

登录成功图片,如下图:

ENTBOOST Server Setup Windows V2 0 29.png

聊天界面:

ENTBOOST Server Setup Windows V2 0 30.png


附录一

防火墙内网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工具)

ENTBOOST Server Setup Windows V2 0 31.png

低版本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 增加免安装部署恩布服务端说明
完善服务端配置程序的安装说明