How to run Dtrace using a custom script file from command line.

book

Article ID: 100007216

calendar_today

Updated On:

Resolution

Run Dtrace from command line, utilizing a custom command file provided, while also increasing the dtrace buffer range to limit buffer overflows.

Command file format:
Below is a general formatted text data to illustrate the format structure of a command file.  The intent of this example is to perform the following:

a. Set the JournalTask to Verbose mode (set journaltask v)
b. Clear the current automatic include filters (Filter clear includes)
c. Create a new Include Filter (+ "time taken").
d. Exit the "DT Filters>" function (exit)
e. Enable logging (log "c:\program files (x86)\Enterprise Vault\Reports\TRACE_LOG.LOG")
f. Set a time period to run Dtrace before exiting using the pause command (pause 15m {h=hours, m = minutes})

Command File Example:
----------------------starts below----------------------
set JournalTask v
filter
clear includes
+ "time taken"
exit
log "c:\program files (x86)\Enterprise Vault\Reports\TRACE_LOG.LOG"
pause 15m
----------------------ends above----------------------

Process:
1. Create text file and add required settings. (See above for example)
As referenced, the command file must have at least 1 set command, a log command and a pause interval.  Filter changes are optional.
2. Save file as txt file, in ANSI format.
3. Open command line and change directory to location of dtrace.exe.
4. Run dtrace using the following method.

Dtrace.exe [buffer size] -v < "Path_and_filename_of_Command_File"

Example:
Dtrace.exe 100000 -v < "C:\Program Files (x86)\Enterprise Vault\Command files\Journal_timetaken.txt"
 

 

 

Issue/Introduction

In Enterprise Vault 7.0 and above, additional functionality was included to perform Dtrace from within the Vault Administration Console (VAC). With this feature included pre-generated categories and scripts to assist in troubleshooting common issues that may arise.