Sie sind auf Seite 1von 30

OPEN LOCAL Sistema open gestin

source de Municipal

Manual de Instalacin
141310244

MAD001 Versin 1.0

10/10/08

MAD: OPEN LOCAL

Sumario Documento
Ttulo Archiv o Proyec to Versi n Versi n 1.0 Manual de Instalacin Open Local: Sistema open source de gestin
Municipal 141310244.odt

1.0

Autor

e-gim

Propietar Diputacin Provincial Jan io

Registro de Cambios
Fecha
10/10/0 8

Cambio Versin inicial del documento

Pg. 2 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

ndice
1 INTRODUCCIN........................................................................................... 4 2 REQUISITOS DE INSTALACIN...................................................................... 5 2.1 REQUISITOS HARDWARE...................................................................................................... 5 2.2 REQUISITOS SOFTWARE ..................................................................................................... 6 2.2.1. REQUISITOS SOBRE SISTEMAS OPERATIVOS WINDOWS............................................................ 6 2.2.2. REQUISITOS SOBRE SISTEMAS OPERATIVOS LINUX/UNIX............................................................ 7 3 INSTALACIN DE LA APLICACIN................................................................. 8 3.1 DIRECTORIOS DE INSTALACIN.............................................................................................. 10 3.2 INSTALACIN Y CONFIGURACIN DEL SERVIDOR DE APLICACIONES..................................................... 12 3.3 CONFIGURACIN DE HERRAMIENTAS EXTERNAS ......................................................................... 13 3.4 CONFIGURACIN DE LA ENTIDAD.......................................................................................... 14 3.5 CONFIGURACIN DE LA BASE DE DATOS................................................................................. 15 3.6 SELECCIN DE MDULOS.................................................................................................. 17 3.7 FINALIZACIN................................................................................................................ 17 4 MANTENIMIENTO DE LA APLICACIN.......................................................... 19 4.1 4.1 REPARAR APLICACIN................................................................................................. 20 4.2 4.2 AGREGAR O QUITAR COMPONENTES................................................................................. 20 4.3 ACTUALIZACIN DE LA APLICACIN........................................................................................ 21 4.4 COPIA DE SEGURIDAD DE BASE DE DATOS............................................................................... 22 4.5 COPIA DE SEGURIDAD DE LA APLICACIN................................................................................. 23 4.6 VALIDAR MODELO DE DATOS.............................................................................................. 24 5 EJECUCIN EN EL EQUIPO CLIENTE............................................................. 25 5.1 DESCARGA DE FUENTES PARA CDIGOS DE BARRAS.................................................................... 28 6 DESINSTALACIN....................................................................................... 29

Pg. 3 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

Introduccin

La herramienta de instalacin tiene como objetivo guiar al usuario en la configuracin y puesta en marcha de la aplicacin e-sijad v1.0. Los componentes que se instalarn sern los siguientes: Servidor de Aplicaciones Jboss 4.2.2-GA Motor de Base de Datos MySQL 5 Aplicacin e-sijad v1.0 El programa de instalacin configurar el Servidor de Aplicaciones y crear el modelo de datos necesario para el correcto funcionamiento de la aplicacin. Se establece como requisito previo que en el equipo se hayan configurado los siguientes componentes software:

Mquina virtual Java 6.

Este instalador ha sido evaluado sobre los siguientes sistemas operativos: Windows XP Windows 2000 Server Windows 2003 Server Linux Ubuntu Server 8.04 LTS Linux Ubuntu Desktop 8.04 LTS Linux Suse 10 Solaris

Pg. 4 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

2 Requisitos de Instalacin
2.1 Requisitos Hardware
Los servidores necesarios, as como sus caractersticas mnimas, se detallan a continuacin. Estos servidores lgicos pueden instalarse en un mismo equipo fsico.

Servidor de Datos: se encargar de suministrar soporte fsico al motor de BD. Los requisitos crticos para este equipo son:

Procesador basado en tecnologa Intel Xeon / DualCore / 64bits similar Memoria RAM de 2 Gb Discos Duros SCSI (10k-15k rpm) / SATA de alto rendimiento Sistema Operativo: Windows 2000/2003 Server, Linux (Ubuntu, RedHat, SuSE)

Servidor de Aplicaciones: debe suministrar soporte fsico a la lgica de negocio del sistema, siendo el responsable de ejecutar todas las operaciones de servidor previstas en el sistema. Los requisitos crticos para este equipo son:

Procesador basado en tecnologa Intel Xeon / DualCore / 64bits similar Memoria RAM de 2 Gb Discos Duros SCSI / SATA de alto rendimiento Sistema Operativo: Windows 2000/2003 Server, Linux (Ubuntu, RedHat, SuSE)

Puesto(s) de Trabajo:

Pentium IV superior Memoria RAM 512 Mb Disco Duro: 80 Gb

Pg. 5 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

Sistema Operativo: Windows 2000/XP, Linux (Ubuntu, RedHat)

2.2 Requisitos Software


2.2.1. Requisitos sobre Sistemas Operativos Windows

Mquina virtual Java: se establece como requisito indispensable que en el


equipo se encuentre configurada una Mquina Virtual Java 1.6.0_10. En aquellos casos en los que la mquina virtual est configurada pero no tiene asociada una variable de entorno en el sistema, el asistente de instalacin solicitar al usuario la ruta del fichero java.exe. En estos casos, ser necesario crear la variable de entorno JAVA_HOME para el correcto funcionamiento del servidor. De este modo, desde el panel de control del sistema en la seccin dedicada a Variables de Entorno, crearemos una nueva variable llamada JAVA_HOME, cuyo valor ser el directorio de instalacin java.

Gestor de Base de Datos: la instalacin de MySQL se lanzar, en sistemas Windows, si no se detecta ninguna versin instalada en el equipo. Otro de los requisitos del programa de instalacin es la utilizacin de
un motor de MySQL en su versin 5 si el usuario desea realizar la instalacin de la Base de Datos de la aplicacin. Dependiendo del sistema, podra ser necesario reiniciar el programa de instalacin tras instalar el motor de base de datos. Si el Asistente de Instalacin no detecta el motor de base de datos y ste se encuentra correctamente instalado, deber comprobar que el archivo ejecutable 'mysql.exe' se encuentra correctamente configurado en el path del sistema. Si el usuario decide la utilizacin de un motor distinto a MySQL, como SqlServer y Oracle, debe tener en cuenta que el programa de instalacin no se ejecutar de forma automtica y deber cerciorarse de su correcta instalacin y configuracin antes de crear el modelo de datos.

Pg. 6 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

Se recomienda que al usuario administrador creado en el proceso de instalacin le sea establecida una contrasea, para evitar as problemas en la creacin del modelo de datos de la aplicacin.

2.2.2. Requisitos sobre sistemas operativos Linux/Unix.

Mquina virtual Java: algunas distribuciones Linux incorporan herramientas para la ejecucin de aplicaciones Java. Se establece como requisito que la ejecucin de la aplicacin e-SIJAD se realizar sobre una mquina virtual Java 1.6.0_10. Si tras la instalacin de la mquina virtual y su posterior configuracin, existieran problemas en la ejecucin del Servidor de Aplicaciones, edite el archivo ' run.conf ' ubicado en la carpeta 'bin' del directorio de instalacin de JBoss incluyendo la siguiente lnea en la seccin dedicada a establecer la variable JAVA_HOME: JAVA_HOME= directorio instalacin Java

Gestor de Base de Datos: el Asistente no lanzar este instalador. Deber ser preinstalado atendiendo a las caractersticas concretas de la distribucin. El uso del motor MySQL en su versin 5, Oracle o SqlServer se establecen como requisito para la creacin del modelo de datos de OpenLocal. Dada la variedad de distribuciones Linux se aconseja la instalacin del motor de Base de Datos mediante el uso del gestor de paquetes de la propia distribucin. Tras la instalacin del motor de Base de Datos, y en el caso de MySQL, es necesario comprobar que el comando 'mysql' es reconocido por el path del sistema. Se ha detectado que en distribuciones SUSE 10 es necesario modificar el archivo my.cnf, incluyendo la siguiente lnea en la seccin dedicada al cliente: [client] loose-local-infile = 1

Pg. 7 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

