The following article details where you can find and configure IGEL Universal Management Suite (UMS) log files.   

For enabling the logging of UMS user actions and actions initiated by a device, see Logging.

If you require UMS log files for IGEL Support, see Save Support Information / Send Log Files to Support.


UMS 6.10.110 or Higher

In UMS version 6.10.110, the outdated logging framework Log4j 1.x was replaced with Logback; see also ISN 2022-19: Log4j 1.x Remainder in UMS.

To change the logging settings for UMS 6.10.110 or higher, use logback.xml.

UMS Server

rmguiserver/logs
(rmguiserver/conf/logback.xml - for configuring the logs)

catalina.log

Central log file for all logging events

ums-server-msg.logLogging of the Apache ActiveMQ messaging

ums-server-communication.log

Logging of communication with UMS Console or devices
Edit at  <!-- Logging of UMS communication -->

localhost.logTechnical logging of the Apache Tomcat server
stderr.logError output of the Apache Tomcat server 
stdout.logStandard output of the Apache Tomcat server

ums-server-threaddump.log

Periodic logging of the threads

ums-server-icg-communication.log

Logging of communication with ICG
Edit at  <!-- Logging of UMS communication --> 

ums-server-health.log

Logging of the UMS HA Health Check

ums-server-monitoring.log

Performance logging
Edit at  <!-- Logging of monitoring data -->; change INFO to DEBUG to get detailed information on each method call (the server restart is then required)

This is an example of rmguiserver/conf/logback.xml where you can configure the logs for the UMS Server, i.e. switch the logging on/off, change the scan period or the number of days for the logging history, etc.:

<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false" scan="true" scanPeriod="60 seconds">

<!-- General settings -->


<!-- Logging of monitoring data -->
<!-- Elevate to 'DEBUG' to see the individual calls -->
<property name="monitoring.level" value="INFO" />

<!-- Logging of UMS communication -->
<!-- Set to 'ALL' to enable and 'OFF' to disable -->
<property name="server2console.level" value="OFF" />
<property name="server2tc.level" value="OFF" />
<property name="server2usg.level" value="OFF" />
<property name="usg2server.level" value="OFF" />


<!-- The base folder for log files -->
<property name="base.dir" value="${catalina.home}/logs" />

<!-- The default logging pattern -->
<property name="pattern.format" value="%-5(%d{[yyyy-MM-dd HH:mm:ss.SSS]}) %-5level [%thread] %logger{10}.%M - %msg%n" />

<!-- The length of logging history in days -->
<property name="logs.history" value="30" />


<!-- The appenders -->


rmguiserver/logs
(rmguiserver/conf/logback.xml - for configuring the logs)

ums-api.log

Logging of the API service

UMS Load Balancer

umsbroker/etc/work/logs
(umsbroker/etc/conf/logback.xml - for configuring the logs)
ums-broker.logCentral log file for all logging events
ums-broker-msg.logLogging of the messages exchanged
ums-broker-health.logLogging of the UMS HA Health Check
ums-broker-monitoring.logPerformance logging
Edit at  <!-- Logging of monitoring data -->; change INFO to DEBUG to get detailed information on each method call (the server restart is then required)

UMS Watchdog

umswatchdog/etc/work/logs
(umswatchdog/etc/conf/logback.xml - for configuring the logs)
ums-watchdog.logCentral log file for all logging events
ums-watchdog-msg.logLogging of the messages exchanged
ums-watchdog-health.logLogging of the UMS HA Health Check

UMS Console

$HOME/.igel
RMClient.exe.logStartup logging
$HOME/.igel/logs
(rmclient/logback.xml - for configuring the logs)
ums-console.logCentral log file for all logging events

UMS Administrator

$HOME/.igel
RMAdmin.exe.logStartup logging
rmguiserver/logs
(rmadmin/logback.xml - for configuring the logs)
ums-admin.logCentral log file for all logging events

Before UMS 6.10.110

UMS Server

rmguiserver/logs
(rmguiserver/conf/log4j.properties - for configuring the logs)

catalina.log

Central log file for all logging events

ums-server-msg.logLogging of the Apache ActiveMQ messaging
communication.logLogging of communication with UMS Console or devices
Edit at # communication logging - define the log levels; refer to Log4j documentation
license_deployment.logLogging of licenses
Edit at # license deployment logging; refer to Log4j documentation
localhost.logTechnical logging of the Apache Tomcat server
stderr.logError output of the Apache Tomcat server 
stdout.logStandard output of the Apache Tomcat server
umsthreaddump.logPeriodic logging of the threads
Edit with # threaddump logging; refer to Log4j documentation
usgcommunication.log

Logging of communication with ICG
Edit at # communication logging - define the log levels; refer to Log4j documentation

health.logLogging of the UMS HA Health Check
monitoring.log

Performance logging
Edit at # execution monitoring; change INFO to DEBUG to get detailed information on each method call (the server restart is then required)

rmguiserver/logs
(rmguiserver/conf/log4japi.properties - for configuring the logs)
api.logLogging of the API service

UMS Load Balancer

umsbroker/etc/work/logs
(umsbroker/etc/conf/log4j.properties - for configuring the logs)
igel-ums-broker.logCentral log file for all logging events
broker-msg.logLogging of the messages exchanged
broker-health.logLogging of the UMS HA Health Check
broker-monitoring.logPerformance logging
Edit at # monitoring logging; change INFO to DEBUG to get detailed information on each method call (the server restart is then required)

UMS Watchdog

umswatchdog/etc/work/logs
(umswatchdog/etc/conf/log4j.properties - for configuring the logs)
igel-ums-watchdog.logCentral log file for all logging events
watchdog-msg.logLogging of the messages exchanged
watchdog-health.logLogging of the UMS HA Health Check

UMS Console

$HOME/.igel
RMClient.exe.logStartup logging
$HOME/.igel/logs
(rmclient/log4j.properties - for configuring the logs)
igel-ums-console.logCentral log file for all logging events

UMS Administrator

$HOME/.igel
RMAdmin.exe.logStartup logging
rmguiserver/logs
(rmadmin/log4j.properties - for configuring the logs)
igel-ums-admin.logCentral log file for all logging events