Introducation

By default detailed error messages are not displayed to the user. Instead, there is a generic error message. If you need to investigate such an error, it’s best to enable the logging of such errors. You can do so by following the steps described in this article.

Step 1 - Change the log configuration file

The log configuration file is located in the installation directory, usually this results in the following path:

C:\Program Files\ITSENSE AG\Web Service\LogConfig.xml

That file by default, is pretty much empty. To configure a log file simply paste the configuration below into that file.

<?xml version="1.0" encoding="utf-8" ?>
<log4net>
  <appender name="LoggerWrapperAppender" type="iTsense.LoggerWrapper.Appender, iTsense.LoggerWrapper">
    <ListenerPort>22000</ListenerPort>
  </appender>
  <appender name="FileAppender" type="log4net.Appender.RollingFileAppender">
    <file value="${AllUsersProfile}\ITSENSE\LOG\COSWeb-log.txt" />
    <appendToFile value="true" />
    <rollingStyle value="Size" />
    <maxSizeRollBackups value="1" />
    <maximumFileSize value="10MB" />
    <staticLogFileName value="true" />
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%date [%thread] %-5level %logger [%property{NDC}] - %message%newline" />
    </layout>
  </appender>
  <root>
    <appender-ref ref="FileAppender" />
  </root>
</log4net>

Step 2 - Recycle the app pool

All you need to do now is to recycle the APP Pool of the Admin UI in the IIS Management Console. After that, a file should be present in the following path:

C:\ProgramData\itsense\LOG\COSWeb-log.txt

If everything worked, you should see content similar to the example below:

CoreOne Suite Dokumentation

How-to enable a log file for the Admin UI

Introducation

Step 1 - Change the log configuration file

Step 2 - Recycle the app pool