Configuring Log Encoding Settings

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