<< Click to Display Table of Contents >> Navigation: Enterprise > Configuration > Enabling Enterprise Logging > Error Logging – Enable Logging to ST_LOG |
The EQuIS Enterprise log4net.config file is configured for the AdoNetAppender enabled with logging level set to "Off." No other appenders are configured. When this ST_CONFIG entry is absent or the STRING_VALUE represents a UTC date and time in the past, no logging will be performed. By setting the STRING_VALUE to a UTC date and time in the future, logging will be enabled and sent to the ST_LOG table. This arrangement removes the need for access to the application server to enable logging.
Namespace – EarthSoft.EDP
Products Affected – Enterprise Web Application and Enterprise Workflow Service
Required Module – log4net
1.Modify the log4net.config file to turn logging on. The log4net.config file can be found in the C:\Program Files\EarthSoft\Enterprise7\bin folder.
Note: There is no option to set the logging level—it is either Off or All. |
In the example below, at approximately line 97, the level value was changed from "off" to "all".
<root>
<level value="all" />
<!--<appender-ref ref="RollingLogFileAppender" />-->
<!--<appender-ref ref="ConsoleAppender"/>-->
<appender-ref ref="AdoNetAppender"/>
</root>
2.Add a line to the ST_CONFIG table in EQuIS Professional. Populate the required fields with the values listed below.
ST_CONFIG |
Value |
Remark |
Valid Values |
---|---|---|---|
CONFIG_SECTION |
log4net |
Required |
|
CONFIG_KEY |
AdoNetAppender |
Required |
|
OBJECT_TYPE |
EnabledUntil |
Required |
|
OBJECT_VALUE |
UTC |
Required |
|
STRING_VALUE |
<date time string> |
Invalid strings will disable logging. |
Any string value that can be parsed by System.DataTime.TryParse |
Example – Enable logging until 8:30 p.m. on April 22, 2016 UTC.
CONFIG_SECTION |
CONFIG_KEY |
OBJECT_TYPE |
OBJECT_VALUE |
STRING_VALUE |
---|---|---|---|---|
log4net |
AdoNetAppender |
EnabledUntil |
UTC |
2016-04-22T20:30-00:00 |
3.IIS will need to be restarted after setting the logging or modifying the log4net.config file.
Once logging has been enabled, any errors will be recorded in the ST_LOG table in EQuIS Professional.
To configure log4net.config to log to the server, see Error Logging - Enable Rolling Log File on the Server.
Copyright © 2023 EarthSoft, Inc • Modified: 03 Nov 2022