visionapp Platform Management Suite visionapp Citrix Tool Citrix ...

visionapp Platform Management Suite
visionapp Citrix Tool
Citrix Policy Configuration
Version 6.1
Technische Dokumentation

II
Copyright © visionapp GmbH, 2002-2006. Alle Rechte vorbehalten.
Die in diesem Dokument enthaltenen Informationen, Konzepte und Ideen sind Eigentum
der visionapp GmbH. Dieses Dokument darf ohne vorherige schriftliche Genehmigung
der visionapp GmbH weder als Ganzes noch auszugsweise vervielfältigt,
fotokopiert, reproduziert, übersetzt, auf ein elektronisches Medium übertragen oder in
maschinenlesbare Form gebracht werden.
Die in diesem Dokument enthaltenen Angaben und Daten können ohne vorherige Ankündigung
geändert werden.
Alle in diesem Dokument erwähnten Marken- und Produktnamen sind Warenzeichen der
jeweiligen Rechtinhaber und werden hiermit anerkannt.
visionapp GmbH
Theodor-Heuss-Allee 110
D-60486 Frankfurt a.M.
Telefon: +49-69-79583-0
Fax: +49-69-79583-599
Email: info@visionapp.de
Web: http://www.visionapp.de
vPMS_vCT_PolicyConfiguration_61_DE II

III
Inhalt
1 Vorwort ................................................................................................... 1
2 Einleitung ................................................................................................ 2
2.1 Voraussetzungen ......................................................................................2
3 Hintergrund............................................................................................. 4
4 Systemvoraussetzung.............................................................................. 6
5 Funktionsweise ....................................................................................... 7
6 Komponenten .......................................................................................... 8
6.1 CPCCon.exe .............................................................................................8
6.2 vCTCPC.dll...............................................................................................8
6.3 vCTCommonLib.dll ....................................................................................8
6.4 vCTResources.dll ......................................................................................8
6.5 vMFCom30.dll, vMFCom40.dll, vMFCommonLib.dll .........................................8
7 Die Anwendung CPCCon.exe .................................................................... 9
7.1 Funktionen ..............................................................................................9
7.1.1 Der Parameter /LFN: ..............................................................................9
7.1.2 Der Parameter /EFL.............................................................................. 10
7.1.3 Der Parameter /IP................................................................................ 10
7.1.4 Der Parameter /IFN:............................................................................. 10
7.1.5 Der Parameter /EP ............................................................................... 11
7.1.6 Der Parameter /EFN: ............................................................................ 11
7.1.7 Der Parameter /DAC............................................................................. 11
7.1.8 Der Parameter /SN: ............................................................................. 11
7.1.9 Der Parameter /? ................................................................................. 11
8 Die Parameterdatei (vCPC.xml) ............................................................. 12
9 Rückgabewerte/Fehlercodes ................................................................. 13
10 Nicht unterstützte Policy Einstellungen............................................... 14
11 Bekannte Fehler.................................................................................. 15
vPMS_vCT_PolicyConfiguration_61_DE III

1
1 Vorwort
Vielen Dank, dass Sie sich für ein Produkt der visionapp GmbH entschieden haben. Die
visionapp Platform Management Suite wird intensiven Qualitätstests unterzogen. Kein
Produkt verlässt unser Haus ohne sorgfältige Tests unserer Qualitätssicherung. Aufgrund
der komplexen Struktur der Computersoftware kann die visionapp GmbH jedoch
keine Garantie dafür übernehmen, dass die Software der visionapp GmbH fehlerfrei ist,
ohne Unterbrechungen arbeitet, mit allen Geräten und Softwarekonfigurationen kompatibel
ist oder Ihren sonstigen Anforderungen entspricht.
Der Inhalt dieser Dokumentation ist rein informativ und kann jederzeit ohne Benachrichtigung
geändert werden. Sie stellt keinerlei Verpflichtung von Seiten der visionapp
GmbH dar. Überdies übernimmt die visionapp GmbH keine Haftung für Fehler oder
Ungenauigkeiten in dieser Dokumentation.
Die neueste Dokumentation finden Sie auf unserer Website unter:
http://www.visionapp.de/support
vPMS_vCT_PolicyConfiguration_61_DE 1

