Citrix UPM Log Parser v1.5

Created Date: Oct 8, 2009

Modified Date: Oct 4, 2016

Please note:
You can download the required file from the Citrix downloads website by visiting the following link: https://www.citrix.com/downloads/citrix-tools

Description

Citrix UPM Log Parser has been designed to help analyzing the log files generated by Citrix Profile Management.

Changes from previous version

• Bug fixes

• Added a time span filter

• Added a time filter

Installation

Note: The tool requires Microsoft .Net Framework 3.0 or higher.

1. Extract the contents of the zip file to a folder.

2. Run CitrixUPMLogParser.exe

How to use Citrix UPM Log Parser

When launching the tool, you can enter the name of a remote machine on which it will try to locate the log file.

If the remote machine cannot be contacted, the tool shows the following error message, to invite you to enter another machine name:

And an Open File dialog box appears, prompting for the location of the log file.

If the machine can be reached, the tool tries to locate the UserProfileManager.log file in <systemroot>\system32\LogFiles\UserProfileManager.

If the file is not found, the tool looks into HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Citrix\UserProfileManager\PathToLogFile to retrieve the log file location (configurable using GPO/INI file)

Finally, if no machine name is specified, the local machine is used instead to prompt for a log file.

If, in the file, information is found about the logging level setup, the Windows version/service pack level and the Citrix Profile Manager version, they are displayed:

When the file is loaded, the tool will jump to the first error found and display the detailed message about the event:

The errors are highlighted in red, while the logon events appear in green and the logoff in blue. A specific color is used when the start of a logoff or logon operation is detected. Service starting and stopping events appear in gray.

The Find button prompts for text to search, optionally filtering the Information, Warning and/or Errors messages. Starting from the beginning of the log, the first event matching the search criteria appears.

To continue the search to the next match, press F3. A new click on the Find button shows the dialog box again.

A right-click on the list will pop-up a menu offering options to copy the highlighted line and to filter or hide the chosen data:

It is possible to filter or hide lines based on Date, Time, Type, Username, Domain, Session ID or Thread ID. The “Reset filter” option will clear all previous filters.

It is also possible to filter based on the time span between two lines: preconfigured times are above a second, 5 seconds, 10 seconds, 30 seconds or a minute. A custom time span (strictly above 60 seconds) can also be entered. The display will be updated leaving only the lines showing the time span selected.

To be able to open another log file, close the existing log.

Security Permissions Required by Citrix UPM Log Parser

When trying to access a remote machine, you must have the required rights to access the machine registry and file system (via the admin share) remotely.

Data Modified by Citrix UPM Log Parser

None.

Uninstallation

Delete the file from the machine.

Contact Information

Questions?  Concerns?  Send any feedback for this tool to supporttools@citrix.com.

Disclaimer

These software applications are provided to you as is with no representations, warranties or conditions of any kind.  You may use and distribute it at your own risk. CITRIX DISCLAIMS ALL WARRANTIES WHATSOEVER, EXPRESS, IMPLIED, WRITTEN, ORAL OR STATUTORY, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NONINFRINGEMENT. Without limiting the generality of the foregoing, you acknowledge and agree that (a) the software application may exhibit errors, design flaws or other problems, possibly resulting in loss of data or damage to property; (b) it may not be possible to make the software application fully functional; and (c) Citrix may, without notice or liability to you, cease to make available the current version and/or any future versions of the software application.  In no event should the code be used to support of ultra-hazardous activities, including but not limited to life support or blasting activities.  NEITHER CITRIX NOR ITS AFFILIATES OR AGENTS WILL BE LIABLE, UNDER BREACH OF CONTRACT OR ANY OTHER THEORY OF LIABILITY, FOR ANY DAMAGES WHATSOEVER ARISING FROM USE OF THE SOFTWARE APPLICATION, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.  You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the code.