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