Vous pouvez utiliser des fichiers de propriétés pour créer ou modifier
les propriétés du port d'écoute Message
Listener Service d'un serveur et les objets StateManageable associés.
Avant de commencer
Déterminez les changements à apporter à votre
configuration de port d'écoute 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 port d'écoute et ses propriétés de configuration.
Exécutez les
commandes administratives à l'aide de wsadmin pour créer ou changer un fichier de propriétés pour un port d'écoute, valider les propriétés et les appliquer à
votre configuration.
Tableau 1. Actions
appliquées aux fichiers de propriétés du port d'écoute Message Listener
Service. Vous pouvez créer, modifier et supprimer
les propriétés de configuration du port d'écoute.Action |
Procédure |
création |
Paramétrez les propriétés et exécutez la commande applyConfigProperties. |
modify |
Modifiez les propriétés et exécutez la commande applyConfigProperties. |
suppression |
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 port d'écoute et ses propriétés.
- Créez des propriétés ListenerPort dans un fichier de propriétés,
Ouvrez un éditeur et spécifiez les propriétés du port d'écoute. Vous pouvez copier l'exemple de propriétés suivant dans un éditeur
et modifier les propriétés selon vos besoins. L'exemple indique un port d'écoute
du MessageListenerService d'un serveur et l'objet StateManageable associé.
#
# SubSection 1.0.0 # ListenerPort
#
ResourceType=ListenerPort
ImplementingResourceType=GenericType
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=:EJBContainer=
:MessageListenerService=:ListenerPort=myName
AttributeInfo=listenerPorts
#DELETE=true
#
#Properties
#
destinationJNDIName=dName #required
connectionFactoryJNDIName=myjName #required
name=myName #required
maxMessages=1 #integer,default(1)
description=My description
maxSessions=1 #integer,default(1)
maxRetries=0 #integer,default(0)
#
# SubSection 1.0.0.0 # ListenerPort State Management
#
ResourceType=StateManageable
ImplementingResourceType=GenericType
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=:EJBContainer=
:MessageListenerService=:ListenerPort=myName:StateManageable=
AttributeInfo=stateManagement
#
#
#Properties
#
initialState=START #ENUM(STOP|START),default(START)
managedObject=myName
EnvironmentVariablesSection
#Environment Variables
cellName=WASCell06
serverName=myServer
nodeName=WASNode04
- Exécutez la commande applyConfigProperties pour créer une configuration de port d'écoute.
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 port d'écoute existant.
- Obtenez un fichier de propriétés pour le port d'écoute à changer.
Vous pouvez extraire
un fichier de propriétés pour un objet ListenerPort
à 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 pour changer une configuration de port d'écoute.
- Si vous n'avez plus besoin du port d'écoute,
vous pouvez supprimer la totalité de l'objet de port d'écoute.
Pour supprimer tout l'objet, 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
le port d'écoute.
Que faire ensuite
Sauvegardez les modifications de la configuration.