PISTA Administración Local · 01 actualizacion: Scripts para actualizar la Base de Datos de los...

Telefónica Soluciones

Pista Administración LocalManual de Instalación

PISTA Administración Local

Manual de Instalación v2.6

Partida 005:

UTE Telefónica Soluciones - Tissat

Referencia: v2.6

Nº Versión: 2.6

Fecha: 28/08/2005


Pista Administración Local

INFORMACIÓN GENERAL

CONTROL DOCUMENTAL:

Proyecto:Entidad de destino: SETSI (MCyT)Titulo: Manual de InstalaciónCódigo de referencia: v2.6Herramienta(s) de edición: Microsoft Word XPAutor(es): Miguel Ángel Ballesteros, Sergi, Daniel ÁlvarezResumen: Manual de Instalación del producto PISTA

ESTADO FORMAL:

Preparado por: Revisado por: Aprobado por:

Nombre: Miguel Ángel Ballesteros,Sergi, Daniel ÁlvarezFecha: 18/10/yyyy

Nombre: Fecha:

Nombre: Fecha:

Ref.: v2.6 Pág. 2 Versión: 2.5.1



CONTROL DE MODIFICACIONES POR CAMBIO DE VERSIONES

VERSIÓN PARTES QUE

CAMBIAN

DESCRIPCIÓN DEL CAMBIO FECHA DECAMBIO

0.1 N/A Documento original (beta)

2.5 Introducida nuevasección 2

Agregado apartado “2. Descarga delproducto y verificación”

13/05/2005

Sección 3.4 Agregada nota importante: no puede usarse“localhost” para referenciar a la máquinadonde se instala el producto. Debe utilizarseun nombre DNS válido.

13/05/2005

Anexo B Cambiado título del anexo B, de “Anexo B:instalación de la BBDD para el portal” a“Anexo B: Preparación de la BBDD parainstalar el producto”.

13/05/2005

Anexo B Eliminados pasos innecesarios del anexo B,dado que el proceso de autoinstalación detables ya los cubre.

13/05/2005

Sección 4.2. Aclarada descripción de la variable deconfiguración “ContentManagerUri” dentrodel módulo PPAL.

13/05/2005

Sección 2 Insertada nueva descripción en el paquete deScripts de Base de Datos para incluir lasactualizaciones del proceso de cargapadronal de las pasarelas.

18/05/2005

Sección 3 Insertado punto 8 en el que se describe elproceso de actualización del procedimientode carga padronal de las pasarelas.

18/05/2005

2.5.1 Sección 4.2 Incluida nota sobre la instalación de Tomcat 16/06/2005Sección 4.2.1 Se ha incluido este punto con las

plataformas probadas16/06/2005

Sección 4.3 Insertadas aclaraciones sobre el servidor decorreo SMTP y la referencias a la base dedatos

16/06/2005

Sección 4.4 Incluidas aclaraciones sobre versiones en lospuntos 2 y 3

16/06/2005

Sección 5.2.1 Insertado un enlace a la configuración de lafuente de datos

16/06/2005

Sección 5.2.1 Insertado un enlace a la configuración de lafuente de datos

Modificador el párrafo para subir lasaplicaciones

16/06/2005

Sección 7.1.1 Se ha incluido una nota aclarando losvalores del fichero de propiedades

16/06/2005

Sección 8.3.1 Incluida aclaración sobre el certificadodigital, y la dirección utilizada

16/06/2005

Sección 8.3.2 Aclarada la configuración del “Server.xml” 16/06/2005Sección 8.5 Incluida aclaración sobre el servidor Tomcat 16/06/2005




Sección 8.6 Incluida aclaración sobre dónde seencuentran los parámetros de entorno

16/06/2005

2.6




INDICE

1INTRODUCCIÓN.................................................................................................................................................7

2DESCARGA DEL PRODUCTO Y VERIFICACIÓN DE SU CONTENIDO................................................ 8

3ACTUALIZACIÓN DEL PRODUCTO DESDE LA V2.5.X............................................................................ 9

4COMPROBACIONES PREVIAS A LA INSTALACIÓN..............................................................................10

4.1NOTAS IMPORTANTES (ALCANCE DE LA INSTALACIÓN)............................................................................................. 104.2PLATAFORMA DE REFERENCIA............................................................................................................................... 10

4.2.1Instalación en otras plataformas........................................................................................................... 104.3CHECK-LIST DE VERIFICACIONES A REALIZAR......................................................................................................... 114.4CONFIGURACIÓN Y VERIFICACIÓN DE LA PLATAFORMA DE BASE................................................................................. 12

5INSTALACIÓN DEL PRODUCTO PISTA ADMINISTRACIÓN LOCAL................................................ 14

5.1DESCRIPCIÓN DE LAS APLICACIONES WEB ENTREGADAS............................................................................................. 145.2PASOS NECESARIOS PARA LA INSTALACIÓN.............................................................................................................14

5.2.1Configuración del servidor de aplicaciones Tomcat 5.0.X................................................................... 145.2.2Instalación de las aplicaciones Web......................................................................................................145.2.3Configuración de la aplicación CMPAL.WAR (Gestor de Contenidos)................................................155.2.4Configuración de la Aplicación PPAL.WAR (Multiportal iSUM).........................................................165.2.5Configuración de la aplicación LMPAL.WAR (Módulo de Autenticación))......................................... 165.2.6Configuración de la aplicación AGPAL.WAR (Gestión de Agendas)................................................... 175.2.7Configuración del Servicio Web Pasarela 3 (webPasarela3.war)........................................................ 175.2.8Configuración del Servicio Web Padron (webPadron.war)..................................................................195.2.9Configuración del Servicio Web Contable y Fiscal (webapp.war)....................................................... 205.2.10Configuración del Servicio Web Estadísticas Padronales (webEstadisticas.war)..............................215.2.11Configuración del Servicio Web Boletín Electrónico (webBoletin.war)............................................. 21

6ARRANQUE DEL SERVIDOR Y ENTRADA A LA APLICACIÓN........................................................... 23

6.1VERSIONES DE LOS APLICATIVOS........................................................................................................................... 23

7CONFIGURACIÓN DE TAREAS BATCH..................................................................................................... 25

7.1CARGAS DE PASARELAS....................................................................................................................................... 257.1.1Procedimiento de carga.........................................................................................................................257.1.2Cron Aplicación de carga......................................................................................................................26

8ANEXO A: CONFIGURACIÓN DEL SERVIDOR DE APLICACIONES TOMCAT 5.0.........................27

8.1PROPIEDADES DE ARRANQUE................................................................................................................................278.1.1Windows................................................................................................................................................. 278.1.2Unix........................................................................................................................................................27

8.2ACTIVAR LOS SERVLETS.......................................................................................................................................278.3CONFIGURACIÓN PARA TRABAJAR CON SOPORTE SSL............................................................................................... 28

8.3.1Paso 1: Generación del Certificado de Servidor...................................................................................288.3.2 Paso 2: Configuración de Tomcat........................................................................................................ 298.3.3Paso 3: Librerías necesarias para los Servicios Web........................................................................... 29

8.4HABILITAR LA ADMINISTRACIÓN REMOTA................................................................................................................ 308.5CONFIGURACIÓN DE UNA FUENTE DE DATOS............................................................................................................ 308.6CONFIGURACIÓN DE ENTRADAS (PARÁMETROS) DE ENTORNO................................................................................... 35

9ANEXO B: PREPARACIÓN DE LA BBDD PARA INSTALAR EL PRODUCTO....................................37

9.1INSTALACIÓN EN ORACLE.................................................................................................................................... 379.1.1Creación de Tablespaces....................................................................................................................... 379.1.2Creación del usuario de Base de Datos.................................................................................................37

9.2INSTALACIÓN EN POSTGRESQL............................................................................................................................379.2.1Creación del usuario de Base de Datos.................................................................................................389.2.2Creación de la Base de Datos................................................................................................................38




10ANEXO C: INSTALACIÓN DEL MODELO DE BASE DE DATOS PARA LAS AGENDAS............... 39

11ANEXO D: INSTALACIÓN DEL MODELO DE BASE DE DATOS PARA LOS SERVICIOS WEBPISTA..................................................................................................................................................................... 40

11.1INSTALACION EN ORACLE................................................................................................................... 4011.1.1Creación de la estructura de tablas.....................................................................................................4011.1.2Creación de cuenta de usuario............................................................................................................ 4011.1.3Creación de las tablas de la base de datos..........................................................................................4011.1.4Creación de los procedimientos de carga padronal, contable y fiscal............................................... 4111.1.5Inserción de la información en las tablas con información fija.......................................................... 41

11.2INSTALACION EN POSTGRESQL.......................................................................................................... 4111.2.1Creación del usuario de la base de datos............................................................................................4111.2.2Creación de la base de datos............................................................................................................... 4111.2.3Creación de las tablas de la base de datos..........................................................................................4111.2.4Creación de los índices de las tablas...................................................................................................4111.2.5Creación de las restricciones de las tablas......................................................................................... 4111.2.6Inserción de los datos en las tablas creadas....................................................................................... 4111.2.7Creación de los procedimientos de carga padronal, contable y fiscal............................................... 42

12ANEXO E: TUNNING DE LA APLICACIÓN..............................................................................................43

12.1POOL DE CONEXIONES....................................................................................................................................... 4312.2PARÁMETROS DE ARRANQUE DE LA JVM.............................................................................................................43

13 ANEXO F: PROBLEMAS QUE PUEDEN SURGIR DURANTE EL PROCESO DE CARGA DEINFORMACIÓN EN LA BBDD..........................................................................................................................44

14ANEXO H: RESOLUCIÓN DE PROBLEMAS FRECUENTES EN EL PROCESO DE INSTALACIÓN.................................................................................................................................................................................45

14.1CONFIGURACIÓN DEL SERVIDOR UNIX................................................................................................................. 4514.1.1Aún me salen mal los acentos.............................................................................................................. 45

