Instalación/compilación

Nota IMPORTANTE:

La instalación de las características compatibles de OpenGTS requiere al menos un conocimiento intermedio de cómo instalar y configurar servicios de sistemas como el compilador de 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 Usuarios Linux

        
    

En sistemas Linux, se recomienda descomprimir e instalar el archivo zip de OpenGTS en "/usr/local/" directorio. En Windows, se puede instalar en cualquier directorio conveniente, como en la partición raíz de "C:\".
A los fines de este documento, supondremos que el sistema operativo de destino está basado en Linux y que la ubicación donde se instalará/descomprimirá OpenGTS es "/usr/local/OpenGTS_1.2.3/" (Nota: es posible que deba elegir otro directorio de instalación si no tiene acceso 'root' en el sistema de destino). Ajuste los separadores de archivo/ruta y comandos según sea necesario para su sistema operativo particular y el directorio de instalación elegido.
Instale el código fuente de OpenGTS:
Descomprima el paquete OpenGTS en "/usr/local/" (esto deberá hacerse como el usuario "raíz"), u otra forma conveniente directorio (en Windows, elija un directorio donde le gustaría que se coloque este paquete, preferiblemente una ruta que no contiene ningún espacio incrustado). Por ejemplo, si el paquete OpenGTS a instalar es "OpenGTS_1.2.3.zip", entonces el comando para descomprimir el paquete sería:
/zzz> cd /usr/local
/usr/local> su raíz
/usr/local# descomprimir /tmp/OpenGTS_1.2.3.zip
/usr/local# chown -R usuario:grupo OpenGTS_1.2.3
/usr/local# salir
/usr/local> exportar GTS_HOME=/usr/local/OpenGTS_1.2.3 (Lo anterior supone que OpenGTS_1.2.3.zip se descargó en "/tmp/". 
Si se descargó el archivo zip de OpenGTS en un directorio diferente, modifique la ubicación del directorio anterior y el nombre del archivo descargado en consecuencia. Además, reemplace el nombre de usuario "usuario" y nombre de grupo "grupo", arriba con el nombre del usuario:grupo que desea que sea el propietario instalación de OpenGTS).
(También tenga en cuenta que el nombre del directorio "/zzz" anterior es solo un nombre de marcador de posición que representa cualquier directorio actual que puede estar en efecto antes de que se emita el comando "cd").




3.2 Usuarios Windows

        
    

La ubicación de los directorios 'bin' de instalación para las instalaciones del servidor de base de datos Java SDK, Ant y SQL, debe agregarse a la variable de entorno PATH de ejecución del comando (si el proceso de instalación no se ha completado). 
ya los agregué a la variable PATH).
Las variables de entorno se pueden configurar manualmente en un símbolo del sistema con el comando "establecer", como se muestra a continuación
ejemplo:
 C:\> establecer GTS_HOME=C:\OpenGTS_1.2.3
(Al configurar las variables de entorno, no se deben usar comillas para encerrar un directorio de instalación, incluso si el directorio contiene espacios incrustados)
Las variables de entorno se referencian encerrándolas en '%'. Por ejemplo, después de configurar el entorno variable JAVA_HOME para apuntar a su directorio de instalación de JDK, esta variable de entorno serí desreferenciado como “%JAVA_HOME%”.
El separador de ruta de archivo es el carácter de barra invertida “\”. Entonces, mientras que en Linux se podría hacer referencia a un archivo/directorio como “$JAVA_HOME/jre/lib/ext/.”, en Windows se haría referencia a este mismo directorio como “JAVA_HOME\jre\lib\ext\.“
Las variables de entorno anteriores se pueden configurar para que se definan 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 en "Mi PC" y seleccione "Propiedades", aparecerá la ventana "Propiedades del sistema".
Seleccione la pestaña "Avanzado", luego presione el botón "Variables de entorno".
– En la sección "Variables del sistema", agregue las siguientes variables:
Nombre de variable: JAVA_HOME (requerido para compilar OpenGTS y ejecutar Tomcat)
 Valor: (La ubicación de la carpeta de instalación de JAVA SDK, NO el JRE)
Nombre de la variable: ANT_HOME
 Valor: (La ubicación de su carpeta de instalación de Ant)
Nombre de la variable: CATALINA_HOME (requerido para construir OpenGTS)
 Valor: (La ubicación de su carpeta de instalación de Apache Tomcat)
Nombre de la variable: GTS_HOME
 Valor: (La ubicación de su carpeta de instalación de OpenGTS)
(Las comillas NO deben usarse para encerrar un directorio de instalación para estas variables de entorno).
especificaciones, incluso si el directorio contiene espacios incrustados)
– Prefije lo siguiente a la variable de entorno "Ruta" en la sección "Variables del sistema" (cree una nueva
Variable "Ruta" si aún no existe una):
.;%JAVA_HOME%\bin;%MYSQL_HOME%\bin;%ANT_HOME%\bin;
(Se pueden agregar comillas a la variable PATH si es necesario)
– Haga clic en "Aceptar" en la ventana "Variable de entorno".
3.2.b) Usuarios de Linux:
Se recomienda crear los siguientes enlaces simbólicos dentro del directorio "/usr/local/" que apuntan
 a sus directorios 'inicio' correspondientes (omita un enlace simbólico dado si ya se ha creado):
 # cd /usr/local
 # ln -s $JAVA_HOME java
 # ln -s $CATALINA_HOME gato
 # ln -s $GTS_HOME gts





3.3 Compilación de los archivos de la biblioteca GTS de apoyo.

        
    

3.3a) Versiones precompiladas de GTS:
Si ha recibido una versión precompilada del paquete GTS, esta sección se puede omitir (sin embargo, puede reconstruir los diversos servlets y archivos jar si desea realizar algún cambio en la configuración del tiempo de ejecución
antes del despliegue.
Compile los archivos de la biblioteca OpenGTS ".jar" y del servlet ".war":
'cd' en el directorio de instalación de OpenGTS y compile los archivos jar y los archivos war de servlet, utilizando el Ant suministrado
 Guión "construir.xml":
/usr/local> cd $GTS_HOME
/usr/local/OpenGTS_1.2.3> y todo
Esto generará varios archivos jar y archivos war en el directorio "$GTS_HOME/build/", incluidos:
• "lib/gtsutils.jar": este contenedor contiene las utilidades básicas y las herramientas de acceso a la base de datos.
• "lib/gtsdb.jar": este contenedor contiene las utilidades de acceso a la base de datos y la definición de la tabla.
• "lib/gtsdmtp.jar": este jar contiene los contenedores del almacén de datos SQL db alrededor del servidor OpenDMTP.
• "lib/tools.jar": este contenedor contiene varias herramientas administrativas y de verificación del sistema.
• "track.war": este archivo "war" (archivo web) contiene el servlet de interfaz web 'Track'.
• "events.war": este archivo "war" contiene el servlet de acceso EventData accesible desde la web.
• "mologogo.war": este archivo "war" contiene el servlet del dispositivo Mologogo.
• "gc101.war": este archivo "war" contiene soporte para el dispositivo Sanav GC-101.
• "gprmc.war": este archivo "war" contiene un servidor de soporte de servlet para un servidor de dispositivo genérico basado en http.
(Nota: esta es solo una lista parcial. También se crearán otros módulos).
La compilación debería completarse normalmente. Es posible que se muestren algunas advertencias, sin embargo, si la advertencia o el error se pueden
ignorado, también habrá un mensaje indicando esto al lado de la advertencia/error (o en una línea justo debajo de la advertencia/error).