Tracing

The Tracing feature is a useful tool for troubleshooting problems with Host Integrator security, servers, domains, and AADS. If you are working with technical support to resolve a problem, you may be asked to create a trace and send it to them.

Note: Only development staff and technical support have the tools required to read traces generated by Host Integrator. Unless you are creating a trace to send to technical support, you should not enable tracing.

Configuring Tracing

To configure tracing:

  1. Log on to the Administrative WebStation using an Administrator profile and switch to configure mode.

  2. In the Navigation tree under the name of the server you want to trace, click Tracing. The Tracing panel opens. The Tracing Active check box indicates whether tracing is currently active; you cannot select it or clear it. The steps to start and stop tracing are described below.

  3. In the Trace Filename box, type the name of the trace file. For example, a path name such as C:\Program Files\VHI\Trace.trc (Windows) or /usr/local/vhi/trace.trc (UNIX) means that the trace file is on the same machine as the Host Integrator Server. If you want the trace to be generated on a machine other than the machine running the server, you must enter the fully qualified network path name.

  4. Select the Trace New Sessions check box if you want new sessions to have tracing activated when they are allocated.
    Note: In some cases, selecting this option may slow server activity to the point where the problem is masked.

  5. In the Maximum trace file size box, enter the maximum amount of disk space that the server will use to create trace files. Enter a value between 0 and 1024 MB.
    Note: Setting the Maximum trace size to 0 means that the trace size is unlimited. The server will continue to send data to the trace file until the problem occurs or there is no more available disk space.
    When tracing is active, the server will write trace data to the trace file until the file is half the maximum trace file size. The server will then create a second file, appending a 2 to the trace file name, and it will send trace data to the second file until it is the same size as the first. It will then start overwriting the data in the first trace file.

  6. To have Tracing start as soon as the server is started, select the Trace Server Startup check box.

  7. Click Submit or Save.

Selecting Trace Nodes

The next step in configuring Tracing is to select the events that will be collected in the trace. To do this, select the appropriate categories in the navigation tree. Technical support will tell you which nodes to select.

Starting and Stopping Tracing

If the Trace Server Startup check box is selected, tracing will start as soon as the server is started. Otherwise, to start tracing:

  1. Log on to the Administrative WebStation using an Administrator profile and switch to configure mode.

  2. In the navigation tree under the name of the server you want to trace, click Tracing. The Tracing Active check box in the panel is automatically selected when tracing is active.

  3. Above the navigation tree, click Start Trace.

  4. After the behavior you want to trace occurs, click Stop Trace.

  5. Unless Maximum trace file size is set to 0, you will have two trace files. Send both of them to technical support following their instructions.