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
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 2000Advanced 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