Manual de Operaciones

Transcripción

1 Manual de Operaciones

2 Manual de Operaciones Versión 1.5 publicado 17-Agosto-2005 Copyright Gobierno del Principado de Asturias 2005

3

4 Tabla de contenidos 1. Introducción Despliegue... 2 Despliegue de aplicaciones en OC4J Standalone... 2 Configurando el despliegue local de aplicaciones... 2 Configurando el despliegue remoto de aplicaciones... 2 Fases del despliegue de aplicaciones... 3 Desinstalando una aplicación desplegada... 3 Despliegue en Oracle IAS Inicialización... 5 Inicialización de la aplicación... 5 Variables ${ } en el fichero de inicialización... 5 Especificación de paths Ficheros de inicialización de la aplicación en blanco Configuración El Sistema de Configuración del FW-PA Contextos de Configuración Plugins de Configuración Configuración del Sistema de Monitorización de Actions Ejemplo de configuración en la SampleApp (Carrito) Ficheros de Configuración J2EE Ficheros J2EE Configuración de filtros Filtro GZIP Filtro de seguridad Filtro de Navegación Servlet Controlador del FW-PA Configuración de página de inicio Configuración de las librerías de tags Configuración de la seguridad Seguridad en el FW-PA Configuración del Contenedor OC4J Crear el certificado de seguridad Configuración para la integración con el Módulo Común de Autenticación Configuración para la integración con el modulo de autenticación standalone El Fichero de Usuarios Escribir el fichero de reglas de la seguridad Conexiones a Bases de Datos Configuración de Conexiones con bases de datos Configuración de Conexiones en OC4J Stadanlone Configuración de Conexiones en OC4J IAS Gestión de Logs Gestión de Logs Configuración del Sistema de Logging Configuración de arranque Configuración de runtime Loggers Appenders Layouts Logs de aplicación y seguimiento de errores Logs de acceso Pista de auditoria iv

5 Manual de Operaciones 9. Metricas Métricas de rendimiento Métricas de uso Consola de Administración Consola JMX Configuración de JMX en OC4J Configuración del sistema de management Operación con la consola JMX Catálogo de objetos gestionables del FW-PA Contador de accesos a la aplicación Contador de excepciones incontroladas Filtro GZIP Sistema de Logging Monitor del Sistema Información de versión del FW-PA Plug-ins de configuración v

6 Lista de figuras 4.1. Estructura del sistema de configuración Configuración de la aplicación de ejemplo (Simple App) Captura del fichero http-web-site.xml Captura del fichero secure-web-site Estados del Sistema de Logging vi

7 Lista de tablas vii

8 Capítulo 1. Introducción El Gobierno del Principado de Asturias ha creado un framework de desarrollo en lo sucesivo FW-PA - para facilitar el desarrollo e implantación de aplicaciones basadas en la tecnología J2EE. Los dos grandes objetivos del framework son: 1. Simplificación del proceso de desarrollo de aplicaciones. Para ello el FW-PA proporciona un conjunto de herramientas y librerías que implementan algunos de los componentes más habituales (y de escritura más tediosa) en aplicaciones web. 2. Definición de estándares de desarrollo, calidad y aceptación. Se trata de un conjunto de directrices, de obligado cumplimiento, para exigir y garantizar unos niveles mínimos de calidad en las aplicaciones J2EE. En este documento se detalla cómo realizar el despliegue, la configuración y la administración de las aplicaciones J2EE desarrolladas sobre el FW-PA. Se introducirá también el uso de la herramienta de administración principal del FW-PA: la consola de gestión. A través de la consola de gestión, los administradores pueden controlar el estado de las aplicaciones y realizar configuraciones en caliente de los componentes del framework. Además, determinados servicios son también gestionables de forma dinámica, lo que permitirá que éstos sean arrancados o detenidos sin necesidad de parar el servidor. 1

