Troubleshooting

User Troubleshooting

The Troubleshooting tab is used to define several settings that are used to aid with tracing problems with objects/elements that are being applied on one or more client machines. These Troubleshooting settings will be in effect for both Logon and Logoff timing events.

The most common setting on this object is the ability to create a detailed trace file for one or more specified users and/or computers.

Do not hide windows during logon sequence

Select this check box to show all initialization windows during Desktop Authority startup. This option is useful when troubleshooting logon problems.

Force KiXtart to refresh its group token-cache during each logon attempt

Enumerated groups are cached to the local machine. To flush the local cache and rebuild it on the local machine select this check box. The cache will refresh during each logon attempt.

Create a detailed trace file on these specific computers and/or users:

Select this check box to enable a User trace file to be created for specific computers and/or users.

The sltrace.htm file is a color coded event log of actions taken during the logon process. Red text within the file indicates that some action may not have completed properly or may be taking longer than expected.

Specify a list of computer names and/or user names that a comprehensive trace file will be created for. This trace file describes the actions taken during the logon process. It is created in the client's %temp%\Desktop Authority folder and is called sltrace.htm.

Names must be delimited by a semicolon (;). The computer/user name supports the question mark (?) and asterisk (*) wildcards.

Example:

mjones;jsmith;PC221;PC3??;PC4*

Upload a copy of each client's trace file to this network path

Specify a network path to which all User trace files will be copied to, after each logon. The trace files are uploaded to the central repository using the DA Administrative User account. This account must have appropriate permissions to the central repository location so the files can be copied. The User based log files are uploaded right after the event (Logon, Refresh, Logoff, or Shutdown) is complete.

Click View files to view the trace file repository as specified by the entry.

Enable debug mode for these specific computers and/or users:

Select this check box to allow Desktop Authority User Management to run in debug mode for the specified computers and/or users.

Specify multiple names by delimiting each by a semicolon (;). The computer/user name supports the question mark (?) and asterisk (*) wildcards.

To activate the debug session on the client, press any key upon Desktop Authority initialization. Debug mode runs the logon script, pausing after each entry is executed on the client machine. Press [Enter] to continue processing the next script entry. Press the letter [D] on the keyboard to continue processing the script to the end, without pausing. Press the letter [Q] on the keyboard to abort the script.

When the script if finished processing, you are prompted to apply the contents of the configuration profiles to the debug log. This will append the debug information generated from the client logon process to the sltrace.htm file. You are then prompted to view the sltrace.htm file. This text file may be viewed at any time to further debug problems that may occur during logon for a client