MDintz

1 Descripción

Esta aplicación permite invocar desde es el dialplan de asterisk distintos servicios desarrollados por MDtel. Cada uno de estos servicios es denominado entorno.

Los diferentes entornos que puede invocar la aplicación MDintz se definen en el archivo de configuración como secciones.

Cada uno de los entornos proporciona diferentes servicios y cada uno de los servicios tiene comandos. Por ejemplo, el entorno intz-nimitz tiene varios servicios (ping, BD, regExpr) y el como ejemplo, el servicio BD tienen diferentes comandos (sqlDato, enrutar, ...)

2 Formato invocación

Formato de comando en dialplan de asterisk (el separador ',' puede ser sustituido por '|'):

 MDintz(<entorno(nimitz)>,<servicio>,<comando>,<par1>,<par2>,...,<parN>)

Formato de comando en CLI de asterisk:

 mdintz qry <nHostFijo(*,0..3)> <entorno(nimitz)> <servicio> <comando> <par1> <par2>...<parN>

3 Retornos generales

Cuando un retorno comienza por el caracter "+", indica a app_mdintz que debe reintentar en otro intz-nimitz.

Retornos genericos en ${MDintzRes}:

 +curro_congestion
 Hay demasiados trabajos encolados a la espera de ejecucion.

 curro_error_param
 El numero de parametros es incorrecto o el comando es desconocido.

 curro_cmd_desconocido
 El comando solicitado es desconocido.

 curro_supervivencia
 No se puede ejecutar en modo supervivencia.

 +mysql_fuera_servicio
 No hay conexion con la base de datos.

 mysql_error_ejec
 Se ha producido algun error en la ejecucion de sentencias SQL.

 +mysql_temporizador
 Cumplido temporizador sin recibir respuesta de la base de datos.

4 Versiones

4.1 (versión 20170130)

La mejora introducida en esta versión es su capacidad de integrarse con un servidor intz desarrollado en tomcat en base al uso de protocolo http, siendo esto transparente para el dialplan.

Lo que se ha hecho es incorporar dos nuevos campo en /etc/asterisk/MDintz.conf:

• protocolo. Valores:

 . nimitz (por defecto para compatibilidad hacia atrás)
 . http1 (nuevo para conectarse con tomcat usando http/get)
 . http2 (nuevo y preferido para conectarse con tomcat usando http/post)

• url. Cadena sin host y sin "entorno" que permite construir la url a la que se conectará en tomcat. Sólo se usa si el protocolo es http1 o http2.

5 Configuración

El archivo de configuración es /etc/asterisk/MDintz.conf

El archivo de configuración cuenta con diferentes secciones, siendo cada sección un entorno diferente al que podrá invocar el MDintz desde el dialplan.

Dentro de cada sección los parámetros de configuración son los siguientes:

5.1 host0

Direcciín IP donde esta el entorno

5.2 port0

Puerto

5.5 protocolo

Protocolo a utilizar con el entorno:

Valores:
 . nimitz (por defecto para compatibilidad hacia atrás)
 . http1 (nuevo para conectarse con tomcat usando http/get)
 . http2 (nuevo y preferido para conectarse con tomcat usando http/post)

5.6 url

Cadena sin host y sin "entorno" que permite construir la url a la que se conectará en tomcat. Sólo se usa si el protocolo es http1 o http2.

5.7 toConx

Tiempo de espera para conectarse al entorno

Valor recomendado 5s

5.8 toRx

Tiempo de espera de respuesta

Valor recomendado 10s