Vous pouvez utiliser des fichiers de propriétés pour créer ou modifier
les propriétés du service personnalisé d'un serveur.
Avant de commencer
Déterminez les changements à apporter à votre
configuration de service personnalisé 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 service personnalisé 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 service personnalisé, valider les propriétés et les appliquer à
votre configuration.
Tableau 1. Actions appliquées aux fichiers de propriétés de service personnalisé. Vous pouvez créer, modifier et supprimer
les propriétés de service personnalisé.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 |
Paramétrez les propriétés et exécutez la commande applyConfigProperties. |
delete Property |
Pour supprimer une ou plusieurs propriétés, exécutez deleteConfigProperties uniquement avec les propriétés
à supprimer dans le fichier de propriétés. |
Vous pouvez éventuellement utiliser le mode interactif avec les commandes :
AdminTask.command_name('-interactive')
Procédure
- Créez un service personnalisé et ses propriétés.
- Créez un fichier de propriétés pour un objet CustomService.
Ouvrez un éditeur et créez un fichier de propriétés de service personnalisé.
Vous pouvez copier l'exemple de fichier de propriétés de cette étape dans un éditeur
et modifier les propriétés selon vos besoins.
Voici un exemple de fichier de propriétés pour un objet CustomService de serveur. Une propriété de CustomService portant le nom myName et présentant une valeur myVal est présentée dans cet exemple.
#
# SubSection 1.0 # CustomService
#
ResourceType=CustomService
ImplementingResourceType=CustomService
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:CustomService=displayName#mydisplayName
AttributeInfo=customServices
#DELETE=true
#
#Properties
#
displayName=mydisplayName #required
classpath=myclasspath #required
enable=false #boolean,default(false)
externalConfigURL=null
context=null
description=null
classname=mclass.name #required
prerequisiteServices={} #ObjectName*(null)
#
# SubSection 1.0.1 # CustomService properties
#
ResourceType=CustomService
ImplementingResourceType=CustomService
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:CustomService=displayName#mydisplayName
AttributeInfo=properties(name,value)
#
#
#Properties
#
myName=myVal
EnvironmentVariablesSection
#Environment Variables
cellName=WASCell06
serverName=myServer
nodeName=WASNode04
- Exécutez la commande applyConfigProperties pour créer une configuration CustomService.
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 service personnalisé existant.
- Obtenez un fichier de propriétés pour le service personnalisé à changer.
Vous pouvez extraire
un fichier de propriétés pour un objet CustomService
à 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 service personnalisée.
- Supprimez la totalité de l'objet de service personnalisé ou ses propriétés.
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 myObjectType.props -reportFileName report.txt]')
Pour supprimer une ou plusieurs propriétés, indiquez uniquement les propriétés
à supprimer dans le fichier de propriétés et exécutez deleteConfigProperties.
Résultats
Vous pouvez utiliser le fichier de propriétés pour configurer et gérer
l'objet du service personnalisé.
Que faire ensuite
Sauvegardez les modifications de la configuration.