Manual de Instalación y OpenGTS Configuracion

18/6/2015

Manual de Instalación y OpenGTS Configuracion

Página 1

OpenGTS Instalación y Configuración Manual

Copyright © 2007­2014 Soluciones GeoTelematic, Inc. Todos los derechos reservados

Configuración OpenGTS y Manual de instalación

Página 1 de 62

Página 2

https://translate.googleusercontent.com/translate_f

1/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

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 re­despliegue 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 pre­requisitos. 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 Socket­Basado 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

https://translate.googleusercontent.com/translate_f

3/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

Configuración OpenGTS y Manual de instalación

Página 4 de 62

Página 5

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/LICENSE­2.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

https://translate.googleusercontent.com/translate_f

4/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

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 des­referencia 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

https://translate.googleusercontent.com/translate_f

Página 6 de 62

5/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

Página 7

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 java­1.8.0­openjdk­devel La variable de entorno JAVA_HOME entonces se debe establecer en la siguiente: # Export JAVA_HOME = / usr / lib / jvm / java­1.8.0­openjdk (Asegúrese de que "/usr/lib/jvm/java­1.8.0­openjdk" 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/apache­ant­1.9.4­bin.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/download­70.cgi Código Postal: http://www.apache.org/dist/tomcat/tomcat­7/v7.0.59/bin/apache­tomcat­7.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 / apache­tomcat­x.xx.xx locales Donde "/usr/local/apache­tomcat­x.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 pre­instalado 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 / WEB­INF / ­" { java.util.PropertyPermission permiso "*", "leer, escribir"; java.security.AllPermission permiso; }; conceder codeBase "file: $ {catalina.home} / webapps / eventos / WEB­INF / ­" { https://translate.googleusercontent.com/translate_f

8/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

java.util.PropertyPermission permiso "*", "leer, escribir"; java.security.AllPermission permiso;

}; conceder "file: $ {catalina.home} / webapps / Mologogo / WEB­INF / ­" 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: mysql­esencial­5. X. XX ­m2­win64.msi Donde "mysql­esenciales­5. X. XX ­m2­win64.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 mysql­server 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: mysql­connector­java­5.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 mysql­connector­java El "mysql­connector­java­5.1 XX .jar." Archivo jar a continuación se puede encontrar en la siguiente ubicación: /usr/share/java/mysql­connector­java­5.1. XX .jar (Donde "mysql­connector­java­5.1. XX .jar" coincide con el nombre del archivo jar instalar) El archivo jar "mysql­connector­java­5.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 mysql­connector­java­5.1.10­bin.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.

https://translate.googleusercontent.com/translate_f

10/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

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 back­slash "\". 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 pre­compilada 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" (web­archivo) 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 GC­101. "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).

https://translate.googleusercontent.com/translate_f

12/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

Configuración OpenGTS y Manual de instalación

Página 15 de 62

Página 16

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 ­ Acceso­Control­Lista 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

https://translate.googleusercontent.com/translate_f

13/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

Configuración OpenGTS y Manual de instalación

Página 16 de 62

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 web­pá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. Access­Control­List (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 look­and­feel 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 re­construido y re­desplegado. 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 pre­construidos, 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 / WEB­INF /" 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 .

https://translate.googleusercontent.com/translate_f

19/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

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 = Reverse­geocodificación de códigos de estado de alta prioridad sólo, 3 = Reverse­geocode 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 inversa­geocodificació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.

Configuración OpenGTS y Manual de instalación

https://translate.googleusercontent.com/translate_f

Página 27 de 62

22/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

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 'Control­C') 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 (proceso­id), 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 prima­socket 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, multi­threading 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 little­endian). 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 HTTP­base, 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 NMEA­0183) 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: Unique­ID Valor por defecto: Identificación ­ gprmc.parm.account URL de parámetros clave: Cuenta­ID Valor por defecto: ctas ­ gprmc.parm.device URL de parámetros clave: Dispositivo­ID 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 NMEA­0183 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 geocodificadas­Invertir 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 http­basa 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 NMEA­0183 $ 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 / WEB­INF / 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, multi­threading, 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 big­endian o little­endian? • ¿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 multi­threading 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.

https://translate.googleusercontent.com/translate_f

30/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

Configuración OpenGTS y Manual de instalación

Página 37 de 62

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 'Control­C')

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 (proceso­id), 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: ... ... 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" sub­etiquetas, 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:        4.0   true   true  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" sub­etiqueta: Esta etiqueta especifica la descripción opcional del servidor de comunicaciones del dispositivo. "UniqueIDPrefix" sub­etiqueta: Esta etiqueta especifica los prefijos opcionales "Unique­ID" que se utilizarán cuando se esté buscando el dispositivo móvil­id en el Tabla de dispositivos. En el orden especificado, el prefijo especificado se antepondrá al móvil­id 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óvil­id será utilizado tal cual (sin prefijo antepuesto).

Configuración OpenGTS y Manual de instalación

Página 40 de 62

Página 41 "ListenPorts" sub­etiqueta: 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" sub­etiqueta: Esta etiqueta incluye "propiedad" sub­etiquetas 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.

https://translate.googleusercontent.com/translate_f

33/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

Configuración OpenGTS y Manual de instalación

Página 41 de 62

Página 42

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 ISO­639 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 ISO­8859­1 caracteres codificado (Por "java.util.Properties" y restricciones "java.util.ResourceBundle"). Los caracteres que no pueden ser directamente representados en ISO­8859­1 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 ISO­8859­1 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.

Configuración OpenGTS y Manual de instalación

Página 43 de 62

Página 44

https://translate.googleusercontent.com/translate_f

35/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

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 Información sobre eventos $ {DeviceDesc} [$ {deviceId}] \ n $ {dateRange}  Columnas  1000   1000   true 

Configuración OpenGTS y Manual de instalación

Página 44 de 62

