PR Plataforma JasperServer Manual de instalación para JasperServer 3.5

Transcripción

1 PR Plataforma JasperServer Manual de instalación para JasperServer 3.5 Edición: 01 1/16 02/12/2009

2 00 Control del documento 00.1 Información general PR Manual de instalación para JasperServer Funcional Técnico Título PR MIA doc Jefe de proyecto Benjamín García Benjamín García A revisar por Antonio Carro Antonio Carro A aprobar por Antonio Carro Antonio Carro 00.2 Lista de distribución Nombre Puesto Departamento Observaciones Antonio Carro Gerente Treelogic Consulting Benjamín García Alfonso Fernández Jefe de Proyecto Consultor Senior Treelogic Consulting Treelogic Consulting antonio.carro@treelogic.com benjamin.garcia@treelo gic.com alfonso.fernandez@tree logic.com 00.3 Histórico de revisiones Versión Fecha Departamento Autor Observaciones Treelogic Consulting Treelogic Consulting Benjamín García Benjamín García 00.4 Estado del documento Versión Fecha Estado Responsable Firma Borrador Benjamín García Borrador Benjamín García Edición: 01 2/16 02/12/2009

3 01 Índice 00 Control del documento Información general Lista de distribución Histórico de revisiones Estado del documento Índice Introducción Instalación JasperServer Introducción Pasos a seguir Iniciando sesión en JasperServer Desinstalando JasperServer Instalación de la API Introducción Pasos a seguir Anexos Procesos utilizados por la plataforma JasperServer Arrancando y parando JasperServer Ubicación de Logs Iniciando sesión en MySQL Backup MySQL Configurando datasources en JasperServer Oracle Referencias Edición: 01 3/16 02/12/2009

4 02 Introducción En este manual se detallan los pasos a seguir para la instalación del servidor de informes JasperServer 3.5 y la API de invocación al mismo. Estas instrucciones son válidas para un Linux Debian 4.0 y OpenSuse 11. Edición: 01 4/16 02/12/2009

5 03 Instalación JasperServer 03.1 Introducción La instalación de JasperServer se efectuará conforme a los pasos definidos en el siguiente punto abriendo un terminal de acceso a la máquina sobre la que se realizará la instalación Pasos a seguir A continuación se describen los pasos seguidos para la instalación del sistema: 1. Añadir un nuevo grupo de seguridad mysql al sistema. groupadd mysql 2. Descargar el instalador de la versión 3.5 de JasperServer. Para esto utilizaremos el comando Wget: Wget % / jasperserver linux-installer.bin/download Ilustración 1. Descargar instalador 3. Aceptar licencia. Finalizada la descarga acceder a la ruta en la que se ha descargado el instalador y ejecutar el siguiente comando:./jasperserver linux-installer.bin NOTA: Puede ser necesario la asignación de permisos de ejecución al instalador. Edición: 01 5/16 02/12/2009

6 Tras la ejecución de este comando se mostrará el contrato de licencia el cual tiene que aceptar para continuar con la instalación, mostrándose una pantalla de confirmación como la que se muestra en la siguiente ilustración: Ilustración 2. Aceptar licencia 4. Indicar directorio de instalación. Se indica el directorio de instalación del servidor de informes, por defecto /opt/jasperserver ([rootinstallserver] en adelante). Ilustración 3. Indicar directorio instalación 5. Configurar la instalación. Una vez indicado el [rootinstallserver] se continuará con la configuración del modo de instalación de Apache Tomcat y MySQL, el instalador en ambas ocasiones permite elegir si deseamos instalar ambos productos a partir de los bundles que incluye o bien utilizar los productos previamente instalados de forma Edición: 01 6/16 02/12/2009

7 independiente. La opción seleccionada en este caso es la primera, con lo que se instalarán las versiones de Apache Tomcat 5.5 y MySQL 5.0 incluidas en el instalador, seleccionando la primera opción en la ventana de confirmación tanto para Tomcat como para MySQL. Ilustración 4. Configurando instalación Durante la configuración de estos dos pasos se nos indicará el puerto de instalación de Tomcat y MySQL. La opción seleccionada en este caso ha sido la asignación de puertos por defecto, el puerto 8080 para Tomcat y 3306 para MySQL. El usuario de acceso por defecto a MySQL es jasperdb con la contraseña password. Ilustración 5. Configurando puertos Edición: 01 7/16 02/12/2009

