[AIX Solaris HP-UX Linux Windows][z/OS]

Installation de fichiers d'application d'entreprise en ajoutant des fichiers de propriété à un répertoire contrôlé

Vous pouvez utiliser les fichiers de propriétés d'application pour installer les fichiers d'application d'entreprise sur un serveur ou un cluster, pour mettre à jour les applications ou modules déployés ou pour désinstaller les applications ou modules déployés. Lorsque vous faites glisser ou copiez un fichier de propriétés sur un répertoire contrôlé, le produit effectue l'opération de déploiement qui y est décrite. Les fichiers d'application d'entreprise que vous installez, mettez à jour ou désinstallez à l'aide de fichiers de propriétés incluent des fichiers d'archive d'entreprise (EAR), d'archive Web (WAR), d'archive Java™ (JAR) et d'archive SIP (Session Initiation Protocol) (SAR). Un fichier d'application d'entreprise doit être conforme à la spécification Java EE (Java Platform, Enterprise Edition).

Avant de commencer

Développez et assemblez le fichier EAR, JAR, WAR ou SAR. Vous pouvez utiliser un outil d'assemblage pris en charge tel qu'un produit IBM® Rational Application Developer for WebSphere Software pour spécifier des liaisons et assembler le fichier.

Contrairement à la procédure décrite à la rubrique Installation de fichiers d'application d'entreprise en les ajoutant à un répertoire contrôlé, qui ne modifie ni les liaisons JNDI (Java Naming and Directory), ni les autres liaisons d'application, les liaisons peuvent être définies dans un fichier de propriétés.

Par défaut, le déploiement des répertoires contrôlés n'est pas activé. Le déploiement par répertoire contrôlé doit être activé avant son utilisation. Voir Définition des valeurs de déploiement d'un répertoire contrôlé.

Restriction : L'installation d'un fichier EAR, JAR, WAR ou SAR en ajoutant un fichier de propriétés à un répertoire contrôlé est disponible uniquement sur des systèmes d'exploitation distribués ou z/OS. Elle n'est pas prise en charge sur les systèmes d'exploitation IBM i.

Pourquoi et quand exécuter cette tâche

Vous pouvez déployer un fichier EAR, JAR, WAR ou SAR sur un serveur d'applications ou un cluster en faisant glisser ou en copiant un fichier de propriétés d'application dans un répertoire contrôlé monitoredDeployableApps/deploymentProperties. Par défaut, le produit analyse le répertoire contrôlé à la recherche de nouveaux fichiers de propriétés toutes les 5 secondes au maximum. Lorsqu'il trouve un nouveau fichier de propriétés dans un répertoire contrôlé, le produit lance automatiquement la commande wsadmin applyConfigProperties, installe l'application ou le module sur le serveur d'applications ou le cluster et démarre l'application ou le module.

Il n'est pas nécessaire de démarrer wsadmin, ni d'entrer des commandes pour déployer l'application ou le module. Ajoutez tout simplement un fichier de propriétés à un répertoire contrôlé. Le produit exécute la commande wsadmin applyConfigProperties à votre place.

Un fichier de propriétés peut également être utilisé pour mettre à jour ou supprimer une application ou un module déployé. Le serveur ou le cluster doit être en fonctionnement pour que le produit puisse détecter des modifications dans les fichiers de son répertoire contrôlé.

Cette étape suppose l'utilisation d'un explorateur graphique pour faire glisser ou copier le fichier de propriétés. Vous pouvez également utiliser les commandes du système d'exploitation pour copier un fichier dans un répertoire contrôlé monitoredDeployableApps/deploymentProperties.

