Document ID: 276120
http://support.veritas.com/docs/276120
E-Mail Colleague IconE-Mail this document to a colleague

How to run Dtrace to help diagnose issues with Enterprise Vault (EV) 6.x, 7.x, 2007.x (7.5.x) and 8.x

Details:
Overview:
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 EV components.  In version 7.0 and higher the dtrace tool has been included in the Administration Console and can be run from the console or from the command line.


Resolution:
Command Line - 6.x, 7.x, 2007.x (7.5.x) and 8.x

1.  Log on as the Vault Service Account.

2.  Open a Command Prompt window.

3.  Change to the Enterprise Vault program folder (normally C:\Program Files\Enterprise Vault).

4.  Type dtrace, and then press Enter.

5.  At the Dtrace prompt (DT>) type V or View.

6.  Record the Id number beside the service or services that are failing.

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 and the ID is 1, then the syntax would be:

set 1 v

8. Repeat 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.

10. Minimize the command prompt window, but do not close.

11. Reproduce the issue or wait until the issue reoccurs

12. Maximize the window, at the DT prompt, type quit. Type y to disable all tracing.

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


Administration Console - 7.x, 2007.x (7.5.x) and 8.x
The tracing functionality in the Administration Console provides a number of supplied Dtrace scripts that collect tracing information.

1. In the Administration Console, expand the Enterprise Vault site until the Enterprise Vault Servers container is visible.

2. Expand the Enterprise Vault Servers container.

3. Expand the Enterprise Vault server that the trace should be run against.

4. Click the Enterprise Vault server.

5. On the Tools menu, click Advanced Features to enable it.
Note: This setting is not remembered: it applies only to the current session of the Administration Console.

6. Press F5 to refresh the view, underneath the server the Traces container is now visible.

7. Right-click Traces and click New and then Trace.

8. The New Trace wizard asks for the following:

a. Which trace category to trace. This is the Enterprise Vault subsystem that in which your problem is likely to be contained.

b. A title for the trace. If a support call is logged, include the case number in the trace title. This title is used in the listing of traces in the Administration Console and is also included in the trace log file.

c. An optional description of the trace.

d. The amount of time to run the trace. Trace files can quickly get large, so a few minutes is usually the amount of time to choose.

e. A maximum size for the log file. The trace will stop if the log file reaches this maximum size.

f. Which folder to use to store the log file.

9. Once the trace is started, the properties can be viewed by double-clicking the trace name in the Administration Console. The option to open or copy the log file is unavailable until the trace is complete..


Products Applied:
 Enterprise Vault Compliance Accelerator 2007 7.5, 2007 7.5 SP1, 2007 7.5 SP2, 2007 7.5 SP3, 2007 7.5 SP4, 2007 7.5 SP5, 6.0, 6.0 SP1, 6.0 SP2, 6.0 SP3, 7.0, 7.0 SP1, 7.0 SP2, 7.0 SP3, 7.0 SP4, 7.0 SP5, 8.0
 Enterprise Vault Discovery Accelerator 2007 7.5, 2007 7.5 SP1, 2007 7.5 SP2, 2007 7.5 SP3, 2007 7.5 SP4, 2007 7.5 SP5, 6.0, 6.0 SP1, 6.0 SP2, 6.0 SP3, 7.0, 7.0 SP1, 7.0 SP2, 7.0 SP3, 7.0 SP4, 7.0 SP5, 8.0
 Enterprise Vault for File System Archiving 2007 7.5, 2007 7.5 SP1, 2007 7.5 SP2, 2007 7.5 SP3, 2007 7.5 SP4, 2007 7.5 SP5, 6.0, 6.0 SP1, 6.0 SP2, 6.0 SP3, 6.0 SP4, 6.0 SP5, 6.0 SP6, 7.0, 7.0 SP1, 7.0 SP2, 7.0 SP3, 7.0 SP4, 7.0 SP5, 8.0
 Enterprise Vault for Lotus Domino 2007 7.5, 2007 7.5 SP1, 2007 7.5 SP2, 2007 7.5 SP3, 2007 7.5 SP4, 2007 7.5 SP5, 6.0, 6.0 SP1, 6.0 SP2, 6.0 SP3, 6.0 SP4, 6.0 SP5, 6.0 SP6, 7.0, 7.0 SP1, 7.0 SP2, 7.0 SP3, 7.0 SP4, 7.0 SP5, 8.0
 Enterprise Vault for Microsoft Exchange 2007 7.5, 2007 7.5 SP1, 2007 7.5 SP2, 2007 7.5 SP3, 2007 7.5 SP4, 2007 7.5 SP5, 6.0, 6.0 SP1, 6.0 SP2, 6.0 SP3, 6.0 SP4, 6.0 SP5, 6.0 SP6, 7.0, 7.0 SP1, 7.0 SP2, 7.0 SP3, 7.0 SP4, 7.0 SP5, 8.0

Last Updated: March 16 2009 11:10 PM GMT
Expires on: 03-16-2010
Subscribe Via E-Mail IconSubscribe to receive critical updates about this document

Subjects:
 Enterprise Vault Compliance Accelerator
   Documentation: Configuration
Enterprise Vault Discovery Accelerator
   Documentation: Configuration
Enterprise Vault for File System Archiving
   Documentation: Configuration
Enterprise Vault for Lotus Domino
   Documentation: Configuration
Enterprise Vault for Microsoft Exchange
   Documentation: Configuration

Languages:
 English (US)

Operating Systems:
Windows 2000

Advanced Server SP1, Advanced Server SP2, Advanced Server SP3, Advanced Server SP4, Datacenter Server SP1, Datacenter Server SP2, Datacenter Server SP3, Datacenter Server SP4, Server SP1, Server SP2, Server SP3, Server SP4

Windows Server 2003

DataCenter, DataCenter SP1, DataCenter SP2, Enterprise Server, Enterprise ServerSP1, R2, Standard Server, Standard Server SP1, Standard Server SP2, Storage Server SP1, Storage Server SP2