Utilisez cette rubrique et l'outil wsadmin pour appliquer des modifications de propriétés à votre environnement à l'aide de fichiers de propriétés.
Avant de commencer
Utilisez la commande extractConfigProperties du groupe PropertiesBasedConfiguration
pour extraire les fichiers de propriétés qui vous intéressent. Utilisez un éditeur de texte pour modifier une ou plusieurs valeurs dans le fichier de propriétés.
Utilisez la commande validateConfigProperties
du groupe PropertiesBasedConfiguration pour valider le fichier de propriétés modifié avant d'appliquer ce fichier dans votre configuration.
Pourquoi et quand exécuter cette tâche
Eviter les incidents: Un fichier de propriétés du système d'exploitation z/OS n'est pas directement applicable dans un système d'exploitation réparti. De même, un fichier de propriétés de système d'exploitation réparti n'est pas directement applicable à un système d'exploitation z/OS.
gotcha
Vous pouvez également utiliser le mode interactif avec ces commandes, tel qu'illustré dans la syntaxe ci-après :
AdminTask.commandName('-interactive')
Procédure
- Modifiez une ou plusieurs propriétés, puis appliquer le fichier de propriétés à la configuration.
- Démarrez l'outil de scriptage wsadmin.
- Modifiez les propriétés visées.
Dans le fichier de propriétés suivant, utilisez un éditeur de texte pour modifier la valeur de la propriété
enableSFSB :
#
# SubSection 1.0 # EJBContainer
#
ResourceType=EJBContainer
ImplementingResourceType=EJBContainer
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=
ID#ApplicationServer_1:EJBContainer=ID#EJBContainer_1AttributeInfo=components
#
#
#Properties
#
EJBTimer={} #ObjectName*(null)
name=null
defaultDatasourceJNDIName=null
inactivePoolCleanupInterval=30000 #long
passivationDirectory="${USER_INSTALL_ROOT}/temp"
enableSFSBFailover=true #boolean
server=null
parentComponent=WebSphere
Application Server, Network Deployment Server
EnvironmentVariablesSection
#
#
#Environment Variables
#Thu Apr 17 14:10:31 CDT 2008
hostName2=*
hostName1=localhost
cellName=IBM-49F7FB781FECell07
nodeName=IBM-49F7FB781FECellManager07
hostName=IBM-49F7FB781FE.austin.ibm.com
serverName=dmgr
enableSSB=true
- Appliquez les propriétés modifiées à votre configuration.
Utilisez la commande
applyConfigProperties pour appliquer le fichier de propriétés à la configuration, tel qu'illustré dans l'exemple Jython suivant :
AdminTask.applyConfigProperties('[-propertiesFileName ejbcontainer.props]')
- Utilisez des variables modifiées par l'utilisateur complémentaires pour modifier la configuration.
- Démarrez l'outil de scriptage wsadmin.
- Utilisez des variables supplémentaires pour modifier la propriété enableSFSBFailover
du conteneur EJB, en remplaçant sa valeur true par false.
Dans le fichier de propriétés suivant, modifiez la propriété enableSFSBFailover
en indiquant comme valeur, la variable
!{enableSSB}.
Vous pouvez utiliser cette variable dans l'en-tête de section ou dans la partie des propriétés de la section. De même, une valeur de propriété peut contenir plusieurs variables, tel qu'illustré pour ResourceId.
#
# SubSection 1.0 # EJBContainer
#
ResourceType=EJBContainer
ImplementingResourceType=EJBContainer
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=ID#ApplicationServer_1:
EJBContainer=ID#EJBContainer_1
AttributeInfo=components
#
#
#Properties
#
EJBTimer={} #ObjectName*(null)
name=null
defaultDatasourceJNDIName=null
inactivePoolCleanupInterval=30000 #long
passivationDirectory="${USER_INSTALL_ROOT}/temp"
enableSFSBFailover=!{enableSSB} #boolean
server=null
parentComponent=WebSphere
Application Server, Network Deployment Server
EnvironmentVariablesSection
#
#
#Environment Variables
#Thu Apr 17 14:10:31 CDT 2008
hostName2=*
hostName1=localhost
cellName=IBM-49F7FB781FECell07
nodeName=IBM-49F7FB781FECellManager07
hostName=IBM-49F7FB781FE.austin.ibm.com
serverName=dmgr
enableSSB=true
- Appliquez les propriétés modifiées à votre configuration.
Utilisez la commande
applyConfigProperties pour appliquer le fichier de propriétés à la configuration, tel qu'illustré dans l'exemple Jython suivant :
AdminTask.applyConfigProperties('[-propertiesFileName ejbcontainer.props]')
- Modifiez la configuration en appliquant un fichier de propriétés et une mappe de variables.
- Démarrez l'outil de scriptage wsadmin.
- Modifiez la propriété enableSFSBFailover du conteneur EJB, en remplaçant la valeur true par false.
Modifiez la propriété enableSFSBFailover en indiquant comme valeur la variable
!{enableSSB} dans un fichier de mappe de variables indépendant. Plutôt que d'indiquer la variable dans la section d'en-tête ou dans la partie des propriétés de la section, créez un fichier de mappe de variables indépendant. Le code suivant est un exemple de fichier de mappe de variables :
ejbprops.vars:
#
#
#Environment Variables
#Day Month 11 Time CDT Year
hostName2=*
hostName1=localhost
cellName=myCell
nodeName=myNode
hostName=myhost.com
serverName=myServer
enableSSB=true
Le code suivant montre le fichier de propriétés correspondant à appliquer à la configuration :
#
# SubSection 1.0 # EJBContainer
#
ResourceType=EJBContainer
ImplementingResourceType=EJBContainer
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=ID#ApplicationServer_1:
EJBContainer=ID#EJBContainer_1
AttributeInfo=components
#
#
#Properties
#
EJBTimer={} #ObjectName*(null)
name=null
defaultDatasourceJNDIName=null
inactivePoolCleanupInterval=30000 #long
passivationDirectory="${USER_INSTALL_ROOT}/temp"
enableSFSBFailover=true#boolean
server=null
parentComponent=WebSphere
Application Server, Network Deployment Server
- Appliquez les propriétés modifiées à votre configuration.
Utilisez la
commande applyConfigProperties pour appliquer le fichier de propriétés et le fichier de mappe de variables à la configuration, tel qu'illustré dans l'exemple Jython suivant :
AdminTask.applyConfigProperties('[-propertiesFileName ejbcontainer.props -variablesMapFileName
ejbprops.vars]')
Que faire ensuite
Pour vérifier que les modifications ont bien été appliquées, extrayez le fichier de propriétés de votre configuration à l'aide de la commande extractPropertiesFile.