Validation de fichiers de propriétés à l'aide de l'outil de scriptage wsadmin

Cette rubrique permet de valider des propriétés de configuration avant d'appliquer des fichiers de propriétés à votre configuration.

Avant de commencer

Utilisez la commande extractConfigProperties du groupe de propriétés PropertiesBasedConfiguration pour extraire un fichier de propriétés de votre configuration. Utilisez un éditeur de texte pour modifier les propriétés du fichier de propriétés.

Pourquoi et quand exécuter cette tâche

La validation d'un fichier de propriétés avant de pouvoir l'appliquer à la configuration comporte deux étapes. Premièrement, utilisez la commande validateConfigProperties pour valider le fichier de propriétés. Ensuite, utilisez la commande applyConfigProperties et l'option -validate pour appliquer les propriétés et valider le fichier, simultanément.

Procédure

Utilisez la commande validateConfigProperties pour valider un fichier de propriétés.
  1. Démarrez l'outil de scriptage wsadmin.
  2. Validez le fichier de propriétés visé.
    Dans cet exemple, validez le fichier de propriétés EJBContainer suivant :
    # # SubSection 1.0 # EJBContainer # ResourceType=EJBContainer 
     ImplementingResourceType=EJBContainer 
     ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}
     :ApplicationServer=ID#ApplicationServer_1:EJBContainer=ID#EJBCon
    ntainer_1 AttributeInfo=components # # #Properties # EJBTimer={}
     #ObjectName*(null) name=null defaultDatasourceJNDIName=null 
     inactivePoolCleanupInterval=30000 #long passivationDirectory="${USER_INSTALL_ROOT}/temp" 
      enableSFSBFailover=true#boolean server=null parentComponent=Network Deployment Server
    Validez toujours le fichier de propriétés dans sa totalité. Ne validez pas des sous-sections du fichier. Utilisez la commande validateConfigProperties pour valider le fichier de propriétés, tel qu'illustré dans l'exemple Jython suivant :
    AdminTask.validateConfigProperties('[-propertiesFileName ejbcontainer.props 
     -variablesMapFileName ejbprops.vars -reportFileName report.txt]')

    La commande renvoie la valeur true si le système valide le fichier de propriétés. La commande renvoie la valeur false si le système ne valide pas le fichier.

    La commande génère également un fichier de rapport et enregistre les actions de configuration, telles que :
    • les modifications apportées à des valeurs de propriétés ;
    • aucune modification des valeurs de propriétés quand la valeur de configuration est identique à celle définie dans le fichier de propriétés ;
    • aucune modification à des valeurs de propriétés en lecture seule ;
    • les exceptions.
    Vous trouverez ci-après un exemple de fichier de rapport :
    ADMG0820I: Start applying properties from file ejbcontainer.props ADMG0818I: Processing 
     section EJBContainer:ApplicationServer. ADMG0810I: Not changing value for this property EJBTimer. (pas de modification de la valeur de la propriété EJBTimer) New value specified is same as current value {}. (la nouvelle valeur spécifiée est identique à la valeur actuelle {}) ADMG0810I: Not changing value for this property defaultDatasourceJNDIName. (pas de modification de la valeur de la propriété defaultDatasourceJNDIName) New value specified is same as current value null. (la nouvelle valeur spécifiée est identique à la valeur null actuelle) ADMG0811I: Changing value for this property enableSFSBFailover. (modification de la valeur de la propriété enableSFSBFailover) New value specified is true. (la nouvelle valeur indiquée est true) Old value was false. (l'ancienne valeur était false) ADMG0810I: Not changing value for this property inactivePoolCleanupInterval. (pas de modification de valeur de la propriété inactivePoolCleanupInterval) New value specified is same as current value (la nouvelle valeur spécifiée est identique à la valeur actuelle) 
     30000. ADMG0810I: Not changing value for this property name. (pas de modification de valeur pour ce nom de propriété) New value specified is same as current value null. (la nouvelle valeur spécifiée est identique à la valeur null actuelle) ADMG0807I: Property parentComponent is readonly. (la propriété parentComponent est en lecture seule) Will not be modified (ne sera pas modifiée) ADMG0810I: Not changing value for this property passivationDirectory. (pas de modification de valeur pour la propriété passivationDirectory)  
     New value specified is same as current value ${USER_INSTALL_ROOT}/temp. (la nouvelle valeur spécifiée est identique à la valeur actuelle ${USER_INSTALL_ROOT}/temp) ADMG0807I: Property server is readonly. (la propriété server est en lecture seule) Will not be modified (ne sera pas modifiée) ADMG0819I: End Processing section EJBContainer:ApplicationServer. (fin du traitement de la section EJBContainer:ApplicationServer) 
    Afin que les rapports soient plus concis, indiquez le paramètre reportFilterMechanism à l'aide de la commande validateConfigProperties pour ne répertorier que les erreurs et les modifications de la configuration, tel qu'illustré dans l'exemple suivant :
    AdminTask.validateConfigProperties('[-propertiesFileName ejbcontainer.props 
     -variablesMapFileName ejbprops.vars -reportFileName report.txt
     -reportFilterMechanism Errors_And_Changes]')
    Le fichier de rapport filtré ne signale que les erreurs et les modifications, tel qu'illustré dans l'exemple de sortie suivant :
    ADMG0820I: Start applying properties from file ejbcontainer.props ADMG0811I: Changing value 
     for this property enableSFSBFailover. New value specified is true. (la nouvelle valeur indiquée est true) Old value was false. (l'ancienne valeur était false)  AADMG0831E: Value specified for property inactivePoolCleanupInterval is not a valid type. (la valeur spécifiée pour la propriété inactivePoolCleanupInterval n'a pas un type valide) Specified value asdf, Required type long. (valeur indiquée asdf, type obligatoire long) ADMG0821I: End applying properties from file ejbcontainer.props. (fin de l'application des propriétés à partir du fichier ejbcontainer.props) 

Que faire ensuite

Si la validation d'un fichier de propriétés échoue, le fichier de rapports générés indique le motif de la défaillance. Le fichier de rapports liste les changements apportés à la configuration et toutes les erreurs.

Pour identifier le problème, vous pouvez définir le paramètre de mécanisme de filtre de rapports afin de signaler uniquement les erreurs. Sinon, le fichier de rapports générés risque d'être trop grand pour rechercher les erreurs se produisant. Dans un fichier de rapports comprenant une combinaison de changements et d'erreurs, recherchez les messsages ADMGXXXXE ou l'un des messages ADMGXXXX suivants :

  • ADMG0809I
  • ADMG0815I
  • ADMG0826I
  • ADMG0829I
  • ADMG0831I
  • ADMG0832I
  • ADMG0833I
  • ADMG0834I
  • ADMG0835I

Ces messages ADMG sont des messages d'erreur. Si le rapport comprend l'un de ces messages ADMG, corrigez l'erreur dans le fichier de propriétés. L'erreur a entraîné la non validité de la propriété spécifiée ou de la valeur de propriété spécifiée.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_7validateprops
Nom du fichier : txml_7validateprops.html