Página 45 11.4) Disponible informe Especificaciones Una vez que el informe ha sido definido en el archivo "report.xml", puede estar disponible para la selección del usuario en la Web­ interfaz haciendo referencia al nombre del informe en el archivo "private.xml" en el "Informes" tag. He aquí un ejemplo de especificación de informe desde el archivo "private.xml":  acl.report.eventDetail   acl.report.eventSummary  https://translate.googleusercontent.com/translate_f

36/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion



Configuración OpenGTS y Manual de instalación

Página 45 de 62

Página 46

Apéndice) A) Soporte para Microsoft SQL Server El apoyo inicial para Microsoft SQL Server se ha incluido con los estándares OpenGTS . Microsoft SQL Server 2005 lata ser descargado / instalado desde la página Web de Microsoft siguiente (s): http://www.microsoft.com/sqlserver/2005/en/us/express.aspx http://www.microsoft.com/Sqlserver/2005/en/us/express­down.aspx Para habilitar el soporte para SQL Server, modifique el archivo "common.conf" en consecuencia para apagar soporte para MySQL y vuelta el soporte para Microsoft SQL Server: # ­­­ Microsoft SQL Server db.sql.provider = sqlserver db.sql.host = localhost db.sql.port = 3193 db.sql.dbname = gts db.sql.user = gts db.sql.password = OpenGTS db.sql.url = jdbc: sqlserver: // $ {db.sql.host}: $ {} db.sql.port db.sql.url.db = $ {} db.sql.url; databasename = $ {} db.sql.dbname También necesitará el apoyo del controlador JDBC para SQL Server para ser descargado / instalado en los entornos de ejecución Java descrito abajo. Descargar: http://msdn.microsoft.com/en­us/data/ff658549 Instalar: % JAVA_HOME% \ jre \ lib \ ext \. https://translate.googleusercontent.com/translate_f

37/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

(Donde % JAVA_HOME% es la ubicación de la instalación de Java) Una vez "common.conf" se han modificado, y el controlador de SQL Server JDBC se ha instalado, recompilar el OpenGTS código e inicializar la base de datos, e instalar los componentes, como se describe anteriormente en este documento. Póngase en contacto con nosotros con cualquier problema que encuentre, o sugerencias que pueden tener relación con el apoyo de Microsoft SQL Server.

Configuración OpenGTS y Manual de instalación

Página 46 de 62

Página 47

Apéndice) B) Apoyo a Mologogo móviles con capacidad. OpenGTS incluye el servlet 'mologogo.war' ( ) Para recibir datos desde Mologogo móviles con capacidad w EB ar cebolleta (Http://www.mologogo.com) usando su característica de "altURL". 'Mologogo.war' se ejecuta en un contenedor de servlets Java y tiendas recibido datos en SQL DB que se pueden ver a través de la interfaz web (ver "track.war '). Configurar el archivo "webapp.conf": El archivo de configuración de ejecución por defecto el archivo "webapp.conf" y el archivo "common.conf", se encuentran en los OpenGTS directorio de instalación. Para la mayoría de las instalaciones, los valores predeterminados especificados en este archivo se puede dejar como está. Si desea personalizar este archivo específico para el servlet "mologogo.war", a continuación, copiar este archivo en el directorio "$ GTS_HOME / guerra / Mologogo / WEB­INF /" y modificar esta copia. B.1) Compilar / Instalación del "mologogo.war" Servlet Java: Para generar el archivo "mologogo.war", ejecute el comando de construcción Ant de la siguiente manera: / Zzz> cd $ GTS_HOME /usr/local/OpenGTS_1.2.3> Mologogo hormiga El "Mologogo" target es un contenedor para tareas ant "mologogo.compile" y "mologogo.war". El objetivo "Mologogo.compile" recopila todas las clases necesarias y archivos de configuración en el directorio de construcción "$ GTS_HOME / build / Mologogo". El "mologogo.war" objetivo continuación, crea el archivo 'archivo web' "$ GTS_HOME / build / mologogo.war". Instale el archivo "mologogo.war" según las instrucciones de instalación / configuración de Apache Tomcat. Típicamente, esto significa copiar el archivo "mologogo.war" al directorio "$ CATALINA_HOME / webapps /.". B.2) La creación de la cuenta "Mologogo" en OpenGTS: Utilice las herramientas de administración de línea de comandos para crear una cuenta llamada "Mologogo" de la siguiente manera: / Zzz> cd $ GTS_HOME /usr/local/OpenGTS_1.2.3> bin / Cuenta admin.sh ­Cuenta = Mologogo ­create Luego, para cada teléfono, cree un nuevo dispositivo: /usr/local/OpenGTS_1.2.3> bin / admin.sh Dispositivo ­Cuenta = Mologogo ­device = ­create mamá /usr/local/OpenGTS_1.2.3> bin / admin.sh Dispositivo ­Cuenta = Mologogo ­device = ­create papá (Etc.) B.2a) Nota importante con respecto a ".sh" y ".bat" archivos de comandos: https://translate.googleusercontent.com/translate_f

38/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

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 " ") B.2b) 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 ­Cuenta = smith tampoco debe ir entre comillas, como en "­Cuenta = smith" , o especificarse con un dos puntos en lugar de un signo igual, como en ­Cuenta: smith .

Configuración OpenGTS y Manual de instalación

Página 47 de 62

Página 48 B.3) Ajuste de la función "altURL" en su teléfono Mologogo: Ajuste la función "altURL" de su teléfono capaz Mologogo a la siguiente URL: "Http: //  ? / Mologogo / Datos ID =  & " Reemplace  con el nombre de dominio de su servidor con Tomcat, y reemplazar  con el identificador de la teléfono específico (como "mamá" o "papá" en este caso). Tenga en cuenta que si usted dejó Tomcat que se ejecuta en el puerto por defecto 8080, entonces puede necesitar su URL para ajustarse a lo siguiente: "Http: // : 8080 / Mologogo / Datos ID =  &" B.4) Comprobación de la instalación: Una vez que todo está configurado, busque los datos que vienen de su teléfono habilitado Mologogo. Nota: Utilizando el "ID =" palabra clave intenta buscar la identidad del dispositivo mediante el uso de los default id cuenta " Mologogo ". Si desea utilizar una cuenta y el dispositivo Identificación del específico, usted puede reemplazar el "? ID =  "con"? ctas =  y dev =  ".

