The following modules must be loaded before this module:

The following libraries or applications must be installed before running Kamailio with this module loaded:

Specify the details to connect to REDIS server. It takes a list of attribute=value separated by semicolon, the attributes can be name, unix, addr, port, db and pass. Name is a generic identifier to be used with module functions. unix is the path to the unix domain socket provided by redis server. addr and port are the IP address and the port to connect to REDIS server. pass is the server password. unix and (addr, port) are mutually exclusive. If both appear in same server settings unix domain socket is configured. db is the DB number to use (defaults to 0 if not specified).

You can set this parameter many times, in case you want to connect to many REDIS servers, just give different attributes and use the specific server name when querying the REDIS instance.

Default value is NULL.

...
modparam("ndb_redis", "server", "name=srvN;addr=127.0.0.1;port=6379;db=1")
modparam("ndb_redis", "server", "name=srvX;addr=127.0.0.2;port=6379;db=4;pass=mypassword")

# Unix domain socket
modparam("ndb_redis", "server", "name=srvY;unix=/tmp/redis.sock;db=3")
...

If set to 1, the module will correctly initialize even if redis is not available at start up.

Default value is “0”.

...
modparam("ndb_redis", "init_without_redis", 1)
...

The timeout when connecting to the redis server

Default value is 1000 ms.

...
modparam("ndb_redis", "connect_timeout", 500)
...

The timeout for each query to the redis server. If the redis server does not reply within the timeout value, the command will fail and kamailio will continue executing the cfg file.

Default value is 1000 ms.

...
modparam("ndb_redis", "cmd_timeout", 500)
...

Send a command to REDIS server identified by srvname. The reply will be stored in a local container identified by replyid. All the parameters can be strings with pseudo-variables that are evaluated at runtime.

Minimum required arguments are srvname, command and replyid. Command argument can be separated into several ones using %s token. (See examples) Total number of arguments cannot exceed six.

The reply can be accessed via pseudo-variable $redis(key). The key can be: type - type of the reply (as in hiredis.h); value - the value returned by REDIS server; info - in case of error from REDIS, it will contain an info message.

If reply type is an array (as in hiredis.h), there are other keys available:

...
if(redis_cmd("srvN", "INCR cnt", "r")) {
    # success - the incremented value is in $redis(r=>value)
    xlog("===== $redis(r=>type) * $redis(r=>value)\n");
}

# set a value
redis_cmd("srvN", "SET foo bar", "r");

redis_cmd("srvN", "SET ruri $ru", "r");

# get a value
redis_cmd("srvN", "GET foo", "r");

# same command separated into two arguments:
redis_cmd("srvN", "GET %s", "foo", "r");

# if we have a key with spaces within it:
redis_cmd("srvN", "GET %s", "foo bar", "r");

# several values substitution:
redis_cmd("srvN", "HMGET %s %s %s", "key1", "field1", "field2", "r");


# array example
if(redis_cmd("srvN", "HMGET foo_key field1 field3", "r")) {
    xlog("array size: $redis(r=>size)\n");
    xlog("first values: $redis(r=>value[0]) , $redis(r=>value[1])\n");
}
...

Frees data in a previous reply from memory. After this function call, accessing to a freed replyid returns null value.

It is not necessary to free a reply to use it again in a new redis_cmd function. When ndb_redis module closes, all pending replies are freed automatically.

...
After a redis command call:
	redis_cmd("srvN", "INCR cnt", "r");

free reply data:
	redis_free("r");
...