La génération d'un fichier d'application EAR peut nécessiter un fichier facultatif qui permet de fractionner les composants client en plusieurs fichiers WAR et EAR et qui permet également de contrôler davantage certains modules inclus et certains éléments de la configuration EAR. Ce fichier s'appelle deployment_packaging.xml. Il doit être placé dans le répertoire SERVER_DIR/project/config.
Le format du fichier deployment_packaging.xml est :
<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>
Chaque fichier peut avoir plusieurs éléments <ear>, ce qui entraîne la génération d'un fichier EAR dans le répertoire SERVER_DIR/build/ear/WLS. Les options de chaque élément sont :
Cette option commande le nom du fichier EAR créé à partir du processus.
Cet attribut facultatif détermine si le module du serveur est inclus dans le fichier EAR. Les entrées valides sont true ou false. La valeur par défaut est false. Si vous déployez plusieurs fichiers EAR sur un serveur d'application, cet attribut doit être défini sur true pour un seul fichier EAR, car un seul module de serveur IBM Cúram Social Program Management doit être déployé par cluster. Si requireServer est défini sur true pour plusieurs fichiers EAR, alors les autres fichiers EAR doivent être déployés dans un autre cluster afin d'éviter les conflits.
Cette option détermine la place des composants client dans le fichier EAR. Elle détermine également l'ordre de régénération des composants du client qui doit avoir lieu. En général, le répertoire principal ne fait pas partie de l'ordre des composants, cependant, il est important dans ce cas de l'ajouter afin d'indiquer s'il doit être inclus dans un fichier WAR spécifique. Les entrées doivent suivre l'ordre classique des composants défini dans le manuel Cúram Server - Guide des développeurs et doivent être séparées par des virgules.
Cette option forme la racine de contexte du module WAR dans le descripteur de déploiement application.xml. Les entrées de cette option doivent commencer avec une barre oblique.
Cet élément facultatif indique si un fichier web.xml personnalisé doit remplacer la version standard dans le fichier WAR. Les entrées doivent correspondre à un chemin Apache Ant vers le répertoire contenant le fichier web.xml.
Il est possible d'utiliser des références aux variables d'environnement dans le cadre de ce chemin d'accès. Par exemple, il est possible d'utiliser ${client.dir} pour pointer ver le répertoire du client Web et ${SERVER_DIR} pour pointer vers le répertoire du serveur.
Pour chaque client Web (fichier WAR), un composant de client Web est nécessaire afin qu'il contienne ses personnalisations. Dans le cas de clients Web multiples, la variable d'environnement CLIENT_COMPONENT_ORDER comprend tous les composants personnalisés. Toutefois, un élément <ear> distinct est requis pour un composant Web personnalisé (et pour d'autres composants le cas échéant).
Comme pour la cible standard, une application entièrement générée doit être disponible. Pour des explications sur la génération d'une application, voir le manuel Cúram Server - Guide des développeurs.