3 Instalacin de la Aplicacin
La instalacin del producto e-SIJAD sobre plataformas Unix/Linux permite la modalidad de instalacin en modo consola. Para utilizar esta caracterstica ser necesario incluir el parmetro '- c' en la sintaxis del comando de ejecucin. Este comando se ayuda de un fichero auxiliar ubicado en el CD de instalacin llamado inst.properties, que deber ser editado indicando los parmetros obligatorios de instalacin. ./e-SIJAD_unix_1_0.sh -c
Parmetro Obligatorio # Directorio de instalacin: Ruta en la se instalar la aplicacin # Directorio Intercambio: Ruta en la que se depositan los ficheros generados por la aplicacin. # Directorio Descriptores: Ruta en la que se ubican los ficheros de equivalencia para el intercambio de informacin con otros organismos. # Directorio Plantillas: Ruta en la que se encuntran las plantillas que utiliza el sistema # Directorio Instalacin BB.DD: Lugar en el que se instalar la Base de Datos # Directorio Spooler: Ruta en la que se depititarn los archivos de spooler # Directorio Textos: Lugar en el que el sistema deposita los ficheros TXT que se generan # Directorio Temporal: Directorio para ficheros temporales creados por el sistema DIR_TEMP=/root/e-SIJAD/temp DIR_TEXTOS=/root/e-SIJAD/textos DIR_SPOOLER=/root/e-SIJAD/spooler DIR_INSTALAR=/root/e-SIJAD/instalar DIR_INTERCAMBIO=/root/eSIJAD/intercambio Valor por defecto DIR_INSTALACION=/root/e-SIJAD

DIR_DESCRIPTORES=/root/eSIJAD/descriptores

DIR_FORMATOS=/root/e-SIJAD/formatos

Pg. 8 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

Parmetro Obligatorio # Ubicacin Servidor (JBOSS) # Nombre Mquina # Memoria Virtual

Valor por defecto JBOSS=/srv/jboss NOM_MAQUINA=localhost MinValor=64 maxValor=128

# Tipo de Accesos: Los valores posibles son RMI HTTP. # Nmero de colas jms # Configuracin de los puertos:

ACCESO=RMI

numColas=100 PUERTO=PRINCIPAL

el atributo 'puerto' puede tener los valores PUERTO_NUM=8080 PRINCIPAL DESPLAZAMIENTO

Si la instalacin se realiza en modo grfico el programa de instalacin de e-SIJAD guiar al usuario paso a paso en el proceso de configuracin de la aplicacin a travs de un asistente. A continuacin, se describen las pantallas que intervienen en este proceso.

Pg. 9 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

3.1 Directorios de Instalacin


Tras la pantalla de bienvenida, se mostrarn las opciones de instalacin. El usuario puede optar por realizar una instalacin completa de la aplicacin o ejecutar una simulacin de la misma.

La opcin de simulacin revisar los procedimientos ms importantes de la instalacin aunque no ejecutar ninguna accin. Esta opcin ser til para comprobar posibles errores en la instalacin. Tras la pantalla de bienvenida, se mostrar el directorio destino. Este directorio contendr los componentes necesarios para la correcta instalacin de la aplicacin.

Pg. 10 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

El siguiente paso ser indicar los directorios de trabajo de la aplicacin. Todos estos directorios se crearn en base a un directorio local o, si se desea, se podrn personalizar cada uno de ellos de forma individualizada.

Pg. 11 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

3.2 Instalacin y Configuracin del Servidor de Aplicaciones


El programa de instalacin instala y configura el Servidor de Aplicaciones JBoss, concretamente la versin 4.2.2-GA. A continuacin se muestra la pantalla dedicada a tal efecto y se describen los parmetros que intervienen en ella.

Ubicacin Servidor: Se debe indicar el directorio local sobre el que ser instalado el servidor de Aplicaciones.

Nombre Mquina: Este parmetro se utilizar para identificar el servidor de aplicaciones. Su valor por defecto ser el nombre del equipo donde se est ejecutando la instalacin, aunque este valor podr ser sustituido por otro identificador, como su direccin IP o su nombre de dominio.

Memoria VM Servidor: Indica la memoria que ser asignada a la mquina virtual del Servidor.

Tipo de Acceso: Aqu se establecer la forma en la que el cliente acceder a la aplicacin.

N Colas JMS: Nmero de colas asignadas para los usuarios de la aplicacin. Configuracin Puertos: Se indicar el puerto por el que la aplicacin ser servida.
Indicar Zona Horaria: Establece la zona horaria con la que trabajar el

servidor.

Instalar JBoss como servicio: Utilizado en Sistemas Operativos Windows.

Configura el inicio del servidor de aplicaciones como un servicio interno del sistema operativo.

Pg. 12 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

3.3 Configuracin de Herramientas Externas


La aplicacin est preparada para interactuar con herramientas externas. Estas herramientas son independientes de la aplicacin y actan como pluging's de la misma. El programa de instalacin permite configurar los datos de conexin a estas herramientas, aunque si stas no se encuentran instaladas el usuario podr continuar la instalacin sin modificar ninguno de estos parmetros.

Pg. 13 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

3.4 Configuracin de la Entidad


