Puede utilizar archivos de propiedades para crear o modificar propiedades del servicio de rastreo y
el registro de rastreo asociado a un servidor.
Antes de empezar
Determine los cambios que desea realizar en la configuración del servicio de rastreo o sus
objetos de configuración.
Inicie la herramienta de scripts wsadmin. Para iniciar wsadmin utilizando el lenguaje
Jython, ejecute el mandato wsadmin -lang jython desde el directorio bin
del perfil del servidor.
Nota: En este tema se hace referencia a uno o más de los archivos de registro del servidor de aplicaciones. Como alternativa recomendada, puede configurar el servidor para utilizar la infraestructura de registro y rastreo HPEL en lugar de utilizar los archivos SystemOut.log , SystemErr.log, trace.log y activity.log en sistemas distribuidos y de IBM® i. Puede también utilizar HPEL junto con sus recursos de registro nativos de z/OS. Si utiliza HPEL, puede acceder a toda la
información de registro y rastreo utilizando la herramienta de línea de mandatos LogViewer desde
el directorio bin de perfil de servidor. Consulte la información sobre la utilización de HPEL
para resolver problemas de aplicaciones para obtener más información sobre la utilización de
HPEL.
Acerca de esta tarea
Utilizando un archivo de propiedades, puede crear, modificar o suprimir un objeto de servicio de
rastreo y sus propiedades de configuración.
Ejecute mandatos administrativos utilizando wsadmin para
cambiar un archivo de propiedades de un servicio de rastreo, validar las propiedades y aplicarlas a su configuración.
Tabla 1. Acciones para los archivos de propiedades del servicio de rastreo. Puede crear, modificar y suprimir propiedades del servicio de rastreoAcción |
Procedimiento |
crear |
No se aplica |
modify |
Edite las propiedades y ejecute el mandato applyConfigProperties. |
delete |
No se aplica |
crear Propiedad |
Establezca las propiedades y ejecute el mandato applyConfigProperties. |
suprimir Propiedad |
Especifique las propiedades que se han de suprimir en el archivo de propiedades y, a
continuación, ejecute el mandato deleteConfigProperties. |
Opcionalmente, puede utilizar la modalidad interactiva con los mandatos:
AdminTask.nombre_mandato('-interactive')
Procedimiento
- Crear propiedades del servicio de rastreo.
- Especifique propiedades TraceService en un archivo de propiedades.
Abra un editor y especifique las propiedades del servicio de rastreo y un TraceLog asociados bajo un
servidor en
un archivo de propiedades. Puede copiar las siguientes propiedades de ejemplo en un editor y modificar las propiedades
según sea necesario para su situación.
El siguiente ejemplo muestra una propiedad bajo
TraceService con el nombre myName y el valor 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
- Ejecute el mandato applyConfigProperties para crear una configuración de TraceService.
La ejecución del mandato applyConfigProperties aplica el archivo de propiedades a la configuración. En
este ejemplo de Jython, el parámetro -reportFileName opcional genera un informe con el
nombre report.txt:
AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt '])
- Modiciar las propiedades del servicio de rastreo o del TraceLog asociado
- Obtenga un archivo de propiedades para el servicio de rastreo que desea cambiar.
Puede extraer un archivo de propiedades de un objeto TraceService utilizando el mandato
extractConfigProperties.
- Abra el archivo de propiedades en un editor y cambie las propiedades según sea necesario.
Asegúrese de que las variables de entorno del archivo de propiedades coincidan con su sistema.
- Ejecute el mandato applyConfigProperties.
- Suprimir las propiedades del servicio de rastreo.
Para suprimir una o más propiedades, especifique sólo aquellas propiedades que desea suprimir en el
archivo de propiedades y ejecute deleteConfigProperties.
AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')
Resultados
Puede utilizar el archivo de propiedades para configurar y gestionar el objeto de servicio de
rastreo.
Qué hacer a continuación
Guarde los cambios en la configuración.