Validación de archivos de propiedades mediante scripts wsadmin

Utilice este tema para validar propiedades de configuración antes de aplicar los archivos de propiedades a su configuración.

Antes de empezar

Utilice el mandato extractConfigProperties en el grupo de mandatos PropertiesBasedConfiguration para extraer un archivo de propiedades de su configuración. Utilice un editor de texto para modificar las propiedades del archivo de propiedades.

Acerca de esta tarea

Hay dos pasos para validar un archivo de propiedades antes de aplicarlo a la configuración. En primer lugar, utilice el mandato validateConfigProperties para validar el archivo de propiedades. A continuación, utilice el mandato applyConfigProperties y la opción -validate para aplicar las propiedades y validar el archivo de forma simultánea.

Procedimiento

Utilice el mandato validateConfigProperties para validar un archivo de propiedades.
  1. Inicie la herramienta de scripts wsadmin.
  2. Validar el archivo de propiedades de interés.
    Para este ejemplo, valida el archivo de propiedades EJBContainer siguiente:
    # # 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
    Valide siempre el archivo de propiedades completo. No valide subsecciones de archivos. Utilice el mandato validateConfigProperties para validar el archivo de propiedades, según muestra el ejemplo de Jython siguiente:
    AdminTask.validateConfigProperties('[-propertiesFileName ejbcontainer.props 
     -variablesMapFileName ejbprops.vars -reportFileName report.txt]')

    El mandato devuelve un valor true si el sistema valida correctamente el archivo de propiedades. El mandato devuelve false si el sistema no valida el archivo.

    El mandato también genera un archivo de informe y registra las acciones de configuración, como:
    • cambios en valores de propiedades.
    • sin cambios en valores de propiedades cuando el valor de configuración es el mismo que el definido en el archivo de propiedades.
    • sin cambios en valores de propiedades de sólo lectura.
    • excepciones.
    El ejemplo siguiente muestra un archivo de informe de ejemplo:
    ADMG0820I:
    Start applying properties from file ejbcontainer.props ADMG0818I: Processing 
     la sección EJBContainer:ApplicationServer. ADMG0810I: No se cambia el valor para esta propiedad EJBTimer. El valor nuevo especificado es igual que 
     el actual {}. ADMG0810I: No se cambia el valor para esta propiedad defaultDatasourceJNDIName. El valor nuevo especificado es igual que 
     el actual nulo. ADMG0811I: Cambio del valor para esta propiedad enableSFSBFailover. El valor nuevo especificado es true. El valor anterior 
     era false. ADMG0810I: No se cambia el valor para esta propiedad inactivePoolCleanupInterval. El valor nuevo especificado es igual que el actual 
     30000. ADMG0810I: No se cambia el valor para este nombre de propiedad. El valor nuevo especificado es igual que el actual nulo. ADMG0807I: 
     La propiedad parentComponent es de sólo lectura. No se modificará ADMG0810I: No se cambia el valor para esta propiedad passivationDirectory.  
     El valor nuevo especificado es igual que el actual ${USER_INSTALL_ROOT}/temp. ADMG0807I: La propiedad server es de sólo lectura. No se 
     modificará ADMG0819I: Fin del proceso de la sección EJBContainer:ApplicationServer. 
    Para que los informes sean más concisos, especifique el parámetro reportFilterMechanism con el mandato validateConfigProperties para que sólo se informe de errores y cambios en la configuración, según se muestra en el ejemplo siguiente:
    AdminTask.validateConfigProperties('[-propertiesFileName ejbcontainer.props
     -variablesMapFileName ejbprops.vars -reportFileName report.txt
     -reportFilterMechanism Errors_And_Changes]')
    El archivo de informe filtrado muestra sólo errores y cambios en la configuración, como se muestra en la salida de ejemplo siguiente:
    ADMG0820I: Iniciar aplicación de propiedades desde el archivo ejbcontainer.props ADMG0811I: Cambio del valor 
     para esta propiedad enableSFSBFailover. El valor nuevo especificado es true. El valor anterior era false.  AADMG0831E: El valor especificado para la propiedad 
     inactivePoolCleanupInterval no es un tipo válido. El valor especificado asdf, debe ser de tipo long. ADMG0821I: Fin de aplicación de propiedades 
     del archivo ejbcontainer.props. 

Qué hacer a continuación

Si la validación de un archivo de propiedades falla, el archivo de informe generado indica la razón de la anomalía. El archivo de informe lista todos los cambios que se realizan en la configuración y los errores, si los hay.

Para identificar el problema, puede establecer el parámetro de mecanismo de filtro de informes para que sólo informe de los errores. De lo contrario, el archivo de informe generado puede ser demasiado grande para buscar los errores reales. En un archivo de informe con una combinación de cambios y errores, busque los mensajes ADMGXXXXE o uno de los mensajes ADMGXXXX siguientes:

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

Estos mensajes ADMG son errores. Si el informe tiene cualquiera de estos mensajes ADMG, corrija la condición de error en el archivo de propiedades. El error ha hecho que la propiedad o el valor de propiedad especificado no sea válido.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_7validateprops
File name: txml_7validateprops.html