Creating a Trace file/detailed Log in RES Workspace Manager 2011

Grant Tiller

From time to time, the support team here at RES Software may ask you for a trace file or a detailed log.

This helps us to better understand what is happening on a machine, and is often an essential part of pinpointing the cause of an unexpected behavior.

There are a couple of ways you can enable the detailed trace, but to keep it easy I always tend to enable tracing from an Admin PC (that way you don’t need to log on as admin, enable tracing, then log on as your test user.

This produces a much cleaner log file)

Preparing to Create a Trace File

If you are using the Read-Only Blanketing functionality within RES Workspace Manager, you will need to create an exception in Global Authorized Files to allow the trace file to write.

This functionality is only available in the Gold Edition of RES Workspace Manager so if you are not using the Gold Edition, or if you have not enabled this function, then please ignore this step:

Grant Tiller

To create the exception, go to the RES Workspace Manager Console and navigate to Security => Global Authorized Files

Click Add at the bottom of the right pane:

Grant Tiller

In the Authorize file dialogue box fill out the text fields with the appropriate details:

Authorized file (path): c:\temp\RESTrace.log

Administrative note: (optionally) Enter a description of the exception.

Under Authorized operation, make sure that both Execute and Modify options are both checked:

Grant Tiller

Click OK to commit the new file:

Grant Tiller

Creating the Trace File

On your admin PC, type services.msc from the run dialogue box:

Grant Tiller

Within the services console, right click Services in the left pane, and select Connect to another computer…

Grant Tiller

In the Select Computer dialogue box, type the name or IP address of the PC, Terminal Server or Hosted Virtual Desktop running Workspace Manager that you would like to enable tracing on:

Grant Tiller

Locate the RES Workspace Manager service, right click and select stop:

Grant Tiller

The next step is to make three minor changes to the registry in order to enable tracing.

From the run dialogue box on your admin PC run regedit:

Grant Tiller

In the registry editor, go to File and select Connect Network Registry…

Grant Tiller

Type the name or IP address of the PC, Terminal Server or Hosted Virtual Desktop running Workspace Manager that you would like to enable tracing on:

Grant Tiller

Scroll through HKEY_LOCAL_MACHINE => SOFTWARE => RES => Workspace Manager:

Grant Tiller

Note that, if you are on a 64-bit operating system, you will need to locate the necessary key in a different location:

HKEY_LOCAL_MACHINE => SOFTWARE => Wow6432Node => RES => Workspace Manager

You then need to create three String Values:

Grant Tiller
  • Value: Trace
  • Type: REG_SZ
  • Data: Yes
  • Value: TraceDetailed
  • Type: REG_SZ
  • Data: Yes
  • Value: TraceFile
  • Type: REG_SZ
  • Data: c:\temp\RESTrace.log
Grant Tiller

You can now go back to the Services snap-in and start the RES Workspace Manager service:

Grant Tiller

Now turn to the PC, Terminal Server or Hosted Virtual Desktop that is running Workspace Manager, and log in as usual:

Grant Tiller

Perform the routine or action that contains the unexpected behavior that you would like RES Software to investigate.

If it is appropriate to do so, make a note of the time that the unexpected behavior occurs:

Grant Tiller

Do not stay logged on to the user session for too long, and be sure not to open applications or perform any actions that are not connected to the unexpected behavior you have seen.

The log file that is being written is limited to two megabytes in size, and when the content reaches this size, it will start overwriting the earliest entries.

Log Off the desktop session (it is important to do this whilst the trace is running, as we can ensure that all processes are being finished and ended cleanly)

Grant Tiller

Now go back to the Admin PC, and stop the RES Workspace Manager service on the PC, Terminal Server or Hosted Virtual Desktop running Workspace Manager:

Grant Tiller

Map through the c$ share to retrieve the RESTrace.log file from the temp directory:

Grant Tiller

Feel free to zip the trace file:

Grant Tiller

The compression ratio will be very high, and it will keep the load off your mail server:

Grant Tiller

Tidying up After Creating the Trace File

It is our recommendation that you do not leave the tracing running on the PC, Terminal Server or Hosted Virtual Desktop running Workspace Manager since this will hinder the performance of the User’s session.

Therefore, while the RES Workspace Manager service is halted, set the values of Trace and TraceDetailed string values to No:

  • Value: Trace
  • Type: REG_SZ
  • Data: No
  • Value: TraceDetailed
  • Type: REG_SZ
  • Data: No
Grant Tiller

Alternatively, you can delete the three keys totally:

Grant Tiller

You can now close the registry editor, and then start the RES Workspace Manager service:

Grant Tiller

Create an Instant Report of the Event Log

The final step is to create an Instant Report of the user Event Log – this file gives a great summary of what happened during the user’s session.

In the RES Workspace Manager Console, navigate to Diagnostics => Workspace Analysis:

Grant Tiller

Type the name of your test user into the Search for: field, and hit the Search button:

Grant Tiller

Right click the name of the User Account returned after the search and select Analyze:

Grant Tiller

At the top of the tree, right click the user’s name and choose Select items for Instant Report

Grant Tiller

Un-check the top of the tree:

Grant Tiller

Then navigate to Diagnostics => Event Log

You will see a list of time and date stamps that relate to the user sessions

Check the box relating to the last session:

Grant Tiller

Right click the tree, and select Create Instant Report of selected items…

Grant Tiller

The Instant Report Viewer will launch and display the report that you have generated.

Click the Save… button to generate a pdf file of the Instant Report:

Grant Tiller

You will be prompted for the name and location of your report:

Grant Tiller

That’s it – you now have an instant report to go with the Trace file, which will allow the RES Software Support staff to better understand your issues.

Sending the Data to RES Software

If you have been asked to produce some tracing and logging, it will in association to a support call that has been already opened.

When you send the logs back in to support, please ensure that you put the call number into the subject line of the email to our support department.

The format should take the form of: RES Support Ticket #xxxxxx# – description of support call

This will ensure that we can update the call, and work on your issues as quickly as possible.

Thanks for reading this article, and remember that in order to solve the problem, first we need to understand the cause.

Leave a Reply

Your email address will not be published. Required fields are marked *