Vous pouvez utiliser des fichiers de propriétés pour créer ou modifier des
propriétés du service de suivi et le journal de trace associé sous un serveur.
Avant de commencer
Déterminez la nature des changements à apporter à votre configuration
du service de suivi 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.
Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM® i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL
en vue du traitement des incidents liés aux applications.
Pourquoi et quand exécuter cette tâche
A l'aide d'un fichier de propriétés, vous pouvez créer, modifier ou supprimer
un objet de service de suivi et ses propriétés de configuration.
Exécutez
des commandes d'administration à l'aide de wsadmin pour modifier un fichier de propriétés
pour un service de suivi, valider les propriétés et les appliquer à votre
configuration.
Tableau 1. Actions
associées aux fichiers de propriétés du service de suivi. Vous pouvez créer, modifier
et supprimer des propriétés du service de suivi.Action |
Procédure |
création |
Non applicable |
modify |
Modifiez les propriétés et exécutez la commande applyConfigProperties. |
suppression |
Non applicable |
création d'une propriété |
Paramétrez les propriétés et exécutez la commande applyConfigProperties. |
suppression d'une propriété |
Spécifiez les propriétés à supprimer du fichier de propriétés,
puis exécutez la commande deleteConfigProperties. |
Vous pouvez éventuellement utiliser le mode interactif avec les commandes :
AdminTask.nom_commande('-interactive')
Procédure
- Créez des propriétés du service de suivi.
- Spécifiez des propriétés TraceService dans un fichier de propriétés.
Ouvrez un éditeur et spécifiez des propriétés du service de suivi et un
TraceLog associé sous un serveur dans un fichier de propriétés. Vous pouvez copier l'exemple de propriétés suivant
dans un éditeur et modifier les propriétés selon
votre situation. L'exemple illustre une propriété sous TraceService
avec le nom myName et la valeur myVal.
#
# Header
#
ResourceType=TraceService
ImplementingResourceType=GenericType
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:TraceService=
AttributeInfo=services
#
#
#Properties
#
startupTraceSpecification="*=info"
enable=true #boolean,default(false)
context=!{serverName}
memoryBufferSize=8 #integer,required,default(8)
traceFormat=BASIC #ENUM(LOG_ANALYZER|BASIC|ADVANCED),default(BASIC)
traceOutputType=SPECIFIED_FILE #ENUM(SPECIFIED_FILE|MEMORY_BUFFER),default(MEMORY_BUFFER)
#
# Header
#
ResourceType=TraceLog
ImplementingResourceType=GenericType
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:TraceService=:TraceLog=
AttributeInfo=traceLog
#
#
#Properties
#
maxNumberOfBackupFiles=5 #integer,default(1)
rolloverSize=20 #integer,default(100)
fileName="${SERVER_LOG_ROOT}/trace.log"
#
# Header
#
ResourceType=TraceService
ImplementingResourceType=GenericType
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:TraceService=
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 TraceService.
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 des propriétés du service de suivi ou TraceLog associé existantes.
- Obtenez un fichier de propriétés pour le service de suivi à
modifier.
Vous pouvez extraire
un fichier de propriétés pour un objet TraceService
à 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.
- Supprimez les propriétés du service de suivi.
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.
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 de service de suivi.
Que faire ensuite
Sauvegardez les modifications de la configuration.