Configuring Log Encoding Settings

Print Friendly and PDF Follow

Product Aeon
Version All
Ticket N/A
KB Permissions Public


As of Aeon 5.2, logs for the following Aeon components have been configured to use UTF-8 encoding by default to fix an issue where some characters, such as those with diacritics and non-Latin characters, did not display correctly:

  • Aeon Desktop Client
  • Customization Manager
  • Staff Manager
  • System Manager
  • Web Platform

This change will only apply automatically to new Aeon 5.2 installs (i.e., those installing Aeon for the first time at version 5.2). If you are using a previous version of Aeon (e.g., Aeon 5.1) or have updated to Aeon 5.2 from a previous version of Aeon, the encoding change must be made manually to the configuration file for each log following the instructions below.


To configure the log file for each component to use UTF-8 encoding, a new line must be added to each log's configuration file. The configuration file for each log is found where the relevant component for that log is installed (e.g., the configuration file for the Aeon Desktop Client log will be located wherever the Aeon Desktop Client is installed on the machine). The default location and name of each log configuration file are both noted in the table below. Please use the table to locate each configuration file and apply the encoding change manually using the following instructions: 

  1. Use the table below to locate and navigate to the Aeon component log's configuration file
  2. Open the log configuration file in a text editing application such as Notepad++
  3. Add a line for <encoding value="utf-8" />  in the section of code nested under the <appender> element, for example:
    <appender name="RollingFile" type="log4net.Appender.RollingFileAppender">
    <file value="C:\Program Files (x86)\Aeon\Logs\\SystemManager.log" />
    <appendToFile value="true" />
    <maximumFileSize value="1MB" />
    <maxSizeRollBackups value="5" />
    <rollingStyle value="Size" />
    <staticLogFileName value="true" />
    <preserveLogFileNameExtension value="true" />
    <encoding value="utf-8" />

    <layout type="log4net.Layout.PatternLayout">
    <conversionPattern value="%date [%thread] %-5level %logger - %message%newline%exception"/>
  4. Save and close the log configuration file
  5. Repeat steps 1-4 until all log configuration files listed in the table have been modified

Log Configuration Files

Component Log Configuration File Name Default File Location
Aeon Desktop Client Aeon.log.config

Located on the local machine:

  • Per-machine installation:
    C:\Program Files (x86)\Aeon\Client\
  • Per-user installation:

Customization Manager


Located on the local machine:

  • Per-machine installation:
    C:\Program Files (x86)\Aeon\CustomizationManager\
  • Per-user installation:

Staff Manager


Located on the local machine:

  • Per-machine installation:
    C:\Program Files (x86)\Aeon\StaffManager\
  • Per-user installation:

System Manager


Located on the Aeon Server:

  • C:\Program Files (x86)\Aeon\System Manager\

Web Platform


Located on the Aeon Server:

  • C:\Program Files (x86)\Aeon\WebPlatform\App_Data\


If this article didn’t resolve your issue, please contact Atlas Support for assistance:

Contact Support