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

Historial de revisiones Manual

RevoluciónFecha 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. Cambios de tipo de Menores, y los cambios de formato de párrafo / página .. MDF 0.0.4 05/06/2007Notas añadidas para los usuarios de Windows. Toda la línea de comandos solicita en cursiva .. Añadido nota sobre el registro de una clave de Google Map.MDF 0.0.5 25/05/2007Notas relativas Añadido soporte para Microsoft Virtual Earth. 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.6 06/03/2007Actualizado enlaces de descarga de MySQL. Incluir Ant enlaces de descarga v1.7.0. MDF 0.0.7 13/06/2007Añadido documentación de administración de base de datos adicional. Se agregó una nota en relación con instal ing un intérprete de Perl en Windows. Errores tipográficos menores fijos. MDF 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. Comentarios adicionales sobre la re­despliegue de "Track.war". Cambiado el nombre del comando "server_mysql. *" Para "server_dmtp. *". MDF 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". Comandos Añadido que son equivalentes a correr "initdb". Añadido comentarios respecto a la personalización del archivo configuation tiempo de ejecución de servlets "webapp.conf". MDF 0.0.11 08/09/2007Añadido algunos comentarios adicionales sobre el servlet 'Eventos'. Tabla comandos de administración cambió de "bin / admin <Tabla> .sh ..." a "admin.sh <Tabla> ... ". Script de arranque del servidor DMTP cambiado a" runserver.sh ­s gtsdmtp ".MDF 0.0.12 16/09/2007Añadido comentarios acerca del uso de archivos por lotes en Windows. Notas Añadido respecto al uso de 'plantilla' y 'GPRMC' para crear servidores de dispositivos personalizada .. 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.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. Se agregó información sobre la implementación de servidores de comunicaciones del dispositivo.MDF 0.1.4 20/02/2008Añadido comentarios adicionales de configuración regardin de Tomcat en Debian / Ubuntu 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. Se agregó información respecto a la personalización del mapa Pasadores .. MDF 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. Inicio Añadido adicional 'dispositivo servidor de comunicaciones' / parada información. MDF 0.2.1 05/24/2009Se 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. Se agregó una sección de "Creación / Modificación de Informes". Notas Añadido en la validación de archivos LocalStrings. MDF 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 de la loog­and­feel, etc.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'. Se agregó información con respecto a la comunicación del dispositivo fichero de configuración de servidores de tiempo de ejecución "dcservers.xml".MDF 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. Añadido información adicional sobre el "GPRMC" http­ basado servidor de comunicaciones del dispositivo. MDF 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. Añadido información sobre cómo iniciar la Módulo TK10x DCS. MDF 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

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

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

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 = <myaccount>". En este caso el nombre de argumento "­Cuenta =" puede ser tomado literalmente, mientras "myaccount" o "<myaccount>" 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 Página 6 de 62

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

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)

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 / ­" {

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 Página 11 de 62

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.

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)

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).

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 = <rootUser> ­rootPass = <rootPass> Donde <rootUser> es el usuario con acceso root en el servidor SQL, y <rootPass> 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 "<bin / comando > ") 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): • Cuenta ­ Tabla de Titular de la cuenta • Usuario ­ Mesa de usuario • UserAcl ­ Acceso­Control­Lista de usuarios tabla • Dispositivo ­ Tabla de información de dispositivos • EventData ­ Los datos de eventos Recibido • Geozona ­ definiciones Geozona / Geofence • EventTemplate ­ Plantillas de paquetes de eventos personalizados (DMTP solamente) • PendingPacket ­ Los paquetes en espera de transmisión al dispositivo (sólo DMTP) • 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 = <rootUser> /usr/local/OpenGTS_1.2.3> bin / dbAdmin.pl ­Grant ­user = <rootUser> /usr/local/OpenGTS_1.2.3> bin / dbAdmin.pl ­mesas = ca

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 "<bin / comando > ") 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 <EmailAddress> ", 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

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" ( W EB AR cebolleta) Se ejecuta en un contenedor de servlets Java y trabaja con el almacén de datos SQL DB para proporcionar un completo 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".

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

/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:

/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" ( W EB AR cebolleta) Se ejecuta en un contenedor de servlets Java y trabaja con el almacén de datos SQL DB para permitir 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 / <archivo> {kml | XML | csv | txt | gpx | json}.? un [UENTA] = <cuenta> ­ el nombre de la cuenta & U [Ser] = <usuario> ­ el nombre de usuario & P [assword] = <contraseña> ­ la cuenta / contraseña de usuario + D [evice] = <dispositivo> ­ el nombre del dispositivo & G [rupo] = <grupo> ­ el nombre del grupo de dispositivos (opcional) [& Rf = <fromtime>] ­ opcional 'de' rango de datos. [& Rt = <totime>] ­ opcional "a" rango de datos. [& L [imit] = <límite>] ­ 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