POPFile DBI Trace Capture utility

Trace:

Differences

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

Link to this comparison view

Next revision		Previous revision
howtos:dbitracecapture [2010/03/23 17:20] – created xueshenghowtos:dbitracecapture [2011/09/23 23:55] (current) – external edit 127.0.0.1
Line 9: Line 9:
  
 The tracing mechanism built in to DBI provides many levels of detail but most of these contain so much obscure detail that they are only of interest to database specialists. Therefore this utility defaults to using trace level 1 for a simple overview of what is happening. The tracing mechanism built in to DBI provides many levels of detail but most of these contain so much obscure detail that they are only of interest to database specialists. Therefore this utility defaults to using trace level 1 for a simple overview of what is happening.
 +
 +{{:howtos:dbicapture.png|}}
  
   * Trace Level 0 disables DBI Tracing so only the normal console messages will be shown.   * Trace Level 0 disables DBI Tracing so only the normal console messages will be shown.
Line 16: Line 18:
   * Trace Level 4 is equivalent to level 3 plus more detailed information from the driver.   * Trace Level 4 is equivalent to level 3 plus more detailed information from the driver.
  
-This utility is based upon POPFile's Message Capture Utility therefore the trace output appears in a scrollable window and can easily be copied to the clipboard (using the right-click menu) and saved in a file for later analysis.+This utility is based upon POPFile's [[messagecapture| Message Capture Utility]] therefore the trace output appears in a scrollable window and can easily be copied to the clipboard (using the right-click menu) and saved in a file for later analysis.
  
 ===== Command-line Options ===== ===== Command-line Options =====
  
-If the utility is started using the command ''dbicapture.exe'' then it will display a page offering 5 choices, with trace level 1 pre-selected. Levels 2 to 4 offer increasing amounts of detail. Level 0 disables tracing so its output contains only the normal console messages generated by POPFile (and any warnings or error messages, of course).+If the utility is started using the command ''**dbicapture.exe**'' then it will display a page offering 5 choices, with trace level 1 pre-selected. Levels 2 to 4 offer increasing amounts of detail. Level 0 disables tracing so its output contains only the normal console messages generated by POPFile (and any warnings or error messages, of course).
  
 As the trace level increases, so does the amount of data produced. Here are some sample report sizes from tests which simply started up POPFile, waited until it had started running and then shut it down: As the trace level increases, so does the amount of data produced. Here are some sample report sizes from tests which simply started up POPFile, waited until it had started running and then shut it down:
Line 31: Line 33:
 |  5   |  57,910 bytes| |  5   |  57,910 bytes|
 |  15  |  97,586 bytes| |  15  |  97,586 bytes|
- 
 If the utility is to be called from a batch file or shortcut then the required trace level can be specified on the command-line If the utility is to be called from a batch file or shortcut then the required trace level can be specified on the command-line
  
    dbicapture.exe /TRACE_LEVEL=1    dbicapture.exe /TRACE_LEVEL=1
  
-and in this case the page which allows the trace level to be selected will not appear. The command-line option is not case-sensitive so ''/trace_level=1'' can be used instead.+and in this case the page which allows the trace level to be selected will not appear. The command-line option is not case-sensitive.
  
 The command-line can also be used to specify trace levels higher than level 4. Be warned that these higher levels generate a lot of data. The command-line can also be used to specify trace levels higher than level 4. Be warned that these higher levels generate a lot of data.
Line 42: Line 43:
 ===== Replacement for Message Capture Utility ===== ===== Replacement for Message Capture Utility =====
  
-DBI Capture Utility v0.0.2 or later can be used as a replacement for the ''msgcapture.exe'' utility shipped with the Windows version of POPFile. One way to do this is to put ''dbicapture.exe'' into the POPFile program folder and rename it as ''msgcapture.exe''. The utility can be then run using this existing shortcut:+DBI Capture Utility v0.0.2 or later can be used as a replacement for the ''**msgcapture.exe**'' utility shipped with the Windows version of POPFile. One way to do this is to put ''**dbicapture.exe**'' into the POPFile program folder and rename it as ''**msgcapture.exe**''. The utility can be then run using this existing shortcut: 
 + 
 +Start -> All Programs -> POPFile -> Support -> Message Capture utility 
 + 
 +To stop the utility from displaying the trace level page, specify the required level of tracing by inserting an appropriate ''**TRACE_LEVEL**'' (or ''**trace_level**'') option in the shortcut. 
 + 
 +===== Separate Download ===== 
 + 
 +The DBI Trace Capture utility is __**not**__ included in the Windows version of POPFile. It is available as a separate download [[/downloads/dbicapture.zip| (48 KB zip file)]]. 
 + 
 +===== Finding the POPFile program and POPFile data folders ===== 
 + 
 +If you are not sure where the POPFile program files and/or the 'User Data' files are stored, use the following Start Menu shortcut to find out:
  
-Start -- Programs -- POPFile -- Support -- Message Capture utility+Start -> All Programs -> POPFile -> Support -> PFI Diagnostic utility (simple)
  
-To stop the utility from displaying the trace level page, specify the required level of tracing in the shortcut by inserting an appropriate /TRACE_LEVEL option.+See [[pfidiagnostic| PFI Diagnostic Utility]] for further details.
  
 
howtos/dbitracecapture.1269364828.txt.gz · Last modified: 2010/03/23 18:20 (external edit)
Old revisions

Should you find anything in the documentation that is incomplete, unclear, outdated or just plain wrong, please let us know and leave a note in the Documentation Forum.

Recent changes RSS feed Donate Driven by DokuWiki
The content of this wiki is protected by the GNU Fee Documentation License