Configuración OpenGTS y Manual de instalación

https://translate.googleusercontent.com/translate_f

Página 48 de 62

39/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

Página 49

Apéndice) C) Tabla Columnas opcionales Varias tablas dentro de los OpenGTS proporcionan para columnas de tablas adicionales que pueden ser utilizados para requisitos de aplicación especiales. Estas columnas de la tabla se pueden activar mediante el establecimiento de propery específica valores dentro de uno de los archivos ".conf" disponibles (es decir. "config.conf", etc). En la siguiente sección describe las distintas columnas de tablas opcionales, y el nombre de la propiedad que se puede utilizar para activar estas columnas. Después de añadir la propiedad especificada en el fichero ".conf" elegido, tendrá que ser actualizado las tablas con las columnas que acaba de agregar. Para actualizar las columnas dentro de las distintas tablas de bases de datos, ejecute el Comando "dbAdmin.pl" como sigue: /usr/local/OpenGTS_1.2.3> bin / dbAdmin.pl ­mesas = ca O, en Windows: C: \> OpenGTS_1.2.3 ­mesas bin \ dbConfig.bat: ca El siguiente comando mostrará las columnas definidas en cada una de las tablas utilizadas por OpenGTS (nota: lo anterior " dbAdmin.pl "o" dbConfig.bat aún se requieren comandos "para asegurar que las columnas de tabla definidos son también agregado a la tabla de base de datos real): /usr/local/OpenGTS_1.2.3> bin / dbAdmin.pl ­schema = TABLE_NAME O, en Windows: C: \ OpenGTS_1.2.3> bin \ dbConfig.bat ­schema: TABLE_NAME Donde " TABLE_NAME "se sustituye por el nombre de la tabla para la que desea visualizar las columnas definidas. Si " TABLE_NAME "se omite, se mostrarán las columnas entonces definidos para todas las tablas. Ca) 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 re­construido y re­desplegado. Nota: Los campos que se describen a continuación sólo pueden contener una lista parcial de los campos que pueden estar disponibles en los distintos mesa campos opcionales. Por favor consulte el módulo de fuente de mesa para una lista definitiva de los campos incluidos.

Configuración OpenGTS y Manual de instalación

Página 49 de 62

Página 50 C.1) Columnas de la tabla Cuenta opcionales: AddressFieldInfo Config Propiedad : startupInit.Account.AddressFieldInfo = true Estos campos se utilizan para almacenar información adicional sobre la dirección, según lo especificado por los requisitos de aplicación. Dirección Línea 1 AddressLine2 addressLine3 addressCity addressState addressPostalCode addressCountry https://translate.googleusercontent.com/translate_f

40/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

MapLegendFieldInfo Config Propiedad : startupInit.Account.MapLegendFieldInfo = true Estos campos se utilizan para almacenar información personalizada leyenda del mapa. mapLegendDevice mapLegendGroup AccountManagerInfo Config Propiedad : startupInit.Account.AccountManagerInfo = true Estos campos se utilizan para almacenar información de configuración de la cuenta Administrador. isAccountManager ManagerID DataPushInfo Config Propiedad : startupInit.Account.DataPushInfo = true Estos campos se utilizan para almacenar el estado de cuenta determinada / datos de eventos 'empujado' a un servidor alternativo: requestPassCode requestIPAddress dataPushURL lastDataRequestTime lastDataPushTime C.2) Columnas de la tabla de dispositivos opcionales: NotificationFieldInfo Config Propiedad : startupInit.Device.NotificationFieldInfo = true Estos campos se utilizan por la aplicación instalada "RuleFactory", o, posiblemente, la notificación de eventos extendida Reglas del motor (ENRE) módulo. En la versión OpenGTS de código abierto, esto puede ser el RuleFactoryExample.java módulo. Cuando está activada, la página "Admin dispositivos" se ajustará automáticamente para mostrar algunos de estos campos. allowNotify lastNotifyTime lastNotifyCode NotifyEmail notifySelector notifyAction notifyDescription notifySubject notifyText notifyUseWrapper notifyPriority parkedLatitude parkedLongitude parkedRadius

Configuración OpenGTS y Manual de instalación

Página 50 de 62

Página 51 LinkFieldInfo Config Propiedad : startupInit.Device.LinkFieldInfo = true Estos campos se utilizan para almacenar información de enlace URL para mostrar en la página del mapa de dispositivos (ver Propiedad "trackMap.showDeviceLink" en "private.xml"), y, posiblemente, en las notificaciones de correo electrónico (si está configurado). linkURL linkDescription DataPushInfo Config Propiedad : startupInit.Device.DataPushInfo = true Estos campos se utilizan para almacenar información sobre la última vez que los registros EventData fueron enviados a otro sistema. lastDataPushTime lastEventCreateMillis FixedLocationFieldInfo Config Propiedad : startupInit.Device.FixedLocationFieldInfo = true Estos campos se utilizan para aplicaciones especiales donde el dispositivo 'telemática' no tiene un receptor GPS y donde el activo que está siendo monitoreada no se mueve (es decir. Como por ejemplo cuando el seguimiento de los niveles del tanque de agua en tanques estacionarios, etc). fixedLatitude fixedLongitude fixedAddress fixedContactPhone fixedServiceTime BorderCrossingFieldInfo Config Propiedad : startupInit.Device.BorderCrossingFieldInfo = true Estos campos se utilizan para almacenar información de estado de línea de cruce fronterizo. (Requiere un módulo que puede detectar stateline cruces fronterizos ­ actualmente no se utilizan en el sistema OpenGTS de código abierto): cruce fronterizo lastBorderCrossTime https://translate.googleusercontent.com/translate_f