Procédure

  1. Créez un fichier de propriétés qui définit la tâche de déploiement à terminer.

    Les exemples à la fin de cette rubrique constituent des fichiers de propriétés d'application utilisables dans des répertoires contrôlés.

    Les fichiers de propriétés utilisés dans des répertoires contrôlés sont identiques aux fichiers de propriétés décrits dans la rubrique relative à l'utilisation des fichiers de propriétés d'application pour installer, mettre à jour et supprimer des fichiers d'application d'entreprise. Cependant, les fichiers de propriétés utilisés pour les répertoires contrôlés sont légèrement différents :

    • Il n'est pas nécessaire de définir des instructions telles que CreateDeleteCommandProperties=true dans l'en-tête.
    • Pour désinstaller une application d'entreprise, indiquez DELETE=true dans l'en-tête de la section des propriétés.

    Seules les opérations dont le type de ressource est Application, par exemple ImplementingResourceType=Application, peuvent être définies dans le fichier de propriétés. Si le fichier de propriétés contient une ressource qui n'est pas de type Application, par exemple, ImplementingResourceType=Server, le produit renvoie un message et n'exécute pas l'opération sur le type de ressource.

    L'installation ou la mise à jour d'une application peut être faite à partir d'un fichier de propriétés modifié. Pour extraire le fichier de propriétés d'une application d'entreprise déployée afin de le modifier ou de l'utiliser comme modèle, exécutez la commande extractConfigProperties :
    • Procédez à l'extraction des propriétés de l'application vers un fichier qui utilise l'ancien format de sortie.
      AdminTask.extractConfigProperties('[-propertiesFileName myApp.props -configData Deployment=MyApplication]')

      L'exécution de cet exemple en langage Jython produit un fichier nommé myApp.props qui recense les propriétés d'un objet de configuration de type Application nommé MyApplication. Par défaut, la sortie créée par la commande extractConfigProperties contient toutes les colonnes, masquées ou non, des tâches d'installation et des valeurs correspondantes, sur des lignes distinctes. La ligne mutables indique les colonnes que vous pouvez éditer (true) et celles que vous ne pouvez pas éditer (false).

      ...
      taskName=MapModulesToServers
        mutables={false false true false false false} #readonly
        row0={module uri server ModuleVersion moduletype moduletypeDisplay} # readonly
      ...

      Ce format est illustré dans l'exemple Installation d'une application d'entreprise avec différentes options de tâche à l'aide de l'ancien format de sortie de l'application.

    • Procédez à l'extraction des propriétés de l'application vers un fichier qui utilise le format de sortie simple.
      AdminTask.extractConfigProperties('[-propertiesFileName myApp.props -configData Deployment=MyApplication
         -options [[SimpleOutputFormat true]]]')

      Cet exemple en langage Jython, dans lequel la valeur true est affectée à l'option SimpleOutputFormat, produit un fichier nommé myApp.props, qui liste dans un format plus lisible les propriétés d'un objet de configuration de type Application, nommé MyApplication. Le fichier contient les colonnes non masquées des propriétés d'application, sous forme de paires nom de colonne=valeur. Les colonnes masquées ne figurent pas dans le fichier.

      ...
      taskName=MapModulesToServers
      row0={ module="My EJB Module"  #readonly
             uri=MyEjbModule.jar,META-INF/ejb-jar.xml  #readonly
             server=WebSphere:cell=!{cellName},node=!{nodeName},
             server=!{serverName} }
      ...

      Ce format est illustré dans l'exemple Installation d'une application d'entreprise avec différentes options de tâche à l'aide du format de sortie simple.

    Pour plus d'informations sur l'extraction des propriétés d'application et les formats de sortie, consultez la rubrique relative à l'utilisation des fichiers de propriétés d'application pour installer, mettre à jour et supprimer des fichiers d'application d'entreprise.

  2. Vérifiez que le serveur d'applications ou le membre de cluster sur lequel vous souhaitez installer le fichier d'application d'entreprise est en cours d'exécution.
  3. Vérifiez que le déploiement à partir du répertoire contrôlé est activé.

    Reportez-vous à la rubrique Définition des valeurs de déploiement de répertoire contrôlé.

  4. Ouvrez un explorateur et créez le répertoire contrôlé deploymentProperties.

    Le répertoire contrôlé des serveurs d'applications de base (autonomes) se trouve sous le profil du serveur. Le chemin du répertoire contrôlé deploymentProperties qui a été créé est racine_serveur_app/profiles/nom_profil_serveur_applications/monitoredDeployableApps/deploymentProperties.

    Pour les serveurs d'applications sur un noeud géré (fédéré) d'un gestionnaire de déploiement, créez le répertoire contrôlé deploymentProperties sous le profil du gestionnaire de déploiement. Le chemin du répertoire contrôlé deploymentProperties qui a été créé est racine_serveur_app/profiles/nom_profil_gestionnaire_de_déploiement/monitoredDeployableApps/deploymentProperties.

    Créez le répertoire contrôlé deploymentProperties des clusters directement sous le profil du gestionnaire de déploiement. Le chemin du répertoire contrôlé deploymentProperties qui a été créé est racine_serveur_app/profiles/nom_profil_gestionnaire_de_déploiement/monitoredDeployableApps/deploymentProperties.

  5. Copiez le fichier de propriétés dans le répertoire contrôlé deploymentProperties.

