ejabberd安裝配置[共27頁]

1、Ejabberd安裝配置王曉東2013-9-14目錄1ejabberd下載42IM客戶端52.1Spark IM52.2Pandion53ejabberd安裝53.1安裝流程63.2ejabberd啟動83.3啟動狀態(tài)查看93.4ejabberd停止93.5ejabberdctl命令93.5.1環(huán)境變量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數(shù)據(jù)庫備份215.3數(shù)據(jù)庫還原216使用ODBC-Mysql226.1配置ODBC-Mysql226.1.1修改配置文件ejabberd.cfg：226.1.2創(chuàng)建數(shù)據(jù)庫ejabberd226.1.3啟動ejabberd，并注冊管理員賬號236.2配置連接池236.3修改配置文件，調(diào)整模塊數(shù)據(jù)記錄到數(shù)據(jù)庫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客戶端產(chǎn)品，本文檔使用spark和pandion作為客戶端工具。這兩款工具均支持中文。2.1 Spark IMSpark IM是JAVA開發(fā)的一款開源IM客戶端。下載地址：/downloads/download-landing.jsp?file=spark/spark_2_6_3.exe2.2 Pandion pandion是C+開發(fā)的IM客戶端。下載地址：http:/pandion.im/download3 ejabberd安裝安裝可使用ejabberd官網(wǎng)提供的安裝文件，也可自行編譯源

5、碼后進行配置。本次文檔采用ejabberd-2.1.13-linux-x86-installer.run安裝文件進行安裝。操作系統(tǒng)版本：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標識的可見屬性(例如: ). 必須確保網(wǎng)絡能夠識別帶有該地址名的計算機.ejabberd服務器域名 linux-ytdh.site: test.c

7、om-管理員用戶名 請為此 ejabberd 安裝輸入管理員的用戶名. 一個帶有該用戶名的 Jabber 賬戶將會被創(chuàng)建并賦予管理權限. 不要在用戶名中使用空白符.管理員用戶名 admin: admin-集群此節(jié)點是集群的一部分嗎? (請注意集群是為高級用戶準備的).集群 y/N: y (當前只做單服務器測試，選擇Y/N均沒有影響)-集群請從另一個節(jié)點復制 $HOME/.erlang.cookie 文件. 警告: 為安全起見, 您最好在防火墻中阻止外部連接4369端口.按 Enter 繼續(xù) : (當前提示不需要執(zhí)行操作，按回車繼續(xù))-集群節(jié)點名稱請使用此計算機的主網(wǎng)絡名稱補充該集群節(jié)點名稱.(

8、節(jié)點名稱可自由設定,當前設定節(jié)點名稱為:first)集群節(jié)點名稱: ejabberd linux-gxh4.site: first節(jié)點名稱被存儲在配置文件：/opt/ejabberd-2.1.13/conf/ejabberdctl.cfg-設定現(xiàn)在已經(jīng)準備將 ejabberd 安裝到您的電腦.您確定要繼續(xù)? Y/n: y (完成基本設置，開始安裝)-正在安裝 ejabberd 于您的電腦中，請稍候. 安裝中 0% _ 50% _ 100% #-安裝程序已經(jīng)完成安裝 ejabberd 于你的電腦中.安裝完成-3.2 ejabberd啟動-#cd /opt/ejabberd-2.1.13/bin

9、#./start-執(zhí)行該命令之后，shell會顯示ejabberd的copyright信息。按ESC-”Shift+:”-q ，填y回車返回linux shell3.3 啟動狀態(tài)查看-#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 環(huán)境變量可以使用ejabberdctl來控制ejabberd服務器，在使用命令之前設定PATH環(huán)境變量，指向安裝目錄的bin-# vi /etc/profile-最后一行加入：PATH=$