41/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

GeoCorridorFieldInfo Config Propiedad : startupInit.Device.GeoCorridorFieldInfo = true Estos campos se utilizan para almacenar la información activa GeoCorridor (actualmente no se utilizan en los OpenGTS de código abierto sistema). activeCorridor MaintOdometerFieldInfo Config Propiedad : startupInit.Device.MaintOdometerFieldInfo = true Estos campos se utilizan para el seguimiento de la información de mantenimiento periódico (actualmente no utilizan en las OpenGTS de código abierto sistema). maintIntervalKM0 maintOdometerKM0 maintIntervalKM1 maintOdometerKM1 maintIntervalHR0 maintEngHoursHR0 maintNotes WorkOrderInfo Config Propiedad : startupInit.Device.WorkOrderInfo = true Estos campos se utilizan para almacenar información e información WorkOrder campo personalizado varios (actualmente no se utiliza en el sistema OpenGTS de código abierto). workOrderID CustomAttributes

Configuración OpenGTS y Manual de instalación

Página 51 de 62

Página 52 C.3) Columnas de la tabla de usuario opcionales: AddressFieldInfo Config Propiedad : startupInit.User.AddressFieldInfo = true Estos campos se utilizan para almacenar información adicional sobre la dirección, según lo especificado por los requisitos de aplicación. Dirección Línea 1 AddressLine2 addressLine3 addressCity addressState addressPostalCode addressCountry C.4) Opcional EventData Tabla Columnas: AddressFieldInfo Config Propiedad : startupInit.EventData.AddressFieldInfo = true Estos campos se utilizan para almacenar información adicional Dirección geocodificada inversa, según lo especificado por la aplicación requisitos. Para que estas columnas para ser llenado en, el proveedor inversa geocode activo debe ser capaz de soportar estos campos: Dirección ciudad StateProvince código postal subdivisión speedLimitKPH isTollRoad GPSFieldInfo Config Propiedad : startupInit.EventData.GPSFieldInfo = true Estos campos se utilizan para almacenar GPS y módem atributos adicionales, tales como la precisión, la dilución de la precisión, la señal de fuerza, etc. gpsFixType horzAccuracy vertAccuracy HDOP satelliteCount BatteryLevel batteryVolts Intensidad de señal CustomFieldInfo Config Propiedad : startupInit.EventData.CustomFieldInfo = true Estos campos se utilizan para almacenar los campos de datos de eventos personalizados diversos, tales como id­conductor, valores analógicos genéricos, etc. https://translate.googleusercontent.com/translate_f

42/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

entityId DriverID driverStatus driverMessage emailRecipient sensorLow sensorHigh centro de costo Número de trabajo rfidTag attachType attachData

Configuración OpenGTS y Manual de instalación

Página 52 de 62

Página 53 GarminFieldInfo Config Propiedad : startupInit.EventData.GarminFieldInfo = true Estos campos se utilizan para recaudar los datos de ETA / parada de un dispositivo Garmin de navegación personal (PND) (un dispositivo de capabile Se requiere el envío de esta información para el servidor). (Actualmente no se utiliza en el sistema OpenGTS de código abierto): etaTimestamp etaUniqueID etaDistanceKM etaLatitude etaLongitude stopID stopStatus stopIndex CANBUSFieldInfo (anteriormente J1708FieldInfo, como de v2.3.2 ) Config Propiedad : startupInit.EventData.CANBUSFieldInfo = true Estos campos se utilizan para almacenar información de diagnóstico del motor recibida desde el equipo de diagnóstico a bordo del motor. La información de diagnóstico de motor por lo general se obtiene de la J1708 vehículo, J1939, OBD­II, o de la interfaz CANBUS. Esta lista opcional incluye campos como "engineRPM", "engineHours", "coolantLevel", "coolantTemp", "OilLevel", "oilTemp", "fuelLevel", "fuelTotal", "fuelIdle", y muchos más (ver la "CANBUSFieldInfo" sección en el módulo de fuente EventData.java para obtener una lista completa de campos compatibles). fuelTotal engineRpm engineHours engineLoad engineTorque idleHours Horas laborales transOilTemp coolantLevel coolantTemp intakeTemp brakeGForce aceleración presión del aceite nivel de aceite oilTemp presión del aire airFilterPressure turboPressure ptoEngaged ptoHours throttlePos brakePos j1708Fault faultCode malfunctionLamp fuelLevel fuelIdle fuelPTO vBatteryVolts fuelPressure fuelUsage fuelTemp fuelEconomy brakePressure presión de llanta tireTemp

https://translate.googleusercontent.com/translate_f

43/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

Configuración OpenGTS y Manual de instalación

Página 53 de 62

Página 54 AtmosphereFieldInfo Config Propiedad : startupInit.EventData.AtmosphereFieldInfo = true Estos campos se utilizan para almacenar datos atmosféricos, tales como la temperatura y la presión barométrica. barómetro ambientTemp cabinTemp ThermoFieldInfo Config Propiedad : startupInit.EventData.ThermoFieldInfo = true Estos campos se utilizan para almacenar información de la temperatura típicamente recibido de monitores de temperatura colocados en la carga que se transporta. thermoAverage0 thermoAverage1 thermoAverage2 thermoAverage3 AnalogFieldInfo Config Propiedad : startupInit.EventData.AnalogFieldInfo = true Estos campos se utilizan para almacenar información analógica genérica. analoge0 analoge1 analoge2 analoge3 AutoIncrementIndex Config Propiedad : startupInit.EventData.AutoIncrementIndex = true Estos campos se utilizan para auto­indexación de los registros EventData. A menos que sea absolutamente necesario, estos campos deben permanecer discapacitados. AUTOINDEX EndOfDaySummary Config Propiedad : startupInit.EventData.EndOfDaySummary = true Estos campos se utilizan para almacenar los datos de resumen diario que puede ser proporcionada por el dispositivo de rastreo GPS remoto. Más dispositivos no ser capaz de proporcionar esta información (actualmente utilizado solamente para el servidor de comunicación del dispositivo Antx). dayEngineStarts dayIdleHours dayFuelIdle dayWorkHours dayFuelWork dayFuelPTO dayDistanceKM dayFuelTotal ServingCellTowerData Config Propiedad : startupInit.EventData.ServingCellTowerData = true Estos campos se utilizan para almacenar la información que sirve de células­torre. Esto puede ser útil para proporcionar una antena de telefonía móvil basado (Se requiere un servicio que puede proporcionar células torre lugar latitud / longitud) localización aproximada. cellTowerID mobileCountryCode mobileNetworkCode cellTimingAdvance locationAreaCode cellServingInfo cellLatitude cellLongitude cellAccuracy

