Understanding basic kamailio.conf

From open-voip.org

Jump to: navigation, search
# $Id: kamailio.cfg 5881 2009-06-22 09:13:04Z henningw $

####### Global Parameters #########

set log level can be betwenn -3(less logs) and 4(more logs - note the performace!) the log levels can be found here

debug=3

stderror: no->syslog; yes=>standard error output

log_stderror=no
log_facility=LOG_LOCAL0

fork: background (=yes) or foreground (=no) mode. in (=no) no tcp/tls support

fork=yes

how many child processes per interface

children=4

port=5060

/* uncomment and configure the following line if you want Kamailio to 
   bind on a specific interface/port/proto (default bind on all available) */
#listen=udp:192.168.1.2:5060

kamailio modules

####### Modules Section ########

#set module path
mpath="//lib/kamailio/modules/"

/* uncomment next line for MySQL DB support */
loadmodule "mi_fifo.so"
loadmodule "sl.so"
loadmodule "tm.so"
loadmodule "rr.so"
loadmodule "pv.so"
loadmodule "maxfwd.so"
loadmodule "usrloc.so"
loadmodule "registrar.so"
loadmodule "textops.so"
loadmodule "uri_db.so"
loadmodule "siputils.so"
loadmodule "xlog.so"
loadmodule "acc.so"

# ----------------- setting module-specific parameters ---------------

fifo file for external commands

# ----- mi_fifo params -----
modparam("mi_fifo", "fifo_name", "/tmp/kamailio_fifo")

# ----- rr params -----
# add value to ;lr param to cope with most of the UAs
modparam("rr", "enable_full_lr", 1)
# do not append from tag to the RR (no need for this script)
modparam("rr", "append_fromtag", 0)

# ----- rr params -----
modparam("registrar", "method_filtering", 1)

# ----- uri_db params -----
/* by default we disable the DB support in the module as we do not need it
   in this configuration */
modparam("uri_db", "use_uri_table", 0)
modparam("uri_db", "db_url", "")

# ----- acc params -----
/* what sepcial events should be accounted ? */
modparam("acc", "early_media", 1)
modparam("acc", "report_ack", 1)
modparam("acc", "report_cancels", 1)
/* by default ww do not adjust the direct of the sequential requests.
   if you enable this parameter, be sure the enable "append_fromtag"
   in "rr" module */
modparam("acc", "detect_direction", 0)
/* account triggers (flags) */
modparam("acc", "failed_transaction_flag", 3)
modparam("acc", "log_flag", 1)
modparam("acc", "log_missed_flag", 2)
modparam("acc", "log_extra", 
        "src_user=$fU;src_domain=$fd;dst_ouser=$tU;dst_user=$rU;dst_domain=$rd")

####### Routing Logic ########

# main request routing logic
route{

check the max forward

        if (!mf_process_maxfwd_header("10")) {
                sl_send_reply("483","Too Many Hops");
                exit;
        }

        # NAT detection
        route(4);
        if (has_totag()) {
                # sequential request withing a dialog should
                # take the path determined by record-routing
                if (loose_route()) {
                        if (is_method("BYE")) {
                                setflag(1); # do accounting ...
                                setflag(3); # ... even if the transaction fails
                        }
                        route(1);
                } else {
                        if (is_method("SUBSCRIBE") && uri == myself) {
                                # in-dialog subscribe requests
                                route(2);
                                exit;
                        }
                        if ( is_method("ACK") ) {
                                if ( t_check_trans() ) {
                                        # non loose-route, but stateful ACK; must be an ACK after a 487 or e.g. 404 from upstream server
                                        t_relay();
                                        exit;
                                } else {
                                        # ACK without matching transaction ... ignore and discard.\n");
                                        exit;
                                }
                        }
                        sl_send_reply("404","Not here");
                }
                exit;
        }
        #initial requests
        # CANCEL processing
        if (is_method("CANCEL"))
        {
                if (t_check_trans())
                        t_relay();
                exit;
        }
        t_check_trans();
        # authentication
        route(3);

Add record-route to requests

        # record routing
        if (!is_method("REGISTER|MESSAGE"))
                record_route();
 
        # account only INVITEs
        if (is_method("INVITE")) {
                setflag(1); # do accounting
        }
        if (!uri==myself)
        /* replace with following line if multi-domain support is used */
        ##if (!is_uri_host_local())
        {

append_hf will add header to the SIP message

                append_hf("P-hint: outbound\r\n"); 
                route(1);
        }
        # requests for my domain
        if( is_method("PUBLISH|SUBSCRIBE"))
                route(2);
        if (is_method("REGISTER"))
        {

Save location of Registration requests

                if (!save("location"))
                        sl_reply_error();
                exit;
        }
        if ($rU==NULL) {
                # request with no Username in RURI
                sl_send_reply("484","Address Incomplete");
                exit;
        }
 
        # apply DB based aliases (uncomment to enable)
        ##alias_db_lookup("dbaliases");
        if (!lookup("location")) {
                switch ($retcode) {
                        case -1:
                        case -3:
                                t_newtran();
                                t_reply("404", "Not Found");
                                exit;
                        case -2:
                                sl_send_reply("405", "Method Not Allowed");
                                exit;
                }
        }
        # when routing via usrloc, log the missed calls also
        setflag(2);
        route(1);
} 
route[1] {
        /* example how to enable some additional event routes */
        if (is_method("INVITE")) {
                #t_on_branch("1");
                t_on_reply("1");
                t_on_failure("1");
        }

        if (!t_relay()) {
                sl_reply_error();
        }
        exit;
}
route[2]
{
        if (is_method("PUBLISH") || $rU==null)
        {
                sl_send_reply("404", "Not here");
                exit;
        }
        return;
}
route[3] {
        return;
}
route[4]{
        return;
}
route[5] {
        return;
}
branch_route[1] {
        xdbg("new branch at $ru\n");
}
onreply_route[1] {
        xdbg("incoming reply\n");
}
failure_route[1] {
        if (t_was_cancelled()) {
                exit;
        }
}
Personal tools