Manual para el uso de medidores sel y la manera de conexion delta y estrella de los medidoresDescripción completa
voz ipDescripción completa
Descripción: Configuracion OMNI
Descripción completa
Descripción completa
Instalación y configuración de un SMBDDescripción completa
manual configuracion onity Configuracion de Estaciones en RedDescripción completa
Armado y configuracion de ordenadoresDescripción completa
Descripción completa
Descripción completa
Original source code: http://sourceforge.net/projects/opengts/ Our Current Custom installation is running at: http://track.migps.net General Requirement: Developer must deliver to us t…Full description
Descripción completa
Manual de Configuración SIAE ALSDescrição completa
Descripción: Manual de Configuracion DHCP Windows Server 2008
MANUAL PARA CONFIGURACION DE HUAWEDescripción completa
Manual de Instalacion y Configuracion Del Sam BroadcasterDescripción completa
Manual de Configuración SIAE ALSDescripción completa
Historial de revisiones Manual Revolución Fecha Cambiado Autor 0.0.1 25/03/2007Versión inicial MDF 0.0.2 30/03/2007Se agregó información para la administración tabla "Usuario" MDF 0.0.3 22/04/2007Objetivos de hormigas de nivel superior modificados para el evento, Mologogo, y la pista de servlet construye. MDF 0.0.4 05/06/2007Notas añadidas para los usuarios de Windows. Cambios de tipo de Menores, y los cambios de formato de párrafo / página .. MDF Toda la línea de comandos solicita en cursiva .. Añadido nota sobre el registro de una clave de Google Map. 0.0.5 25/05/2007Notas relativas Añadido soporte para Microsoft Virtual Earth. MDF 0.0.6 06/03/2007Actualizado enlaces de descarga de MySQL. Incluir Ant enlaces de descarga v1.7.0. Notas añadidas para los usuarios de Windows en relación con el establecimiento de las variables de entorno ación instal. MDF 0.0.7 13/06/2007Añadido documentación de administración de base de datos adicional. MDF Se agregó una nota en relación con instal ing un intérprete de Perl en Windows. Errores tipográficos menores fijos. 0.0.8 06/30/2007Añadido enlace adicional para su descarga MySQL WinXP. MDF 0.0.9 14/07/2007Comentarios adicionales sobre JavaBeans Activation Framework cambios de notas menores.MDF "Track.war". Cambiado el nombre del comando "server_mysql. *" Para "server_dmtp. *". Comentarios adicionales sobre la redespliegue de 0.0.10 27/07/2007Eliminada referencia a la creación de la cuenta por defecto "opendmtp", dispositivo "móvil", al inicializar la base de datos con "initdb". MDF que son equivalentes a correr "initdb". Comandos Añadido 0.0.11 08/09/2007Añadido algunos comentarios adicionales sobre el servlet 'Eventos'. Añadido comentarios respecto a la personalización del archivo configuation tiempo de ejecución de servlets "webapp.conf". MDF ... ". Script de arranque del servidor DMTP cambiado a" runserver.sh s gtsdmtp ". Tabla comandos de administración cambió de "bin / admin .sh ..." a "admin.sh 0.0.12 16/09/2007Añadido comentarios acerca del uso de archivos por lotes en Windows. MDF 0.1.1 30/11/2007Añadido nota adicional sobre el uso 'dbAdmin.pl "para añadir que faltan columnas de la tabla. Cambios de texto menores hicieron. Notas Añadido respecto al uso de 'plantilla' y 'GPRMC' para crear servidores de dispositivos personalizada .. MDF 0.1.2 06/02/2008Comentario añadido de requisitos previos en cuanto a la inflación instal de Tomcat en Linux.MDF 0.1.3 17/02/2008Se agregó una sección de Internacionalización / localización. MDF 0.1.4 20/02/2008Añadido comentarios adicionales de configuración regardin de Tomcat en Debian / Ubuntu Se agregó información sobre la implementación de servidores de comunicaciones del dispositivo. MDF 0.1.5 03/28/2008Java SDK 5.0 ahora se requiere para construir OpenGTS. MDF 0.1.6 11/04/2008Se ha añadido una sección sobre las pruebas ación instal MDF 0.1.7 14/05/2008Sección "Compilar" Actualización para incluir "hormiga todos". Añadido comentarios adicionales a la sección Localización .. MDF 0.1.8 20/06/2008Actualizado ubicación del archivo 'private.xml'. Actualizada la información de enlace de descarga para los varios módulos. MDF 0.1.9 08/07/2008Comentarios adicionales con respecto a la construcción Añadido el ejemplo del servidor 'plantilla'. MDF 0.1.10 07/27/2008Añadido nota con respecto a 'bin dbConfig.bat \' comando disponible para usuarios de Windows. MDF Se agregó información respecto a la personalización del mapa Pasadores .. 0.1.11 10/16/2008Varios cambios menores MDF 0.1.12 01/12/2008Actualizado sección "Administración de base de datos ' MDF 0.1.13 12/16/2008Actualización de Apache Tomcat URL de descarga MDF 0.1.14 01/02/2009Actualizaciones Varios MDF 0.2.0 02/04/2009Agregado Mac OS X información de configuración. Capítulos reorganizado. MDF 0.2.1 05/24/2009Inicio Añadido adicional 'dispositivo servidor de comunicaciones' / parada información. Se agregó una sección en instal ing MotoDMTP MDF 0.3.0 01/07/2009Añadido notas relativas al apoyo "events.war" para exportar los eventos con formato GPX. MDF en la validación de archivos LocalStrings. Se agregó una sección de "Creación / Modificación de Informes". Notas Añadido 0.3.1 02/08/2009Comentarios adicionales añadidos con respecto al uso "events.war" de mapa de Google Earth, actualizaciones nota con respecto a la personalización d MDF 0.3.2 08/23/2009Añadido comentarios respecto a correr "runserver.bat" en Windows. Actualizado Tomcat versión 5.5.28 a. MDF 0.3.3 30/10/2009Añadido opción 'sendMail' al mandato de CheckInstall '. MDF 0.3.4 06/18/2010Informaton actualizada sobre 'runserver', iniciar / detener los servidores de comunicaciones de dispositivos y el uso de 'psjava'. MDF comunicación del dispositivo fichero de configuración de servidores de tiempo de ejecución "dcservers.xml". Se agregó información con respecto a la 0.3.5 08/07/2010Agregado GTS sección de arquitectura del sistema. Actualizado diferentes enlaces prerequisitos. Actualizado partida / parada DCS. MDF 0.3.6 10/09/2010Añadido "dispositivo" opciones de administración adicionales. Añadido "Columnas de la tabla opcionales" MDF 0.4.1 08/03/2011Colocado de Prerrequisitos y OpenGTS instal aciones en capítulos separados. Capítulos renumerado. MDF basado servidor de comunicaciones del dispositivo. Añadido información adicional sobre el "GPRMC" http 0.4.2 04/01/2011Agregado Trackstick CSV información de importación de datos (v2.3.2). Errores tipográficos menores fijos, etc. MDF 0.4.3 21/08/2011Varios cambios. Agregado JSON formato de archivo a la descripción del "events.war". Actualización JavaMail descarga Versión / URL. MDF Módulo TK10x DCS. Añadido información sobre cómo iniciar la 0.4.4 12/27/2012Mesa Incluido nombres de campo opcionales. MDF 0.4.5 11.20.13 Actualizar vínculos. MDF
Configuración OpenGTS y Manual de instalación
Página 2 de 62
Page 3 OpenGTS Instalación / Configuración Contenidos: 1. Introducción 1.1 Plataformas compatibles 1.2 Arquitectura del Sistema 1.3 Mejoras Planificadas 1.4 Convenciones del documento 2 Carga de los módulos de requisitos previos 2.1 Java Compiler 2.2 Apoyo JavaMail 2.3 Apache "Ant" Construir Herramienta 2.4 Apache "Tomcat" contenedor servlet 2.5 Base de datos MySQL Proveedor 2.6 de MySQL controlador JDBC 3 Instalación / Compilación del Fuente OpenGTS 3.1 Descomprimir / Instalación de la Fuente OpenGTS https://translate.googleusercontent.com/translate_f
2/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
3.2 Configuración de las variables de entorno 3.3 Compilar el apoyo GTS Biblioteca Archivos 4 de inicialización y pruebas de instalación 4.1 Inicializando las tablas de bases de datos SQL 4.2 Prueba de la instalación 4.3 Carga de los datos de ejemplo 4.4 Creación de la Cuenta "sysadmin" 5 Instalación "track.war" 5.1 Configuración del archivo "webapp.conf" 5.2 Configuración del Informes disponibles 5.3 Configuración de la Private Label Look and Feel 5.4 Compilar / Instalación del servlet "track.war" 5.5 Prueba de la instalación 5.6 Instalación de varias versiones de "track.war" 6 Instalación "events.war" 6.1 Configurar el archivo "webapp.conf" 6.2 Compilar / Instalación del "events.war" Java Servlet 6.3 Comprobación de la instalación Administración de bases de datos 7 7.1 Creación de cuentas / Edición 7.2 Creación / Edición de Usuarios 7.3 Creación / Edición de Dispositivos 7.4 Base de Datos General de Funciones Administrativas 8 Instalación / Puesta en marcha del OpenDMTP, TK10x y Módulos Aspicore DCS 8.1 Configuración del archivo "dcservers.xml" 8.2 Inicio del servidor de comunicación de dispositivos 8.3 Detención del servidor de comunicación de dispositivos 8.4 Adición de un nuevo registro de dispositivos 9 Creación de su propio Comunicación Device Server 9.1 Servidores de comunicación de dispositivos basados en HTTP (utilizando el servlet "GPRMC") 9.1.1 Configuración del servlet "GPRMC" 9.1.2 Configuración predeterminada "GPRMC" 9.1.3 Construcción del servlet "GPRMC" 9.2 Raw SocketBasado Comunicación Device Server 9.2.1 Inicio del servidor de comunicación de dispositivos 9.2.2 Detención del servidor de comunicación de dispositivos Archivo de configuración XML 9.3 Runtime
Configuración OpenGTS y Manual de instalación
Página 3 de 62
Página 4 OpenGTS Instalación / Configuración Contenido: (continuación) 10 Internacionalización / Localización 10.1 Apoyar un nuevo idioma 10.2 Cambio del idioma visualizado 11 Creación / Modificación de Informes 11.1 Informe de Diseño. 11.2 Informe de Datos Iterator 11.3 Definición del informe XML 11.4 Disponible informe Especificaciones Apéndice: A) Soporte para Microsoft SQL Server B) Apoyo a Mologogo móviles con capacidad C) Tabla Columnas opcionales D) Instalación MotoDMTP E) La importación de GPS Eventos del Trackstick Mini
1. Introducción OpenGTS (Open Source G PS T estanterías S istema) tiene la intención de ofrecer un servicio basado en la web de servicios de fondo genérico para consulta y visualización de datos GPS relacionados. Se desgined para operar de forma independiente de cualquier dispositivo de rastreo GPS específico o protocolo, pero viene con soporte para varios formatos de protocolo del dispositivo (como OpenDMTP Abrir dispositivo fuente Monitoreo y Seguimiento Protocolo http://www.opendmtp.org ). Está diseñado específicamente para su uso en pequeñas y medianas empresas comerciales que deseen tomar ventaja de GPS seguimiento para "flotas" de vehículos. Sin embargo, OpenGTS es altamente configurable y escalable para empresas más grandes también. En el lado del servidor, OpenGTS está diseñado para ser el dispositivo y el protocolo independiente. Para utilizar las características de OpenGTS, necesitará un servidor de comunicaciones del dispositivo / protocolo específico para ser aplicado para comunicarse con el dispositivo remoto y colocar los datos en la base de datos SQL. OpenGTS barcos con soporte para OpenDMTP ( http://www.opendmtp.org ) De modo que los dispositivos compatibles con OpenDMTP estará listo para utilizar inmediatamente los servicios de OpenGTS. Un servidor de comunicaciones dispositivo personalizado también se puede implementar utilizando la fuente de servidor de ejemplo incluido código. Consulte el capítulo titulado "Creación de su propio Comunicación Device Server" para obtener más información. Por el lado de la interfaz web, la presentación de usuario es fácilmente personalizable para adaptarse a la persona deseada motivo. Opciones de menú y las características también son fácilmente personalizable para adaptarse a los requisitos específicos. El código fuente para el proyecto OpenGTS puede descargar desde SourceForge en el siguiente enlace: https://sourceforge.net/projects/opengts/files/ (Con licencia bajo la Licencia Apache Versión 2: http://www.apache.org/licenses/LICENSE2.0 ) Exención de responsabilidad: OpenGTS / OpenDMTP no deben ser utilizados para cualquier actividad ilegal. Los proveedores de este proyecto no asumen responsibity para cualquier actividad ilegal que pueden llevarse a cabo por los usuarios de este software. 1.1) Plataformas compatibles OpenGTS se implementa completamente en Java y debe funcionar bien en cualquier sistema que es totalmente compatible con el Java Runtime Medio Ambiente. Sin embargo, esta aplicación requiere un servidor de base de datos SQL, y por lo tanto se limita también a sistemas en los que su base de datos SQL elegido ejecuta. Visite el sitio web de soporte de base de datos SQL correspondiente para su sistemas compatibles (es decir. para MySQL ver " http://www.mysql.org " Que ha sido probado con OpenGTS en Linux, Mac OS X, FreeBSD, OpenBSD, y las plataformas / Vista / Windows XP 20xx). 1.2) Arquitectura del Sistema
Este gráfico describe la arquitectura del sistema básico del sistema de OpenGTS. Los diversos comunicación del dispositivo servidores (los módulos de los que escuchan para los datos entrantes de los dispositivos de localización GPS remotos) se ejecutan como procesos separados en la parte superior de Java. El servlet Track (es decir. La interfaz web), así como otros servlets (incluyendo cualquier dispositivo basado en http servidor de comunicaciones), ejecute dentro de un contenedor servlet, como Apache Tomcat.
Configuración OpenGTS y Manual de instalación
Página 5 de 62
Page 6 1.3) Mejoras Planificadas OpenGTS siempre está evolucionando, y las nuevas características continuamente se están haciendo disponibles. Éstos son algunos generales categorías de las características que se encuentran en la etapa de planificación o implementación: • Características del mapa Adicionales. • Informes adicionales. GTS Enterprise fue construido sobre OpenGTS y tiene varias características adicionales disponibles, así (más información con respecto a la GTS empresa se puede encontrar en " http://www.geotelematic.com/gts.html "): • Soporte para varios "uso comercial" proveedores de servicios de mapeo. • Soporte para muchos dispositivos de localización GPS a distancia adicionales. • Las opciones adicionales de presentación de informes. • Motor simple 'Reglas' para enviar notificaciones sobre la base de criterios de los eventos entrantes (mejorado la notificación de eventos Reglas del motor también está disponible). Póngase en contacto con nosotros con respecto a la disponibilidad de estas y otras características al " [email protected] ". 1.4) Convenciones del documento Con el fin de proporcionar un documento de instalación / configuración genérica que abarca diversos tipos de sistemas (es decir. De Windows XP, Mac OS X, y las distintas distribuciones de Linux), y de las diversas versiones del sistema OpenGTS, la siguiente convenciones y supuestos se han adoptado en este documento: 1) Este documento se asume que el sistema operativo de destino está basado en Linux. Para otros tipos de sistemas operativos, el separadores de ruta y especificaciones de directorio apropiado tendrá que ser utilizado que coincidan con los requisitos de su sistema operativo específico. Medio Ambiente especificación variable también puede variar entre sistemas operativos. Por ejemplo, para desreferencia el entorno JAVA_HOME vairable, "% JAVA_HOME%" se especifica en un Sistema de Windows, mientras que "$ JAVA_HOME" se especifica en Linux y Mac OS X. 2) Este documento se asume que el directorio en el que se instalarán OpenGTS es "/ usr / local /". Si se quiere debe instalar OpenGTS en un directorio diferente, usted tendrá que reemplazar las referencias de directorio en este documento al directorio en el que se instaló OpenGTS. 3) OpenGTS tiene un calendario de lanzamientos frecuentes. Para mantener la coherencia, este documento asume que la versión de OpenGTS a instalar es "OpenGTS_1.2.3". Así que las referencias a "OpenGTS_1.2.3" dentro de este documento debe ser reemplazado por el nombre real y la versión del OpenGTS que va a instalar. 4) En diversos ejemplos de línea de comandos, puede ver la especificación de directorio "/ zzz". Esta especificación es simplemente un nombre de marcador de posición que representa algún directorio actual en el sistema, y no un nombre de directorio literal existente en el sistema. 5) En varios lugares dentro de este documento, las opciones de línea de comandos se especifican como "argName = valor", donde "ArgName" es el nombre de un argumento de línea de comandos, y el "valor" es el valor que se asignará al mandamiento argumento ine. Al introducir comandos de Windows en un símbolo del sistema DOS (como cuando se utiliza el ".bat" versión de los comandos), comando argumentos como rootUser = root DEBEN bien estar encerrados entre comillas, como en "rootUser = root", o especificarse con dos puntos en lugar de un signo igual, como en rootUser: root (preferido). 6) En varios lugares dentro de este documento, las opciones de línea de comandos que se muestran pueden incluir valores de ejemplo que deben ser sustituidos por valores específicos a sus necesidades. Por ejemplo, una opción de línea de comandos que indica un cuenta puede ser especificado como "Cuenta = myaccount" o como "Cuenta = ". En este caso el nombre de argumento "Cuenta =" puede ser tomado literalmente, mientras "myaccount" o "" indica un valor que debe ser reemplazado con un valor específico que cumpla sus requisitos. 7) En varios lugares dentro de este documento, las opciones de línea de comandos que se muestran pueden mandar línea parámetros que son opcionales (sólo tienen que ser incluidos a para algunas aplicaciones, o para cambiar el comportamiento por defecto). Estos parámetros opcionales se mostrarán dentro de cuadrados corchetes '[' ... '] "(por ejemplo". [dir = / Tmp / gts] ") Estos cuadrados soporte indicará que el parámetro especificado dentro de los corchetes es opcional, dependiendo de la requisitos de comando. Los cuadrados soportes en sí no son para ser incluidos en la orden introducida. Configuración OpenGTS y Manual de instalación
2) Cargando los paquetes de requisitos previos Nota Importante: La instalación de los módulos OpenGTS requisito previo no requieren por lo menos un conocimiento intermedio de cómo instalar y configurar servicios de sistemas tales como el compilador Java, Apache Ant, MySQL (u otro servidor de base de datos SQL), Apache Tomcat (u otro contenedor de servlets), y otras tecnologías relacionadas. Compilar OpenGTS requiere que se instalarán los siguientes paquetes o aplicaciones, configurar, y se ejecuta en el sistema local: 2.1) Java Compiler Paquete: Java SE JDK 8 Descargar: http://www.java.com/en/download/manual.jsp Notas: descargar sólo el JDK (JRE ya está incluida en el JDK) Nota: Para evitar posibles dolores de cabeza tratando de obtener el código OpenGTS compilar, asegúrese de que está utilizando el "Sun Microsystems "versión del compilador de Java. Las versiones de" otros "tienen problemas al compilar el código. Después de instalar el compilador de Java, compruebe su versión con el siguiente comando: java version Asegúrese de que dice "Java (TM)" y "Java HotSpot (TM) Client VM". Nota: Asegúrese de que el directorio de instalación de Java SDK 'bin' se ha añadido a la variable de entorno PATH (ver más abajo). No hacerlo puede dar lugar a errores de compilación. NOTA IMPORTANTE: Sólo instalar el componente JDK, no instale el componente separado JRE. El JDK ya contiene un JRE componente y el JDK es necesario para compilar el código Java. Después de haber instalado tanto en el JDK y JRE en su sistema, puede provocar cierta confusión a la hora de compilar y ejecutar la aplicación. 2.1.a) a los usuarios de Mac OS X: El v1.6.0 Java JDK es probable que ya instalado en el sistema Mac OS X, por lo que es posible que no seria necesario descargar otra copia del JDK de Java. Su versión instalada del V.1.6.0 Java JDK puede estar en el siguiente directorio: /System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home 2.1.b) usuarios de Fedora / CentOS Linux: El Fedora / CentOS Java "OpenJDK Development Environment" se puede instalar y utilizar en lugar de descargar la JDK8 directamente de Sun Microsystems. El comando para instalar el desarrollador de Java 1.8.0 medio ambiente en Fedora / CentOS es el siguiente (debe ser 'root' para instalar): # Yum install java1.8.0openjdkdevel La variable de entorno JAVA_HOME entonces se debe establecer en la siguiente: # Export JAVA_HOME = / usr / lib / jvm / java1.8.0openjdk (Asegúrese de que "/usr/lib/jvm/java1.8.0openjdk" coincide con el nombre de la instalación de Java JDK directorio) Se recomienda crear también un "java" enlace simbólico en el directorio "/ usr / local /" directorio que apunta a la Java JDK instalación, como sigue: # Cd / usr / local # Ln s $ JAVA_HOME java
Configuración OpenGTS y Manual de instalación
Página 7 de 62
Página 8
2.1.c) los usuarios de Windows: El proceso de instalación de Java en Windows es probable que siga adelante una instalación tanto los directorios JDK y JRE (Incluso si el JRE no fue seleccionado durante el proceso de instalación). La instalación predeterminada instalará el siguientes directorios: C: \ Archivos de programa \ Java \ jdk1.8.0_40 \ C: \ Archivos de programa \ Java \ jre1.8.0_40 \ Apache "hormiga" y otros programas Java no funcionan bien con una variable de entorno JAVA_HOME que contiene espacios incrustados (como "C: \ Archivos de programa \ Java \ jdk1.8.0_40"). Para evitar esto Oracle tiene creado un subdirectorio en "C: \ Datos de programa \ Oracle \ Java \ javapath \" para contener links a diversos Java ejecutables sin espacios incrustados, sin embargo, por alguna razón se ha omitido el compilador JDK desde esta lista. Para corregir esto, necesitamos crear un directorio de enlace simbólico adicional a la instalación del JDK. Ir https://translate.googleusercontent.com/translate_f
6/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
al menú "Inicio" y seleccione "Todos los programas", luego "Accesorios", a continuación, haga clic en "Símbolo del sistema" y seleccione "Ejecutar como Administrador". Esto proporcionará a los privilegios adecuados para crear el enlace simbólico, utilizando el siguientes comandos: cd C: \ Datos de programa \ Oracle \ Java \ javapath \ MKLINK / D JDK "C: \ Archivos de programa \ Java \ jdk1.8.0_40" La variable de entorno JAVA_HOME Sistema entonces se puede ajustar a la siguiente (sin espacios incrustados): JAVA_HOME ==> C: \ Datos de programa \ Oracle \ Java \ javapath \ JDK El editor de variable de entorno se puede acceder desde el menú "Inicio", haga clic en "Panel de control" y, a continuación "Sistema", luego "Configuración avanzada del sistema", luego "Variables de entorno". La variable de entorno PATH del sistema debe entonces ser prefijado con la siguiente % JAVA_HOME% \ bin; Los diversos archivos jar biblioteca requerida (es decir. "Javax.mail.jar", etc) necesitarán ser copiado tanto a la directorios de bibliotecas extensas en las instalaciones de JDK y JRE. Estos directorios se enumeran a continuación: C: \ Archivos de programa \ Java \ jdk1.8.0_40 \ jre \ lib \ ext \ C: \ Archivos de programa \ Java \ jre1.8.0_40 \ lib \ ext \ NOTA: Los archivos jar biblioteca adicionales deben copiarse usando arrastrar / soltar desde la consola de Windows. Attemping copiarlos desde una ventana del símbolo del sistema puede aparecer como han copiado con éxito, sin embargo, estos archivos jar de la biblioteca aún no pueden ser accesibles por el tiempo de ejecución de Java.
Configuración OpenGTS y Manual de instalación
Página 8 de 62
Page 9 2.2) Soporte JavaMail Paquete: API Sun JavaMail (v1.5.2 +) URL: https://java.net/projects/javamail/pages/Home Código Postal: javax.mail.jar El archivo jar "javax.main.jar" de este archivo descarga se debe instalar en el directorio de Java extendió biblioteca como siguiente (acceso "root" requiere): # Cd / tmp / # Javax.mail.jar cp $ JAVA_HOME / jre / lib / ext /. (Donde "/ tmp /" es el directorio donde "javax.mail.jar" fue descomprimido) 2.2.a) a los usuarios de Mac OS X: En Mac OS X, el directorio de la biblioteca ampliada de Java puede ser en la siguiente ubicación: $ JAVA_HOME / lib / ext 2.2.b) los usuarios de Windows: Necesitará Este archivo jar que se copiarán en los directorios AMBOS biblioteca extendidos en las instalaciones de JDK y JRE: C: \ Archivos de programa \ Java \ jdk1.8.0_40 \ jre \ lib \ ext \ C: \ Archivos de programa \ Java \ jre1.8.0_40 \ lib \ ext \ NOTA: Este archivo jar debe ser copiado a través de arrastrar / soltar desde la consola de Windows. Attemping copiarlos desde una símbolo del sistema puede parecer que se han copiado con éxito, sin embargo, estos archivos jar de la biblioteca pueden no ser accesible por el tiempo de ejecución de Java. Esto permitirá que el conductor JavaMail esté disponible para todo el código Java que se ejecuta, y entornos de servlets Tomcat. (Nota importante: asegurarse de que los permisos de los archivos de la biblioteca tarro son legibles mundo) https://translate.googleusercontent.com/translate_f
7/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
2.3) Apache "Ant" Construir Herramienta Paquete: v1.9.4 Ant + Descargar: http://ant.apache.org/bindownload.cgi Código Postal: http://archive.apache.org/dist/ant/binaries/apacheant1.9.4bin.zip Nota: Asegúrese de que el directorio de la instalación de la hormiga 'bin' se ha añadido a la variable de entorno PATH (ver más abajo). 2.3.a) a los usuarios de Mac OS X: La última versión de la hormiga es probable que ya instalado en el sistema Mac OS X, por lo que es posible que no seria necesario descargar otra copia del Apache Ant. Su versión instalada de Apache Ant puede estar en la siguiente directorio: / Usr / share / ant 2.3.b) usuarios de Fedora / CentOS Linux: El Fedora / CentOS Apache "Hormiga" se puede instalar y utilizar en lugar de la descarga de la instalación "Ant" directamente de Apache. El comando para instalar el "Hormiga" crear ambiente en Fedora / CentOS es el siguiente (Debe ser 'root' para instalar): # Yum install ant
Configuración OpenGTS y Manual de instalación
Página 9 de 62
Página 10 2.4) Apache "Tomcat" contenedor servlet Paquete: Apache Tomcat V7.x contenedor de servlets URL: http://tomcat.apache.org/download70.cgi Código Postal: http://www.apache.org/dist/tomcat/tomcat7/v7.0.59/bin/apachetomcat7.0.59.zip Notas: No instale Tomcat v8, ya que contiene algunas incompatibilidades API con versiones anteriores de código servlet. Si su versión de la distribución Linux ya viene con una versión de Tomcat instalada, todavía es muy recomendable que se inicia con una versión de Tomcat descargar directamente desde la página web de Apache. Esto eliminará o reducirá cualquier permisos o problemas classpath que se pueden encontrar. Luego, cuando todo está en marcha y funcionando correctamente, si optar por hacerlo, se puede volver atrás e instalar OpenGTS en la versión de Apache Tomcat que se envió / instala con su distribución de Linux. 2.4.a) los usuarios de Linux que instalan el descargado Apache Tomcat: Se recomienda que la instalación de Tomcat manual de instalarse en el "/ usr / local /" directorio ('root' Se requiere acceso para instalar en este directorio). La variable de entorno CATALINA_HOME entonces se debe establecer en la siguiente: $ CATALINA_HOME exportación = / usr / local / apachetomcatx.xx.xx locales Donde "/usr/local/apachetomcatx.xx.xx" coincide con el nombre del directorio de instalación de Tomcat. Se recomienda crear también un "gato" enlace simbólico en el directorio "/ usr / local /" directorio que apunta a la Instalación de Tomcat, como sigue: # Cd / usr / local # Ln s $ CATALINA_HOME tomcat Dentro del directorio de instalación de Tomcat 'bin' (es decir. "$ CATALINA_HOME / bin"), asegúrese de que la ejecución de Permisos bit se establece en todos los archivos ".sh". Si no se establece el siguiente comando establecerá el bit de ejecución: $ Cd $ CATALINA_HOME / bin $ Chmod a + x * .sh Si el bit de ejecución no se encuentra en estos archivos, Tomcat "startup.sh" y comandos "shutdown.sh" pueden no ser capaz de ejecutar. 2.4.b) usuarios de Debian / Ubuntu utilizando un preinstalado Apache Tomcat: Le recomendamos descargar la versión de Tomcat directamente de Apache, sin embargo, si usted todavía va a utilizar el Debian / Ubuntu instalado la versión de Tomcat, y los archivos de registro de Tomcat están llenando de Mensajes "java.security.AccessControlException" al intentar acceder a las propiedades del sistema, entonces usted puede ser necesario para crear / editar un archivo de política de Tomcat en el directorio "/etc/tomcat6/policy.d" que contiene el información siguiente (o similar): conceder codeBase "file: $ {catalina.home} / webapps / pista / WEBINF / " { java.util.PropertyPermission permiso "*", "leer, escribir"; java.security.AllPermission permiso; }; conceder codeBase "file: $ {catalina.home} / webapps / eventos / WEBINF / " { https://translate.googleusercontent.com/translate_f
}; conceder "file: $ {catalina.home} / webapps / Mologogo / WEBINF / " codeBase { java.util.PropertyPermission permiso "*", "leer, escribir"; java.security.AllPermission permiso; }; Asegúrese de que los valores anteriores son adecuados para su instalación.
Configuración OpenGTS y Manual de instalación
Página 10 de 62
Página 11 2.5) Proveedor de base de datos MySQL Paquete: MySQL v5.xx URL: http://dev.mysql.com/downloads/mysql/ 2.5.a) los usuarios de Windows: En Windows, descargar / instalar el siguiente archivo: mysqlesencial5. X. XX m2win64.msi Donde "mysqlesenciales5. X. XX m2win64.msi" es el nombre de la instalación de MySQL más reciente para De Windows. 2.5.b) a los usuarios de Mac OS X: MySQL se puede descargar en el formato de paquete OS X desde la siguiente ubicación :: http://dev.mysql.com/downloads/mysql/5.5.html#downloads 2.5.c) usuarios de Fedora / CentOS Linux: El Fedora / CentOS "MySQL" se puede instalar y utilizar en lugar de la descarga de la instalación "MySQL" directamente desde MySQL. El comando para instalar "MySQL" en Fedora / CentOS es el siguiente (debe ser 'root' para instalar): # Yum install mysql mysqlserver Nota: Asegúrese de que el directorio de instalación de MySQL "bin" se ha añadido a la variable de entorno PATH.
Configuración OpenGTS y Manual de instalación https://translate.googleusercontent.com/translate_f
Página 11 de 62 9/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
Página 12 2.6) MySQL controlador JDBC Paquete: controlador MySQL Connector / J v5.1.XX JDBC URL: http://dev.mysql.com/downloads/connector/j/ Código Postal: mysqlconnectorjava5.1. XX .zip Nota: Connector / J se distribuye bajo licencia GPL. 2.6.a) usuarios de Fedora / CentOS Linux: El conductor Fedora / CentOS MySQL JDBC se puede instalar y utilizar en lugar de descargar el JDBC de MySQL instalación del controlador directamente desde MySQL. El comando para instalar "MySQL" en Fedora / CentOS es el siguiente (Debe ser 'root' para instalar): # Yum install mysqlconnectorjava El "mysqlconnectorjava5.1 XX .jar." Archivo jar a continuación se puede encontrar en la siguiente ubicación: /usr/share/java/mysqlconnectorjava5.1. XX .jar (Donde "mysqlconnectorjava5.1. XX .jar" coincide con el nombre del archivo jar instalar) El archivo jar "mysqlconnectorjava5.1. XX .jar" de este archivo zip descargado debe instalarse en el Java directorio de la biblioteca ampliada de la siguiente manera (acceso "root" es necesario): # Cd XXXXXXXX # Cp mysqlconnectorjava5.1.10bin.jar $ JAVA_HOME / jre / lib / ext /. (Donde "XXXXXXXX" es el directorio en el controlador JDBC de MySQL fue descomprimido) 2.6.b) a los usuarios de Mac OS X: En Mac OS X, el directorio de la biblioteca ampliada de Java puede ser en la siguiente ubicación: $ JAVA_HOME / lib / ext 2.6.c) los usuarios de Windows: Necesitará Este archivo jar que se copiarán en los directorios AMBOS biblioteca extendidos en las instalaciones de JDK y JRE: C: \ Archivos de programa \ Java \ jdk1.8.0_40 \ jre \ lib \ ext \ C: \ Archivos de programa \ Java \ jre1.8.0_40 \ lib \ ext \ NOTA: Este archivo jar debe ser copiado a través de arrastrar / soltar desde la consola de Windows. Attemping copiarlos desde una símbolo del sistema puede parecer que se han copiado con éxito, sin embargo, estos archivos jar de la biblioteca pueden no ser accesible por el tiempo de ejecución de Java. Esto permitirá que el controlador JDBC esté disponible para todo el código Java que se ejecuta, y entornos de servlets Tomcat. (Nota importante: asegurarse de que los permisos de los archivos de la biblioteca tarro son legibles mundo)
Configuración OpenGTS y Manual de instalación
Página 12 de 62
Página 13
3) Instalación / Compilación de la Fuente OpenGTS Nota Importante: La instalación de las características OpenGTS apoyados requiere al menos un conocimiento intermedio de cómo instalar y configurar servicios de sistemas tales como el compilador Java, Apache Ant, MySQL (u otro servidor de base de datos SQL), Apache Tomcat (u otro contenedor de servlets), y otras tecnologías relacionadas.
3.1) Descomprimir / Instalación de la Fuente OpenGTS En los sistemas Linux, se recomienda que los OpenGTS archivo zip se descomprimen y se instalan en el directorio "/ usr / local /" directorio. En Windows, se puede instalar en cualquier directorio conveniente, como en la partición raíz de "C: \". A los efectos de este documento, vamos a suponer que el sistema operativo de destino se basa en Linux, y que la ubicación donde se instalarán / descomprimido OpenGTS es "/usr/local/OpenGTS_1.2.3/" (Nota: es posible que tenga que elegir otro directorio de instalación si no tiene acceso "root" en el sistema de destino). Ajuste los separadores archivo / ruta y comandos según sea necesario para su sistema operativo particular, y directorio de instalación elegido. Instalar el código fuente OpenGTS: Descomprimir el paquete OpenGTS en "/ usr / local /" (esto tendrá que hacerse como el usuario "root"), u otro conveniente directorio (en Windows, elija un directorio donde le gustaría este paquete para ser colocado preferiblemente un camino que no contiene espacios incrustados). Por ejemplo, si el paquete OpenGTS que se instalará es "OpenGTS_1.2.3.zip", el comando para descomprimir el paquete sería: / Zzz> cd / usr / local /> Raíz usr / local Do / usr / local # descomprimir /tmp/OpenGTS_1.2.3.zip / Usuario usr / local R # chown: Grupo OpenGTS_1.2.3 / # Exit usr / local / Usr / local> GTS_HOME exportación = / usr / local / OpenGTS_1.2.3 (El anterior supone que OpenGTS_1.2.3.zip se descargó a "/ / tmp". Si los OpenGTS zip archivo se descargó en un directorio diferente, modificar la ubicación del directorio anterior y el nombre del archivo descargado en consecuencia. También, reemplace el Nombre de usuario "usuario" y el nombre del grupo "grupo", anteriormente con el nombre del usuario: grupo que usted desea tener dueños de la Instalación OpenGTS). (También tenga en cuenta que el " / Zzz "Nombre del directorio anterior es sólo un nombre de marcador de posición que representa cualquier directorio actual que puede ser, en efecto, antes de emitir el comando "cd"). 3.2) Configuración de las variables de entorno La siguiente variable de entorno debe establecerse en el directorio de instalación del paquete correspondiente o aplicación: • • • •
JAVA_HOME El Java JDK (no el JRE) directorio de instalación. ANT_HOME El directorio de instalación de Apache Ant. CATALINA_HOME El directorio de instalación de Apache Tomcat. GTS_HOME El directorio de instalación OpenGTS.
Configuración OpenGTS y Manual de instalación
Página 13 de 62
Página 14 3.2.a) los usuarios de Windows: La ubicación de la instalación de directorios 'bin' para el SDK de Java, Hormiga, y las instalaciones de servidor de base de datos SQL, necesita ser añadido a la variable de entorno PATH ejecución de comandos (si el proceso de instalación no tiene ya les añade a la variable PATH). Las variables de entorno se pueden configurar de forma manual en un símbolo del sistema con el comando "set", como en el siguiente ejemplo: C: \> set GTS_HOME = C: \ OpenGTS_1.2.3 (Al establecer las variables de entorno, las citas no deben ser utilizados para encerrar un directorio de instalación, incluso si la directorio contiene espacios incrustados) Las variables de entorno son referenciados por encerrándolos en '%'. Por ejemplo, después de establecer el entorno JAVA_HOME variable en punto a su directorio de instalación de JDK, esta variable de entorno sería desreferenciado como "% JAVA_HOME%". El separador de ruta del archivo es el carácter de backslash "\". Así, mientras que en Linux podría hacer referencia a un directorio / archivo como "$ JAVA_HOME / jre / lib ext / /.", en Windows se hace referencia a este mismo directorio que "% JAVA_HOME % \ Jre \ lib \ ext \ ". Las variables de entorno pueden ajustarse para ser definido automáticamente al iniciar un símbolo del sistema a través de la ventana "Propiedades del sistema" de la siguiente manera: Haga clic derecho sobre "Mi PC" y seleccione "Propiedades", la ventana "Propiedades del sistema" mostrará. Seleccione la pestaña "Avanzado" y luego presione el botón "Variables de entorno". En la sección "Variables del sistema", añade las siguientes variables: Nombre de la variable: JAVA_HOME (necesario para la construcción de OpenGTS, y corriendo Tomcat) https://translate.googleusercontent.com/translate_f
11/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
Valor: (La ubicación de su Java SDK carpeta de instalación, NO JRE) Nombre de la variable: ANT_HOME Valor: (La ubicación de su carpeta de instalación Ant) Nombre de la variable: CATALINA_HOME (necesario para OpenGTS construcción) Valor: (La ubicación de su carpeta de instalación Apach Tomcat) Nombre de la variable: GTS_HOME Valor: (La ubicación de su carpeta de instalación OpenGTS) (Presupuestos deberían NO pueden usar para encerrar un directorio de instalación de éstos variable de entorno especificaciones, incluso si el directorio contiene espacios incrustados) Prefijo lo siguiente a la " Ruta de la variable de entorno "en el" Variables de sistema " sección (crear una nueva " Camino variable "si uno no existe ya): .;% JAVA_HOME% \ bin;% MYSQL_HOME% \ bin;% ANT_HOME% \ bin; (Cotizaciones pueden añadirse a la variable PATH si es necesario) Haga clic en " Aceptar "en la" variable de entorno "ventana.
3.2.b) los usuarios de Linux: Se recomienda que los siguientes enlaces simbólicos se crearán dentro de la "/ usr / local /" directorio cuyo punto a su directorios 'home' correspondiente (saltar un enlace simbólico dado si ya se ha creado): # Cd / usr / local # Ln s $ JAVA_HOME java # Ln s $ CATALINA_HOME tomcat # Ln s $ GTS_HOME gts
Configuración OpenGTS y Manual de instalación
Página 14 de 62
Página 15 3.3) Compilar el apoyo GTS Biblioteca Archivos. 3.3a) Versiones precompilados de GTS: Si usted ha recibido una versión precompilada del paquete GTS, en esta sección se puede omitir (sin embargo usted puede reconstruir los diversos servlets y archivos jar si desea realizar ningún cambio en la configuración de ejecución antes de la implementación. Compilar la biblioteca OpenGTS servlet archivos .war "" ".jar" y: 'Cd' en el OpenGTS directorio de instalación y compilar los archivos jar y servlet archivos de guerra, utilizando la hormiga suministrado "Build.xml" script: / Usr locales> / cd $ GTS_HOME /usr/local/OpenGTS_1.2.3> ant todo Esto construirá varios archivos jar y archivos de guerra, en el directorio "$ GTS_HOME / build /", incluyendo: • • • • • • • • •
"Lib / gtsutils.jar" Este frasco contiene las utilidades de base y herramientas de acceso db. "Lib / gtsdb.jar" Este frasco contiene las utilidades de acceso a la base de datos y definición de la tabla. "Lib / gtsdmtp.jar" Este frasco contiene las envolturas del almacén de datos SQL db todo el OpenDMTP servidor. "Lib / tools.jar" Este frasco contiene comprobación del sistema de varios y herramientas administrativas. "Track.war" Este archivo "guerra" (webarchivo) contiene la interfaz web servlet 'Track'. "Events.war" Este archivo "guerra" contiene el acceso web de acceso EventData servlet. "Mologogo.war" Este archivo "guerra" contiene el servlet dispositivo Mologogo. "Gc101.war" Este archivo "guerra" incluye soporte para el dispositivo Sanav GC101. "Gprmc.war" Este archivo "guerra" contiene un servidor de soporte de servlets para un servidor de dispositivo basado en http genérico.
(Nota: esto es sólo una lista parcial Otros módulos se crearán también.). La construcción debe completar normalmente. Puede haber algunas advertencias que se muestran, sin embargo, si la advertencia o de error pueden ser ignorado, también habrá un mensaje que indica que este lado de la advertencia / error (o en una línea justo debajo de la advertencia / error).
4) Inicialización e Instalación de Pruebas Antes de utilizar OpenGTS , primero se debe inicializar. En esta sección se describen los pasos necesarios para la inicialización y pruebas. 4.1) Inicializando las tablas de bases de datos SQL Antes de guardar los datos en la base de datos SQL, primero se debe inicializar las tablas utilizadas por OpenGTS . Esto puede ser logrado con el comando "bin / init.sh" de la siguiente manera: / Zzz> cd $ GTS_HOME /usr/local/OpenGTS_1.2.3> bin / initdb.sh rootUser = rootPass = Donde es el usuario con acceso root en el servidor SQL, y es la contraseña del usuario root (mayo ser opcional dependiendo de la configuración de su servidor SQL). [NOTA: Este no es el mismo que el usuario "root" Linux] 4.1.a) Nota importante con respecto a ".sh" y ".bat" archivos de comandos: Los comandos que terminan en ".sh" o ".bat" DEBEN ser ejecutados desde el OpenGTS directorio de instalación. El intento de ejecutar estos comandos desde otro directorio puede resultar en una "ClassNotFoundException" o Error "NoClassDefFoundError", o similar. (Esto significa que usted debe cd $ GTS_HOME , a continuación, ejecutar el comando como " ") los usuarios de Windows pueden desear instalar un intérprete de Perl en su máquina en Para utilizar las versiones de Perl (".pl") de los scripts de línea de comandos que no requieren que se ejecutan Del OpenGTS directorio de instalación. Más información sobre las posibles distribuciones de Perl disponibles en Win32 plataformas se pueden encontrar en este lugar: " http://win32.perl.org/wiki/index.php?title=Win32_Distributions " 4.1.b) Nota importante para los usuarios de Windows: Al utilizar la versión ".bat" de los comandos en una ventana de DOS, argumentos de comandos como rootUser = root o bien debe ir entre comillas, como en "rootUser = root" , o especificarse con dos puntos en lugar de un signo igual, como en rootUser: root . Por lo tanto, en Windows, el comando es: bin \ initdb.bat "rootUser: userName "" rootPass: userpass " Donde ' userName 'y' userpass 'deben sustituirse por el usuario root y la contraseña correspondiente. El comando "initdb.sh" realiza las siguientes funciones al inicializar el OpenGTS base de datos: • Crea una base de datos llamada " gts ". • Crea / Concede "usuario gts "con" contraseña OpenGTS "con acceso a la" gts base de datos ". • Crea las siguientes tablas de la " gts base de datos "(esto es sólo una lista parcial): Tabla de Titular de la cuenta • Cuenta Mesa de usuario • Usuario AccesoControlLista de usuarios tabla • UserAcl Tabla de información de dispositivos • Dispositivo Los datos de eventos Recibido • EventData definiciones Geozona / Geofence • Geozona Plantillas de paquetes de eventos personalizados (DMTP solamente) • EventTemplate Los paquetes en espera de transmisión al dispositivo (sólo DMTP) • PendingPacket • etcétera El comando "initdb.sh" realiza las mismas funciones que la siguiente secuencia de comandos: / Zzz> cd $ GTS_HOME /usr/local/OpenGTS_1.2.3> bin / dbAdmin.pl createDB user = /usr/local/OpenGTS_1.2.3> bin / dbAdmin.pl Grant user = /usr/local/OpenGTS_1.2.3> bin / dbAdmin.pl mesas = ca
Página 17 Nota para los usuarios de Windows: "Bin / dbAdmin.pl" sólo está disponible para los usuarios de Linux, y los usuarios de Windows que se ejecuta dentro de un Cygwin medio ambiente. "Bin \ dbConfig.bat" proporciona un subconjunto de las funciones disponibles en "bin / dbAdmin.pl" que se desarrollará desde un símbolo del sistema de Windows. 4.2) Prueba de la instalación 4.2.a) Nota importante con respecto a ".sh" y ".bat" archivos de comandos: Los comandos que terminan en ".sh" o ".bat" DEBEN ser ejecutados desde el OpenGTS directorio de instalación. El intento de ejecutar estos comandos desde otro directorio puede resultar en una "ClassNotFoundException" o Error "NoClassDefFoundError", o similar. (Esto significa que usted debe cd $ GTS_HOME , a continuación, ejecutar el comando como " ") El siguiente comando se ha incluido para ayudar en el control de la instalación del sistema y la visualización de cualquier inconsistencias que podrían causar problemas en tiempo de ejecución: / Zzz> cd $ GTS_HOME /usr/local/OpenGTS_1.2.3> bin / checkInstall.sh O, en Windows: C: \> cd% GTS_HOME% C: \ OpenGTS_1.2.3> bin \ checkInstall.bat Este comando mostrará diversos directorios configurados y variables de entorno. Si se muestran los errores, que debe ser corregido (o al menos entiende) antes de continuar la implementación del sistema. Se requiere configuración SMTP para admitir características como el envío de notificaciones por correo electrónico olvidados, emailing informes, etc. Las propiedades requeridas para SMTP pueden configurarse en uno de los archivos de configuración de tiempo de ejecución ".conf" (típicamente "Custom.conf"). Si desea probar la configuración de correo electrónico SMTP, puede añadir la opción "sendMail ", que intentará enviar un mensaje de prueba a la dirección de correo electrónico especificada: /usr/local/OpenGTS_1.2.3> bin / checkInstall.sh sendMail [email protected] (Tenga en cuenta que hay un espacio entre la opción 'sendMail' y la dirección de correo electrónico) O, en Windows: C: \ OpenGTS_1.2.3> bin \ checkInstall.bat sendMail: [email protected] (Tenga en cuenta que hay es un ":" entre la opción 'sendMail' y la dirección de correo electrónico para la versión Windows del comando) Reemplazar "[email protected]" con la dirección de correo electrónico que desea que reciba el correo electrónico de prueba. 4.3) Cargando los datos de ejemplo Algunos datos de la muestra se ha proporcionado con el OpenGTS instalación que puede ser cargado y considerarse en el Web interfaz. Por favor, consulte el documento en "sampleData / README.txt" dentro del OpenGTS directorio de instalación para información sobre cómo cargar los datos de la muestra.
Configuración OpenGTS y Manual de instalación
Página 17 de 62
Página 18 4.4) La creación de la Cuenta "sysadmin" (La función de "sysadmin" sólo está disponible con la versión 2.2.7 OpenGTS y superior) Al entrar a la "sysadmin" cuenta una nueva 'ficha' menú estará disponible, con nuevas selecciones webpágina, que permiten https://translate.googleusercontent.com/translate_f
14/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
la creación de nuevas cuentas. El siguiente comando se puede utilizar para crear la cuenta de "administrador de sistemas": /usr/local/OpenGTS_1.2.3> bin / Cuenta Cuenta admin.sh = sysadmin pass = contraseña create O, en Windows: C: \ OpenGTS_1.2.3> bin \ Cuenta admin.bat Cuenta: sysadmin pass: contraseña create Vuelva a colocar la anterior especificación "contraseña" con una contraseña segura. A continuación, debería ser capaz de iniciar sesión en la cuenta de "sysadmin" para ver la nueva pestaña "System Admin".
Configuración OpenGTS y Manual de instalación
Página 18 de 62
Página 19
5) Instalación "track.war" El "track.war" ( ) Se ejecuta en un contenedor de servlets Java y trabaja con el almacén de datos SQL DB para proporcionar un completo W EB AR cebolleta interfaz web ofrecido a los datos de localización GPS capturados en la base de datos SQL desde dispositivos remotos. El mapeo asistencia utiliza actualmente OpenLayers / OpenStreetMap, pero puede ser configurado para utilizar otro servicio de mapas comercial proveedores. 5.1) Configuración del archivo "webapp.conf" El archivo de configuración de ejecución por defecto "webapp.conf" incluye el archivo "common.conf", que incluye a su vez "System.conf" y "custom.conf". Para la mayoría de las instalaciones, los valores predeterminados especificados en este archivo se puede dejar como está. Sin embargo, algunos elementos, tales como las especificaciones de su servidor SMTP, deben configurarse para adaptarse a los requisitos del sistema. 5.2) Configuración de los informes disponibles Varios detalle y resumen los informes se pueden definir mediante el archivo "reports.xml", que se puede encontrar en "$ GTS_HOME / reports.xml". https://translate.googleusercontent.com/translate_f
15/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
Más información detallada se puede encontrar en el archivo de arriba "reports.xml", y en este documento en otros lugares. Este es un Resumen de las características disponibles en el archivo "reports.xml" (experiencia en el formato general y la edición de archivos XML será necesario). "ReportLayout" define el formato de registro esperado y las columnas disponibles para el informe definido. La específica diseño del informe se define por la clase Java especificada y 2 diseños de informes se han proporcionado: •
org.opengts.war.report.event.EventDataLayout Esta disposición prevé para mostrar registros EventData y especifica las columnas disponibles en función de los campos disponibles en el registro EventData.
•
org.opengts.war.report.field.FieldLayout Esta disposición prevé mostrar genérico "fielddata" registros y especifica diversos tipo que se puede utilizar para mostrar los datos pertinentes columnas disponibles.
El "Informe" etiqueta especifica una clase Java que está unido a un ReportLayout específico. El "Informe" también especifica la forma en que se va a presentar al usuario (es decir. la opción de menú), título del informe, que se muestra columnas y criterios de selección de informe. 5.3) Configuración de la etiqueta privada look & feel La configuración y personalización de la interfaz de usuario de la web se pueden especificar en el archivo "$ GTS_HOME / private.xml" (O "$ GTS_HOME / private / private_common.xml" para el GTS Empresa). Este archivo controla las siguientes opciones que están disponibles en base a un "dominio" (el nombre de dominio de la URL de referencia visitar el servidor):
La fecha / Formatos de tiempo, y se muestra TimeZones. El MapProvider utilizado (es decir. Google Maps, Microsoft Virtual Earth, Mapstraction, OpenLayers, etc). Incluyendo lo iconos pasador se van a mostrar en el mapa. Los ReverseGeocodeProviders utilizan para convertir los valores de latitud / longitud en una dirección de la calle (Geonames, etc.). El GeocodeProvider utiliza para convertir direcciones de calles en una latitud / longitud (si está disponible). Las opciones disponibles de menú, las páginas web y archivos JSP de personalización. Opciones de informe disponibles. AccessControlList (ACL) definiciones. Y mucho, mucho más ...
Por favor refiérase a las observaciones contenidas en el "private.xml" (o "private_common.xml") de archivos para obtener más información.
Configuración OpenGTS y Manual de instalación
Página 19 de 62
Página 20 OpenGTS incluye soporte de mapeo para OpenLayers / OpenStreetMap, Google Maps, Microsoft Virtual Earth, y Mapstraction (que puede soportar varios otros proveedores de servicios de mapeo también). Póngase en contacto con nosotros en relación con el apoyo a otros proveedores de servicios de mapeo comerciales. Si usted va a utilizar Google Maps para su proveedor de mapas, también debe registrarse para obtener una clave de Google Map (asegúrese de que usted cumpla con sus términos de servicio) y coloque la llave de regresar en el (O "private_common.xml") archivo "private.xml" en el lugar indicado (es decir. Reemplazar "*** Place Google Maps Clave Aquí *** "con su clave citado). Para cambiar el valor por defecto aparece mapa chinchetas, puede crear su propio Sección "Pasadores" dentro de su MapProvider elegido. Vea la sección de archivos 'private.xml' Pasadores (en el "OpenLayers" sección MapProvider) para obtener más información sobre la personalización de iconos pasador. Consulte los contenidos del archivo de etiqueta privada proporcionada en "$ GTS_HOME / private.xml" para obtener más información sobre específica personalizaciones (experiancia en el formato general, edición y sintaxis de los archivos XML será necesario). 5.3.a) Mantener sintaxis XML adecuado al modificar " private.xml "o" reports.xml " Asegúrese de que los cambios en el archivo 'private.xml' todavía cumplen con sintaxis XML adecuado. XML es muy en particular acerca de la sintaxis correcta, y la introducción de un error de sintaxis XML menudo resulta en un mensaje de error similar al el siguiente al intentar ver la página de inicio de sesión en un navegador web: Configuración no válida 'private.xml', por favor póngase en contacto con el administrador del sistema Ejecutar "bin / checkInstall.sh" para ayudar a diagnosticar los errores de sintaxis XML que pueden haber sido introducidas. El lookandfeel general de la interfaz web también se pueden cambiar modificando el archivo JSP "$ GTS_HOME / guerra / pista / jsp / loginSession.jsp" y los diferentes archivos CSS en el directorio "$ GTS_HOME / guerra / pista / css /". Busque la sección de etiqueta "páginas web" en el archivo "private.xml" para adicional información sobre la personalización del archivo "loginSession.jsp". 5.3.b) IMPORTANTE: Vuelva a implementar todos los servlets después de modificar cualquier archivo de configuración de ejecución Cambios en cualquiera de "private.xml", "reports.xml", "webapp.conf", "common.conf", "system.conf", o archivos "custom.conf" (u otro ".xml" o archivo ".conf"), será necesario que el "track.war" (al igual que la otra servlets archivo) ser reconstruido y redesplegado. 5.4) Compilar / Instalación del "track.war" Servlet Java Para generar el archivo "track.war", ejecute el comando de construcción Ant de la siguiente manera: / Zzz> cd $ GTS_HOME https://translate.googleusercontent.com/translate_f
16/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
/usr/local/OpenGTS_1.2.3> pista hormiga (Nota, la "hormiga todos" realizado anteriormente también se basa en el archivo "track.war") La "pista" de destino es un contenedor para tareas ant "track.compile" y "track.war". El "track.compile" objetivo compila todas las clases necesarias y archivos de configuración en el directorio de construcción "$ GTS_HOME / build / pista". El objetivo "Track.war" y luego crea el archivo 'archivo web' "$ GTS_HOME / build / track.war". Si alguno de los tiempo de ejecución archivos de configuración han cambiado, como archivos "common.conf" "private.xml", "reports.xml", "webapp.conf", o (O posiblemente cualquier otro "* .conf" del "* .xml" archivo), a continuación, el archivo "track.war" debe ser reconstruido y redistribuido. Un acceso directo para reconstruir el archivo "track.war", si todos los módulos de origen ya se han compilado, es emitir la siguiente comando: / Zzz> cd $ GTS_HOME /usr/local/OpenGTS_1.2.3> hormiga track.war Esto simplemente volver a empaquetar el archivo "track.war" de los módulos de origen preconstruidos, y la configuración de tiempo de ejecución cambiada archivos. Si todo lo que ya ha sido compilado, este comando toma normalmente sólo unos segundos en completarse.
Configuración OpenGTS y Manual de instalación
Página 20 de 62
Página 21 Instale el archivo creado "track.war" según las instrucciones de instalación / configuración de Apache Tomcat. Típicamente, esto significa copiar el archivo "track.war" al directorio "$ CATALINA_HOME / webapps /.": /usr/local/OpenGTS_1.2.3> cp build / track.war $ CATALINA_HOME / webapps /. O bien, el siguiente objetivo "hormiga" también se puede utilizar: /usr/local/OpenGTS_1.2.3> track.deploy hormiga El método anterior para el despliegue supone que Tomcat está configurado para 'AutoDeploy = "true". Si los cambios no aparecen después de reconstruir y volver a desplegar el archivo "track.war", entonces puede ser necesario forzar Tomcat para actualizar el "Track.war" servlet siguiendo estos pasos: ") Parar Tomcat (es decir ". $ CATALINA_HOME / bin / shutdown.sh ") Eliminar el servlet "pista" existente (es decir, ". rm rf $ CATALINA_HOME / webapps / seguimiento * ") Implementar el nuevo servlet "pista" (es decir ". cp $ GTS_HOME / build / track.war $ CATALINA_HOME / webapps /. ") Reinicie Tomcat (es decir ". $ CATALINA_HOME / bin / startup.sh 5.5) Prueba de la instalación 5.5.a) de acceso web seguro: Configuración y uso de " https "(es decir. SSL) es muy recomendable que la URL incluye la contraseña de la cuenta y será encriptada a través de 'https', pero serán enviados en el claro si plain 'http' se utiliza. Instrucciones para configurar Tomcat para soportar SSL se puede encontrar en el sitio web de Apache Tomcat. Después de la construcción / desplegar 'track.war', usted debería ser capaz de ver la página de inicio de sesión con una URL similar a la siguiente: http: // localhost: 8080 / pista / Pista (Sustituir "'localhost: 8080" con su propio nombre de dominio donde' se instaló track.war '.) Tenga en cuenta que la especificación para el directorio URL "/ pista / Pista" es sensible a mayúsculas. Servicios de apoyo para la geocodificación inversa (girando una latitud / longitud en una dirección), utilizando como Geonames ( http://geonames.org ) Y Google, también se ha incluido. Busque los " ReverseGeocodeProvider etiquetas "en el Archivo 'private.xml' para más información. 5.5.b) Compatibilidad del navegador: La página del mapa de localización por GPS en la interfaz web hace un uso intensivo de formateo JavaScript y HTML. Firefox v3.xx, Chrome 8.0.x, y Safari 5.0.X, son las plataformas dirigidas, pero también parece funcionar bien (Con algunas diferencias menores) en Microsoft Internet Explorer 6.0 / 7.0 / 8.0 (algunas anomalías visuales han sido reportados con versiones anteriores de IE). Otros navegadores no se han probado completamente. 5.6) Instalación de varias versiones de "track.war" La URL para acceder a la página de inicio de sesión es normalmente de la siguiente manera: http: // localhost: 8080 / pista / Pista El nombre de " pista "que aparece más arriba deriva su nombre del nombre para el archivo de la guerra, en este caso" pista .war ". Este significa que usted puede instalar múltiples / diferentes copias de la " pista archivo .war ", siempre y cuando el nombre del archivo de la guerra es cambiado durante la copia. Por ejemplo, si copia el " track archivo .war "para Tomcat de la siguiente manera: https://translate.googleusercontent.com/translate_f
17/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
/usr/local/OpenGTS_1.2.3> acumulación cp / pista .war $ CATALINA_HOME / webapps / pista1 .war A continuación, puede acceder a esta versión instalada con la siguiente URL: http: // localhost: 8080 / pista1 / Pista Configuración OpenGTS y Manual de instalación
Página 21 de 62
Página 22
6) Instalación "events.war" El "events.war" ( ) Se ejecuta en un contenedor de servlets Java y trabaja con el almacén de datos SQL DB para permitir W EB AR cebolleta descargar porciones seleccionadas de una secuencia de eventos a través de Internet. Esto se puede utilizar con el mapeo basado en la web aplicaciones para proporcionar seguimiento casi en tiempo real de un vehículo o una persona. El servlet '"events.war" apoya actualmente la recuperación de datos en KML, XML, CSV, TXT, GPX, o formatos de archivo JSON, y se puede utilizar en los programas de mapeo como Google Earth, o MS MapPoints. 6.1) Configuración del archivo "webapp.conf" El archivo de configuración de ejecución por defecto "webapp.conf" incluye el archivo "common.conf", que incluye a su vez "System.conf" y "custom.conf". Para la mayoría de las instalaciones, los valores predeterminados especificados en este archivo se puede dejar como está. Sin embargo, algunos elementos, tales como las especificaciones de su servidor SMTP, deben configurarse para adaptarse a los requisitos del sistema. Si desea personalizar el archivo "webapp.conf" específicamente para el servlet "events.war", copiar este archivo a la directorio "$ GTS_HOME / guerra / eventos / WEBINF /" y modificar esta copia. 6.2) Compilar / Instalación del "events.war" Java Servlet Para generar el archivo "events.war", ejecute el comando de construcción Ant de la siguiente manera: / zzz> cd $ GTS_HOME /usr/local/OpenGTS_1.2.3> eventos de hormigas (Nota, la "hormiga todos" realizado anteriormente también se basa en el archivo "events.war") Los "eventos" de destino es un contenedor para tareas ant "events.compile" y "events.war". El objetivo "Events.compile" recopila todas las clases necesarias y archivos de configuración en el directorio de construcción "$ GTS_HOME / build / eventos". El "events.war" objetivo continuación, crea el archivo 'archivo web' "$ GTS_HOME / build / events.war". Instale el archivo "events.war" según las instrucciones de instalación / configuración de Apache Tomcat. Típicamente, esto simplemente implica copiar el archivo "events.war" al directorio "$ CATALINA_HOME / webapps /.". (El método anterior para despliegue supone que Tomcat está configurado para 'AutoDeploy = "true"') 6.3) Prueba de la instalación Acceda a los datos almacenados en la base de datos SQL a través de la web con la siguiente URL construida: http [s]: // localhost: 8080 / eventos / {kml | XML | csv | txt | gpx | json}.? un [UENTA] = el nombre de la cuenta & U [Ser] = el nombre de usuario & P [assword] = la cuenta / contraseña de usuario + D [evice] = el nombre del dispositivo & G [rupo] = el nombre del grupo de dispositivos (opcional) [& Rf = ] opcional 'de' rango de datos. [& Rt = ] opcional "a" rango de datos. [& L [imit] = ] opcional número de "límite" de los eventos devueltos. Donde "localhost: 8080" debe ser reemplazado con el nombre de dominio real y el puerto utilizado para acceder al Apache Servidor web Tomcat. [Nota: por encima de objetos colocados en cuadrados corchetes son opcionales. Las opciones colocados entre llaves indican que una de las opciones dentro de las llaves deben ser seleccionados].
Configuración OpenGTS y Manual de instalación
Página 22 de 62
Página 23 Nota: El 'rf' y (número de segundos intervalos de fechas 'rt' pueden especificarse en formato de hora 'Unix Epoch' desde la medianoche Ene https://translate.googleusercontent.com/translate_f
18/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
1, 1970) o en "aaaa / mm / dd / HH: MM: SS" formato. Si no se especifica, se devolverán los últimos 100 eventos. 6.3.a) Nota sobre el acceso web seguro: Configuración y uso de " https "(es decir. SSL) es muy recomendable que la URL incluye la contraseña de la cuenta y será encriptada a través de 'https', pero serán enviados en el claro si plain 'http' se utiliza. Instrucciones para configurar Tomcat para soportar SSL se puede encontrar en el sitio web de Apache Tomcat.
Algunos ejemplos: •
https: // localhost: 8080 / eventos / data.csv a = opendmtp & p = mypass + D = móvil Devolución de un archivo CSV con formato de datos ('data.csv') que contiene el último registro 100 eventos para el dispositivo ' opendmtp '/' móvil '. Los datos se devuelven a través de una conexión HTTP SSL. (Nota: sustituir « mypass 'con la contraseña correcta)
•
http: // localhost: 8080 / eventos / data.json a = Demo & p = mypass + D = Demo Devolución de un archivo con formato JSON de datos ('data.json') que contiene el último registro de 100 eventos para el dispositivo ' Demo '/' Demo '. (Nota: sustituir « mypass 'con la contraseña correcta)
•
http: // localhost: 8080 / eventos / data.kml un gts = & p = mypass + D = dev y rf = 1145776000 y rt = 1145777000 Devolver un KML (XML) archivo de datos fomatted ('data.kml') con los primeros 100 eventos dentro de la especificada rango para el dispositivo "gts / dev".
•
http: // localhost: 8080 / eventos / data.gpx a = gts & p = mypass + D = dev y rf = 1145776000 y rt = 1145777000 Devuelve una GPX (XML) archivo de datos fomatted ('data.gpx') con los primeros 100 eventos dentro de la especificada alcance para el dispositivo "gts / dev" (véase " http://www.topografix.com/gpx.asp "Para obtener información con respecto a la Formato de datos GPX).
Google Earth tiene la capacidad de forma automática datos de las encuestas de este URL a intervalos especificados. A configurar Google Earth para leer los puntos de datos de eventos del servidor, haga clic en "Añadir" en la barra de menú principal, luego seleccione "Red Enlace". Añadir la URL recuperación de KML al servidor y haga clic en "Parámetros Refresh" para poder entrar en tiempos de actualización periódica. Para mostrar siempre los acontecimientos más recientes dentro de Google Earth, omita la fecha opción de gama ("rf" y "ta") y en su lugar especificar la opción de "límite" para hacer que la lista devuelta para siempre incluir la última serie de eventos. •
http: // localhost: 8080 / eventos / data.kml a = gts & p = mypass + D = dev y límite = 100? Devolver un KML (XML) archivo de datos fomatted ('data.kml') con los últimos 100 eventos disponibles para el dispositivo "gts / dev".
•
http: // localhost: 8080 / eventos / data.kml a = gts & p = mypass + D = dev y límite = 1? Devolver un KML (XML) fomatted archivo de datos ('data.kml') con sólo el último (más reciente) de eventos para el dispositivo "gts / dev".
Configuración OpenGTS y Manual de instalación
Página 23 de 62
Página 24
7) Administración de bases de datos
7.a) Nota importante con respecto a ".sh" y ".bat" archivos de comandos: Los comandos que terminan en ".sh" o ".bat" DEBEN ser ejecutados desde el OpenGTS directorio de instalación. Intentando para ejecutar estos comandos desde otro directorio puede resultar en un "ClassNotFoundException" o Error "NoClassDefFoundError", o similar. (Esto significa que usted debe cd $ GTS_HOME , a continuación, ejecutar el comando como " ") 7.b) Nota importante para los usuarios de Windows: Al utilizar la versión ".bat" de los comandos en una ventana de DOS, argumentos de comandos como rootUser = root o bien debe ir entre comillas, como en "rootUser = root" , o especificarse con dos puntos en lugar de un signo igual, como en rootUser: root .
La mayor parte de administración de base de datos (cuentas, usuarios y dispositivos, etc) se puede realizar ya sea a través de la línea de comandos servicios públicos o a través de la interfaz web. Los ejemplos de edición ejemplo Cuenta / usuario / dispositivo que se muestra a continuación describen solamente algunos de los posibles campos en cada una de estas tablas. El archivo 'Schema.txt', incluido en el OpenGTS paquete, contiene una lista de las tablas actuales, y los campos en cada una de las mesas disponibles. Una lista de las tablas y los campos definidos en la actualidad también se puede generar con el siguiente comando: / Zzz> cd $ GTS_HOME /usr/local/OpenGTS_1.2.3> bin / dbAdmin.pl schema O, en Windows: C: \ zzz> cd% GTS_HOME% C: \ OpenGTS_1.2.3> bin \ dbAConfig.bat schema 7.1) Creación de cuentas / Edición El comando "bin / Cuenta admin.sh" apoya muchas funciones administrativas que actúan sobre la "Cuenta" SQL mesa. Estas son algunas de las funciones que se pueden realizar a través del "bin / Cuenta admin.sh" comando: Creación de una cuenta: /usr/local/OpenGTS_1.2.3> bin / Cuenta admin.sh Cuenta = create Esto crea la cuenta especificada con los valores por defecto (sustituir "" con el identificador de cuenta que desea crear). Edición de una cuenta: /usr/local/OpenGTS_1.2.3> bin / Cuenta admin.sh Cuenta = edit Este comando muestra un editor de campo Cuenta de línea de comandos, de forma similar a lo siguiente:
Configuración OpenGTS y Manual de instalación
Página 24 de 62
Página 25 (NOTA: La siguiente es sólo un ejemplo Su aplicación contiene definiciones de campo addtional favor.. revisar el archivo 'Schema.txt' en el paquete OpenGTS para obtener una lista de las posibles definiciones de campo.) Clave: opendmtp 0) Contraseña: "demo" 1) Descripción: "Cuenta Ejemplo" 2) está activo: "true" 3) Nombre de contacto: "" 4) Teléfono de contacto: "" 5) Contacto Dirección de correo electrónico: "" 6) Zona horaria: "EE.UU. / Hawaii" 7) Unidades de velocidad: "0" 8) Unidades de distancia: "0" 9) Modo Geocoder: "0" 10) Nombre PrivateLabel: "*" Introduzca el número de campo [o 'conservar', 'salida']: Para seleccionar un valor de campo de cambiar, introduzca el número de campo, luego pulsa enter. Después de cambiar el valor del campo, pulsa enter de nuevo. Guarde los cambios por fin entrar en "Guardar". Aquí está una descripción de algunos de los campos de cuenta (por favor ver 'Schema.txt' para una descripción de otro campo posible definiciones) : Contraseña La contraseña de la cuenta de inicio de sesión. Al iniciar la sesión, si existe el usuario "admin", a continuación, la contraseña "admin" serán utilizados, en lugar de esta contraseña, para autenticar al usuario. Descripción La descripción de la cuenta (utilizado en los informes, etc). Es activo Este valor es "true" si la Cuenta se considera todavía en servicio. If "falsos", entonces todas las conexiones por todo dispositivos de propiedad serán rechazadas. Nombre de Contacto El nombre de la persona de contacto para la Cuenta. Teléfono de contacto el número de teléfono de la persona de contacto. Contacto Dirección de correo electrónico addres correo electrónico de la persona de contacto. Zona Horaria La zona horaria preferida para la Cuenta. Unidades de velocidad Las unidades de velocidad preferidos para la Cuenta. Los valores válidos son: 0 = mph, 1 = kph, 2 = nudos. https://translate.googleusercontent.com/translate_f
20/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
Unidades de distancia las unidades de distancia preferidos para la Cuenta. Valor valores son: 0 = Miles, 1 = kilómetros, 2 = nudos. Modo Geocoder Este es el modo inverso geocodificación utilizado para esta cuenta. Los valores válidos son: 0 = No inversa geocodificación realizado, solamente 1 = Geozona búsqueda, 2 = Reversegeocodificación de códigos de estado de alta prioridad sólo, 3 = Reversegeocode todo (se requiere un servicio de geocodificación inversa disponible). PrivateLabel Nombre Este es el nombre del 'dominio' en el archivo 'private.xml' a los que esta cuenta debe ser asignado. Si hay más de un "dominio" se define en el archivo 'private.xml', a continuación, esto permite el uso de recursos diferentes inversageocodificación, y cartografía para diferentes cuentas. Listado de cuentas existentes: /usr/local/OpenGTS_1.2.3> bin / list Cuenta admin.sh Esta lista de todas las cuentas y dispositivos de propiedad.
Configuración OpenGTS y Manual de instalación
Página 25 de 62
Página 26 7.2) Creación / Edición de Usuarios El comando "bin / Usuario admin.sh" soporta varias funciones administrativas que actúan sobre la tabla de SQL "Usuario". Estas son algunas de las funciones que se pueden realizar con el comando "bin / Usuario admin.sh": Creación de un usuario: /usr/local/OpenGTS_1.2.3> bin / admin.sh usuario Cuenta = user = create Esto crea el usuario especificado con valores por defecto (sustituir "" con el identificador de usuario que desea crear). El usuario nombre "admin" está reservado para su uso por el administrador de la cuenta. Cuando el administrador de la cuenta registra en (dejando el campo de nombre de usuario en blanco en el registro en la pantalla), entonces el registro en el proceso se comprueba si existe el usuario "admin". Si esto el nombre de usuario no existe, entonces la contraseña y de control de acceso asignado al usuario "admin" se utilizará para la Cuenta administrador (Nota: el usuario predeterminado de inicio de sesión se puede cambiar en la página web Administración de cuentas, o en la Cuenta de línea de comandos de edición). Edición de un usuario: /usr/local/OpenGTS_1.2.3> bin / admin.sh usuario Cuenta = user = edit Este comando muestra un editor de campo de usuario de línea de comandos, de forma similar a lo siguiente: (NOTA: La siguiente es sólo un ejemplo Su aplicación contiene definiciones de campo addtional favor.. revisar el archivo 'Schema.txt' en el paquete OpenGTS para obtener una lista de las posibles definiciones de campo.) Clave: opendmtp, el usuario 0) Contraseña: "" 1) Descripción: "Usuario Nuevo" 2) está activo: "true" 3) Nombre de contacto: "" 4) Teléfono de contacto: "" 5) Contacto Dirección de correo electrónico: "" 6) Zona horaria: "" Introduzca el número de campo [o 'conservar', 'salida'] Para seleccionar un valor de campo de cambiar, introduzca el número de campo, luego pulsa enter. Después de cambiar el valor del campo, pulsa enter de nuevo. Guarde los cambios por fin entrar en "Guardar". He aquí una descripción detallada de algunos de los campos de usuario (consulte "Schema.txt " para una descripción de otros posibles definiciones de campo) : Contraseña La contraseña de inicio de sesión del usuario. Dejando el archivo de contraseñas vacío impedirá que el usuario inicie sesión. Si desea permitir que el usuario inicie sesión sin tener que introducir una contraseña, a continuación, debe establecer el campo de contraseña para la prueba " * blanco * "(mayúsculas y minúsculas, y sin las comillas por supuesto). Descripción La descripción del usuario (utilizado en los informes, etc). Es activo Este valor es "true" si el usuario todavía se considera en servicio. If "falsos", todos los intentos de conexión de este Usuario será rechazada. https://translate.googleusercontent.com/translate_f
21/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
Nombre de Contacto El nombre de la persona de contacto del usuario. Teléfono de contacto el número de teléfono de la persona de contacto. Contacto Dirección de correo electrónico addres correo electrónico de la persona de contacto. Zona Horaria La zona horaria preferida para el usuario
Configuración OpenGTS y Manual de instalación
Página 26 de 62
Página 27 7.3) Creación / Edición de Dispositivos El comando "Dispositivo bin / admin.sh" apoya muchas funciones administrativas que actúan sobre el "dispositivo" SQL mesa. Estas son algunas de las funciones que se pueden realizar con el comando "bin / Dispositivo admin.sh": Creación de un dispositivo: /usr/local/OpenGTS_1.2.3> bin / admin.sh Dispositivo Cuenta = device = create Esto crea el dispositivo especificado con valores por defecto (sustituir "" con el identificador de dispositivo que desea crear). Edición de un dispositivo: /usr/local/OpenGTS_1.2.3> bin / admin.sh Dispositivo Cuenta = device = edit Este comando muestra un editor de campo de usuario de línea de comandos, de forma similar a lo siguiente: (NOTA: La siguiente es sólo un ejemplo Su aplicación contiene definiciones de campo addtional favor.. revisar el archivo "Schema.txt " en el paquete OpenGTS para obtener una lista de las posibles definiciones de campo.) Clave: opendmtp, móvil 0) Descripción: "Nuevo dispositivo" 1) está activa: "true" 2) Las direcciones IP válidas: "" Codificaciones 3) soportados: "7" 4) Contabilidad tiempo de intervalo Minutos: "60" 5) Número máximo de eventos por intervalo: "21" 6) Max Total de conexiones por Intervalo: "10" 7) Max Total de conexiones por minuto: "2" 8) Conexiones Max Dúplex por Intervalo: "6" 9) Conexiones Max dúplex por minuto: "1" Introduzca el número de campo [o 'conservar', 'salida']: Para seleccionar un valor de campo de cambiar, introduzca el número de campo, luego pulsa enter. Después de cambiar el valor del campo, pulsa enter de nuevo. Guarde los cambios por fin entrar en "Guardar". He aquí una descripción detallada de algunos de los campos de dispositivo (consulte "Schema.txt" para una descripción de otra posibles definiciones de campo) : Descripción La descripción del dispositivo (utilizado en los informes, etc). Está activo "true" si este dispositivo se considera todavía en servicio. Si "false", todas las conexiones de este dispositivo serán negado. Las direcciones IP válidas La dirección IP del dispositivo en una conexión entrante se comprueba contra esta especificada bloque de direcciones IP válidas, y se negó si la dirección IP no coincide. Un valor en blanco acepta todo IP entrante direcciones. Codificaciones soportadas Este es un OpenDMTP parámetros del protocolo, y por lo general debe ser siempre "7". Vea el Especificación del protocolo OpenDMTP para más información. Contabilidad tiempo de intervalo Minutos ( OpenDMTP solamente) Este valor se utiliza para evitar que los clientes de fuera de control el consumo excesivo de ancho de banda. El valor aquí especifica el número de minutos durante los cuales los siguientes "Max" se imponen límites de valor. Un valor de "0" desactiva la contabilidad de conexión. Número máximo de eventos por Intervalo ( OpenDMTP solamente) El número máximo de eventos permitidos durante el anterior especifica intervalo. Max Total de conexiones por Intervalo ( OpenDMTP solamente) Este es el número máximo de TCP o UDP conexiones que se permiten durante el intervalo especificado anteriormente.
Página 28 Max Total de conexiones por minuto ( OpenDMTP solamente) Este es el número máximo de TCP o UDP conexiones que se permiten durante un intervalo de 60 segundos. Conexiones Max Dúplex por Intervalo ( OpenDMTP solamente) Este es el número máximo de conexiones TCP que se permite durante el intervalo especificado anteriormente. Conexiones Max dúplex por minuto ( OpenDMTP solamente) Este es el número máximo de conexiones TCP que se les permite durante un intervalo de 60 segundos. Recuperando Dispositivos Eventos a través de la línea de comandos: /usr/local/OpenGTS_1.2.3> bin / admin.sh Dispositivo Cuenta = device = Eventos Este comando devuelve los últimos acontecimientos en formato CSV. Fecha, Hora, Código, Latitud, Longitud, velocidad, rumbo, altitud, dirección 2007/03 / 07,23: 13: 21, InMotion, 29.57241, 142.78869,103.9,178.3,287.0 "," 2007/03 / 07,23: 15: 23, InMotion, 29.57241, 142.78869,103.9,178.3,287.0 "," 2007/03 / 07,23: 17: 23, InMotion, 29.57241, 142.78869,103.9,178.3,287.0 "," 2007/03 / 07,23: 19: 23, InMotion, 29.57241, 142.78869,103.9,178.3,287.0 "," 2007/03 / 07,23: 21: 25, InMotion, 29.57241, 142.78869,103.9,178.3,287.0 "," 2007/03 / 07,23: 23: 27, InMotion, 29.57241, 142.78869,103.9,178.3,287.0 "," Eliminación de eventos "futuro" para un dispositivo determinado: De vez en cuando un dispositivo de rastreo GPS emitirá una fecha GPS / tiempo que está en el futuro, a veces mucho tiempo en el futuro. Para mostrar el número de eventos actuales que están en el futuro más de 5 minutos, introduzca la siguiente comando: ... > bin / admin.sh Dispositivo Cuenta = device = countFutureEvents = 300 Para eliminar estos eventos "futuro": ... > bin / admin.sh Dispositivo Cuenta = device = deleteFutureEvents = 300 Eliminación de eventos "viejos" para un dispositivo determinado: Como eventos se acumulan en la base de datos, puede ser útil en algún momento para recortar eventos antiguos del sistema. La siguiente comando contará el número de eventos antes de hace 90 días: ... > bin / admin.sh Dispositivo Cuenta = device = countOldEvents = 90d Para eliminar estos eventos "viejos": ... > bin / admin.sh Dispositivo Cuenta = device = deleteOldEvents = 90d El valor de argumento para los "countOldEvents" y "deleteOldEvents" se puede especificar el uso de un tiempo relativo, tales como "120d", indicando eventos mayores de hace 120 días, o con una especificación de tiempo específico, como por ejemplo "2010/03 / 12,13: 15: 00, GMT", indicando eventos existentes antes de 12 de marzo 2010 13:15 GMT. ADVERTENCIA: La eliminación de eventos antiguos de la mesa EventData es definitiva. Una vez que se han eliminado los acontecimientos, no se puede recuperar.
Configuración OpenGTS y Manual de instalación
Página 28 de 62
Página 29 7.4) Funciones administrativas de base de datos general El "dbAdmin.pl" comando (sólo está disponible como un script de Perl) puede realizar varias funciones administrativas en el SQL base de datos (Nota: el comando "bin \ dbConfig.bat 'se proporciona para los usuarios de Windows, y realiza un subconjunto de la operaciones disponibles para el comando "dbAdmin.pl"). Estas son algunas de las funciones que se pueden realizar utilizando el Comando "dbAdmin.pl": Verifique columnas de tabla / Actualizar: /usr/local/OpenGTS_1.2.3> bin / dbAdmin.pl mesas Este comando comprobar la configuración de columna de todos OpenGTS tablas e informar sobre las columnas que faltan, u otro https://translate.googleusercontent.com/translate_f
23/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
anomalías. Si un OpenGTS no existe la tabla, se creará. /usr/local/OpenGTS_1.2.3> bin / dbAdmin.pl mesas = c Al actualizar a una versión más reciente de OpenGTS en que las nuevas columnas se han añadido varias tablas, lo anterior comando emitirá la requerida "ALTER TABLE" comandos para las tablas como sea necesario con el fin de agregar cualquier nueva tabla las columnas. Si un "tipo" específica columna ha cambiado, el uso de "mesas = ca" hará que los tipos de las columnas para ser alterados. /usr/local/OpenGTS_1.2.3> bin / dbAdmin.pl mesas = ca O, en Windows: C: \> OpenGTS_1.2.3 mesas bin \ dbConfig.bat: ca Este comando se debe utilizar siempre la actualización a una versión más reciente de OpenGTS . Volcar las tablas en el disco: /usr/local/OpenGTS_1.2.3> bin / dbAdmin.pl dump dir = / tmp / gts Este comando volcará todos OpenGTS tablas en el directorio especificado por el argumento "dir" ("/ tmp / gts" es el destino por defecto si no se especifica la opción "dir"). Si es requerido por la instalación de MySQL, es posible que también tenga que especifique el usuario root de base de datos (es decir., como en "rootUser = "). Mesas individuales pueden, posteriormente, volver a cargar con el " =
opción de carga ". (Nota para los usuarios de Linux: En algunas versiones de Linux que emplean SELinux, puede recibir un error que indica que MySQL no está permitido escribir en el directorio especificado. En estos casos, puede que tenga que especificar un directorio que MySQL está permitido escribir en, o cambiar la configuración de seguridad de SELinux para proporcionar MySQL con autorización para escribir en el directorio "/ tmp".) Tablas de carga de disco: /usr/local/OpenGTS_1.2.3> bin / dbAdmin.pl load =
dir = / tmp / gts Este comando se carga la tabla especificada desde el archivo previamente creado por el argumento "dump". Durante la mesa carga, se corresponden en lo posible columnas. Si una columna está presente en el archivo de 'dumping', pero se ha eliminado en el tabla actual GTS, se generará una advertencia de que la columna se ha caído. Este comando es útil cuando pequeña cambios de la tabla deben ser realizados en la estructura de la columna. [Nota: los corchetes especificados anteriormente indican que la opción dentro de los corchetes es opcional. Los corchetes no deben especificarse literalmente en la línea de comandos si el argumento opcional dentro de los corchetes se utiliza].
Configuración OpenGTS y Manual de instalación
Página 29 de 62
Página 30
8) Instalación / Puesta en marcha del OpenDMTP, TK10x y módulos DCS Aspicore En esta sección se describe cómo iniciar y detener el "gtsdmtp", "tk10x", y el servidor de comunicación del dispositivo "Aspicore" Módulos (DCS), sin embargo estas instrucciones también son aplicables a otros servidores de comunicaciones de dispositivos que pueden también ser instalado o puesto en práctica. Más información sobre la OpenDMTP proyecto se puede encontrar en el vínculo " http://www.opendmtp.org ". Apoyo para OpenDMTP dispositivos compatibles se incluyen en OpenGTS con el servidor de comunicación del dispositivo "gtsdmtp" (DCS). El módulo DCS "tk10x" es compatible con dispositivos compatibles TK102 / TK103 protocolo más común (Nota: algunos fabricantes producción de un dispositivo TK102 / TK103 puede ser el uso de su propia variante protocolo personalizado que no es compatible con el TK102 común / protocolo TK103). Aspicore ofrece software del teléfono del cliente para el seguimiento de los diferentes teléfonos Nokia, Samsung y Sony Ericsson. La Aspicore DCS dentro del paquete OpenGTS está diseñado para trabajar con el TCP o UDP método de transporte de datos que puede configurarse dentro de la aplicación de teléfono del cliente Aspicore. Para obtener más información sobre sus teléfonos compatibles, y para obtener su software cliente, vistit su sitio web en " http://www.aspicore.com/en/tuotteet_tracker.asp?tab=2&sub=1 ". 8.1) Configuración del archivo "dcservers.xml" El archivo "dcservers.xml" contiene algunas propiedades configurables que afectan a la ejecución de la OpenDMTP ("Gtsdmtp") y Aspicore ("") Aspicore servidores. La mayoría de los valores de las propiedades se debe dejar como su valor por defecto, pero los valores siguientes propiedades se pueden ajustar a las propias de su entorno operativo: OpenDMTP : • tcpport = "31000" • UDPport = "31000" https://translate.googleusercontent.com/translate_f
24/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
TK10X : • tcpport = "31272" • UDPport = "31272" Aspicore : • tcpport = "31265" • UDPport = "31265" Estos puertos se especifican en la etiqueta "ListenPorts" para su respectiva "DCServer", y son los puertos predeterminados en que estos servidores escuchan para las conexiones entrantes de los dispositivos remotos. Puede cambiar este puerto al cambiar la valor en este atributo de etiqueta. También puede indicar varios puertos especificando con separadores de coma. (Es decir. 'Tcpport = "31000,31100"'). 8.2) Inicio del servidor de comunicación de dispositivos El "gtsdmtp", "tk10x", o servidor "Aspicore" se puede iniciar la siguiente manera: / Zzz> cd $ GTS_HOME /usr/local/OpenGTS_1.2.3> bin / runserver.sh s servidor Donde " servidor "debe sustituirse por el nombre específico del servidor para empezar (es decir." gtsdmtp "," tk10x ", o "Aspicore").
Configuración OpenGTS y Manual de instalación
Página 30 de 62
Página 31 8.2a) Nota importante con respecto a ".sh" y ".bat" archivos de comandos: Los comandos que terminan en ".sh" o ".bat" DEBEN ser ejecutados desde el OpenGTS directorio de instalación. El intento de ejecutar estos comandos desde otro directorio puede resultar en una "ClassNotFoundException" o Error "NoClassDefFoundError", o similar. (Esto significa que usted debe cd $ GTS_HOME , a continuación, ejecutar el comando como " ") O bien, la versión de Perl de este comando se puede utilizar sin necesidad de estar en el OpenGTS directorio de instalación: / Zzz> $ GTS_HOME / bin / runserver.pl s servidor En Windows, el comando se puede omitir los "s" y puede ser introducida de la siguiente manera: C: \> cd \ OpenGTS_1.2.3 C: \ OpenGTS_1.2.3 \> \ bin \ runserver.bat servidor El servidor inicializar y empezar a escuchar en el puerto (s) especificado por el "ListenPorts" etiqueta en el "dcservers.xml" presentar para la específica denominada DCServer. Para cambiar el puerto en la línea de comandos escucha, se puede añadir un argumento "port" como sigue: / Zzz> $ GTS_HOME / bin / runserver.pl s servidor port 31123 O en Windows: C: \ OpenGTS_1.2.3 \> \ bin \ runserver.bat servidor port: 31123 Para establecer escuchando en el puerto "31123". También puede agregar la línea de comandos opción "debugMode" para habilitar el registro de nivel de depuración. Mientras se ejecuta en modo de "fondo", los registros de salida se guardan en el archivo "$ GTS_HOME / logs / servidor.log ". (El archivo "servidor.out "también se creó por" runserver.pl "para capturar la salida a stdout / stderr, pero lo hará normalmente permanecerá vacío). Cuando se prueba / depuración, también puede iniciar un servidor "interactiva". Es decir, el servidor se ejecuta en el primer plano (es decir. No 'Segundo plano'), y todas las salidas de registro se envía a la consola en lugar del archivo de registro. Para iniciar un servidor "interactiva", agrega la opción "i" para la línea de comandos, de la siguiente manera: / Zzz> $ GTS_HOME / bin / runserver.pl s servidor i (Para detener el servidor en este modo, sólo tiene que pulsar 'ControlC') 8.3) Detener el servidor de comunicaciones de dispositivos Cuando se inicia en modo de "fondo" (es decir. Sin la opción "i"), se crea un archivo "Identificación de Procesos" (PID) en "$ GTS_HOME / logs / servidor.pid ", que contiene el proceso de identificación de la tarea en segundo plano. Este archivo se utiliza para detener la https://translate.googleusercontent.com/translate_f
25/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
servidor con el comando: / Zzz> $ GTS_HOME / bin / runserver.pl s servidor kill Donde " servidor "debe sustituirse por el nombre específico del servidor para empezar (es decir." gtsdmtp "," tk10x ", o "Aspicore").
Configuración OpenGTS y Manual de instalación
Página 31 de 62
Página 32 En los sistemas Linux, el comando Perl "psjava ", Incluido con OpenGTS , se puede utilizar para mostrar información sobre qué servidores de comunicación de dispositivos Actualmente runningr: / Zzz> $ GTS_HOME / bin / psjava PID Padres L Usuario clase Java / jar 215 (1) 1 OpenGTS org.apache.catalina.startup.Bootstrap 8115 (1) 1 OpenGTS /usr/local/OpenGTS_1.2.3/build/lib/gtsdmtp.jar 8120 (1) 1 OpenGTS /usr/local/OpenGTS_1.2.3/build/lib/tk10x.jar 8123 (1) 1 OpenGTS /usr/local/OpenGTS_1.2.3/build/lib/aspicore.jar 8129 (1) 1 OpenGTS /usr/local/OpenGTS_1.2.3/build/lib/template.jar Este comando enumera todos los conocidos procesos en ejecución de Java, con su PID asociado (procesoid), padre PID, usuario y Clase Java o un archivo jar que se está ejecutando actualmente. El " "Proceso indica org.apache.catalina.startup.Bootstrap Apache Tomcat que se está ejecutando con el PID indicada. " gtsdmtp "," tk10x "," Aspicore ", y" plantilla "Indicar su respectivos servidores de comunicación del dispositivo en funcionamiento. 8.4) Adición de un nuevo registro de dispositivos Una vez que el servidor de comunicaciones dispositivo adecuado (DCS) está en ejecución, inicie sesión en una cuenta que desea tener la propia dispositivo / teléfono que será el seguimiento y agregar un nuevo registro de dispositivos / vehículo en la página "Admin dispositivos". OpenDMTP: Dispositivos OpenDMTP suelen utilizar la "cuenta" real y de "dispositivo" de identificación. En este caso, asegúrese de que la cuenta y el dispositivo Identificación del programado en el dispositivo compatible con OpenDMTP coincide con la misma cuenta y dispositivo de Identificación creado dentro de la Sistema OpenGTS. TK10x: Dispositivos TK102 / TK103 normalmente reportan su información de identificación única mediante el número IMEI del módem. En el " Dispositivo de administración "de la página, configurar el" Steam ID campo "al valor de IMEI en el formato [ tk_12345679012345 ], donde " 123456789012345 "es el número IMEI del teléfono (El" tk_ prefijo "se utiliza para ayudar a identificar el tipo de dispositivo servidor de comunicaciones utilizado para analizar los datos en este caso TK102 / TK103). Aspicore : El software de cliente Aspicore informa de la información de identificación única utilizando el número IMEI del teléfono. En el " Dispositivo de administración "de la página, configurar el" Steam ID campo "al valor de IMEI en el formato [ s60_12345679012345 ], donde " 123456789012345 "es el número IMEI del teléfono (El" s60_ prefijo "se utiliza para ayudar a identificar el tipo de dispositivo servidor de comunicaciones utilizado para analizar los datos en este caso Aspicore).
Configuración OpenGTS y Manual de instalación https://translate.googleusercontent.com/translate_f
Página 32 de 62 26/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
Página 33
9) Creación de su propio servidor de comunicación de dispositivos Para que OpenGTS para recibir datos de un dispositivo, un personalizado "Comunicación Device Server" tendrá que ser implementado que entiende el protocolo utilizado para comunicarse con el dispositivo remoto, y el inserto recibió eventos en la base de datos SQL. En esta sección se ofrece una breve descripción del ejemplo servidores 'plantilla' provisto OpenGTS para la implementación de su propio servidor de comunicaciones dispositivo remoto. El método utilizado por dispositivos remotos para el transporte de eventos al servidor varía en gran medida con el fabricante del dispositivo. Algunos datos de transporte a un servidor a través de mensajes SMS, algunos usan un transporte de correo electrónico SMTP para enviar datos a un servidor, algunos utilizar un protocolo basado en HTTP que codifican los datos en la solicitud al servidor, y muchos utilizan alguna forma de primasocket comunicación basada en (a través de TCP / UDP) para conectarse a un oyente en el servidor para transmitir datos. Con el fin de crear un dispositivo servidor de comunicaciones que es capaz de analizar los datos de entrada de un dispositivo, una comprensión íntima de las características específicas de Se requiere el protocolo utilizado por el fabricante del dispositivo. OpenGTS incluye ejemplos para servidores basados en HTTP, y los servidores basados en bruto sockets (soporte TCP y UDP), sin embargo, ya que cada fabricante del dispositivo tiene normalmente su propio protocolo y modo de transporte de datos, estos servidores ejemplo, no se puede suponer que solo el trabajo con cualquier / todos dispositivo. Dependiendo del dispositivo particular elegido, puede haber una cantidad significativa y sustancial de trabajo necesario para apoyar el dispositivo de hardware elegido. El primero, y más importante, el paso al comenzar a implementar un servidor de comunicaciones de dispositivo para un hardware elegido dispositivo es obtener y entender completamente la documentación del protocolo del fabricante del dispositivo. Mientras http comunicación basada a menudo puede ser ingeniería inversa de la observación de los datos que llegan al servidor, el intento de ingeniería inversa de un protocolo basado en bruto sockets puede resultar extremadamente difícil, si no imposible, sin protocolo adecuado documentación. 9.a) Nota importante con respecto a la IMPLEMENTACIÓN de un servidor de comunicaciones del dispositivo: La implementación de un servidor de comunicaciones de dispositivo para un dispositivo dado puede tomar una cantidad significativa y sustancial de trabajo de programación para llevar a cabo, dependiendo del protocolo de dispositivo. Para implementar un servidor, es probable que necesita una comprensión en profundidad de la comunicación basada en TCP / UDP, y una buena comprensión de Java técnicas de programación, incluida la comunicación zócalo, multithreading y manipulación posiblemente bit a bit técnicas para la extracción de los campos de bits de datos binarios (incluyendo saber si el dispositivo de seguimiento envía datos en formatos grandes endian o littleendian). Si se utiliza un protocolo basado en HTTP, es posible que tenga una comprensión de cómo los servlets se construyen, y cómo funcionan dentro de un contenedor de servlets, como Apache Tomcat.
Configuración OpenGTS y Manual de instalación
Página 33 de 62
Página 34 9.1) Servidores de Comunicación dispositivo basado en HTTP (utilizando el servlet "GPRMC") [Habilidades necesarias: Java, servlets, protocolos basados en HTTP] La comunicación basada en HTTP es típicamente el más fácil de implementar. Si su dispositivo de rastreo remoto envía mensajes a la servidor usando un protocolo de comunicación HTTPbase, entonces el servidor de ejemplo 'GPRMC' puede ser modificado para analizar recibido datos e insertarlo en la base de datos SQL. Las fuentes para el servidor 'GPRMC' (el nombre de la cifra récord de $ GPRMC en el protocolo NMEA0183) se puede encontrar en el OpenGTS directorio de origen "src / org / OpenGTS / guerra / GPRMC" y corre como un servlet en un contenedor de servlets como Apache Tomcat (y usa los mismos puertos de acceso configuradas para https://translate.googleusercontent.com/translate_f
27/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
Tomcat). 9.1.1) Configuración del servlet "GPRMC" : Este módulo ha incorporado muchas opciones configurables y sólo puede tener propiedades especiales de personalización que pueden ser especificado en el archivo "webapp.conf". La siguiente es una lista de propiedades configurables disponibles para el "GPRMC" http basado servidor de comunicaciones del dispositivo: Formato de datos / valor Claves de la propiedad: gprmc.logName Registro de nombre de salida. Valor por defecto: GPRMC gprmc.uniquePrefix Prefijo UniqueID, utiliza cuando las operaciones de búsqueda Dispositivo. Valores predeterminados de valor: (igual que " gprmc.logName "valor de la propiedad) gprmc.defaultAccountID ID de la cuenta por defecto. Valor por defecto: GPRMC gprmc.minimumSpeedKPH Velocidad mínima aceptable (acelera menos de este valor se establece en '0') Valor por defecto: 0.0 gprmc.estimateOdometer De ser cierto, se calculará un odómetro GPS basado. Valor por defecto: falso gprmc.simulateGeozones Si es verdad, una llegada Geozona / salidas será detectado y se creará los eventos adicionales oportunas. Valor por defecto: falso gprmc.dateFormat Formato de fecha para el parámetro 'fecha'. Valores válidos: NINGUNO , EPOCH , AMD , DMY , MDY Valor por defecto: AMD gprmc.response.ok Respuesta volvió al dispositivo en la recepción de datos con éxito. Valor por defecto: (nada volvió) gprmc.response.error Respuesta de regresó a dispositivo en el éxito (de error) la recepción de datos. Valor por defecto: (nada volvió)
Configuración OpenGTS y Manual de instalación
Página 34 de 62
Página 35 URL de parámetros Teclas de la propiedad: gprmc.parm.unique URL de parámetros clave: UniqueID Valor por defecto: Identificación gprmc.parm.account URL de parámetros clave: CuentaID Valor por defecto: ctas gprmc.parm.device URL de parámetros clave: DispositivoID dev Valor por defecto: gprmc.parm.auth URL de parámetros clave: Aut / contraseña (no se utiliza) Valor por defecto: (en blanco) gprmc.parm.status URL de parámetros clave: StatusCode Valor por defecto: código gprmc.parm.gprmc URL de parámetros clave: GPRMC (Se espera que el NMEA0183 récord de GPRMC para este valor de este parámetro) Valor por defecto: GPRMC gprmc.parm.date URL de parámetros clave: Fecha (ignora si ' gprmc.parm.gprmc se especifica ') Valor por defecto: fecha gprmc.parm.time https://translate.googleusercontent.com/translate_f
28/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
URL de parámetros clave: Tiempo (ignorado si " gprmc.parm.gprmc se especifica ') Valor por defecto: el tiempo gprmc.parm.latitude URL de parámetros clave: Latitud (ignora si ' gprmc.parm.gprmc se especifica ') Valor por defecto: lat gprmc.parm.longitude URL de parámetros clave: Longitud (ignora si ' gprmc.parm.gprmc se especifica ') Valor por defecto: lon gprmc.parm.speed URL de parámetros clave: clave de parámetros de velocidad (kph) (ignora si ' gprmc.parm.gprmc se especifica ') Valor por defecto: velocidad gprmc.parm.heading URL de parámetros clave: Titulo (grados) (ignora si ' gprmc.parm.gprmc se especifica ') Valor por defecto: la cabeza gprmc.parm.altitude URL de parámetros clave: Altitud (metros) Valor por defecto: alt gprmc.parm.odometer URL de parámetros clave: cuentakilómetros (kilómetros) Valor por defecto: odom gprmc.parm.address URL de parámetros clave: Dirección geocodificadasInvertir Valor por defecto: dir gprmc.parm.driver URL de parámetros clave: Driver ID Valor por defecto: drv gprmc.parm.message URL de parámetros clave: Mensaje Valor por defecto: msg
Configuración OpenGTS y Manual de instalación
Página 35 de 62
Página 36 9.1.2) Incumplimiento "GPRMC" Configuración : El cofiguration defecto "GPRMC" (sin cambios de configuración especiales realizados en el archivo "webapp.conf") espera un httpbasa URL siguiente formato: (la URL a continuación muestra los diferentes campos en líneas separadas, pero se envía normalmente al servidor como una única URL todo en una sola línea): http://example.com:8080/gprmc/Data? id = 123456789012345 y code = 0xF020 y GPRMC = $ GPRMC, 080.701,00, A, 3128,7540, N, 14257.6714, W, 000.0,000.0,180707 ,,, A * 1C Donde http://example.com:8080/gprmc/Data? Representa el anfitrión: ("? / GPRMC / Data") puerto ("example.com:8080") y "gprmc.war" ubicación servlet 123456789012345 Representa el ID de móvil único del dispositivo (tal como el IMEI #). (Este valor debe introducirse en el "Administrador de dispositivos" Página de campo "Steam ID" en el formato "gprmc_123456789012345").
0xF020 Representa el código de estado se utiliza para identificar el motivo del evento. El código de estado se utiliza aquí debe coincidir con el maleficio, o valor decimal de un código de estado que aparece en la sección "Códigos de estado y descripciones" manual en la siguiente ubicación: http://www.geotelematic.com/docs/StatusCodes.pdf Además de uno de los códigos de estado anteriores hexagonales / decimales, cualquiera de los siguientes nombres en clave de texto también se puede usar, lo cual lo h automáticamente se convertirán en Es correspondiente código de estado basado en hexagonal cuando se introduce en la tabla EventData: GPS, PÁNICO, Waymark, etc, (ver fuente GPRMC módulo "Data.java" para obtener una lista actual). $ GPRMC, 080.701,00, A, 3128,7540, N, 14257.6714, W, 000.0,000.0,180707 ,,, A * 1C Representa el NMEA0183 $ GPRMC cosas claras desde el receptor GPS. 9.1.3) La construcción del servlet "GPRMC" : El archivo "gprmc.war" se construye automáticamente por los OpenGTS "hormiga todo" de comandos, pero también puede ser construido específicamente con el siguiente comando: GPRMC hormiga Después de hacer los cambios de configuración en las propiedades anteriores, el archivo "gprmc.war" debe ser reconstruido y reubicó en Para que los cambios de configuración surtan efecto. Si necesita realizar cambios en este módulo de fuente para apoyar el dispositivo, se recomienda que copie la fuente archivos a un directorio nuevo (recuerde que cambiar el nombre del paquete de Java, y también copiar / modificar la información "web.xml" https://translate.googleusercontent.com/translate_f
29/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
encontrar en la "guerra / GPRMC / WEBINF / web.xml"), a continuación, modificar las fuentes copiadas con los cambios específicos requeridos por su dispositivo rastreador. Necesitará Este módulo para ser configurado e instalado en un contenedor de servlets, similar al proceso de instalación se utiliza para otros servlets en esta documentación. Consulte el código fuente del servidor 'GPRMC' directamente para obtener información adicional. (El código fuente de este módulo se pueden encontrar en el directorio "src / org / OpenGTS / guerra / GPRMC /").
Configuración OpenGTS y Manual de instalación
Página 36 de 62
Página 37 9.2) Raw Socket Server Based Comunicación Dispositivo [Habilidades necesarias: Java, la comunicación TCP / UDP socket, multithreading, manipulación bit a bit, cliente generales / servidor protocolos] Si su dispositivo de rastreo remoto envía mensajes al servidor mediante un protocolo de comunicación basado en la toma de corriente, entonces el ejemplo servidor 'plantilla' se puede modificar para analizar los datos recibidos y la inserta en la base de datos SQL. Las fuentes para el servidor 'plantilla' se puede encontrar en el OpenGTS directorio de origen "src / org / OpenGTS / servidores / plantilla". Este tipo de servidor se ejecuta como un proceso independiente que escucha en un puerto de socket seleccionado para las conexiones TCP / UDP entrantes. Es probable que tenga que hacer algunos cambios significativos en el código fuente para apoyar a su dispositivo en particular. Es recomienda que copie los archivos de origen a un directorio nuevo (recuerde que debe cambiar el nombre del paquete Java), a continuación, modificar las fuentes copiadas con los cambios específicos requeridos por el dispositivo de seguimiento. Éstos son algunos de los principales atributos del protocolo que deben determinarse antes de comenzar a implementar una red TCP / UDP socket basado servidor de comunicaciones del dispositivo: • Son los paquetes de protocolo transmitidas en ASCII, binario, o ambos? • ¿Cómo es la longitud real de un paquete de cliente determinado (esto es extremadamente importante)? • ¿Cuáles son los diversos tipos y el contenido de los paquetes recibidos desde el cliente? • Para los paquetes binarios, son campos enteros codificados en formato bigendian o littleendian? • ¿Qué paquetes de respuesta, si la hay, es el cliente espera recibir del servidor? Servidor El ejemplo 'plantilla' contiene los siguientes módulos de fuente: Constants.java Este módulo constains mayoría de las opciones configurables personalizados utilizados para apoyar su protocolo de dispositivo remoto específico. Tales como los tiempos de espera, longitudes mínima y / o máxima de paquetes, ASCII / codificación binaria, etc. La información básica sobre el tipo de protocolo se debe establecer en este módulo. Main.java Este es el principal punto de entrada para el servidor y probablemente no tendrá que ser modificado. TrackClientPacketHandler.java El objetivo de este módulo es comprende las características específicas del protocolo de comunicación para el dispositivo remoto, y requerirá la mayor parte de la personalización significativa necesaria para apoyar el dispositivo remoto. Aquí es donde se identifican los paquetes de clientes entrantes, los datos se analiza y insertan en las tablas, y las respuestas requeridas se devuelven al dispositivo cliente. TrackServer.java Esta es una envoltura / controlador para un / sesión UDP TCP y los delegados más control a la Clase TrackClientPacketHandler. Este entorno de servidor / marco maneja la escucha de conexiones entrantes y multithreading para usted (este servidor puede manejar múltiples conexiones simultáneas entrantes), así como la mayoría manejo de errores. Cuando se utiliza el ejemplo de servidor "plantilla" como base para su propio servidor de comunicación del dispositivo, se recomienda que copie los archivos de 'plantilla' en una carpeta nueva (y por tanto un nuevo paquete de Java) el nombre de su elegido dispositivo de localización / telemática (es decir., tales como "acme1000"). El archivo "build.xml" también debe ser modificado para incluir un "objetivo" para el nombre del servidor elegido. Para construir el ejemplo del servidor 'plantilla', el objetivo de la hormiga 'plantilla' se puede utilizar como de la siguiente manera: > Plantilla de la hormiga Este objetivo 'plantilla' en 'build.xml' se puede copiar para crear su propio objetivo específico acumulación de hormigas para su dispositivo elegido Nombre del servidor de comunicaciones. Consulte el código fuente del servidor 'plantilla' directamente para obtener información adicional de personalización. El "icare" servidor también está disponible (en el directorio de origen "src / org / OpenGTS / servidores / Icare /"), que apoya el dispositivo ICare G3300. Este módulo de servidor de comunicaciones dispositivo también puede ser examinado en busca de ayuda en la creación de su propio personalizado servidor de comunicaciones del dispositivo.
Página 38 9.2.1) Inicio del servidor de comunicación de dispositivos Una vez que su archivo jar servidor se ha creado, puede utilizar el comando "bin / runserver.sh" (o " runserver.bat Windows) para iniciar el servidor de comunicación del dispositivo de la siguiente manera:
"En la
/ Zzz> cd $ GTS_HOME /usr/local/OpenGTS_1.2.3> bin / plantilla runserver.sh s 9.2.1.a) Nota importante con respecto a ".sh" y ".bat" archivos de comandos: Los comandos que terminan en ".sh" o ".bat" DEBEN ser ejecutados desde el OpenGTS directorio de instalación. Intentando para ejecutar estos comandos desde otro directorio puede resultar en un "ClassNotFoundException" o Error "NoClassDefFoundError", o similar. (Esto significa que usted debe cd $ GTS_HOME , a continuación, ejecutar el comando como " ") O bien, la versión de Perl de este comando se puede utilizar sin necesidad de estar en el OpenGTS directorio de instalación: / Zzz> $ GTS_HOME / bin / runserver.pl s plantilla En Windows, el comando se puede omitir los "s" y puede ser introducida de la siguiente manera: C: \> cd \ OpenGTS_1.2.3 C: \ OpenGTS_1.2.3 \> \ bin \ template runserver.bat El servidor inicializar y empezar a escuchar en el puerto (s) especificado en el archivo "dcservers.xml" para la "plantilla" servidor. El puerto predeterminado es 31200. Para cambiar el puerto de escucha en la línea de comandos, un " port "Puede ser añadido como sigue: / Zzz> $ GTS_HOME / bin / runserver.pl s plantilla port 31123 O, en Windows: C: \ OpenGTS_1.2.3 \> \ bin \ template runserver.bat port: 31123 Para establecer escuchando en el puerto "31123" (por ejemplo). También puede agregar la línea de comandos opción "debugMode" para habilitar el registro de nivel de depuración. Mientras se ejecuta en modo de "fondo", los registros de salida se guardan en el archivo "$ GTS_HOME / logs / template.log". (El archivo "template.out" también se crea en este directorio para detectar cualquier / mensajes stderr stdout que se muestran dentro de la servidor que no utilizan la función de registro 'Imprimir' integrado en OpenGTS. Normalmente, este archivo debe alway estar vacío). Cuando se prueba / depuración, también puede iniciar un servidor "interactiva". Es decir, el servidor se ejecuta en el primer plano (es decir. No 'Segundo plano'), y todas las salidas de registro se envía a la consola en lugar del archivo de registro. Para iniciar un servidor "interactiva", agrega la opción "i" para la línea de comandos, de la siguiente manera: / Zzz> $ GTS_HOME / bin / runserver.pl s plantilla i (Para detener el servidor en este modo, sólo tiene que pulsar 'ControlC')
Configuración OpenGTS y Manual de instalación
Página 38 de 62
Página 39 9.2.2) Detener el servidor de comunicaciones de dispositivos Cuando se inicia en modo de "fondo" (es decir. Sin la opción "i"), se crea un archivo "Identificación de Procesos" (PID) en "$ GTS_HOME / logs / template.pid", que contiene el proceso de identificación de la tarea en segundo plano. Este archivo se utiliza para detener el servidor con el comando: https://translate.googleusercontent.com/translate_f
31/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
/ Zzz> $ GTS_HOME / bin / runserver.pl s plantilla kill En los sistemas Linux, el comando Perl "psjava ", Incluido con OpenGTS , se puede utilizar para mostrar información sobre que los servidores de comunicación de dispositivos se están ejecutando actualmente, incluyendo el " plantilla "Servidor: / Zzz> $ GTS_HOME / bin / psjava PID Padres L Usuario clase Java / jar 215 (1) 1 OpenGTS org.apache.catalina.startup.Bootstrap 8115 (1) 1 OpenGTS /usr/local/OpenGTS_1.2.3/build/lib/gtsdmtp.jar 8129 (1) 1 OpenGTS /usr/local/OpenGTS_1.2.3/build/lib/template.jar Este comando enumera todos los conocidos procesos en ejecución de Java, con su PID asociado (procesoid), padre PID, usuario y Clase Java o un archivo jar que se está ejecutando actualmente. El " "Proceso indica org.apache.catalina.startup.Bootstrap Apache Tomcat que se está ejecutando con el PID indicada. " gtsdmtp "Y" plantilla "Indicar su respectivo funcionamiento Servidores de comunicaciones del dispositivo. 9.3) Archivo de configuración XML en tiempo de ejecución. Los servidores de primas a base de enchufe de comunicación del dispositivo (como el ejemplo de servidor 'plantilla') apoyar el tiempo de ejecución configuración mediante el archivo "dcservers.xml". Un formato de ejemplo de la "dcservers.xml" es la siguiente: ... DCServer> ... DCServerConfig> Los atributos para la etiqueta DCServerConfig incluyen los siguientes: : Este atributo especifica la dirección IP o nombre de host local a la que se unirá el servidor. Esto es BindAddress útil cuando el servidor local tiene más de una dirección IP, y necesita enviar paquetes UDP de nuevo a un cliente dispositivo. Si se deja en blanco, el servidor se unirá a la dirección IP local predeterminada. La longitud de la cola máxima para las indicaciones de conexión entrantes (una solicitud para conectarse). Si una atrasos indicación de conexión llega cuando la cola está llena, se rechaza la conexión. Si se deja en blanco, o es 0 o menos, entonces el se utilizará el valor por defecto atraso. Vea la "java.net.ServerSocket" clase para más información. : Este valor se añade a cualquier especificación puerto. A menos que sea necesario de otro modo para el sistema específico PortOffset requisitos, este valor debe permanecer en "0". : Si la etiqueta "DCServerConfig" contiene ningún "Incluir" subetiquetas, este es el directorio que será includedir buscar los archivos incluidos. Configuración OpenGTS y Manual de instalación
Página 39 de 62
Página 40
Un ejemplo "Incluir" formato de etiqueta es la siguiente: Los atributos para la etiqueta Incluya incluyen los siguientes: : Este atributo especifica el nombre del archivo a incluir. El archivo incluye también debe ser una adecuada expediente formato de archivo XML DCServerConfig. Todos los servidores de comunicaciones de dispositivo definidos dentro de este incluyeron archivo (como se define por las etiquetas "DCServer") se añadirá a los servidores de comunicaciones de dispositivo definidos en otras partes en este archivo XML. Recursiva Incluir directivas no están permitidos. : Este atributo especifica si la incluyen se requiere archivo de existir. Si este valor es "verdadero" y el opcional incluir archivo no existe, y se mostrará el error. Si este valor es "falso" y el archivo de inclusión no existe, a continuación, el directorio de inclusión se ignora en silencio. Un ejemplo formato de etiqueta "DCServer" es la siguiente:
32/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
Servidor Ejemplo Plantilla ]]> Description> UniqueIDPrefix> 4.0 propiedad> true propiedad> true propiedad> Properties> DCServer> El atributo de la etiqueta DCServer son los siguientes: nombre : Este atributo es obligatorio y especifica el nombre del servidor de comunicaciones del dispositivo. La especificada nombre debe ser único entre todos los servidores de comunicaciones de dispositivos cargados. Si el nombre de un dispositivo de comunicación se encuentra el servidor que ya se ha definido, la entrada DCServer llamado posterior será ignorado. "Descripción" subetiqueta: Esta etiqueta especifica la descripción opcional del servidor de comunicaciones del dispositivo. "UniqueIDPrefix" subetiqueta: Esta etiqueta especifica los prefijos opcionales "UniqueID" que se utilizarán cuando se esté buscando el dispositivo móvilid en el Tabla de dispositivos. En el orden especificado, el prefijo especificado se antepondrá al móvilid entonces el ID resultante es arriba mirado en el campo de la tabla de dispositivos "IDunico". Si no lo encuentra, entonces se usará la siguiente prefijo. El prefijo especificación "*" significa que el móvilid será utilizado tal cual (sin prefijo antepuesto).
Configuración OpenGTS y Manual de instalación
Página 40 de 62
Página 41 "ListenPorts" subetiqueta: Esta etiqueta especifica los puertos en los que el servidor de comunicaciones dispositivo escuchará las conexiones entrantes desde dispositivos remotos. El "tcpport" atributo especifica el puerto en el que se pondrá en marcha un oyente TCP. El atributo "UDPport" especifica el puerto en el que se pondrá en marcha un oyente UDP. Si bien "tcpport" o "UDPport" es blanco, o no se especifica, no se iniciará el correspondiente "oyente". "Propiedades" subetiqueta: Esta etiqueta incluye "propiedad" subetiquetas que especifican las propiedades de ejecución que pueden ser utilizados para especificar aún más la comportamiento del servidor de comunicación del dispositivo en tiempo de ejecución. Las propiedades estándar que la mayoría de comunicación del dispositivo servidor reconocer son los siguientes: : (Doble) Esta propiedad especifica la velocidad mínima aceptable basado en GPS. Una velocidad minimumSpeedKPH valor beow el valor especificado por esta propiedad será considerada una velocidad de '0'. Esto se utiliza para mitigar GPS valores de velocidad que puede indicar movimiento, incluso cuando el receptor GPS es estacionario. : (Booleano) Esta propiedad especifica si un valor del odómetro basado en GPS debe ser estimateOdometer calculado automáticamente de las ubicaciones GPS válidos reportados por el evento entrante. El valor del odómetro evento actual se calcula mediante la determinación de la distancia desde la ubicación del evento anterior al evento actual ubicación, a continuación, añadir esta distancia a la lectura del cuentakilómetros anterior. : (Booleano) Esta propiedad especifica si los eventos entrantes deben ser revisadas para simulateGeozones Geozona llegar / salir ocurrencias. Si se ha encontrado el evento actual llega a tener, o haber salido, desde una Geozona (como aparece en la tabla Geozona), entonces el evento apropiado, con el código de estado llegar / salir, será generado e insertado en la tabla EventData. Servidores específicos de comunicación dispositivo también pueden apoyar a otras especificaciones de propiedad.
10) Internacionalización / Localización El OpenGTS código fuente es i18n ("internacionalización") compatible, que significa que puede adaptarse a los diversos lanugages sin requerir ningún cambio de código (es decir. no fija el texto codificado que no se puede cambiar en el tiempo de la pantalla). Localización ("L10n") es el proceso de aplicación de un texto específico de idioma para una configuración regional determinada. 10.1) El apoyo a una nueva lengua Todo el texto Inglés, que es visualizable en el OpenGTS interfaz web se puede encontrar en los archivos de propiedades de recursos llamados "LocalStrings_en.properties" que se encuentra dentro de los diferentes directorios de archivos fuente. Estos archivos contienen una lista de la Inglés texto predeterminado que se mostrará si no hay configuración regional específica ha sido elegido. El formato de este archivo es "TextKey = valor", donde el "textKey" es un identificador único para el texto "valor" específico. 10.1.a) Descargue los archivos más recientes de configuración regional para la siguiente distribución: Puede descargar un archivo zip que contiene los "LocalStrings_xx.properties" Archivos para la próxima versión de OpenGTS en la siguiente URL: http://www.geotelematic.com/download.html#LocalStrings Para apoyar un nuevo idioma / locale, buscar cada ocurrencia de los archivos "LocalStrings_en.properties" y crear una copia llamada "LocalStrings_ XX .properties "en el mismo directorio, donde" XX "en este caso es la ISO639 2 letras código de idioma. Luego, en el nuevo archivo, retire la prefijación "#" carácter de comentario en cada línea clave = valor, y modificar el valor de texto para que coincida con la sintaxis de un lenguaje específico y significado. Asegúrese de dejar la llave de texto tal cual. La contenido de las "LocalStrings_ XX .properties "archivos deben ser escritos usando solamente ISO88591 caracteres codificado (Por "java.util.Properties" y restricciones "java.util.ResourceBundle"). Los caracteres que no pueden ser directamente representados en ISO88591 se pueden incluir el uso de Unicode escapa especificando el formato '\ u XXXX ', donde " XXXX "es la representación hexadecimal del carácter Unicode. La instalación de Java JDK incluye la herramienta 'native2ascii' para ayudar con la conversión de texto Unicode a Unicode escapó texto. Si un archivo "LocalStrings_XX.properties" no contiene adecuado Unicode codificación (es decir. un inválido "\ u XXXX " especificación), y luego de Java puede ser incapaz de cargar el archivo de propiedades, y el archivo LocalStrings específico no puede ser utilizado. Para comprobar que no hay "\ u no válidos XXXX "especificaciones están presentes, el siguiente comando CheckInstall validará la "LocalStrings_ XX .properties "archivos: / Zzz> $ GTS_HOME / bin / checkInstall.sh localStrings = $ GTS_HOME / src Este comando buscará todos "LocalStrings_ XX .properties "archivos de la" "Directorio y $ GTS_HOME / src examinar su contenido para no válidos "\ u XXXX "especificaciones. Si cualquier archivo LocalStrings contiene no válido "\ u XXXX " especificaciones, el mensaje de error "formato incorrecto \ codificación uxxxx" será visto por el archivo particular. Este comando También se comprueba que sólo ISO88591 caracteres se utilizan en los archivos LocalStrings. La configuración regional de idioma específico que aparece en la interfaz web se controla mediante el atributo "locale" en la etiqueta "Dominio" en el archivo "private.xml". Después de hacer los cambios en el archivo "private.xml", o cualquiera de los archivos "LocalStrings_XX.properties", que Seguro que reconstruir y volver a implementar el archivo "track.war". 10,2) Cambio del idioma visualizado Configuración del idioma visualizado se puede configurar en el archivo 'private.xml'. En la etiqueta de "Dominio", cambie el "locale" https://translate.googleusercontent.com/translate_f
34/51
18/6/2015
Manual de Instalación y OpenGTS Configuracion
para el código de país de 2 letras deseado. Por ejemplo, para cambiar el idioma a alemán, establecer el "locale" Dominio atribuir a 'locale = "de"'. También puede agregar un menú de selección de idioma desplegable a la página de inicio de sesión mediante el establecimiento de la Propiedad "accountLogin.showLocaleSelection" a "true". Las selecciones de idioma se especifican en el Etiqueta "SupportedLocales". (Reconstruir / redistribuir el archivo 'track.war' después de hacer cualquier cambio en el fichero 'private.xml'.) Configuración OpenGTS y Manual de instalación
Página 42 de 62
Página 43
11) Creación / Modificación de Informes OpenGTS viene con un motor muy simple y configurable de generación de informes. Los informes se componen de 3 principal componentes: el diseño del informe, el iterador de datos del informe, y la especificación de informe XML. La especificación XML informe especifica un iterador de datos del informe, las restricciones de informes, y las columnas que han de aparecer en el informe. El iterador datos del informe construye los datos que se incluirán en el informe basado en la presentación de informes restricciones. El diseño de los datos del informe se itera por los datos del informe y genera un informe basado en la columna información de formato proporcionado por el XML especificación de informe. Los componentes "Informe Layout" y "Datos de informe Iterator" deben ser implementadas en el código de Java por un Java programador, y debería ser configurable para un uso general. El "Informe Especificación XML" es una configuración de informe archivo de texto que especifica el tipo, columnas y contraints de un informe específico. Siempre que el diseño del informe y datos iterador se implementan para el uso general, muchos tipos diferentes de informes pueden ser creados que utilizan el mismo diseño y iterador de datos. 11.1) Informe Layout El Informe de Diseño es un módulo Java que define lo que están disponibles para un informe dado columnas, y sus respectivos opciones de formato. Un diseño del informe se debe extender la clase Java abstracto "org.opengts.war.report.ReportLayout" y debe definir un Subclase "DataRow" que entiende cómo analizar informe de columna / campos de objetos de fila informe proporcionados por el informe iterador de datos. La clase "org.opengts.war.report.event.EventDataLayout" es un ejemplo ReportLayout subclase que define las columnas disponibles y las opciones de formato para los informes Detalle Evento o sumarias. 11.2) Datos del informe Iterator El Informe de Datos Iterator es un módulo Java que construye la lista de registros que se van a incluir en el informe basado en las limitaciones especificadas en la especificación XML informe. Un iterador de datos del informe se debe extender la clase Java abstracto "org.opengts.war.report.ReportData" y proporcionar implementaciones para los métodos "getTotalDataIterator" "getBodyDataIterator" y. También debe unirse a una ReportLayout específica al proporcionar una implementación para el método "getReportLayout". La clase "org.opengts.war.report.event.EventDetailReport" es un ejemplo informesInforme subclase que genera el informe Detalle de evento.
11.3) definición de informe XML El "report.xml" archivo define el estilo HTML utilizado para una columna definida en un ReportLayout. Si también define específica informes de especificar qué reportData iterador, y que las columnas se incluirán en un informe dado. También especifica las restricciones que se han de aplicar a los datos que el informe contendrá. He aquí un ejemplo de definición de informe desde el archivo 'report.xml' para el informe "Detalle de eventos": Información sobre eventos MenuDescription> Información sobre eventos Title> $ {DeviceDesc} [$ {deviceId}] \ n $ {dateRange} Subtítulo> <> Columnas Columnas> 1000 SelectionLimit> 1000 ReportLimit> true OrderAscending> Restricciones> MapIconSelector> Informe>