Configuración OpenGTS y Manual de instalación

Página 54 de 62

Página 55 NeighborCellTowerData Config Propiedad : startupInit.EventData.NeighborCellTowerData = true Estos campos se utilizan para almacenar la información de la célula vecina torre. Esto puede ser útil para proporcionar una torre celular (Se requiere un servicio que puede proporcionar células torre lugar latitud / longitud) ubicación aproximada basada. cellNeighborInfo0 cellNeighborInfo1 cellNeighborInfo2 cellNeighborInfo3 https://translate.googleusercontent.com/translate_f

44/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

cellNeighborInfo4 cellNeighborInfo5 WorkZoneGridData Config Propiedad : startupInit.EventData.WorkZoneGridData = true Estos campos se utilizan para la información de muestreo de datos WorkZone. (No se utiliza en los OpenGTS de código abierto, y en la mayoría Instalaciones de la empresa GTS): sampleIndex IDMuestra CreationTimeMillisecond Config Propiedad : startupInit.EventData.CreationTimeMillisecond = true Estos campos se utilizan para EventData tiempo récord creación con resolución de milisegundos. Esto también crea un "dataPush" campo que se puede utilizar con el dispositivo "DataPushInfo" campos opcionales. dataPush creationMillis

Configuración OpenGTS y Manual de instalación

Página 55 de 62

Página 56

Apéndice) D) Instalación MotoDMTP

Da) Nota: La fuente para la MotoDMTP software de soporte de seguimiento GPS se encuentra en el OpenDMTP "cliente­j2me" descarga del proyecto en SourceForge: https://sourceforge.net/project/showfiles.php?group_id=151031 El " MotoDMTP aplicación "está diseñado para trabajar con Motorola i415 / i425 / i290 / i335 de Boost teléfonos móviles, y puede trabajar en otras Motorola Boost teléfonos móviles también. " MotoDMTP "utiliza el OpenDMTP protocolo para enviar datos a la OpenDMTP servidor, que se incluye con OpenGTS . Motorola Boost Los teléfonos móviles están disponibles en varios puntos de venta en los EE.UU., como Radio Shack, Walmart, Target, Best Buy, etc, y también puede ser adquirido de Boost Mobile directamente. Después de comprar uno de estos Boost Motorola Los teléfonos móviles, activar el servicio en la red de Boost Mobile según las instrucciones que acompañan al teléfono. Cerciorarse que seleccione el servicio de plan de datos ("Wireless Web Activar") para que el teléfono para enviar los datos al servidor. Nota: OpenGTS / OpenDMTP y Soluciones GeoTelematic, Inc. no están afiliados a Motorola o Boost Mobile, o cualquiera de los diversos puntos de venta al por menor se ha mencionado, en cualquier forma. "Motorola", "Boost Mobile", y los diversos mencionado https://translate.googleusercontent.com/translate_f

45/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

puntos de venta son marcas registradas de sus respectivas compañías. Db) Importante: Al activar el servicio Boost Mobile, asegúrese de seleccionar la opción de plan de datos (consulte "Activar inalámbrico Web ") para activar el teléfono para enviar los datos al servidor. Dc) Nota: Instalación MotoDMTP requiere el uso de Windows para ejecutar el Motorola "iDEN Java Application Loader" aplicación. D.1) Configurar el archivo MotoDMTP.jad: Una versión precompilada de "MotoDMTP.jar" y "MotoDMTP.jad" se incluye en esta versión. Para construir su propia versión del archivo "MotoDMTP.jar", consultar el MotoDMTP documentación que accomanies la OpenDMTP 'Java' Descarga la aplicación .. El archivo JAD (MotoDMTP.jad) se utiliza para cargar las propiedades de ejecución y la información de configuración en el J2ME aplicación. Necesitará este archivo para ser modificado antes de la instalación para configurar el servidor: puerto al que se enviarán los datos, y para configurar el nombre (cuenta, dispositivo, etc.) que se utiliza para identificar el teléfono en el servidor. Edite el archivo "MotoDMTP.jad" con un editor de texto conveniente (como Windows "WordPad") y añade la siguiente definición de la propiedad a la última línea del archivo (o editar la línea existente, si uno está ya presente): DMTP­Access: 0,  ,  ,  ,  Que especifica el servidor: puerto y AccountID / DeviceID utiliza para identificar el teléfono en el servidor. (Nota: la prefijación "0", que se requiere y se reserva para uso futuro). (Nota: Los caracteres '' en los ejemplos anteriores sirven para delimitar las distintas opciones y no han de ser incluido en la especificación propiedad final. JAD especificaciones propiedad fichero deben comenzar en el primer carácter de la línea).

Configuración OpenGTS y Manual de instalación

Página 56 de 62

