{"id":481,"date":"2011-11-08T08:52:28","date_gmt":"2011-11-08T07:52:28","guid":{"rendered":""},"modified":"2019-10-29T13:20:23","modified_gmt":"2019-10-29T12:20:23","slug":"installing-and-configuring-homer-sip-capture-server-debian-64b-squeeze-howto","status":"publish","type":"post","link":"https:\/\/nil.uniza.sk\/en\/installing-and-configuring-homer-sip-capture-server-debian-64b-squeeze-howto\/","title":{"rendered":"Installing and configuring Homer SIP capture server – debian 64b squeeze – howto"},"content":{"rendered":"

Note 2019-10: This guide was made for an older verion of sipcapture and actual guide is available at https:\/\/www.sipcapture.org\/<\/a><\/p>\n

Description: <\/strong>Homer is an Open Source SIP Capture server by Alexandr Dubovikov & Friends, based on OpenSER\/Kamailio and supporting HEPv1\/v2 (Homer Encapsulation Protocol)<\/i> & IP proto 4 (IPIP)<\/i> encapsulation and monitoring\/mirroring port capture modes. Homer ships with a flexible and lightweight capture agent for unsupported scenarios and a powerful browser based UI (webHomer).<\/p>\n

Web<\/strong>:<\/p>\n

http:\/\/sipcapture.org\/<\/p>\n

http:\/\/code.google.com\/p\/homer\/<\/p>\n

To fulfill installation tasks we will need Kamailio with sipcapture module enabled, mysql server, apache server wuth php support and enabled rewrite rules, homer webgui.<\/p>\n

Topology<\/h1>\n

\u00a0Image will come soon<\/em><\/p>\n

Installing capture node (Kamailio with Mysql)<\/h1>\n

The capture server of the Homer capture solution is an application, which collects all SIP messages in HEP\/IPIP protocols from your capture agents (other Kamailio servers in our case). The capture server is based on the Kamailio server, therefore we first need to install Kamailio 3.2 server with MySQL support.<\/p>\n

The sipcapture module should be a part of the main kamailio package. So we have two options, install kamailio <\/a>with mysql modules<\/a> from repository or manually compile kamailio and all required packages from GIT<\/a>. In a case of manual compilation, there have to be mysql and sipcapture module enabled (make modules-cfg include_modules=“db_mysql sipcapture“). For an installation ovreview look at the article about installing the Kamailio server from GIT<\/a>.<\/p>\n

Download homer files<\/h2>\n

During next steps we will require some files provided inside of homer and kamailio source files, so we will download it. In a case of manual compilation and installtion this step is probably done.<\/p>\n

mkdir homer\ncd homer<\/pre>\n
Get a local copy of the homer repository with this command:<\/p>\n
\n
\n
git clone https:\/\/code.google.com\/p\/homer\/<\/pre>\n
\u00a0and get a copy of Kamailio source files<\/div>\n<\/div>\n<\/div>\n
cd ..\nmkdir kamailio32\ncd kamailio32\ngit<\/span> clone --depth 1 git<\/span>:\/\/git<\/span>.sip-router.org\/sip-router kamailio<\/span><\/strong><\/pre>\n
Copy Homer capture config file<\/h2>\n
Now copy the example kamailio.cfg from kamailio\/modules\/sipcapture\/examples\/ to yours default kamailio’s config directory. i.e \/usr\/local\/etc\/kamailio\/ if you install it from git or \/etc\/kamailio if it was installed from repository, open it and change:<\/p>\n
cd \/etc\/kamailio\/\ncp <YOUR_PATH_TO_KAMAILIO_SOURCE>\/kamailio32\/kamailio\/modules\/sipcapture\/examples\/kamailio.cfg kamailio.cfg\n<\/pre>\n
<\/h2>\n
Modification of kamailio.cfg file<\/h2>\n
Open kamailio.cfg file and change appropriate fields to reflect your installation (mainly IP\u00a0address)<\/p>\n
# here should be your ip and port on which the capture server listen on <\/span>\n<\/span>listen<\/span>=<\/span>udp<\/span>:<\/span>158.193.139.49<\/span>:<\/span>5060<\/span> <\/span>\n\n<\/span># credentials to access mysql db, where all messages collected <\/span>\nmodparam<\/span>(<\/span>\"sipcapture\"<\/span>,<\/span> \"db_url\"<\/span>,<\/span> \"mysql:\/\/homer_user:homer_password@localhost\/homer_db\"<\/span>)<\/span> \u00a0\n\n<\/span># if you have more then one node set capture_node name \u00a0 \u00a0 \u00a0 \u00a0 \u00a0<\/span>\n<\/span># this name will be used in mysql, field node<\/span>\nmodparam<\/span>(<\/span>\"sipcapture\"<\/span>,<\/span> \"capture_node\"<\/span>,<\/span> \"homer03\"<\/span>)<\/span>\n\n<\/span>#activate HEP capturing<\/span>\nmodparam<\/span>(<\/span>\"sipcapture\"<\/span>,<\/span> \"hep_capture_on\"<\/span>,<\/span> 1<\/span>)<\/span><\/pre>\n
Check if config file containts line with requested modules<\/p>\n
loadmodule \"pv.so\"\nloadmodule \"db_mysql.so\"\nloadmodule \"sipcapture.so\"\nloadmodule \"textops.so\"\n<\/pre>\n
and start the kamailio to check if everything is oK<\/p>\n
\/etc\/init.d\/kamailio start\nStarting Kamailio:\nloading modules under \/usr\/local\/lib64\/kamailio\/modules_k\/:\/usr\/local\/lib64\/kamailio\/modules\/\nListening on\n             udp: 158.193.139.49:5060\nAliases:\n             udp: homer:5060\n             udp: homer.sip.uniza.sk:5060\n\nkamailio started.\n<\/pre>\n
Creation of Mysql database tables<\/h2>\n
Create a homer database (homer_db)<\/p>\n
root@homer:\/# mysql -u root -p\nEnter password:\nmysql> create database homer_db;\nmysql> connect homer_db;\nmysql> \n<\/pre>\n
and paste script from http:\/\/code.google.com\/p\/homer\/source\/browse\/sql\/create_sipcapture.sql<\/a><\/p>\n
Then create an DB user with privileges to reflect your kamailio.cfg configuration<\/p>\n
CREATE USER 'homer_user'@'localhost' IDENTIFIED BY 'homer_password';\nGRANT ALL PRIVILEGES ON homer_db.* TO 'homer_user'@'localhost';\n<\/pre>\n
then open kamailio.cfg and modify line<\/p>\n
modparam<\/span>(<\/span>\"sipcapture\"<\/span>,<\/span> \"db_url\"<\/span>,<\/span> \"mysql:\/\/homer_user:homer_password@localhost\/homer_db\"<\/span>)<\/span> \u00a0\n<\/span><\/pre>\n
finally restart the kamailio service.<\/p>\n
Installing homer web interface<\/h2>\n
Install apache web server with php5 and mysql support<\/p>\n
apt-get install apache2 apache2-doc php5 php5-mysql php5-gd<\/pre>\n
Enable rewrite.load<\/em> for your apache. Enabling rewrite mode for my Apache 2 means add symlink from \/etc\/apache2\/mods-available into \/etc\/apache2\/mods-enabled. Alternativelly we enable apache rewrite mode with following command<\/p>\n
 a2enmod rewrite\n<\/pre>\n
Without this we are not able to use homer webgui web after installation.<\/p>\n
Then download latest homer webgui files<\/p>\n
cd \/home\/palo\/\nwget http:\/\/homer.googlecode.com\/files\/webhomer3_2_3.tgz\n<\/pre>\n
go to the www folder<\/p>\n
cd \/var\/www\n<\/pre>\n
and extract homer gui files here<\/p>\n
tar xvfz \/home\/palo\/webhomer3_2_3.tgz\n<\/pre>\n
Now create a database for a homer<\/p>\n
root@homer:\/# mysql -u root -p\nEnter password:\nmysql> create database homer_users;\n<\/pre>\n
and fill it with homer_users.sql from webhomer\/sql folder (downloaded in webhomer3_2_3.tgz).<\/p>\n
root@homer:\/var\/www# mysql -u root -p homer_users < \/var\/www\/webhomer\/sql\/homer_users.sql\n<\/pre>\n
Copy<\/p>\n
cp configuration_example.php configuration.php\ncp preferences_example.php preferences.php\n<\/pre>\n
Create a user to access this database and define him in the configuration.php<\/p>\n
\/* Access db of homer users *\/<\/span>\ndefine<\/span>(<\/span>HOST<\/span>,<\/span> \"localhost\"<\/span>); <\/span>define(PORT, 3306);\ndefine<\/span>(<\/span>USER<\/span>,<\/span> \"root<\/span>\"<\/span>);<\/span>\ndefine<\/span>(<\/span>PW<\/span>,<\/span> \"root<\/span>\"<\/span>);<\/span>\ndefine<\/span>(<\/span>DB<\/span>,<\/span> \"homer_users\"<\/span>);<\/span><\/pre>\n
then define username and password for HOMER db (made a few steps before). This user must be defined in all your nodes DB. Don’t forget to insert all your nodes into homer_nodes table.<\/p>\n
\/* Homer connection \n* \u00a0this user must have the same password for all Homer nodes\n* \u00a0please define all your nodes in homer_nodes table\n*\/<\/span>\n\ndefine<\/span>(<\/span>HOMER_HOST<\/span>,<\/span> \"localhost\"<\/span>); <\/span>define(HOMER_PORT, 3306);\ndefine<\/span>(<\/span>HOMER_USER<\/span>,<\/span> \"homer_users\"<\/span>);<\/span>\ndefine<\/span>(<\/span>HOMER_PW<\/span>,<\/span> \"homer_password\"<\/span>);<\/span>\ndefine<\/span>(<\/span>HOMER_DB<\/span>,<\/span> \"homer_db\"<\/span>);<\/span>\ndefine<\/span>(<\/span>HOMER_TABLE<\/span>,<\/span> \"sip_capture\"<\/span>);<\/span><\/pre>\n
Modifying Apache configuration<\/h2>\n
Do not forget to modify apache config file to allow loading index.php file as the homer webgui is written in php language. So open apache‘ default config file<\/p>\n
vim \/etc\/apache2\/sites-enabled\/000-default<\/pre>\n
and add into line with DirectoryIndex (labeled with green) within Directory block (labeled with yellow) words index.php<\/em><\/strong>. The whole config should look like:<\/p>\n
<VirtualHost *:80>\n        ServerAdmin webmaster@localhost\n\n        DocumentRoot \/var\/www\n        <Directory \/>\n                Options FollowSymLinks\n                AllowOverride None\n        <\/Directory>\n        <Directory \/var\/www\/>\n                Options Indexes FollowSymLinks MultiViews\n                AllowOverride None\n                DirectoryIndex index.php<\/span> index.html\n                Order allow,deny\n                allow from all\n        <\/Directory><\/span>\n\n        ScriptAlias \/cgi-bin\/ \/usr\/lib\/cgi-bin\/\n        <Directory \"\/usr\/lib\/cgi-bin\">\n                AllowOverride None\n                Options +ExecCGI -MultiViews +SymLinksIfOwnerMatch\n                Order allow,deny\n                Allow from all\n        <\/Directory>\n\n        ErrorLog ${APACHE_LOG_DIR}\/error.log\n\n        # Possible values include: debug, info, notice, warn, error, crit,\n        # alert, emerg.\n        LogLevel warn\n\n        CustomLog ${APACHE_LOG_DIR}\/access.log combined\n\n    Alias \/doc\/ \"\/usr\/share\/doc\/\"\n    <Directory \"\/usr\/share\/doc\/\">\n        Options Indexes MultiViews FollowSymLinks\n        AllowOverride None\n        Order deny,allow\n        Deny from all\n        Allow from 127.0.0.0\/255.0.0.0 ::1\/128\n    <\/Directory>\n\n<\/VirtualHost>\n<\/pre>\n
Have to be noted, that it is default apache config.<\/p>\n
Finally restart apache with \/etc\/init.d\/apache restart<\/em><\/p>\n
First Login<\/h2>\n
Open your preferred browser and point out to webhomer folder, in my case homer.sip.uniza.sk\/webhomer\/<\/p>\n
\"\"<\/p>\n
and using the default login credentials test@test.com\/test123 we should be able login<\/p>\n
\"\"<\/p>\n
Modyfying accounts\/passwords<\/h2>\n
To modify\/delete existing account or add a new account you have to click on Admin menu and drag Users button from left part of the page and drop it somewhere on page.<\/p>\n
\"\"<\/p>\n
where user config panel will appear. It should look like.<\/p>\n
\"\"<\/p>\n
Clicking on existing accocunt we may modify it:<\/p>\n
\"\"<\/p>\n
Clicking on the Create buton we may create a new user:<\/p>\n
\"\"<\/p>\n
Enable statistics<\/h2>\n
First, extend homer_db with statistic tables<\/p>\n
mysql -u root -p homer_db < \/var\/www\/webhomer\/sql\/statistics.sql\n<\/pre>\n
then enable statistics module, so open preferences.php file<\/p>\n
vim \/var\/www\/webhomer\/preferences.php\n<\/pre>\n
look through for lines<\/p>\n
\/* Modules Options *\/\ndefine(MODULES, 0);  \/* Set to 1 Enable Statistic Modules *\/\n<\/pre>\n
and change to<\/p>\n
define(MODULES, 1);<\/pre>\n
Next we have to setup cron to run statistics collection script. I have small problem to locate statistic.pl srcipt required by official HowTo. finally I’ve make a git clone of homer project<\/p>\n
git clone https:\/\/code.google.com\/p\/homer\/<\/pre>\n
\n
<\/div>\n
<\/div>\n
and there<\/div>\n<\/div>\n
and there I’ve found required scripts folder with statistic.pl script. So copy the statistic.pl file to the \/usr\/local\/sbin\/ folder.<\/p>\n
Then open the file and edit database parameters:<\/p>\n
$mysql_table = \"sip_capture\";\n$mysql_dbname = \"homer_db\";\n$mysql_user = \"homer_user\";\n$mysql_password = \"homer_password\";\n$mysql_host = \"localhost\";<\/pre>\n
and prepare crontab,\u00a0for example put the following line into crontab file:<\/p>\n
*<\/span>\/5 * \u00a0 \u00a0* * * \u00a0 root \u00a0 \u00a0\/<\/span>usr<\/span>\/local\/<\/span>sbin<\/span>\/<\/span>statistic<\/span>.<\/span>pl<\/span><\/pre>\n
Finally check permission rules for \/usr\/local\/sbin\/statistic.pl file. They have to allow script execution. It should look like<\/p>\n
 ls -al \/usr\/local\/sbin\/statistic.pl\n-rwxr-xr-x <\/span><\/strong>1 root staff 5798 Dec 20 10:07 \/usr\/local\/sbin\/statistic.pl\n<\/pre>\n
If not, run<\/p>\n
chmod 755 \/usr\/local\/sbin\/statistic.pl\n<\/pre>\n
Installing\/enabling capture agent<\/h1>\n
Kamailio<\/h2>\n
SIP\u00a0capture functionalities are builded into core kamailio. We have to only load required module, initialized them with appropriate parameters and modify routing logic. We do it with directives which allow us to simply switch on\/off this functionalities:<\/p>\n
First, define WITH_HOMER\u00a0directive<\/p>\n
#!define WITH_HOMER\n<\/pre>\n
then move to loadparam section of your kamailio.cfg and paste there<\/p>\n
#!ifdef WITH_HOMER\nloadmodule \"siptrace.so\"\n#!endif\n<\/pre>\n
Take care that the siptrace module is loaded after loading mysql and tm modules!<\/p>\n
As a next step we will configure parameters of the module:<\/p>\n
#!ifdef WITH_HOMER\n# check IP and port of your capture node\nmodparam(\"siptrace\", \"duplicate_uri\",\"sip:158.193.139.49:5060\");\nmodparam(\"siptrace\", \"hep_mode_on\",1);\nmodparam(\"siptrace\", \"trace_to_database\",0);\nmodparam(\"siptrace\", \"trace_flag\",22);\nmodparam(\"siptrace\", \"trace_on\", 1);\n#!endif\n<\/pre>\n
Finally we modify main routing logic. Look for line with „route{“ and add<\/p>\n
#!ifdef WITH_HOMER\n        #start duplicate the SIP message now\n        sip_trace();\n        setflag(22);\n#!endif\n<\/pre>\n
Adding capture agents<\/h2>\n
Capture agents have to be added as nodes in homer_users DB (table homer nodes). It can be realized through webhomer GUI. We have to click on Admin menu and drag Nodes button from left part of the page and drop it somewhere on page.<\/p>\n
\"\"<\/p>\n
where nodes window willa appear:<\/p>\n
\"\"<\/p>\n
Where HOST\u00a0means IP\u00a0address of capture agent and name is its name unde which we are able to see its statistics and SIP\u00a0messages.<\/p>\n
Testing<\/h1>\n
Checking of required services<\/h2>\n
If everything is OK we should be able login to homer webgui and check admin status of required services, where inside of all fields have to be OK<\/p>\n
\"\"<\/p>\n
Monitoring verification<\/h2>\n
If everything is working, after login to webhomer, we are able to see captured sip messages:<\/p>\n
\"\"<\/p>","protected":false},"excerpt":{"rendered":"
Description: <\/strong>Homer is an Open Source SIP Capture server by Alexandr Dubovikov & Friends,  based on OpenSER\/Kamailio and supporting HEPv1\/v2 (Homer Encapsulation Protocol)<\/i> & IP proto 4 (IPIP)<\/i>  encapsulation and monitoring\/mirroring port capture modes. Homer ships  with a flexible and lightweight capture agent for unsupported scenarios  and a powerful browser based UI (webHomer).<\/p>\n
Web<\/strong>:<\/p>\n
http:\/\/sipcapture.org\/<\/p>\n
http:\/\/code.google.com\/p\/homer\/<\/p>","protected":false},"author":7,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_seopress_robots_primary_cat":"","_seopress_titles_title":"","_seopress_titles_desc":"","_seopress_robots_index":"","_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"categories":[781,685,771,807,809,699],"tags":[],"class_list":["post-481","post","type-post","status-publish","format-standard","hentry","category-kamailio-en","category-linux_-_howto-en","category-sip-en","category-sip-testing-en","category-sip-tools-en","category-mmm-tools"],"taxonomy_info":{"category":[{"value":781,"label":"Kamailio"},{"value":685,"label":"Linux - HOWTO"},{"value":771,"label":"SIP"},{"value":807,"label":"Testing"},{"value":809,"label":"Tools"},{"value":699,"label":"Tools"}]},"featured_image_src_large":false,"author_info":{"display_name":"admin","author_link":"https:\/\/nil.uniza.sk\/en\/author\/admin\/"},"comment_info":8,"category_info":[{"term_id":781,"name":"Kamailio","slug":"kamailio-en","term_group":0,"term_taxonomy_id":779,"taxonomy":"category","description":"","parent":771,"count":29,"filter":"raw","cat_ID":781,"category_count":29,"category_description":"","cat_name":"Kamailio","category_nicename":"kamailio-en","category_parent":771},{"term_id":685,"name":"Linux - HOWTO","slug":"linux_-_howto-en","term_group":0,"term_taxonomy_id":683,"taxonomy":"category","description":"","parent":0,"count":71,"filter":"raw","cat_ID":685,"category_count":71,"category_description":"","cat_name":"Linux - HOWTO","category_nicename":"linux_-_howto-en","category_parent":0},{"term_id":771,"name":"SIP","slug":"sip-en","term_group":0,"term_taxonomy_id":769,"taxonomy":"category","description":"","parent":0,"count":23,"filter":"raw","cat_ID":771,"category_count":23,"category_description":"","cat_name":"SIP","category_nicename":"sip-en","category_parent":0},{"term_id":807,"name":"Testing","slug":"sip-testing-en","term_group":0,"term_taxonomy_id":805,"taxonomy":"category","description":"","parent":771,"count":2,"filter":"raw","cat_ID":807,"category_count":2,"category_description":"","cat_name":"Testing","category_nicename":"sip-testing-en","category_parent":771},{"term_id":809,"name":"Tools","slug":"sip-tools-en","term_group":0,"term_taxonomy_id":807,"taxonomy":"category","description":"","parent":771,"count":10,"filter":"raw","cat_ID":809,"category_count":10,"category_description":"","cat_name":"Tools","category_nicename":"sip-tools-en","category_parent":771},{"term_id":699,"name":"Tools","slug":"mmm-tools","term_group":0,"term_taxonomy_id":697,"taxonomy":"category","description":"","parent":687,"count":6,"filter":"raw","cat_ID":699,"category_count":6,"category_description":"","cat_name":"Tools","category_nicename":"mmm-tools","category_parent":687}],"tag_info":false,"_links":{"self":[{"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/posts\/481","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/comments?post=481"}],"version-history":[{"count":0,"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/posts\/481\/revisions"}],"wp:attachment":[{"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/media?parent=481"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/categories?post=481"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/tags?post=481"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}