9 Capítulo 2. Despliegue Despliegue de aplicaciones en OC4J Standalone El despliegue de aplicaciones realizadas sobre el framework de desarrollo del Principado de Asturias se hace utilizando la herramienta Ant. Para ello, se incluyen una serie de targets en el fichero build.xml de la aplicación en blanco (App Blank). Estas tareas Ant han de parametrizarse por el personal de Sistemas para que apunte a la(s) instancia(s) de OC4J del entorno destino. Se da opción a hacer dos tipos de despliegue: local y remoto. El despliegue local está pensado para las pruebas locales que realice el desarrollador en su puesto de desarrollo, mientras que el remoto se daría en el caso de desplegar en un servidor remoto. Configurando el despliegue local de aplicaciones Para lanzar este proceso es necesario configurar una serie de propiedades del fichero build.xml. Un ejemplo de configuración de estas propiedades se presenta a continuación: <!-- Propiedades de deployment para localhost --> <property name="oc4j_home" value="c:/desarrollo/java/install/oc4j" /> <property name="admin.jar" value="${oc4j_home}/j2ee/home/admin.jar" /> <property name="deployment.name" value="appblank" /> <property name="local.test.host" value="localhost" /> <property name="admin.local.username" value="admin" /> <property name="admin.local.password" value="admin" /> La propiedad OC4J_HOME debe apuntar al directorio en el que se tiene instalado el servidor de aplicaciones OC4J. La propiedad admin.jar contiene el path completo al fichero admin.jar que vienen con el servidor OC4J en el directorio ${OC4J_HOME}/j2ee/home/admin.jar. En caso de querer desplegar la aplicación en un servidor remoto desde el puesto de desarrollo local es necesario este fichero, por lo que se recomienda tener una instalación local del servidor OC4J. Las propiedades admin.local.username y admin.local.password definen el usuario y la contraseña para el despliegue en la instalación local del servidor de aplicaciones. La propiedad deployment.name define el nombre que se le da a la aplicación cuando es desplegada. Configurando el despliegue remoto de aplicaciones De forma análoga a la configuración que se hace para el despliegue de aplicaciones el local, han de establecerse ciertas propiedades para el despliegue en remoto. Estas propiedades son las que se muestran a continuación: <property name="desa.test.host" value=" " /> <property name="admin.remote.username" value="admin" /> <property name="admin.remote.password" value="admin" /> Como propiedades a destacar se encuentran: 2

10 Despliegue La propiedad desa.test.host define la dirección IP del servidor remoto en el que se despliegan las aplicaciones. Las propiedades admin.remote.username y admin.remote.password definen el usuario y la contraseña para el despliegue en el servidor remoto. Normalmente, estos parámetros suelen coincidir con los locales, ya que para el despliegue remoto se emplea el admin.jar local. Fases del despliegue de aplicaciones En el despliegue de las aplicaciones en el servidor Oracle 9iAS concurren dos fases diferenciadas: despliegue (deploy) y enlazado (bind). Con el despliegue se consigue que el servidor de aplicaciones descomprima el fichero.ear de la aplicación en la carpeta ${OC4J_HOME}/j2ee/home/applications, mientras que con el enlazado se actualizan los ficheros de configuración correspondientes y se asocia el la aplicación con el nombre definido en la propiedad deploymentname. La tarea Ant que se encarga del despliegue y enlazado en el puesto de desarrollo de una aplicación se presenta a continuación: <target name="deploy.localhost" depends="set.config.file.names.localhost, make-ear <!-- instalamos la aplicacion.. --> <java jar="${admin.jar}" fork="true" failonerror="true"> <arg value="${test.host}" /> <arg value="${admin.username}" /> <arg value="${admin.password}" /> <arg value="-deploy" /> <arg value="-file" /> <arg value="${appblank.ear}" /> <arg value="-deploymentname" /> <arg value="${deployment.name}" /> </java> <!-- Hacemos bindapp.. --> <java jar="${admin.jar}" fork="true" failonerror="true"> <arg value="${test.host}" /> <arg value="${admin.username}" /> <arg value="${admin.password}" /> <arg value="-bindwebapp" /> <arg value="${deployment.name}" /> <arg value="${deployment.name}" /> <arg value="http-web-site" /> <arg value="/${deployment.name}" /> </java> </target> Para el caso de despliegue en remoto se facilitan dos targets análogos llamados deploy.desa y undeploy.desa. Desinstalando una aplicación desplegada Una vez se haya desplegado una aplicación puede interesar desinstalarla del servidor OC4Jj. Por esta razón se incluyen tareas Ant en el fichero build.xml de la aplicación de ejemplo (sampleapp) que se encargan de realizar esta tarea. 3