14.2INSTALACIÓN DEL TOMCAT................................................................................................................................ 4514.2.1He cambiado la configuración del Tomcat al puerto 80 y 443 y ahora no me va.............................. 4514.2.2Mi máquina de producción ya está utilizando los puertos 80 y 443, ¿puedo cambiarlos a otros?.... 45




1 INTRODUCCIÓN

El presente documento va dirigido al personal encargado de realizar la instalación de unaplataforma con la el producto multiportal PISTA Administración Local. El documento secomplementa con una serie de anexos, que sirven de apoyo durante el proceso de instalación.

Ref.: Pág. 7 Versión: .5.1



2 DESCARGA DEL PRODUCTO Y VERIFICACIÓN DE SUCONTENIDO

La última versión del producto está disponible para su descarga desde www.pistalocal.com.Todo el material necesario para la instalación está disponible en un único paquete (archivoZIP), en el que se incluyen los siguientes directorios:

o /01 Scripts de BBDD: Directorio que contiene los scripts para crear los espacios deBBDD para realizar la instalación. Se recomienda que sea un DBA quien realice osupervise esta operación, o que él mismo cree los espacios necesarios.

o /01 portal: Scripts para crear las BBDD del portal

o /02 pasarelas: Scripts para crear las BBDD de las pasarelas

01 actualizacion: Scripts para actualizar la Base de Datos de losServicios Web PISTA (ver apartado 11 Anexo D) de la v2.4 a la v2.5.

o /02 Manuales: Directorio con los manuales oficiales de instalación, administradorglobal, administrador local, y usuario registrado.

o Manual de Instalacion v2.5

o Manual del Administrador Global v2.5

o Manual del Administrador Local v2.5

o Manual del Usuario Registrado v2.5

o /03 Módulos: Directorio con las aplicaciones web a instalar.

o 00 Aplicación deTest.zip

o 01 Portal.zip

o 02 Gestión de Contenidos.zip

o 03 Agendas.zip

o 04 Procesos de carga de pasarelas.zip

o 05 Pasarela3.zip

o 06 Estadísticas Padronales.zip

o 07 Pasarela de Padron.zip

o 08 Pasarela Contable y Fiscal.zip

o 09 Boletín.zip




3 ACTUALIZACIÓN DEL PRODUCTO DESDE LA V2.5.XEn el caso en el que ya dispongamos de un aplicativo instalado v2.5 que queramos actualizar ala nueva v2.6, los pasos a realizar serán los siguientes:

1. Parar el servidor de aplicaciones.

2. Hacer una copia de seguridad completa (de la configuración de todos los módulos, delrepositorio de contenidos, y de las BBDD). Ver manual de administración global paramás detalles sobre este proceso de backup.

3. Hacer una copia de seguridad de cualquier modificación que se haya realizado sobre“ppal”, “cmpal”, y en general cualquier módulo del producto. En especial:

a. Dentro de “ppal”: interfaces y css que hayamos introducido para personalizarel producto

b. Dentro de “cmpal”: plantillas de presentación para tipos de contenidos,categorías, etc.

c. En cualquier módulo: información de internacionalización (de idiomas)

d. Parámetros de arranque del proceso de cargas

4. Eliminar desde línea de comandos:

a. Los ficheros WAR y las carpetas desplegadas dentro del directorio “webapps”de los módulos a sustituir (haciéndolo así se mantiene la configuraciónprevia).

b. Los ficheros con los binarios del directorio de cargas.

5. Instalar los nuevos módulos:

a. Los nuevos WAR dentro del directorio “webapps”

b. Los nuevos binarios del directorio de cargas.

6. Arrancar el servidor de aplicaciones

7. Verificar que las aplicaciones WAR se despliegan correctamente y que laactualización ha sido correcta verificando que las aplicaciones siguen funcionando eincorporan las mejoras y corrigen los bugs.




4 COMPROBACIONES PREVIAS A LA INSTALACIÓN

4.1 NOTAS IMPORTANTES (ALCANCE DE LA INSTALACIÓN)

• El producto PISTA Administración Local se instala sobre una plataformaconsiderada “base” que nada tiene que ver con el producto en sí mismo.

• Cualquier información de ayuda para la configuración de dicha plataforma debase incluida en este documento debe considerarse secundaria y sin garantías.

• Es responsabilidad de la entidad sobre la que realice la instalación proporcionar,convenientemente configurada, la plataforma “base”.

4.2 PLATAFORMA DE REFERENCIA

La siguiente configuración muestra un ejemplo de referencia donde se ha instalado sinproblemas el producto PISTA Administración Local:

• Sistema Operativo Windows XP SP1• JDK v 1.4.2• Una instancia de base de datos Oracle 8.1.x ó 9.x • Servidor de aplicaciones Jakarta Tomcat 5.0.19, configurado correctamente para

utilizar la máquina virtual anteriormente citada. Es necesario puesto que utilizafuncionalidad de servlet 2.4, y se encuentra disponible a partir de la versión 5 deTomcat.

• Internet Explorer 6.0 o Mozilla 1.4 o superior• Librería Apache Xerces versión 2.6.0 para validación ficheros XML frente XSD.

http://xml.apache.org/xerces2-j/index.html

En principio no habría problemas al instalarlo en otro sistema operativo, mientras disponga dela citada maquina virtual1.

NOTA: Si se realizar la instalación en Windows es recomendable instalar el servidorTomcat en un directorio que NO tenga espacios en blanco. (Por defecto el instalador detomcat utiliza la url C:\Archivos de Programa\...)

4.2.1 Instalación en otras plataformasSe ha probado con éxito la instalación en las siguientes configuraciones2:

Sistema Operativo Versión JDK Servidor Tomcat Base de DatosWindows XP 1.5.0_02 5.5.7 PostgreSQL 8.0.3Windows XP 1.5.0_02 5.5.7 Oracle 9iWindows XP 1.5.0 5.0.28 PostgreSQL 8.0.1Windows XP 1.5.0 5.0.28 Oracle 8.1.71 Pueden surgir problemas a la hora de instalar el prototipo en otros sistemas operativos ya que lasaplicaciones web *.war han sido realizadas sobre Windows y la codificación de los caracteres de salto delínea y retorno de carro pueden ser diferentes. En particular, sobre Unix se puede utilizar el comandodos2unix para solventar este problema, aplicándolo a todos los documentos cuyo contenido sea textoplano.2 Esto no significa que no funcione en otras plataformas; simplemente se dan como referencia deinstalaciones conocidas sobre las que se ha instalado sin problema alguno.




Red Hat Linuxrelease 9 (Shrike)Kernel: 2.4.20-8smp

1.4.2_04 5.0.24 PostgreSQL 7.4.1

SuSE Linux 9.0(i586) Kernel: 2.4.21-99-default

1.4.2 5.0.25 PostgreSQL 7.4.213

4.3 CHECK-LIST DE VERIFICACIONES A REALIZAR

NOTA IMPORTANTE: La siguiente lista de comprobaciones DEBE verificarse al completo.Si no se verifica alguno de los puntos la instalación no se realizará satisfactoriamente.

• Comprobación de equipos (pueden coincidir en algunas configuraciones):

o Se dispone de un servidor “web/aplicaciones”

o Se dispone de un servidor para la BBDD

o Se dispone de un equipo cliente con el que acceder al equipo servidor

o Se dispone de un servidor para correo saliente (SMTP). Este paso seránecesario si se van a utilizar los servicios de envío de correos del portal.

• Comprobaciones relativas al equipo servidor “web/aplicaciones”:

o Tiene correctamente instalada una J2SE v1.4.2 (comprobar con “java –version”). Puede conseguirse de http://java.sun.com/j2se

o Tiene correctamente instalado un Jakarta Tomcat 5.0.19 o superior (enprincipio es válido cualquier contenedor de servlets 2.4, aunque sólo se haprobado con Tomcat 5)

o El Tomcat utiliza la J2SE 1.4.2 y no otra J2SE que pudiera estar instalada

• Comprobaciones relativas al equipo de BBDD

o Se dispone de una instalación correcta de BBDD: Oracle 8.1.7 o superior, oPostgreSQL 7.4.1 o superior

o La BBDD está levantada

o La BBDD dispone de un “esquema” (Oracle) o “base de datos” (PostgreSQL)donde almacenar los datos y se conoce su identificador (SID). Si la base dedatos no existe será necesario crearla. Para crear el esquema ver el ANEXO B:Preparación de la BBDD para instalar el producto.

o Se dispone de un usuario de BBDD con permisos suficientes para lanzar losscripts de creación de tablas y la carga inicial de datos.

• Comprobaciones relativas al equipo cliente:

o Tiene instalador un Internet Explorer 6.0 o Mozilla 1.4 o superior

• Comprobaciones relativas al equipo servidor de correo saliente (SMTP)

o El servidor de correo saliente está activo

• Comprobaciones de conectividad:

o El equipo servidor tiene acceso a los puertos requeridos por la BBDD

o El equipo servidor tiene acceso al puerto SMTP del servidor de correos




o El equipo cliente tiene acceso a los puertos 80 y 443 del equipo servidor

4.4 CONFIGURACIÓN Y VERIFICACIÓN DE LA PLATAFORMA DE BASE

Suponiendo que hubiéramos descargado la JDK y el Tomcat los pasos a seguir serían lossiguientes:

1. Si es una Linux, verificar que existe una variable de entorno “LANG = es_ES.ISO-8859-1” (esto asegura que el encoding de ficheros funciona con acentos)

2. Instalar la JDK 1.4.2 o superior. Asegurarse de que podemos hacer “java –version”desde cualquier directorio y ver la versión correspondiente. Si nos encontramos en unsistema Windows será necesario incluir el directorio bin de la jdk en la variable deentorno PATH.

3. Instalar el Tomcat 5.0.19 o superior y configurarlo para que utilice la JDK (ver 8.1) Sise instala una versión de Tomcat superior debemos comprobar que funcionan lasherramientas de administración web (Admin y Manager). Por ejemplo, en la versión5.5.9 la herramienta de administración del Tomcat (admin) no viene incluida.

