Utilisez cette rubrique pour utiliser un fichier de propriétés extraites pour créer ou supprimer des objets de configuration qui ne sont pas des objets serveur, cluster, application ou groupe d'autorisations.
Pourquoi et quand exécuter cette tâche
Le groupe de commandes PropertiesBasedConfiguration de l'objet AdminTask
permet d'utiliser des fichiers de propriétés pour créer et supprimer des objets de configuration de votre environnement.
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
Procédure
- Démarrez l'outil de scriptage wsadmin.
- Extrayez de votre configuration un fichier de propriétés du sous-type qui vous intéresse.
La commande extractConfigProperties permet d'extraire le fichier de propriétés de la ressource qui vous intéresse.
Dans l'exemple suivant, les propriétés de la ressource ThreadPool sont extraites :
AdminTask.extractConfigProperties('[-propertiesFileName threadPool.props -configData
Server=server1 -filterMechanism SELECTED_SUBTYPES -selectedSubTypes [ThreadPool]]')
Cette commande génère un fichier modèle semblable à l'exemple de modèle suivant :
# # SubSection 1.0.1.4 # Thread pools # ResourceType=ThreadPool
ImplementingResourceType=Server ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:Thr
eadPoolManager=ID#ThreadPoolManager_1:ThreadPool=ID#builtin_ThreadPool_4 # # #Properties #
maximumSize=20 #integer name=Default inactivityTimeout=5000 #integer minimumSize=5
#integer isGrowable=false #boolean
- Créez ou supprimez des objets de configuration.
Pour créer un nouveau pool d'unités d'exécution ou en supprimer un existant, modifiez l'attribut ResourceId.
- Pour créer un nouveau pool d'unités d'exécution, attribuez à l'attribut ResourceId une valeur qui n'existe pas dans votre configuration. Dans l'exemple suivant, notez que le ResourceId ThreadPool=ID#builtin_ThreadPool_4 est remplacée par le ResourceId ThreadPool=ID#ThreadPool_99999 qui n'existe pas dans la configuration :
# # SubSection 1.0.1.4 # Thread pools # ResourceType=ThreadPool
ImplementingResourceType=Server ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:Thr
eadPoolManager=ID#ThreadPoolManager_1:ThreadPool=ID#ThreadPool_99999 # # #Properties # maximumSize=20
#integer name=myThreadPool inactivityTimeout=5000 #integer minimumSize=5 #integer isGrowable=false #Boolean
Exécutez la commande applyConfigProperties pour appliquer le fichier de propriétés à votre configuration, tel qu'illustré dans la commande suivante :
AdminTask.applyConfigProperties('[-propertiesFileName threadPool.props]')
La commande valide automatiquement le fichier de propriétés, puis utilise les valeurs modifiées dans le fichier pour créer un nouveau pool d'unités d'exécution dans votre configuration.
- Pour supprimer le pool d'unités d'exécution, indiquez la propriété DELETE=true dans l'en-tête du fichier de propriétés, tel qu'illustré dans l'exemple suivant :
# # SubSection 1.0.1.4 # Thread pools # ResourceType=ThreadPool
ImplementingResourceType=Server ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:Thr
eadPoolManager=ID#ThreadPoolManager_1:ThreadPool=myThreadPool DELETE=true # # #Properties # maximumSize=20
#integer name=myThreadPool inactivityTimeout=5000 #integer minimumSize=5 #integer isGrowable=false #boolean
Exécutez la commande deleteConfigProperties pour utiliser le fichier de propriétés pour supprimer le pool d'unités d'exécution de votre configuration, tel qu'illustré dans la commande suivante :
AdminTask.deleteConfigProperties('[-propertiesFileName threadPool.props]')
La commande valide automatiquement le fichier de propriétés, puis utilise le nouvel attribut et la nouvelle valeur dans le fichier pour supprimer le pool d'unités d'exécution de votre configuration.
Eviter les incidents: Si vous exécutez la commande deleteConfigProperties avant d'ajouter l'attribut et la valeur
DELETE=true au fichier de propriétés, la commande réinitialise chaque propriété à sa valeur par défaut. Le système supprime complètement les propriétés n'ayant pas de valeurs par défaut.
gotcha
- Sauvegardez les modifications de configuration.
Entrez l'exemple de commande suivante pour sauvegarder les modifications de
configuration :
AdminConfig.save()