Configure HPEL with wsadmin scripting


Use the AdminConfig object to configure HPEL

  1. Change the trace specification.

    For example, change the trace specification to *=info:com.ibm.ws.classloader.*=all

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

  2. Change the size of the log repository.

    For example, delete the oldest log content from the log repository when the repository size approaches 65 MB. Specify HPELTrace or HPELTextLog instead of HPELLog to change the setting for the HPEL trace repository or HPEL text log.

      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 log repository location.

    For example, change the HPEL log repository directory name to /tmp/myDirectory. Specify HPELTrace or HPELTextLog instead of HPELLog to change the setting for the HPEL trace repository or HPEL text log.

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

  4. Disable log record buffering.

    For example, change the HPEL log repository to not use log record buffering. Specify HPELTrace or HPELTextLog instead of HPELLog to change the setting for the HPEL trace repository or HPEL text log.

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

    Best practice is to enable log record buffering in almost all cases. Only disable log record buffering when the server is failing unexpectedly and cannot write buffered content to disk before stopping..

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

    For example, 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.

      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 log repository.

    For example, change the out of space action for the HPEL log repository. Specify HPELTrace or HPELTextLog instead of HPELLog to change the setting for the HPEL trace repository or HPEL text log.

      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 on the target node and restart the server


Use the AdminControl object to configure HPEL

Changes you make using the AdminControl object take effect immediately.

  1. Change the trace specification.

    For example, 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.

    For example, 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.

    For example, 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.

    For example, 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")

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

    For example, 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.

    For example, 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")


Related

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