10、PATH:/opt/ejabberd-2.1.13/bin重啟Linux后生效，在Linux shell下執(zhí)行ejabberdctl查看。-# ejabberdctl-成功，啟動ejabberd-# ejabberdctl start -啟動# ejabberdctl status -查看ejabberd狀態(tài)-3.5.2 常用命令 start status stop restartEjabberdctl命令更多細節(jié)請參考在線中文文檔4.1節(jié)，地址如下/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. 登陸成功后進入管理控制臺，虛擬主機下查看當前服務器相關數(shù)據(jù)及訪問權限控制3.7 ejabberd配置文件-# cat /opt/ejabberd-2.1.13/conf/ejabberd.cfg-配置文件詳細內(nèi)容，查看在線中文文檔3.1節(jié)，地址：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. 在“連線”內(nèi)容輸入ejabberd服務器的IP以及端口。Ejabberd默認連接端口：5222在ejabberd.cfg中l(wèi)isten中配置。3. 其它保持默認，點擊“確定”，完成設置4.1.2 注冊賬號1. 在spark操作面板，點擊“(A)賬號”2. 輸入賬號：user1 ；服務器：4.1

13、.3 登陸1. 輸入賬號：user1 服務器：2. 登陸成功，登陸成功，會收到一條服務器發(fā)的匿名消息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 調(diào)試5.1.2 日志文件一個ejabberd節(jié)點寫2個日志文件： ejabberd.log ejabberd 服務日志, 由 ejabberd 節(jié)點匯報的消息 erlang.log Erlang/OTP 系統(tǒng)日志, 由 Erlang/OTP 使用 SASL (系統(tǒng)架構支持庫) 匯報的消息 5.1.3 日志備份/重命名日志文件不斷增長，所以建議定期替換。替換方法是重命名日志文件，然后執(zhí)行命令：-# ejabberdctl re

15、open-log-如果沒有手動進行日志文件重命名，ejabberd-2.1.13 執(zhí)行上面的命令后，日志文件自動重命名為：ejabberd-old.log ，erlang-old.log。5.1.4 WatchDog警告Watchdog配置在文件ejabberd.cfgejabberd包含了一個看門狗 watchdog 機制，當找出和內(nèi)存使用有關的問題時，對開發(fā)者可能有用. 如果ejabberd服務器的一個進程消耗了超過配置閥值的內(nèi)存, 一個消息將被發(fā)送到ejabberd配置文件中選項 watchdog_admins 定義的 XMPP 帳號. 語法是: watchdog_admins, JID

16、, . 消耗的內(nèi)存以words衡量: 一個word在32位系統(tǒng)上是4字節(jié)bytes, 在64位系統(tǒng)上是8字節(jié)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 數(shù)據(jù)庫備份注意：這些選項僅將備份內(nèi)置的 Mnesia 數(shù)據(jù)庫. 如果您正在使用 ODBC 模塊, 您還需要分別備份您的數(shù)據(jù)庫.Ejabberd可以使用2種方式進行備份；1. 登陸管理控制臺,http:/server:5280/admin進行備份“節(jié)點”-“ejabberdfirst”-“備份”，在“存儲為二進制備份”，填寫備份地址及名稱后，點擊“確定”，完成備份2. Shell備份-# ejabberdctl backup /opt/backup/ejabberd-201309

18、16.backup-5.3 數(shù)據(jù)庫還原與數(shù)據(jù)庫備份類似，可通過控制臺和shell命令進行數(shù)據(jù)庫還原1. 登陸管理控制臺后，在選項“立即恢復二進制備份”，填寫要恢復的備份文件，點擊“確定”完成操作2. Shell還原-# ejabberdctl restore /opt/backup/ejabberd-20130916.backup-如果數(shù)據(jù)庫較大，這個操作將消耗很多內(nèi)存，此時建議使用install_fallback-# ejabberdctl install_fallback /opt/backup/ejabberd-20130916.backup-6 使用ODBC-Mysql6.1 配置OD

