How to change the log level for the PCoIP Software Client

Rate this Article
No votes yet

August 1, 2018

Last modified: 03/28/2023, 9:56 am

Knowledge Base Article Internal Setup

Teradici Global Support Services may request logging level be changed on the PCoIP Software Client. The log level determines the class of data written to the log. The log levels supported by the PCoIP Software Client are:

  • 0 = Critical
  • 1 = Error
  • 2 = Info (Default)
  • 3 = Debug 

Logging can be changed via the command line for one client session or for all sessions it can be set in the client settings files or Windows registry.

Command line

Windows

  1. The Windows client executable can be found in "C:\Program Files (x86)\Teradici\PCoIP Client\bin\pcoip_client.exe"
  2. Start the client from the command line and specify the log level using the -l option. For example:
    "C:\Program Files (x86)\Teradici\PCoIP Client\bin\pcoip_client.exe" -l log-level

Mac OSX and Linux

  1. Open the client from a Terminal window with a command line parameter specifying the log level as follows: 
    open /Applications/PCoIPClient.app --args -l log-level

     

Client settings file

Windows

  1. Edit the file %LOCALAPPDATA%\Local\Teradici\pcoip_client_settings.txt 
  2. Add the line pcoip.event_filter_mode = log-level

Mac OSX and Linux

  1. Set pcoip.event_filter_mode = log-level in /etc/teradici/pcoip_admin.conf

Windows Registry

You can use regedit to update the registry manually 

  • Define the pcoip.event_filter_mode value in the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Teradici\Client\PCoIP\pcoip_admin_defaults
  • Set the value of pcoip.event_filter_mode to the log level you want.  The type should be DWORD 32-bit.
 
Pertains to:
  • PCoIP Software Client 1.0.0
  • PCoIP Software Client 1.10.0
  • PCoIP Software Client 1.11.0
  • PCoIP Software Client 1.5.0
  • PCoIP Software Client 1.7.0
  • PCoIP Software Client 1.8.0
  • PCoIP Software Client 1.9.0
  • PCoIP Software Client 1.9.1
  • PCoIP Software Client 3.2.0
  • PCoIP Software Client 3.3.0
  • PCoIP Software Client 3.4.0
  • PCoIP Software Client 1.0.0
  • PCoIP Software Client 1.10.0
  • PCoIP Software Client 1.11.0
  • PCoIP Software Client 1.5.0
  • PCoIP Software Client 1.7.0
  • PCoIP Software Client 1.8.0
  • PCoIP Software Client 1.9.0
  • PCoIP Software Client 1.9.1
  • PCoIP Software Client 3.2.0
  • PCoIP Software Client 3.3.0
  • PCoIP Software Client 3.4.0