User Tools

Site Tools


debugfile

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
Next revision Both sides next revision
debugfile [2009/04/17 14:44]
twdorris created
debugfile [2009/06/22 10:03]
dmertz
Line 1: Line 1:
 ====== Creating an ECMLink application debug file ====== ====== Creating an ECMLink application debug file ======
 In some debugging situations, it's necessary to collect more information from a customer'​s runtime environment. ​ You do that by increasing the debug level in our logging system. ​ Doing so dramatically increases log volume, though. ​ So you do not want to leave the configuration in this state permanently. In some debugging situations, it's necessary to collect more information from a customer'​s runtime environment. ​ You do that by increasing the debug level in our logging system. ​ Doing so dramatically increases log volume, though. ​ So you do not want to leave the configuration in this state permanently.
 +
 +===== Usage =====
 +To create a fresh applog.txt file:
 +
 +  - Exit the ECMLink application
 +  - Edit the logging.properties file (more details below)
 +  - Start the ECMLink application
 +  - Recreate the problem you were having
 +  - Exit the ECMLink application
 +  - Grab the applog.txt file and edit/post it up on our forums
 +  - Edit the logging.properties file and undo the changes you made above
 +
  
 ===== logging.properties file ===== ===== logging.properties file =====
-Location ​the logging.properties file in the installation root directory. ​ Under Windows, this will typically be:+Locate ​the logging.properties file in the installation root directory. ​ Under Windows, this will typically be:
  
   C:\Program Files\ECMLink   C:\Program Files\ECMLink
Line 15: Line 27:
   com.ecmtuning.ecmlink.level = FINE   com.ecmtuning.ecmlink.level = FINE
  
-Change that FINE to FINEST and you'll get a LOT more debug data.+Change that FINE to FINEST and you'll get a LOT more debug data.  If you are running Windows Vista, you'll need to be running as administrator to be able to edit the logging.properties file.
  
 ===== applog.txt file ===== ===== applog.txt file =====
-The debug file can be located in the following directory:+When running under Windows XP, the debug file can be located in the following directory:
  
   C:​\Documents and Settings\<​username>​\ecmlink   C:​\Documents and Settings\<​username>​\ecmlink
  
-The filename will be applog.txt. +When running under Windows Vista, ​the debug file can be located in the following directory:
- +
-===== Usage ===== +
-To create a fresh applog.txt file: +
- +
-  - Exit the ECMLink application +
-  - Edit the logging.properties ​file as explained above +
-  - Start the ECMLink application +
-  - Recreate the problem you were having +
-  - Exit the ECMLink application +
-  - Grab the applog.txt file and edit/post it up on our forums+
  
 +  C:​\Users\<​username>​\ecmlink
  
 +The filename will be applog.txt.
  
  
debugfile.txt · Last modified: 2024/03/15 11:16 (external edit)