How to run Dtrace to help diagnose issues with Enterprise Vault

Article: 100038975
Last Published: 2016-12-12
Ratings: 6 1
Product(s): Enterprise Vault

Description

Dtrace is a tool used by Enterprise Vault to diagnose problems when a service, task, or process fails. Dtrace.exe is a standalone utility that can be copied to any server hosting Enterprise Vault (EV) components. The dtrace tool can be run either from the Vault Administration Console or from the command line.

Administration Console
  1. On the EV server open the Vault Administration Console (VAC)

  2. Expand Site and then Enterprise Vault Servers

  3. Select the relevant EV server

  4. Go to the Tools menu and select Advanced Features

  5. Under the EV Server there should now be the additional Traces container (if there is not then press F5 to refresh)

  6. Right click on Traces and select New > Trace...

  7. Click Next on the first page of the New Trace Wizard

  8. Select the appropriate category that you wish to trace from the dropdown menu and then click Next

  9. Input a title for the trace and a description (optional) then click Next

  10. Select the amount of time you require the trace to run for, making sure you set enough time to be able to recreate/capture the issue. Set the maximum log size (default 100MB), this will set the size of each trace file before rolling over to a new file. Also set the folder in which to write the trace files to, making sure this location has plenty of free space. Then click Next

  11. Click Run Now to begin the Dtrace

 
Command Line
 

Note : This command window may be minimized if required, but do not close

  1. Log onto the EV Server as the Vault Service Account

  2. Open a Command Prompt window

  3. Navigate to the EV program folder (typically C:\Program Files (x86)\Enterprise Vault)

  4. Type dtrace and press Enter

  5. At the Dtrace prompt (DT>) type View and press Enter

  6. Record the Id number beside the service or services that the trace will be run to capture

  7. Use the following command to set Dtrace for logging against a specific service

    set servicename_or_ID level

    For example, if running a Dtrace on the Admin Service where the ID is 1 and the logging level required is verbose (maximum), then the syntax would be:

    set 1 v

    Note : For a list of possible services to dtrace see https://www.veritas.com/docs/000007015.

  8. Repeat step 7 for as many separate processes as required

  9. Use the following command to specify the log file name:

    log tracelog.log

    Note: A path can also be entered for the location of the file. If only a file name is provided, the location of the trace file will be the directory from which Dtrace has been run. For example:

    log d:\tracelog.log

  10. Reproduce the issue or wait until the issue reoccurs

  11. At the DT prompt, type quit and press enter

  12. Type y to confirm and disable all tracing

  13. Collect the log file and send it to Technical Support for review.

Was this content helpful?