Vous pouvez utiliser des fichiers de propriétés pour créer, modifier ou supprimer
les propriétés du pool de connexions d'une source de données.
Avant de commencer
Déterminez les changements à apporter à votre
configuration de source de données 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 pool de connexions.
Exécutez les
commandes administratives à l'aide de wsadmin pour appliquer un fichier de propriétés pour un pool de connexions à votre configuration, valider les propriétés ou les supprimer.
Tableau 1. Actions
appliquées aux fichiers de propriétés du pool de connexions. Vous pouvez créer, modifier et supprimer
les propriétés du pool de connexions.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 ConnectionPool,
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 ConnectionPool.
- Paramétrez les propriétés ConnectionPool selon les besoins.
Ouvrez un éditeur dans un fichier de propriétés ConnectionPool. Modifiez la section Environment Variables pour que les variables soient conformes à votre système
et paramétrez toute valeur de propriété à changer. Pour définir
une propriété personnalisée, modifiez la valeur AttributeInfo et
les valeurs de propriétés. Voici un exemple de fichier de propriétés ConnectionPool :
#
# Header
#
ResourceType=ConnectionPool
ImplementingResourceType=JDBCProvider
ResourceId=Cell=!{cellName}:Node=!{nodeName2}:Server=!{serverName2}:JDBCProvider=myJDBCProvider:
DataSource=jndiName#myDataSourceJNDI:ConnectionPool=
AttributeInfo=connectionPool
#
#
#Properties
#
stuckThreshold=0 #integer
unusedTimeout=1800 #long
maxConnections=10 #integer
stuckTimerTime=0 #integer
testConnectionInterval=0 #integer
minConnections=1 #integer
surgeThreshold=-1 #integer
connectionTimeout=180 #long
purgePolicy=EntirePool #ENUM(EntirePool|FailingConnectionOnly)
surgeCreationInterval=0 #integer
numberOfUnsharedPoolPartitions=0 #integer
stuckTime=0 #integer
agedTimeout=0 #long
reapTime=180 #long
testConnection=false #boolean
numberOfSharedPoolPartitions=0 #integer
freePoolDistributionTableSize=0 #integer
numberOfFreePoolPartitions=0 #integer
EnvironmentVariablesSection
#Environment Variables
cellName=myCell
nodeName=myNode
serverName=myServer
- Exécutez la commande applyConfigProperties pour créer ou changer une configuration de pool de connexions.
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 '])
- Modifier un fichier de propriétés existant.
- Obtenez un fichier de propriétés pour le pool de connexions à changer.
Vous pouvez extraire
un fichier de propriétés pour un objet ConnectionPool
à l'aide de la commande extractConfigProperties.
- Ouvrez le fichier de propriétés dans un éditeur et changez les
propriétés selon les besoins.
Vérifiez que les variables d'environnement
du fichier de propriétés correspondent à votre système.
- Exécutez la commande applyConfigProperties.
- Si vous n'avez plus besoin du pool de connexions,
vous pouvez supprimer la totalité de l'objet du pool de connexions.
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 myObjectType.props -reportFileName report.txt]')
Résultats
Vous pouvez utiliser le fichier de propriétés pour configurer et gérer
l'objet du pool de connexions et ses propriétés.
Que faire ensuite
Sauvegardez les modifications de la configuration.