Network Deployment (Distributed operating systems), v8.0 > Troubleshoot and support > Use HPEL to troubleshoot applications > Configure HPEL


Configure HPEL with wsadmin scripting


Use the AdminConfig object to configure HPEL

  1. Change the trace specification.
    HPELService = AdminConfig.getid("/Cell:myCell/Node:myNode/Server:myServer/HighPerformanceExtensibleLogging:/")
    AdminConfig.modify(HPELService, "[[startupTraceSpec *=info:com.ibm.ws.classloader.*=all]]")
    AdminConfig.save()

  2. Set HPEL to delete eldest log content when repository size approaches 65 MB....
    HPELService = AdminConfig.getid("/Cell:myCell/Node:myNode/Server:myServer/HighPerformanceExtensibleLogging:/")
    HPELLog = AdminConfig.list("HPELLog", HPELService)
    AdminConfig.modify(HPELLog, "[[purgeMaxSize 65]]")
    AdminConfig.save()

  3. Change the HPEL log repository /tmp/myDirectory.

    HPELService = AdminConfig.getid("/Cell:myCell/Node:myNode/Server:myServer/HighPerformanceExtensibleLogging:/")
    HPELLog = AdminConfig.list("HPELLog", HPELService)
    AdminConfig.modify(HPELLog, "[[dataDirectory /tmp/myDirectory]]")
    AdminConfig.save()

    To change the setting for the HPEL trace repository or HPEL text log, specify HPELTrace or HPELTextLog instead of HPELLog

  4. Disable log record buffering.

    HPELService = AdminConfig.getid("/Cell:myCell/Node:myNode/Server:myServer/HighPerformanceExtensibleLogging:/")
    HPELLog = AdminConfig.list("HPELLog", HPELService)
    AdminConfig.modify(HPELLog, "[[bufferingEnabled false]]")
    AdminConfig.save()

    Enable log record buffering in almost all cases. Only disable log record buffering when your server is failing unexpectedly and cannot write buffered content to disk before stopping. bprac

  5. Enable the HPEL log repository to start a new log file each day at 3pm.
    HPELService = AdminConfig.getid("/Cell:myCell/Node:myNode/Server:myServer/HighPerformanceExtensibleLogging:/")
    HPELLog = AdminConfig.list("HPELLog", HPELService)
    AdminConfig.modify(HPELLog, "[[fileSwitchTime 15]]")
    AdminConfig.modify(HPELLog, "[[fileSwitchEnabled true]]")
    AdminConfig.save()

  6. Change the out of space action for the HPEL log repository.
    HPELService = AdminConfig.getid("/Cell:myCell/Node:myNode/Server:myServer/HighPerformanceExtensibleLogging:/")
    HPELLog = AdminConfig.list("HPELLog", HPELService)
    AdminConfig.modify(HPELLog, "[[outOfSpaceAction PurgeOld]]")
    AdminConfig.save()

  7. Synchronize the node agent and restart server

  8. Restart the server to make the changes take effect.


Use AdminControl to configure HPEL

Changes made using the AdminControl object take effect immediately.

  1. Change the trace specification.

    The following example shows how to change the trace specification to *=info:com.ibm.ws.classloader.*=all

    HPELControlMBean = AdminControl.queryNames('cell=myCell,node=myNode,type=HPELControlService,process=myServer,*')
    AdminControl.setAttribute(HPELControlMBean, "traceSpecification", "*=info:com.ibm.ws.classloader.*=all")

  2. Change the size of the log repository.

    The following example shows how to set HPEL to automatically delete the oldest log content from the log repository when the repository size approaches 65 MB. Specify HPELTraceDataService or HPELTextLogService instead of HPELLogDataService to change the setting for the HPEL trace repository or HPEL text log. 

    HPELLogDataMBean = AdminControl.queryNames('cell=myCell,node=myNode,type=HPELLogDataService,process=myServer,*')
AdminControl.setAttribute(HPELLogDataMBean, "purgeMaxSize", "65")

  3. Change the log repository location.

    The following example shows how to change the HPEL log repository directory name to /tmp/myDirectory. Specify HPELTraceDataService or HPELTextLogService instead of HPELLogDataService to change the setting for the HPEL trace repository or HPEL text log. 

    HPELLogDataMBean = AdminControl.queryNames('cell=myCell,node=myNode,type=HPELLogDataService,process=myServer,*')
AdminControl.setAttribute(HPELLogDataMBean, "dataDirectory", "/tmp/myDirectory")

  4. Disable log record buffering.

    The following example shows how to change the HPEL log repository to not use log record buffering. Specify HPELTraceDataService or HPELTextLogService instead of HPELLogDataService to change the setting for the HPEL trace repository or HPEL text log. 

    HPELLogDataMBean = AdminControl.queryNames('cell=myCell,node=myNode,type=HPELLogDataService,process=myServer,*')
AdminControl.setAttribute(HPELLogDataMBean, "bufferingEnabled", "false")

    Enable log record buffering in almost all cases. Only disable log record buffering when your server is failing unexpectedly and cannot write buffered content to disk before stopping. bprac

  5. Start writing to a new log file each day at a specified time.

    The following example shows how to enable the HPEL log repository to start a new log file each day at 3pm. Specify HPELTrace or HPELTextLog instead of HPELLog to change the setting for the HPEL trace repository or HPEL text log. 

    HPELLogDataMBean = AdminControl.queryNames('cell=myCell,node=myNode,type=HPELLogDataService,process=myServer,*')
AdminControl.setAttribute(HPELLogDataMBean, "fileSwitchTime", "15")
AdminControl.setAttribute(HPELLogDataMBean, "fileSwitchEnabled", "true")

  6. Change the out of space action for the log repository.

    The following example shows how to change the out of space action for the HPEL log repository. Specify HPELTraceDataService or HPELTextLogService instead of HPELLogDataService to change the setting for the HPEL trace repository or HPEL text log. 

    HPELLogDataMBean = AdminControl.queryNames('cell=myCell,node=myNode,type=HPELLogDataService,process=myServer,*')
AdminControl.setAttribute(HPELLogDataMBean, "outOfSpaceAction", "PurgeOld")

High Performance Extensible Logging (HPEL)
Use the wsadmin scripting AdminConfig object for scripted administration
Change from basic mode to HPEL logging and tracing
Change from HPEL to basic mode logging and tracing

+

Search Tips   |   Advanced Search