Las siguientes pantallas estn dedicadas a la configuracin de todos aquellos datos y parmetros que ayudan a definir las caractersticas de una Administracin Pblica. Cada uno de estos valores podr ser modificado desde el mdulo de configuracin de la aplicacin, una vez que sta se encuentre instalada en su mquina.

Pg. 14 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

3.5 Configuracin de la Base de Datos


La pantalla de configuracin de Base de Datos muestra los parmetros necesarios para definir el acceso al modelo de datos de la aplicacin, as como la configuracin que deber incluir el Servidor de Aplicaciones para el citado acceso. A continuacin se describen las variables involucradas en esta configuracin. Origen de Datos: Nombre que se asignar al conjunto de parmetros. Motor: Se indicar el motor de Base de Datos (MYSQL, SQLSERVER, ORACLE). Servidor: Nombre de dominio o Direccin IP de la mquina en la que reside o se instalar el motor. Puerto: Se cargar por defecto segn el motor seleccionado. Base de Datos: nombre del esquema de Base de Datos a crear o sobre el que trabajar si ya se encuentra creado. Datos de Autenticacin: Se indicar un usuario y contrasea vlidos para el servidor de Base de Datos indicado. Si la opcin crear base de datos se encuentra seleccionada los datos que introduzca para la autenticacin en la base de datos deben tener privilegios para realizar la citada tarea. Si alguno de estos datos es incorrecto no ser posible la conexin con la base de datos, lo que provocar que el esquema no sea creado y que se muestre un aviso. Nmero de Conexiones: Indica el nmero de conexiones que soportar el origen de datos establecido. Crear Base de Datos: Este flag indica la creacin o no de un esquema de base de datos en el servidor indicado.

Pg. 15 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

Una vez establecidos los valores ser necesario presionar el botn insertar para que stos se almacenen en la tabla. Si no existiera ningn motor de Base de Datos MySQL configurado en su mquina, el programa de instalacin ofrecer la opcin de instalar el que se ubica en el CD de Instalacin. Para el caso de sistemas operativos Unix se recomienda que la instalacin del motor se lleve a cabo mediante el gestor de paquetes de la propia distribucin. Para los motores Oracle y SqlServer ser el usuario el encargado de su instalacin y configuracin, estableciendo todos aquellos parmetros necesarios para que el programa de instalacin pueda conectar con el servidor de datos y crear el modelo de datos de e-SIJAD.
NOTA: es necesario que el usuario de BBDD tenga asociado una contrasea. En el caso de que no exista clave asociada, en MySQL se puede utilizar el comando: C:\>mysqladmin -uroot password root

Pg. 16 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

3.6 Seleccin de Mdulos


La aplicacin e-SIJAD es modular y el programa de instalacin permite la seleccin de los mdulos.

En esta pantalla aparecen los mdulos disponibles para la instalacin. El usuario podr seleccionar aquellos que considere ms apropiados.

3.7 Finalizacin
Una vez completada la instalacin aparecer una ventana indicando todas las incidencias que se han producido durante la instalacin. El proceso de instalacin, a parte de mostrar esta ventana informativa, tambin crea varios ficheros .log con informacin sobre la instalacin.

Pg. 17 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

Estos ficheros se encuentran en la carpeta de instalacin, uno llamado eSIJAD.log y otro ubicado en la carpeta .install4j llamado instalation.log.

Pg. 18 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

4 Mantenimiento de la Aplicacin
Una vez concluida la instalacin de e-sijad, en posteriores ejecuciones del programa de instalacin se mostrar el men de mantenimiento de la aplicacin.

En este men se incluyen todas las opciones necesarias para el mantenimiento tanto de la aplicacin e-SIJAD como del modelo de datos asociada a la misma.

Pg. 19 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

4.1 4.1 Reparar Aplicacin


Esta opcin permite la reinstalacin de la aplicacin. El programa de instalacin advierte sobre la prdida de informacin que este proceso podra llegar a provocar. Antes de la reparacin de la aplicacin es recomendable realizar una copia de seguridad de la misma.

4.2 4.2 Agregar o Quitar Componentes


Desde esta pantalla el usuario podr aadir o eliminar mdulos de e-SIJAD.

Esta accin reconfigura el servidor de aplicaciones por lo que podra ser necesario su reinicio.

Pg. 20 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

4.3 Actualizacin de la aplicacin


La actualizacin de e-SIJAD se realiza en tres niveles diferenciados: nivel de aplicacin, nivel de usuario y nivel de Base de Datos.

