The TMS website offers some extended logging to help debug stubborn errors. This article details how to enable the logging and where to find the resulting log files.
Enabling logging
The TMS website extended logging can be enabled by editing the web.config file and uncommenting a few lines.
- Locate the TMS website root folder. By default, this is C:\inetpub\wwwroot\TMS
- Open the web.config file in Notepad. Depending on your level of access, you may need to open Notepad as administrator. Note that there is a folder called WebConfig with a web.config file inside it, this is not the correct file.
- Navigate to the end of the file
- There are 2 sections that are of interest - full logging and specific feature logging.
- Once you have made the required changes, the TMS website will automatically reset and begin logging. Other than the website taking roughly 10 - 20 seconds to load the next page, this will be transparent to end users.
Enabling full logging
- Remove the highlighted lines
Enabling specific feature logging
- Choose which feature you would like to enable logging for
- Uncomment the relevant section by adding a "-->" immediately before it and a "<!--" immediately after it
- For example, to enable Scheduled Message debugging, uncomment the tMessagingService and tMessageSchedule loggers
The log files
The TMS website will write logs to the tms.log file located in the web root folder (usually C:\inetpub\wwwroot\TMS\). Once this file becomes full, it will be renamed tms.log.1 and a new tms.log file created. Once you have 10 log files, the oldest file will be discarded to make room for further logs.
Increasing log file size and count
The TMS website will often log a large amount of information. Once the website has logged enough information to fill the maximum size and number of log files, it will simply delete the oldest log file and begin logging to a new file.
In order to log large amounts of data, you can increase both the size of each individual log file and the log file count. These settings are found in the web.config immediately prior to the settings for tuning the logging on. Please see the Enabling Logging section above for details.
Depending on how many users your TMS website has, the log files could fill up very quickly. Several background processes (notably Scheduled Messages) will also quickly fill the log files.
The IIS Windows user must have Write access to the TMS website root folder. If it does not have write access, no log files will be produced.