Manual de Instalación Aplicación Web y Móvil Diego Andrés Casas Avellaneda Versión 1.0
1
Historial de cambios Versión
Fecha
0.1 1.0
23/11/2012 30/11/2012
Sección del documento Secciones 1 y 2 Secciones 1, 2, 3, 4, 5
2
Descripción de cambios Creación de sección Lanzamiento de documento
Tabla de contenido
Historial de cambios .............................................................................................................................. 2 Tabla de contenido................................................................................................................................ 3 Tabla de ilustraciones............................................................................................................................ 4 1.
PROCESO DE INSTALACIÓN ................................................................................................................... 6 1.
Instalación de Base de Datos .................................................................................................... 6
2.
Creación de la Base de Datos SIMEV preconfigurada ............................................................... 6
3.
Instalación de GlassFish Server Open Source Edition ............................................................... 6
4.
Configuración del ambiente de producción .............................................................................. 6
5.
a.
Instalación del driver MySQL connector. .............................................................................. 6
b.
Ingreso al ambiente de producción ...................................................................................... 6
c.
Creación del Connection Pool ............................................................................................... 6 Despliegue de la aplicación ....................................................................................................... 9
3
Tabla de ilustraciones Ilustración 1 - Creación de un nuevo conjunto de conexiones ............................................................. 7 Ilustración 2 - Propiedades adicionales del conjunto de conexiones ................................................... 7 Ilustración 3 - Confirmación de ping de la configuración del conjunto de conexiones ........................ 8
4
1. Introducción 1.1. Propósito Objetivo del documento: Explicar los pasos de instalación y despliegue de la aplicación web de SIMEV.
Razón del documento: El presente documento tiene como objetivo principal explicar los pasos de la instalación de la aplicación web del sistema empleando los requerimientos y casos de uso especificados en el Documento de Especificación de Software
Audiencia: El documento está dirigido a cualquier persona con conocimientos en administración de tecnologías de información (TI), que esté familiarizado con Java EE 6 y los productos Oracle Glassfish OpenSource Edition y MySQL Community Edition.
1.2. Alcance El presente documento abarca los siguientes temas:
Instalación de la base de datos MySQL y el servidor de aplicación Glassfish. Configuración del servidor de aplicaciones para desplegar correctamente la aplicación.
5
PROCESO DE INSTALACIÓN APLICACIÓN WEB 1. Instalación de Base de Datos Para instalar MySQL Server realice la descarga del instalador http://dev.mysql.com/tech-resources/articles/mysql-installer-for-windows.html Microsoft Windows. En caso contrario descargue http://dev.mysql.com/downloads/workbench/5.2.html
desde: para desde:
En el momento de realizar la instalación ingrese la contraseña del root (usuario principal) de la base de datos, recuerde la contraseña para los pasos posteriores y cámbiela con regularidad.
2. Creación de la Base de Datos SIMEV preconfigurada En la consola de MySQL Server o a través de MySQL Workbench ejecute las sentencias que se localizan en el archivo SIMEV.mwb. Si desea ver el diagrama de tablas de la base de datos, abra con MySQL Workbench el archivo SIMEV.mwb.
3. Instalación de GlassFish Server Open Source Edition Descargue desde http://glassfish.java.net/public/downloadsindex.html#top GlassFish Server Open Source Edition 3.1.2 y siga las instrucciones de instalación. Recuerde configurar durante la instalación el dominio como domain1. También se configurará la cuenta administrativa, a la cual debe asignársele un usuario y una contraseña, las cuales debe recordar para ingresar al ambiente de producción.
4. Configuración del ambiente de producción a. Instalación del driver MySQL connector. Instale el driver MySQL localizado en el sitio oficial de MySQL copiándolo en la carpeta lib de la instalación de GlassFish. Reinicie GlassFish para actualizar los cambios. b. Ingreso al ambiente de producción En el explorador web del servidor ingrese a http://localhost:4848, espere a que se inicialice la consola de administración e ingrese el usuario y la contraseña. c. Creación del Connection Pool Para establecer la comunicación entre la aplicación y la base de datos es necesario establecer un Pool de conexiones que administrará el servidor de aplicaciones. Para tal fin ingrese a Resources/JDBC/JDBC Connection Pools y cree un nuevo Pool de conexiones.
6
Ilustración 1 - Creación de un nuevo conjunto de conexiones
En el Pool Name ingrese simev_origen, debido a que así se encuentra configurado el JNDI (Interfaz de Nombrado y Directorio de Java). Configure el tipo de recurso y el proveedor de la base de datos como se encuentra en la figura.
Ilustración 2 - Propiedades adicionales del conjunto de conexiones
El nombre de la base de datos es: simev El nombre del servidor es: localhost (si pertenece algún dominio específico se debe configurar el nombre completo del servidor en el dominio ej.: simev.javeriana.edu.co) El usuario es: root La contraseña es la misma que se empleó en la instalación de MySQL Server. Al final compruebe que la conexión se realizó correctamente en la pestaña General realizando un Ping a la Base de Datos. El resultado debe ser exitoso. De lo contrario revise nuevamente toda la configuración.
7
Ilustración 3 - Confirmación de ping de la configuración del conjunto de conexiones
8
5. Despliegue de la aplicación Después de realizar las labores de configuración se procederá al despliegue final de la aplicación, para que pueda ser ejecutada en el servidor. Para tal fin ingrese a Applications/Deploy. En Deploy, seleccione el archivo del cual desea hacer el despliegue para subirlo al servidor. Para descargar el archivo haga clic aquí. Seleccione en tipo Web Application. En la propiedad State seleccione Activate. En la propiedad Available seleccione Activate Después haga clic en Accept. Espere unos momentos y la aplicación quedará completamente desplegada y lista para su uso.
9
PROCESO DE INSTALACIÓN APLICACIÓN MÓVIL 1. Descarga de la aplicación Para descargar el archivo SIMEV.apk haga clic aquí. Se requiere una aplicación de apoyo debido a que SIMEV no se ha registrado en Google Play para realizar la instalación. Antes de instalar la aplicación descargue e instale AppInstaller en su dispositivo móvil desde Google Play para realizar la instalación.
2. Instalación Después de realizar la instalación de AppInstaller, por favor transfiera el archivo SIMEV.apk a la memoria SD del dispositivo. Ingrese a AppInstaller y localice el archivo en la ubicación donde se transfirió en la memoria, pulse sobre el archivo una vez y seleccione la opción Instalar. Siga las instrucciones en pantalla y la instalación se instalará correctamente para su uso.