Asunto: Manual de usuario Fecha: 12 de September de 20122 Elaborado por: BALIDEA CONSULTING & PROGRAMMING Elaborado por: BALIDEA CONSULTING & PROGRAMMING Documento de instalación Santiago, 19 de Septiembre de 2012
CONTROL DE VERSIONES Y DISTRIBUCIÓN Nombre del documento: Codificación del documento: A21L-Documento de instalación Versión: 00.01 A21L-Documento de instalación Elaborado por: Balidea Consulting & Programming Fecha aprobación: 17/12/2012 Descripción del contenido: Autores: El documento contiene los requisitos y pasos para la instalación de la aplicación web <Diputación de la Coruña, y los ayuntamientos de :Carballo, Cambre, Noia, As Pontes, Pontedeume, Arzúa y Bergondo> Licencias: Esta obra está bajo una licencia Creative Commons Attribution-ShareAlike 3.0 Unported License. Para consultar una copia de esta licencia, visite la web http://creativecommons.org/licenses/by-sa/3.0 o remita una carta a Creative Commons, 444 Castro Street, Suite 900, Mountain View, California, 94041, USA. REGISTRO DE CAMBIOS Versión Causa de nueva versión Fecha aprobación 00.01 Elaboración del documento. 17/12/2012 CLÁUSULA DE PROPIEDAD: La propiedad de este documento pertenece al conjunto de entidades locales participantes en el proyecto LOURED (Diputación de la Coruña, y los ayuntamientos de :Carballo, Cambre, Noia, As Pontes, Pontedeume, Arzúa y Bergondo). La información contenida en el mismo deberá de emplearse conforme a la licencia establecida (Creative Commons Attribution-ShareAlike 3.0). 2 / 9
Índice de contenido 1. INTRODUCCIÓN...4 2. REQUISITOS MÍNIMOS DEL SISTEMA...5 2.1. HARDWARE...5 2.2. SOFTWARE...5 3. PROCEDIMIENTO DE INSTALACIÓN...7 3.1. INSTALACIÓN DE JAVA...7 3.2. INSTALACIÓN DEL SERVIDOR WEB...7 3.3. INSTALACIÓN DEL SERVIDOR DE BASE DE DATOS...7 3.4. CREACIÓN DE LA BASE DE DATOS...8 3.5. DESPLIEGUE DE LA APLICACIÓN...8 3.6. CONFIGURACIÓN DE LA APLICACIÓN...8 3 / 9
1. INTRODUCCIÓN Este documento representa una guía de los requisitos necesarios y los pasos a seguir para instalar la aplicación Web. Esta aplicación tiene como finalidad facilitar las tareas de creación de indicadores, en base a distintas fuentes de datos, para diversas aplicaciones, preferentemente Agenda 21 Local. 4 / 9
2. REQUISITOS MÍNIMOS DEL SISTEMA Se detallan a continuación, los requisitos mínimos de Hardware y Software que deben cumplir los elementos del sistema para el correcto funcionamiento de la aplicación. 2.1. HARDWARE Cliente: Mínimo: PC con procesador Pentium III 700 Mhz o equivalente, 512 MB de RAM y 100 MB de espacio libre en disco. Recomendado: Servidor: Mínimo: PC con procesador Pentium IV o superior, 2 GB de RAM y 4 GB de espacio libre en disco. PC con procesador Pentium III 700 Mhz o equivalente, 512 MB de RAM y 4 GB de espacio libre en disco. Recomendado: PC con procesador Pentium IV o superior, 2 GB de RAM y 25 GB de espacio libre en disco. 2.2. SOFTWARE Cliente: Mínimo: Navegador web (Mozilla Firefox 10.0, Google Chrome) Lector de archivos pdf (Adobe Reader, Foxit Reader,... etc) Recomendado: Navegador web (Mozilla Firefox) 5 / 9
Lector de archivos pdf (Adobe Reader, Foxit Reader,... etc) Servidor: Mínimo: JDK - 6u30 Apache Tomcat 5.5 PostgreSQL 9.1 Recomendado: JDK - 6u30 Apache Tomcat 6.0.26 PostgreSQL 9.1.5-1 6 / 9
3. PROCEDIMIENTO DE INSTALACIÓN Cliente: No es necesario ningún tipo de instalación específica en el cliente, para hacer uso de la aplicación tan solo será necesario que disponga de un navegador web y un lector de archivos pdf. Servidor: Para realizar la instalación en el servidor será necesario llevar a cabo los pasos que se detallan a continuación: 3.1. INSTALACIÓN DE JAVA El primer paso comenzará con la instalación del JDK - 6u30 (la versión adecuada para plataformas 32 bits o 64 bits). Se puede seguir este proceso en el video adjunto: Paso1_InstallJDK.wmv. 3.2. INSTALACIÓN DEL SERVIDOR WEB Para la instalación del servidor Apache Tomcat, bastará con seguir los pasos del asistente de instalación; teniendo en cuenta las siguientes consideraciones: Por defecto se utilizará el puerto 8080. Seleccionar que el servidor arranque como servicio de Windows. Seleccionar la instalación de Tomcat basada en dll para obtener un mejor rendimiento. Seleccionar la instalación del Tomcat Host Manager. Seleccionar la ruta en la cual fue instalado el JDK durante el paso anterior. Se puede seguir este proceso en el video adjunto: Paso2_InstallTomcat.wmv. 3.3. INSTALACIÓN DEL SERVIDOR DE BASE DE DATOS Para la instalación del servidor PostgreSQL, bastará con seguir los pasos del asistente de instalación. Por defecto, la instalación se realizará en el puerto 5432. Se puede seguir este proceso en el video adjunto: Paso3_InstallPostgreSQL.wmv. 7 / 9
3.4. CREACIÓN DE LA BASE DE DATOS Para la creación de la base de datos, será necesario ejecutar el script adjunto postgresql9.sql en el servidor PostgreSQL. Se puede seguir este proceso en el video adjunto: Paso4_InstallScripts.wmv. 3.5. DESPLIEGUE DE LA APLICACIÓN Para desplegar la aplicación hay seguir los siguientes pasos: acceder a la web de administración del servidor de aplicaciones http://localhost:8080 (el puerto 8080 es el puerto por defecto, pero puede haber sido seleccionado otro en el proceso de instalación). Seleccionar la opción Tomcat Manager. Dentro de la sección Archivo WAR a desplegar: seleccionar el archivo a21l-res.war y pulsar el botón Desplegar. seleccionar el archivo a21l-web.war y pulsar el botón Desplegar. Se puede seguir este proceso en el video adjunto: Paso5_InstallApp.wmv. 3.6. CONFIGURACIÓN DE LA APLICACIÓN Para finalizar con la instalación, será necesario realizar los siguientes pasos: 1. Configurar el Servidor web de apache para coger el driver de oracle, para ello se copiará el fichero ojdbc-14.jar en el directorio lib del TomCat. 2. Configurar la base de datos que será utilizada por la aplicación: Para ello se editará el fichero de configuración: {Directorio Apache Tomcat}\webapps\a21l-rest\WEB-INF\classes\spring\datasources-context.xml y se establecerán los valores adecuados para conectase a PostgreSQL: <bean id="datasource" class="org.springframework.jdbc.datasource.drivermanagerdatasource" p:driverclassname="org.postgresql.driver" p:url="jdbc:postgresql://localhost:5432/postgres" p:username="123abc." p:password="123abc."/> 8 / 9
3. Configurar la url en la que ha sido desplegada la aplicación: Para ello se editará el fichero de configuración: {Directorio Apache Tomcat}\webapps\a21l-web\WEB-INF\classes\spring\despliegue.properties y se establecerán los valores adecuados: servicio.configuraciongeneral.urlbase=http://localhost:8080/a21l-web/ 4. Configurar el carácter usado para representar el punto decimal para la exportación a CSV. Para ello se modificará la entrada servicio.configuraciongeneral.caracterseparadorcsv ubicada en el fichero de configuración: {Directorio Apache INF\classes\spring\despliegue.properties servicio.configuraciongeneral.urlbasesw=http://localhost:8080/a21lrest/rest Tomcat}\webapps\a21l-rest\WEB- 5. Configurar los parametros para el acceso al catálogo del sistema: Para ello se editará el fichero de configuración: {Directorio Apache Tomcat}\webapps\a21l-rest\WEB-INF\classes\spring\despliegue.properties y se establecerán los valores adecuados para las siguientes entradas: servicio.configuraciongeneral.catalogourl: se establecerá la cadena de conesión a la BD del catálogo un ejemplo sería: servicio.configuraciongeneral.catalogourl=jdbc:postgresql://servercat alogo:4423/dbcatalogo servicio.configuraciongeneral.catalogonome: se establecerá el nombre del catálogo o fuente interna. Un ejemplo sería: servicio.configuraciongeneral.catalogonome=dbcatalogo servicio.configuraciongeneral.catalogouser: se establecerá el nombre de usuario para conectarse a la BD del catálogo. Un ejemplo sería: servicio.configuraciongeneral.catalogouser=admin servicio.configuraciongeneral.catalogopass: se establecerá la password de usuario para conectarse a la BD del catálogo. Un ejemplo sería: servicio.configuraciongeneral.catalogopass=passuser213 servicio.configuraciongeneral.catalogodata: se establecerá la fecha para la creación del catalogo en la aplicación. Un ejemplo sería: servicio.configuraciongeneral.catalogodata=29-10-2012 Nota: Si se desea cambiar el catálogo interno, a mayores de cambiar estas propiedades, se requiere estos dos pasos: borrar la entrada de la BD y reiniciar el Tomcat. 9 / 9