Configuración de Tracking Listener
|
<< Click to Display Table of Contents >> Navigation: »No topics above this level« Configuración de Tracking Listener |
Tracking Listener no posee interfaz gráfica y debe ser configurada mediante archivos de parámetros localizados en el directorio trackinglistener/conf. Los parámetros se describen a continuación.
Archivo tracking.properties
Se trata del archivo principal de la configuración. Según las opciones seleccionadas puede necesitar otros archivos de configuración. Cada parámetro está compuesto por un par clave-valor. Las claves son únicas. Las líneas que comienzan con # son comentarios.
Los parámetros se describen a continuación.
Receivers
#Receivers to load (one or many) receiver.1=jmap.extensions.tracking.listener.receiver.TrackingTCPReceiver receiver.2=jmap.extensions.tracking.listener.receiver.TrackingUDPReceiver receiver.3=jmap.extensions.tracking.listener.receiver.FilesReceiver #receiver.4=jmap.extensions.tracking.listener.receiver.Simulator
|
Esta sección contiene la configuración de los módulos de recepción de Tracking Listener. Estos módulos son responsables de recibir los datos con distintos métodos. Se pueden utilizar varios módulos de recepción de manera simultánea. Cada módulo conlleva su propio archivo de parámetros.
Los principales módulos son TrackingTCPReceiver (recepción por TCP/IP, protocolo TCP) y TrackingUDPReceiver (recepción por TCP/IP, protocolo UDP). Según la configuración de los equipos de geolocalización y de transmisión por TCP/IP, se puede utilizar un módulo u otro. Cada módulo tiene su propio archivo de parámetros.
El módulo Simulator sirve para simular la recepción de datos por Tracking Listener.
#Send alarm if no activity for the specified timeout (ms) activity.alarm.enabled=true activity.alarm.timeout=43200000
|
Esta sección permite configurar la emisión de alarmas en el caso en que no se reciban datos durante un cierto período de tiempo. Permite detectar una situación anómala de inactividad como la pérdida de la conexión a la red.
El parámetro activity.alarm.enabled permite activar (true) o desactivar (false) el envío de alarmas de inactividad.
El parámetro activity.alarm.timeout define el período de inactividad (en milisegundos) pasado el cual se emite una alarma.
Caché
#Cache system to load (only one) cache=jmap.extensions.tracking.listener.cache.FileCache #cache=jmap.extensions.tracking.listener.cache.MemoryCache
|
Esta sección contiene la configuración del sistema de puesta en caché utilizado por Tracking Listener. Tracking Listener utiliza ese caché para almacenar los datos recibidos antes de transmitirlos al sistema de persistencia. Si el sistema de persistencia no funciona correctamente, el caché acumula los datos para que no se pierdan. Si los datos se acumulan, Tracking Listener puede lanzar alarmas. La sección sobre las alarmas ofrece más información.
Existen dos módulos. El módulo FileCache almacena los datos en disco (directorio trackinglistener/cache). En caso de interrupción de Tracking Listener, los datos en disco son releídos y enviados a la persistencia, lo que minimiza la pérdida de datos. Si los datos se acumulan en caché, el espacio en disco utilizado va a aumentar lo que en general no constituye un problema durante un corto período de tiempo. Se recomienda utilizar el módulo de puesta en caché. El archivo de parámetros de este módulo no contiene ningún parámetro.
El módulo MemoryCache almacena los datos en memoria. Si Tracking Listener es reencendido los datos en caché se pierden. Por otra parte, si los datos en caché se acumulan, la memoria se puede saturar rápidamente. En lo posible se debe utilizar el módulo FileCache. El archivo de parámetros de este módulo no contiene ningún parámetro.
#Send an alarm if cache size becomes higher than specified value. #Resend alarm if size grows by the specified factor cache.size.alarm.enabled=true cache.size.alarm.value=100 cache.size.alarm.value.factor=2
|
Esta sección concierne el envío de alarmas cuando los datos se acumulan en el caché.
El parámetro cache.size.alarm.enabled permite activar (true) o desactivar (false) el envío de alarmas.
El parámetro cache.size.alarm.value determina la cantidad de datos en caché que son necesarios para el envío de una alarma. Cuando el caché alcanza ese umbral se envía una alarma.
El parámetro cache.size.alarm.value.factor determina la frecuencia de envío de alarmas hasta que la situación vuelva a la normalidad. Por ejemplo, si el valor de este factor es 2, se emite una nueva alarma cada vez que la cantidad de datos en caché se duplica. Para un valor de 100 y un factor de 2, se emiten alarmas cuando la cantidad de datos en caché alcanzan los umbrales 100, 200, 400, 800, etc. El objetivo de este mecanismo es limitar la cantidad de alarmas emitidas.
Decoders
#Decoders to load (one or many) decoder.1=jmap.extensions.tracking.listener.decoder.CypressDecoder #decoder.2=jmap.extensions.tracking.listener.decoder.BluetreeDecoder #decoder.3=jmap.extensions.tracking.listener.decoder.CypressDickeyJohnDecoder
|
Esta sección concierne los módulos de descodificación de mensajes provenientes de equipos de geolocalización. Cada módulo está concebido para descodificar los mensajes de un tipo de equipo específico. Se pueden utilizar varios módulos de descodificación simultáneamente. Se pueden desarrollar nuevos módulos de descodificación para soportar nuevos tipos de equipo.
El módulo CypressDecoder se utiliza con frecuencia en Tracking para descodificar mensajes provenientes de equipos Chameleon CTM de la compañía Cypress.
El módulo CypressDisckeyJohnDecoder se utiliza para descodificar los mensajes de equipos Cypress conectados con los controladores de distribución de abrasivos de la compañía Dickey-John. Utilizando este módulo puede visualizar y analizar los datos de mantenimiento invernal de calzadas con Tracking.
Los módulos de descodificación existentes no comportan archivos de parámetros.
Persistance Handlers
#Persistence handler to load (only one) handler=jmap.extensions.tracking.listener.persistence.JDBCHandler #handler=jmap.extensions.tracking.listener.persistence.JMapServerHandler #handler=jmap.extensions.tracking.listener.persistence.Simulator
|
Esta sección concierne los módulos de gestión de la persistencia. Los módulos de persistencia almacenan la información recibida por Tracking Listener. Se puede configurar sólo un módulo de persistencia a la vez.
El módulo JDBCHandler persiste los datos directamente en una base de datos relacional (base de datos de Tracking). Puede utilizar este módulo si su arquitectura de red permite que Tracking Listener se conecte directamente a la base de datos de Tracking. Este módulo comporta su propio archivo de parámetros.
El módulo JMapServerHandler delega la persistencia de los datos a JMap Server. Todos los datos recibidos son enviados a JMap Server y éste asegura su persistencia en la base de datos de Tracking. Este módulo comporta su propio archivo de parámetros.
El módulo Simulator sólo se utiliza en test y no efectúa persistencia.
#Persistence thread pool size threadpool.size=2
|
Este parámetro define la cantidad de hilos de ejecución (threads) que se utilizarán para la persistencia. Esto permite ejecutar tareas de persistencia en simultáneo cuando se reciben volúmenes elevados de datos.El valor por defecto es 2 y resulta adecuado en la mayoría de los casos.
Filters
#Filters (zero, one or many) #filter.0=jmap.extensions.tracking.listener.filter.TrackingDataFilterSpeedValidity
|
Esta sección contiene la configuración de los módulos de filtro. Los filtros son opcionales y sirven para filtrar los datos recibidos de los aparatos de geolocalización.
El único filtro disponible es TrackingDataFilterSpeedValidity que permite ignorar los datos recibidos cuya velocidad indicada es inferior o igual a 0. Se pueden añadir otros filtros en función de las necesidades.
SMTP
#SMTP parameters for sending alarms using email smtp.host=mail.k2geospatial.com smtp.username=someuser smtp.password=apassword smtp.from=tracking@k2geospatial.com smtp.recipients=manager@k2geospatial.com
|
Esta sección permite definir los parámetros para el envío de alarmas por correo electrónico. Si no se informan los parámetros, no se envían correos.
El parámetro smtp.recipients permite definir los destinatarios de los correos de alarma. Las direcciones se separan con el carácter " ; ".
Logs
log.level=info
|
Tracking Listener contiene un registro de actividades (log file). Este parámetro determina el nivel de información que se escribe en el registro. Los archivos del registro están localizados en el directorio trackinglistener/logs.
Los niveles disponibles son all, debug, info, error y fatal.
Archivos de parámetros de los módulos
Archivo jmap.extensions.tracking.listener.receiver.TrackingTCPReceiver.properties
port=3636
|
Este archivo contiene un sólo parámetro que define el puerto que utilizará el módulo TrackingTCPReceiver para la recepción de datos con el protocolo TCP. El puerto puede variar en función de las necesidades.
Archivo jmap.extensions.tracking.listener.receiver.TrackingUDPReceiver.properties
port=3637
|
Este archivo contiene un sólo parámetro que define el puerto que utilizará el módulo TrackingUDPReceiver para la recepción de datos con el protocolo UDP. El puerto puede variar en función de las necesidades.
Archivo jmap.extensions.tracking.listener.receiver.Simulator.properties
delay.min=3000 delay.max=10000
#MOBILEID=X,Y,INPUT,DIRECTION|... Mobile_1=-73.56769676273318,45.494208187827,0,0|-73.56485608621003,45.492955408051074,1,0|-73.59709811452376,45.47284507389789,1,0 Mobile_2=-73.66769676273318,45.474208187827,0,0|-73.46485608621003,45.292955408051074,1,0|-73.49709811452376,45.67284507389789,0,0
|
Este archivo contiene los parámetros del módulo Simulator. Este módulo simula la recepción de datos por Tracking Listener. El simulador lee los datos de este archivo y simula la recepción de datos con una frecuencia variable.
Los parámetros delay.min y delay.max determinan la frecuencia (en milisegundos) de los datos simulados por Simulator. El retraso es aleatorio y se sitúa entre el retraso mínimo y el retraso máximo.
Las líneas siguientes permiten parametrizar la lista de móviles simulados y su comportamiento. Cada línea comienza con el nombre del móvil (la clave) y contiene series de 4 valores separados por caracteres " | ". Cada serie contiene las coordenadas x e y, el valor de las entradas y la dirección del móvil. Cuando se llega a la fin de la línea de un móvil el simulador vuelve al comienzo.
Archivo jmap.extensions.tracking.listener.persistence.JDBCHandler.properties
# Parameters for JDBC persistence jdbc.driver=org.gjt.mm.mysql.Driver jdbc.url=jdbc:mysql://localhost:3306/tracking?useCursorFetch=true jdbc.username=root jdbc.password= jdbc.poolsize=1
|
Este archivo contiene los parámetros del módulo JDBCHandler. Esos parámetros permiten establecer una conexión JDBC con un sistema de base de datos relacional.
El parámetro jdbc.driver indica la clase de controlador JDBC que se debe utilizar. Esta clase debe encontrarse en el classpath de Java.
El parámetro jdbc.url es la cadena de conexión a la base de datos y varía según el tipo de controlador seleccionado.
Los parámetros jdbc.username y jdbc.password contienen la información de autenticación para la base de datos.
Puede activar el cifrado de la contraseña utilizando la función password (contraseña).
Ejemplo: jdbc.password=password(Hola!123)
La contraseña escrita será reemplazada automáticamente en el archivo por la contraseña cifrada.
Archivo jmap.extensions.tracking.listener.persistence.JMapServerHandler.properties
poolid=99
# Parameters for JMapServer # connectionmode : CONNECTION_DIRECT or CONNECTION_PROXY
jmapserver.host=localhost jmapserver.port=7003 jmapserver.httpport=8080 jmapserver.proxypath=/jmap/servlet/jmapproxy jmapserver.serverid=jmap jmapserver.connectionmode=CONNECTION_DIRECT jmapserver.username=administrator jmapserver.password=
|
Este archivo contiene los parámetros del módulo JMapServerHandler que sirven para establecer una conexión con JMap Server.
Los parámetros jmapserver.host y jmapserver.port definen las opciones para una conexión directa (si jmapserver.connectionmode=CONNECTION_DIRECT).
Los parámetros jmapserver.httpport, jmapserver.proxypath y jmapserver.serverid definen las opciones para una conexión por proxy (si jmapserver.connectionmode=CONNECTION_PROXY).
Los parámetros jmapserver.username et jmapserver.password contienen la información de autenticación en JMap Server.
Puede activar el cifrado de la contraseña utilizando la función password(contraseña).
Ejemplo: jmapserver.password=password(Hola!123)
La contraseña será reemplazada automáticamente en el archivo por la contraseña cifrada.