La creación de un archivo EAR de aplicación también incluye un archivo opcional para permitir que los componentes de cliente se dividan en distintos archivos WAR y EAR y para permitir también más control de algunos de los módulos incuidos y de configuración de EAR. 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 los resultados en un archivo EAR que se genera en el directorio SERVER_DIR/build/ear/WLS. Las opciones para cada elemento son:
Esta opción controla el nombre del EAR creado desde el 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 servidor de aplicaciones, este atributo debe establecerse en true sólo para un archivo EAR ya que sólo se debe desplegar un módulo de servidor de IBM Cúram Social Program Management por clúster. Si requireServer se establece en true para varios archivos EAR, los demás archivos EAR se deben desplegar en otro clúster para evitar conflictos.
Esta opción controla cuáles de los componentes de cliente se colocan en el archivo EAR. También controla el orden de componente para la reconstrucción del cliente que deberá tener lugar. Normalmente, el directorio principal no forma parte del orden de componentes, pero en esta ocasión es importante para añadir esta opción para calificar si debe incluirse en un archivo WAR determinado. Las entradas aquí deben seguir el orden habitual de los componentes definidos en Cúram Server Developer's Guide 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. Aquí las entradas deben empezar con una barra inclinada.
Este elemento opcional controla si un archivo web.xml personalizado debe sobrescribir la versión estándar en el archivo WAR. Aquí las entradas deben ser una vía de acceso de Apache Ant 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, se puede utilizar ${client.dir} para apuntar al directorio del cliente web y se puede utilizar ${SERVER_DIR} para apuntar al directorio de servidor.
Para cada cliente web (por ejemplo un archivo WAR), se necesita un componente de cliente web independiente para contener las personalizaciones. En el caso de varios clientes web, la variable de entorno CLIENT_COMPONENT_ORDER incluirá todos los componentes personalizados; pero se necesitarán elementos <ear> independiedntes, uno para cada componente web personalizado (y otros componentes, según sea necesario).
Al igual que con el destino estándar, debe estar disponible una aplicación totalmente compilada. Para obtener detalles sobre cómo compilar una aplicación, consulte Cúram Server Developer's Guide.