Using tracing

The tracing functionality in the Administration Console enables you to select from a number of supplied Dtrace scripts that collect tracing information.

If you log a support call, Symantec Corporation may ask you to run a trace to aid problem diagnosis.

To enable traces

  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 on which you want to run a trace.

  4. Click the Enterprise Vault server.

  5. On the Tools menu, click Advanced Features to select it.

    Note that 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 you now see a Traces container.

    You are now ready to create a new trace. The New Trace wizard asks for the following:

    • Which trace category to trace. This is the Enterprise Vault subsystem that in which your problem is likely to be contained. You might pick, for example, "Search and Indexing issues" or "Restoring and Retrieval issues".

    • A title for the trace. If you have logged a support call, you make want to include the call 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.

    • An optional description of the trace. This is for your own notes.

    • 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.

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

    • Which folder to use to store the log file.

To create a new trace

  1. In the Administration Console, enable traces as described in this section.

  2. Right-click the Traces container under the server on which you want to run a trace and, on the shortcut menu, click New and then Trace. The New Trace wizard starts.

  3. Work through the wizard.

    Once you have started the trace, you can view its properties by double-clicking the trace name in the Administration Console. You have options to open or copy the log file, but these are unavailable until the trace is complete.