8 En el siguiente paso se indicará si se desean instalar datos de ejemplo los cuales hemos optado por instalar. Ilustración 6. Instalando ejemplos A continuación se indica la posibilidad de instalar ireport 3.5.0, una herramienta gráfica para el diseño de informes. Se opta por su instalación. Ilustración 7. Instalando ireport 6. Instalar JasperServer Finalizada la configuración se procederá a la instalación del servidor de informes previa confirmación por parte del usuario. Edición: 01 8/16 02/12/2009

9 Ilustración 8. Confirmando instalación 7. Fin de la instalación. Una vez finalizada la instalación podremos acceder al servidor de informes del siguiente modo: Donde [host] indica la máquina en la que hemos instalado el servidor. Ilustración 9. Página inicial JasperServer Por último y opcionalmente, se podría añadir al arranque del sistema un script que nos permita parar y arrancar el servidor de informes JasperServer. Edición: 01 9/16 02/12/2009

10 #!/bin/sh # Inicia el JasperServer case "$1" in 'start') /opt/jasperserver-3.5.0/jasperctl.sh start ;; 'stop') /opt/jasperserver-3.5.0/jasperctl.sh stop ;; *) echo "Usage: $0 { start stop }" ;; esac exit Iniciando sesión en JasperServer Una vez finalizada la instalación y validado el correcto funcionamiento del servidor podremos iniciar sesión en JasperServer accediendo a través de la URL donde [host] representa la máquina en la que se ha instalado el servidor y 8080 es el puerto configurado para Apache Tomcat. Si no ocurre ningún problema, aparecerá la página inicial de acceso en la que el usuario podrá autenticarse en el sistema introduciendo los siguientes datos: Usuario: jasperadmin (Usuario administrador) Contraseña: jasperadmin Si se ha optado por instalar los datos de ejemplo adicionalmente se crearán nuevos usuarios finales. Estos usuarios no son usuarios administradores con lo que tienen menos privilegios que el usuario administrado, los datos de acceso son los siguientes: Usuario: joeuser Contraseña: joeuser Edición: 01 10/16 02/12/2009

11 03.4 Desinstalando JasperServer PR Manual de instalación para JasperServer El directorio de instalación [rootinstallserver] incluye un ejecutable que permite desinstalar el servidor de informes JasperServer. Para su utilización debe ubicarse en el directorio de instalación [rootinstallserver] y ejecutar el siguiente comando:./uninstall Se le preguntará si desea eliminar JasperServer del sistema con lo que para completar la desinstalación deberá presionar la tecla Y. Edición: 01 11/16 02/12/2009

12 04 Instalación de la API 04.1 Introducción La instalación de la API desarrollada para la invocación al servidor JasperServer se llevará a cabo conforme a los pasos definidos en el siguiente punto Pasos a seguir A continuación se describen los pasos necesarios para la instalación de la API: 1. Ubicar el.jar de la API (es.xunta.edu.jasperserver.api.jar) en un directorio origen, por defecto hemos seleccionado /opt/api ([rootinstallapi] en adelante) 2. Ubicar las dependencias de la API en la ruta [rootinstallapi]/libs. 3. Los scripts para la ejecución de los comandos de la API estarán almacenados en [rootinstallapi]/scripts. Copiar los ".sh" a esta carpeta. 4. Definir las siguientes variables de entorno en el sistema: JAVA_HOME='[directorio jdk_1.5] PATH=$PATH:${JAVA_HOME}/bin JRE_HOME=${JAVA_HOME}/jre JASPERSERVER_API='/opt/api/es.xunta.edu.utils.jasperserver.api-x.x.x.jar ' JASPERSERVER_USER='jasperadmin' JASPERSERVER_PASSWORD='jasperadmin' Donde [jdk_1.5] indica el directorio donde se encuentra ubicada la jdk_1.5. Si realizamos la instalación de la API y el servidor Jasper Server en la misma máquina en la ubicación indicada por defecto, podremos definir la variable JAVA_HOME como se describe a continuación: JAVA_HOME=' /opt/jasperserver-3.5.0/java Edición: 01 12/16 02/12/2009

13 05 Anexos 05.1 Procesos utilizados por la plataforma JasperServer Se han monitorizado el número de procesos que ejecuta JasperServer tanto en condiciones normales como en condiciones de saturación. Estos procesos no varían según la carga de trabajo que tenga la plataforma y pueden observarse ejecutando el comando ps de unix. Ilustración 10. Procesos en ejecución Los procesos lanzados por JasperServer son tres y pueden identificarse en la lista de procesos activos por los siguientes valores bajo la columna CMD: /bin/sh /opt/jasperserver-3.5.0/mysql/bin/mysqld_safe /opt/jasperserver-3.5.0/mysql/bin/mysqld /opt/jasperserver-3.5.0/java/bin/java Durante la realización de este estudio no se ha observado ningún hilo ni proceso en estado inconsistente (Stopped o Zombie). Si, en algún caso, fuese necesaria la interrupción manual de algún hilo o proceso, esto podría lograrse utilizando el comando de Linux: Kill -9 pid (siendo pid el identificador del proceso). Edición: 01 13/16 02/12/2009