2
2 Einleitung
Dieses Handbuch enthält eine Anleitung über die möglichen Funktionen sowie Referenzinformationen
für Betrieb und Fehlerbeseitigung. Bitte studieren Sie es vor der Verwendung
der Software sorgfältig, um das Risiko eventueller Fehler bei der Durchführung
der Installation und Konfiguration der Software schon im Vorfeld einzugrenzen.
Die visionapp GmbH begrüßt ausdrücklich Ihre Kommentare zu diesem Handbuch.
Sollten sie Fragen oder Verbesserungsvorschläge zur Software selbst oder zur Dokumentation
haben, so finden Sie auf unserer Website (http://www.visionapp.de/support)
weitere Hinweise.
2.1 Voraussetzungen
Voraussetzung für ein erfolgreiches Arbeiten mit dem vorliegenden Handbuch sind gute
Kenntnisse im Umgang mit Microsoft Windows Terminal Services und Citrix Presentation
Server Farmen. Eine grundsätzliche Vertrautheit mit Microsoft Windows Server
Betriebssystemen und Softwareverteilungsverfahren für Betriebssysteme sowie
Applikationen ist von Vorteil. Weiterhin richtet sich dieses Handbuch an Personen, die
mit Installation, Administration und Fehlerbeseitigung von Servern befasst sind. Die
visionapp GmbH geht davon aus, dass Sie für die Wartung von Servern qualifiziert sind
und für die Arbeit an eingesetzten Softwareprodukten geschult wurden.
Diese Dokumentation setzt ein bestimmtes Wissen über technische Gegebenheiten und
Fachtermini voraus. Für den einfacheren Umgang mit der vorliegenden Dokumentation
ist daher die Kenntnis der entsprechenden Dokumentation von Citrix sinnvoll.
Falls Sie ein Problem mit den vorhandenen Informationen nicht beheben können, finden
Sie auf unserer Website (http://www.visionapp.de/support) weitere Hinweise zur
Lösung von Problemen. Überdies informiert Sie unsere Website über:
Informationen zum Produkt
Informationen zu neuen Produkten
Produktaktualisierungen
zahlreiche Whitepapers und Präsentationen
Vertriebspartner in Ihrer Nähe
vPMS_vCT_PolicyConfiguration_61_DE 2

3
Diese Dokumentation hält sich weitgehend an die folgenden Richtlinien:
fett Schaltflächen sowie Wörter und Texte wie sie in der Benutzeroberfläche
verwendet werden fett gedruckt.
„Anführungs-
zeichen“
Die Hervorhebung durch „Anführungszeichen“ macht den Leser auf
Fachbegriffe aufmerksam, die zum ersten Mal in der Dokumentation
verwendet werden.
Link Bei blauem und gleichzeitig unterstrichenem Text handelt es sich
um einen Hyperlink.
Die Dokumentation verdeutlicht den Text mit folgenden Symbolen:
Die Erste-Hilfe-Box weist auf Hilfestellungen zu einem bestimmten
Problem hin, gibt Tipps zu Besonderheiten oder verrät ungewöhnliche
Lösungen.
Das Frage-Antwort-Symbol steht für einen Hinweis. Es weist auf
Besonderheiten hin, die beachtet werden müssen, um problemloses
Arbeiten mit dem Produkt zu ermöglichen.
Das Warnsymbol macht auf besonders wichtige Abschnitte im
Dokument aufmerksam. An diesen Stellen werden nützliche Hinweise
gegeben, die Sie vor evtl. Datenverlust, Beschädigungen des
Produkts und anderen unerfreulichen Begleiterscheinungen bewahren.
vPMS_vCT_PolicyConfiguration_61_DE 3

4
3 Hintergrund
Mittels Citrix Presentation Server können Richtlinien (Policy) auf Verbindungen
angewendet werden, die bestimmte Bedingungen erfüllen. Richtlinien können für
Benutzer und Benutzergruppen erstellt werden, basierend auf geografischem Standort,
Stellenbeschreibung oder auf bestimmten Aufgaben, die nicht für alle Bedingungen
gelten. Wenn Richtlinien erstellt werden, können diese auf Benutzernamen,
Benutzergruppen, IP-Adressen von Clientgeräten, Clientgerätenamen oder Server
angewendet werden. Richtlinien enthalten Regeln, die die Einstellungen der Richtlinien
definieren. Eine einzelne Richtlinie kann mehrere Regeln enthalten. Beispiel: Es können
Richtlinien erstellt werden, mit denen eine Gruppe von Regeln auf Verbindungen von
Arbeitsstationen im Unternehmenshauptsitz angewendet werden, und eine andere
Gruppe von Regeln, die auf Verbindungen von Laptops angewendet wird, die dem
mobilen Verkaufspersonal zur Verfügung gestellt werden. Standardmäßig werden neu
erstellte Richtlinien auf keine Verbindung angewendet. Es muss eine Richtlinie
mindestens einem Filter hinzugefügt werden, damit diese auf Verbindungen
angewendet wird.
vPMS_vCT_PolicyConfiguration_61_DE 4

5
Abbildung 1: Citrix Policy Eigenschaften
Je nach Umgebung können die zu erstellenden Richtlinien sehr umfangreich sein. Bei
einer kompletten Erst- oder Neuinstallation einer Farm müssen so über die Citrix
Management Konsole alle Einstellungen gesetzt werden. Im Enterprise-Umgebung
müssen die Richtlinien automatisch importiert werden können ohne einen manuellen
Eingriff über die Citrix Management Konsole diese zu setzen.
Weitere Informationen zum Erstellen und Festlegen von Richtlinien finden Sie im Citrix
MetaFrame Presentation Server-Handbuch.
vPMS_vCT_PolicyConfiguration_61_DE 5

6
4 Systemvoraussetzung
Grundvoraussetzung für den Einsatz der visionapp Citrix Policy Configuration ist
zunächst eines der folgenden Betriebssysteme in englischer oder deutscher Sprache:
Microsoft Windows 2000 Server oder Advanced Server für die x86 Platform, mit
Service Pack 4 oder höher
Microsoft Windows Server 2003, Standard oder Enterprise Edition, für die x86
oder x64 Platform, mit Service Pack 1 oder höher
Microsoft Windows Server 2003 R2, Standard oder Enterprise Edition, für die
x86 oder x64 Platform, mit Service Pack 1 oder höher
Zusätzlich werden die folgenden Anwendungen für den Einsatz der in dieser Dokumentation
beschriebenen Komponenten benötigt:
Microsoft .Net Framework 1.1
vPMS_vCT_PolicyConfiguration_61_DE 6

7
5 Funktionsweise
Die vCTCPC wurde entwickelt, um eine Sicherung von Citrix-spezifischen
Richtlinieneinstellungen mit Option zur Wiederverwendung durchzuführen.
Mittels des vCTCPC-Werkzeugs können bestehende Richtlinien einer Citrix Presentation
Server Farm in eine Datei exportiert werden. Die erstellte Datei kann während einer
Initialinstallation automatisch in eine Citrix Presentation Server Farm importiert
werden. Je nach Aufgabe können der Anwendung unterschiedliche Kommandozeilen
mitgegeben werden.
Der Funktionsablauf:
Verbindungsaufbau zum Citrix Presentation Server
Export oder Import der Citrix Presentation Server Richtlinien (Policy)
optional - Protokollieren der Aktionen
Die Komponente ist in der ausgelieferten, ausführbaren Toolbox-
Setup enthalten. Um die Installation zu starten, muss die
Installationsdatei auf ein lokales Laufwerk kopiert werden (die Datei
kann nicht von einem Netzlaufwerk ausgeführt werden). Die
Installationsdatei für das Toolbox-Setup befindet sich auf der
visionapp Produkt-CD unter:
:\Installation\visionapp Toolbox Setup\visionapp_Toolbox.msi.
Die Installation wird mit einem Doppelklick auf die Datei
visionapp_Toolbox.msi gestartet.
vPMS_vCT_PolicyConfiguration_61_DE 7

8
6 Komponenten
Die vCTCPC setzt sich aus den in den nachfolgenden Abschnitten beschriebenen
Komponenten zusammen:
6.1 CPCCon.exe
Mit der Konsolenanwendung CPCCon.exe (Citrix Policy Configuration) wird die
komplette vCPC-Funktionalität ausgeführt.
6.2 vCTCPC.dll
Die Datei vCTCPC.dll ist eine Funktionsbibliothek, welche die Programmlogik von vCPC
enthält.
6.3 vCTCommonLib.dll
Die Datei vCTCommonLib.dll ist eine Funktionsbibliothek, die alle metaframebezogenen
Funktionen für Metaframe Presentation Server enthält.
6.4 vCTResources.dll
Die Datei vCTResources.dll ist eine Funktionsbibliothek, welche die Texte für die
Komponenten enthält.
6.5 vMFCom30.dll, vMFCom40.dll, vMFCommonLib.dll
Die Dateien vMFComxx.dll sind Funktionsbibliotheken, die aus der MFCOM.exe
exportierte Funktionen enthalten, um den Zugriff über Microsoft .Net zu ermöglichen
(Interoperatibilität mit COM-Objekten). Die Anwendung vMFCommonLib.dll ist eine
Funktionsbibliothek des Citrix Moduls innerhalb des visionapp Control Centers (vCC).
vPMS_vCT_PolicyConfiguration_61_DE 8

9
7 Die Anwendung CPCCon.exe
Die Ausführung der kompletten vCPC-Funktionalität erfolgt über die Anwendung
CPCCon.exe die es ermöglicht sämtliche Funktionen unbeaufsichtigt auszuführen.
7.1 Funktionen
Damit die automatisierte Ausführung von vCPC gewährleistet wird verfügt CPCCon.exe
über verschiedene Kommandozeilenparameter. Der Aufruf von CPCCon.exe mittels
Kommandozeilenparameter “/?” zeigt eine Beschreibung der möglichen Kommandozeilenparameter
an:
CPCCon.exe [/LFN:] [/EFL] [/IP] [/IFN:] [/EP] [/EFN:]
[/DAC] [/SN:] [/?]
/LFN:LogFileName
/EFL EnableFileLogging
/IP ImportPolicies
/IFN: ImportFileName
/EP ExportPolicies
/EFN:ExportFileName
/DAC DisableAccessCheck
/SN: ServerName
/? Help
Abbildung 2: CPCCon.exe Online-Hilfe
7.1.1 Der Parameter /LFN:
Der Parameter „/LFN:“ (LogFileName) dient dazu eine bestimmte Protokolldatei
anzugeben, in die die durch vCPC ausgeführten Aktionen protokolliert werden. Dieser
Parameter kann nur zusammen mit dem Parameter „/EFL“ angegeben werden.
vPMS_vCT_PolicyConfiguration_61_DE 9

10
7.1.2 Der Parameter /EFL
Der Parameter „/EFL“ (EnableFileLogging) dient dazu die Protokollierung in einer
Protokolldatei zu aktivieren. Wenn dieser Parameter nicht angegeben wird, wird keine
Protokolldatei erstellt. Ohne Angabe des Parameters „/LFN:“ wird die Protokolldatei
„%Anwendungsverzeichnis%\vCPC.log“ erstellt.
24.05.2006 23:11:47:970 CPC started
24.05.2006 23:11:49:726 Export of Citrix policies...
24.05.2006 23:11:50:478 Export of policy configuration "visionapp"
started.
24.05.2006 23:11:50:541 Start export Category "Policy Filter"
24.05.2006 23:11:50:557 Category "Policy Filter" has been successfully
exported
24.05.2006 23:11:50:588 Start export Category "Session Policy"
24.05.2006 23:11:50:855 Category "Session Policy" has been successfully
exported
24.05.2006 23:11:50:871 Start export Category "User Policy 2"
24.05.2006 23:11:50:933 Category "User Policy 2" has been successfully
exported
24.05.2006 23:11:50:996 Start export Category "Policy Filter 2"
24.05.2006 23:11:51:027 Category "Policy Filter 2" has been successfully
exported
24.05.2006 23:11:51:074 Start export Category "Session Policy 2"
24.05.2006 23:11:51:168 Category "Session Policy 2" has been successfully
exported
24.05.2006 23:11:51:184 Policy configuration "visionapp" exported.
24.05.2006 23:11:51:200 CPC finished
Abbildung 3: vCPC.log Protokoll-Datei
7.1.3 Der Parameter /IP
Der Parameter „/IP“ (ImportPolicies) dient dazu die Einstellungen der Citrix Policies, zu
importieren. Ohne Angabe des Parameters „/IFN:“ wird die Importdatei
„%Anwendungsverzeichnis%\vCPC.xml“ benutzt..
7.1.4 Der Parameter /IFN:
Dieser Parameter überschreibt die Standardeinstellung
„%Anwendungsverzeichnis%\vCPC.xml“. Dieser Parameter kann nur zusammen mit
dem Parameter „/IP“ angegeben werden.
vPMS_vCT_PolicyConfiguration_61_DE 10

11
7.1.5 Der Parameter /EP
Der Parameter „/EP“ (ExportPolicies) dient dazu die Einstellungen der Citrix Policies in
eine Datei zu exportieren. Ohne Angabe des Parameters „/EFN:“ wird die Exportdatei
„%Anwendungsverzeichnis%\vCPC.xml“ erstellt.
7.1.6 Der Parameter /EFN:
Der Parameter „/EFN:“ (ExportFileName) dient dazu eine bestimmte Exportdatei
anzugeben, in welche die Policy Einstellungen exportiert werden. Dieser Parameter
kann nur zusammen mit dem Parameter „/EP“ angegeben werden.
7.1.7 Der Parameter /DAC
Der Parameter „/DAC“ (DisableAccessCheck) dient dazu die automatische Prüfung der
Zugriffsrechte beim Start der Anwendung zu deaktivieren. Dies kann z.B. bei der
Ausführung über AT-Job sinnvoll sein.
7.1.8 Der Parameter /SN:
Der Parameter „/SN:“ (ServerName) dient dazu den Namen (kein UNC-Name) des
Servers explizit anzugeben, auf dem die vCPC-Operationen ausgeführt werden sollen.
Es wird automatisch der Name des Servers verwendet auf dem CPC ausgeführt wird,
wenn dieser Parameter nicht angegeben wird.
7.1.9 Der Parameter /?
Der Parameter „/?“ zeigt die o.g. Onlinehilfe an.
vPMS_vCT_PolicyConfiguration_61_DE 11

12
8 Die Parameterdatei (vCPC.xml)
Die Datei vCPC.xml ist die Parameterdatei, die alle Informationen enthält, die vCPC
zum Konfigurieren der Policies benötigt. Die Parameterdatei wird ohne explizite Angabe
eines anderen Pfades/Dateinamens im gleichen Verzeichnis wie die Programmdatei
CPCCon.exe und mit dem Namen vCPC.xml erwartet.
visionapp100000004446743408651797263
10353381307831
91221202320022<
/configureshadowers>0222
21422222
…
…
12-
10
Abbildung 4: vCPC.xml Parameter-Datei
vPMS_vCT_PolicyConfiguration_61_DE 12

13
9 Rückgabewerte/Fehlercodes
Folgende Rückgabewerte (Return Codes) können nach Ausführung der Anwendung
zurückgeliefert werden:
Wert Bedeutung
0 NoError
2 NotLicensed
3 NoAdminFarmAccess
4 ExportError
5 ParameterMissing
6 ImportFileDoesntExists
7 ImportError
1000 UnknownError
32765 WarningOccurs
Tabelle 1: Rückgabewerte und Fehlercodes
vPMS_vCT_PolicyConfiguration_61_DE 13

14
10 Nicht unterstützte Policy Einstellungen
Folgende Einstellungen werden beim Import nicht unterstützt:
„Display Window Contents While Dragging Rule” (EnableDragWithContents)
„Menu Animation“ (EnableMenuAnimation)
„Printer Connections For The Session Printer Policy” (PrinterConnections)
„Allowed/Denied Accounts For This Policy“ (Allowed/Denied Accounts)
“Central Credential Store” wird erst ab Citrix Presentation Server 4.0
unterstützt
„UNC path for Central Credential Store“ wird erst ab Citrix Presentation Server
4.0 unterstützt.
„Do not use Metaframe Password Manager“ wird erst ab Citrix Presentation
Server 4.0 unterstützt
vPMS_vCT_PolicyConfiguration_61_DE 14

15
11 Bekannte Fehler
„List Of Allowed/Denied Client Names“ (Alowed/Denied ClientNames)
„This Property Queries Or Sets The Policy That Determines The Type Of The
Client Printers To Be Connected When A User Logs On To A Session“
(ConnectCPDeviceType). Die Einstellung “Do not auto-create client printers”
wird nicht unterstützt. Stattdessen wird die Einstellung „Auto-create all client
printers“ gesetzt.
Die hier aufgeführten Probleme sind beim Hersteller Citrix bekannt.
In Kürze werden hierzu die entsprechenden Hotfixe zur Verfügung
gestellt.
vPMS_vCT_PolicyConfiguration_61_DE 15