+1 408 879 5600 (USA) +44 (0) 113 383 0125 (UK)

• MailSite 10.2.0

How to configure the information included in the MailSite Service v2 Logs and re-enable the original format if so desired.

WARNING!!
Incorrectly editing the registry can damage the server, it is best practice to backup your registry. Please proceed with caution.

If you have a clustered MailSite installation you will need to make the following changes on each server individually.

Configuring V2 Log Types (Listeners)

V2 logging introduces ByUser logs alongside the traditional server logs. ByUser logs contain all the server interactions for a single user account. You can enable one or both of these depending on your needs as follows:

1. Click on the Start button.
2. Select Run, and enter regedit
3. Navigate to (Windows x86) HKEY_LOCAL_MACHINE/SOFTWARE/Rockliffe/MailSite/Logging or (Windows x64) HKEY_LOCAL_MACHINE/SOFTWARE/Wow6432Node/Rockliffe/MailSite/Logging
4. Create a new DWORD (32-Bit)Value
• LogListeners
• Hit Enter, double click on the new entry to set the desired value -
• 1 - Collated or Server text file logs only, stored in the main logs folder.
• 2 - ByUser text file logs only, stored in the '..\Logs\ByUser\...' folder.
• 3 - ByUser and Server text file logs.
• 4 - ByUser and Server SQLite logs, Requires the use of a tool such as SQLiteStudio to review the data.
5. Enter the value you need for your situation and close the property.
6. Exit out of regedit
7. Restart the services

Modifying the Contents of the V2 Logs

The V2 logs include a lot of data not present in the original logging format. This extra information can be valuable to our engineers in diagnosing issues, however if you find the logs hard to read, or wish to reduce their size you can alter what is included by changing the logging format property as follows:

1. Click on the Start button.
2. Select Run, and enter regedit
3. Navigate to (Windows x86) HKEY_LOCAL_MACHINE/SOFTWARE/Rockliffe/MailSite/Logging or (Windows x64) HKEY_LOCAL_MACHINE/SOFTWARE/Wow6432Node/Rockliffe/MailSite/Logging
4. Create a new String Value
• Template
• Hit Enter, double click on the new entry to set the value: They can be -
• {timestamp} UTC {activeUser} ({category}) {message} - This is the default option.
5. Alter the template to suit your requirements
6. Click OK and exit out of regedit
7. Restart the services

Enabling and Disabling New and Old Logging Styles

Should you wish to re-enable the original log files, or disable the V2 logs entirely you can do so as follows:

1. Click on the Start button.
2. Select Run, and enter regedit
3. Navigate to (Windows x86) HKEY_LOCAL_MACHINE/SOFTWARE/Rockliffe/MailSite/Logging or (Windows x64) HKEY_LOCAL_MACHINE/SOFTWARE/Wow6432Node/Rockliffe/MailSite/Logging
4. Create a new DWORD (32-Bit)Value
• To Enable the older logging files (V1) then we need to add this property name
• V1Enabled
• Hit Enter, double click on the new entry to be set its value: It can be - 0 = Disabled (Default) or 1 = Enabled
5. Create a new DWORD (32-Bit)Value
• To Disable the new logs V2 then we need to add this property name
• V2Enabled
• Hit Enter, double click on the new entry to be able to add its value: They can be - 0 = Disabled or 1 = Enabled (Default)
6. Click OK and exit out of regedit
7. Restart the services

Last revised 2015-6-19