Carga de los módulos y requisitos previos

2) Cargar los paquetes y requisitos previos
Nota IMPORTANTE:
La instalación de los módulos de requisitos previos 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.
La compilación de OpenGTS requiere que los siguientes paquetes o aplicaciones estén instalados, configurados y ejecutándose en el sistema local:
2.1 Compilador Java Paquete: Java SE JDK 8 Descargar: http://www.java.com/en/download/manual.jsp Notas: descargue solo el JDK (el JRE ya está incluido en el JDK) Nota: Para evitar posibles dolores de cabeza al tratar de compilar el código OpenGTS, asegúrese de estar usando el "Sun Microsystems" del compilador de Java. Las 'otras' versiones tienen problemas para compilar este código. Después de instalar el compilador de Java, verifique su versión con el siguiente comando: Java -versión Asegúrese de que diga "Java(TM)" y "Java HotSpot(TM) Client VM". Nota: Asegúrese de que el directorio 'bin' de instalación de Java SDK se haya agregado a la variable de entorno PATH (consulte a continuación). Si no lo hace, es posible que se produzcan errores del compilador. NOTA IMPORTANTE: Instale solo el componente JDK, no instale el componente JRE separado. El JDK ya contiene un JRE y se necesita el JDK para compilar el código Java. Tener tanto el JDK como el JRE instalados en su sistema, puede causar cierta confusión a la hora de compilar y ejecutar la aplicación. 2.1.a) Usuarios de Mac OS X: Es probable que Java JDK v1.6.0 ya esté instalado en su sistema Mac OS X, por lo que puede que no sea necesario descargue otra copia de Java JDK. Su versión instalada de Java JDK v.1.6.0 puede estar en el siguiente directorio: /Sistema/Biblioteca/Frameworks/JavaVM.framework/Versions/1.6.0/Inicio 2.1.b) Usuarios de Fedora/CentOS Linux: El "Entorno de desarrollo OpenJDK" de Fedora/CentOS Java se puede instalar y utilizar en lugar de descargando el JDK8 directamente desde Sun Microsystems. El comando para instalar el desarrollador de Java 1.8.0 El entorno 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 debe configurarse de la siguiente manera: # exportar JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk (asegúrese de que "/usr/lib/jvm/java-1.8.0-openjdk" coincida con el nombre del Java JDK instalado directorio) Se recomienda crear también un enlace simbólico "java" en el directorio "/usr/local/" que apunte a l a Instalación de Java JDK, de la siguiente manera: # cd /usr/local # ln -s $JAVA_HOME java 2.1.c) Usuarios de Windows: Es probable que el proceso de instalación de Java en Windows continúe e instale los directorios JDK y JRE. (incluso si el JRE no se seleccionó durante el proceso de instalación). La instalación predeterminada instalará los siguientes directorios: C:\Archivos de programa\Java\jdk1.8.0_40\ C:\Archivos de programa\Java\jre1.8.0_40\ Apache "ant" y otros programas Java no funcionan bien con una variable de entorno JAVA_HOME que contiene espacios incrustados (como "C:\Program Files\java\jdk1.8.0_40"). Para evitar esto, Oracle tiene creó un subdirectorio en "C:\ProgramData\Oracle\Java\javapath\" para contener enlaces a varios Java ejecutables sin espacios incrustados, sin embargo, por alguna razón ha omitido el compilador JDK de esta lista. Para corregir esto, necesitamos crear un enlace simbólico de directorio adicional a la instalación de JDK. Ir al menú "Inicio", luego seleccione "Todos los programas", luego "Accesorios", luego haga clic derecho en "Símbolo del sistema" y seleccione "Ejecutar como administrador". Esto proporcionará los privilegios adecuados para crear el enlace simbólico, utilizando los siguientes comandos: cd C:\ProgramData\Oracle\Java\javapath\mklink /D JDK "C:\Archivos de programa\Java\jdk1.8.0_40" La variable del sistema del entorno JAVA_HOME se puede configurar de la siguiente manera (sin espacios incrustados): JAVA_HOME ==> C:\ProgramData\Oracle\Java\javapath\JDK Se puede acceder al editor de variables de entorno desde el menú "Inicio" haciendo clic en "Panel de control", luego "Sistema", luego "Configuración avanzada del sistema", luego "Variables de entorno". La variable del sistema de entorno PATH debe tener el prefijo siguiente %JAVA_HOME%\bin; Los diversos archivos jar de la biblioteca necesarios (es decir, "javax.mail.jar", etc.) deberán copiarse en AMBOS directorios de biblioteca extendida 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 de la biblioteca adicional DEBEN copiarse arrastrando y soltando desde la consola de Windows. intentando para copiarlos desde una ventana del símbolo del sistema puede parecer que se han copiado correctamente, sin embargo, es posible que el tiempo de ejecución de Java aún no pueda acceder a los archivos jar de la biblioteca.
2.2 Soporte de correo Java 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 de descarga debe instalarse en el directorio de la biblioteca extendida de Java como siguiente (se requiere acceso 'root'): # cd /tmp/ # cp javax.mail.jar $JAVA_HOME/jre/lib/ext/. (Donde "/tmp/" es el directorio donde se descomprimió "javax.mail.jar") 2.2.a) Usuarios de Mac OS X: En Mac OS X, el directorio de la biblioteca extendida de Java puede estar en la siguiente ubicación: $JAVA_HOME/lib/ext 2.2.b) Usuarios de Windows: Este archivo jar deberá copiarse en AMBOS directorios de la biblioteca extendida 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 copiarse arrastrando y soltando desde la consola de Windows. Intentar copiarlos de un El símbolo del sistema puede parecer que se han copiado correctamente, sin embargo, es posible que estos archivos jar de la biblioteca no se accesible por el tiempo de ejecución de Java. Esto permitirá que el controlador JavaMail esté disponible para todos los entornos de servlet Tomcat y código Java en ejecución. (Nota importante: asegúrese de que los permisos en los archivos jar de la biblioteca sean legibles en todo el mundo)
2.3 Herramienta de compilación Apache "Ant" Paquete: Hormiga v1.9.4+ 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 'bin' de instalación de Ant se haya agregado a la variable de entorno PATH (consulte a continuación). 2.3.a) Usuarios de Mac OS X: Es probable que la última versión de Ant ya esté instalada en su sistema Mac OS X, por lo que puede que no sea necesario descargue otra copia de Apache Ant. Su versión instalada de Apache Ant puede estar en la siguiente directorio: /usr/compartir/hormiga 2.3.b) Usuarios de Fedora/CentOS Linux: El "Ant" de Fedora/CentOS Apache se puede instalar y utilizar en lugar de descargar la instalación "Ant". directamente desde Apache. El comando para instalar el entorno de compilación "Ant" en Fedora/CentOS es el siguiente (debe ser 'root' para instalar): # yum instalar hormiga
2.4 Contenedor de servlets Tomcat de Apache Paquete: contenedor de servlets Apache Tomcat v7.x 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 de API con versiones anteriores del código Servlet. - Si su versión de distribución de Linux ya viene con una versión de Tomcat instalada, aún así es muy recomendable. que comience con una versión de Tomcat descargada directamente desde el sitio web de Apache. Esto eliminará o reducirá cualquier permisos o problemas de classpath que puedan surgir. Luego, cuando todo esté listo y funcionando correctamente, si elige hacerlo, puede regresar e instalar OpenGTS en la versión de Apache Tomcat que se envió/instaló con su distribución de Linux. 2.4.a) Usuarios de Linux instalando Apache Tomcat descargado: Se recomienda que la instalación manual de Tomcat se instale en el directorio "/usr/local/" ('root' se requerirá acceso para instalar en este directorio). La variable de entorno CATALINA_HOME debe configurarse de la siguiente manera: $ exportar CATALINA_HOME=/usr/local/apache-tomcat-x.xx.xx 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 enlace simbólico "tomcat" en el directorio "/usr/local/" que apunte al Instalación de Tomcat, de la siguiente manera: # cd /usr/local # ln -s $CATALINA_HOME gato Dentro del directorio 'bin' de instalación de Tomcat (es decir, "$CATALINA_HOME/bin"), asegúrese de ejecutar El bit de permisos está establecido en todos los archivos ".sh". Si no se establece, el siguiente comando establecerá el bit de ejecución: $ cd $CATALINA_HOME/papelera $ chmod a+x *.sh Si el bit de ejecución no está configurado en estos archivos, es posible que los comandos "startup.sh" y "shutdown.sh" de Tomcat no se ejecuten. capaz de ejecutar. 2.4.b) Usuarios de Debian/Ubuntu que utilizan Apache Tomcat preinstalado: Recomendamos descargar la versión de Tomcat directamente desde Apache, sin embargo, si aún planea usar el Debian/Ubuntu versión instalada de Tomcat, y sus archivos de registro de Tomcat se están llenando con mensajes "java.security.AccessControlException" al intentar acceder a las propiedades del sistema, entonces puede necesitar crear/editar un archivo de política de Tomcat en el directorio "/etc/tomcat6/policy.d" que contiene el siguiente información (o similar): conceder codeBase "archivo:${catalina.home}/webapps/track/WEB-INF/-" { permiso java.util.PropertyPermission "*", "leer, escribir"; permiso java.security.AllPermission; }; conceder codeBase "archivo:${catalina.home}/webapps/events/WEB-INF/-" { permiso java.util.PropertyPermission "*", "leer, escribir"; permiso java.security.AllPermission; }; conceder codeBase "archivo:${catalina.home}/webapps/mologogo/WEB-INF/-" { permiso java.util.PropertyPermission "*", "leer, escribir"; permiso java.security.AllPermission; }; Asegúrese de que los valores anteriores sean apropiados para su instalación.
2.5 Proveedor de base de datos MySQL Paquete: MySQL v5.X.X URL: http://dev.mysql.com/downloads/mysql/ 2.5.a) Usuarios de Windows: En Windows, descargue/instale el siguiente archivo: mysql-essential-5.X.XX-m2-win64.msi Donde "mysql-essential-5.X.XX-m2-win64.msi" es el nombre de la última instalación de MySQL para windows. 2.5.b) 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: Se puede instalar y usar Fedora/CentOS "MySQL" en lugar de descargar la instalación de "MySQL" directamente desde MySQL. El comando para instalar "MySQL" en Fedora/CentOS es el siguiente (debe ser 'root' para instalar): # yum instalar mysql-servidor mysql Nota: Asegúrese de que el directorio "bin" de instalación de MySQL se haya agregado a la variable de entorno PATH.
2.6 Controlador MySQL JDBC Paquete: Conector MySQL/J v5.1.XX Controlador JDBC URL: http://dev.mysql.com/downloads/connector/j/ Código postal: mysql-conector-java-5.1.XX.zip Nota: Connector/J se distribuye bajo licencia GPL. 2.6.a) Usuarios de Fedora/CentOS Linux: El controlador Fedora/CentOS MySQL JDBC se puede instalar y usar en lugar de descargar MySQL JDBC Instalación del controlador directamente desde MySQL. El comando para instalar "MySQL" en Fedora/CentOS es el siguiente (debe ser 'root' para instalar): # yum instalar mysql-conector-java El archivo jar "mysql-connector-java-5.1.XX.jar" se puede encontrar en la siguiente ubicación: /usr/share/java/mysql-conector-java-5.1.XX.jar (donde "mysql-connector-java-5.1.XX.jar" coincide con el nombre del archivo jar de instalación) El archivo jar "mysql-connector-java-5.1.XX.jar" de este archivo zip descargado debe instalarse en Java. directorio de la biblioteca extendida de la siguiente manera (se requiere acceso 'root'): # cd XXXXXXXX # cp mysql-conector-java-5.1.10-bin.jar $JAVA_HOME/jre/lib/ext/. (donde "XXXXXXXX" es el directorio donde se descomprimió el controlador MySQL JDBC) 2.6.b) Usuarios de Mac OS X: En Mac OS X, el directorio de la biblioteca extendida de Java puede estar en la siguiente ubicación: $JAVA_HOME/lib/ext 2.6.c) Usuarios de Windows: Este archivo jar deberá copiarse en AMBOS directorios de la biblioteca extendida 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 copiarse arrastrando y soltando desde la consola de Windows. El símbolo del sistema puede parecer que se han copiado correctamente, sin embargo, es posible que estos archivos jar de la biblioteca no este accesible por el tiempo de ejecución de Java. Esto permitirá que el controlador JDBC esté disponible para todo el código Java en ejecución y el entorno de servlet de Tomcat.