11 Despliegue Estas se presentan a continuación: <target name="undeploy.localhost" depends="set.config.file.names.localhost"> <!-- desinstalamos la aplicacion.. --> <java jar="${admin.jar}" fork="true" failonerror="true"> <arg value="${test.host}" /> <arg value="${admin.username}" /> <arg value="${admin.password}" /> <arg value="-undeploy" /> <arg value="${deployment.name}" /> </java> </target> <target name="undeploy.desa" depends="set.config.file.names.desa"> <echo message="${admin.jar}" /> <!-- desinstalamos la aplicacion.. --> <java jar="${admin.jar}" fork="true" failonerror="true"> <arg value="ormi://${test.host}" /> <arg value="${admin.username}" /> <arg value="${admin.password}" /> <arg value="-undeploy" /> <arg value="${deployment.name}" /> </java> </target> Despliegue en Oracle IAS El FW-PA no ofrece ningún soporte específico para el despliegue en Oracle IAS. En este entorno, los despligues deben realizarse utilziando la consola de administración del servidor. A partir de la versión 1.4 del FW-PA, es posible generar EARs que puedan ser desplegados en cualquier entorno, siempre y cuando se cumplan las siguientes condiciones: 1. Todos los entornos son tecnológicamente idénticos. Tienen la misma configuración de máquina virtual, la misma memoria (tanto heap como stack), configuración AWT, etc. 2. Existen las carpetas destinadas a albergar los ficheros de log y de configuración. Todas están en la misma ruta en todos los sistemas. 4