19、BC-Mysql使用ejabberd安裝文件安裝過程中，默認使用ejabberd內(nèi)置數(shù)據(jù)庫Mnesia。使用ODBC連接Mysql，則之前的賬號不能繼續(xù)使用。后面將詳細介紹6.1.1 修改配置文件ejabberd.cfg：注釋掉下面這行auth_method, internal.加入下面的兩行auth_method, odbc.odbc_server, mysql, ”localhost”, ”ejabberd”, ”ejabberd”, ”ejabberd”.6.1.2 創(chuàng)建數(shù)據(jù)庫ejabberd創(chuàng)建數(shù)據(jù)庫并導入Mysql腳本 Ejabberd數(shù)據(jù)庫腳本在源碼中可以找到，源碼下載地址: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個到數(shù)據(jù)庫的連接. 使用這個選項來修改該值: odbc_pool_size, 10.6.3 修改配置文件，調(diào)整模塊數(shù)據(jù)記錄到數(shù)據(jù)庫如果你想要, 有可能使用一個關系數(shù)據(jù)庫來存儲信息件. 你可以通過在ejabberd 配置文件修改模塊名稱帶上_odbc 后綴來實現(xiàn)這點. 你可以為以下數(shù)據(jù)使用關系數(shù)據(jù)庫: 最后連接日期和時間: 使用 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. 用戶黑名單規(guī)則: 使用 mod_privacy_odbc 取代 mod_privacy. 模塊列表：模塊 功能 依賴 mod_adhoc 特定命令 (XEP-0050) mod_announce 管理公告 推薦 mod_adhoc mod_caps 實體能力 (XEP-0115) mod_configure 使用特定命令配置服務器 mod_adhoc mod_disco 服務發(fā)現(xiàn) (XEP-0030) mod_echo XMPP節(jié)回音 mod_ir

23、c IRC網(wǎng)關 mod_last 最后活動 (XEP-0012) mod_last_odbc 最后活動 (XEP-0012) 支持的數(shù)據(jù)庫 (*) mod_muc 多用戶聊天 (XEP-0045) mod_muc_log 多用戶聊天室記錄 mod_muc mod_offline 離線消息存儲 (XEP-0160) mod_offline_odbc 離線消息存儲 (XEP-0160) 支持的數(shù)據(jù)庫 (*) mod_ping XMPP Ping 和定期保持連接 (XEP-0199) mod_privacy 禁止通訊 (XMPP IM) mod_privacy_odbc 禁止通訊 (XMPP IM)

24、 支持的數(shù)據(jù)庫 (*) mod_private 私有XML存儲 (XEP-0049) mod_private_odbc 私有XML存儲 (XEP-0049) 支持的數(shù)據(jù)庫 (*) mod_proxy65 SOCKS5字節(jié)流 (XEP-0065) mod_pubsub 發(fā)行-訂閱 (XEP-0060), PEP (XEP-0163) mod_caps mod_pubsub_odbc 發(fā)行-訂閱 (XEP-0060), PEP (XEP-0163) 支持的數(shù)據(jù)庫 (*) 和 mod_caps mod_register I帶內(nèi)注冊 (XEP-0077) mod_roster 名冊管理 (XMPP I

25、M) mod_roster_odbc 名冊管理 (XMPP IM) 支持的數(shù)據(jù)庫 (*) mod_service_log 拷貝用戶消息到日志服務 mod_shared_roster 共享名冊管理 mod_roster 或 mod_roster_odbc mod_sic Server IP檢查 (XEP-0279) mod_stats 統(tǒng)計信息收集 (XEP-0039) mod_time 實體時間 (XEP-0202) mod_vcard 電子名片 (XEP-0054) mod_vcard_ldap 電子名片 (XEP-0054) LDAP服務器 mod_vcard_odbc 電子名片 (XEP

26、-0054) 支持的數(shù)據(jù)庫 (*) mod_vcard_xupdate 基于vCard的頭像 (XEP-0153) mod_vcard 或 mod_vcard_odbc mod_version 軟件版本 (XEP-0092) (*) 這個模塊需要數(shù)據(jù)庫支持. 關于支持的數(shù)據(jù)庫列表, 見 3.2 節(jié). 通過后綴你可以看到每個模塊需要哪個數(shù)據(jù)庫后端: 沒有后綴, 這意味著那個模塊使用Erlang的內(nèi)建數(shù)據(jù)庫 Mnesia 作為后端. _odbc, 這意味著該模塊需要一個支持的數(shù)據(jù)庫 (見 3.2 節(jié)) 作為后端. _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