Anforderungen an eine Citrix Laufzeit Umgebung
==============================================

Server Anforderungen
===================
*  getestet mit Citrix XenApp 5.0

Client Anforderungen
===================
*  getestet mit XenApp Client Version 11.2



Installation der Citrix-Client-Komponente ( Cherry Virtual Channel Driver):
==========================================================================
Es wird versucht, automatisch den Installationspfad des Citrix-Clients aus folgenden Registry-Pfaden zu ermitteln:

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


Achtung!
Dieser Eintrag ist bei neueren Versionen des ICA Clients (ab Version 11.2) nicht mehr vorhanden und muss daher manuell gesetzt werden.

Bei 32bit Client Systemen befindet sich der Eintrag nun normalerweise unter
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Install\ICA Client\InstallFolder

Falls ein 64bit Client System verwendet wird, sollte der Eintrag nun unter
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\Install\ICA Client\InstallFolder
gefunden werden können.



Gelingt dies nicht, so wird die Citrix-Komponente nicht installiert!

Im Erfolgsfall:

CDICTXClient.dll wird im über die Registry ermittelten Citrix-Installationspfad installiert.
Die Datei Module.ini (im über die Registry ermittelten Citrix-Installationspfad) wird um der virtuellen Kanal "Cherry" erweitert ( für Win32 Clients):
	Im Abschnitt [ICA 3.0] wird die Zeile "VirtualDriver=" am Ende um ", Cherry" ergänzt
	Im Abschnitt [VirtualDriver] wird eine neue Zeile "Cherry =" hinzugefügt.
	Es wird ein neuer Abschnitt wie folgt angelegt:
		[Cherry]
		DriverName= CDICTXClient.dll
		DriverNameWin32= CDICTXClient.dll

Um mit dem Cherry Device Interface zu kommunizieren, greift CDICTXClient.dll auf die Dll CDITalCom.dll zu;
Diese wird im selben Verzeichnis wie CDI.exe installiert, wenn CDI.exe vorhanden ist, ansonsten unter %program files%\Cherry.
CDICTXClient.dll sucht CDITALCom.dll über einen Registry-Pfad:
Die Zeichenfolge unter HKEY_LOCAL_MACHINE\SOFTWARE\Cherry\Common Files\CDITALCom.dll muss den kompletten Pfad mit Dateinamen für CDITALCom.dll enthalten.

Falls ein 64bit Client System verwendet wird, ist dieser Eintrag nicht vorhanden und muss vom Benutzer erstellt werden, der Wert kann hier ebenfalls unter
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Cherry\Common Files\CDITALCom.dll 
entnommen werden.


Logging auf Client-Seite erfolgt über die Einstellungen im CTCYMConfig - Tool



Installation der Citrix-Server-Komponente:
==========================================
CDITalCTX.dll wird benötigt um mit dem Client kommunizieren zu können.
CDITalCTX.dll wird unter %program files%\Cherry\CDI installiert.

Logging auf Server-Seite erfolgt über die Dll ChyTrace00.dll:
ChyTrace00.dll wird unter %CommonProgramFiles%\Cherry\Common installiert.
CDITalCTX.dll sucht ChyTrace00.dll über einen Registry-Pfad:
Die Zeichenfolge unter HKEY_LOCAL_MACHINE\SOFTWARE\Cherry\Common Files\ChyTrace00.dll muss den kompletten Pfad mit Dateinamen für ChyTrace00.dll enthalten.
Um das Logging zu aktivieren, sind folgende Registry-Einträge notwenig:
[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