12 Capítulo 3. Inicialización Inicialización de la aplicación El proceso de inicialización de las aplicaciones se gestiona con el fichero princast-initscript.xml. Los objetos que se definan en este fichero serán creados por el sistema de arranque del FW- PAy además, 1-) Si implementan el interfaz Configurable serán configurados, 2.-) Si implementan el interface Launchable serán arrancados y 3-) Si implementan el interface ManageableMBean serán registrados bajo la consola JMX. El fichero de configuración princast-init-script.xml se ajusta a la estructura de los ficheros de definición de beans del framework Spring ( Cada objeto inicializable se define con un bean, utilizando la etiqueta <bean id= class= />, donde el atributo id es un identificador único del bean (se usa para referenciarlo en otros lugares del fichero) y el atributo class es el nombre completamente cualificado de la clase del objeto. Si el objeto tiene propiedades (métodos set ), es posible inicializar sus valores anidando, dentro de la etiqueta <bean>, etiquetas <property name= >. Donde name es el nombre de la propiedad según el convenio de nombrado de java beans. El valor se especificará en el cuerpo de la etiqueta <property> teniendo en cuenta: a. Si se asigna un valor constante, éste debe ir en el cuerpo de una etiqueta <value></value>. b. Si se asigna una referencia a otro objeto creado en el mismo fichero, se utilizará la etiqueta <ref id= />, donde id es el identificador del bean a asignar. Variables ${ } en el fichero de inicialización En el fichero princast-init-script.xml es posible utilizar variables al estilo ANT : ${nombre}. Los valores de estas variables se obtienen de un fichero de propiedades. Para poder utilizar este tipo de variables, es necesario incluir, en el propio fichero princastinit.script.xml, el siguiente bean: <bean id="propertyconfigurer" class="org.springframework.beans.factory.config.prope <property name="location"><value> ruta del fichero </value></property> </bean> Donde ruta del fichero es el path del fichero de properties del que se cargarán los valores de las variables. La ruta de este fichero es relativa al classpath. También es posible utilizar rutas de fichero absolutas. Para ello, es necesario utilizar la construcción de Spring FileSystemResources, tal y como se indica en el siguiente ejemplo: bean id="propertyconfigurer" class="org.springframework.beans.factory.config.proper <property name="location"> <bean class="org.springframework.core.io.filesystemresource"> <constructor-arg><value>c:/deploy.properties</value></constructor-arg> </bean> </property> </bean> Un ejemplo de uso de variables es el que sigue: 5

13 Inicialización <bean id="examplebean" class="es.princast.framework.examples.mybean" lazy-init="false" singleton="true"> <property name="exampleprop"><value>${example.value}</value></property> </bean> Especificación de paths. Es muy habitual que propiedades de beans del fichero de inicialización sean paths de ficheros (de configuración, etc.). Cuando se habla de paths, en el fichero princast-init-script.xml, se debe tener cuenta que puede ser: Un path absoluto. Un path relativo al directorio base de la aplicación. Un path relativo al classpath. En este caso, el path debe empezar con el prefijo: classpath://. Ficheros de inicialización de la aplicación en blanco <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" " <beans> <!-- Resolves ${...} placeholders from client.properties --> <bean id="propertyconfigurer" class="org.springframework.beans.factory.config.prop <property name="location"><value>deploy.properties</value></property> </bean> <!-- Modulos de configuracion --> <bean id="baseconfigurationplugin" class="es.princast.framework.core.configuration <constructor-arg><value>baseplugin</value></constructor-arg> <property name="file"><value>${base.module.file}</value></property> <property name="contexts"> <list> <value>security</value> <value>root.context</value> <value>action.context</value> <value>jmx.context</value> </list> </property> </bean> <bean id="jaasconfigplugin" class="es.princast.framework.facilities.security.jaas. <constructor-arg><value>jaas-config</value></constructor-arg> <property name="file"><value>web-inf/jaas-config.xml</value></property> <property name="contexts"> <list> <value>security</value> </list> </property> </bean> <bean id="securityrulesplugin" class="es.princast.framework.web.filter.security.co 6

14 Inicialización <constructor-arg><value>security-rules</value></constructor-arg> <property name="file"><value>web-inf/princast-security-rules.xml</value></propert <property name="contexts"> <list> <value>security</value> </list> </property> </bean> <!-- Sombreros JMX para los modulos --> <bean id="jmxbaseplugincap" class="es.princast.framework.core.management.configura <property name="plugin"><ref bean="baseconfigurationplugin"/></property> </bean> <bean id="jmxjaasconfigplugincap" class="es.princast.framework.core.management.con <property name="plugin"><ref bean="jaasconfigplugin"/></property> </bean> <bean id="securityrulesplugincap" class="es.princast.framework.core.management.con <property name="plugin"><ref bean="securityrulesplugin"/></property> </bean> <!-- Gestor de configuracion --> <bean id="configurationmanager" class="es.princast.framework.core.configuration.fr factory-method="getconfigurator" lazy-init="false" singleton="true"> <property name="plugins"> <list> <ref bean="baseconfigurationplugin"/> <ref bean="jaasconfigplugin"/> <ref bean="securityrulesplugin"/> </list> </property> </bean> <!-- Gestor de logging --> <bean id="loggingmanager" class="es.princast.framework.core.logging.loggingmanager factory-method="getlogging" lazy-init="false" singleton="true"> </bean> <!-- Objetos gestionables JMX --> <bean id="loggingjmx" class="es.princast.framework.core.management.mlogging.loggin <bean id="systemjmx" class="es.princast.framework.core.management.msystem.systemjm <bean id="fw-pa_info" class="es.princast.framework.core.management.info.frameworkp <!-- Otros objetos inicializables --> <bean id="counterfactory" class="es.princast.framework.core.management.mcounters.c factory-method="getfactory"/> </beans> 7

15 Inicialización El contenido del fichero deploy.properties (en el classpath de la appblank) es: base.module.file = WEB-INF/appblank.properties El contenido del fichero appblank.properties, definido con la variable ${base.module.file} es: #Este fichero se puede ubicar en cualquier lugar siempre y cuando se referencie #correctamente desde el fichero deploy.properties (situado en el classpath de la ap HIT.COUNTER=es.princast.framework.core.management.mcounters.historic.HistoricalCoun ACTION_MGMT=es.princast.framework.web.action.monitoring.PrincastActionMgmtInterface LOGGING_XMLCONF=/WEB-INF/log4j.xml app-config=appblank http.port=8888 https.port=4443 https/cert.port=8844 JMX.SERVER.ADAPTOR = es.princast.framework.core.management.adapters.oc4jmbeanserver Los beans definidos en el fichero princast-init-script.xml son los que siguen: propertyconfigurer baseconfigurationplugin jaasconfigplugin securityrulesplugin jmxbaseplugincap, jmxjaasconfigplugincap, securityrulesplugincap configurationmanager loggingmanager Se trata de un bean para la gestión y reemplazo de variables estilo ANT (${ }). Declaración del plug-in de configuración base. Este plugin carga información de configuración con carácter general. En ejemplo, los parámetros de configuración se tomarán de un fichero de properties cuya ubicación se define bajo el parámetro base.module.file en el fichero deploy.properties. En este fichero se pueden definir tanto parámetros de carácter general (ROOT.CONTEXT), como parámetros específicos para las Actions de Struts (ACTION.CONTEXT) o para el sistema de seguridad (SECURITY). Declaración del plug-in para la gestión de la configuración JAAS del sistema de seguridad de la aplicación. Para configurar este plugin, se indicará la ubicación del fichero jaas-config.xml y se registrará para servir parámetros al contexto SECURITY. Declaración del plug-in para la gestión de la configuración de los recursos protegidos de la aplicación. Para utilizar este plugin, es necesario especificar la ubicación del fichero princastsecurity-rules.xml y registrarlo para servir parámetros al contexto SECURITY. Declaración de los sombreros JMX para los plug-ins de configuración. Estos objetos permiten conectar los plug-ins de configuración con la consola JMX, de forma que éstos puedan ser gestionados en caliente. Objeto fachada del sistema de configuración. En este bean es necesario registrar todos los plug-ins que se hayan definido, de forma que puedan ser luego accesibles para las aplicaciones. Objeto fachada para el sistema de logging. 8

16 Inicialización managementfactory loggingjmx systemjmx FW-PA_Info counterfactory Objeto fachada para el sistema de gestión JMX. Se especifica el nombre del servidor JMX, el puerto por el que se puede acceder a la consola http y el par usuario/contraseña para acceder a la misma. Objeto JMX que permite gestionar los niveles de log desde la consola HTML. Objeto JMX que permite gestionar determinados parámetros del sistema desde la consola HTML. Objeto JMX que muestra, desde la consola HTML, información a cerca de la versión del FW-PA que utiliza la aplicación. Fábrica de contadores para gestionar la cuenta de accesos a la aplicación. 9

17 Capítulo 4. Configuración El Sistema de Configuración del FW-PA Los componentes del FW-PA se configuran a través del Sistema de Configuración centralizado. Este sistema permite gestionar parámetros de configuración sin importar donde estén definidos. Además, el sistema también permite la actualización en caliente de sus valores y la gestión, de forma homogénea, de toda la configuración a través de la consola de administración JMX. Figura 4.1. Estructura del sistema de configuración Los componentes del Sistema de Configuración son: Objetos configurables Contextos de Configuración Configurador Central Objetos de aplicación o del FW-PA que implementan el interface Configurable. Para configurarse cargan sus datos del Sistema de Configuración. Conjuntos que sirven para clasificar los parámetros, evitando conflictos en sus nombres. Los objetos configurables deben saber el nombre del contexto al que pertenece cada parámetro que pueda necesitar. Es un objeto fachada que se encarga de cargar los parámetros de los ficheros de configuración, clasificarlos en sus contextos y ponerlos a disposición de los objetos configurables. Plug-in de Configuración Contextos de Configuración Son objetos que permiten acceder a ficheros de configuración y cargar los parámetros que contienen. También pueden gestionar estos parámetros, actualizar sus valores y refrescar el almacén cuando se actualice el fichero. Con el fin de evitar colisiones en el nombrado de los parámetros de configuración, éstos se clasifican en Contextos. Un contexto es un conjunto de parámetros de configuración relacionados entre sí. No puede haber dos parámetros, en un mismo contexto, con el mismo nombre. El programador de objetos configurables debe documentar claramente los nombres de los parámetros que va a necesitar, así como el nombre del contexto al que pertenece cada parámetro. Los objetos del FW-PA utilizan los siguientes contextos: ROOT.CONTEXT ACTION.CONTEXT SECURITY JMX.CONTEXT Contexto raíz. En este contexto se pueden introducir todos los parámetros que no encajen en ningún contexto predefinido. Contexto del que toman parámetros los objetos de la capa controlador (Actions Struts). Contexto en el que se clasifican los parámetros relativos al sistema de seguridad del FW-PA. Contexto para la configuración del sistema de gestión JMX 10

18 Configuración Plugins de Configuración Los plug-ins de configuración son objetos que permiten cargar, y gestionar, ficheros de configuración. Los plug-ins de configuración deben definirse en el fichero de inicialización: princast-initscript.xml. <bean id="baseconfigurationplugin" (1) class="es.princast.framework.core.configura <constructor-arg><value>baseplugin</value></constructor-arg> <property name="file"><value>${base.module.file}(3)</value></property> <property name="contexts">(4) <list> <value>security</value> <value>root.context</value> <value>action.context</value> <value>jmx.context</value> </list> </property> </bean> Es importante tener en cuenta los siguientes puntos: 1. El plug-in debe tener un identificador único. No puede haber otro objeto en el fichero de arranque con el mismo identificador. 2. Se debe seleccionar la clase de plugin adecuada. Puede haber dos tipos de plug-ins: basados en properties y basados en xml. Si los parámetros de configuración se pueden definir en un fichero de properties estándar, se puede utilizar directamente el plug-in: PropertiesFileConfigurationPlugin. Si, por el contrario es necesario que los datos se almacenen con un formato más complejo, por ejemplo XML, será necesario implementar un plug-in XML ad-hoc (ver [Manual de Desarrollo de Aplicaciones J2EE con el FW-PA]). 3. Para que el plug-in pueda cargar los parámetros se debe indicar la dirección del fichero de configuración. La ubicación del fichero se indica utilizando la propiedad file. El valor de esta propiedad puede ser: un path absoluto de fichero, un path relativo al contexto de la aplicación tomando como base el directorio raíz de la aplicación, un path relativo tomando como base el classpath (si el path comienza por la cadena: classpath:// ) o una variable estilo ANT (ver apartado 3.1 para más información) que contenga un path en alguno de los tres formatos anteriores. 4. Se deben indicar los nombres de los contextos que pueden acceder a los parámetros del plug-in. Todos los pa-rámetros del plug-in estarán disponibles para cada uno de los contextos que se definan. En la definición del ejemplo, si se define el parámetro FOO_PARAM, éste estará disponible para los contextos: SECURITY, ROOT.CONTEXT y ACTION.CONTEXT. Además de definir los plug-ins de configuración, es necesario que éstos estén registrados en el Gestor de Configuración (FrameworkConfigurator). <bean id="configurationmanager" class="es.princast.framework.core.configuration.fr factory-method="getconfigurator" lazy-init="false" singleton="true"> <property name="plugins"> <list> <ref bean="baseconfigurationplugin"/>(1) <ref bean="jaasconfigplugin"/> <ref bean="securityrulesplugin"/> </list> 11

19 Configuración </property> </bean> Para registrar un plug-in, basta con incluir una referencia a dicho plug-in (property plugins ), en la definición del configurationmanager. Opcionalmente, se puede definir un sombrero JMX para el plugin. Un sombrero JMX es un objeto que permite gestio-nar el plugin a través de la consola HTML del FW-PA, lo que posibilita que se actualicen valores de parámetros de configuración (o incluso el fichero de configuración completo) en caliente, sin necesidad de parar la aplicación. <bean id="jmxbaseplugincap" class="es.princast.framework.core.management.configurat </bean> Para acceder a un plug-in de configuración a través de la consola JMX es necesario tener en cuenta: 1. La clase del adaptador JMX es siempre: es.princast.framework.core.management.configuration.configurationpluginjmxadapter 2. En la propiedad plugin se debe indicar la referencia al plug-in que se va a gestionar. En el ejemplo, el plugin es baseconfigurationplugin. 3. La consola de administración debe estar activa y correctamente configurada. Configuración del Sistema de Monitorización de Actions Las Actions suministradas por el FW-PA disponen de un sistema de monitorización y control que, se encarga de realizar métricas sobre el proceso de la Action. El interfaz con el sistema de monitorización (PrincastActionMgmtInterface) es una clase que permite programar las métricas que se deben tomar, así como la forma en que se agregarán. Este interfaz se puede definir en caliente a través del sistema de configuración del FW-PA. La clase del interfaz se indica a través del parámetro ACTION_MGMT, de alguna de las formas que siguen: 1. En primer lugar, se buscará el parámetro de configuración: <nombre de clase de Action>@ACTION_MGMT. Para buscar definiciones específicas para un tipo de Action concreta. 2. Si no se encuentra una definición específica, se buscará el parámetro ACTION_MGMT, donde se definirá la clase por defecto para todas las Actions. Estos parámetros se deben poner a disposición del contexto: ACTION.CONTEXT. <!-- Modulos de configuracion --> <bean id="baseconfigurationplugin" class="es.princast.framework.core.configuration <constructor-arg><value>baseplugin</value></constructor-arg> <property name="file"><value>classpath://base.propertiesvalue></property> <property name="contexts"> <list> <value>security</value> <value>root.context</value> <value>action.context</value> </list> 12

20 Configuración </property> </bean> Siendo el contenido del fichero classpath://base.properties el que sigue (las líneas subrayadas son las relativas al contexto ACTION.CONTEXT): # #Fri Jan 07 10:08:36 CET 2005 HIT.COUNTER=es.princast.framework.core.management.mcounters.historic.HistoricalCoun FooAction@ACTION_MGMT= es.princast.framework.web.action.monitoring.princastactionmg ACTION_MGMT=es.princast.framework.web.action.monitoring.PrincastActionMgmtInterface CARRITO.AGENCIA=Manin Directo. LOGGING_XMLCONF=/WEB-INF/log4j.xml app-config=carrito http.port=8888 https.port=4443 https/cert.port=8844 En el FW-PA se suministran dos implementaciones del interfaz de conexión con el sistema de management de las Actions: PrincastActionMgmtInterfaceImpl Monitoriza los accesos a las Actions y las excepciones no controladas. PrincastActionMgmtInterfaceNullImpl Apaga el sistema de monitorización para la Action. Ejemplo de configuración en la SampleApp (Carrito). En la figura se muestra un esquema de la configuración de la aplicación del carrito. El componente central es el fichero de inicialización princast-init-script.xml, donde se definen y registran los plug-ins de configuración. Figura 4.2. Configuración de la aplicación de ejemplo (Simple App) El fichero princast-init-script.xml utiliza variables para la definición de algunos valores. Estas variables se cargan del fichero deploy.properties, ubicado en el classpath de la aplicación. Además, se definen tres plug-ins de configuración: baseconfigurationplugin jaasconfigplugin securityrulesconfig Contiene todos los parámetros de configuración de carácter general. Este plugin surte de parámetros a todos los contextos: SECURITY, BASE.CONTEXT y ACTION.CONTEXT. Estos parámetros se leen, todos, del fichero carrito.properties, ubicado en el path de la aplicación (directorio WEB-INF). Que se encarga de gestionar el fichero de configuración de la seguridad: jaas-config.xml Que gestiona el fichero de recursos protegidos: princastsecurity-rules.xml. 13

21 Capítulo 5. Ficheros de Configuración J2EE Ficheros J2EE En la aplicación en blanco que se proporciona se incluye un fichero web.xml con el que configurar la aplicación Web. A continuación se presentan cada una de las propiedades configurables en el mismo agrupadas por secciones. Configuración de filtros Filtro GZIP El FW-PA tiene integrado un filtro que permite la compresión del flujo de datos que circula entre el cliente y el servidor. Para habilitarlo cuando se despliega la aplicación es necesario incluir las siguientes etiquetas XML: <!-- filtro GZip --> <filter> <filter-name>gzipfilter</filter-name> <filter-class>es.princast.framework.web.filter.gzip.gzipfilter</filter-class> </filter> <!-- Mapear el filtro GZip con el ActionServlet --> <filter-mapping> <filter-name>gzipfilter</filter-name> <servlet-name>action</servlet-name> </filter-mapping> El nombre del filtro viene dado por el elemento filter-name. En principio, no existe ninguna restricción en cuanto al nombrado de este filtro, si bien se recomienda seguir el nombrado del ejemplo. La clase que implementa el filtro viene indicada en el elemento filter-class. El valor de este elemento no puede ser otro diferente al que aparece en el ejemplo. En cuanto al elemento servlet-name, éste tiene que tener como valor el del nombre del PrincastActionServlet empleado como controlador de la aplicación. De esta forma, todas las peticiones recibidas por el controlador podrán ser devueltas al cliente empleando compresión gzip. Filtro de seguridad En el FW-PA se facilita un filtro de seguridad que se configura pasándole los siguientes parámetros: <filter> <filter-name>securityfilter</filter-name> <filter-class> es.princast.framework.web.filter.security.corp.princastsecurityfilter 14