4. Arrancar el servidor y probarlo abriendo un navegador y conectando con“http://maquina.dominio.es:8080/”. Debería verse la pantalla de bienvenida a Tomcat,informando de que la instalación fue ok. Parar el servidor.

5. Activar los servlets (ver 8.2)

6. Configurar http en el puerto 80 y https en el 443 (ver 8.3). La configuración del httpsNO es opcional (y muy importante por la LOPD, ya que en ocasiones se transmiteinformación personal). Comprobar que ambos puertos son accesibles (podrían aparecerproblemas de firewall, tanto externos como internos en el propio servidor –algunasinstalaciones arrancan un firewall que bloquean el puerto 443).

7. Habilitar la administración remota (ver 8.4)

8. Arrancar el servidor y probar que “http://maquina/” y “https://maquina/” funcionancorrectamente. Parar el servidor de aplicaciones.

9. Copiar la aplicación “testpal.war” en el directorio “$TOMCAT_HOME/webapps”3

10. Arrancar la aplicación y conectarnos a “http://maquina/testpal”. NOTAIMPORTANTE: El nombre de la máquina debe ser un nombre válido en el DNS, nosiendo posible utilizar “localhost”.

11. Comprobar que pasa la prueba de sesión, pero no la de conexión con la BBDD (ya quetodavía no se ha configurado el pool)

12. Comprobar que hay conectividad desde el servidor a la BBDD. Ejemplo: si tenemosOracle instalado en el puerto 1521, es posible comprobar la conectividad mediante elcomando “telnet maquinabbdd 1521”, siendo “maquinabbdd” la máquina donde está laBBDD. Otras BBDD pueden necesitar otras formas de comprobación; consultar ladocumentación de la BBDD.

13. Configurar el pool de conexiones (ver 8.5). Es muy importante haber copiado el driverJDBC, correspondiente a la BBDD que estemos usando, en el directorio“$TOMCAT_HOME/common/lib”

3 Con el fin de verificar que la plataforma de base está correctamente configurada seproporciona la aplicación “testpal.war”. Si esta aplicación funciona correctamente, el productodebería poderse instalar sin grandes problemas.




5 INSTALACIÓN DEL PRODUCTO PISTA ADMINISTRACIÓNLOCAL

5.1 DESCRIPCIÓN DE LAS APLICACIONES WEB ENTREGADAS

• cmpal.war - Aplicación Web que contiene el software de gestión de contenidos.

• lmpal.war - Aplicación Web utilizada por el portal iSUM para gestionar el proceso deautenticado de usuarios en el portal.

• ppal.war - Aplicación Web que contiene el software de portal iSUM.

• agpal.war – Aplicación Web utilizada por el portal iSUM para gestionar las agendas delos contenidos que las poseen

• webPasarela3.war - Representa el servicio web compuesto por la Pasarela 3. Suinstalación debe realizarse donde esté ubicado el portal.

• webapp.war - Representa el servicio web compuesto por los servicios de proveedorContable y Fiscal. Debe instalarse en la maquina que vaya a actuar como proveedor deservicios.

• webPadron.war - Servicio web que representa los servicios padronales ofrecidos por elproveedor, éstos son: Datos padronales del ciudadano, Hoja padronal del ciudadano yVolante padronal. Debe instalarse en la maquina que vaya a actuar como proveedor deservicios.

• webEstadisticas.war - Servicio web encargado de solicitar al proveedor el fichero xmlcorrespondiente con las estadísticas padronales, creadas durante el proceso de carga deun archivo de padrón. Estará alojado en la misma máquina en la que se encuentre laPasarela 3.

• webBoletin.war - Servicio de boletín electrónico. Deberá estar alojado junto a laPasarela 3.

Estos cinco últimos servicios los denominaremos Servicios Web PISTA en adelante paradistinguirlos del resto

5.2 PASOS NECESARIOS PARA LA INSTALACIÓN

5.2.1 Configuración del servidor de aplicaciones Tomcat 5.0.XEn primer lugar deberemos configurar el servidor de aplicaciones para que pueda trabajar conservlets, tenga soporte SSL y configurarlo para permitir crear los DataSource para acceder a lasbases de datos en las que se instalen las distintas aplicaciones (Ver el anexo 8.5 Configuraciónde una fuente de datos). Se puede consultar en http://jakarta.apache.org/tomcat cómo acceder alas herramientas de administración que ofrece el servidor de aplicaciones.

5.2.2 Instalación de las aplicaciones WebAntes de instalar las aplicaciones en el servidor de aplicaciones se debe configurarcorrectamente los DataSource (Ver el anexo 8.5 Configuración de una fuente de datos) paraacceder a las bases de datos, puesto que hay aplicaciones que realizan la generación de laestructura de base de datos utilizando su DataSource correspondiente (Es necesario que se hayacreado en la base de datos correspondiente el usuario y esquema/database para el producto).




