Note: This article applies to adTempus 4 and later. For adTempus 3.x and 2.x. , see article K00000012.
adTempus produces diagnostic logs that can be used by Arcana Development support staff to diagnose problems.
Separate log files are created for the adTempus service and the adTempus Console.
Log files for the adTempus service are found in
[program files directory]\Arcana Development\adTempus\[Version]\logs\[InstanceName]
C:\Program Files\Arcana Development\adTempus\4.0\logs\Default
The current log file is named "adtempus.service.log". Previous log files are named "adtempus.service.log.1" through "adtempus.service.log.9". Each time the adTempus service is restarted, or if the log file reaches 10MB in size, a new log file is started.
Log files for the adTempus Console are found in the user's TEMP directory ("%TEMP%").
The current log file is named "adtempus.console.log". Previous log files are named "adtempus.console.log.1" through "adtempus.console.log.9". Each time the adTempus Console is restarted, or if the log file reaches 10MB in size, a new log file is started.
The Job Host process hosts execution for scripts and some other operations. Log files for the host process are found in the TEMP directory of the user whose account the job is running under. The log file is named "adtempus.jobhost.nnnn.log", where nnnn is the Windows Process ID (PID) of the instance of the host process. Old log files are periodically deleted automatically.
During normal operation, adTempus writes to the log files only when potential problems are detected during adTempus operations. Generally such issues are also reported to the user, through error messages or alerts in the Console. The diagnostic log files contain additional details that can be used to trace the cause of the problem.
When attempting to diagnose a problem it is sometimes necessary to have adTempus log more extensive information to the logs. Follow the instructions below to do this when instructed to do so by support personnel.
Please ZIP any log files sent to Arcana Development.
Important: When you ZIP the log files, be sure that the current log file ("adtempus.service.debug.log") is included. Some ZIP utilities will not include this file because it is in use. If this happens, make a copy of the file and add the copy to the ZIP.
A logging configuration tool has been created to make it easier to configure diagnostic logging (previously, configuring the logging required editing configuration files). This tool is installed with adTempus beginning with version 4.2, but for earlier versions you will need to download it:
In adTempus 4.2 and later, logging can be configured using the "adtloggingconfig" program found in the adTempus program folder ("C:\Program Files\Arcana Development\adTempus\4.0"). You must be a member of the Administrators group on the computer to make the configuration change.
Note: In some cases the adtloggingconfig.exe is incorrectly installed to "C:\Program Files\Arcana Development\adTempus". In this case, move it to "C:\Program Files\Arcana Development\adTempus\4.0" before running it.
In the adtloggingconfig tool, check the Enable debug logging option for the adTempus service, Console, and/or Job Host, as appropriate.
Click OK to save the changes and close the tool. adTempus will now begin writing a second set of log files.
To turn off logging when it is no longer required, uncheck the Enable debug logging option, then click OK to save changes and close the tool.
Changes take effect immediately and do not require a restart of the adTempus service or Console.