Skip to main content

Configuring Log Encoding Settings

ProductAeon
VersionAll
TicketN/A
KB PermissionsPublic

Issue​

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.

Resolution​

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 in the section of code nested under the 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"/>
        </layout>
    </appender>

  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​

ComponentLog Configuration File NameDefault File Location
Aeon Desktop ClientAeon.log.configLocated on the local machine:


  • Per-machine installation:
    C:\Program Files (x86)\Aeon\Client</li>

  • Per-user installation:
    C:\Users%USERPROFILE%\AppData\Local\Apps\Aeon\Client</li>
Customization ManagerCustomizationManager.log.configLocated on the local machine:


  • Per-machine installation:
    C:\Program Files (x86)\Aeon\CustomizationManager</li>

  • Per-user installation:
    C:\Users%USERPROFILE%\AppData\Local\Apps\Aeon\CustomizationManager</li>
Staff ManagerStaffManager.log.configLocated on the local machine:


  • Per-machine installation:
    C:\Program Files (x86)\Aeon\StaffManager</li>

  • Per-user installation:
    C:\Users%USERPROFILE%\AppData\Local\Apps\Aeon\StaffManager</li>
System ManagerAeonSystemManager.log.configLocated on the Aeon Server:

  • C:\Program Files (x86)\Aeon\System Manager</li>
Web PlatformAeonWebPlatform.log.configLocated on the Aeon Server:

  • C:\Program Files (x86)\Aeon\WebPlatform\App_Data</li>