Parar el servidor de aplicaciones Tomcat, y copiar los ficheros *.war en el directorio webappsdel Tomcat, también se puede utilizar el gestor de aplicaciones del servidor para subir nuestrasaplicaciones al servidor en ‘caliente’ (En Tomcat se accede a este gestor mediante la direcciónhttp://server_name/manager/html).

Si se han copiado los ficheros a mano hay que arrancar el servidor de aplicaciones para que sedesempaqueten los war en sus correspondientes carpetas. Una vez arrancado el servidor, éstedesempaquetará las cuatro aplicaciones de forma automática. Una vez desempaquetadas lasaplicaciones intentará arrancar las aplicaciones y dará algún error. Estos errores son normales,puesto que la configuración de las aplicaciones no se ha realizado todavía.

Los pasos anteriores son generales para todos los servicios, pero para el caso de los ServiciosWeb PISTA será necesario también ubicar en un directorio concreto todos los ficheros XSD yXSL necesarios para la Pasarela 3, manteniendo la estructura de directorios. Este directorioestará definido en el fichero web.xml de webPasarela3.war. NOTA: Los usuarios teníandudas sobre si esto debe hacerse ahora, o para qué sirve, …Adicionalmente, será necesario configurar las aplicaciones por medio de la herramienta deadministración de tomcat. Utilizando esta herramienta para cada aplicación habrá queconfigurar algunos parámetros que se explicarán detalladamente para cada servicio. Entre otrascosas mediante la edición de estos parámetros configuraremos el acceso a la base de datos y losficheros de log, así como rutas de directorios.

5.2.3 Configuración de la aplicación CMPAL.WAR (Gestor de Contenidos)Para configurar el gestor de contenidos debemos acceder a la consola de administrador delservidor de aplicaciones y configurar los parámetros del entorno de la aplicación tal y como seexplica en el punto 8.6 Configuración de Entradas (Parámetros) de Entorno.

Los parámetros que hay que configurar para la aplicación del Gestor de Contenidos son:

• multiprojectRoot – Directorio donde se va a ubicar el multiproyecto.

• subscriptionRoot – Directorio de trabajo del gestor de suscripciones.

• structureFileName – Fichero de estructura de los nuevos proyectos. Contiene laestructura de categorías, los tipos de contenido y los roles y permisos del proyecto. Esteparámetro no se debe modificar.

• cache-directory – Directorio donde se van a almacenar los ficheros que se cachean.Por defecto se almacena en el directorio cache dentro del contexto de la aplicacióncmpal.

• cache-time-of-life – Tiempo de vida máximo de un fichero en la caché (enmilisegundos). Por defecto esta establecido a 24 horas.

• cache-clean-period – Frecuencia de tiempo con la que se ejecuta el proceso delimpieza de caché (en milisegundos). Por defecto está establecido a 12 horas.

• actions/net.sf.scmwebgui.actions.SendMail-smtpHost – Dirección en la que seencuentra el servidor de correo. (Utilizado en las suscripciones).

• actions/net.sf.scmwebgui.actions.SendMail-smtpPort – Puerto en el que seencuentra el servidor de correo. (Utilizado en las suscripciones).

• actions/global-agendaServerUri – Dirección http en la que se encuentra el contextode la aplicación de agenda.

• replaceUris – Parámetro de configuración heredado de la aplicación web del gestor decontenidos. Debe valer ‘true’ para la instalación.




• SSL_Port – Parámetro de configuración que indica el puerto SSL utilizado.

5.2.4 Configuración de la Aplicación PPAL.WAR (Multiportal iSUM)La aplicación del Multiportal (PPAL) requiere de una base de datos para su funcionamiento. Laaplicación necesita que el DataSource esté configurado correctamente, puesto que en elmomento de arranque de la aplicación se comprobará si se necesita crear la estructura de basede datos utilizada por el portal.

Para configurar la aplicación del Multiportal debemos acceder a la consola de administrador delservidor de aplicaciones y configurar los parámetros del entorno de la aplicación tal y como seexplica en el punto 8.6 Configuración de Entradas (Parámetros) de Entorno.

Para el acceso a la base de datos hay que enlazar el nombre “jdbc/ppal” con la fuente de datos(DataSource) donde se encuentren las tablas de la aplicación. Ver punto 8.5 Configuración deuna fuente de datos.

Los parámetros que hay que configurar para la aplicación del Multiportal son:

• log-level – Nivel de log utilizado en la aplicación. (Los ficheros de log se encuentranen el directorio WEB-INF/logs del contexto de la aplicación ppal)

• smtp-host – Dirección en la que se encuentra el servidor de correo. (Utilizado en elservicio de envío de correos.

• login_module/server – Nombre del servidor donde se encuentra el Módulo de Logindel Multiportal.

• login_module/context – Nombre de la aplicación del Módulo de Login delMultiportal. Por defecto es lmpal, no se debe modificar.

• login_module/http – Puerto http (no seguro) en el que se encuentra la aplicación delMódulo de Autenticación del Multiportal.

• login_module/https – Puerto https (seguro) en el que se encuentra la aplicación delMódulo de Autenticación del Multiportal.

• login_module/https_CD – Puerto https (seguro) para cifrado digital en el que seencuentra la aplicación del Módulo de Autenticación del Multiportal. En principio nose utiliza.

• ContentManagerUri – Dirección http en la que se encuentra el contexto de laaplicación de la gestión de contenidos CMPAL. El parámetro es de la forma:“http://nombremaquina.dominio.com/cmpal”.

• EstadisticasUri – Dirección http en la que se encuentra el contexto de la aplicación deestadísticas.

• Pasarela3Uri – Dirección http en la que se encuentra el contexto de la aplicación de latercera pasarela.

5.2.5 Configuración de la aplicación LMPAL.WAR (Módulo de Autenticación))Para configurar la aplicación del Modulo de Autenticación debemos acceder a la consola deadministrador del servidor de aplicaciones y configurar los parámetros del entorno de laaplicación tal y como se explica en el punto 8.6 Configuración de Entradas (Parámetros) deEntorno.

Para el acceso a la base de datos hay que enlazar el nombre “jdbc/lmpal” con la fuente dedatos (DataSource) donde se encuentren las tablas de la aplicación. Ver punto 8.5Configuración de una fuente de datos.




Los parámetros que hay que configurar para la aplicación del Módulo de Autenticación son:

• log-level – Nivel de log utilizado en la aplicación. (Los ficheros de log se encuentranen el directorio WEB-INF/logs del contexto de la aplicación ppal)

5.2.6 Configuración de la aplicación AGPAL.WAR (Gestión de Agendas)La aplicación de Agenda (AGPAL) requiere de una base de datos para su funcionamiento. Laaplicación necesita que el DataSource esté configurado correctamente, puesto que en elmomento de arranque de la aplicación se comprobará si se necesita crear la estructura de basede datos utilizada por la aplicación.

La aplicación AGPAL tiene sólo dos elementos de configuración: los logs y la conexión aBBDD.

Los logs de la aplicación se controlan a través de dos atributos del contexto de la aplicación(accesibles desde la aplicación de administración de Tomcat):

• log-level: controla el nivel de log. Valores válidos, de menor a mayor nivel de detalle:SEVERE, WARN, INFO, FINE, FINER, FINEST. Se corresponden con los niveles delestándar de logs para la JDK 1.4

• log-file: La ruta en la que se desea almacenar la información de logs.

Para el acceso a la base de datos hay que enlazar el nombre “jdbc/agpal” con la fuente de datosdonde se encuentren las tablas de la aplicación. Ver punto 8.5 Configuración de una fuente dedatos.

NOTA: La aplicación AGPAL viene configurada por defecto para trabajar con oracle. Si labase de datos a utilizar es postgreSQL, hay que modificar una propiedad en el ficheroTorque.properties que se encuentra situado en %TOMCAT_HOME%/webapps/agpal/WEB-INF/classes. La configuración de dicha propiedad es la siguiente:

• ORACLE: torque.database.AGPAL.adapter=oracle

• POSTGRESQL: torque.database.AGPAL.adapter=postgresql

5.2.7 Configuración del Servicio Web Pasarela 3 (webPasarela3.war)Los servicios que proporciona este servicio web webPasarela3.war son los siguientes:

• Administración de la carga del archivo padronal.• Administración de los servicios proporcionados por el proveedor.• Administración de las tablas de la base de datos.• Servicio de pasarela con el proveedor.

El servicio es dependiente de la plataforma, pero para simplificar las modificaciones a realizarsobre el mismo, todas las modificaciones necesarias se van a realizar a través de la consola deadministración del servidor de aplicaciones. Los parámetros que hay que configurar para elservicio de pasarela 3 son los siguientes:

NOTA: REVISAR LOS PARÁMETROS ACTUALES, YA QUE NO SECORRESPONDEN CON LOS QUE APARECEN AL INSTALAR

• cargaContableDirectory: directorio para carga de archivos contables en BD. Es eldirectorio de trabajo de la aplicación de carga y es importante que el directorio delúltimo nivel se denomine “contable”.

• cargaFiscalDirectory: especifica el directorio de carga de los archivos fiscales en laBD. Como en el caso anterior la ruta tiene que tener en el último nivel un directorio conun nombre específico, en este caso “fiscal”.




• cargaPadronDirectory: es el directorio de carga de los archivos padronales. En elúltimo nivel el directorio se debería denominar “padron”.

• defaultLocale: locale que utiliza el servicio web por defecto (formato: idioma_país).

• log-level: controla el nivel de log. Valores válidos, de menor a mayor nivel de detalle:SEVERE, WARN, INFO, FINE, FINER, FINEST. Se corresponden con los niveles delestándar de logs para jdk 1.4


• log-util-file: La ruta en la que se desea almacenar la información de logs de las clasesdel paquete de utilidades.

• maxLineasTablas: Numero máximo de registros presentados por página al administrarlas tablas auxiliares del padrón.

• pasarela3URL: URL donde se encuentra la tercera pasarela.

• timeout: timeout de las conexiones de la pasarela 3.

• tmpPasarela3Dir: directorio temporal para la tercera pasarela. Este directorio esutilizado para grabar ficheros temporalmente durante la administración de servicios dela pasarela 3.

• user-bd: usuario de la base de datos.

• workDirectory: Este parámetro debe indicar la ruta de trabajo de la pasarela3. Unavez establecida la ruta, será necesario crear un directorio al final de esta ruta con elcódigo INE del ayuntamiento (workDir/codigoINE) y ya dentro de este directorio,descomprimir el archivo ‘pasarela3workDir.zip’ que contiene todos los ficheros XSD yXSL necesarios para la correcta ejecución de la pasarela. NOTA: ACLARAR ELSIGNIFICADO DE ESTE PARÁMETRO

Modificando los anteriores parámetros podremos ejecutar el servicio en cualquier plataforma.

El servicio web del padrón y de contable y fiscal pueden ser configurados en máquinasdiferentes a la que esté configurada la pasarela 3. Para ello se tendrá que configurar lasaplicaciones war webapp.war y webPadron.war en una máquina distinta, y se deberá crear allíla bases de datos para los servicios contable, fiscal y padronal.

Otra serie de ficheros que será necesario modificar serán aquellos con extensión xsl, y enconcreto, todos los que terminen con la particula ‘–in-idioma.xsl’ (Estos archivos se encuentrandentro del archivo ‘pasarela3workDir.zip’ dentro de las carpetas de los grupos de servicios):

• listaFacturas-in_en-US.xsl• listaFacturas-in_es-ES.xsl• listaImpuestos-in_en-US.xsl• listaImpuestos-in_es-ES.xsl• listaPadronal-in_en-US.xsl• listaPadronal-in_es-ES.xsl• listarNHOP-in_en-US.xsl• listarNHOP-in_es-ES.xsl• misDatosPadronales-in_en-US.xsl• misDatosPadronales-in_es-ES.xsl




Estos ficheros se encontrarán en el directorio definido en el parámetro workDirectory delservicio web, accesible a través de la herramienta de administración de Tomcat.

De estos ficheros será necesario modificar las etiquetas correspondientes a la url del proveedorde servicios. Sirva de ejemplo el fichero listaFacturas-in_es-ES.xsl para determinar lasetiquetas a modificar(en negrita las modificaciones):

<?xml version="1.0" encoding="UTF-8"?>

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:output method="html" indent="yes"/>

<xsl:template match="/">

<html>

<head>

<meta http-equiv="content-type" content="text/html; charset=UTF-8"></meta>

</head> <body bgcolor="#008080">

<h1>Listado de Facturas</h1>

<form action="control" method="post">

Va usted a solicitar un listado de facturas:<br></br>

DNI: <xsl:value-of select="/datos/dni"/> <br></br>

<input type="hidden" name="skipForm" value="true"></input>

<input type="hidden" name="codServicio" value="Servicio1"></input>

<input type="hidden" name="accion"value="resp"></input>

<input type="hidden" name="op" value="listarFacturas"></input>

<input type="hidden" name="page"value="1"></input>

<input type="hidden"name="servletAyto"

value="ContableFiscalController"></input>

<input type="hidden" name="webAyto"value="webapp"></input>

<input type=”hidden” name=”hostAyto”value=”localhost”></input>

<input type=”hidden” name=”portAyto”value=”8080”></input>

<input type="hidden" name="xsdAyto"value="work"></input>

<input type="submit" value="Solicitar"></input>

</form>

</body>

</html>

</xsl:template>

</xsl:stylesheet>

5.2.8 Configuración del Servicio Web Padron (webPadron.war)




El fichero que contiene los servicios es webPadron.war . Los servicios que proporciona son:

• Información estadística padronal

• Volante padronal

• Datos padronales

• Hoja padronal

Al igual que el servicio de Pasarela 3, es necesario configurar el aplicativo después de haberloinstalado mediante la aplicación manager del servidor tomcat. Los parámetros del entorno quehay que configurar se explican a continuación:

• defaultLocale: locale que utiliza el servicio web por defecto (formato: idioma_país).

• estadisticasDir: Directorio raíz donde se van a encontrar los ficheros XML deestadísticas padronales. Es importante que este valor sea el del directorioworkDirectory (definido en el fichero propertiesBD.properties) de la aplicación decarga, más el sufijo /padron.

• idServiceSolicitud : Identificador del servicio de solicitud de volante. Siempre serásolicitudvolante.

• isSecure: Configura el servicio en modo seguro para login con certificados. Pordefecto en false.

• log-level: Controla el nivel de log. Valores válidos, de menor a mayor nivel de detalle:SEVERE, WARN, INFO, FINE, FINER, FINEST. Se corresponden con los niveles delestándar de logs para jdk 1.4



• work: Ruta (relativa a donde se encuentre desplegada la aplicación) que contiene losficheros con la definición de los servicios (.xsd).

5.2.9 Configuración del Servicio Web Contable y Fiscal (webapp.war)

Los servicios proporcionados son:

• Contable: relacionado con el estado de las facturas del ciudadano.• Fiscal: relacionado con el estado de los impuestos.

En este caso también hay que editar alguno de los ficheros de configuración. A continuación semuestra los distintos parámetros que se pueden configurar:




• maxLimFacturas: Número máximo de facturas que se van a presentar en cada página.




• maxLimImpuestos: Número máximo de impuestos que se van a presentar en cadapágina.

• worDirectory: Ruta (relativa a donde se encuentre desplegada la aplicación) quecontiene los ficheros con la definición de los servicios (.xsd).

Una vez realizados los cambios bastará con salvar y hacer un commit para que estos tenganefecto.

5.2.10 Configuración del Servicio Web Estadísticas Padronales (webEstadisticas.war)

Este servicio es el encargado de solicitar al servicio web de padrón, alojado en el proveedor, eldocumento XML con las estadísticas padronales. Recogerá este documento, lo validará y leaplicará una hoja de estilo XSL para mostrar los resultados al usuario. Para la correctaejecución del servicio será necesario configurar correctamente los parámetros a través de laconsola de administración del servidor de aplicaciones:

• host: dirección IP del host donde se encuentra instalado el servicio proveedor deinformación padronal.


• log-file: la ruta en la que se desea almacenar la información de logs.

• log-util-file: la ruta en la que se desea almacenar la información de logs de las clasesdel paquete de utilidades.

• path_ayunt: URI con el path para acceder al servicio proveedor de informaciónestadística del padrón (ej: /webPadron/PadronController/estadisticas).

• path_grafica: ruta donde se guardan temporalmente las gráficas de poblacióngeneradas.

• path_xsd: ruta donde se encuentra el fichero xsd donde se va a validar.

• path_xsl: ruta donde se encuentran los ficheros XSL correspondiente a las estadísticas.

• path_xsl_edad: ruta donde se encuentra el fichero XSL correspondiente a lasestadísticas por edades.

• path_xsl_estudios: ruta donde se encuentra el fichero XSL correspondiente a lasestadísticas por estudios.

• path_xsl_lugar: ruta donde se encuentra el fichero XSL correspondiente a lasestadísticas por lugar de nacimiento.

• port: puerto donde se encuentra el servicio proveedor.

• timeout: timeout de la conexión establecida con el proveedor del ayuntamiento.

Una vez editados los parámetros deberán salvarse los cambios y hacer un commit.

5.2.11 Configuración del Servicio Web Boletín Electrónico (webBoletin.war)

Servicio referente al la edición, creación y borrado de noticias. Deberá estar alojado en la




máquina que aloja a la Pasarela3, junto al portal. Para configurar el es necesario configurar losparámetros del entorno, como en los casos de los servicios anteriores:

• host: dirección IP del host donde se encuentra instalado el servicio web de boletínelectrónico.


• log-file: la ruta en la que se desea almacenar la información de logs.

• log-util-file: la ruta en la que se desea almacenar la información de logs de las clasesdel paquete de utilidades.

• log-velocity-file: ruta y nombre del fichero donde se almacena la información delmotor de plantillas velocity.

• multiprojectRoot – Directorio donde se va a ubicar el multiproyecto. Tiene que ser elmismo que el configurado en la aplicación cmpal.war.

• scm-login: Login del gestor de contenidos. Por defecto admin..

• scm-passwd: Password del gestor de contenidos. Por defecto admin.

• subscriptionRoot – Directorio de trabajo del gestor de suscripciones. Tiene que ser elmismo que el configurado en la aplicación cmpal.war.

• structureFileName – Fichero de estructura de los nuevos proyectos. Contiene laestructura de categorías, los tipos de contenido y los roles y permisos del proyecto. Esteparámetro no se debe modificar. Tiene que ser el mismo que el configurado en laaplicación cmpal.war.




6 ARRANQUE DEL SERVIDOR Y ENTRADA A LA APLICACIÓNDurante el proceso de arranque, el servidor de aplicaciones iniciará automáticamente laaplicación iSUM, mostrando durante el proceso el siguiente mensaje:===================================================iSUM version isum-6.0.0-sp1-PISTATrying to start iSUMConfigurated ISUM service path to:/tomcat/webapps/ppal/WEB-INF/classesInitializing logs at tomcat/webapps/ppal/WEB-INF/logs/iSUM Log4j InitializedAvailable portals:* Ayuntamiento InicialLoading Anonymous Portals...Loaded!!!Configuring system to use HTTPS:2750 ms to start it up.iSUM running succesfully!!!===================================================Done!Loading locators... ISUM loadedLoad successfullyInvoking GC......Done!

Una vez arrancado el servidor habrá que conectarse a la siguiente dirección para entrar en lapágina inicial: http://nombre_máquina/ppal

El usuario Administrador Global del portal es el ‘isumadmin’ sin contraseña.

Una vez nos hayamos conectado con dicho usuario deberemos ir al servicio “Mis Datos” eintroducir una contraseña.

A continuación, y sólo la primera vez que entremos tras la instalación, accederemos al serviciode “Sincronización de Usuarios” introduciremos como usuario ‘admin’, y como password‘admin’, y pulsaremos el botón de sincronizar.

Este proceso realiza una sincronización de los usuarios existentes en el multiportal isum y loscrea en la gestión de contenidos. Sin realizar este proceso, NO se verá ningún contenido enel portal, puesto que el acceso al gestor de contenidos requiere que los usuarios esténregistrados.

A partir de este punto, cerraremos la sesión y volveremos a entrar con el usuario AdministradorGlobal para empezar a trabajar con el producto.

6.1 VERSIONES DE LOS APLICATIVOS

Todos los aplicativos han sido marcados con su número de versión. Para acceder al número deversión, invocar la URL:

http://<nombre de la máquina>/<módulo>/version.html




Ejemplo:http://pistalocal.dip.es/ppal/version.html




7 CONFIGURACIÓN DE TAREAS BATCH

7.1 CARGAS DE PASARELAS

7.1.1 Procedimiento de carga

Esta es la aplicación encargada de realizar periódicamente la carga de nueva información en labase de datos a través de un archivo. Estos archivos podrán contener información padronal, deimpuestos o de facturas.

Para poder realizar de forma correcta el procedimiento de carga será necesario:

• cargar.jar : este fichero contiene los ficheros necesarios para la ejecución del procesode carga

• oracle-classes-9.0.2.jar/postgresql-7.4.1.jar: fichero que contiene el driver deconexión a la base de datos (para oracle o postgreSQL respectivamente).

• logging.jar: este fichero contiene las librerías necesarias para utilizar los archivos delogs.

• proc_carga.bat/proc_carga.sh: script que permite ejecutar el proceso de carga (parasistemas windows y Unix respectivamente).

• propertiesBD.properties: fichero con las propiedades de conexión a la base de datos.

Todos los ficheros deben estar en el mismo directorio. El fichero de propiedades de conexión ala base de datos (propertiesBD.properties) se muestra a continuación:

NOTA: Los parámetros de configuración de este fichero deben ser los mismos que se hanutilizado en la configuración de la fuente de datos para las pasarelas (pistaBD)

PROPERTIESBD.PROPERTIES (ejemplo para Oracle)

//dirección completa de conexión a la base de datosurl=jdbc:oracle:thin:@172.27.26.12:1521:dbtaxi//nombre del usuario para conexiónuser=pista//contraseñapassword=pista123//nombre del driver de conexión a la BBDDconexion=oracle.jdbc.driver.OracleDriver//Nombre de la base de datoscadenaConexion=dbtaxi //Directorio de trabajo, directorio a partir del cual se ubicaran los//ficheros de carga para ser actualizados en la base de datos. La//aplicación de carga recogerá esta ruta y generará a partir de ella //los directorios necesarios para la correcta ejecución del procesoworkDirectory=C:/PistaLocal/cargas/webCargas/work//Ruta al fichero de logficheroLog=C:/PistaLocal/logs/cargaArchivo.log




//variable que se utiliza para la carga de datos fiscales que nos indica el número// de meses que se añaden a la fecha de carga (fecha del sistema en el momento // que se lanza el proceso de carga). En este ejemplo, como el valor es 0 se toma la// fecha de carga.numeroMesesEstadoFiscal=0

NOTA: el proceso de carga fiscal borrará aquellos registros del portal cuya fecha de cargo seainferior a (fecha de carga + numeroMesesEstadoFiscal)

Es necesario, para la correcta ejecución del proceso de carga, tener correctamente configuradoslos parámetros workDirectory y ficheroLog del fichero PropertiesBD.properties. Una vezconfigurados esos parámetros, el script que lanza la aplicación (proc_carga.bat/proc_carga.sh)podrán ser ejecutadas desde cualquier ubicación siempre y cuando los cuatro ficheros queconforman la misma estén en el mismo directorio.

NOTA: el parámetro workDirectory debe coincidir con el parámetrocargaContableDirectory/cargaFiscalDirectory/cargaPadronDirectory del servicio Pasarela3exceptuando el sufijo propio de este último parámetro. Esto es así puesto que la administraciónde la carga almacena el fichero a cargar a partir de la ubicación que marca uno de los tresparámetros anteriores, y aquí, la aplicación debe buscar los ficheros de carga para realizar lamisma en la base de datos a partir del parámetro workDirectory.

Para sistemas Unix/Linux, debemos indicar la ruta completa del directorio donde se almacenantodos los ficheros que componen la aplicación de carga. Para ello establecemos un valor parala variable DIR_CARGA en el fichero que contiene el script (proc_carga.sh). Un ejemplo sería:

#!/bin/sh

DIR_CARGA=/usr/pista/carga

Etc ...

7.1.2 Cron Aplicación de carga

Este demonio es el encargado de lanzar periódicamente el proceso de carga de informaciónsobre la base de datos.

El siguiente ejemplo para sistemas operativos Unix resume el mecanismo de llamada al script.Se debe incluir la siguiente línea en el fichero /etc/crontab: 02 4 * * * root /usr/pista/carga/proc_carga.shDe tal manera que se ejecutará el script "proc_carga.sh" todos los días a las 4:02 como usuarioroot.El demonio "crond" recoge automáticamente los cambios producidos en el fichero "crontab"por lo que no es necesario reinvocarlo.




8 ANEXO A: CONFIGURACIÓN DEL SERVIDOR DEAPLICACIONES TOMCAT 5.0

8.1 PROPIEDADES DE ARRANQUE

Debe asegurarse que:

• La JDK utilizada por Tomcat es la 1.4.2

• Que la codificación de ficheros es “ISO-8859-1”.

• Que se puede usar AWT (librería gráfica interna de Java, utilizada para generar las“miniaturas” de las imágenes subidas al gestor de contenidos). Para ello debemoscomprobar que tenemos las librerías para que funcionen las X en Unix (aunque noestén levantadas).

• Que Tomcat puede compilar las JSPs de las aplicaciones que se instalen sobre él

• Que siempre se arranca el servidor de aplicaciones con el mismo usuario en máquinasUnix, puesto que Tomcat utiliza el sistema de ficheros para desempaquetar los war,compilar JSP’s, etc. y podrían existir problemas de permisos de acceso a ficheros.

8.1.1 WindowsUtilizar la distribución autoinstalable, que instalará y configurará las variables de entornocorrectamente.

8.1.2 UnixEditar el fichero “bin/catalina.sh” e incluir, tras los comentarios, las variables “JAVA_HOME”(que debe apuntar al directorio donde está instalada la JDK) y “CATALINA_OPTS” (queestablece la codificación de ficheros y permite usar AWT aunque no esté levantado un servidorX en la máquina Unix):

JAVA_HOME=/www/j2sdk1.4.2_04CATALINA_OPTS="-Dfile.encoding=ISO-8859-1 -Djava.awt.headless=true"export JAVA_HOME CATALINA_OPTS

FinalmenteCopiar la librería “$JAVA_HOME/lib/tools.jar” en el directorio“$TOMCAT_HOME/common/lib”. Esta librería incluye el compilador de Java, utilizado paracompilar las JSPs.

8.2 ACTIVAR LOS SERVLETS

En la versión 5.0.x de Tomcat por defecto los servlets cuya invocación es del tipohttp://maquina/app/servlet/com.foo.bar.TestServlet están deshabilitados, por lo que para suutilización en el proyecto PISTA, es necesario habilitar esta funcionalidad.

Para habilitar los servlets en tomcat hay que ir al fichero web.xml que se encuentra en eldirectorio $TOMCAT_HOME/conf y habilitar (quitar los comentarios) las siguientes partes delfichero de configuración:

Declaración del Invoker <servlet> <servlet-name>invoker</servlet-name>


<servlet-class> org.apache.catalina.servlets.InvokerServlet </servlet-class> <init-param> <param-name>debug</param-name> <param-value>0</param-value> </init-param> <load-on-startup>2</load-on-startup> </servlet>

Mapping de /servlet/* al Invoker  <servlet-mapping> <servlet-name>invoker</servlet-name> <url-pattern>/servlet/*</url-pattern> </servlet-mapping>

8.3 CONFIGURACIÓN PARA TRABAJAR CON SOPORTE SSL

La instalación inicial del producto PISTA necesita configurar el servidor de aplicaciones paraque trabaje en modo seguro mediante la utilización de un certificado de servidor.

Por defecto la instalación asume las siguientes premisas:

• Arranque del servidor no seguro en el puerto 80• Arranque del servidor seguro en el puerto 443• Acceso al portal de usuarios anónimos en modo no seguro.• Acceso al portal de usuarios registrados en modo seguro.

Si se desea modificar alguno de estos parámetros de configuración inicial se documentará en elanexo de este documento.

La información necesaria para confeccionar este apartado se ha obtenido de la web del proyectoTomcat de Apache:

http://jakarta.apache.org/tomcat/tomcat-5.0-doc/ssl-howto.html

8.3.1 Paso 1: Generación del Certificado de ServidorLa aplicación debe utilizar un certificado de servidor, éste certificado debe ser emitido por unaentidad de certificación válida, en el caso de las administraciones públicas, lo emite la FNMT.Se puede generar un certificado de prueba con el procedimiento que sigue a continuación, perose recomienda que se solicite un certificado oficial a la FNMT o a cualquier otra autoridad decertificación válida.

Para la generación del certificado se utiliza la herramienta keytool de Java, por lo tanto habráque ejecutar lo siguiente:

1. En entornos Windows:%JAVA_HOME%\bin\keytool -genkey -alias tomcat -keyalg RSA2. En entornos Unix:$JAVA_HOME/bin/keytool -genkey -alias tomcat -keyalg RSA

La aplicación solicitará una contraseña que deberá ser “changeit” en minúscula. Si se deseacambiar consultar la web de referencia.

A continuación la aplicación keytool solicitará los siguientes datos:

CN - Contact Name (Nombre y Apellido). Se deberá introducir el nombre del servidormediante el cual se va a acceder al portal. Es decir, si el portal va a estar accesible a través de laurl www.maquina.es se deberá introducir en este punto dicha url. La dirección url elegidadebe estar dada de alta en el servidor de nombres de dominio (DNS), para poder acceder a ella.

OU – Organization Unit (Unidad de la Organización). Nombre de la Unidad de laOrganización.

O – Organization (Organización). Nombre de la Organización.

L – Locality (Localidad). Localidad donde se ubica la Organización.

ST – State (Estado o Provincia). Estado o Provincia donde se ubica la Organización.

C – Country (Código de País). Código de país de dos letras donde se ubica la unidad.

En última instancia la aplicación solicitará una contraseña que deberá ser la misma que lautilizada en el punto anterior, es decir, “changeit”.Este proceso genera el fichero “.keystore” en el directorio “home” del usuario. Tomcat trataráde buscar allí este fichero. Este fichero contiene el certificado de servidor generado.

8.3.2 Paso 2: Configuración de TomcatPara configurar el servidor de aplicaciones deberemos editar el fichero server.xml, que seencuentra ubicado en $TOMCAT_HOME/conf. En el siguiente ejemplo se muestra un ejemplopara la versión 5.0.X (otras versiones pueden cambiar el formato).

<Connector port="80"

maxThreads="150"minSpareThreads="25"maxSpareThreads="75"enableLookups="false"redirectPort="443"acceptCount="100"debug="0"connectionTimeout="20000" disableUploadTimeout="true" />

<Connector port="443"

maxThreads="150"minSpareThreads="25"maxSpareThreads="75"enableLookups="false"disableUploadTimeout="true"acceptCount="100"debug="0"scheme="https"secure="true"><Factory clientAuth="false" protocol="TLS" />

</Connector>

Los cambios son (marcados en negrita):

o Cambiar el puerto HTTP a 80 en vez de 8080

o Cambiar el puerto HTTPS a 443 en vez de 8443 (hay que descomentar el conector)

La configuración de HTTPS busca el fichero “.keystore” en el directorio “home” del usuario. SiTomcat no encontrase el fichero (error FileNotFound en el “catalina.out”), se puede especificarel fichero agregndo a la etiqueta del conector HTTPs el atributo keystoreFile=”<path-al-fichero>”.

Una vez realizado esta modificación se puede arrancar el servidor de aplicaciones para realizarlas pruebas pertinentes.

8.3.3 Paso 3: Librerías necesarias para los Servicios WebEs necesario insertar dentro del directorio common/endorsed de Tomcat los siguientes ficheros:

• xmlParserAPIs.jar



• xml-apis.jar• xercesImpl.jar.

Estos ficheros corresponden a la librería Xerces, pero esta versión presenta problemas y es porello que hay que utilizar la versión 2.6.0. Para conocer los problemas producidos ver:

http://www.mail-archive.com/[email protected]/msg05737.html

8.4 HABILITAR LA ADMINISTRACIÓN REMOTA

Para permitir la administración remota del servidor Tomcat, es necesario introducir en elfichero ‘conf/tomcat-users.xml’ una línea del estilo a la mostrada en negrita a continuación:

<tomcat-users> <role rolename="tomcat"/> <role rolename="role1"/> <role rolename="standard"/> <role rolename="manager"/> <role rolename="admin"/> <user username="tomcat" password="tomcat" roles="tomcat"/> <user username="both" password="tomcat" roles="tomcat,role1"/> <user username="role1" password="tomcat" roles="role1"/> <user username="admin" password="admin" roles="standard,manager,admin"/></tomcat-users>

Con esto se crea un usuario con los roles manager y admin. Gracias a estos roles se puedeacceder a las aplicaciones de gestión del servidor Tomcat.

8.5 CONFIGURACIÓN DE UNA FUENTE DE DATOS

Las aplicaciones del producto PISTA delegan en el contenedor la gestión y configuración de lafuente de datos (DataSource) donde se almacena su información persistente. En esta sección seexplica cómo configurar Tomcat 5.0.X para que proporcione una fuente de datos a través deJNDI (extraído de la propia documentación de Tomcat).

Lo más sencillo es emplear la consola de administración que incorpora el propio Tomcat,accesible vía web en la URL: http://localhost/admin. Tras autenticarnos con el login/passwordde administración, veremos:




Antes de crear un DataSource deberemos crear el esquema de base de datos (Oracle, databaseen PostgreSQL) y el usuario para que el DataSource se pueda validar por parte del servidor deaplicaciones. Nos interesa especialmente la sección “Resources/Data Sources”, dondepodremos ver las fuentes de datos dadas de alta en el contexto, así como crear nuevas o borraralguna existente. Seleccionaremos crear una nueva fuente de datos y rellenaremos lossiguientes campos:

Las propiedades son:

• JNDI NameSe deberá introducir el nombre de la fuente de datos que deseemos. Pordefecto se pondrá “portalConnection” y “pistaBD” (para los aplicativos dewebapp.war, webPadron.war y webPasarela3.war), ya que las aplicaciones vienenconfiguradas por defecto con unos enlaces a unos DataSource con estos nombres.




• Data Source URL: Esta es la URL JDBC de conexión a la base de datos(“nombremaquina” es el nombre DNS de la máquina que alberga la BBDD, y el SID esel identificador del esquema de BBDD):

o ORACLE: jdbc:oracle:thin:@nombremaquina:1521:SIDo POSTGRESQL: jdbc:postgresql://nombremaquina/SID

• JDBC Driver Class: Esta es la clase del driver JDBC de la base de datos. MUYIMPORTANTE : el JAR con el driver debe ubicarse en el directorio $TOMCAT_HOME/common/lib. Estos drivers suelen acompañar a la distribución dela BBDD (normalmente bajo un directorio “jdbc”), aunque también pueden descargarsede la web. Oracle suele llamarle “classes12.jar” (Postgre depende; ver documentaciónde la BBDD).

o ORACLE: oracle.jdbc.driver.OracleDrivero POSTGRESQL: org.postgresql.Driver

• User Name y Password: Nombre de usuario y password para conectarse a la base dedatos.

• Max Active Connections: Tamaño máximo del pool de conexiones, esto es, el númeromáximo de conexiones abiertas contra la base de datos.

• Max Idle Connections: Número máximo de conexiones en espera que puede “retener”el pool.

• Max Wait for Connection: Tiempo máximo de espera (en milisegundos, 5000 = 5seg.) cuando se intenta obtener una conexión (-1 para espera infinita).

• Validation Query: Consulta de validación del DataSource. Es necesario utilizar unaconsulta válida que devuelva resultados para la base de datos utilizada. Se recomiendautilizar las siguientes consultas de validación:

o ORACLE: select sysdate from dual

o POSTGRESQL: select current_date

Opcionalmente, estas propiedades pueden configurarse en el fichero de configuración delservidor (server.xml):

<GlobalNamingResources>[...]

<Resource name="portalConnection" type="javax.sql.DataSource"/><Resource name="pistaBD" type="javax.sql.DataSource" scope="shareable"/>

<ResourceParams name="portalConnection"> <parameter> <name>url</name> <value>jdbc:postgresql://nombremaquina/SID</value> </parameter> <parameter> <name>driverClassName</name> <value>org.postgresql.Driver</value> </parameter> <parameter> <name>username</name> <value>myuser</value> </parameter> <parameter> <name>password</name> <value></value> </parameter> <parameter> <name>maxActive</name> <value>4</value> </parameter> <parameter> <name>maxIdle</name>




<value>2</value> </parameter> <parameter> <name>maxWait</name> <value>5000</value> </parameter> <parameter> <name>validationQuery</name> <value>select sysdate from dual</value> </parameter> </ResourceParams>

<ResourceParams name="pistaBD"> <parameter> <name>url</name> <value>jdbc:oracle:thin:@localhost:1521:dbtaxi</value> </parameter> <parameter> <name>validationQuery</name> <value>SELECT * FROM INFO_CONTABLE</value> </parameter> <parameter> <name>maxIdle</name> <value>4</value> </parameter> <parameter> <name>maxActive</name> <value>10</value> </parameter> <parameter> <name>driverClassName</name> <value>oracle.jdbc.driver.OracleDriver</value> </parameter> <parameter> <name>maxWait</name> <value>30000</value> </parameter> <parameter> <name>removeAbandoned</name> <value>true</value> </parameter> <parameter> <name>username</name> <value>pista</value> </parameter> <parameter> <name>logAbandoned</name> <value>true</value> </parameter> <parameter> <name>removeAbandonedTimeout</name> <value>10</value> </parameter> <parameter> <name>password</name> <value>pista123</value> </parameter> </ResourceParams></GlobalNamingResources>

El siguiente paso antes de guardar los cambios en el servidor de aplicaciones Tomcat, esasegurarnos que nuestras aplicaciones tienen acceso al DataSource dado de alta, para elloiremos a ‘Tomcat Server/Service (Catalina)/ Host/Context/(Nombre Aplicacion)/Resources/ Resource Links’ y comprobaremos que existe una entrada como la mostrada en lasiguiente imagen, en la que se muestra el nombre con el que se ha mapeado desde la aplicación(jdbc/agpal, en el ejemplo) con el nombre que tiene a nivel Global el DataSource que se va autilizar (portalConnection, en el ejemplo).




En cada aplicación se debe configurar el enlace al DataSource de forma correcta, puesto quemediante este mapeo se accederá al DataSource global que hemos creado con anterioridad. Sino existe, o difiere algún parámetro deberemos modificarlo, de la forma siguiente:

Donde los parámetros serán:

- Nombre: Nombre utilizado desde la aplicación web para trabajar con el DataSource, ydefinido en el web.xml. Es recomendable no modificarlo.

- Global: Nombre del DataSource global, con el cual se quiere enlazar.

- Tipo: Tipo del Recurso con el que se enlaza, en nuestro caso siempre será“javax.sql.DataSource”

NOTA: Siempre que se desee almacenar los cambios en la herramienta de administración,se deberá pulsar el botón “Acometer Cambios”. Este botón reinicia el servidor deaplicaciones, almacenando los cambios.

Es importante también reseñar que al almacenar los cambios, el fichero server.xml sepuede corromper. (Esto ocurre con algunas versiones del servidor Tomcat). Para evitar




este problema, lo aconsejable es guardar una copia de dicho fichero, tras haberconfigurado el puerto seguro https 443.

8.6 CONFIGURACIÓN DE ENTRADAS (PARÁMETROS) DE ENTORNO

Las aplicaciones del producto PISTA utilizan entradas de entorno para configurar susaplicaciones. Dichos parámetros se configuran a través de la herramienta de administración delservidor de aplicaciones que se este utilizando. En esta sección se explica cómo configurar laentradas de entorno para el servidor Tomcat 5.0.X

Para modificar las entradas de entorno de una aplicación concreta deberemos acceder a laaplicación de administración (http://nombreMaquina/admin) y acceder a la ruta del árbol de laparte izquierda: ‘Tomcat Server/Service (Catalina)/ Host/Context/(Nombre Aplicacion)/Resources/Environment Entries’ y modificar los valores para las entradas que aparezcan paradicha aplicación, de esta forma, nuestra aplicación se puede configurar de una forma mássencilla y sin tener que parar el servidor de aplicaciones.

Para modificar una entrada pulsaremos sobre el nombre de dicha entrada y se nos presentaráuna pantalla en la que podremos modificar el valor de dicha entrada, tal y como se muestra acontinuación.




9 ANEXO B: PREPARACIÓN DE LA BBDD PARA INSTALAR ELPRODUCTO

La instalación del multiportal de PISTA Administración Local precisa de una BBDD desoporte. En esta sección se documentan los procesos de preparación en dos de los motores másfrecuentes: oracle y postgresql.

El producto sólo necesita un espacio “vacío” en la BBDD, ya que durante el proceso dearranque se verifica si existen o no las tablas y sus datos, y se ejecutan automáticamente losscripts que fueran necesarios.

9.1 INSTALACIÓN EN ORACLE

El software de multiportal utilizado en el proyecto Pista Administración Local recomienda parasu instalación en bases de datos Oracle la creación de dos tablespaces distintos, uno paraalmacenar datos y otro para almacenar índices.

9.1.1 Creación de TablespacesEl primer script que se proporciona es el de la creación de tablespaces. El fichero se llama‘ora_tablespaces.sql’. En él deberemos configurar el tablespace en el que se almacenarán losdatos e índices del usuario del multiportal. Además es necesario modificar el fichero paraubicar los dbf en la máquina de la base de datos.

Por defecto se utilizará ISUM_DATA para el tablespace de datos e índices, con un tamaño de50 Mb.

Este script se debe lanzar con un usuario Administrador de la Base de Datos (system, o algúnusuario con rol DBA)

9.1.2 Creación del usuario de Base de DatosEl segundo script que se proporciona es el de la creación del usuario de base de datos utilizadopor el software de multiportal, se llama ‘ora_user.sql’. En él se deberá configurar el nombre delusuario, su password, y los tablespaces en los que tiene cuota para escribir.

Por defecto se utilizará como usuario ISUM y password ISUM, teniendo cuota ilimitada sobrelos tablespaces por defecto ISUM_DATA. Además se le otorgan los roles connect y resourcede oracle por defecto.

Este script se debe lanzar con un usuario Administrador de la Base de Datos (system, o algúnusuario con rol DBA)

9.2 INSTALACIÓN EN POSTGRESQL4

La instalación sobre la base de datos PostgreSQL no tiene especificado ningún diseño físico,sin embargo existen también cinco scripts para la creación del usuario de Base de Datos delaplicativo, aunque el orden difiere del de la instalación anterior. La ejecución de los scriptsnecesita que se realice desde la ubicación en la que se encuentran los mismos, en caso contrariose deberá especificar la ruta completa a los ficheros en cada ejecución del comando ‘psql’.

4 Se recomienda la siguiente dirección URL para un tutorial paso a paso de Postgre sobre Windows(aunque se instale sobre Linux, muchos de los conceptos son los mismos):http://www.ejip.net/faq/postgresql_win_setup_faq.jsp




NOTA: Si se ha configurado correctamente el DataSource del servidor de aplicaciones,únicamente es necesario realizar los dos primeros pasos, puesto que la creación de laestructura de tablas, la inserción de datos y la activación de las constraints se realizará porparte de la aplicación al inicializarse por primera vez.

9.2.1 Creación del usuario de Base de DatosPara ello deberemos ejecutar el script de base de datos ‘pg_user.sql’. Este script lo deberemosejecutar desde el usuario administrador de la base de datos.

Para crear el usuario deberemos ejecutar el script desde un Terminal unix (o cygwin en caso deWindows) el comando a utilizar es el siguiente:psql -d template1 -f pg_user.sqlDonde template1 es el nombre de la base de datos del sistema, para poder averiguar cuál es, sepuede utilizar el comando psql –l que devuelve la lista de bases de datos existentes en elsistema.

Este script creará el usuario isum con el password isum, si se desea cambiar alguno de estosdatos, será necesario modificarlo en el script. El usuario creado necesitará tener el permiso“CREATEDB” necesario para la creación de la base de datos para el software de portal.

9.2.2 Creación de la Base de DatosPara crear la base de datos se deberá ejecutar el script ‘pg_database.sql’. Este script lodeberemos ejecutar desde el usuario que hemos creado en el paso anterior.

Para crear la base de datos deberemos ejecutar el script desde un Terminal unix (o cygwin encaso de Windows), el comando a utilizar es el siguiente:psql -d template1 -U isum -W -f pg_database.sqlDonde template1 es el nombre de la base de datos del sistema, y isum es el nombre del usuarioque va a crear la base de datos, que será su propietario. Éste usuario debe ser el mismo que seha creado en el punto anterior.

Por defecto se utiliza ‘ISUM’ como nombre de base de datos, para modificarlo habrá quemodificar el script.

NOTA: Se debe especificar el encoding de la base de datos a ‘UNICODE’ en su creación




10 ANEXO C: INSTALACIÓN DEL MODELO DE BASE DE DATOSPARA LAS AGENDAS

La instalación del módulo de las Agendas de PISTA Administración Local precisa de unaBBDD de soporte. Por defecto, el módulo utiliza el mismo espacio de BBDD que el portal, porlo que no hay que hacer nada especial: cuando se despliegue la aplicación se crearán las tablascorrespondientes, y se poblarán de los datos de arranque.




11 ANEXO D: INSTALACIÓN DEL MODELO DE BASE DE DATOSPARA LOS SERVICIOS WEB PISTA

Este apartado comprende la instalación del modelo de base de datos necesario para losServicios Web PISTA. Hay que tener en cuenta que esta base de datos se instala junto con losservicios web de contable, fiscal y padrón (webapp.war y webPadron.war), y no tienen por quéestar en la misma máquina que la tercera pasarela.

11.1 INSTALACION EN ORACLE

A continuación se detallan los pasos necesarios para dejar operativa la base de datos empleadapor los servicios web PISTA empleando un SGBD Oracle. Serán necesarios 3 scripts:

11.1.1 Creación de la estructura de tablasEn desarrollo se esta empleando el tablespace por defecto del sistema.

11.1.2 Creación de cuenta de usuarioSe empleara la cuenta usada durante el proceso de instalación del sistema.

Para la ejecución de los siguientes scripts se recomienda usar SQL*Plus. Pinchando en‘Fichero’ -> ‘Abrir’. Solo tendremos que seleccionar el script correspondiente.

11.1.3 Creación de las tablas de la base de datosPara tal fin será necesario usar el fichero CreacionBDPistaLocal_or.sql .




11.1.4 Creación de los procedimientos de carga padronal, contable y fiscal.Se hará uso del fichero ProcsCarga_or.sql

11.1.5 Inserción de la información en las tablas con información fijaPara ello se empleara el fichero DatosTablasFijas_or.sql.

Con estos pasos ya tendríamos configurada la base de datos para poder realizar consultas sobreella.

11.2 INSTALACION EN POSTGRESQL

Para poder utilizar el lenguaje pl/pgSQL en una determinada BDD debemos instalarlotecleando desde línea de comandos como usuario postgres lo siguiente:

# su - postgres# createlang plpgsql PISTA_DB

Siendo PISTA_DB el nombre de la base de datos.

11.2.1 Creación del usuario de la base de datosPara tal fin será necesario ejecutar el script postgre_user_webPISTA.sql

El comando a ejecutar para tal fin es:

psql -d template1 -f postgre_user_webPISTA.sql

11.2.2 Creación de la base de datosPara ello será necesario ejecutar el script postgre_database_webPISTA.sql

El comando será el siguiente:

psql -d template1 -f postgre_database_webPISTA.sql

11.2.3 Creación de las tablas de la base de datosPara ello se ejecutara el siguiente script postgre_tables_webPISTA.sql


psql -d PISTA_DB -U pista_user -W -f postgre_tables_webPISTA.sql

11.2.4 Creación de los índices de las tablasSerá necesario ejecutar el siguiente script postgre_index_webPISTA.sql


psql -d PISTA_DB -U pista_user -W -f postgre_index_webPISTA.sql

11.2.5 Creación de las restricciones de las tablasSerá necesario ejecutar el siguiente script postgre_constraints_webPISTA.sql


psql -d PISTA_DB -U pista_user -W -f postgre_constraints_webPISTA.sql

11.2.6 Inserción de los datos en las tablas creadasSerá necesario ejecutar el siguiente script postgre_data_webPISTA.sql


psql -d PISTA_DB -U pista_user -W -f postgre_data_webPISTA.sql




11.2.7 Creación de los procedimientos de carga padronal, contable y fiscalPara tal fin habrá que ejecutar el siguiente script: ProcsCarga_webPISTA.sql


psql -d PISTA_DB -U pista_user -W -f ProcsCarga_webPISTA.sql




12 ANEXO E: TUNNING DE LA APLICACIÓNNo cualquier configuración de la aplicación funcionará con iguales prestaciones. Por eso, no essuficiente “dejar caer” la aplicación si queremos obtener resultados decentes. En este apartadose recogen las recomendaciones generales para hacer una configuración más “fina”.

12.1 POOL DE CONEXIONES

Las aplicaciones que acceden a la BBDD lo hacen a través de un pool de conexiones definidoen el servidor. En número máximo de conexiones abiertas establece la cota máxima de accesossimultáneos a la base de datos.

Un número insuficiente puede bloquear la aplicación cuando muchos usuarios acceden a laaplicación. No hay que olvidar, además, que una única instalación da soporte a múltiplesportales y, por tanto, se multiplican los accesos.

12.2 PARÁMETROS DE ARRANQUE DE LA JVM

Los parámetros de arranque de la Maquina Virtual hacen referencia al espacio en memoria queva a usar la aplicación , estableciendo el comienzo del heap y su tamaño máximo (en elejemplo, el heap tiene un rango entre 256 Mb y 512 Mb), así como al tipo de máquina virtualJava a utilizar:

JAVA_OPTS='-server -Xms256M -Xmx512M'




13 ANEXO F: PROBLEMAS QUE PUEDEN SURGIR DURANTEEL PROCESO DE CARGA DE INFORMACIÓN EN LA BBDD

Como consecuencia de la ejecución de un proceso de carga, se pueden producir los siguientesproblemas relacionados con la interacción de dicha aplicación con la base de datos (basado enBBDD Oracle):

- .ORA-04031: unable to allocate 4176 bytes of shared memorySolución: modificar la variable shared_pool_size del init.ora.

- .ORA-01858: a non-numeric character was found where a numeric was expectedEl problema es debido a que en el nombre del fichero que se va a cargar no viene lafecha de consolidación en formato DDMMYY.

La solución pasa por añadir la fecha directamente en el nombre del fichero utilizando elmodulo de subida de ficheros de carga en el servidor.

- .java.lang.StringIndexOutOfBoundsException: String index out of range: 169El problema es debido a que el archivo a cargar en Base de Datos en su ultima línea hayun retorno de carro.

La solución pasa por eliminar dicho retorno del fichero a cargar.

- .ORA-01562: failed to extend rollback segment number 2 ORA-01628: max #extents (505) reached for rollback segment R02La solución pasa por aumentar el segmento de rollback, esto es tarea de un DBA, unapagina que puede servir de ayuda

http://www.experts-exchange.com/Databases/Oracle/Q_20097770.html.

Otra de las soluciones pasa por hacer los INSERT y los DELETE paginados.

- .ORA-06502: PL/SQL: numeric or value error: character string buffer too smallEsto ocurre porque el código INE del ayuntamiento es una cadena mayor de 5caracteres. Comprobarlo en las propiedades del portal.




14 ANEXO H: RESOLUCIÓN DE PROBLEMAS FRECUENTES ENEL PROCESO DE INSTALACIÓN

14.1 CONFIGURACIÓN DEL SERVIDOR UNIX

14.1.1 Aún me salen mal los acentosComprobar que el lenguaje utilizado en la máquina Unix es el ISO-8859-1 para la codificaciónde los ficheros, para realizar esta comprobación hay que mirar la propiedad de entorno LANG,que debe valer es_ES.ISO-8859-1. Este problema ocurre al desempaquetar las aplicacioneswar, puesto que el lenguaje por defecto es el UTF-8 (no utiliza acentos), al desempaquetar losficheros, los codifica sin tener en cuenta los acentos. Para corregir este problema hay quelimpiar la base de datos, y los directorios donde se desempaquetan las aplicaciones, cambiar lacodificación y volver a arrancar el servidor de aplicaciones.

NOTA sobre el idioma en Linux (solución aportada por Diputación de Huesca sobre unDebian): Instalar, mediante el comando "tasksel", la opción de idioma español, y después(IMPORTANTE) instalar el paquete “localeconf”, (apt-get install localeconf), durante laconfiguración del paquete “localeconf” se le dice que ponga “es_ES.ISO-8859-1” para todo yya no hace falta definir variables para el idioma en “catalina.sh” ni en ningún otro sitio.

14.2 INSTALACIÓN DEL TOMCAT

14.2.1 He cambiado la configuración del Tomcat al puerto 80 y 443 y ahora no me vaConfirmar que no está ocupado el puerto 80 y 443 con otro servidor (p.e. un Apache).

14.2.2 Mi máquina de producción ya está utilizando los puertos 80 y 443, ¿puedocambiarlos a otros?

La aplicación está configurada para que funcione con los puertos 80 y 443, pero se puedemodificar cualquiera de los dos, los pasos a seguir son:

• Cambiar los puertos en el servidor de aplicaciones.

• Acceder a la Base de datos utilizada y actualizar la tabla ‘SERVERS’ con los nuevosvalores en la columna ‘SRV_PORT’.

• Arrancar el servidor de aplicaciones, acceder a la herramienta de administración delTomcat, y modificar la configuración de la aplicación ppal, para que refleje loscambios en los puertos.


PISTA Administración Local · 01 actualizacion: Scripts para actualizar la Base de Datos de los...

Documents

Transcript of PISTA Administración Local · 01 actualizacion: Scripts para actualizar la Base de Datos de los...