Página 57 Por ejemplo, suponiendo que el anfitrión es "data.example.com" y el puerto es "31000", y la AccountID / DeviceID es "Myaccount / mydevice", una adecuada especificada "DMTP­Access:" línea whould aparece de la siguiente manera: DMTP­Access: 0, data.example.com, 31000, myaccount, mydevice D.1a) Importante: Asegúrese de que hay una línea en blanco al final del archivo 'MotoDMTP.jad' después de la última entrada de la propiedad. Sin esta línea en blanco, la última entrada de la propiedad no puede ser cargado en la aplicación J2ME, y el teléfono puede no ser capaz para establecer una conexión con el servidor. En el servidor, agregue la cuenta­id y dispositivo de identificación, para recibir datos desde el teléfono. D.2) Definiendo otras opciones de generación de eventos configurable: También puede establecer el intervalo de presentación de informes y otras opciones configurables en el archivo JAD también. Éstos son algunos adicional opciones configurables que pueden ser incluidos en el archivo JAD para cambiar el comportamiento de seguimiento: (Nota: Los caracteres '' en los ejemplos siguientes sirven para delimitar las distintas opciones y no han de ser incluido en la especificación propiedad final. JAD especificación fichero propiedad debe comenzar en el primer carácter de la línea). DMTP­gps­MINSPD:  Esta opción establece el GPS informado velocidad mínima (sustituir "  "con el mínimo deseado GPS informaron velocidad en km / h). Plazos de envío indicado por el receptor GPS que son menores que este valor se fija en cero antes de informar de ellos en un Evemt. Esto ayuda a mitigar las imprecisiones en los receptores GPS que puede reportar un 'movimiento' acelerar aun cuando el receptor GPS está sentado inmóvil en un escritorio. La velocidad mínima predeterminada GPS es de 12 Km / h (aproximadamente 7,4 mph). DMTP­mot­start:  Esta opción especifica la velocidad mínima que debe ser informado antes de que se genere un evento de "Inicio de movimiento" (reemplazar "  "con el mínimo de velocidad 'inicio' deseada en km / h). Este valor debe ser al menos tan grande como el valor especificado en el GPS mínimos acelerar arriba. El valor predeterminado es 16,1 kmh (aproximadamente 10 millas por hora). DMTP­mot­inmotion:  Esta opción especifica el número de segundos entre eventos informados mientras el teléfono está en movimiento, después de la generación de un evento "Inicio de movimiento" (sustituir "  "con el intervalo deseado en movimiento en la presentación de informes segundos). Este valor no puede ser inferior a 60 segundos. El valor predeterminado es de 120 segundos (2 minutos). https://translate.googleusercontent.com/translate_f

46/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

DMTP­mot­stop:  Esta opción especifica el número de segundos que esperar después de las paradas de teléfonos móviles para informar de un evento "Stopped" (reemplazar "  "con el número deseado de segundos de espera antes de generar un evento de" Stopped "). Este valor se utiliza para prevenir la parada rápida / comienza ocurran con frecuencia en ventanillas luces y dejar de signos, o paradas cortas durante tráfico pesado. El valor predeterminado es de 210 segundos (3,5 minutos). ­Dormitorio­tasa DMTP­mot:  Esta opción especifica el número de segundos entre eventos informados mientras el teléfono no está en movimiento (es decir. "Durmiente") después de la generación de un evento "Stopped" (sustituir "  "con la información deseada en estado latente intervalo en segundos). Este valor no puede ser inferior que 300 segundos. El valor predeterminado es de 1800 segundos (30 minutos).

Configuración OpenGTS y Manual de instalación

Página 57 de 62

Página 58 DMTP­mot­EXSPEED:  Esta opción especifica el umbral de velocidad en km / h, más allá del cual se gnerated un evento exceso de velocidad (reemplazar "  "con el umbral de velocidad deseada en km / h). El valor predeterminado es "0", que no lo hace generar un evento exceso de velocidad. D.2a) Importante: Asegúrese de que hay una línea en blanco al final del archivo 'MotoDMTP.jad' después de la última entrada de la propiedad. Sin esta línea en blanco, la última entrada de la propiedad no puede ser cargado en la aplicación J2ME, y el teléfono puede no ser capaz para establecer una conexión con el servidor. D.3) Instalación de la aplicación en el teléfono: Descargar e instalar el "iDEN Java Application Loader" de Motorola, disponible en este enlace: http://developer.motorola.com/docstools/idenjal/ Esta aplicación se instala en Windows XP o Vista. Consulte el sitio web de arriba para más detalles sobre el sistema requisitos y procedimientos de instalación. Se necesitará un cable USB (tipo A macho a mini­B­macho) para conectar el i425 teléfono / i290 a tu PC con Windows (el teléfono i415 requiere un cable de encargo disponible en su tienda de Sprint / Nextel). También puede ser necesario para descargar el controlador USB para Motorola auricular, que se puede obtener desde el siguiente enlace: http://developer.motorola.com/docstools/USB_Drivers/ Cargando MotoDMTP en su teléfono usando OpenJAL: 1) Coloque tanto el "MotoDMTP.jar" y "MotoDMTP.jad" en el mismo directorio. 2) Poner en marcha OpenJAL y configurar las preferencias de "Conectar a través de conexión USB". 3) Conecte el teléfono al PC mediante el cable USB. 4) Seleccione "Conectar a teléfono". A los pocos segundos se debe conectar al teléfono e indicará una "X" roja sobre el "Conectar a teléfono" icono. 5) Seleccione "Aplicación J2ME de carga", a continuación, busque el archivo "MotoDMTP.jad". 6) Seleccione "Descargar". En pocos segundos la descarga debe ser completa (si bien puede parecer que sólo el Archivo "MotoDMTP.jad" se está descargando, es, de hecho, tanto la carga "MotoDMTP.jad" y "MotoDMTP.jar" archivos en el teléfono.) 7) Una vez cargado, haga clic en el botón "teléfono Disconnect" dentro de la aplicación OpenJAL. Diferentes teléfonos tienen diferentes métodos para la instalación / actualización / aplicaciones Java de partida. A continuación se describe una visión general del proceso, pero los comandos en su teléfono particular, pueden ser diferentes: Instalación de la aplicación MotoDMTP vez descargado en el teléfono: 1) Desde la pantalla principal del teléfono (con el logotipo "Boost Mobile"), seleccione el botón de menú y recorrer a la "Java Aplicaciones "o" Juegos y aplicaciones "icono, a continuación, pulse Aceptar. 2) Si se le pide para instalar la nueva aplicación descargada, seleccione "Sí". De otra manera transversal a la aplicación "MotoDMTP" y pulse el botón de menú. Si hay una actualización disponible, seleccione "Actualizar" y pasar por el proceso de actualización. Empezar la aplicación, seleccione Aceptar. Inicio de la aplicación MotoDMTP: 1) Desplazamiento a la aplicación y pulse "OK" "MotoDMTP". 2) Si se les pide alguna pregunta con respecto al acceso a los recursos móviles (GPS, transmisión de datos, etc.), siempre responder sí / ok / siempre / etc.

