Instalación de eventos

El "events.war" (Web-ARCHive) se ejecuta en un contenedor de Java Servlet y funciona con el almacén de datos SQL DB para permitir descargar porciones seleccionadas de una secuencia de eventos a través de la web. Esto se puede utilizar con el mapeo basado en la web aplicaciones para proporcionar seguimiento casi en tiempo real de un vehículo o persona. 
El servlet '"events.war" actualmente admite recuperación de datos en formatos de archivo KML, XML, CSV, TXT, GPX o JSON, y puede usarse en programas de mapeo como Google Earth o MS MapPoints.
--

6.1 Configuración del archivo (webapp.conf)

        
    
 
El archivo de configuración de tiempo de ejecución predeterminado "webapp.conf" incluye el archivo "common.conf", que a su vez incluye "sistema.conf" y "personalizado.conf". Para la mayoría de las instalaciones, los valores predeterminados especificados en este archivo se pueden dejar como están. Sin embargo, algunos elementos, como las especificaciones de su servidor SMTP, deben configurarse para adaptarse a los requisitos de su sistema.
Si desea personalizar el archivo "webapp.conf" específicamente para el servlet "events.war", copie este archivo en el
directorio "$GTS_HOME/war/events/WEB-INF/" y modifique esta copia




6.2 Compilación/Instalación del Servlet Java (events.war)

        
    
Para compilar el archivo "events.war", ejecute el comando Ant build de la siguiente manera:
/zzz> cd $GTS_HOME
/usr/local/OpenGTS_1.2.3> eventos hormiga
(tenga en cuenta que el "todo hormiga" realizado anteriormente también crea el archivo "events.war")
El objetivo "eventos" es un envoltorio para los objetivos de hormiga "eventos. compilar" y "eventos. guerra". El objetivo
"events.compile" compila todas las clases y archivos de configuración necesarios en el directorio de compilación
"$GTS_HOME/compilación/eventos". El objetivo "events.war" luego crea el archivo 'archivo web'
"$GTS_HOME/construir/eventos.guerra".
Instale el archivo "events.war" según las instrucciones de instalación/configuración de Apache Tomcat. Por lo general, esto simplemente
implica copiar el archivo "events.war" al directorio "$CATALINA_HOME/webapps/.". (El método anterior para
la implementación asume que Tomcat está configurado para 'autoDeploy="true"')




6.3 Prueba de la instalación

        
    
Acceda a los datos almacenados en SQL DB a través de la web con la siguiente URL construida:
 http[s]://localhost:8080/events/<archivo>.{kml|xml|csv|txt|gpx|json}?
 a[cuenta]=<cuenta> - el nombre de la cuenta
 &u[ser]=<usuario> - el nombre de usuario
 &p[contraseña]=<contraseña> - la cuenta/contraseña de usuario
 &d[evice]=<dispositivo> - el nombre del dispositivo
 &g[roup]=<group> - el nombre del grupo de dispositivos (opcional)
 [&rf=<fromTime>] - rango de datos 'desde' opcional.
 [&rt=<toTime>] - rango de datos 'to' opcional.
 [&l[imit]=<limit>] - Número opcional de 'límite' de eventos devueltos.
Donde "localhost:8080" debe reemplazarse con el nombre de dominio real y el puerto utilizado para acceder a Apache
servidor web tomcat. [Nota: los elementos anteriores colocados entre corchetes son opcionales. Las opciones colocadas entre llaves
indicar que se debe seleccionar una de las opciones dentro de las llaves].
Algunos ejemplos:
• https://localhost:8080/events/data.csv?a=opendmtp&p=mypass&d=mobile
Devuelve un archivo de datos con formato CSV ('data.csv') que contiene los últimos 100 registros de eventos para el dispositivo
'opendmtp'/'móvil'. Los datos se devuelven a través de una conexión HTTP SSL. (Nota: reemplace 'mypass' con
la contraseña adecuada)
• http://localhost:8080/events/data.json?a=demo&p=mypass&d=demo
Devuelve un archivo de datos con formato JSON ('data.json') que contiene los últimos 100 registros de eventos para el dispositivo
'demostración'/'demostración'. (Nota: reemplace 'mypass' con la contraseña adecuada)
• http://localhost:8080/events/data.kml?a=gts&p=mypass&d=dev&rf=1145776000&rt=1145777000
Devolver un archivo de datos con formato KML (XML) ('data.kml') con los primeros 100 eventos dentro del especificado
rango para el dispositivo "gts/dev".
• http://localhost:8080/events/data.gpx?a=gts&p=mypass&d=dev&rf=1145776000&rt=1145777000
Devolver un archivo de datos con formato GPX (XML) ('data.gpx') con los primeros 100 eventos dentro del especificado
para el dispositivo "gts/dev" (consulte "http://www.topografix.com/gpx.asp" para obtener información sobre el
 formato de datos GPX).
Google Earth tiene la capacidad de sondear automáticamente los datos de esta URL a intervalos específicos.
configure Google Earth para leer puntos de datos de eventos del servidor, haga clic en "Agregar" en la barra de menú principal, luego
seleccione "Enlace de red". Agregue la URL de recuperación de KML al servidor y haga clic en "Actualizar parámetros" para poder
introducir tiempos de actualización periódicos. Para mostrar siempre los eventos más recientes en Google Earth, omita la fecha
opción de rango ("rf" y "rt") y, en su lugar, especifique la opción "límite" para que la lista devuelta siempre
incluir el último conjunto de eventos.