mirror of https://github.com/sipwise/kamailio.git
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.
133 lines
3.1 KiB
133 lines
3.1 KiB
postgres Module
|
|
|
|
Greg Fausak
|
|
|
|
August.net
|
|
|
|
Edited by
|
|
|
|
Greg Fausak
|
|
|
|
Copyright © 2003 Greg Fausak
|
|
__________________________________________________________________
|
|
|
|
Table of Contents
|
|
|
|
1. Admin Guide
|
|
|
|
1. Overview
|
|
2. Dependencies
|
|
|
|
2.1. Kamailio Modules
|
|
2.2. External Libraries or Applications
|
|
|
|
3. Parameters
|
|
|
|
3.1. retries (integer)
|
|
3.2. timeout (integer)
|
|
3.3. tcp_keepalive (integer)
|
|
|
|
4. Functions
|
|
|
|
List of Examples
|
|
|
|
1.1. Set retries parameter
|
|
1.2. Set timeout parameter
|
|
1.3. Set tcp_keepalive parameter
|
|
|
|
Chapter 1. Admin Guide
|
|
|
|
Table of Contents
|
|
|
|
1. Overview
|
|
2. Dependencies
|
|
|
|
2.1. Kamailio Modules
|
|
2.2. External Libraries or Applications
|
|
|
|
3. Parameters
|
|
|
|
3.1. retries (integer)
|
|
3.2. timeout (integer)
|
|
3.3. tcp_keepalive (integer)
|
|
|
|
4. Functions
|
|
|
|
1. Overview
|
|
|
|
The module is an implementation of the internal DB API v1 and v2
|
|
connector for PostgreSQL server. It has support for reconnecting when
|
|
the connection is broken.
|
|
|
|
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:
|
|
* No dependencies on other Kamailio modules.
|
|
|
|
2.2. External Libraries or Applications
|
|
|
|
The following libraries or applications must be installed before
|
|
running Kamailio with this module loaded:
|
|
* PostgreSQL library - e.g., libpq5.
|
|
* PostgreSQL devel library - to compile the module (e.g., libpq-dev).
|
|
|
|
3. Parameters
|
|
|
|
3.1. retries (integer)
|
|
3.2. timeout (integer)
|
|
3.3. tcp_keepalive (integer)
|
|
|
|
3.1. retries (integer)
|
|
|
|
How many retries to attept to reconnect if connection to Postgres
|
|
server becomes broken.
|
|
|
|
Default value is 2 (that means three attepts to submit the query, first
|
|
will triger the connection error and two more (the value of this
|
|
parameter) after resetting the connection).
|
|
|
|
Example 1.1. Set retries parameter
|
|
...
|
|
modparam("db_postgres", "retries", 3)
|
|
...
|
|
|
|
3.2. timeout (integer)
|
|
|
|
Setting this variable to any value larger than zero (which is the
|
|
default value) enables both a connection timeout and a query timeout.
|
|
If a connection attempt or a query takes longer than this many seconds,
|
|
the operation will be aborted and an error will be returned.
|
|
|
|
Note that this timeout is applied to each underlying operation (i.e.
|
|
for each connection attempt), so depending on circumstances and on the
|
|
value of the “retries” variable, a single query from the SIP proxy's
|
|
point of view can take longer than the “timeout”.
|
|
|
|
Example 1.2. Set timeout parameter
|
|
...
|
|
modparam("db_postgres", "timeout", 10)
|
|
...
|
|
|
|
3.3. tcp_keepalive (integer)
|
|
|
|
Enable the TCP keepalive timer and set the number of seconds the
|
|
connection must be idle before to start sending keepalive packets.
|
|
Defaults to zero, which disables TCP keepalive packets.
|
|
|
|
Only supported on platforms which understand and support the
|
|
“TCP_KEEPIDLE” socket option.
|
|
|
|
Example 1.3. Set tcp_keepalive parameter
|
|
...
|
|
modparam("db_postgres", "tcp_keepalive", 600)
|
|
...
|
|
|
|
4. Functions
|
|
|
|
NONE
|