GenerateNBCDR=0
1
Genere CDRs para llamadas que vienen desde zonas vecinas. La dirección IP y el ID del endpoint que esta llamando se presenta como una cadena vacía. Esto es frecuentemente utilizado para propósitos de debug.
GenerateUCCDR=0
0
Genere CDRs para llamadas que son desconectadas (unconnected). Es es frecuentemente utilizado para propósitos de debug. Tenga presente que una llamada se considera desconectada (unconnected) solamente si el gatekeeper utiliza modo de ruteo (routed mode) y no recibe un mensaje de conexión Q.931. En modo directo (direct mode), siempre una llamada es considerada conectada (connected).
DefaultCallDurationLimit=3600
0
Límite máximo de tiempo (por defecto) que durará una llamada (en segundos).
Establesca esta variable a 0
para deshabilitar esta característica y no limitar
la duración de las llamadas.
AcctUpdateInterval=60
0
Un intervalo de tiempo (en segundos) para actualización de accounting (accounting update), dejando un registro para cada llamada en progreso. Detalles exactos de actualización de accounting (accounting update) dependen del módulo de registro de accounting elegido (ver la sección [Gatekeeper::Acct]). En general, la actualización del accounting (accounting update) es con la finalidad de tener un servicio de respaldo con el incremento de la duración de la llamada, para llamadas establecidas o conectadas (connected calls). El valor por defecto 0 le indica al gatkeeper que no realize actualización de accounting en absoluto. Por favor tenga presente que establecer períodos cortos de tiempo podría disminuír el rendimiento del GK.
TimestampFormat=Cisco
RFC822
Formato de presentación de las cadenas impresas dentro del los CDRs.
El gatekeeper puede trabajar como un endpoint registrandose con otro gatekeeper. Con esta característica, usted puede construír facilmente jerarquías de gatekeepers. Esta sección define las características de un endpoint para el gatekeeper.
Gatekeeper=10.0.1.1
no
Defina un gatekeeper padre (parent gatekeeper) para el endpoint(el gatekeeper), con el cual se va a registrar.
No trate de registrarse con usted mismo, a menos de que usted desee confundirse.
Para dehabilitar esta característica, configure este campo para que sea no
.
Type=Gateway
Gateway
Defina el tipo de terminal para el endpoint.
Los valores válidos son Gateway
o Terminal
.
H323ID=CitronProxy
<Name>
Especifique el o los alias H.323 ID para el endpoint. Múltiples alias pueden separarse con comas.
E164=18888600000,18888700000
N/A
Define el alias E.164 (dialedDigits) para el endpoint. Múltiples alias pueden separarse con comas.
Password=123456
N/A
Especifique un password para que sea enviado al gatekeeper padre.
Todas las peticiones RAS contendrán el password en el campo cryptoTokens
(MD5 & HMAC-SHA1-96) y en el campo tokens (CAT).
Para enviar peticiones RAS sin los camposcryptoTokens y tokens,
establesca el password como vacío.
Si la opción EncryptAllPasswords
está habilitada, o la variable KeyFilled
esta definida
en esta sección, el password está en forma encriptada y deberá ser creada utilizando
la utilidad addpasswd
.
Además, el password es también utilizado en mensajes LRQs enviados a gatekeepers vecinos.
Prefix=188886,188887
N/A
Registre los prefijos utilizados con el gatekeeper padre.
Solamente tiene efecto cuando el tipo de terminal es Gateway
.
TimeToLive=900
60
Sugiera un valor time-to-live (en segundos)para el proceso de registro. Tenga presente que el real contador para time-to-live es asignado por el gatekeeper padre en el mensaje RCF contestando a la petición RRQ.
RRQRetryInterval=10
3
Defina un intervalo de reintento en segundos para reenviar un RRQ si no se ha recibido respuesta desde el gatekeeper padre. Este intervalo es duplicado con cada falla, a un máximo de interrupción de RRQRetryInterval * 128.
ARQTimeout=2
2
Define un valor de espera en segundos para los ARQs.
UnregisterOnReload=1
0
Define si el gatekeeper hijo desregistra y re-registra con su gatekeeper padre cuando recibe el comando Reload.
NATRetryInterval=60
60
Tiempo que se debe esperar antes de tratar de reconectar el TCP NAT signalling socket (en segundos). Esto puede pasar por cualquiera de estas razones:la conexión no puede ser establecida o ésta ha sido rota.
NATKeepaliveInterval=86400
86400
Define que tan a menudo es refrescada la conexión de señalización TCP NAT con un gatekeeper padre. Puesto que las cajas NAT usualmente mantienen TCP mappings solamente por un tiempo definido, es bueno establecer éste con un valor un poco mas pequeñoque el de la caja NAT. El refresco de la conexión es realizado enviando un mensaje Q.931 IncomingCallProceeding. Si su NAT realiza traducción de puertos TCP, usted podría necesitar establecer éste a un valor cercano a 60 segundos.
Discovery=0
1
Decida se descubre o no el gatekeeper padre enviando primero un GRQ.
UseAlternateGK=0
1
Habilite la característica de alternar gatekeepers. Si los mensajes GRJ/GCF/RFC recibidos
desde el gatekeeper padre contienen una lista de gatekeepers alternos, esta
información es almacenada y puede ser utilizada después para registrarse con otro gatekeeper
en caso de cualquier falla. Si usted no desea usar esta característica, establezca
esta variable a 0
.
GatekeeperIdentifier=ParentGK
Not set
Defina este parámetro si usted desea aceptar solamente aquellos gatekeepers que correspondan a este identificador de gatekeeper. Es muy utilizado con GRQ discovery y puede prevenir una asignación de gatekeeper accidental. No establezca esta variable, si a usted no le importa acerca de identificadores de gatekeeper o si usted utiliza gatekeepers alternos que pueden tener diferentes identificadores de gatekeeper establecidos.
EndpointIdentifier=OpenH323GK
Not set
Establezca esta característica si usted desea utilizar un identificador de endpoint específico para este gatekeeper hijo. Si esta opción no esta establecida (por defecto), el gatekeeper padre asignará el identificador en un mensaje GCF/RCF.
Esta sección permite la configuración de las llamadas colas virtuales (virtual queues) para permitir distribuciónde llamadas entrantes por una aplicación externa, mediante el puerto de estado. Una cola virtual tiene un alias H.323 que puede ser llamado como un endpoint.
En el arrivo de un mensaje ARQ a una cola virtual, el gatekeeper señala una RouteRequest en el puerto de estado y espera a que una aplicación externa responda ya sea con un RouteReject (entonces el ARQ será rechazado) o con un RouteToAlias/RouteToGateway el cual conduce al ARQ a ser reescrito de este modo la llamada será ruteada hacia el alias (eg. call center agent) especificado por la aplicación externa.
Si no se recibe ninguna respuesta después de un período de tiempo, la llamada es finalizada.
Usted puede definir colas virtuales de tres maneras:
nombre de alias exacto
- Una lista de alias es asignada. Si un alias destino ARQ
corresponde a uno de estos nombres, la cola virtual es activada,prefijo
- Una lista de prefijos es dada. Si un alias destino ARQ
inicia con uno de estos prefijo, la cola virtual es activada,expresión regular
- Una expresión regular es dada. Si un alias destino ARQ
corresponde a la expresión, la cola virtual es activada.Ver la sección de monitoreso (monitoring section) para detalles sobre los mensajes y respuestas.
VirtualQueueAliases
Este parámetro define una lista de alias H.323 para las colas virtuales (Utilizado con vqueue RoutingPolicy).
VirtualQueueAliases=sales,support
VirtualQueuePrefixes
Este parámetro define una lista de prefijos para las colas virtuales (Utilizado con vqueue RoutingPolicy).
VirtualQueuePrefixes=001215,1215
VirtualQueueRegex
Este parámetro deine una expresión regular para las colas virtuales (Utilizado con vqueue RoutingPolicy).
VirtualQueueRegex=^(001|1)215[0-9]*$
RequestTimeout
10
Tiempo de espera en segundos para que la aplicación externa responda el RouteRequest.
Si no se recibe ninguna respuesta durante este tiempo un ARJ será enviado hacia el
enpoint que llama (caller).
Carge configuraciones del gatekeeper desde una base de datos SQL (adicionalmente a las configuraciones
leidas desde el archivo de configuración). Una ConfigQuery
genérica puede ser utilizada
para leer casi todas las configuraciones desde la base de datos y/o una de [RasSrv::RewriteE164]
,
[RasSrv::PermanentEndpoints]
, [RasSrv::Neighbors]
,
[RasSrv::GWPrefixes]
consultas pueden ser utilizadas para cargar configuraciones particulares.
Los valores leídos desde la base de datos SQL tiene preferencia sobre las configuraciones encontradas
en el archivo de configuración.
Driver=MySQL | PostgreSQL
El driver SQL a utilizar. Actualmente, drivers MySQL
and PostgreSQL
estan implementados.
Host=DNS[:PORT] | IP[:PORT]
localhost
Dirección del host SQL server. Puede estar en la forma de DNS[:PORT]
o IP[:PORT]
.
Como sql.mycompany.com
o sql.mycompany.com:3306
o 192.168.3.100
.
Database=billing
billing
El nombre de la base de datos a la cual se realiza la conexión.
Username=gnugk
El username utilizado para conectarse a la base de datos.
Password=secret
El password utilizado para conectarse a la base de datos.
Si el password no está especificado, un intento de conexión a la base de datos
sin un password es realizada.
Si EncryptAllPasswords
está habilitada, o una variable KeyFilled
esta definida
en esta sección, el password esta en forma encriptada y puede ser creado utilizando la
utilidad addpasswd
.
ConfigQuery=SELECT ...
N/A
Defina una consulta SQL utilizada para leer configuraciones del gatekeeper desde la base de datos.
La consulta es parametrizada, lo que significa que el remplazo de parámetros ocurre antes
de que la consulta es ejecutada. Los parámetros están denotados por las cadenas %1, %2, ...
Especifique %% para insertar un caracter de porcentaje antes de un dígito dentro de una cadena
(así %%1), especifique %{1} para pemitir expansión dentro de expesiones complejas
como %{1}123. Para ConfigQuery
solamente está definido un parámetro:
%1
- El identificador del gatekeepercolumna con índice 0
- nombre de la sección de configuración (config section name)columna con índice 1
- nombre de la opción (config key)columna con índice 2
- valor de la opción (config value)Ejemplos de consultas:
ConfigQuery=SELECT secname, seckey, secval FROM sqlconfig WHERE gk = '%1'
ConfigQuery=SELECT '[RasSrv::RRQAuth]', alias, rule FROM rrqauth WHERE gk = '%1'
RewriteE164Query=SELECT ...
N/A
Defina una consulta SQL para recuperar desde la base de datos reglas de reescritura (rewrite rules)
para la sección [RasSrv::RewriteE164]
. La consulta es parametrizada,
lo que significa que el reemplazo de parámetros ocurre antes de que cada consulta es ejecutada.
Los parámetros están denotados por cadenas %1, %2, ...
Especifique %% para insertar un caracter de porcentaje antes de un dígito dentro de una cadena
(así %%1), especifique %{1} para pemitir expansión dentro de expesiones complejas
como %{1}123. Para RewriteE164Query
solamente está definido un parámetro:
%1
- El identificador del gatekeepercolumna con índice 0
- nombre de la regla de reescritura (rewrite rule key)columna con índice 1
- valor de la regla de reescritura (rewrite rule value)Ejemplos de consulta:
RewriteE164Query=SELECT rkey, rvalue FROM rewriterule WHERE gk = '%1'
NeighborsQuery=SELECT ...
N/A
Defina una consulta SQL para recuperar desde la base de datos entradas vecinas (neighbor entries)
para la sección [RasSrv::Neighbors]
. La consulta es parametrizada,
lo que significa que el reemplazo de parámetros ocurre antes de que cada consulta es ejecutada.
Los parámetros están denotados por cadenas %1, %2, ...
Especifique %% para insertar un caracter de porcentaje antes de un dígito dentro de una cadena
(así %%1), especifique %{1} para pemitir expansión dentro de expesiones complejas
como %{1}123. Para NeighborsQuery
está definido un parámetro:
%1
- El identificador del gatekeepercolumna con índice 0
- nombre del vecino (identificador)columna con índice 1
- dirección IP del vecinocolumna con índice 2
- número de puerto del vecinocolumna con índice 3
- prefijos opcionales (separados por comas)columna con índice 4
- password opcionalcolumna con índice 5
- IP dinámica opcional (optional dynamic IP flag)Ejemplos de consultas:
NeighborsQuery=SELECT nid, nip, nport, npfx, NULL, 0 FROM neighbor WHERE gk = '%1'
PermanentEndpointsQuery=SELECT ...
N/A
Defina una consulta SQL para recuperar endpoints permanentes desde la base de datos
para la sección [RasSrv::PermanentEndpoints]
. La consulta es parametrizada,
lo que significa que el reemplazo de parámetros ocurre antes de que cada consulta es ejecutada.
Los parámetros están denotados por cadenas %1, %2, ...
Especifique %% para insertar un caracter de porcentaje antes de un dígito dentro de una cadena
(así %%1), especifique %{1} para pemitir expansión dentro de expesiones complejas
como %{1}123. Para PermanentEndpointsQuery
solamente está definido un parámetro:
%1
- El identificador del gatekeepercolumna con índice 0
- dirección IP del endpoint permanentecolumna con índice 1
- número de puerto del endpoint permanentecolumna con índice 2
- alias del endpoint permanentecolumna con índice 3
- prefijos opcionales del endpoint permanente (separados por comas)Ejemplos de consultas:
PermanentEndpointsQuery=SELECT peip, 1720, pealias, NULL FROM permanentep WHERE gk = '%1'
GWPrefixesQuery=SELECT ...
N/A
Defina una consulta SQL para recuperar prefijos de gateways desde la base de datos
para la sección [RasSrv::GWPrefixes]
. La consulta es parametrizada,
lo que significa que el reemplazo de parámetros ocurre antes de que cada consulta es ejecutada.
Los parámetros están denotados por cadenas %1, %2, ...
Especifique %% para insertar un caracter de porcentaje antes de un dígito dentro de una cadena
(así %%1), especifique %{1} para pemitir expansión dentro de expesiones complejas
como %{1}123. Para GWPrefixesQuery
solamente está definido un parámetro:
%1
- El identificador del gatekeepercolumna con índice 0
- alias del gatewaycolumna con índice 1
- prefijos del gateway (separados por comas)Ejemplos de consultas:
GWPrefixesQuery=SELECT gwalias, gwpfx FROM gwprefix WHERE gk = '%1'