Product Documentation

Configure CEIP

May 22, 2017

When you participate in the Citrix Customer Experience Improvement Program (CEIP), anonymous statistics and usage information are sent to Citrix to help improve the quality and performance of Citrix products.

Registry settings

By default, you automatically participate in the CEIP when you install the Linux VDA. The first upload of data occurs approximately seven days after you install the Linux VDA. You can change this default setting in the registry.

CEIPSwitch

Registry setting that enables or disables the CEIP (default = 0):

Location: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\CEIP

Name: CEIPSwitch

Value: 1 = disabled, 0 = enabled

By default, the CEIPSwitch property is hidden in the registry. When it remains unspecified, the CEIP is enabled.

You can run the following command on a client to disable the CEIP: 

Command Copy

/opt/Citrix/VDA/bin/ctxreg update -k "HKEY_LOCAL_MACHINE\ SOFTWARE\Citrix\CEIP" -v "CEIPSwitch" -d "1"

DataPersistPath

Registry setting that controls the data persisting path (default = /var/xdl/ceip):

Location: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\CEIP

Name: DataPersistPath

Value: String

You can run the following command to set this path:

command Copy

/opt/Citrix/VDA/bin/ctxreg update -k "HKEY_LOCAL_MACHINE\ SOFTWARE\Citrix\CEIP" -v "DataPersistPath" -d "your_path" 

If the path you configured does not exist or cannot be accessed, data is saved in the default path.

CEIP data collected from the Linux VDA

The following table gives an example of the types of anonymous information collected. The data does not contain any details that identify you as a customer.

Data point

Key name

Description

Machine GUID

machine_guid

Identifying the machine where the data originates

AD solution

ad_solution

String denoting the machine’s domain joining method

Linux kernel version

kernel_version

String denoting the machine’s kernel version

LVDA version

vda_version

String denoting the installed version of the Linux VDA.

LVDA update or fresh install

update_or_fresh_install

String denoting the current Linux VDA package is being freshly installed or updated

HDX 3D pro enabled or not

hdx_3d_pro

String denoting whether HDX 3D Pro is enabled on the machine

VDI mode enabled or not

vdi_mode

String denoting whether VDI mode is enabled

LVDA key services last restart time

ctxhdx

ctxvda

The last restart time of the ctxhdx and ctxvda services, in the format of dd-hh:mm:ss, for example, 10-17:22:19

GPU type

gpu_type

Denoting the GPU type of the machine

CPU cores

cpu_cores

Integer denoting the number of CPU cores of the machine

CPU frequency

cpu_frequency

Float denoting the CPU frequency in MHz

Physical memory size

memory_size

Integer denoting the physical memory size in KB

Active session number

active_session_number

Integer denoting the number of active sessions on the machine at the time we collect this data point

Linux OS name and version

os_name_version

String denoting the Linux OS name and version of the machine

Session key

session_key

Identifying the session where the data originates

Reconnect time cost

reconnect_time_cost

Used to save the session’s reconnect time cost. The size of the array is 5 where we keep track of the current value, the minimum value, the maximum value, the running sum, and the update count of this data point.

Active session time

active_session_time

Used to save the session’s active times. One session could have multiple active times because the session can disconnect/reconnect.

Session duration time

session_duration_time

Used to save the session’s duration from logon to logoff

Receiver client type

receiver_type

Integer denoting the Citrix Receiver type used to launch the session

Receiver client version

receiver_version

 

String denoting the version of Citrix Receiver used to launch the session

Printing count

printing_count

Integer denoting the number of times the session uses the printing function

USB redirection count

usb_redirecting_count

Integer denoting the number of times the session uses a USB device