This page is no longer maintained and may contain obsolete information.
The CAST Engineering Dashboard provides a variety of log information to help you debug errors you may encounter. Three output options are available, two of which are active by default:
Output to file
By default, CAST outputs information to a .log file located here:
%USERPROFILE%\castweb\logs\CAST_MM-DD-YYYY.log
This is governed by the following entry in the %CATALINA_HOME%\webapps\CAST-CED\WEB-INF\web.xml file (set the <param-value> tag to "false" to deactivate this log):
<context-param> <param-name>logger.output.file</param-name> <param-value>true</param-value> <description>Outputs logs to file</description> </context-param>
If you want to modify the storage location for these log files, you need to uncomment the following entry in the web.xml file and define the new location in the <param-value> tag:
<!-- context-param> <param-name>cast.web.home</param-name> <param-value>[C:\castweb]</param-value> <description>the path to home repository of cast web</description> </context-param-->
For example:
<context-param> <param-name>cast.web.home</param-name> <param-value>D:\CAST\temp</param-value> <description>the path to home repository of cast web</description> </context-param>
Following any changes you make, save the web.xml file and then restart your application server so that the changes are taken into account.
Note that modifying this option will also change the storage location for auto generated PDF reports from the Report Builder feature - see CAST-CED - Configure the hard disk location for auto generated PDF reports.
Output to JVM console
By default, CAST outputs information to the JVM console that is displayed by your application server:
This is governed by the following entry in the %CATALINA_HOME%\webapps\CAST-CED\WEB-INF\web.xml file (set the <param-value> tag to "false" to deactivate this log):
<context-param> <param-name>logger.output.console</param-name> <param-value>true</param-value> <description>Outputs logs to JVM console</description> </context-param>
For more information about the JVM console logging, please see your application server documentation.
Following any changes you make, save the web.xml file and then restart your application server so that the changes are taken into account.
Output to CAST Engineering Dashboard pages
It is possible to publish logs direct to the CAST Engineering Dashboard pages. This is governed by the following entry in the %CATALINA_HOME%\webapps\CAST-CED\WEB-INF\web.xml file (set the <param-value> tag to "true" to activate this log):
<context-param> <param-name>logger.output.buffer</param-name> <param-value>false</param-value> <description>Outputs logs to internal buffer</description> </context-param>
- Note that this logging is deactivated by default as it is considered a security vulnerability. CAST recommends only activating this log for debugging purposes - it should not be used on a day-to-day basis.
- Following any changes you make, save the web.xml file and then restart your application server so that the changes are taken into account.
Output content
By default, CAST outputs Warnings, Errors and Fatal errors (level 2). This is governed by the following section in the %CATALINA_HOME%\webapps\CAST-CED\WEB-INF\web.xml file:
<!-- Sets logger level (0: DETAIL, 1: INFO, 2:WARNING, 3: ERROR, 4: FATAL) --> <context-param> <param-name>logger.level</param-name> <param-value>2</param-value> <description>Global log level</description> </context-param> <context-param> <param-name>logger.level.JAAS</param-name> <param-value>2</param-value> <description>JAAS log level</description> </context-param> <context-param> <param-name>logger.level.SERVER</param-name> <param-value>2</param-value> <description>SERVER log level</description> </context-param> <context-param> <param-name>logger.level.PROP</param-name> <param-value>2</param-value> <description>PROP log level</description> </context-param> <context-param> <param-name>logger.level.DATA</param-name> <param-value>2</param-value> <description>DATA log level</description> </context-param> <context-param> <param-name>logger.level.EVAL</param-name> <param-value>2</param-value> <description>EVAL log level</description> </context-param> <context-param> <param-name>logger.level.HTML</param-name> <param-value>2</param-value> <description>HTML log level</description> </context-param> <context-param> <param-name>logger.level.XML</param-name> <param-value>2</param-value> <description>XML log level</description> </context-param> <context-param> <param-name>logger.level.MSG</param-name> <param-value>2</param-value> <description>MSG log level</description> </context-param> <context-param> <param-name>logger.level.CTX</param-name> <param-value>2</param-value> <description>CTX log level</description> </context-param> <context-param> <param-name>logger.level.URL</param-name> <param-value>2</param-value> <description>URL log level</description> </context-param> <context-param> <param-name>logger.level.SQL</param-name> <param-value>2</param-value> <description>SQL log level</description> </context-param> <context-param> <param-name>logger.level.MEM</param-name> <param-value>2</param-value> <description>MEM log level</description> </context-param> <context-param> <param-name>logger.level.ROWREADER</param-name> <param-value>2</param-value> <description>ROWREADER log level</description> </context-param>
By default, all output options are set to level 2. You can set any of the above options to one of the following:
Level | Description |
---|---|
0 | All output is logged - verbose level |
1 | Information, warnings, errors and fatal errors are logged |
2 | Warnings, errors and fatal errors are logged (default) |
3 | Errors and fatal errors are logged |
4 | Only fatal errors are logged |