ejabberd安装配置[共27页]

1、Ejabberd安装配置王晓东2013-9-14目录1ejabberd下载42IM客户端52.1Spark IM52.2Pandion53ejabberd安装53.1安装流程63.2ejabberd启动83.3启动状态查看93.4ejabberd停止93.5ejabberdctl命令93.5.1环境变量93.5.2常用命令113.5.3ejabberdctl help113.6管理控制台113.7ejabberd配置文件124ejabberd IM测试124.1spark IM124.1.1设置124.1.2注册账号134.1.3登陆144.2pandion154.2.1设置154.2.2注册

2、账号164.2.3登陆174.3管理控制台查看用户175Ejabberd维护185.1日志管理185.1.1日志配置185.1.2日志文件195.1.3日志备份/重命名195.1.4WatchDog警告195.2数据库备份215.3数据库还原216使用ODBC-Mysql226.1配置ODBC-Mysql226.1.1修改配置文件ejabberd.cfg：226.1.2创建数据库ejabberd226.1.3启动ejabberd，并注册管理员账号236.2配置连接池236.3修改配置文件，调整模块数据记录到数据库241 ejabberd下载本次ejabberd测试使用了ejabberd 2.1

3、.13.Ejabberd 2.1.13安装文件，下载地址：/en/ejabberd/downloadsEjabberd 源码下载地址：/processone/ejabberd在线英文文档(Guide): /docs/ejabberd/guide_en.html在线中文文档(Guide): /Ejabberd2:%E5%AE%89%E8%A3%85%E5%92%8C%E6%93%8D%E4%BD%9C%E6%8C%87%

4、E5%8D%972 IM客户端目前有很多开源的IM客户端产品，本文档使用spark和pandion作为客户端工具。这两款工具均支持中文。2.1 Spark IMSpark IM是JAVA开发的一款开源IM客户端。下载地址：/downloads/download-landing.jsp?file=spark/spark_2_6_3.exe2.2 Pandion pandion是C+开发的IM客户端。下载地址：http:/pandion.im/download3 ejabberd安装安装可使用ejabberd官网提供的安装文件，也可自行编译源

5、码后进行配置。本次文档采用ejabberd-2.1.13-linux-x86-installer.run安装文件进行安装。操作系统版本：opensuse 12.3。3.1 安装流程-#chmod +x ejabberd-2.1.13-linux-x86-installer.run#./ejabberd-2.1.13-linux-x86-installer.run -Language SelectionPlease select the installation language1 Dutch - Nederlands2 English - English3 French - Fran?ais4

6、 German - Deutsch5 Russian - 6 Simplified Chinese - 简体中文7 Spanish - Espa?olPlease choose an option 2 : 6-安装目录 /opt/ejabberd-2.1.13: -ejabberd服务器域 (本次安装使用””作为服务器域名)请输入想使用的ejabberd域名. 域是添加到用户名后面以构成Jabber IM标识的可见属性(例如: ). 必须确保网络能够识别带有该地址名的计算机.ejabberd服务器域名 linux-ytdh.site: test.c

7、om-管理员用户名 请为此 ejabberd 安装输入管理员的用户名. 一个带有该用户名的 Jabber 账户将会被创建并赋予管理权限. 不要在用户名中使用空白符.管理员用户名 admin: admin-集群此节点是集群的一部分吗? (请注意集群是为高级用户准备的).集群 y/N: y (当前只做单服务器测试，选择Y/N均没有影响)-集群请从另一个节点复制 $HOME/.erlang.cookie 文件. 警告: 为安全起见, 您最好在防火墙中阻止外部连接4369端口.按 Enter 继续 : (当前提示不需要执行操作，按回车继续)-集群节点名称请使用此计算机的主网络名称补充该集群节点名称.(

8、节点名称可自由设定,当前设定节点名称为:first)集群节点名称: ejabberd linux-gxh4.site: first节点名称被存储在配置文件：/opt/ejabberd-2.1.13/conf/ejabberdctl.cfg-设定现在已经准备将 ejabberd 安装到您的电脑.您确定要继续? Y/n: y (完成基本设置，开始安装)-正在安装 ejabberd 于您的电脑中，请稍候. 安装中 0% _ 50% _ 100% #-安装程序已经完成安装 ejabberd 于你的电脑中.安装完成-3.2 ejabberd启动-#cd /opt/ejabberd-2.1.13/bin

9、#./start-执行该命令之后，shell会显示ejabberd的copyright信息。按ESC-”Shift+:”-q ，填y回车返回linux shell3.3 启动状态查看-#cd /opt/ejabberd-2.1.13/bin #./status-3.4 ejabberd停止-#cd /opt/ejabberd-2.1.13/bin #./stop-3.5 ejabberdctl命令3.5.1 环境变量可以使用ejabberdctl来控制ejabberd服务器，在使用命令之前设定PATH环境变量，指向安装目录的bin-# vi /etc/profile-最后一行加入：PATH=$