Los archivos de actualizacin tiene extensin .e-SIJAD y contienen los elementos para la actualizacin. Cada actualizacin establece una build o nivel de versin del sistema de informacin. No ser posible actualizar la aplicacin a una versin anterior a la existente, haciendo uso de un fichero de actualizacin antiguo. La actualizacin del modelo de datos se realizar sobre aquellos que se hayan sido creados en algn proceso de instalacin.

Pg. 21 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

4.4 Copia de Seguridad de Base de Datos


A travs de esta opcin se pueden realizar copias de seguridad de cualquier modelo de datos vinculado con e-SIJAD.

Al igual que sucede en la actualizacin, en el proceso de copias de seguridad slo sern incuidos aquellos modelos de datos creados a partir del programa de instalacin. Los ficheros resultado de la copia se almacenarn por defecto en el directorio:

c:\e-SIJAD_Backup (S.O. Windows) /$(usuario)/e-SIJAD_Backup (S.O. Unix)

Pg. 22 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

4.5 Copia de Seguridad de la Aplicacin


Para realizar una copia de seguridad de la aplicacin el usuario slo debe seleccionar el directorio en el que se almacenar la copia.

El fichero resultado de la copia de seguridad tendr extensin .e-SIJAD.

Pg. 23 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

4.6 Validar Modelo de Datos


Con esta opcin el usuario podr validar cualquier modelo de datos creado en un proceso de instalacin de la aplicacin.

Pg. 24 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

5 Ejecucin en el equipo cliente


Para ejecutar la aplicacin en el equipo cliente se deben realizar los siguientes pasos:

PASO 1: asegurarse de que el servidor de aplicaciones este inicializado. Para sistemas operativos Windows el inicio del servidor de aplicaciones consistira en la ejecucin del fichero que se crea en el escritorio llamado Iniciar Jboss. En sistemas operativos Linux/Unix, para iniciar el servidor de aplicaciones necesitamos ejecutar el fichero run.sh, ubicado en la carpeta 'bin' del directorio de instalacin de Jboss. Si por alguna circunstancia no se permitiera la ejecucin del citado fichero por limitaciones de seguridad, ser necesario utilizar el siguiente comando: bash ./run.sh

PASO 2: Ejecutar la Aplicacin desde el puesto cliente. Desde cualquier navegador web indicando la Url configurada en el proceso de instalacin y que hace referencia al archivo de inicio de la aplicacin.

URL: http://<servidor>:8080/openlocal-cliente/

Desde esta URL se suministra la pgina de instalacin de la aplicacin cliente. Desde esta pgina sde optar por la instalacin de la mquina virtual JAVA o la ejecucin de la aplicacin.

Pg. 25 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

Este proceso instalar en el equipo cliente la aplicacin y crear un acceso directo en el escritorio si as ha sido establecido desde el Panel de Control de JAVA. En ocasiones ser necesario indicar explcitamente el fichero de ejecucin de la aplicacin Java Web Start, necesario para la correcta ejecucin del cliente. Este ejecutable suele encontrarse en la siguiente ubicacin: <Directorio_instalacin_Java>/jre/javaws/ Ejecutable Linux: javaws Ejecutable Windows: javaws.exe

Pg. 26 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

La primera ventana que aparece al abrir la aplicacin es la de validacin del usuario. El usuario por defecto que se crea en la aplicacin es esijad y la contrasea esijad.

Pg. 27 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

5.1 Descarga de Fuentes para Cdigos de Barras


Los cdigos de barras son utilizados por la aplicacin e-SIJAD para la generacin de recibos. Para una correcta generacin de estos cdigos de barras es necesaria la incorporacin de fuentes especficas para el Sistema Operativo Windows. Las fuentes se pueden encontrar en la siguiente URL: http://<nombre_servidor>:8080/openlocal-cliente/Fuentes.rar Copiar el contenido de este fichero en la ruta: c:\Windows\Font

Pg. 28 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

6 Desinstalacin
La aplicacin dispone de un desinstalador que elimina del sistema la aplicacin, a excepcin de aquellos archivos que hubiesen sido modificados tras la instalacin. Este desinstalador se ubica en el directorio de instalacin especificado por el usuario y que ser ejecutado:

uninstall.exe (Windows) ./uninstall (Linux)

Para finalizar el proceso el desinstalador preguntar al usuario si desea eliminar las bases de datos creadas en la instalacin.

Pg. 29 de 30

Manual Instalacin-Adminstracin: Sistema Open Source de Gestin Municipal

Pg. 30 de 30