visionapp Platform Management Suite visionapp Citrix Tool Farm Configuration Version 6.1 Technische Dokumentation
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_farmconfiguration_61_de II
Inhalt 1 Vorwort... 1 2 Einleitung... 2 2.1 Voraussetzungen...2 3 Hintergrund... 4 4 Systemvoraussetzung... 5 5 Funktionsweise... 6 6 Komponenten... 7 6.1 FCCon.exe...7 6.2 vctfc.dll...7 6.3 vctcommonlib.dll...7 6.4 vctresources.dll...7 6.5 vmfcom30.dll, vmfcom40.dll, vmfcommonlib.dll...7 7 Die Konsolenanwendung FCCon.exe... 8 7.1 Funktionen...8 7.1.1 Der Parameter /PFN:...8 7.1.2 Der Parameter /LFN:...9 7.1.3 Der Parameter /EFL...9 7.1.4 Der Parameter /ES... 10 7.1.5 Der Parameter /EFN:... 10 7.1.6 Der Parameter /DAC... 10 7.1.7 Der Parameter /?... 10 8 Die Parameterdatei... 11 9 Rückgabewerte/Fehlercodes... 12 vpms_vct_farmconfiguration_61_de III
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_farmconfiguration_61_de 1
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 nachfolgend aufgeführten Dokumentationen sinnvoll: visionapp Base Installation Packages Dokumentation visionapp Control Center Online-Hilfe 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_farmconfiguration_61_de 2
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_farmconfiguration_61_de 3
3 Hintergrund Die visionapp Citrix Tools (vct) sind eine Sammlung von verschiedenen Anwendungen die dazu dienen Citrix Presentation Server Aktionen, die normalerweise über die Citrix Presentation Server Konsole ausgeführt werden, zu automatisieren. Die visionapp Farm Configuration Komponente ist Teil der vct-komponenten. Durch den Einsatz der visionapp Farm Configuration Komponente wird die Konfiguration der Citrix Presentation Farm zu einem vollautomatischen Prozess, der in die Installationsroutine eingefügt werden kann und somit Teil des gesamten automatischen Installationsprozesses wird. Hierdurch ergibt sich bei der Neuinstallation einer Citrix Presentation Server Farm eine vollständig installierte und fertig konfigurierte Citrix Presentation Server Farm. Abbildung 1: Managementkonsole für MetaFrame Server 4.0 vpms_vct_farmconfiguration_61_de 4
4 Systemvoraussetzung Grundvoraussetzung für den Einsatz des visionapp Citrix Tools Farm Configuration (vctfc) 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: Citrix MetaFrame Presentation Server 3.0 oder Citrix Presentation Server 4.0 Microsoft.NET Framework 1.1 visionapp Control Center 2006 vpms_vct_farmconfiguration_61_de 5
5 Funktionsweise Die vctfc wurde entwickelt, um während einer unbeaufsichtigten Installation nach der Citrix Farminstallation Citrix weitere farmspezifische Konfigurationen anzugeben und zu setzen. Die Parameter werden aus einer Konfigurationsdatei ausgelesen und über die MFCOM Schnittstelle in den Citrix Presentation Server Farm eingetragen. Zur Kontrolle wird im gleichen Verzeichnis eine Protokolldatei erstellt. Die Parameter werden über wenige Schritte in der visionapp Control Center (vcc) Oberfläche vorbereitet. Der vcc bietet die Möglichkeit zur grafisch-interaktiven Voreinstellung der Citrix-Parameter, bevor die Installation gestartet wird. Dieser ist mit verantwortlich für die Übertragung dieser Einstellungen auf den Zielserver. Daher ist sehr wenig Betriebsaufwand bei jedem Release- oder Rollenwechsel von Servern oder ganzen Farmen notwendig. 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_farmconfiguration_61_de 6
6 Komponenten Das vctfc setzt sich aus den in den nachfolgenden Abschnitten beschriebenen Komponenten zusammen: 6.1 FCCon.exe Mit der Anwendung FCCon.exe (Farm Configuration Console) wird die komplette FC- Funktionalität ausgeführt. 6.2 vctfc.dll Die Datei vctfc.dll ist eine Funktionsbibliothek, welche die Programmlogik von FC enthält. 6.3 vctcommonlib.dll Die Datei vctcommonlib.dll ist eine Funktionsbibliothek, die alle Citrix bezogenen Funktionen für Citrix 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 Framework 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_farmconfiguration_61_de 7
7 Die Konsolenanwendung FCCon.exe Die Ausführung der kompletten FC-Funktionalität erfolgt über die Anwendung FCCon.exe, die es ermöglicht sämtliche Funktionen unbeaufsichtigt auszuführen. 7.1 Funktionen Zur unbeaufsichtigten Ausführung von vctfc verfügt FCCon.exe über verschiedene Kommandozeilenparameter. Es wird eine Beschreibung der möglichen Kommandozeilenparameter angezeigt, wenn FCCon.exe mit dem Kommandozeilenparameter /? aufgerufen wird. FCCon.exe [/PFN:] [/LFN:] [/EFL] [/ES] [/EFN:] [/DAC] [/?] /PFN: ParameterFileName /LFN: LogFileName /EFL EnableFileLogging /ES ExportSettings /EFN: ExportFileName /DAC DisableAccessCheck /? Help Abbildung 2: FCCon.exe Online-Hilfe 7.1.1 Der Parameter /PFN: Der Parameter /PFN (ParameterFileName) dient dazu eine bestimmte Parameterdatei einschließlich Pfad anzugeben. Dieser Parameter überschreibt die Standardeinstellung %Anwendungsverzeichnis%\vsionapp.xml. vpms_vct_farmconfiguration_61_de 8
7.1.2 Der Parameter /LFN: Der Parameter /LFN (LogFileName) dient dazu eine bestimmte Protokolldatei anzugeben, in welche die durch FC ausgeführten Aktionen protokolliert werden. Dieser Parameter kann nur zusammen mit dem Parameter /EFL angegeben werden. 7.1.3 Der Parameter /EFL Der Parameter /EFL (EnableFileLogging) dient dazu die Protokollierung in einer Protokolldatei zu aktivieren. Für den Fall, dass dieser Parameter nicht angegeben wird, wird keine Protokolldatei erstellt. Ohne Angabe des Parameters /LFN: wird die Standardprotokolldatei %Anwendungsverzeichnis%\FC.log erstellt. 12/27/2005 2:10:20 PM:511 FCCon - Farm Configuration Console 12/27/2005 2:10:20 PM:511 FC started 12/27/2005 2:10:20 PM:995 Reading input parameter file... 12/27/2005 2:10:21 PM:229 Configuration of category "ICA Keep-Alive" started 12/27/2005 2:10:21 PM:307 Configuration of "Enable ICA Keep-Alive" to "1"... 12/27/2005 2:10:21 PM:916 "Enable ICA Keep-Alive" has been successfully configured to "1" 12/27/2005 2:10:21 PM:916 Configuration of "ICA Keep-Alive Time-out value (in seconds)" to "60"... 12/27/2005 2:10:21 PM:916 "ICA Keep-Alive Time-out value (in seconds)" has been successfully configured to "60" 12/27/2005 2:10:21 PM:916 Category "ICA Keep-Alive" has been successfully configured 12/27/2005 2:10:21 PM:916 Configuration of category "ICA Settings" started 12/27/2005 2:10:21 PM:931 Configuration of "Discard redundant graphics operations" to "1"... 12/27/2005 2:10:21 PM:931 "Discard redundant graphics operations" has been successfully configured to "1"... Abbildung 3: Standardprotokolldatei %Anwendungsverzeichnis%\FC.log vpms_vct_farmconfiguration_61_de 9
7.1.4 Der Parameter /ES Der Parameter /ES (ExportSettings) dient dazu die Farmeinstellungen in eine Datei zu exportieren. Ohne Angabe des Parameters /EFN: wird die Exportdatei %Anwendungsverzeichnis%\FC.xml erstellt. 7.1.5 Der Parameter /EFN: Der Parameter /EFN: (ExportFileName) dient dazu eine bestimmte Exportdatei anzugeben, in welche die Farmeinstellungen exportiert werden. Dieser Parameter kann nur zusammen mit dem Parameter /EFS angegeben werden. 7.1.6 Der Parameter /DAC Der Parameter /DAC (DisableAccessCheck) dient dazu die automatische Prüfung der Zugriffsrechte beim Start der Anwendung zu deaktivieren. Dies kann beispielsweise bei der Ausführung über einen AT-Job sinnvoll sein. 7.1.7 Der Parameter /? Der Parameter /? zeigt die oben genannte Onlinehilfe an. vpms_vct_farmconfiguration_61_de 10
8 Die Parameterdatei Die Datei visionapp.xml ist die Konfigurationsdatei, die alle Informationen enthält, die vctfc zum Konfigurieren der Farmeinstellungen benötigt. Die Konfigurationsdatei wird ohne explizite Angabe eines anderen Pfades/Dateinamens im gleichen Verzeichnis wie die Programmdatei FCCon.exe und mit dem Namen visionapp.xml erwartet. Die Konfigurationsdatei wird automatisch beim Starten des visionapp Package Parameter Transfer (PPT) erstellt. Dabei werden die Informationen aus der visionapp Control Center Datenbank gelesen und in die visionapp.xml Datei geschrieben. Da die Parameter über den visionapp Control Center vorkonfiguriert werden, ist eine Beschreibung der möglichen Parameter in der visionapp Control Center Online-Hilfe hinterlegt. Die zahlreichen Parameter sind abhängig von der eingesetzten Version, zur Zeit Citrix Metaframe Presentation Server 3.0 und Citrix Presentation Server 4.0, und der Edition: Standard, Advanced und Enterprise. vpms_vct_farmconfiguration_61_de 11
9 Rückgabewerte/Fehlercodes Folgende Rückgabewerte (Return Codes) können nach Ausführung der Anwendung zurückgeliefert werden: Wert Bedeutung 0 AAPCon wurde erfolgreich durchlaufen. 1 Die Parameterdatei wurde nicht gefunden. 2 Der Lizenzschlüssel konnte nicht gefunden werden oder ist ungültig. 3 Der ausführenden Benutzer ist kein Farmadministrator. 4 Es ist ein Fehler beim Exportieren aufgetreten. 5 Ein Parameter fehlt. 200 Fehler beim Schreiben der Farm Parameter 201 Fehler beim Schreiben der ConnectionAccessControl Parameter 202 Fehler beim Schreiben der ConnectionLimits Parameter 203 Fehler beim Schreiben der ICAKeepAlive Parameter 204 Fehler beim Schreiben der ICASettings Parameter 205 Fehler beim Schreiben der MemoryCPUOptimization Parameter 206 Fehler beim Schreiben der MFAdministration Parameter 207 Fehler beim Schreiben der MFSettings Parameter 208 Fehler beim Schreiben der Printerdrivers Parameter 209 Fehler beim Schreiben der SessionReliability Parameter 210 Fehler beim Schreiben der SNMP Parameter 211 Fehler beim Schreiben der SpeedScreen Parameter 212 Fehler beim Schreiben der Zonen Parameter 1000 Unbekannter Fehler vpms_vct_farmconfiguration_61_de 12