10、PATH:/opt/ejabberd-2.1.13/bin重启Linux后生效，在Linux shell下执行ejabberdctl查看。-# ejabberdctl-成功，启动ejabberd-# ejabberdctl start -启动# ejabberdctl status -查看ejabberd状态-3.5.2 常用命令 start status stop restartEjabberdctl命令更多细节请参考在线中文文档4.1节，地址如下/Ejabberd2:%E5%AE%89%E8%A3%85%E5%92%8C%E6%93%8D%E4%

11、BD%9C%E6%8C%87%E5%8D%973.5.3 ejabberdctl help使用ejabberdctl help查看提供的命令及基本用法。3.6 管理控制台1. 管理控制台访问地址：36:5280/admin2. 账号：(管理员账号域名),密码3. 登陆成功后进入管理控制台，虚拟主机下查看当前服务器相关数据及访问权限控制3.7 ejabberd配置文件-# cat /opt/ejabberd-2.1.13/conf/ejabberd.cfg-配置文件详细内容，查看在线中文文档3.1节，地址：http:/www.jabb

12、/Ejabberd2:%E5%AE%89%E8%A3%85%E5%92%8C%E6%93%8D%E4%BD%9C%E6%8C%87%E5%8D%974 ejabberd IM测试4.1 spark IM4.1.1 设置1. 打开spark，在界面点击“高级”-“一般”2. 在“连线”内容输入ejabberd服务器的IP以及端口。Ejabberd默认连接端口：5222在ejabberd.cfg中listen中配置。3. 其它保持默认，点击“确定”，完成设置4.1.2 注册账号1. 在spark操作面板，点击“(A)账号”2. 输入账号：user1 ；服务器：4.1

13、.3 登陆1. 输入账号：user1 服务器：2. 登陆成功，登陆成功，会收到一条服务器发的匿名消息4.2 pandion4.2.1 设置1. 在操作面板点击“连接设置”2. 输入ejabberd IP地址及端口号52223. 其它保持默认，点击“确定”完成设置4.2.2 注册账号1. 在pandion操作面板点击“注册一个新用户”2. 信息如下4.2.3 登陆4.3 管理控制台查看用户管理控制台，下查看当前用户5 Ejabberd维护5.1 日志管理5.1.1 日志配置选项 loglevel 修改文件 ejabberd.log 的详细程度. 语法是: -log

14、level, Level.例如：loglevel, 3.-可能的 Level 有: 0 没有ejabberd日志文件（不推荐） 1 紧急 2 错误 3 警告 4 信息 5 调试5.1.2 日志文件一个ejabberd节点写2个日志文件： ejabberd.log ejabberd 服务日志, 由 ejabberd 节点汇报的消息 erlang.log Erlang/OTP 系统日志, 由 Erlang/OTP 使用 SASL (系统架构支持库) 汇报的消息 5.1.3 日志备份/重命名日志文件不断增长，所以建议定期替换。替换方法是重命名日志文件，然后执行命令：-# ejabberdctl re

15、open-log-如果没有手动进行日志文件重命名，ejabberd-2.1.13 执行上面的命令后，日志文件自动重命名为：ejabberd-old.log ，erlang-old.log。5.1.4 WatchDog警告Watchdog配置在文件ejabberd.cfgejabberd包含了一个看门狗 watchdog 机制，当找出和内存使用有关的问题时，对开发者可能有用. 如果ejabberd服务器的一个进程消耗了超过配置阀值的内存, 一个消息将被发送到ejabberd配置文件中选项 watchdog_admins 定义的 XMPP 帐号. 语法是: watchdog_admins, JID

16、, . 消耗的内存以words衡量: 一个word在32位系统上是4字节bytes, 在64位系统上是8字节bytes. 这个阀值缺省是 1000000 words. 这个值可以用选项 watchdog_large_heap来配置, 或在一个会话中使用watchdog警报机器人. 语法是: watchdog_large_heap, Number. 示例配置（ejabberd.cfg修改）: -watchdog_admins, admin2localhost, .watchdog_large_heap, 30000000.-要移除watchdog管理员, 在选项

17、里移除. 为了移除所有watchdog管理员, 设置该选项为空列表: -watchdog_admins, .-5.2 数据库备份注意：这些选项仅将备份内置的 Mnesia 数据库. 如果您正在使用 ODBC 模块, 您还需要分别备份您的数据库.Ejabberd可以使用2种方式进行备份；1. 登陆管理控制台,http:/server:5280/admin进行备份“节点”-“ejabberdfirst”-“备份”，在“存储为二进制备份”，填写备份地址及名称后，点击“确定”，完成备份2. Shell备份-# ejabberdctl backup /opt/backup/ejabberd-201309

18、16.backup-5.3 数据库还原与数据库备份类似，可通过控制台和shell命令进行数据库还原1. 登陆管理控制台后，在选项“立即恢复二进制备份”，填写要恢复的备份文件，点击“确定”完成操作2. Shell还原-# ejabberdctl restore /opt/backup/ejabberd-20130916.backup-如果数据库较大，这个操作将消耗很多内存，此时建议使用install_fallback-# ejabberdctl install_fallback /opt/backup/ejabberd-20130916.backup-6 使用ODBC-Mysql6.1 配置OD

