visionapp Citrix Tool Citrix Policy Configuration

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 Anführungszeichen Link Schaltflächen sowie Wörter und Texte wie sie in der Benutzeroberfläche verwendet werden fett gedruckt. Die Hervorhebung durch Anführungszeichen macht den Leser auf Fachbegriffe aufmerksam, die zum ersten Mal in der Dokumentation verwendet werden. 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: <CD>:\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 komplette vcpc-funktionalität ausgeführt. Policy Configuration) wird die 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. <?xml version="1.0" encoding="utf- 8"?><policies><policy><name>visionapp</name><description /><enabled>1</enabled><partialmatch>0</partialmatch><policyfilter><allowan onymoususers>0</allowanonymoususers><allowexplicitusers>0</allowexplicitus ers><applyclientipfilter>0</applyclientipfilter><applyclientnamefilter>0</ applyclientnamefilter><applyserverfilter>0</applyserverfilter><applyuserfi lter>0</applyuserfilter></policyfilter><policyid><id64>4446743408651797263 </id64><idh32>1035338130</idh32><idl32>783</idl32></policyid><policytype>1 9</policytype><priority>1</priority><sessionpolicy><acupolicy>2</acupolicy ><acurule>2</acurule><allowedshadowaccounts /><allowshadow>1</allowshadow><clientsecurityrequirement>2</clientsecurity requirement><clientsecurityrequirementlist>0</clientsecurityrequirementlis t><clpdriverrule>2</clpdriverrule><clpdrivertype>3</clpdrivertype><concurr entlogonsessions>2</concurrentlogonsessions><concurrentsessionlimit>0</con currentsessionlimit><concurrentsessionslimit>0</concurrentsessionslimit><c oncurrentsessionspolicy>2</concurrentsessionspolicy><configureshadowers>2< /configureshadowers><connectcdatlogon>0</connectcdatlogon><connectcdpolicy >2</connectcdpolicy><connectcdrule>2</connectcdrule><connectclientdrives>2 </connectclientdrives><connectclientprinters>2</connectclientprinters><con nectcpatlogon>1</connectcpatlogon><connectcpdevicetype>4</connectcpdevicet ype><connectcppolicy>2</connectcppolicy><connectcprule>2</connectcprule><d efaulttomainclientprinter>2</defaulttomainclientprinter><defaulttomaincppo licy>2</defaulttomaincppolicy><defaulttomaincprule>2</defaulttomaincprule> 1</defaultprinter></printerconnections><sessionprintersrule>2</sessionprin tersrule><twaincompressionlevel>- 1</twaincompressionlevel><usetwaincompression>0</usetwaincompression></ses sionpolicy2></policy></policies> 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