NetVault 13.3.2 - Administration Guide

Enabling tracing

Diagnostic tracing is disabled by default. When investigating a problem, Quest Technical Support might ask you to enable tracing on the relevant NetVault machines to capture diagnostic information about the error condition. This information helps in determining the source of error condition. Once the traces are enabled for the server, warning is displayed as Diagnostics in the Header Pane of NetVault.


	IMPORTANT: Tracing can affect performance of the application and generate large amounts of data on the server and client machines. You should only enable tracing when requested by Quest Technical Support, and disable this option after the issue is resolved.

To enable diagnostic tracing:

In the Navigation pane, click Change Settings.

—or—

In the Navigation pane, click Manage Clients.

To enable diagnostic tracing:

•

fFor the NetVault Server from Change Settings: On the NetVault Server Settings page, under System and Security, click Diagnostic Tracing. On the Diagnostic Trace Settings page, click Enable Tracing.

•

For the NetVault Client from Change Settings: On the NetVault Server Settings page, click Clients. In the NetVault Clients table, select the client, and click Next. Under System and Security, click Diagnostic Tracing. On the Diagnostic Trace Settings page, click Enable Tracing.

•

For the NetVault Client from Manage Clients:

•

On the Manage Clients page, select the Trace Status check box or click Enable Tracing

—or—

•

On the Manage Clients page, select the client, and click Enable Tracing.

In the Trace Enable Options drawer, configure the following settings.

Figure 28. Trace Enable Options drawer


	IMPORTANT: When you select multiple clients, the Trace Enable Options drawer does not show the list of process names. You can either use the All current and future processes option, or provide the process ID list in the associated box.

Table 151. Trace Enable Options

Setting

Description

Enable Tracing

Select one of the following options:

•

Immediately: This option is selected by default. To start tracing immediately, use this option.

•

At service startup: To enable tracing at service startup, select this option.

NOTE: You can also enable tracing at service startup by clicking Trace Configuration on the Diagnostic Trace Settings page, and selecting the Enable trace on service startup check box in the Trace Configuration Options dialog box.

When you select this option, tracing is enabled on all processes.

•

At a certain time: To automatically start and stop tracing at specified times, select this option, and specify the time window:

- Starting at: Select this check box, and type or select the date and time when tracing should be started on the machine.

- Stopping at: Select this check box, and type or select the date and time when tracing should be stopped on the machine.

Create Trace for

Specify the processes for which trace files are required:

•

All current and future processes: This option is selected by default. To generate trace files for all current and new processes, use this option.

•

Specific processes: To generate trace files for specific processes, select this option.

In the list of process names, select the processes, and click the Add button (

). To select consecutive items, hold down the Shift key while clicking with the mouse button; to select non-consecutive items, hold down the Ctrl key while clicking with the mouse button.

To remove a process that was previously included, select the process name in the list, and click the Remove button (

Alternatively, edit the Process ID list in the associated box to add or remove any process ID numbers.


	IMPORTANT: Trace settings do not persist across restarts of NetVault Service unless you have selected the At service startup or Enable trace on service startup options. In such cases, tracing is enabled on all processes.

To view the page size setting, sorting order in the table, export the records, or edit table settings, click the icons at the lower- right corner of the table. For more information, see Customizing tables in NetVault WebUI.

Click Apply to apply the settings and close the drawer.

Downloading trace files

Trace files are generated on the machines where the selected processes are running. You can use the WebUI to download trace files from various machines to the local machine where the WebUI is running.

To download trace files:

In the Navigation pane, click Change Settings.

To download trace files:

•

From the NetVault Server: On the NetVault Server Settings page, under System and Security, click Diagnostic Tracing.

•

From the NetVault Client: On the NetVault Server Settings page, click Clients. In the NetVault Clients table, select the client, and click Next. Under System and Security, click Diagnostic Tracing.

In the list of trace sessions, select the session that you want to download.

Click Download, and in the confirmation dialog box, click OK.

In the File Download dialog box, select the Save option, and specify the location, if necessary. Make sure that you do not navigate away from the page until the browser starts downloading the files.


	NOTE: When you send trace files to Quest Technical Support, make sure that you include files from all relevant NetVault machines.

Changing the trace directory location

By default, the trace container directory is created under the NetVault installation directory. You can modify the default settings to specify a new location for the container directory. When tracing is enabled, a session directory is created under the container directory; all trace files generated during the session reside in this directory.


	NOTE: The trace container directory cannot be changed when tracing is enabled.

To change the trace container directory:

In the Navigation pane, click Change Settings.

To change the trace directory:

•

For the NetVault Server: On the NetVault Server Settings page, under System and Security, click Diagnostic Tracing.

•

For the NetVault Client: On the NetVault Server Settings page, click Clients. In the NetVault Clients table, select the client, and click Next. Under System and Security, click Diagnostic Tracing.

On the Diagnostic Trace Settings page, click Trace Configuration. In the Trace Configuration Options dialog box, configure the following setting:

•

Trace Container Directory: Specify the new location for the trace container directory. You must provide the full filepath.

Click Apply to apply the new settings and close the dialog box.

Enabling tracing using Txtconfig

You can use the Txtconfig utilities to enable tracing at service startup. At service startup, tracing is enabled on all processes. The Txtconfig utilities do not provide the options to start tracing immediately, start and stop tracing at the specified time, or enable tracing for specific processes.

To enable diagnostic tracing using Txtconfig:

In a terminal or command prompt window, type txtconfig, and press Enter or Return.

On the Machine page, press p to view the main menu, and then press the option number for the Diagnostic Tracing page.

Press the option number for the Enable trace on service startup setting to change the value to ON.

To save the settings and quit Txtconfig, press s, and then press q.


	NOTE: Tracing is not enabled until the next service startup. For more information about restarting the NetVault Service, see Starting or stopping the NetVault Service.

製品を選択してください:

サービス向上のために、「Purpose of your Chat（チャットの目的）」を記入してください。

お客様の不具合に推奨されるソリューション

NetVault 13.3.2 - Administration Guide

Enabling tracing

Downloading trace files

Changing the trace directory location

Enabling tracing using Txtconfig