visionapp Platform Management Suite Package Parameter Transfer Version 5.1.0.11 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_packageparametertransfer_51_de II
Inhalt 1 Vorwort...1 2 Einleitung...2 2.1 Voraussetzungen...2 3 Hintergrund...4 4 Systemvoraussetzungen...5 5 Funktionsweise...6 6 Die Anwendung PPT.exe...8 6.1 Der Parameter /CreateDSDB oder /CreateVAPDB...8 6.2 Der Parameter /ResetWaitForDSDB oder /ResetWaitForVAPBDB...8 7 Beschreibung der Konfigurationsparameter...9 7.1 Der Parameter DBSERVER...9 7.2 Der Parameter DBNAME...9 7.3 Der Parameter LOGFILE (Optional)... 10 7.4 Der Parameter OUTPUTFILE (Optional)... 10 7.5 Der Parameter HOSTNAME (Optional)... 11 7.6 Der Parameter DBUSER / DBPASSWORD (Optional)... 11 8 Return-Codes...12 vpms_packageparametertransfer_51_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_packageparametertransfer_51_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 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_packageparametertransfer_51_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_packageparametertransfer_51_de 3
3 Hintergrund Package Parameter Transfer (PPT) wurde entwickelt um eine zentrale Schnittstelle zur visionapp Control Center-Datenbank (vcc-datenbank) zu schaffen, welche alle benötigten Variablen für die Installation eines Servers ermittelt. Dadurch wird zum einen der Netzwerkverkehr gering gehalten und zum anderen musste nicht jedes Installationspaket, das Informationen aus der vcc-datenbank benötigt, mit Zugriffsfunktionen und entsprechenden Berechtigungen auf die vcc-datenbank ausgestattet werden. Da PPT in der Regel einmalig ausgeführt wird muss die vcc-datenbank nicht ständig erreichbar sein. vpms_packageparametertransfer_51_de 4
4 Systemvoraussetzungen Grundvoraussetzung für den Einsatz von visionapp Package Parameter Transfer ist zunächst eines der folgenden Betriebssysteme in englischer oder deutscher Sprache: Microsoft Windows 2000 Server mit Service Pack 4 oder höher Microsoft Windows 2000 Advanced Server mit Service Pack 4 oder höher Microsoft Windows Server 2003, Standard Edition mit Service Pack 1 oder höher Microsoft Windows Server 2003, Enterprise Edition 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: MDAC 2.7 SP1 oder höher Microsoft.NET Framework 1.1 SQL Server 2000 ab SP 3 visionapp Control Center 2006 vpms_packageparametertransfer_51_de 5
5 Funktionsweise vppt liest alle Farm- und Server-Variablen für den zu installierenden Server aus der visionapp Control Center Datenbank (vcc-datenbank) und schreibt diese in die Installationsparameterdatei auf dem zu installierenden Server. Zu diesen Informationen gehören unter anderem: Ermitteln der Farm-, Zonen- und Server-ID Ermitteln des Farm- und Zonen-Namens Ermitteln der Farm-Variablen (Citrix Presentation Server-Parameter oder visionapp Installation Packages-Parameter) Ermitteln der Server-Variablen (Citrix Presentation Server-Parameter oder visionapp Installation Packages-Parameter) Ermitteln aller zusätzlichen Variablen auf Farm-, Zonen- und Server-Ebene Ermitteln des Freigabenamens des Protokollverzeichnisses aus der vcc-datenbank Weiterhin werden folgende zusätzliche Informationen in die Installationsparameterdatei geschrieben: Schreiben des verschlüsselten Hash-Wertes für die Citrix-Tools Ermitteln der Security Identifiers (SIDs) aller lokalen Benutzer und Domänenbenutzer PPT schreibt außerdem folgende Informationen für den entsprechenden Server in die vcc-datenbank: Anzahl der CPUs Full Qualified Domain Name (FQDN) MAC-Adresse IP-Adresse Zusätzlich legt PPT einen Schlüssel HKLM\SOFTWARE\visionapp in die Registrierung auf dem zu installierenden Server an, in welchem der Pfad der Installationsparameterdatei festgelegt wird. Der Pfad dieser Datei setzt sich aus den Variablen %ProgramFiles% und Release Herstellername zusammen, welcher in der Datenbank des Control Centers hinterlegt ist. vpms_packageparametertransfer_51_de 6
Neben dem Ermitteln der Installationsparameter aus der Control Center Datenbank, werden weitere Parameter des Zielsystems ermittelt und ebenfalls in der Installationsparameterdatei abgelegt. Hier sind die Version, die Sprache des Betriebssystems und die SID s für die Gruppen- und Benutzernamenzuordnung zu nennen. Zusätzlich wird für die visionapp Citrix-Tools (vct) eine XML-Datei mit allen Farm- und Server-Variablen (Citrix Presentation Server- Parameter) erstellt und auf den zu installierenden Server abgelegt. 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 Resource-CD unter: <CD>:\Installation\Toolbox\visionapp_Toolbox.msi. Die Installation mit einem Doppelklick auf die Datei visionapp_toolbox.msi gestartet. vpms_packageparametertransfer_51_de 7
6 Die Anwendung PPT.exe Die Anwendung PPT.exe wird durch Aufruf eines Kommandozeilenbefehls mit dem Namen der ini-datei als Kommandozeilenparameter ausgeführt. Diese INI-Datei muss nicht zwingend angegeben werden. Wird PPT ohne Angabe einer INI-Datei gestartet, setzt das Programm voraus, dass im gleichen Verzeichnis wie die EXE-Datei eine INI- Datei namens PPT.ini vorhanden ist. Aufruf : C:\temp\PPT.exe C:\temp\PPT.ini Ohne die INI-Datei ist PPT nicht lauffähig. Die folgenden zwei Kommandozeilenparameter werden vom Citrix Presentation Server- Installationspaket in Verbindung mit der Control Center Einstellung Data Store erstellen oder vom VAP-Installationspaket zum Anlegen der VAP-Datenbank verwendet. 6.1 Der Parameter /CreateDSDB oder /CreateVAPDB PPT liest den Wert CMF_CREATE_DS (bzw. VAP_CREATE_PORTAL_DB) der entsprechenden Farm, in der sich der Server befindet aus und erstellt entweder die Datenbank für das entsprechende Paket (wenn Wert = 2 oder 3) oder wartet solange, bis der Wert von CMF_WAIT_FOR_DS (bzw. VAP_WAIT_FOR_DB ) auf 0 gesetzt wird. Dabei werden die Farmparameter einmal pro Minute überprüft. Nach 15 Minuten wird der Vorgang automatisch abgebrochen. 6.2 Der Parameter /ResetWaitForDSDB oder /ResetWaitForVAPBDB PPT setzt den Wert CMF_WAIT_FOR_DS (bzw. VAP_WAIT_FOR_DB) der entsprechenden Farm, in der sich der Server befindet auf 0 zurück. vpms_packageparametertransfer_51_de 8
7 Beschreibung der Konfigurationsparameter In diesem Kapitel werden die Parameter beschrieben, die in der INI-Datei angegeben werden können. Die benötigte INI-Datei verfügt über Format und Parameter wie in der folgenden Abbildung dargestellt: [CONFIG] DBSERVER = 10.1.1.150 DBNAME = VCC_DATABASE LOGFILE = C:\TEMP\PPT.LOG OUTPUTFILE = C:\TEMP\OUTPUT.INI HOSTNAME = SERVER01 DBUSER = sa DBPASSWORD = ******** Abbildung 1: Beispielhafte PPT.INI Konfigurationsdatei 7.1 Der Parameter DBSERVER Durch den Wert des Parameters DBSERVER wird der SQL-Server auf dem die vcc Datenbank installiert ist angegeben. 7.2 Der Parameter DBNAME Durch den Wert des Parameters DBNAME wird der Datenbankname des vcc angegeben. vpms_packageparametertransfer_51_de 9
7.3 Der Parameter LOGFILE (Optional) Durch den Wert des Parameters LOGFILE kann ein Pfad inklusive Dateiname angegeben werden, in welche die Aktionen von PPT protokolliert werden. Wird dieser Wert nicht gefüllt, wird keine Log-Datei erstellt. 16.11.2005 16:48:51:738 ***************************************************** 16.11.2005 16:48:51:738 S - Parameter found : LOGFILE : C:\TEMP\PPT.LOG 16.11.2005 16:48:51:738 S - Parameter found : DBSERVER : 10.1.1.150 16.11.2005 16:48:51:738 S - Parameter found : DBNAME : VCC_DATABASE 16.11.2005 16:48:51:738 S - Parameter found : C:\TEMP\OUTPUT.INI 16.11.2005 16:48:51:738 S - Parameter found : SERVER01 16.11.2005 16:48:51:738 S - Parameter found : DBUSER : sa 16.11.2005 16:48:51:753 S - Parameter found : DBPASSWORD : ******** 16.11.2005 16:48:52:097 S - outputfile created 16.11.2005 16:48:52:113 S - Write Value : CMF_ACCESS_CONDITION : 1 16.11.2005 16:48:52:113 S - Write Value : CMF_ADD_LOCAL : Abbildung 2: Beispielhafte PPT.LOG Protokolldatei 7.4 Der Parameter OUTPUTFILE (Optional) Durch den Wert des Parameters OUTPUTFILE wird der Pfad inklusive Dateiname angegeben, in welche PPT die ausgelesenen Werte exportiert. [INSTALLATION] INS_INST_LOG_PATH=C:\Program Files\visionapp\Log [CITRIX METAFRAME] CMF_ACCESS_CONDITION=1 [RELEASEINFO] REL_MANUFACTURER_NAME=visionapp [SYSTEM] SYS_AUTOREBOOT_DAY=0 [TERMINAL SERVICES] WTS_RDP_AUTO_CLIENT_DRIVES=1 [CUSTOM] Paramter=test [VCC] VCC_DB_SERVER=10.1.1.150 [SECURITY IDENTIFIERS] S-1-5-32-544=Administrators Abbildung 3: Beispielhafte VISIONAPP.INI Konfigurationsdatei vpms_packageparametertransfer_51_de 10
7.5 Der Parameter HOSTNAME (Optional) Durch den Parameter HOSTNAME kann der Server angegeben werden, für den die Informationen aus der vcc Datenbank gelesen werden. Wird kein Servername angegeben, so wird automatisch der Computername verwendet auf dem PPT ausgeführt wird. 7.6 Der Parameter DBUSER / DBPASSWORD (Optional) Durch die Parameter DBUSER und DBPASSWORD kann ein interner SQL-Benutzer mit Passwort angegeben werden, mit dem der Zugriff auf vcc Datenbank stattfindet. Wird kein Benutzer angegeben, so wird das Benutzerkonto verwendet, mit dem PPT ausgeführt wurde. Das angegebene Passwort muss allerdings visionapp Secure IT (vsit) verschlüsselt sein. vpms_packageparametertransfer_51_de 11
8 Return-Codes Folgende Return-Codes können nach Ausführung von PPT zurückgeliefert werden: 11 : Es konnte keine INI-Datei gefunden werden. 20 : Es konnte kein SQL-Server in der INI-Datei gefunden werden. 21 : Es konnte keine Datenbank in der INI-Datei gefunden werden. 25 : Es konnte keine Farm- oder Server-ID ermittelt werden. 26 : Fehler beim Ermitteln der Server-Variablen 27 : Fehler beim Ermitteln der Farm-Variablen 28 : Fehler beim Schreiben der globalen Variablen 29 : Fehler beim Updaten der Farm-Eigenschaft CREATE_DS 31 : Fehler beim Ermitteln der vip-farm-variablen 32 : Fehler beim Ermitteln der vcc Konfigurationsparameter 40 : Fehler beim Schreiben des WAIT_FOR_DS -Flags 41 : Fehler beim WAIT_FOR_DS 42 : Fehler beim Schreiben einer Farm-Eigenschaft 50 : Maximale Zeit von 15 Minuten beim WAIT_FOR_DS ist erreicht. vpms_packageparametertransfer_51_de 12