This article describes how to enable PortICA logging.

Background

PortICA logging, in addition to enabling the Workstation Agent log, can be a useful tool when troubleshooting issues with the Virtual Desktop Agent (VDA). PortICA logging is not enabled by default on the VDA.

---

Instructions

PortICA logging can be enabled using the LogEnabler tool or by following the Manual Method :

Using LogEnabler Tool

1. Download the LogEnablerV3.zip and extract it to a convenient location.

2. Double-click to start the application and select the appropriate options to enable or disable logging.

Manual Method

1. Create a new file named PorticaConfig.XML within the following directory:

   C:\Program Files\Citrix\ICAService\XML\

   Note: You must create the XML directory.

2. Copy and paste the following text into the file:

   <?xml version="1.0" encoding="utf-8"?>
   <Config xmlns="Portica.xsd">
           <Portica>
           <LogFile>
               <LogLevel>5</LogLevel>
           </LogFile>
           <CdfTrace>
               <LogLevel>5</LogLevel>
           </CdfTrace>
           <FunctionTrace>
               <LogLevel>5</LogLevel>
           </FunctionTrace>
       </Portica>
   </Config>

3. Save this file to the newly created XML directory.

4.  Restart the Citrix ICA Service.

The above mentioned sample code is provided to you as is with no representations, warranties or conditions of any kind. You may use, modify 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 sample code 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 sample code 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 sample code. In no event should the code be used to support 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 SAMPLE CODE, INCLUDING WITHOUT LIMITATION DIRECT, SPECIAL, INCIDENTAL, PUNITIVE, CONSEQUENTIAL OR OTHER DAMAGES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Although the copyright in the code belongs to Citrix, any distribution of the sample code should include only your own standard copyright attribution, and not that of Citrix. You agree to indemnify and defend Citrix against any and all claims arising from your use, modification or distribution of the sample code.

This article describes how to enable PortICA logging.

Log File Format

The log files is created using the following format:

porticaSvc_<timestamp>.log

Log File Location

Under Windows XP, the log files are generated and stored in the following directory:

C:\Documents and Settings\LocalService\Local Settings\Temp

For Windows 7 and Vista, the log files can be found in the following directory:

C:\Windows\ServiceProfiles\LocalService\AppData\Local\Temp

Logging Verbosity levels

Within porticaConfig.XML, you can configure the level of logging used using the <LogLevel></LogLevel> value. Your options are 0, 1, 5, or 9; with 0 being the least verbose or no logging, and 9 being the most verbose (all available output). In most cases, a logging level of 5 is sufficient to triage PortICA issues.

Note: In Step 2, LogLevel is set to 5 for each of the logs.