Error Logging – Enable Logging to ST_LOG

<< 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

 

Instructions

 

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.