https://translate.googleusercontent.com/translate_f

47/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

Configuración OpenGTS y Manual de instalación

Página 58 de 62

Página 59 También puede configurar el teléfono para iniciar automáticamente la aplicación MotoDMTP cuando el teléfono está encendido: 1) Desde la pantalla principal del teléfono, seleccione el botón de menú, a continuación, seleccione "Configuración" y seleccione "Personalizar". 2) Traverse a la opción "Power Up" y pulse el botón OK. 3) "App: ..." se seleccionará. Pulse el botón Aceptar. 4) Traverse a la opción "MotoDMTP" y pulse el botón OK. 5) Continúe seleccionando "Volver" hasta que aparezca la pantalla principal. Importante: El receptor GPS en el teléfono puede no funcionar si el teléfono no tiene servicio activo corriente a través de Boost Mobile. Como resultado, la latitud / longitud no se muestre correctamente en el teléfono si Boost Mobile servicio no está activa. D.4) Notas de aplicación: Después de iniciar la aplicación, la pantalla aparecerá como sigue: TIM: n / a LAT: n / a LON: n / a ACC: +/­ 0 ft SPD: 0 mph ALT: 0 ft EVT: 0/0 GPS Adquirir ... (Nota: si " Error de acceso se muestra ", entonces la propiedad" DMTP­Access "no se ha configurado correctamente en el Archivo "MotoDMTP.jad". Congigure la propiedad "DMTP­Access" como se describe anteriormente y vuelva a cargar la aplicación a la teléfono. Asegúrese de que hay una línea en blanco al final del archivo "MotoDMTP.jad"). Una vez que la primera posición de GPS, aparecerá similar a la siguiente pantalla: TIM: 12:24:27 LAT: 39.1234 LON: ­142.1234 ACC: +/­ 20 pies SPD: 0 mph ALT: 17 pies EVT: 0/0 Los campos que se muestran se describen como sigue: TIM ­ El tiempo actual LAT ­ La latitud LON ­ La longitud actual ACC ­ La 'exactitud' de la posición GPS actual SPD ­ La velocidad actual ALT ­ La altitud actual EVT ­ El número de eventos de transmisión / el número de eventos en cola para transmitir

Configuración OpenGTS y Manual de instalación

Página 59 de 62

Página 60

Apéndice)

https://translate.googleusercontent.com/translate_f

48/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

E) La importación de GPS Eventos del Trackstick Mini (Esta característica está disponible en la versión v2.3.2 de OpenGTS ) El "Trackstick Mini" es un dispositivo de registro de datos GPS disponibles en «TrackStick". Más información se puede encontrar en su sitio web en "http://www.trackstick.com/products/mini/index.html". Nota: OpenGTS y Soluciones GeoTelematic, Inc. no están afiliados a Trackstick o Telespial Systems, en cualquier manera. "Trackstick" y "Trackstick Mini" son marcas comerciales registradas de Trackstick y Sistemas Telespial. El "Trackstick Manager" puede exportar la información de registro GPS en formato CSV (valores separados por comas­valor). Esta exportado Archivo CSV se puede importar en OpenGTS para mostrar los diversos lugares capturados en un mapa. Durante la importación de OpenGTS , los puntos de datos se puede filtrar para incluir sólo los puntos que tienen cambios de dirección o de más de un cierto número de segundos de diferencia, reduciendo así el número de puntos de datos innecesarios. La configuración requerida utilizado al exportar el archivo CSV es el siguiente: Fecha / Hora ­ Todos los formatos de fecha / hora disponibles que los soportes Administrador Trackstick también son compatibles con la OpenGTS utilidad de importación CSV, sin embargo, el cuadro de "Display segundos" también debe ser revisado. Recomendado: Fecha en "DD / MM / AAAA" formato y tiempo en una columna separada en formato de 24 horas como "hh: mm: ss". Zona horaria se recomienda exportar los datos de zona horaria GMT, pero la zona horaria de los datos exportados puede ser ­ especificada en la OpenGTS . importación CSV Recomendado: GMT. Latitud / Longitud ­ Todos los formatos de latitud / longitud disponibles que los soportes Administrador Trackstick son también apoyado por el OpenGTS utilidad de importación CSV, sin embargo, el cuadro de "Visible" también debe ser revisado. Recomendados: grados. Altitud ­ Las unidades de altura deben estar en metros. La casilla "Visible" debe comprobarse. Temperatura ­ Las unidades de temperatura debe estar en grados Celsius. Velocidad ­ Las unidades deben estar en "kph" (km / h), sin embargo "mph" y "nudos" deben funcionar tan bien como siempre que esta unidad especificación se muestra después de que el valor de la velocidad. Recomendado: km / h. Status (duración) ­ Las unidades seleccionadas deben estar en "minutos". Curso ­ Las unidades del curso / partida deben estar en grados (necesario para la rúbrica de filtrado de cambio). La casilla "Visible" debe ser revisado. "Display Fix GPS" caja debe ser revisado. "Visualización de Señales" caja debe ser revisado. "Display Power On / Off Registros" caja debe ser revisado. E.1) Configurar el filtrado de eventos: El proceso de importación puede filtrar eventos para retener sólo aquellos que son pertinentes. La siguiente configuración de ejecución propiedades se pueden configurar para especificar el tipo de filtrado que debe producirse al importar los datos de registro del GPS (estos propiedades deben especificarse en el archivo "config.conf"): trackstick.minimumHeadingChange Esta propiedad especifica el mínimo detectado cambio de rumbo para aceptar un punto de datos para su inclusión en la mesa EventData. Un número mayor reducirá el número de eventos incluidos. Un número más pequeño Wil producir . una línea de ruta más suave alrededor gira Valor recomendado: 15,0 (grados) trackstick.minimumMovingSeconds Esta propiedad especifica el número mínimo de segundos entre puntos de datos periódicos cuando el vehículo está en . movimiento Valor recomendado: 120 (segundos) trackstick.minimumDormantSeconds Esta propiedad especifica el número mínimo de segundos entre puntos de datos periódicos que se pueden producir al . el vehículo no está en movimiento Valor recomendado: 1800 (segundo)

