Kamailio: Difference between revisions
mNo edit summary |
mNo edit summary |
||
| Line 16: | Line 16: | ||
{{Cmd|/etc/init.d/postgresql setup}} | {{Cmd|/etc/init.d/postgresql setup}} | ||
== Direct logging information to syslog == | |||
The default behavior is to log activity to postmaster.log without rotation. This can result in large log files filling the ramdisk. Edit the postgresql.conf file to enable logging information to be sent to syslog (logs will appear in /var/log/messages which is rotated and older logs are automatically deleted). | The default behavior is to log activity to postmaster.log without rotation. This can result in large log files filling the ramdisk. Edit the postgresql.conf file to enable logging information to be sent to syslog (logs will appear in /var/log/messages which is rotated and older logs are automatically deleted). | ||
| Line 23: | Line 23: | ||
{{Cmd|<nowiki>sed "/^[# ]*log_destination/clog_destination = 'syslog'" -i /var/lib/postgresql/9.0/data/postgresql.conf</nowiki>}} | {{Cmd|<nowiki>sed "/^[# ]*log_destination/clog_destination = 'syslog'" -i /var/lib/postgresql/9.0/data/postgresql.conf</nowiki>}} | ||
== Start postgresql and enable auto start == | |||
{{Cmd|/etc/init.d/postgresql start | {{Cmd|/etc/init.d/postgresql start | ||
rc-update add postgresql}} | rc-update add postgresql}} | ||
Create file for Kamailio to start after pg-restore when booting: | |||
{{Cmd|<nowiki>echo 'rc_after=pg-restore' > /etc/conf.d/kamailio</nowiki>}} | {{Cmd|<nowiki>echo 'rc_after=pg-restore' > /etc/conf.d/kamailio</nowiki>}} | ||
= Install SIP Router (Kamailio) = | = Install SIP Router (Kamailio) = | ||
==Install Kamailio == | |||
{{Cmd|apk add kamailio kamailio-presence kamailio-pcre kamailio-postgres}} | {{Cmd|apk add kamailio kamailio-presence kamailio-pcre kamailio-postgres}} | ||
== Configuration of Kamailio == | |||
Edit the kamctlrc file - uncomment and/or change the following variables. Please note that in your production environment it is recommended that usernames and passwords be customized (defaults as used below should be avoided if at all possible) for added security. | |||
{{Cmd|<nowiki>sed "/^[# ]*SIP_DOMAIN/cSIP_DOMAIN=sip.<DOMAIN>.net" -i /etc/kamailio/kamctlrc | {{Cmd|<nowiki>sed "/^[# ]*SIP_DOMAIN/cSIP_DOMAIN=sip.<DOMAIN>.net" -i /etc/kamailio/kamctlrc | ||
sed '/^[# ]*DBENGINE/cDBENGINE=PGSQL' -i /etc/kamailio/kamctlrc | sed '/^[# ]*DBENGINE/cDBENGINE=PGSQL' -i /etc/kamailio/kamctlrc | ||
| Line 48: | Line 52: | ||
sed '/^[# ]*DBROOTUSER/cDBROOTUSER="postgres" ' -i /etc/kamailio/kamctlrc</nowiki>}} | sed '/^[# ]*DBROOTUSER/cDBROOTUSER="postgres" ' -i /etc/kamailio/kamctlrc</nowiki>}} | ||
== Create the Kamailio database == | |||
{{Cmd|<nowiki>echo postgres > /root/.pgpass | {{Cmd|<nowiki>echo postgres > /root/.pgpass | ||
| Line 54: | Line 58: | ||
kamdbctl create openser</nowiki>}} | kamdbctl create openser</nowiki>}} | ||
== Start Kamailio and setup for auto start on reboot == | |||
{{Cmd|<nowiki>/etc/init.d/kamailio start | {{Cmd|<nowiki>/etc/init.d/kamailio start | ||
rc-update add kamailio | rc-update add kamailio | ||
echo 'rc_after=postgresql' >> /etc/conf.d/kamailio<nowiki>}} | echo 'rc_after=postgresql' >> /etc/conf.d/kamailio</nowiki>}} | ||
= Create a few SIP ROUTER users (extensions) = | |||
Note | {{Note|You can add as many extensions you want to use this command: kamctl extension and password.}} | ||
Example: | Example: | ||
| Line 68: | Line 73: | ||
kamctl add 5001 5001}} | kamctl add 5001 5001}} | ||
Xlite (or other Software-based IP Phone) can be used for this preliminary test. | Xlite (or other Software-based IP Phone) can be used for this preliminary test. You can register a soft-phone or sip-phone with the account "5000" and password "5000", using the SIP-Router aip as "domain" and other one with 5001 and call each other. | ||
You can register a soft-phone or sip-phone with the account "5000" and password "5000", using the SIP-Router aip as "domain" and other one with 5001 and call each other. | |||
[[Category:Telephony]] | [[Category:Telephony]] | ||
Revision as of 03:56, 1 April 2012
Kamailio (former OpenSER) is an Open Source SIP Server released under GPL, able to handle thousands of call setups per second. Among features: asynchronous TCP, UDP and SCTP, secure communication via TLS for VoIP (voice, video), SIMPLE instant messaging and presence, ENUM, least cost routing, load balancing, routing fail-over, accounting, authentication and authorization against MySQL, Postgres, Oracle, Radius, LDAP, XMLRPC control interface, SNMP monitoring. It can be used to build large VoIP servicing platforms or to scale up SIP-to-PSTN gateways, PBX systems or media servers like Asterisk, FreeSWITCH or SEMS.
This document will be a quick c/p guide to setup Kamailio 3.1.1 on Alpinelinux 2.1, and assume that you have already installed the alpinelinux base system.
Upgrade Installation
echo 'http://dl-3.alpinelinux.org/alpine/v2.1/main/' > /etc/apk/repositories apk upgrade -U
Install Postgresql
apk add postgresql postgresql-client
- Setup postgresql
/etc/init.d/postgresql setup
Direct logging information to syslog
The default behavior is to log activity to postmaster.log without rotation. This can result in large log files filling the ramdisk. Edit the postgresql.conf file to enable logging information to be sent to syslog (logs will appear in /var/log/messages which is rotated and older logs are automatically deleted).
The following command will update the file correctly.
sed "/^[# ]*log_destination/clog_destination = 'syslog'" -i /var/lib/postgresql/9.0/data/postgresql.conf
Start postgresql and enable auto start
/etc/init.d/postgresql start rc-update add postgresql
Create file for Kamailio to start after pg-restore when booting:
echo 'rc_after=pg-restore' > /etc/conf.d/kamailio
Install SIP Router (Kamailio)
Install Kamailio
apk add kamailio kamailio-presence kamailio-pcre kamailio-postgres
Configuration of Kamailio
Edit the kamctlrc file - uncomment and/or change the following variables. Please note that in your production environment it is recommended that usernames and passwords be customized (defaults as used below should be avoided if at all possible) for added security.
sed "/^[# ]*SIP_DOMAIN/cSIP_DOMAIN=sip.<DOMAIN>.net" -i /etc/kamailio/kamctlrc sed '/^[# ]*DBENGINE/cDBENGINE=PGSQL' -i /etc/kamailio/kamctlrc sed '/^[# ]*DBHOST/cDBHOST=localhost' -i /etc/kamailio/kamctlrc sed '/^[# ]*DBNAME/cDBNAME=openser' -i /etc/kamailio/kamctlrc sed '/^[# ]*DBRWUSER/cDBRWUSER=openser' -i /etc/kamailio/kamctlrc sed '/^[# ]*DBRWPW/cDBRWPW="openser"' -i /etc/kamailio/kamctlrc sed '/^[# ]*DBROUSER/cDBROUSER=openserro' -i /etc/kamailio/kamctlrc sed '/^[# ]*DBROPW/cDBROPW=openserro' -i /etc/kamailio/kamctlrc sed '/^[# ]*DBROOTUSER/cDBROOTUSER="postgres" ' -i /etc/kamailio/kamctlrc
Create the Kamailio database
echo postgres > /root/.pgpass chmod 600 /root/.pgpass kamdbctl create openser
Start Kamailio and setup for auto start on reboot
/etc/init.d/kamailio start rc-update add kamailio echo 'rc_after=postgresql' >> /etc/conf.d/kamailio
Create a few SIP ROUTER users (extensions)
Example:
kamctl add 5000 5000 kamctl add 5001 5001
Xlite (or other Software-based IP Phone) can be used for this preliminary test. You can register a soft-phone or sip-phone with the account "5000" and password "5000", using the SIP-Router aip as "domain" and other one with 5001 and call each other.