Para la creación de una aplicación EAR también es necesario un archivo opcional para permitir la división de los componentes de cliente en distintos archivos WAR y EAR, y también para permitir un mayor control de una parte de la configuración EAR y de los módulos incluidos. Este archivo se denomina deployment_packaging.xml y debe colocarse en el directorio SERVER_DIR/project/config.
El formato del archivo deployment_packaging.xml es el siguiente:
<deployment-config> <ear name="Curam" requireServer="true"> <components>custom,sample,SamplePublicAccess,core</components> <context-root>/Curam</context-root> </ear> <ear name="CuramExternal"> <components>SamplePublicAccessExternal</components> <context-root>/CuramExternal</context-root> <custom-web-xml>${client.dir}/custom_web_xml</custom-web-xml> </ear> </deployment-config>
Cada archivo puede tener varios elementos ear y da como resultado un archivo EAR que se genera en el directorio SERVER_DIR/build/ear/WAS. Las opciones para cada elemento son:
Esta opción controla el nombre del EAR creado a partir del proceso.
Este atributo opcional controla si el módulo de servidor está incluido en el archivo EAR. Las entradas válidas son true o false. El valor predeterminado es false. Si se despliegan varios archivos EAR en un servidor de aplicaciones, este atributo debe establecerse en true sólo para un archivo EAR, ya que sólo se puede desplegar un módulo de servidor IBM Cúram Social Program Management por cada clúster. Si se establece requireServer en true para varios archivos EAR, los demás archivos EAR deben desplegarse en un clúster EAR para evitar conflictos.
Esta opción controla qué componentes de cliente se colocan en el archivo EAR. También controla el orden de los componentes para la nueva creación del cliente que deberá tener lugar. Normalmente, el directorio principal no forma parte del orden de los componentes, pero en esta ocasión es importante añadir esta opción para indicar si debe incluirse en un archivo WAR determinado. Estas entradas deben seguir el orden habitual de los componentes definidos en la publicación Cúram Server Guía del desarrollador y deben estar separadas por comas.
Esta opción forma la raíz de contexto del módulo WAR en el descriptor de despliegue application.xml. Estas entradas deben empezar con una barra inclinada.
Este elemento opcional controla si un archivo web.xml debe sobrescribir la versión estándar en el archivo WAR. Estas entradas deben ser una vía de acceso de Apache Ant que lleve al directorio que contiene el archivo web.xml.
Es posible utilizar referencias a variables de entorno como parte de esta vía de acceso. Por ejemplo, puede utilizarse ${client.dir} para que apunte al directorio del cliente web y ${SERVER_DIR} para que apunte al directorio del servidor.
Para cada cliente web (por ejemplo, un archivo WAR) se necesita un componente de cliente web independiente para que contengasus personalizaciones. En el caso de varios clientes web, la variable de entorno CLIENT_COMPONENT_ORDER incluirá todos los componentes personalizados; pero serán necesarios los elementos <ear> separados, uno para cada componente web personalizado (y otros componentes, según sea necesario).
Al igual que con el destino estándar, debe haber disponible una aplicación IBM Cúram Social Program Management generado totalmente. Para obtener más detalles sobre cómo generar una aplicación, consulte la publicación Cúram Server Guía del desarrollador.