How to run Dtrace to help diagnose issues with Enterprise Vault

Article:TECH38122  |  Created: 2005-01-01  |  Updated: 2014-11-24  |  Article URL http://www.symantec.com/docs/TECH38122
Article Type
Technical Solution


Issue



Dtrace is a tool used by Symantec 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 is built into the EV Administration Console and can be run from either the console or the command line.

 


Solution



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

  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 then please see TECH129595

  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. Note : This command window may be minimized if required, but do not close

  11. Reproduce the issue or wait until the issue reoccurs

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

  13. Type y to confirm and disable all tracing

  14. Collect the log file and send it to Symantec support




Legacy ID



276120


Article URL http://www.symantec.com/docs/TECH38122


Terms of use for this information are found in Legal Notices