19、BC-Mysql使用ejabberd安装文件安装过程中，默认使用ejabberd内置数据库Mnesia。使用ODBC连接Mysql，则之前的账号不能继续使用。后面将详细介绍6.1.1 修改配置文件ejabberd.cfg：注释掉下面这行auth_method, internal.加入下面的两行auth_method, odbc.odbc_server, mysql, ”localhost”, ”ejabberd”, ”ejabberd”, ”ejabberd”.6.1.2 创建数据库ejabberd创建数据库并导入Mysql脚本 Ejabberd数据库脚本在源码中可以找到，源码下载地址:htt

20、ps://processone/ejabberd6.1.3 启动ejabberd，并注册管理员账号启动ejabberd并注册管理员账号-#ejabberdctl start#ejabberdctl register admin1 admin-可到ejabberd.users表查询当前写入的账号。确保管理员账号被赋予角色权限，在ejabberd.cfg中进行配置后重启ejabberd。-acl, admins, user, admin1, . access, configure, allow, admins.-6.2 配置连接池缺省的ejab

21、berd为每个虚拟主机打开10个到数据库的连接. 使用这个选项来修改该值: odbc_pool_size, 10.6.3 修改配置文件，调整模块数据记录到数据库如果你想要, 有可能使用一个关系数据库来存储信息件. 你可以通过在ejabberd 配置文件修改模块名称带上_odbc 后缀来实现这点. 你可以为以下数据使用关系数据库: 最后连接日期和时间: 使用 mod_last_odbc 取代 mod_last. 离线消息: 使用 mod_offline_odbc 取代 mod_offline. 名册: 使用 mod_roster_odbc 取代 mod_roster. 用户的VCARD: 使用

22、mod_vcard_odbc 取代 mod_vcard. 私有XML存储: 使用 mod_private_odbc 取代 mod_private. 用户黑名单规则: 使用 mod_privacy_odbc 取代 mod_privacy. 模块列表：模块 功能 依赖 mod_adhoc 特定命令 (XEP-0050) mod_announce 管理公告 推荐 mod_adhoc mod_caps 实体能力 (XEP-0115) mod_configure 使用特定命令配置服务器 mod_adhoc mod_disco 服务发现 (XEP-0030) mod_echo XMPP节回音 mod_ir

23、c IRC网关 mod_last 最后活动 (XEP-0012) mod_last_odbc 最后活动 (XEP-0012) 支持的数据库 (*) mod_muc 多用户聊天 (XEP-0045) mod_muc_log 多用户聊天室记录 mod_muc mod_offline 离线消息存储 (XEP-0160) mod_offline_odbc 离线消息存储 (XEP-0160) 支持的数据库 (*) mod_ping XMPP Ping 和定期保持连接 (XEP-0199) mod_privacy 禁止通讯 (XMPP IM) mod_privacy_odbc 禁止通讯 (XMPP IM)

24、 支持的数据库 (*) mod_private 私有XML存储 (XEP-0049) mod_private_odbc 私有XML存储 (XEP-0049) 支持的数据库 (*) mod_proxy65 SOCKS5字节流 (XEP-0065) mod_pubsub 发行-订阅 (XEP-0060), PEP (XEP-0163) mod_caps mod_pubsub_odbc 发行-订阅 (XEP-0060), PEP (XEP-0163) 支持的数据库 (*) 和 mod_caps mod_register I带内注册 (XEP-0077) mod_roster 名册管理 (XMPP I

25、M) mod_roster_odbc 名册管理 (XMPP IM) 支持的数据库 (*) mod_service_log 拷贝用户消息到日志服务 mod_shared_roster 共享名册管理 mod_roster 或 mod_roster_odbc mod_sic Server IP检查 (XEP-0279) mod_stats 统计信息收集 (XEP-0039) mod_time 实体时间 (XEP-0202) mod_vcard 电子名片 (XEP-0054) mod_vcard_ldap 电子名片 (XEP-0054) LDAP服务器 mod_vcard_odbc 电子名片 (XEP

26、-0054) 支持的数据库 (*) mod_vcard_xupdate 基于vCard的头像 (XEP-0153) mod_vcard 或 mod_vcard_odbc mod_version 软件版本 (XEP-0092) (*) 这个模块需要数据库支持. 关于支持的数据库列表, 见 3.2 节. 通过后缀你可以看到每个模块需要哪个数据库后端: 没有后缀, 这意味着那个模块使用Erlang的内建数据库 Mnesia 作为后端. _odbc, 这意味着该模块需要一个支持的数据库 (见 3.2 节) 作为后端. _ldap, 这意味着该模块需要一个LDAP服务器作为后端. 7 Jabberd 服务器集群和负载均衡配置7.1 集群配置步骤1. 从第一台机器拷贝 $HOME/.erlang.cookie 文件到第二台机器.(或者) 你也可以增加-setcookie content_of_.erlang.cookie选项到以下所有erl 命令.2. 在第二台机器上，在ejabberd工作目录中，以 ejabberd 守候进程用户运行以下命令: erl -sname ejabberd -mnesia dir /var/lib/ejabberd/ -mnesia extra_db_nodes ejabberdfirst -s mnesia