Manual de Actualización - La Forja de Guadalinex
Contents
1. 7 HISTORIALDE CAMBIOS Dirigirse al documento de novedades de la versi n P gina 18 de 182. UA JUNTA DE ANDALUCIA Portafirmas Manual de Actualizaci n Versi n INS005 Fecha 11 07 2011 Versi n 2 3 0 Portafirmas ON Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA HOJA DE CONTROL nas rante e Aprobado por REGISTRO DE CAMBIOS CONTROL DE DISTRIBUCI N Nombre y Apellidos Mar a Luisa de la Vega Royo Manuel Baena Fern ndez Francisco Jos Cantero Villar Manuel Mart n Soria P gina 3 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA Miguel J V zquez Rebollo P gina 4 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA NDICE 1 REQUISITOS PREVIOS DE LA ACTUALIZACI N cococccoccocococcnoncnoononononennonanenconoconinonnonococnnoconocononos 4 2 PROCEDIMIENTO DE ACTUARON 5 21 Comprobaci n de versi n ACA iaa A A A 5 2 2 Copia de Seguridad de los Ficheros de Configuraci nN oocccccconcccccnononacininonononanononnnnnnnanononaninonane 6 3 MATRIZ DE ACTUALIZACI N A ia di 7 al custodia y Visto BUENO A ES 7 32 Frma y Multirma MASIVA ib 7 3 3 Prefirma Alfresco y SMTP nerds 8 94 Ml OS ont AA EA E A 8 4 RESTAURAR COPIA DE LA CONFIGURACI N DE LA APLICACI N ccccocccccccccocooicoicoinoinaccnocooccconos 9 5 REVISI N DE LA CONFIGURACI N orinar ii is 11 6 KODULOS EXTERNOS cn A is 12 7 HIS TORIAL DE CAMBIOS o sr to SS
3. n para poder ejecutar la posibilidad de definir otras custodias que no sea la tradicional basada en base de datos o poder definir lineas de firma con vistos buenos intermedios Para ello hay que lanzar el script ubicado en la siguiente ruta de los fuentes en maven de la aplicaci n mediante el cliente SQL que prefiramos pfirmav2 src main database oracle actualizacion script_datos_v20b_v20 sql Una vez lanzado el script si todo es correcto hacer commit para que se guarden los cambios en la base de datos 3 2 Firma y Multifirma masiva Se trata de cargar una serie de nuevos par metros que necesita la aplicaci n para poder configurar que tipo de firma se emplear firma en bloque o masiva y la forma en que se firmar n los datos firmar el contenido binario o el hash Para m s informaci n sobre la P gina 11 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA configuraci n de los par metros comentados anteriormente revisar el Manual de Administraci n Para ello hay que lanzar el script ubicado en la siguiente ruta de los fuentes en maven de la aplicaci n mediante el cliente SQL que prefiramos pfirmav2 src main database oracle actualizacion script_datos_v20_v21 sql Una vez lanzado el script si todo es correcto hacer commit para que se guarden los cambios en la base de datos 3 3 Prefirma Alfresco y SMTP Incluye una serie de nuevos par metros
4. from qrtz_cron_triggers 3 DBA 2 Minutos delete from qrtz_simple_triggers delete from qrtz_triggers delete from grtz job details 4 DBA Lanzar el script de vuelta a atr s 2 Minutos pfirmav2 src main database oracle rollback script_datos_v23_v22 sql sql P gina 14 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA pfirmav2 src main database postgresql rollback script datos _pg_v23_v22 sql sql seg n proceda Restituir el WAR anterior de la aplicaci n a gt Aene partir de la copia de seguridad a Se recomienda limpiar los directorios 6 Sietas temporales del servidor de aplicaciones por 1 Minuto lo general work temp y logs depender de cada tipo de servidor 7 Sistemas Reiniciar el servidor de aplicaciones 5 minutos P gina 15 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA 5 REVISI N DE LA CONFIGURACI N Seguir el manual de administraci n y volver a una configuraci n que no haga uso de las funcionalidades desarrolladas en la versi n fallida P gina 16 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA 6 M DULOS EXTERNOS La configuraci n de m dulos externos viene descrita en el manual de administraci n P gina 17 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA
5. E A SERA RA RARO 13 P gina 5 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n 1 REQUISITOS PREVIOS DE LA ACTUALIZACI N El objetivo del presente documento es indicar los pasos a dar al actualizar la versi n Portafirmas V2 3 indicando paso a paso los cambios que debemos hacer si venimos de versiones anteriores La actualizaci n se limitar a lanzar una serie de scripts de base de datos que a adir n nuevas opciones a la aplicaci n correspondientes a la versi n a instalar Para desplegar el nuevo WAR de la aplicaci n deber seguirse la instrucciones de instalaci n a partir del punto del empaquetado automatizado en maven o configuraci n manual de la aplicaci n Se debe por tanto de partir de una instalaci n previa de la aplicaci n en su versi n v2 0 Si se tiene una versi n 1 X hay que seguir los pasos de migraci n descritos en el manual de instalaci n Es necesario desconectar a los usuarios antes de comenzar la actualizaci n S Es necesario revisar y preparar la marcha atr s antes de comenzar a ejecutar la actualizaci n P gina 6 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA 2 PROCEDIMIENTO DE ACTUALIZACI N Para actualizar de versi n se recomienda seguir los siguiente pasos 1 Comprobar la versi n actual y revisar la matriz de cambios necesarios 2 Detener el servidor de aplicaciones y asegurarnos que no hay nadi
6. ain database oracle actualizacion script_datos_v22_v23 sql PostgreSQL pfirmav2 src main database postgresqlactualizacion script datos pg v22 v23 sql Una vez lanzado el script si todo es correcto hacer commit para que se guarden los cambios en la base de datos P gina 13 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA 4 RESTAURAR COPIA DE LA CONFIGURACI N DE LA APLICACION Es necesario eliminar sin nimos p blicos para la marcha atr s Indique cuales NO Es necesario eliminar roles para la marcha atr s Indique cuales NO Es necesaria la restauraci n del esquema previo backup NO Es necesario restaurar el software anterior previa copia S Operaciones Orden Perfil Descripci n Tiempo 1 Sistemas Detener el servidor de aplicaciones 2 Minutos Comprobar que no hay sesiones activas en el servidor En el caso de tener una base de Oracle podemos comprobar la sesiones activas de base de datos mirando la vista v session en las columnas machine y username 2 DBA Solo debe aparecer el puesto desde 5 Minutos el cual estamos conectados En el caso de PostgreSQL con la aplicaci n pgAdmin3 en el men Herramientas Estado de Servidor podemos ver todas las conexiones activas existentes solo debe aparecer el puesto actual Limpiar las tablas de Quartz para evitar problemas con el serializado de tareas delete
7. e usando la aplicaci n durante el proceso de actualizaci n de base de datos 2 1 En el caso de tener una base de Oracle podemos comprobar la sesiones activas de base de datos mirando la vista v session en las columnas machine y username Solo debe aparecer el puesto desde el cual estamos conectados 2 2 En el caso de PostgreSQL con la aplicaci n pgAdmin3 en el men Herramientas Estado de Servidor podemos ver todas las conexiones activas existentes solo debe aparecer el puesto actual 3 Hacer copia de seguridad de los ficheros de configuraci n 4 Apuntar los datos de conexi n de base de datos para poder restablecerlos 5 Actualizaciones a realizar 5 1 No hay cambios que realizar seg n la matriz pasar al siguiente punto 5 2 Hay cambios a realizar aplicar todos los indicados en la matriz 6 Desplegar el nuevo WAR de la aplicaci n generado autom ticamente desde maven o actualizando manualmente el mismo siguiendo los pasos descritos en el manual de Instalaci n 7 Se recomienda limpiar los directorios temporales del servidor de aplicaciones por lo general work temp y logs depender de cada tipo de servidor 8 Arrancar de nuevo el servidor de aplicaciones Veamos a continuaci n las operaciones necesarias para realizar la actualizaci n 2 1 Comprobaci n de versi n actual Para saber que versi n de la aplicaci n tenemos desplegada podemos mirarlo dentro de la estruct
8. la base de datos hibernate connection username Usuario de conexi n de base de datos hibernate connection password Clave del usuario de conexi n de base de datos Si tenemos dudas a este respecto el Manual de Instalaci n nos puede servir para repasar la configuraci n a nivel de Hibernate y los distintos tipos de Base de Datos El guardar estos archivos y apuntar estos valores es una medida adicional de seguridad la copia de P gina 9 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA seguridad debe ser sobre todo del WAR preconfigurado de la aplicaci n P gina 10 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA 3 MATRIZ DE ACTUALIZACI N A continuaci n se detallan los cambios que tenemos que hacer en nuestro sistema para actualizar hasta la ltima versi n disponible Versiones anteriores Actualizaciones a realizar 3 1 Custodia y Visto Bueno X 3 2 Firma y multifirma X X masiva 3 3 Prefirma Alfresco y X X X SMTP 3 4 Firma IOS X X X X La actualizaci n mediante scripts SOLO debe hacerse si partimos de una de las versiones anteriores descritas Si hacemos una instalaci n desde cero esta ya incorpora todos los cambios necesarios y por tanto NO es preciso actualizar nada 3 1 Custodia y Visto Bueno Se trata de cargar una serie de nuevos par metros que necesita la aplicaci
9. ura de carpetas de la aplicaci n dentro del siguiente fichero pfirmav2 WEB INF classes version properties P gina 7 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA P gina 8 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA El contenido de este archivo nos indica la versi n version v2 X Y date DD MM YYYY client JUNTA DE ANDALUCIA clientAbreviature ja title Portafirmas build 2 X Y Z Los datos importantes en este caso es el de version centr ndonos en los dos primeros d gitos el cual nos permitir saber los cambios que tenemos que hacer para subir de versi n 2 2 Copia de Seguridad de los Ficheros de Configuraci n Se recomienda hacer una copia de seguridad de la aplicaci n completa Si se ha seguido el manual de instalaci n bastar con guarda una copia del WAR generado autom ticamente desde maven o bien precompilado y actualizado manualmente Con eso bastar a si bien por conocimiento los archivos que contienen la configuraci n de la aplicaci n son Archivo Descripci n pfirmav2 WEB INF classes META INF persistence xml Conexi n Base de Datos pfirmav2 WEB INF classes logback xml Trazas pfirmav2 WEB INF classes quartz properties Propiedades Quartz Es importante apuntarnos los siguientes valores Propiedad Descripci n hibernate connection url Indica la ruta de conexi n a
10. y constantes para poder a adir un nuevo estado previo antes de firma en entornos donde no existe la posibilidad de ejecutar el cliente de firma se ha incluido a la distribuci n principal la implementaci n con el gestor documental alfresco y por ltimo se a ade un par metro para habilitar o no la autenticaci n con servidores SMTP Para ello hay que lanzar el script ubicado en la siguiente ruta de los fuentes en maven de la aplicaci n mediante el cliente SQL que prefiramos en funci n a nuestro gestor de base de datos Oracle pfirmav2 src main database oracle actualizacion script_datos_v21_v22 sql PostgreSQL pfirmav2 src main database postgresqlactualizacion script datos pg v21 v22 sdi Una vez lanzado el script si todo es correcto hacer commit para que se guarden los cambios en la base de datos y los cambios se habran llevado a efecto 3 4 Firma IOS Se trata de cargar una serie de nuevos par metros que necesita la aplicaci n para poder firmar en el componente de autenticaci n y firma de lOS as como para la nueva estructuraci n de las pantallas de administraci n Para ello hay que lanzar el script ubicado en la siguiente ruta de los fuentes en maven de la aplicaci n mediante el cliente SQL que prefiramos en funci n a nuestro gestor de base de P gina 12 de 18 Portafirmas Innovaci n y Prospectiva Manual de Actualizaci n JUNTA DE ANDALUCIA datos Oracle pfirmav2 src m
Download Pdf Manuals
Related Search