This article continue on series of articles about the Kamailio 3.1.x SIP proxy deployed on debian lenny and its features. In previous articles we have:<\/p>\n
1) installed clear Kamailio 3.1.x server <\/a><\/p>\n 2) added Mysql support <\/a>for persistance location storage<\/p>\n 3) SIREMIS web management interface for our kamailio server<\/a>.<\/p>\n and now, we will configure the IM\/presence support.<\/p>\n To support presence, Kamailio requires special DB tables for presence. So when you installing Mysql support for Kamailio, you have to uncomment in etc\/kamailio\/kamctlrc file following lines<\/p>\n and then run<\/p>\n If you are further in your configuration and Mysql is already configured, the kamdbctl <\/strong><\/em>command has a presence options regarding to adding presence tables.<\/p>\n So you may run kamdbctl presence, and required tables will be added.<\/p>\n Do not run kamdbctl presence, if you already have installed <\/strong>presence tables using kamdbctl create during initial DB initialisation. Running kamdbctl presence will do change in kamailio database and it causing problem to run presence correctly. Precisely, the version table of the kamailio database is modyfied such way, that there are added new indexes pointing to a duplicated tables regarding to the presence service with different version indexes.<\/p>\n The following modules must be loaded before this module: <\/p>\n External Libraries or Applications have to be already installed<\/p>\n and do not forget restart kamailio server \/etc\/init.d\/kamailio restart<\/p>\n The Presence and instant messaging RFC standards are quite complex and wide. For this kind of service over Kamailio we will use presence and xcap modules.<\/p>\n Kamailio 3.1.x<\/p>\n Open \/etc\/kamailio\/kamailio.cfg<\/em> and we go through, line by line.<\/p>\n At the top of the cfg file, in define zone blocks, we have prepared<\/p>\n so we will define presence support<\/p>\n and for the basic Presence configuration it is all<\/strong>. All other lines are included inside of the kamailio.cfg as directive blocks.<\/p>\n <\/p>\n Anyway, we may look through.<\/p>\n In module section (starting with ####### Modules Section ########<\/strong>) we will find<\/p>\n What mean, that if we have defined presence directive (and we have), the modules will be loaded.<\/p>\n Now we are going to setting module parameters, and in config file we are moving behind<\/p>\n so we are in and going through we find prepared lines.<\/p>\n The first and the second modparam (modparam("presence", "db_url", DBURL), 9modparam("presence_xml", "db_url", DBURL)<\/em>) <\/em>is pointing to the database defined in the upper part of the kamailio.cfg. And if we have correctly configured Mysql support, we do not need to deal with.<\/p>\n The last modparam (modparam("presence_xml", "force_active", 1<\/a>)) deals about subscription permissions. The parameters has value 1 if we use XCAP server, otherwise should be 0.<\/p>\n Inside of the main routing logic, starting woth lines<\/p>\n we may find preconfigured route calling to handle Presence (route(PRESENCE)<\/em><\/strong>)<\/p>\n where the route(PRESENCE) contain lines<\/p>\n So the default behaviour should be fulfilled and the service should work.<\/p>\n Using Bria and SipCommuicator with Presence agent settings (not peer to peer) work nice. Transfer of the buddy lists do not work yet.<\/p>\n Using wireshark at both client sides, or ngrep on the server, we should observe message diagram looking something like<\/p>\n <\/p>","protected":false},"excerpt":{"rendered":" This article continue on series of articles about the Kamailio 3.1.x SIP proxy deployed on debian lenny and its features. In previous articles we have:<\/p>\nPrerequsities<\/h2>\n
\n
\r\n# If to install tables for the modules in the EXTRA_MODULES variable.\r\nINSTALL_EXTRA_TABLES=ask\r\n\r\n# If to install presence related tables.\r\nINSTALL_PRESENCE_TABLES=ask \r\n<\/pre>\n
kamdbctl crea<\/span>te\r\n<\/pre>\n\r\npstest:\/home\/palo# kamdbctl<\/strong> <\/span>database engine 'mysql' loaded\r\n\/usr\/sbin\/kamdbctl $Revision$\r\n\r\nusage: kamdbctl create <db name or db_path, optional> .....(creates a new database)\r\n kamdbctl drop <db name or db_path, optional> .......(!entirely deletes tables!)\r\n kamdbctl reinit <db name or db_path, optional> .....(!entirely deletes and than re-creates tables!)\r\n kamdbctl backup <file> .................................(dumps current database to file)\r\n kamdbctl restore <file> ................................(restores tables from a file)\r\n kamdbctl copy <new_db> .................................(creates a new db from an existing one)\r\n kamdbctl migrate <old_db> <new_db> .....................(migrates DB from 1.2 to 1.3, not implemented yet!)\r\n kamdbctl presence <\/span>......................................(adds the presence related tables)\r\n kamdbctl extra .........................................(adds the extra tables)\r\n\r\n<\/pre>\nDependencies<\/h2>\n
\n
\n
\n <\/li>\n<\/ul>\nInstalling the kamailio presence module<\/h2>\n
\r\napt-get install kamailio-presence-modules\r\n<\/pre>\n
Configuration of the Kamailio for Instant Messaging and Presence (SIMPLE)<\/h2>\n
\n
Loading required modules<\/h3>\n
\r\n# *** To enable presence server execute:\r\n# - enable mysql\r\n# - define WITH_PRESENCE\r\n<\/pre>\n
\r\n#!define WITH_PRESENCE\r\n<\/pre>\n
\r\n#!ifdef WITH_PRESENCE\r\nloadmodule "presence.so"\r\nloadmodule "presence_xml.so"\r\n#!endif\r\n<\/pre>\n
Setting up module parameters<\/h3>\n
\r\n# ----------------- setting module-specific parameters ---------------\r\n<\/pre>\n
\r\n#!ifdef WITH_PRESENCE\r\n# ----- presence params -----\r\nmodparam("presence", "db_url", DBURL)\r\n\r\n# ----- presence_xml params -----\r\nmodparam("presence_xml", "db_url", DBURL)\r\nmodparam("presence_xml", "force_active", 1)\r\n#!endif\r\n<\/pre>\n\r\n####### Defined Values #########\r\n\r\n# *** Value defines - IDs used later in config\r\n#!ifdef WITH_MYSQL\r\n# - database URL - used to connect to database server by modules such\r\n# as: auth_db, acc, usrloc, a.s.o.\r\n#!define DBURL "mysql:\/\/openser:openserrw@localhost\/kamailio"\r\n#!endif\r\n<\/pre>\n
Modifying route logic for using IP\/Presence<\/h2>\n
\r\n# Main SIP request routing logic\r\n# - processing of any incoming SIP request starts with this route\r\nroute {\r\n<\/pre>\n\r\n# handle presence related requests\r\n route(PRESENCE);\r\n<\/pre>\n
\r\nroute[PRESENCE] {\r\n if(!is_method("PUBLISH|SUBSCRIBE"))\r\n return;\r\n\r\n#!ifdef WITH_PRESENCE\r\n if (!t_newtran())\r\n {\r\n sl_reply_error();\r\n exit;\r\n };\r\n\r\n if(is_method("PUBLISH"))\r\n {\r\n handle_publish();\r\n t_release();\r\n }\r\n else\r\n if( is_method("SUBSCRIBE"))\r\n {\r\n handle_subscribe();\r\n t_release();\r\n }\r\n exit;\r\n#!endif\r\n\r\n # if presence enabled, this part will not be executed\r\n if (is_method("PUBLISH") || $rU==$null)\r\n {\r\n sl_send_reply("404", "Not here");\r\n exit;\r\n }\r\n return;\r\n}\r\n<\/pre>\nTesting<\/h2>\n
\r\nPUA PA WATCHER\r\n \r\n | | |\r\n | | <----- SUBSCRIBE --- |\r\n | | |\r\n | | ------ 200 OK -----> |\r\n | | |\r\n | | ----- NOTIFY -----> |\r\n | | |\r\n | | <---- 200 OK ------ |\r\n | | |\r\n | | |\r\n | ------- PUBLISH ---> | |\r\n | | |\r\n | <------ 200 OK ---- | |\r\n | | |\r\n | | ----- NOTIFY -----> |\r\n | | |\r\n | | <---- 200 OK ------ |\r\n | | | <\/pre>\n