Enable debug or Trace on Autosys Web Server AEWS

Products

• Autosys Workload Automation

Issue/Introduction

This document covers the steps needed to enable debug or trace on Autosys Web Server for troubleshooting any Web Server related issues.

Resolution

On the Autosys Web Server host:

 

1) Backup $AUTOUSER/log4j.xml

2) Edit original $AUTOUSER/log4j.xml

3) Change appropriate loggers below (based on requirement of what component is being debugged), to debug

Below example shows debug on  Command (wrapper), web services, security 

<!-- Web service query Logging -->
   <logger name="com.ca.waae.wsquery" >
         <level value="warn" />
   </logger>

   <!-- Instance startup Logging -->
   <logger name="com.ca.waae.aehome" >
         <level value="warn" />
   </logger>

   <!-- Post event audit Logging -->
   <logger name="com.ca.waae.audit" >
         <level value="warn" />
   </logger>

   <!-- Configuration Logging -->
   <logger name="com.ca.waae.config" >
      <level value="warn" />
   </logger>

   <!-- Common routine Logging -->
   <logger name="com.ca.waae.common" >
      <level value="warn" />
   </logger>

   <!-- Security Logging -->
   <logger name="com.ca.waae.security" >
         <level value="debug" />
   </logger>

   <!-- Database access Logging -->
   <logger name="com.ca.waae.dbaccess" >
         <level value="warn" />
   </logger>

   <!-- Metadata Logging -->
   <logger name="com.ca.waae.metadata" >
         <level value="warn" />
   </logger>

   <!-- command utils Logging -->
   <logger name="com.ca.waae.cmd" >
         <level value="DEBUG" />
   </logger>

   <!-- High level web service Logging -->
   <logger name="com.ca.waae.ws" >
         <level value="DEBUG" />
   </logger>

4) Change the root level to DEBUG to

<root>
      <level value="DEBUG" />

5) Save the file,  changes are dynamic and are read per the log4j refresh interval. 

6) The two files that contain debug information are:

waae_webservices_wrapper.log

waae_webservices.log

 

Make sure to revert these changes once troubleshooting is completed.

 

Additional Information

For AutosysCommandWrapper to spit out some additional information to WCC's ECLI tab, when a command is run,  

$AUTOUSER/webserver/conf/wrapper.conf

Identify the line that looks like:

wrapper.java.additional.10=-Dautosys.command.exe=AutoSysCommandWrapper

 

Add a -t  at the end so it looks like:

wrapper.java.additional.10=-Dautosys.command.exe=AutoSysCommandWrapper -t

 

## For Windows 

wrapper.java.additional.10=-Dautosys.command.exe="AutoSysCommandWrapper -t"

 

Save the file and restart AEWS

 

 

 

 

 

For AEWS JIL or JIL verify operations, below is needed with a value of trace and not with a value of debug

 

   <!-- command utils Logging -->
   <logger name="com.ca.waae.cmd" >
         <level value="trace" />
   </logger>

   <!-- High level web service Logging -->
   <logger name="com.ca.waae.ws" >
         <level value="trace" />
   </logger>

   <root>
      <level value="debug" />