Résultats

Le produit ajoute un répertoire portant le même nom que le fichier au répertoire installedApps/nom_cellule du profil.

De même, le produit écrit des messages relatifs au déploiement d'application dans le fichier SystemOut.log du répertoire racine_serveur_app/logs/nom_serveur. Les messages commencent par la clé de message CWLDD.

Ils indiquent que le produit a déployé le fichier d'application et que l'application est en cours d'exécution.

Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL en vue du traitement des incidents liés aux applications.

Dans le cas d'une installation à partir du répertoire contrôlé d'un gestionnaire de déploiement, le produit ne démarre pas automatiquement l'application ou le module si l'agent de noeud ou le serveur est arrêté. Si l'agent de noeud est arrêté, le produit installe l'application ou le module au niveau du gestionnaire de déploiement, mais ne synchronise pas les modifications avec le noeud et ne démarre pas l'application ou le module. Les modifications sont appliquées au noeud au prochain démarrage de l'agent assorti d'une synchronisation. Si le serveur est arrêté mais que l'agent de noeud est en cours d'exécution, le produit installe l'application ou le module et synchronise les modifications avec le noeud, mais ne démarre pas le serveur.

Exemple

Les exemples de fichiers de propriétés qui suivent constituent des modèles que vous pouvez modifier pour déployer vos applications :

Installation d'une application d'entreprise sur une cible de déploiement

Tableau 1. Propriétés requises. Définissez les propriétés du tableau ci-dessous dans le fichier de propriétés.
Propriété Description
Name Définit le nom de l'application à installer.
TargetServer Définit le nom du serveur sur lequel l'application doit être installée.
TargetNode Définit le nom du noeud sur lequel l'application doit être installée.
EarFileLocation Définit l'emplacement du fichier d'archive d'entreprise (fichier EAR). Entrez le chemin d'accès complet.
#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=hello
TargetServer=!{serverName}
TargetNode=!{nodeName}
EarFileLocation=/temp/HelloWorld.ear
#TargetCluster=cluster1

EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell
nodeName=myNode
serverName=myServer

Installation d'une application d'entreprise avec différentes options de tâche à l'aide de l'ancien format de sortie de l'application

L'exemple de fichier de propriétés installe une application d'entreprise avec des options de tâche. Le fichier contient toutes les colonnes, masquées ou non, des tâches d'installation et des valeurs correspondantes, sur des lignes distinctes. La ligne mutables indique les colonnes que vous pouvez éditer (true) et celles que vous ne pouvez pas éditer (false).

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=!{applicationName}
EarFileLocation=c:/temp/HelloWorld.ear

#
# SubSection 1.0.2 # MapModulesToServers Section. taskName
# and row0 should not be edited. row0 contains column names
# for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=MapModulesToServers
  mutables={false false true false false false} #readonly
  row0={module uri server ModuleVersion moduletype moduletypeDisplay} # readonly
  row1={“My Web Module” myWebModule.war,WEB-INF/web.xml 
  WebSphere:cell=!{cellName},node=!{nodeName},server=!{serverName} 14
  moduletype.web "Web Module"}
  row2={"My EJB module" MyEjbModule.jar,META-INF/ejb-jar.xml
  WebSphere:cell=!{cellName},node=!{nodeName},server=
  !{serverName} 13 moduletype.ejb "EJB Module"}


#
# SubSection 1.0.3 # MapRolesToUsers Section. taskName and
# row0 should not be edited. row0 contains column names for
# the tasks.
#ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=MapRolesToUsers
row0={role role.everyone role.all.auth.user role.user 
role.group role.all.auth.realms role.user.access.ids 
role.group.access.ids} #readonly
mutables={false true true true true true true true} 
#readonly
row1={administrator AppDeploymentOption.No 
AppDeploymentOption.No "adminuser" "admingroup" 
AppDeploymentOption.No "" ""}