14 05.2 Arrancando y parando JasperServer PR Manual de instalación para JasperServer Para restaurar el sistema, la plataforma cuenta con un script (jasperctl.sh) dentro del directorio de instalación jasperserver que permite arrancar y parar todo el entorno. Los comandos a ejecutar para el arranque y la parada del sistema serían los siguientes:./ jasperctl.sh start./ jasperctl.sh stop 05.3 Ubicación de Logs Dos son los archivos log a observar para el control de errores. El primero registra los errores pertenecientes al servidor JasperServer. El segundo, es el log asociado al API. Las rutas donde se encuentran estos logs son las siguientes: Log JasperServer: [rootinstallserver]/apache-tomcat/webapps/jasperserver/ WEB- INF/logs/jasperserver.log. Puede configurarse el nivel de depuración modificando el fichero log4j.properties desde la ubicación [rootinstallserver]/apachetomcat/webapps/jasperserver/web-inf/log4j.properties, por defecto jasperserver solo muestra información sobre errores y avisos. Log API: [rootinstallapi]/scripts/logfile.log. Puede configurarse el nivel de depuración modificando el fichero log4j.properties incluido en el archivo log4j jar. Adicionalmente pueden consultarse los logs del servidor de aplicaciones (por defecto en la ubicación [rootinstallserver]/apache-tomcat/logs/) y de la base de datos instalada para obtener información sobre el propio JasperServer Iniciando sesión en MySQL Por defecto se instala un MySQL que contiene el modelo de datos de la plataforma JasperServer, puede acceder a él desde la línea de comandos utilizando el usuario jasperdb del siguiente modo: <mysql>/bin/mysql -u jasperdb -p or <mysql>/bin/mysql -u root -p El instalador crea el usuario jasperdb que responde bajo la contraseña password. Edición: 01 14/16 02/12/2009

15 05.5 Backup MySQL Se recomienda para salvaguardar los datos almacenados realizar periódicamente copias de seguridad de la base de datos. La copia de seguridad podrá realizarse utilizando el comando mysqldump. La sentencia a ejecutar sería mysqldump -u<username> -p<password> <database name> > <output file>. Para restaurar una copia de seguridad será necesario ejecutar: mysql -u<username> - p<password> <database name> < <input file>. Una buena práctica es crear un script y ejecutarlo regularmente a través de cron o de cualquier otra herramienta de planificación de tareas Configurando datasources en JasperServer Oracle Para configurar la plataforma de generación de informes JasperServer permitiendo la creación de datasources en Oracle 10 tenemos que realizar los siguientes pasos: 1. Copiar el archivo ojdbc14.jar en la ubicación [rootinstallserver]/apachetomcat/common/lib para que el servidor pueda cargar el driver JDBC de Oracle. Este paso es necesario tanto para el acceso a datasources mediante jdbc como jndi, los siguientes pasos recogen la configuración para datasources jndi. 2. Editar el fichero context.xml ubicado en la ruta [rootinstallserver]/apachetomcat/webapps/jasperserver/meta-inf añadiendo el siguiente recurso <Resource name="jdbc/oracleds" auth="container" driverclassname="oracle.jdbc.oracledriver" type="javax.sql.datasource" url="jdbc:oracle:thin:@[host]:1521:[dbname]" username="user" password="pass" maxactive="100" maxidle="30" maxwait="10000"/> Donde [host] indica la ip de la máquina en la que se ha instalado Oracle y [dbname] el nombre de la base de datos. 3. Editar el fichero web.xml ubicado en la ruta [rootinstallserver]/apachetomcat/webapps/jasperserver/web-inf añadiendo la siguiente configuración: Edición: 01 15/16 02/12/2009

16 <resource-ref> <description>oracle Datasource example</description> <res-ref-name>jdbc/oracleds</res-ref-name> <res-type>javax.sql.datasource</res-type> <res-auth>container</res-auth> </resource-ref> 4. Una vez finalizada esta configuración se podrán crear datasources cuyo origen sea Oracle haciendo uso del script correspondiente (ver manual de usuario). 06 Referencias Puede obtener mas información sobre la instalación y administración de JasperServer 3.5 consultando la guía de instalación JasperServer-Install-Guide.pdf incluida en los entregables en el apartado Documentación. Edición: 01 16/16 02/12/2009