Vous pouvez utiliser des fichiers de propriétés pour créer, modifier ou supprimer
les propriétés de fabriques de connexions de persistance gérée par conteneur (CMP).
Avant de commencer
Déterminez les changements à apporter à votre
configuration de fabrique de connexions CMP ou ses objets de configuration.
Démarrez l'outil de scriptage wsadmin. Pour démarrer wsadmin à l'aide du langage Jython, exécutez la commande wsadmin
-lang Jython du répertoire bin du
profil de serveur.
Pourquoi et quand exécuter cette tâche
Grâce à un fichier de propriétés, vous pouvez créer, modifier ou supprimer
un objet de fabrique de connexions CMP.
Exécutez les
commandes administratives à l'aide de wsadmin pour appliquer un fichier de propriétés pour une fabrique de connexions CMP à votre configuration, valider les propriétés ou les supprimer.
Tableau 1. Actions appliquées aux fichiers de propriétés de fabrique de connexions CMP. Vous pouvez créer, modifier et supprimer
les propriétés de fabrique de connexions CMP.Action |
Procédure |
création |
Paramétrez les propriétés requises et exécutez la commande applyConfigProperties. |
modify |
Modifiez les propriétés requises et exécutez la commande applyConfigProperties. |
suppression |
Pour supprimer tout l'objet CMPConnectorFactory,
supprimez la mise en commentaire #DELETE=true et exécutez
la commande deleteConfigProperties. |
create Property |
Non applicable |
delete Property |
Non applicable |
Vous pouvez éventuellement utiliser le mode interactif avec les commandes :
AdminTask.command_name('-interactive')
Procédure
- Créez un fichier de propriétés pour une instance CMPConnectorFactory.
- Paramétrez les propriétés CMPConnectorFactory selon les besoins.
Ouvrez un éditeur dans un fichier de propriétés CMPConnectorFactory.
Modifiez la section Environment Variables pour que les variables soient conformes à votre système
et paramétrez toute valeur de propriété à changer. Voici un exemple de fichier de propriétés CMPConnectorFactory :
#
# Header
#
ResourceType=CMPConnectorFactory
ImplementingResourceType=J2CResourceAdapter
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:J2CResourceAdapter=myJ2CResourceAdapter:
CMPConnectorFactory=jndiName#myCFJNDI
#DELETE=true
#
#
#Properties
#
name=myCF #required
connectionDefinition=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:J2CResourceAdapter=
myJ2CResourceAdapter:Connector=:ResourceAdapter=:OutboundResourceAdapter=:ConnectionDefinition=
connectionFactoryImplClass#com.ibm.ws.rsadapter.cci.WSRdbConnectionFactoryImpl #ObjectName
(ConnectionDefinition),required
category=null
authMechanismPreference=BASIC_PASSWORD #ENUM(BASIC_PASSWORD|KERBEROS),default(BASIC_PASSWORD)
providerType=null
jndiName=myCFJNDI #required
diagnoseConnectionUsage=false #boolean,default(false)
xaRecoveryAuthAlias=null
authDataAlias=null
manageCachedHandles=false #boolean,default(false)
description=null
logMissingTransactionContext=true #boolean,default(true)
#
EnvironmentVariablesSection
#Environment Variables
cellName=myCell
nodeName=myNode
serverName=myServer
- Exécutez la commande applyConfigProperties pour créer ou changer une configuration de fabrique de connexions CMP.
L'exécution de la commande applyConfigProperties
applique le fichier de propriétés à la configuration.
Dans cet
exemple Jython, le paramètre facultatif -reportFileName
génère un rapport nommé report.txt:
AdminTask.applyConfigProperties(['-propertiesFileName MonTypeObjet.props -reportFileName report.txt '])
- Modifiez un fichier de propriétés existant.
- Obtenez un fichier de propriétés pour la fabrique de connexions CMP à changer.
Vous pouvez extraire
un fichier de propriétés pour un objet CMPConnectorFactory
à l'aide de la commande extractConfigProperties.
- Ouvrez le fichier de propriétés dans un éditeur et modifiez les
propriétés souhaitées.
Vérifiez que les variables d'environnement
dans le fichier de propriétés correspondent à votre système.
- Exécutez la commande applyConfigProperties.
- Si vous n'avez plus besoin de la fabrique de connexions CMP,
vous pouvez supprimer la totalité de l'objet de la fabrique de connexions CMP.
Spécifiez DELETE=true dans
la section d'en-tête du fichier de propriétés et exécutez la commande deleteConfigProperties ;
par exemple :
AdminTask.deleteConfigProperties('[-propertiesFileName MonTypeObjet.props -reportFileName report.txt]')
Résultats
Vous pouvez utiliser le fichier de propriétés pour configurer et gérer
l'objet de fabrique de connexions CMP et ses propriétés.
Que faire ensuite
Sauvegardez les modifications de la configuration.