Requirements to the Citrix Runtime-Environment
==============================================

Server requirements
===================
* tested with Citrix XenApp 5.0

Client requirements
===================
* tested with XenApp Client Version 11.2


Installation of the Citrix-Client-Component (Cherry Virtual Channel Driver)
===========================================================================
The setup tries to detect automatically the installation path of the Citrix-Client in the following registry entry:

HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA-Client\MsiInstallDir
or
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\MsiInstallDir


Warning!
For newer versions of the Citrix ICA Client (later 11.2), this registry entry have to be add manually.

If you run a 32bit client system, the entry should be in 
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Install\ICA Client\InstallFolder

If you run a 64bit client system, the entry should be in
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\Install\ICA Client\InstallFolder



If the setup doesn´t locate the install path in this entry, the Citrix component won´t be installed!

If the setup locates the install path:

CDICTXClient.dll will be installed in the detected directory
The File Module.ini will be extended with the virtual channel "Cherry" (for Win32 Clients):
	In section [ICA 3.0] the entry "VirtualDriver=" will be appended with ", Cherry"
	In section [VirtualDriver] a new entry "Cherry = " will be created
	Also a new section will be created:
		[Cherry]
		DriverName = CDICTXClient.dll
		DriverNameWin32 = CDICTXClient.dll
 
To communicate with the Cherry Device Interface, the CDICTXClient.dll uses the CDITalCom.dll
This file is stored in the same directory as the CDI.exe. If the CDI is not installed, the file is stored in "%program files%\Cherry".

CDICTXClient.dll tries to detect CDITalCom.dll in the following registry path:
	HKEY_LOCAL_MACHINE\SOFTWARE\Cherry\Common Files\CDITALCom.dll

Notice:
The string value have to contain the whole path including the filename of the CDITalCom.dll!
If you run a 64bit client system, you have to add this entry manually. The value should be the same like
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Cherry\Common Files\CDITALCom.dll 

Client-side logging occurs with the CTCYMConfig - Tool



Installation of the Citrix-Server-Component
===========================================
CDITalCTX.dll is used to communicate with the Client.
CDITalCTX.dll will be installed in directory "%program files%\Cherry\CDI".

Server-side logging occurs via the ChyTrace00.dll
ChyTrace00.dll will be installed in "%CommonProgramFiles%\Cherry\Common".
CDITalCTX.dll tries to detect ChyTrace00.dll in the following registry path:
	HKEY_LOCAL_MACHINE\SOFTWARE\Cherry\Common Files\ChyTrace00.dll

Notice:
The string value have to contain the whole path including the filename of the ChyTrace00.dll!

To activate server-side logging, following registry entries have to be set:
[HKEY_LOCAL_MACHINE\SOFTWARE\Cherry\ChyTrace00]
"LoggingEnable"=dword:00000001
"LogFileName"="c:\\temp\\log.txt"
"FileSizeToSplit"=dword:00030000
"SkipModuleName"=dword:00000000
"SkipSourceFile"=dword:00000000
"SkipSourceLine"=dword:00000000
"StripSourceFilePath"=dword:00000001