Configuración OpenGTS y Manual de instalación

Página 60 de 62

Página 61 trackstick.estimateOdometer Esta propiedad especifica si desea calcular un valor odómetro basado en GPS entre los puntos sucesivos. El punto de partida del odómetro se obtiene del campo "lastOdometerKM" en el registro de dispositivos, y la final valor de los odómetros se almacena de nuevo en el dispositivo de campo "lastOdometerKM". Desde se recupera el odómetro de comenzar a partir del registro de dispositivos, y odómetro terminando se almacena de nuevo en el registro del dispositivo, es posible que el intento para importar un archivo CSV más de una vez puede sesgar los valores del odómetro introducidos en la tabla EventData. La proceso de importación no intente detectar un intento de volver a importar el mismo archivo CSV, para mitigar cualquier "sesgar" efecto que puede ocurrir, sin embargo se debe tener cuidado para evitar volver a importar el archivo de salvar CSV si es posible. Valor recomendado: true E.2) Ejecutar el comando de importación: Suponiendo que el nombre de su archivo CSV exportado se llama "2011­03­26 04.05.10.csv", el comando de importación el archivo CSV en OpenGTS sería la siguiente: cd $ GTS_HOME bin / trackstick.sh ­Cuenta = CUENTA ­device = DISPOSITIVO ­tmz = TIMEZONE ­CSV = "2011­03­26 04.05.10.csv" O en Windows: https://translate.googleusercontent.com/translate_f

49/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

cd% GTS_HOME% bin \ trackstick.bat ­Cuenta: CUENTA ­device: DISPOSITIVO ­tmz: TIMEZONE ­CSV: "2011­03­26 04.05.10.csv" Donde " CUENTA "y" DISPOSITIVO "son la cuenta / dispositivo al que se aplicarán los datos importados, y" TIMEZONE "es la zona horaria de los tiempos representados dentro del archivo CSV. (Nota: "­a: CUENTA ­d: DISPOSITIVO "también puede ser utilizado para especifique la cuenta y el dispositivo). Establezca el archivo "­CSV" al nombre del archivo exportado desde la "Trackstick Manager". El comando será entonces encabezado de salida informaton que indica los valores de la filtrado de eventos como sigue (los valores se muestra a continuación sólo son un ejemplo de los valores que pueden aparecer): ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ Cuenta Demo Dispositivo: demo Modo de depuración: false Por defecto Zona horaria: GMT Min Velocidad Km / H: 0.0 Var Denominación mínima: 15.0 Min Mudanza Sec: 120 Min Durmiente Sec: 1800 Estimación del cuentakilómetros: true ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ Seguido por una pantalla de cada evento analizado y se inserta en la tabla EventData: ... ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ Incluya Evento: true ­ Evento de Inicio (kph) Marca de tiempo: [1301012280] jue 24 de marzo 17:18:00 PDT 2011 Estado: Inicio GeoPoint: 39.25054 / ­142,33508 Altitud: 562.7 metros (1,846.1 pies) Velocidad: 4.0 km / h (2,5 mph) en dirección 337,6 (Norte) Temp: 28,4 C (83,1 F) Odómetro: 0,0 km (0,0 millas) Evento almacenado: [0xF111] Iniciar

Configuración OpenGTS y Manual de instalación

Página 61 de 62

Página 62 ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ Incluya Evento: true ­ Evento Movimiento Periódico Marca de tiempo: [1301012520] jue 24 de marzo 17:22:00 PDT 2011 Estado: InMotion GeoPoint: 39.25052 / ­142,33528 Altitud: 564.5 metros (1,852.0 pies) Velocidad: 0,0 km / h (0,0 mph) en dirección 62.0 (Nordeste) Temp: 28,9 C (84,0 F) Odómetro: 0,0 km (0,0 millas) Evento almacenado: [0xF112] InMotion ­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­­ ... Si la opción "­nosave" se añade a la línea de comandos, a continuación, se producirá el análisis de datos, pero los registros EventData voluntad No almacenar ni habrá ninguna información odómetro actualizarse en el registro de dispositivos. El uso de "­nosave" es por lo general recomendado para la comprobación inicial de los datos para asegurarse de que la zona horaria no se ha especificado correctamente (de lo contrario el tiempo puede ser apagado por varias horas). E.3) Captura de la información de la temperatura del dispositivo: La información de la temperatura también se puede almacenar en la tabla de EventData, siempre que la siguiente opcional Conjunto de campos EventData "ThermoFieldInfo" se ha activado (configurado en "config.conf"): startupInit.EventData.ThermoFieldInfo = true Entonces actualizar las columnas de tabla EventData: cd $ GTS_HOME bin / dbAdmin.pl ­mesas = ca El archivo "reports.xml" puede entonces ser modificada para mostrar los valores de temperatura en uno de los informes EventDetail.

https://translate.googleusercontent.com/translate_f

50/51

18/6/2015

Manual de Instalación y OpenGTS Configuracion

Configuración OpenGTS y Manual de instalación

https://translate.googleusercontent.com/translate_f

Página 62 de 62

51/51