You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
kamailio/modules/db_mongodb/README

104 lines
2.3 KiB

DB_MONGODB Module
Daniel-Constantin Mierla
<miconda@gmail.com>
Edited by
Daniel-Constantin Mierla
<miconda@gmail.com>
Copyright © 2014 asipto.com
__________________________________________________________________
Table of Contents
1. Admin Guide
1. Overview
1.1. Limitations
2. Dependencies
2.1. Kamailio Modules
2.2. External Libraries or Applications
3. Usage
List of Examples
1.1. Usage
Chapter 1. Admin Guide
Table of Contents
1. Overview
1.1. Limitations
2. Dependencies
2.1. Kamailio Modules
2.2. External Libraries or Applications
3. Usage
1. Overview
1.1. Limitations
This module provides DB APIv1 connector for MongoDB NoSQL server.
It can be used as a replacement for other database modules such as
db_mysql, db_postgres, a.s.o. Not all the specs of DB APIv1 are
implemented, thus the usage of this module might be restricted to
specific modules.
You can read more about MongoDB at: http://www.mongodb.org.
1.1. Limitations
* This module has implemented the equivalent operations for INSERT,
UPDATE, DELETE and SELECT. The match condition (WHERE clause) works
with the operators: equal, not equal, greater than, less than,
equal or greater than, equal or less than. Raw query is not
implemented inside this module, use ndb_mongodb for sending any
kind of command to a MongoDB server.
2. Dependencies
2.1. Kamailio Modules
2.2. External Libraries or Applications
2.1. Kamailio Modules
The following modules must be loaded before this module:
* none.
2.2. External Libraries or Applications
The following libraries or applications must be installed before
running Kamailio with this module loaded:
* mongo-c-driver - available at
https://github.com/mongodb/mongo-c-driver
Note: if you use tls module, use at least mongo-c-driver v1.2.1 -
there were reports of issues inside earlier versions of the driver.
3. Usage
Load the module and set the the DB URL for specific modules to:
mongodb://username:password@host:port/database. Username, password and
port are optional.
Example 1.1. Usage
...
loadmodule "db_mongodb.so"
...
#!define DBURL "mongodb://localhost/kamailio"
modparam("acc", "db_url", DBURL)
...