#
# SubSection 1.0.4 # BindJndiForEJBNonMessageBinding 
# Section. taskName and row0 should not be edited. row0 
# contains column names for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
#Properties
#
taskName=BindJndiForEJBNonMessageBinding
row0={EJBModule EJB uri JNDI ModuleVersion 
localHomeJndi remoteHomeJndi} #readonly
mutables={false false false true false true true} #readonly
row1={"My EJB module" myEjb myEjbModule.jar,META-INF/ejb-
jar.xml myEjb 20 "" “"}


#
# SubSection 1.0.5 # MapEJBRefToEJB Section. taskName and 
# row0 should not be edited. row0 contains column names for
# the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
#Properties
#
taskName=MapEJBRefToEJB
row0={module EJB uri referenceBinding class JNDI 
ModuleVersion} #readonly
mutables={false false false false false true false} 
#readonly
row1={"My EJB module" myEJB MyEjbModule.jar,META-INF/ejb-
jar.xml myEJB com.ibm.defaultapplication.Increment 
Increment 23}

#
# SubSection 1.0.6 # DataSourceFor20EJBModules Section.
# taskName and row0 should not be edited. row0 contains
# column names for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
#
#Properties
#
taskName=DataSourceFor20EJBModules
row0={AppVersion EJBModule uri JNDI resAuth 
login.config.name auth.props dataSourceProps} #readonly
mutables={false false false true true true true true} 
#readonly
row1={13 "My EJB module" MyEjbModule.jar,META-INF/ejb-
jar.xml MyDataSource cmpBinding.perConnectionFactory "" ""
 ""}

#
# SubSection 1.0.7 # DataSourceFor20CMPBeans Section.
# taskName and row0 should not be edited. row0 contains 
# column names for the task.#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=DataSourceFor20CMPBeans
row0={AppVersion EJBVersion EJBModule EJB uri JNDI resAuth
login.config.name auth.props} #readonly
mutables={false false false false false true true true 
true} #readonly
row1={13 13 "My EJB module" MyEjb MyEjbModule.jar,META-
INF/ejb-jar.xml myDataSource
cmpBinding.perConnectionFactory "" ""}

#
# SubSection 1.0.8 # MapWebModToVH Section. taskName and 
# row0 should not be edited. row0 contains column names for
# the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}

#
# Properties
#
taskName=MapWebModToVH
row0={webModule uri virtualHost} #readonly
mutables={false false true} #readonly
row1={"My Web Application" MyWebModule.war,WEB-INF/web.xml 
default_host}
#


#
# SubSection 1.0.9 # CtxRootForWebMod Section. taskName and
# row0 should not be edited. row0 contains column names for
# the task.#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=CtxRootForWebMod
row0={webModule uri web.contextroot} #readonly
mutables={false false true} #readonly
row1={"My Web Application" MyWebModule.war,WEB-INF/web.xml
/}


#
# SubSection 1.0.10 # MapSharedLibForMod Section. taskName
# and row0 should not be edited. row0 contains column names
# for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=MapSharedLibForMod
row0={module uri sharedLibName} #readonly
mutables={false false true} #readonly
row2={"My Web Application" MyWebModule.war,WEB-INF/web.xml
 ""}
row1={myApp META-INF/application.xml ""}#


#
# SubSection 1.0.11 # JSPReloadForWebMod Section. taskName
# and row0 should not be edited. row0 contains column names
# for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=JSPReloadForWebMod
row0={webModule uri jspReloadEnabled jspReloadInterval} 
#readonly
mutables={false false true true} #readonly
row1={"My Web Application" MyWebModule.war,WEB-INF/ibm-web-
ext.xmi AppDeploymentOption.Yes}
#


#
# SubSection 1.0.35 # SharedLibRelationship Section. 
# taskName and row0 should not be edited. row0 contains 
# column names for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=SharedLibRelationship
row0={module uri relationship compUnitName matchTarget 
origRelationship} #readonly
mutables={false false true true true false} #readonly
row2={"My Web Application" MyWebModule.war,WEB-INF/web.xml
"" "" AppDeploymentOption.Yes ""}
row1={myApp META-INF/application.xml "" "" 
AppDeploymentOption.Yes ""}
#

EnvironmentVariablesSection
#
# Environment Variables
#
applicationName=myApp
cellName=myCell
nodeName=myNode
serverName=myServer

Installation d'une application d'entreprise avec différentes options de tâche à l'aide du format de sortie simple

L'exemple de fichier de propriétés installe une application d'entreprise avec des options de tâche. Il illustre des propriétés d'application qui ont été extraites avec l'option SimpleOutputFormat. Avec cette option, le fichier contient les colonnes non masquées des propriétés d'application, sous forme de paires nom de colonne=valeur. Les colonnes masquées ne figurent pas dans le fichier. Le format des fichiers résultant de l'extraction des propriétés d'application avec l'option SimpleOutputFormat est en général plus facile à lire et à modifier.

#
   # Header
   #
   ResourceType=Application
   ImplementingResourceType=Application 

# Properties
Name=!{applicationName}
EarFileLocation=c:/temp/HelloWorld.ear

#
# SubSection 1.0.2 # MapModulesToServers Section. taskName
# and lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#         

#
# Properties
#
taskName=MapModulesToServers
row0={ module="My EJB Module"  #readonly
       uri=MyEjbModule.jar,META-INF/ejb-jar.xml  #readonly
       server=WebSphere:cell=!{cellName},node=!{nodeName},
       server=!{serverName} }
row1={ module="My Web Module"  #readonly
       uri=myWebModule.war,WEB-INF/web.xml  #readonly
       server=WebSphere:cell=!{cellName},node=!{nodeName},
       server=!{serverName} }


#
# SubSection 1.0.3 # MapRolesToUsers Section. taskName and
# lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=MapRolesToUsers
row0={ role="All Role"  #readonly
       role.everyone=AppDeploymentOption.No
       role.all.auth.user=AppDeploymentOption.Yes
       role.user=""
       role.group=""
       role.all.auth.realms=AppDeploymentOption.No
       role.user.access.ids=""
       role.group.access.ids="" }


#
# SubSection 1.0.4 # BindJndiForEJBNonMessageBinding 
# Section. taskName and lines marked as "#readonly" should
# not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
#Properties
#
taskName=BindJndiForEJBNonMessageBinding
row0={ EJBModule="My EJB Module"  #readonly
      EJB=myEjb  #readonly
      uri=myEjbModule.jar,META-INF/ejb-jar.xml  #readonly
      JNDI=myEjb
      localHomeJndi=""
      remoteHomeJndi="" }


#
# SubSection 1.0.5 # MapEJBRefToEJB Section. taskName and 
# lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
#Properties
#
taskName=MapEJBRefToEJB
row0={ module="My EJB Module"  #readonly
      EJB=myEJB  #readonly
      uri=MyejbModule.jar,META-INF/ejb-jar.xml  #readonly
      referenceBinding=myEJB  #readonly
      class=com.ibm.defaultapplication.Increment #readonly
      JNDI=myejb }


#
# SubSection 1.0.6 # DataSourceFor20EJBModules Section. 
# taskName and lines marked as "#readonly" should not be 
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
#
#Properties
#
taskName=DataSourceFor20EJBModules
row0={ EJBModule="My EJB Module"  
       #readonly
       uri=myEjbModule.jar,META-INF/ejb-jar.xml  #readonly
       JNDI=MyDatasource
       resAuth=cmpBinding.perConnectionFactory
       login.config.name=""
       auth.props=""
       dataSourceProps="" }


#
# SubSection 1.0.7 # DataSourceFor20CMPBeans Section. 
# taskName and lines marked as "#readonly" should not be
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
# Properties
#
taskName=DataSourceFor20CMPBeans
row0={ EJBModule="My EJB Module”  #readonly
       EJB=MyEjb  #readonly
       uri=MyEjbModule.jar,META-INF/ejb-jar.xml  #readonly
       JNDI=MyDatasource
       resAuth=cmpBinding.perConnectionFactory
       login.config.name=""
       auth.props="" }


#
# SubSection 1.0.8 # MapWebModToVH Section. taskName and 
# lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}


#
# Properties
#
taskName=MapWebModToVH
row0={ webModule="My Web Application"  #readonly
       uri=myWebModule.war,WEB-INF/web.xml  
       #readonly
       virtualHost=default_host }


#
# SubSection 1.0.9 # CtxRootForWebMod Section. taskName and
# lines marked as "#readonly" should not be edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


# Properties
#
taskName=CtxRootForWebMod
row0={ webModule="My Web Application"  #readonly
       uri=myWebModule.war,WEB-INF/web.xml 
       #readonly
       web.contextroot=/ }


#
# SubSection 1.0.10 # MapSharedLibForMod Section. 
# taskName and lines marked as "#readonly" should not be 
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=MapSharedLibForMod
row0={ module=myApp”  #readonly
       uri=META-INF/application.xml  #readonly
       sharedLibName="" }
row1={ module="My Web Application"  #readonly
       uri=MyWebModule.war,WEB-INF/web.xml  #readonly
       sharedLibName="" }


#
# SubSection 1.0.11 # JSPReloadForWebMod Section. taskName
# and lines marked as "#readonly" should not be 
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#


#
# Properties
#
taskName=JSPReloadForWebMod
row0={ webModule="My Web Application"  #readonly
      uri=MyWebModule.war,WEB-INF/web.xml  
           #readonly
       jspReloadEnabled=AppDeploymentOption.Yes
       jspReloadInterval=10 }


#
# SubSection 1.0.35 # SharedLibRelationship Section.
# taskName and lines marked as "#readonly" should not be 
# edited.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=SharedLibRelationship
row0={ module=myApp  #readonly
       uri=META-INF/application.xml  #readonly
       relationship=""
       matchTarget=AppDeploymentOption.Yes }
row1={ module="My Web Application"  #readonly
       uri=MyWebModule.war,WEB-INF/web.xml  
       #readonly
       relationship=""
       matchTarget=AppDeploymentOption.Yes }

EnvironmentVariablesSection
#
# Environment Variables
#
applicationName=myApp
cellName=myCell
nodeName=myNode
serverName=myServer

Mise à jour d'un fichier unique dans une application d'entreprise déployée

Cet exemple de fichier de propriétés illustre l'ajout d'un fichier unique à une application déployée :

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=hello
Update=true
operationType=add
contentType=file
contentURI=test.war/com/ibm/addMe.jsp
contentFile=/temp/addMe.jsp

Suppression d'un fichier unique d'une application d'entreprise déployée

Cet exemple de fichier de propriétés illustre la suppression d'un fichier unique dans une application déployée :

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=hello
Update=true
operationType=delete
contentType=file
contentURI=test.war/com/ibm/addMe.jsp

Mise à jour d'un module unique dans une application d'entreprise déployée

Cet exemple de fichier de propriétés illustre l'ajout d'un module unique à une application déployée :

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=hello
Update=true
operationType=add
contentType=moduleFile
#contextRoot=”/mywebapp” # required for web module only
contentURI=Increment.jar
contentFile=/apps/app1/Increment.jar
deployEJB=false

Suppression d'un module unique d'une application d'entreprise déployée

Cet exemple de fichier de propriétés illustre la suppression d'un module unique dans une application déployée :

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=hello
Update=true
operationType=delete
contentType=moduleFile
contentURI=test.war

Remplacement, ajout ou suppression de plusieurs fichiers d'une application d'entreprise déployée

Cette option définit la mise à jour de plusieurs fichiers d'une application installée par le téléchargement d'un fichier compressé. En fonction du contenu de ce dernier, cette option peut permettre de remplacer des fichiers, d'en ajouter de nouveaux et d'en supprimer de l'application installée. Chaque entrée dans le fichier compressé est traitée comme un fichier unique et le chemin d'accès depuis la racine du fichier compressé est traité comme chemin relatif dans l'application installée.

Pour remplacer un fichier, l'un de ceux dans le fichier compressé doit avoir le même chemin relatif que celui à mettre à jour dans l'application installée.

Pour ajouter un nouveau fichier à l'application installée, un fichier dans le fichier compressé doit avoir un chemin relatif différent des fichiers dans l'application installée.

Le chemin d'accès relatif à un fichier dans l'application installée est formé par la concaténation du chemin d'accès relatif du module, si le fichier se trouve dans un module, et de celui du fichier à partir de la racine du module, séparés par une barre oblique (/).

Pour supprimer un fichier de l'application installée, indiquez les métadonnées dans le fichier compressé, à l'aide d'un fichier nommé META-INF/ibm-partialapp-delete.props dans n'importe quelle portée d'archive. Le fichier ibm-partialapp-delete.props doit être un fichier ASCII répertoriant les fichiers à supprimer dans cette archive, avec une entrée par ligne. L'entrée peut contenir un modèle de chaîne tel qu'une expression régulière identifiant plusieurs fichiers. Les chemins des fichiers à supprimer doivent être relatifs par rapport au chemin de l'archive comportant le fichier META-INF/ibm-partialapp-delete.props.

Pour plus d'informations sur le fichier de métadonnées .props à inclure dans les fichiers compressés, voir la section "Replace, add, or delete multiple files" de Preparing for application update settings.

Dans l'exemple de fichier de propriétés, le fichier compressé myAppPartial.zip est utilisé pour la mise à jour d'une application déployée nommée hello :

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=hello
Update=true
operationType=update
contentType=partialapp
contentFile=/temp/MyApp/myAppPartial.zip

Remplacement de la totalité d'une application d'entreprise déployée

Cet exemple de fichier de propriétés met à jour la totalité d'une application déployée :

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application


# Properties
Name=hello
Update=true
operationType=update
contentType=app
contentFile=/apps/app1/newApp1.ear
useDefaultBindings=true

Désinstallation d'une application à partir d'une cible de déploiement

Cet exemple de fichier de propriétés désinstalle une application déployée :

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application
DELETE=true

# Properties
Name=hello

Modification des options de déploiement d'une application déployée

Cet exemple de fichier de propriétés met à jour les options de déploiement d'une application déployée :

#
# Header
#
ResourceType=Application
ImplementingResourceType=Application

# Properties
Name=!{applicationName}

#
# SubSection 1.0.1 # AppDeploymentOptions Section. taskName
# and row0 should not be edited. row0 contains column names
# for the task.
#
ResourceType=Application
ImplementingResourceType=Application
ResourceId=Deployment=!{applicationName}
#

#
# Properties
#
taskName=AppDeploymentOptions
row1={$(APP_INSTALL_ROOT)/$(CELL)
AppDeploymentOption.Yes 
AppDeploymentOption.No
AppDeploymentOption.No 
AppDeploymentOption.No 
"" 
off .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755 
"WASX.SERV1 [x0617.27]" 
AppDeploymentOption.No 
AppDeploymentOption.No}
mutables={true true true true true true true true false true true}
row0={installed.ear.destination
distributeApp 
useMetaDataFromBinary 
createMBeansForResources 
reloadEnabled 
reloadInterval 
validateinstall 
filepermission 
buildVersion 
allowDispatchRemoteInclude 
allowServiceRemoteInclude} #readonly

#
EnvironmentVariablesSection
#
#
#Environment Variables
applicationName=newhello

Edition des propriétés de déploiement d'un module Web

Cet exemple de fichier de propriétés illustre la modification des propriétés de déploiement d'un module Web :

#
# WebModuleDeployment
#
ResourceType=WebModuleDeployment
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}:ApplicationDeployment=
:WebModuleDeployment=uri#web.war


#
#Properties
#
startingWeight=90000 #integer,required,default(1)
deploymentId=1 #required
classloaderMode=PARENT_FIRST ENUM(PARENT_FIRST|PARENT_LAST),default(PARENT_FIRST)
altDD=null
uri=web.war #required
#applicationDeployment=Cell=!{cellName}:Deployment=!{applicationName}:ApplicationDeployment=
#ObjectName(ApplicationDeployment)


EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell
applicationName=myApp 

Que faire ensuite

Si le fichier de propriétés déploie une application ou un module, testez l'application ou le module déployé. Par exemple, entrez l'URL d'une application déployée dans un navigateur Web et vérifiez ses performances.

Si le déploiement a échoué, lisez les messages figurant dans le fichier SystemOut.log, corrigez l'erreur et ajoutez à nouveau le fichier de propriétés dans le répertoire contrôlé.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=trun_app_install_dragdrop_prop
Nom du fichier : trun_app_install_dragdrop_prop.html