enteo NetInstall mit vSM - Visionapp

enteo NetInstall 

im Einsatz mit 

visionapp Server Management 

Version 2008 

Technische Dokumentation 

www.visionapp.com enteo NetInstall

Inhalt 

Inhalt 

1 Vorwort...............................................................................................................1 

2 Weitergabe und Gewährleistung..........................................................................1 

3 Technischer Support............................................................................................1 

3.1 visionapp Webseite .........................................................................................1 

3.2 E-Mail ...........................................................................................................2 

4 Über visionapp ....................................................................................................3 

5 Über diese Dokumentation ..................................................................................4 

5.1 Vorkenntnisse ................................................................................................4 

5.2 Formate und Symbole .....................................................................................4 

6 enteo NetInstall für vSM 2008 .............................................................................6 

6.1 Überblick .......................................................................................................6 

6.2 Systemvoraussetzungen für enteo NetInstall ......................................................6 

6.3 Funktionsweise...............................................................................................6 

6.3.1 Einleitung ..........................................................................................6 

6.3.2 enteo NetInstall-Voraussetzungen .........................................................6 

6.3.3 enteo NetInstall-Komponentenübersicht.................................................7 

6.3.4 enteo NetInstall-Organisations- und Site-Konfiguration ............................7 

6.3.5 enteo NetInstall-Sitezugehörigkeit konfigurieren .....................................8 

6.3.6 enteo NetInstall-Projektzuweisung ........................................................9 

6.3.7 enteo NetInstall-Dienstkonto für die Dienstinstallation konfigurieren ........ 11 

6.3.8 enteo NetInstall-Dienstkonto für SQL-Serverzugriff konfigurieren ............ 12 

6.3.9 enteo NetInstall-Protokollierung und vADM-Reporting konfigurieren ......... 13 

6.3.10 Integration der vSM-NetInstall-Datenbanken ........................................ 14 

6.3.10.1 Informationen zum vSM-Datenbankaufbau ........................... 14 

6.3.10.2 Informationen zum Importieren der vSM-Datenbanken........... 15 

6.3.10.3 Erzeugen der vSM-NetInstall-Datenbanken ........................... 16 

6.3.10.4 Einspielen der vSM-Datenbanken......................................... 16 

6.3.11 Einspielen der vBIP-Pakete mittels PackageSync ................................... 17 

6.3.12 Einspielen von optionalen vAIP Paketen ............................................... 19 

6.3.13 Berechtigen der enteo NetInstall-Datenbanken und Pakete ..................... 23 

6.3.13.1 Berechtigen der Datenbanken ............................................. 24 

6.3.13.2 Berechtigen der Ordner ...................................................... 24 

www.visionapp.com I

Inhalt 

6.3.13.3 Berechtigung der Projekte .................................................. 25 

6.3.13.4 Zeitplanung der Projekte .................................................... 26 

6.3.13.5 Berechtigen der Serverspezifikationen.................................. 26 

6.3.13.6 Zeitplanung der Serverspezifikationen.................................. 27 

6.3.13.7 Berechtigen der PostInstall Projekte..................................... 28 

6.3.13.8 Zeitplanung der PostInstall-Projekte .................................... 29 

6.3.13.9 Freigabe der PostInstall-Projekte ......................................... 30 

6.4 Funktionsbeschreibug der Teilkomponenten ..................................................... 31 

6.4.1 Funktionsweise des vADM-NetInstall-Moduls......................................... 31 

6.4.2 Funktionsweise der Installationsprojekte .............................................. 31 

6.4.3 Funktionsweise der Serverspezifikationsprojekte ................................... 32 

6.4.4 Funktionsweise der Installationsskriptprojekte ...................................... 34 

6.4.5 Funktionsweise der PostInstall-Skript-Projekte ...................................... 35 

6.4.6 Funktionsweise der ereignisorientierten Skripte..................................... 36 

6.4.6.1 $OnStartScript .................................................................. 36 

6.4.6.2 $OnEndScriptDone ............................................................ 36 

6.4.6.3 $OnEndScriptTerminated.................................................... 36 

6.4.7 Funktionsweise der Variablenskript-Projekte ......................................... 37 

6.4.8 Funktionsweise des NI-SCRIPT-ABORTED Projekts................................. 38 

6.4.9 Funktionsweise des NI-PACKAGE-EXEC Projektes .................................. 39 

6.4.10 Funktionsweise des NI-GLOBAL-APP-CFG Projektes ............................... 39 

www.visionapp.com II

Vorwort 

1 Vorwort 

Vielen Dank, dass Sie sich für ein Produkt der visionapp GmbH entschieden haben. Die visionapp 

Application Delivery Management Suite wird intensiven Qualitätstests unterzogen. Kein 

Produkt verlässt unser Haus ohne sorgfältige Tests unserer Qualitätssicherung. 

Diese Dokumentation 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 zu minimieren. 

Die visionapp GmbH begrüßt ausdrücklich Ihre Kommentare zu dieser Beschreibung. Sollten 

sie Fragen oder Verbesserungsvorschläge zur Software selbst oder zur Dokumentation haben, 

so finden Sie auf unserer Website weitere Hinweise sowie die neueste Dokumentation: 

http://www.visionapp.com/support 

2 Weitergabe und Gewährleistung 

Die in diesem Dokument enthaltenen Informationen, Konzepte und Ideen sind Eigentum der 

visionapp GmbH. Eine Weitergabe, auch in Auszügen, ohne die Zustimmung der visionapp 

GmbH ist nicht gestattet und führt in jedem Falle zu rechtlichen Konsequenzen. 

Alle in diesem Dokument erwähnten Marken- und Produktnamen sind Warenzeichen der jeweiligen 

Rechteinhaber und werden hiermit anerkannt. 

Alle Produktbeschreibungen haben lediglich allgemeinen und beschreibenden Charakter und 

sind nicht als Zusicherung bestimmter Eigenschaften oder als Gewährleistungs- oder Garantieerklärung 

zu verstehen. visionapp übernimmt keine ausdrückliche oder stillschweigende 

Gewähr für Dokumentation. 

Alle Rechte vorbehalten ©visionapp GmbH Dezember 2007 

3 Technischer Support 

Die visionapp Application Delivery Management Suite (vADM) wird entwickelt von der visionapp 

GmbH. Technischer Support ist über die visionapp Webseite und über E-Mail verfügbar. 

3.1 visionapp Webseite 

Die visionapp Webseite www.visionapp.com bietet zahlreiche Informationen und Downloads: 

> Informationen zu neuen Produkten 

> Produktaktualisierungen und -updates 

> Whitepapers und Präsentationen 

Die jeweile aktuelle Produktversion und die dazugehörige Dokumentation finden Sie unter 

www.visionapp.com/download-center. 

Vorwort www.visionapp.com 1

Technischer Support 

3.2 E-Mail 

Für technischen Support via E-Mail kontaktieren sie uns über: 

support@visionapp.com 

Um uns einen effizienten und schnellen Support zu ermöglichen, senden Sie uns zusammen 

mit Ihrer Anfrage die folgenden Informationen: 

> Eingesetzte Version der visionapp Application Delivery Management Suite. 

> Verwendete Edition des visionapp Workspace Management und visionapp Server Management. 

> Name, Version und Sprache des Client-Betriebssystems Ihrer vADM-Konsole. 

> Name, Version und Sprache des Datenbankservers Ihrer vADM-Datenbank. 

> Version, Service Pack und Sprache des Microsoft SQL-Servers Ihrer vADM-Datenbank. 

> Eine genaue Beschreibung des Problems einschließlich der Meldungen. 

> Protokolle aus dem Eventlog der betroffenen Server. 

> Zur weiteren Unterstüztung alle relevanten Screenshots. 

Beim Einsatz von visionapp Server Management 

> Genauere Angaben über die Zielplattform der zu verwaltenden und zu installierenden Server. 

> Eine komplette Kopie als ZIP-Datei des visionapp-Ordners von der Zielplattform. Sie finden 

den Ordner unter %ProgramFiles% (Programme oder Program files). Wenn das Verzeichnis 

zu groß zum Versenden ist, dann benötigen wir min. folgende Dateien bzw. Ordner: 

> %ProgramFiles%\visionapp\visionapp.ini 

> %ProgramFiles%\visionapp\visionapp.xml 

> %ProgramFiles%\visionapp\ICS\ICS.ini 

> %ProgramFiles%\visionapp\ICS\Install.log 

> %ProgramFiles%\visionapp\ICS\Log 

> %ProgramFiles%\visionapp\Log\visionapp.log 

> Wenn das visionapp-Verzeichnis noch nicht existiert, dann sollte die im Root-Verzeichnis 

(c:\) vorhandene vTT.log mitgesendet werden. 

Beim Einsatz von visionapp Workspace Management 

> Name, Version und Sprache der eingesetzten Webserver. 

> Name, Version und Sprache der eingesetzten Datenbank ihrer vAC-Datenbank. 

> Version, Service Pack und Sprache des Microsoft SQL-Servers Ihrer vAC-Datenbank. 

> Name, Version und Sprache der eingesetzten Anwendungsserver. 

> Name und Version der Internet Browser. 

> Die Exportdateien von visionapp.config, web.config und Konfigurationsdaten (alles aus 

der vADM-Konsole unter Basiseinstellungen exportieren). 

Technischer Support www.visionapp.com 2

Über visionapp 

4 Über visionapp 

Die visionapp GmbH ist spezialisiert auf die Planung, Implementierung und den Betrieb von 

serverbasierten Infrastruktur- und Portal-Lösungen auf Basis von Microsoft- und Citrix-Technologien. 

Das Unternehmen verfügt über im Markt derzeit einzigartige Produkte und Dienstleistungen, 

die es ermöglichen, Windows Terminal Server-Infrastruktur zu optimieren und 

kosteneffizienter zu administrieren. Im Mittelpunkt steht die visionapp Application Delivery 

Management Suite mit dem visionapp Server Management und dem visionapp Workspace 

Management sowie Consulting- und ASP-Dienstleistungen. 

Das Lösungsangebot ist auf die Bedürfnisse großer und mittelständischer Unternehmen aus 

den Bereichen Finanzdienstleistung, Industrie, Handel und öffentliche Verwaltungen zugeschnitten. 

Weitere Informationen 

visionapp GmbH 

Head Office Frankfurt 

Helfmann-Park 2 

65760 Eschborn 

web: www.visionapp.com 

Über visionapp www.visionapp.com 3

Über diese Dokumentation 

5 Über diese Dokumentation 

5.1 Vorkenntnisse 

Voraussetzung für ein erfolgreiches Arbeiten mit der vorliegenden Dokumentation 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 Anwendungen ist von Vorteil. 

Weiterhin richtet sich diese Dokumentation 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 Installation Packages Dokumentation 

> vADM Online-Hilfe 

> visionapp PackageSync Dokumentation 

> visionapp Separated Package Manager Dokumentation 

> visionapp Wise to NetInstall Wizard Dokumentation 

> enteo NetInstall Online-Hilfe 

Falls Sie ein Problem mit den vorhandenen Informationen nicht beheben können, finden Sie 

auf unserer Website weitere Hinweise zur Lösung von Problemen. 

5.2 Formate und Symbole 

Für die verschiedenen Anweisungen werden folgende Formate verwendet: 

fett 

Menünamen und -einträge, Namen von Fenstern, Eingabe- und Listenfeldern, 

Meldungen sowie wichtige Aussagen sind fett gedruckt. 

kursiv Eingaben, die Sie als Administrator vornehmen müssen, sind kursiv. 

Festbreite Programmcode, Pfade und Dateinamen stehen in Festbreitenschrift. 

Links 

Bei unterstrichenem, rot eingefärbten Text handelt es sich um einen 

Hyperlink. 

Folgende Symbole werden verwendet: 

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. 

Über diese Dokumentation www.visionapp.com 4

Über diese Dokumentation 

Die Erste-Hilfe-Box weist auf Hilfestellungen zu einem bestimmten Problem hin, 

gibt Tipps zu Besonderheiten oder verrät ungewöhnliche Lösungen. 

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. 

Über diese Dokumentation www.visionapp.com 5

enteo NetInstall für vSM 2008 

6 enteo NetInstall für vSM 2008 

6.1 Überblick 

Das enteo NetInstall-Modul innerhalb der vADM-Konsole liefert die grundlegenden Funktionalitäten 

zur Verteilung von Anwendungssoftware auf Serversystemen unter Verwendung der 

Software enteo NetInstall. 

Um die Verteilung von Anwendungssoftwarepaketen mit enteo NetInstall aus der vADM-Konsole 

heraus durchführen zu können, wird eine existierende enteo NetInstall-Infrastruktur 

benötigt. Zusätzlich werden mit dem visionapp Server Management (vSM) vorbereitete enteo 

NetInstall-Datenbanken und die von enteo als Projekte bezeichneten Pakete mit ausgeliefert. 

Diese Datenbanken und Projekte ersparen viele aufwändige Schritte. 

Die vorbereiteten enteo NetInstall-Datenbanken und Projekte beinhalten den vollen Umfang 

der visionapp Base Installation Packages (vBIP). Innerhalb der Datenbanken befinden sich so 

genannte Serverspezifikationsprojekte, welche die Installation der Projekte für die unterschiedlichen 

Farm- und Servertypen innerhalb von enteo NetInstall steuern. 

6.2 Systemvoraussetzungen für enteo NetInstall 

Grundvoraussetzung für den Einsatz ist zunächst eines der folgenden Betriebssysteme in englischer 

oder deutscher Sprache: 

> Microsoft Windows 2000 Server mit Service Pack 4. 

> Microsoft Windows 2000 Advanced Server mit Service Pack 4. 

> 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. 

Weitere Informationen hierzu entnehmen Sie bitte der Herstellerdokumentation. 

6.3 Funktionsweise 

6.3.1 Einleitung 

In diesem Dokument wird davon ausgegangen, dass in der Umgebung bereits ein enteo 

NetInstall-Server installiert und konfigurieret wurde und entsprechende Erfahrungen im 

Umgang mit enteo NetInstall vorhanden sind. Daher werden in diesem Dokument lediglich die 

wesentlichen Schritte des Zusammenspiels von enteo NetInstall und dem visionapp Server 

Management (vSM) und der vADM-Konsole behandelt. 

6.3.2 enteo NetInstall-Voraussetzungen 

Das visionapp Server Management 2008 (vSM) und die vADM-Konsole 2008 unterstützen 

enteo NetInstall in folgenden Versionen: 

> enteo NetInstall 5.7 Enterprise Edition 

> enteo NetInstall 5.8 

enteo NetInstall für vSM 2008 www.visionapp.com 6


enteo NetInstall 5.7 Standard wird nicht unterstützt. Ab enteo NetInstall 5.8 

gibt es keine Unterscheidung mehr zwischen Standard- und Enterprise-Edition. 

6.3.3 enteo NetInstall-Komponentenübersicht 

vSM 2008 für enteo NetInstall besteht neben den Kernkomponenten vSM und vADM-Konsole 

aus folgenden enteo NetInstall-spezifischen Erweiterungen und Komponenten: 

> vADM-Konsole enteo NetInstall-Modul 

> vADM-Konsole enteo OSD-Modul 

> visionapp NetInstall-Datenbanken (visionapp Based Installation Packages Paketumfang) 

> visionapp Preparation Tools (speziell visionapp PackageSync und visionapp 

Wise2NetInstall-Assistent) 

6.3.4 enteo NetInstall-Organisations- und Site-Konfiguration 

Bei der Verwendung von vSM 2008 in Verbindung mit enteo NetInstall werden die folgenden 

enteo NetInstall-Konfigurationseinstellungen abweichend von den enteo Standardwerten empfohlen: 

Sektion Parameter Wert 

AutoInstall-Einstellungen 

Installationseinstellungen 

AutoInstall auf NT-Servern 

erlauben 

Bei Timeout maximal warten 

(sek.) 

Protokolldatei-Einstellungen Lokaler Pfad für Protokolldatei 

Protokolldatei-Einstellungen Protokolldateien fortführen Ja b 

Protokolldatei-Einstellungen 

Protokolldatei-Einstellungen 

Organisationseigenschaften 

Organisationseigenschaften 

Detaillierungsgrad der lokalen 

Protokolldateien 

Maximale Größe der Protokolldatei 

(KB) 

Windows Terminal Server- 

Unterstützung aktivieren 

WTS Unterstützung nur auf 

Terminal Servern im Application 

Mode verwenden 

enteo NetInstall für vSM 2008 www.visionapp.com 7 

Ja 

10000 a 

%ProgramFiles%\visionapp\Log\NetInstall 

Detailliert (Debug) 

20000 

Ja 

Ja


Sektion Parameter Wert 


Einstellungen 


Einstellungen 

Service-Einstellungen 

Installationszeitfenster 

Benutzer zu Beginn des 

Installationszeitfensters 

abmelden 

Verzögerung beim Starten 

[sek] 

6.3.5 enteo NetInstall-Sitezugehörigkeit konfigurieren 

Benutzerdefiniert 

(Installation Erlauben 

24h x 7d) 

a. Bei diesem Wert handelt es sich um einen Wert, der gegebenenfalls in Abhängigkeit zu ihrer Umgebung individuell 

gesetzt werden muss. Der Wert 1000 ist lediglich ein Richtwert. Der Wert muss so gewählt werden, dass das am 

längsten laufende Installationspaket bis zum Ende ausgeführt werden kann ohne das NetInstall dieses vorzeitig beendet. 

b. Bei dieser Einstellung handelt es sich um eine Netinstall 5.7 Funktion. In enteo NetInstall 5.8 existiert diese Einstellung 

nicht. 

Die oben genannten Konfigurationseinstellungen können mit dem enteo NetInstall-Manager 

konfiguriert werden. Einige der enteo NetInstall-Konfigurationseinstellungen 

sind nur im Experten Modus sichtbar. Es empfiehlt sich daher, 

diesen während des Konfigurierens zu aktivieren. Die Kategorie Windows Terminal 

Server Einstellungen ist erst sichtbar, wenn in der Kategorie Organisationseigenschaften 

die Einstellung Windows Terminal Server- 

Unterstützung aktivieren entsprechend konfiguriert wurde und der enteo 

NetInstall-Manager einmal beendet und neu gestartet wurde. 

Die enteo NetInstall-Infrastruktur kann mittels Sites und Organisationseinheiten logisch und 

physikalisch strukturiert werden. Wie die jeweilige Umgebung diesbezüglich strukturiert wird, 

hängt von den individuellen Bedürfnissen ab. In Bezug auf vSM ist die Strukturierung in soweit 

relevant, als dass die Zielsysteme, welche mithilfe von vSM installiert werden sollen, Zugriff 

auf die entsprechende Site benötigen, um auf die enteo NetInstall-Datenbanken von vSM 

zugreifen zu können. 

Starten Sie dazu den enteo NetInstall-Manager und sperren Sie die Site-Konfiguration. Selektieren 

Sie die entsprechende Site und rufen Sie über das Kontextmenü den Menüpunkt Eigenschaften 

auf. Auf der Registerkarte Site-Definition ist mittels der Schaltfläche Neu das 

Hinterlegen der Bedingungen für die Site-Zugehörigkeit möglich. 

enteo NetInstall für vSM 2008 www.visionapp.com 8 

Ja 

30


Eigenschaften einer enteo NetInstall-Site: 

Bei den Bedingungen können Sie zwischen verschiedenen Merkmalen wie zum Beispiel der IP- 

Adresse oder dem Hostnamen wählen. Auch die Verwendung von Wildcards und Ausschlüssen 

ist möglich. Durch Übernehmen oder OK werden die Einstellungen gespeichert. Danach sollte 

die Site-Konfiguration wieder entsperrt werden. 

6.3.6 enteo NetInstall-Projektzuweisung 

Um aus der vADM-Konsole heraus steuern zu können, welche Zielsysteme auf welche enteo 

NetInstall-Projekte berechtigt sind, wird die enteo NetInstall-Maschinengruppenfunktion verwendet. 

Bevor diese verwendet werden kann, müssen einige vorbereitende Schritte sowohl auf 

dem enteo NetInstall-Server als auch innerhalb der vADM-Konsole durchgeführt werden. 

Für den Fall, dass auf dem enteo NetInstall-Server noch keine Maschinengruppen verwendet 

werden, legen Sie zuerst die Maschinengruppendatei an. Diese muss in den Unterordner 

Extern$ auf der NetInstall-Netzwerkfreigabe angelegt werden. Wenn der Ordner Extern$ noch 

nicht existiert, legen Sie ihn an. 

Bei der Maschinengruppendatei handelt es sich um die Datei xnimgrp.cfg, die im Ordner 

Extern$ ablegt wird. Bei dieser Maschinengruppendatei handelt es sich um eine simple Textdatei 

im INI-Format. 



Der folgende Teil zeigt die durch visionapp vorbereitete Maschinengruppendatei mit einigen 

beispielhaften Einträgen: 

[Available Machinegroups] 

060_CTX_APPLICATION_ALL_X=Citrix Presentation Server - Application 

060_CTX_PLATFORM_ALL_X=Citrix Presentation Server - Platform 

[060_CTX_APPLICATION_ALL_X] 

[060_CTX_PLATFORM_ALL_X] 

… 

Eine vorbereitete xnimgrp.cfg enteo NetInstall-Maschinengruppendefinitionsdatei 

wird mit vSM ausgeliefert. Die Datei für enteo NetInstall befindet sich auf 

der visionapp Produkt-CD unter: 

:\Installation\enteo NetInstall\Extern$\xnimgrp.cfg 

Diese kann direkt in eine enteo NetInstall-Umgebung kopiert werden. Innerhalb 

der vorbereiteten enteo NetInstall-Maschinengruppendefinitionsdatei befinden 

sich bereits alle enteo NetInstall-Maschinengruppen, die im späteren Verlauf der 

Konfiguration zum Berechtigen der unterschiedlichen Servertypen benötigt werden. 

Sollten Sie mehrere enteo NetInstall-Server in einer Struktur haben, sollte die 

Maschinengruppendatei auf Ihrem ersten Server innerhalb der Struktur (dem so 

genannten Org-Master) angelegt werden, damit die Datei von diesem auf die 

anderen Server repliziert wird. 

Damit die vADM-Konsole Zugriff auf die in enteo NetInstall hinterlegte Maschinengruppendatei 

erhält, muss der vollständige UNC-Pfad zur Datei in der vADM-Konsole hinterlegt werden. 



Hierzu wird die Registerkarte NetInstall unter dem Menüpunkt Extras|Einstellungen ausgewählt. 

Hinterlegen des Pfades zur Maschinengruppendefinitionsdatei: 

6.3.7 enteo NetInstall-Dienstkonto für die Dienstinstallation konfigurieren 

Damit bei einer Installation eines Zielsystems, welches mittels vADM-Konsole gesteuert wird, 

ein automatisches Installieren des enteo NetInstall-Dienstes erfolgen kann, muss in den 

vADM-Einstellungen das enteo NetInstall-Dienstkonto hinterlegt werden. 

Gehen Sie über den Menüpunkt Extras|Einstellungen auf die Registerkarte enteo NetInstall 

und hinterlegen Sie das enteo NetInstall-Dienstkonto sowie Kennwort: 



6.3.8 enteo NetInstall-Dienstkonto für SQL-Serverzugriff konfigurieren 

Das enteo NetInstall-Dienstkonto auf dem SQL-Datenbankserver muss mit den 

im Anschluss aufgeführten Berechtigungen ausgestattet sein. 

Gründe: Installation der Zielsysteme vom Typ Citrix Presentation Server oder 

visionapp Access Portal, automatische Erzeugung von SQL Datenbanken mittels 

der Funktion Data Store erzeugen bzw. Datenbank erzeugen sowie Authentisierung 

des enteo NetInstall-Dienstkontos mithilfe integrierter Sicherheit am 

SQL Datenbankserver. 

Serverrollen auf dem Datenbankserver: 

> Database Creators 

> Process Administrators 

> Security Administrators 

Diese Berechtigungen müssen dem enteo NetInstall-Benutzer auf dem SQL- 

Server nicht unbedingt gewährt werden. Werden die Berechtigungen nicht 

gewährt, muss ein Benutzer mit entsprechenden Berechtigungen in den Datenbankeinstellungen 

der Farm hinterlegt werden. 



Citrix Presentation Server-Datenbankeinstellungen in der vADM-Konsole : 

6.3.9 enteo NetInstall-Protokollierung und vADM-Reporting konfigurieren 

In der vSM enteo NetInstall-Implementierung gibt es drei Arten des erweiterten Reportings: 

1. Jedes installierte Paket wird in die vADM-Datenbank protokolliert und ist somit über die 

Registerkarte Protokollierung in der vADM-Konsole sichtbar. Die Protokollierung ist im 

Auslieferungszustand aktiviert und kann bei Bedarf durch die Benutzerdefinierte NetInstall- 

Variable NI_VCC_LOGGING = 0 deaktiviert werde. Dies wird jedoch nicht empfohlen. 

2. Es gibt eine zusätzliche lokale textbasierte Protokollierung. Dabei handelt es sich um eine 

Protokolldatei, die sämtliche Pakete übersichtlich auflistet und im Verzeichnis %ProgramFiles%\visionapp\Log\NetInstall 

ablegt. Diese Art der Protokollierung ist im Auslieferungszustand 

aktiviert und kann nach Bedarf durch die benutzerdefinierte enteo NetInstall-Variable 

NI_SERVER_LOGGING = 0 deaktiviert werden. Dies wird jedoch nicht empfohlen. 

3. Es gibt die Möglichkeit auf eine zentrale Netzwerkfreigabe eine textbasierte Protokollierung 

zu aktivieren, die alle erfolgreichen und fehlgeschlagenen Pakete übersichtliche auflistet. 

Um die zusätzliche textbasierte Protokollierung auf einer Netzwerkfreigabe zu aktivieren, 

muss in den enteo NetInstall-Siteeinstellungen die Benutzerdefinierte Variable 

NI_NETWORK_LOGGING auf den Wert 1 gesetzt werden. Zusätzlich muss die benutzerdefinierte 

enteo NetInstall-Variable NI_NETWORK_LOGGING_SHARE gesetzt werden, deren 

Wert den UNC Pfad der Netzwerkfreigabe beinhaltet. Zuletzt ist dafür zu sorgen, dass die 

Netzwerkfreigabe existiert und dass das enteo NetInstall-Dienstkonto über Ändern-Rechte 

auf der Netzwerkfreigabe verfügt. 

Das folgende Beispiel zeigt die benutzerdefinierten Variablen für die Aktivierung der Netzwerkprotokollierung: 

NI_NETWORK_LOGGING = 1 

NI_NETWORK_LOGGING_SHARE = \\ServerName\Reporting$ 

Es empfiehlt sich, die Netzwerkfreigabe direkt auf dem enteo NetInstall-Server 

anzulegen. Sobald mehrere enteo NetInstall-Server im Einsatz sind, sollten Sie 

aus Gründen der Ausfallsicherheit die Netzwerkfreigabe auf jedem enteo 

NetInstall-Server anlegen. Diese Freigaben können durch Verwendung der 

enteo NetInstall-Variable %CurrentServer% innerhalb der 

NI_NETWORK_LOGGING_SHARE Variable dynamisch angesprochen werden. 

Hier ein Beispiel: 

NI_NETWORK_LOGGING_SHARE =\\%CurrentServer%\Reporting$ 



6.3.10 Integration der vSM-NetInstall-Datenbanken 

Zum Umfang von vSM gehören vorbereitete enteo NetInstall-Datenbanken und die von enteo 

als Projekte bezeichneten Pakete. Diese Datenbanken und Projekte ersparen viele aufwändige 

Schritte. 

Die vorbereiteten enteo NetInstall-Datenbanken und Projekte beinhalten den vollen Umfang 

der visionapp Base Installation Packages (vBIP). Innerhalb der Datenbanken befinden sich so 

genannte Serverspezifikationsprojekte, welche die Installation der Projekte für die unterschiedlichen 

Farm- und Servertypen innerhalb von enteo NetInstall steuern. 

Aus lizenzrechtlichen Gründen ist die Weitergabe von fertigen Paketen mit Third Party Software 

nicht möglich. Aus diesem Grund liegen die vBIP-Pakete, welche sich innerhalb der enteo 

NetInstall-Projekte und Datenbanken befinden, im separierten Format vor. Dies bedeutet, dass 

die Pakete mittels visionapp Separated Package Manager und dem Third Party Datenträger 

rekonstruiert werden müssen, bevor sie verwendet werden können. Anschließend können die 

Pakete mittels visionapp PackageSync in die vorbereiteten enteo NetInstall-Datenbanken 

und Projekte übernommen werden. 

Mehr Informationen zum Thema vBIP sind in der technischen Dokumentation der visionapp 

Base Installation Packages zu finden. Informationen zum visionapp Separated Package 

Manager sowie zu visionapp PackageSync sind in der entsprechenden Online-Hilfe zu finden. 

6.3.10.1 Informationen zum vSM-Datenbankaufbau 

Im Auslieferungszustand von vSM befinden sich die folgenden vier enteo NetInstall-Datenbanken 

auf dem vSM-Produktdatenträger: 

060_DB_x_PLATFORM 

060_DB_x_APPLICATION 

060_DB_x_CONTROL 

060_DB_x_POSTINSTALL 

Die Datenbanknamen setzen sich nach folgendem Schema zusammen: 

> Segment 1, Versionsnummer der vSM-Generation (mit führender 0). 

> Segment 2, Kürzel für ein Objekt vom Typ Datenbank. 

> Segment 3, Kürzel für die Umgebung (Optional, wenn „Staging“ zum Einsatz kommt): 

> E = Entwicklungsumgebung. 

> T = Testumgebung. 

> A = Abnahmeumgebung. 

> L = Pilotumgebung. 

> P = Produktionsumgebung. 

> Segment 4, Name der Datenbank: 

> PLATFORM = Plattformpakete für unterschiedliche Serverrollen wie Citrix MetaFrame 

Server, Terminalserver, Datenbankserver, Webserver. 

> APPLICATION = Anwendungspakete. 

> CONTROL = Installationsskripte, die die Installation und Reihenfolge steuern. 



> POSTINSTALL = Pakete, die nachträglich mittels Nachversand auf bestehende Systeme 

verteilt werden können. 

Innerhalb der enteo NetInstall-Datenbanken werden unterschiedliche Ebenen durch eine Ordnerstruktur 

gegliedert. Die erste Ebene ist wie folgt gegliedert: 

> GLOBAL = Pakete, die für sämtliche Systeme relevant sind und für alle Umgebungen mit 

gleicher Konfiguration zum Einsatz kommen. 

> COSTOMIZED = Pakete, die je nach Umgebung mit unterschiedlicher Konfiguration zum Einsatz 

kommen oder kundenspezifische Einstellungen beinhalten. 

Neben der Gliederung auf erster Ebene gibt es weitere Unterteilungen nach Servertyp, Betriebsystemtyp 

und Betriebsystemsprache. Diese Unterteilung ist selbsterklärend und geht aus 

dem Ordernamen hervor. 

Im Ordner CUSTOMIZED kann auf Wunsch eine weitere Unterteilung erfolgen, wenn beispielsweise 

im Unternehmen unterschiedliche Konfigurationen für verschiedene Abteilungen oder 

Serverfarmen benötigt werden. In diesem Fall wird unterhalb des Ordners CUSTOMIZED eine 

weitere Ordnerebene angelegt (z.B. AbteilungA, AbteilungB, ServerFarmA, ServerFarmB). Im 

Auslieferungszustand beinhaltet der Ordner COSTOMIZED bereits einen Unterordner namens 

TEMPLATES. Dieser dient als Vorlagenordner für weitere Unterteilungen. Der Ordner TEMPLATES 

kann nach dem Firmennamen umbenannt werden, wenn keine Unterteilung gewünscht ist. 

Beachten Sie im Falle einer Unterteilung, dass dies in allen vier Datenbanken entsprechend 

umgesetzt werden muss. 

Es wird empfohlen, die Pakete unterhalb des Ordners CUSTOMIZED\... abzulegen, 

wenn eigene Pakete erstellt oder durch visionapp erstellte Pakete an 

Besonderheiten angepasst bzw. konfiguriert werden. Dieses Vorgehen erleichtert 

eine eventuelle zukünftige Migration auf neueren vSM-Versionen. 

In den Ordnern befinden sich die enteo NetInstall-Projekte. Auch die Projektnamen basieren 

auf einen Namensschema. In der technischen Dokumentation zu den visionapp Base Installation 

Packages finden Sie weitere Informationen zu diesem Namensschema sowie zu Funktion 

und Anpassungsmöglichkeiten der Pakete. 

6.3.10.2 Informationen zum Importieren der vSM-Datenbanken 

enteo NetInstall bietet im enteo NetInstall-Manager eine Import- und Exportmöglichkeit 

für Projekte. Komplette enteo NetInstall-Datenbanken können auf 

diese Weise nicht bewegt werden, weshalb empfohlen wird, die durch visionapp 

zur Verfügung gestellten vSM-Datenbanken und Projekte nicht über die Projektimportfunktion 

zu importieren. 

Stattdessen legen Sie vier neue, leere enteo NetInstall-Datenbanken in der 

enteo NetInstall-Infrastruktur an. Anschließend kopieren Sie den Inhalt der visionapp 

Datenbanken in die eben neu erstellten. Durch diesen Vorgang sparen 

Sie im Vergleich zum Import über die Projektimportfunktion deutlich Zeit. 



6.3.10.3 Erzeugen der vSM-NetInstall-Datenbanken 

Zunächst müssen im enteo NetInstall-Manager in der gewünschten Organisationseinheit (OU) 

oder Site vier neue, leere enteo NetInstall-Datenbanken angelegt werden. Hierzu entsperren 

Sie die enteo NetInstall-Konfigurationsdatenbank und wählen über den Menüpunkt Einfügen| 

Datenbank die Funktion zum Anlegen von Datenbanken aus. Folgen Sie anschließend dem 

Assistenten. 

Die Datenbanken werden entsprechend dem in Abschnitt “Informationen zum vSM-Datenbankaufbau” 

auf Seite 14 erläuterten Namensschema benannt. Achten Sie dabei vor allem 

darauf, dass anstelle des x im Segment 3 das Buchstabenkürzel entsprechend der Staging- 

Umgebung gewählt wird, wenn Staging verwendet wird. Stellen Sie außerdem sicher, dass die 

Option Nur eine Datenbankkopie halten im Assistenten aktiviert ist. Sind diese vier Datenbanken 

im enteo NetInstall-Manager angelegt, wählen Sie Speichern und beenden Sie den 

enteo NetInstall-Manager. 

Auf der enteo NetInstall-Netzwerkfreigabe sind durch diesen Vorgang jeweils vier Ordner, entsprechend 

ihrer Datenbanknamen, im Unterverzeichnis Install und im Unterverzeichnis Work 

entstanden. 

6.3.10.4 Einspielen der vSM-Datenbanken 

Nachdem die leeren enteo NetInstall-Datenbanken gemäß Abschnitt “Erzeugen der vSM- 

NetInstall-Datenbanken” auf Seite 16 angelegt wurde, kann der Inhalt in die vorbereiteten leeren 

enteo NetInstall-Datenbanken kopiert werden. 

Eine einzelne enteo NetInstall-Datenbank im Dateisystem besteht immer aus zwei getrennten 

Ordnern, dem Datenbankordner innerhalb des Work-Ordners und dem Datenbankordner innerhalb 

des Install-Ordners. Demnach muss für jede enteo NetInstall-Datenbank jeweils einmal 

der Inhalt des Datenbankordners des Work-Verzeichnisses und einmal der Inhalt des Datenbankordners 

des Install-Ordners kopiert werden. 

Zuerst den Inhalt des Datenbankordners innerhalb des Work-Verzeichnisses 

kopieren und anschließend den Inhalt des Datenbankordners des Install-Verzeichnisses. 

Hintergrund hierfür ist die während des Kopiervorgangs stattfindende 

enteo NetInstall-Replikation vom Work-Verzeichnis in das Install- 

Verzeichnis. Alternativ kann der enteo NetInstall-Replikationsdienst für diesen 

Vorgang angehalten werden. 

Erscheint beim Kopieren der Dateien eine Meldung, dass die eine oder andere Datei bereits 

existiert, beantworten Sie die Frage Vorhandene Datei/Ordner überschreiben mit Ja. 

Die folgende Aufstellung veranschaulicht die Inhalte der Verzeichnisse, die von der visionapp 

Resource-CD auf die enteo NetInstall-Netzwerkfreigabe kopiert werden muss: 

Quelle: :\Installation\enteo NetInstall\Work\060_DB_x_PLATFORM\*.* 

Ziel: \\NIServer\NIShare\Work\060_DB_x_PLATFORM\*.* 

Quelle: :\Installation\enteo NetInstall\Work\060_DB_x_APPLICATION\*.* 

Ziel: \\NIServer\NIShare\Work\060_DB_x_APPLICATION\*.* 



Quelle: :\Installation\enteo NetInstall\Work\060_DB_x_CONTROL\*.* 

Ziel: \\NIServer\NIShare\Work\060_DB_x_CONTROL\*.* 

Quelle: :\Installation\enteo NetInstall\Work\060_DB_x_POSTINSTALL\*.* 

Ziel: \\NIServer\NIShare\Work\060_DB_x_POSTINSTALL\*.* 

Quelle: :\Installation\enteo NetInstall\Install\060_DB_x_PLATFORM\*.* 

Ziel: \\NIServer\NIShare\Install\060_DB_x_PLATFORM\*.* 

Quelle: :\Installation\enteo NetInstall\Install\060_DB_x_APPLICATION\*.* 

Ziel: \\NIServer\NIShare\Install\060_DB_x_APPLICATION\*.* 

Quelle: :\Installation\enteo NetInstall\Install\060_DB_x_CONTROL\*.* 

Ziel: \\NIServer\NIShare\Install\060_DB_x_CONTROL\*.* 

Quelle: :\Installation\enteo NetInstall\Install\060_DB_x_POSTINSTALL\*.* 

Ziel: \\NIServer\NIShare\Install\060_DB_x_POSTINSTALL\*.* 

Die Dateien und Ordner besitzen das Attribut Schreibgeschützt, wenn die 

enteo NetInstall-Datenbanken von der vSM-CD kopiert werden. Entfernen Sie 

das Attribut, z.B. über Windows Explorer oder den Shell Befehl Attrib. 

Nachdem die Datenbanken auf die enteo NetInstall-Freigabe eingespielt sind, kann der enteo 

NetInstall-Manager erneut gestartet werden. Jetzt werden die zuvor neuen und leeren Datenbanken 

inklusive Inhalt angezeigt. 

6.3.11 Einspielen der vBIP-Pakete mittels PackageSync 

Wie bereits in Kapitel “Integration der vSM-NetInstall-Datenbanken” auf Seite 14 beschrieben, 

handelt es sich bei den vSM-NetInstall-Datenbanken und Projekten um leere Datenbank- und 

Projekthüllen. In diese Hüllen werden die mithilfe der vBIP, der Third Party Datenträger und 

dem visionapp Separated Package Manager eingespielten Pakete erstellt. 

Dieses Kapitel erläutert, wie das Einspielen der Pakete durch visionapp PackageSync in die 

enteo NetInstall-Datenbank durchgeführt wird. Weitere notwendige Schritte, wie die Rekonstruktion 

der vBIP-Pakete mittels des visionapp Separated Package Managers wird in der visionapp 

Base Installation Packages Dokumentation und in der visionapp Separated Package 

Manager Onlinehilfe beschrieben. 

Das Werkzeug visionapp PackageSync, welches Bestandteil der visionapp Preparation Tools ist, 

muss zuerst auf einem Rechner installiert werden. Es kann sich dabei sowohl um den enteo 

NetInstall-Server handeln als auch um den Rechner, auf welchem mittels visionapp Separated 

Package Manager Pakete erzeugt werden. 



Um die Installation zu starten, führen Sie die Installationsdatei aus, die sich auf 

der visionapp Produkt-CD befindet. Hinweis: Die Datei kann in der Regel nicht 

von einem Netzlaufwerk ausgeführt werden. 

:\Installation\visionapp Toolbox Setup\visionapp_Toolbox.msi. 

Nachdem visionapp PackageSync gestartet wurde, können Sie über die Schaltfläche Einstellungen 

einen Suchfilter konfigurieren. Hier wird die Zeichenkombination 060_ hinterlegt. 

Diese Zeichenkombination stellt den Namensanfang der vSM 2008 Pakete dar und sorgt dafür, 

dass ausschließlich Pakete dieses Typs in der Synchronisationsauswahl vorkommen: 

Die Schaltfläche Synchronisieren ermöglicht den Wechsel in den Synchronisationsmodus. Im 

Feld Quell-Verzeichnis spezifizieren Sie den Pfad, in welchem sich die fertig rekonstruierten 

vBIP-Pakete befinden. Hiernach geben Sie im Feld Ziel-Verzeichnis das Install-Verzeichnis 

des enteo NetInstall-Servers an. Danach klicken Sie auf Vergleichen, damit Quellverzeichnis 

und Zielverzeichnis verglichen werden. Zuletzt markieren Sie die Dateien, welche auf dem 

enteo NetInstall-Server synchronisiert werden sollen. 



Klicken Sie danach auf Synchronisieren, um die Dateien auf den enteo NetInstall-Server einzuspielen: 

6.3.12 Einspielen von optionalen vAIP Paketen 

Die visionapp Base Installation Packages (vBIP) gehören zum visionapp Server Management 

(vSM). Darüber hinaus gibt es für die vBIP eine vorbereitete enteo NetInstall-Datenbank mit 

vorbereiteten enteo NetInstall-Projekten und Serverspezifikationen. Daneben besteht gegebenenfalls 

der Bedarf, einige optionale Pakete aus den visionapp Advanced Installation Packages 

(vAIP) einzuspielen. Da es sich bei den vAIP-Paketen um reine Wise-Pakete handelt, für die es 

keine entsprechend vorbereiteten enteo NetInstall-Projekthüllen und Skripte gibt, müssen 

diese gesondert erzeugt werden. Hierzu kann der Wise to NetInstall Wizard verwendet werden, 

welcher Bestandteil der visionapp Preparation Tools ist. 

Das Verzeichnis, in welchem sich die kompilierten Wise-Pakete befinden, wird spezifiziert und 

ein neuer Ordner angelegt. In diesem können temporär erzeugte enteo NetInstall-Projekte 

zwischengespeichert werden. Optional kann ein Filter inklusive Wildcards verwendet werden, 

wenn nur bestimmte Dateien umgewandelt werden sollen. 



visionapp Wise to NetInstall Wizard Einstellungen: 

Im folgenden Dialog kann durch Build an exemplary NetInstall Control Script und Build 

an exemplary NetInstall Variable Script spezifiziert werden, ob neben den enteo NetInstall-Projekten 

auch ein beispielhaftes enteo NetInstall-Variablen- und Steuerskript erzeugt 

wird. In diesem Fall wird über Target database path or variable die Pfadvariable spezifiziert, 

die verwendet werden soll. 

Mittels Consider source path kann spezifiziert werden, ob die Ordnerstruktur der Wise- 

Pakete als Ordnerstruktur in enteo NetInstall übernommen werden soll. 

Mit Move file instead of copying files kann angegeben werden, ob die Wise-Pakete verschoben 

statt kopiert werden sollen. 

Dem enteo NetInstall-Projektnamen kann mit Project prefix und Projekt suffix wahlweise 

ein Präfix oder Suffix (z.B. 060_) hinzugefügt werden. 



visionapp Wise to NetInstall Wizard-Opionen: 

Im folgenden Dialog kann ausgewählt werden, welche Wise-Pakete in enteo NetInstall-Projekte 

umgewandelt werden sollen: 

Nach der Auswahl von Next erfolgt die Erstellung der enteo NetInstall-Projekte auf Basis der 

Wise-Pakete. Anschließend können innerhalb des enteo NetInstall-Managers die soeben umgewandelten 

Projekte importiert werden. Dazu wählen Sie die Zieldatenbank und der Zielordner 

innerhalb der enteo NetInstall-Struktur aus. Danach wählen Sie Datei|Projekte importieren 

aus. 



enteo NetInstall-Projektimport-Assistent: 

Geben Sie das Quellverzeichnis an und wählen Sie Weiter. Es erscheit der Dialog zur Auswahl 

der zu importierenden Projekte: 

Wählen Sie die Projekte und klicken Sie Weiter. Der Import beginnt. 

Der nächste Schritt nach dem Import der Projekte beinhaltet, die Zeilen aus dem beispielhaften 

enteo NetInstall Control Skript und NetInstall Variable Skript in das entsprechende NetIsntall 

Installationsskript und enteo NetInstall Variable Skript zu übernehmen. Weitere 

Informationen finden Sie in den Abschnitten “Funktionsweise der Installationsskriptprojekte” 

auf Seite 34 und “Funktionsweise der Variablenskript-Projekte” auf Seite 37. 



6.3.13 Berechtigen der enteo NetInstall-Datenbanken und Pakete 

Nachdem die Datenbanken, wie in Kapitel “Integration der vSM-NetInstall-Datenbanken” auf 

Seite 14 beschrieben, importiert wurden, müssen selbige inklusive der darin enthaltenen Ordner 

und Projekte unter Zuhilfenahme des enteo NetInstall-Managers berechtigt werden. Die 

einzelnen Projekte müssen zusätzlich mit einem Installationszeitplan versehen, freigegeben, 

und repliziert werden. 

Alle Datenbanken und Ordner werden auf die gleiche Art und Weise berechtigt. Zur Berechtigung 

einer Datenbank oder eines Ordners wählen Sie auf der Registerkarte Interaktive 

Installation mit der Berechtigung * die Funktion Berechtigen über das Kontextmenü aus. 

Mit Ausnahme der Projekte im Unterorder Serverspezifikationen werden alle auf die gleiche 

Art und Weise mittels der Funktion Berechtigen auf den Modus Interaktive Installation mit 

der Berechtigung * berechtigt. Dann definieren Sie die Zeitplanung mithilfe der Funktion Zeitplanung 

auf dem Installationstyp Interaktive Installation. Als Startzeitpunkt wird ein Wert 

gewählt, der in der Vergangenheit liegt, wie beispielsweise 01.01.2001 00:00:00. Anschließend 

geben Sie alle Projekte mittels der Funktion Freigaben frei. Zuletzt definieren Sie für 

jedes Projekt die Replikation über die Funktion Replikation definieren mit der Option Zum 

nächstmöglichen Zeitpunkt auf alle Server replizieren. 

Alle Projekte des Unterordners Serverspezifikationen die in der CONTROL-Datenbank zu finden 

sind, erhalten eine abweichende Berechtigung und Zeitplanung. Die Funktion Berechtigen 

berechtigt die zu der Serverspezifikation gehörende Maschinengruppe auf den 

Installationstyp WTS (Server) und auf den Installationstyp AutoInstall. Im Anschluss daran 

definieren Sie die Zeitplanung mittels der Funktion Zeitplanung auf den Installationstyp WTS 

(Server) und dem Installationstyp AutoInstall, jeweils mit dem Ausführungstyp Einmalig. 

Anschließend geben Sie alle Projekte mittels der Funktion Freigaben frei. Zuletzt definieren 

Sie für jedes Projekt die Replikation über die Funktion Replikation definieren mit der Option 

Zum nächstmöglichen Zeitpunkt auf alle Server replizieren. 

Alle Projekte vom Typ PostInstall, die sich im Ordner Installationsskripts der CONTROL- 

Datenbank befinden, erhalten neben der normalen Projektberechtigung und Zeitplanung noch 

eine weitere Berechtigungsbedingung vom Typ RegValueExists mit dem Wert HKLM\Software\visionapp\PostInstall. 

Es empfiehlt sich, die Berechtigungen, die Zeitplanung, die Freigabe und die Replikation zu 

aktualisieren, da diese bei einer Vielzahl von Projekten konfiguriert werden müssen. visionapp 

empfiehlt die Verwendung von Makros, da enteo NetInstall keine Schnittstelle zur Automatisierung 

bietet. 

Ein vorbereitetes Makro wird mit vSM ausgeliefert. Die Komponente befindet 

sich im ausgelieferten, ausführbaren Toolbox-Setup. Um die Installation zu starten, 

kopieren Sie die Installationsdatei auf ein lokales Laufwerk (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. 

Macroexpress selbst ist zu finden unter www.macroexpress.com. 



6.3.13.1 Berechtigen der Datenbanken 

Zur Berechtigung einer enteo NetInstall-Datenbank markieren Sie die Datenbank und wählen 

Sie die Option Berechtigen aus dem Kontextmenü aus. Anschließend können Sie Berechtigungen 

entsprechend der folgenden Abbildung vergeben: 

6.3.13.2 Berechtigen der Ordner 

Registerkarte: 

Interaktive, automatische 

und De-Installation 

Berechtigung: 

* 

Zur Berechtigung eines Ordners markieren Sie diesen und wählen Sie anschließend die Option 

Berechtigen aus dem Kontextmenü aus. 



Anschließend können Sie Berechtigungen entsprechend der folgenden Abbildung vergeben: 

6.3.13.3 Berechtigung der Projekte 


Interaktive, automatische 

und De-Installation 

Berechtigung: 

* 

Zur Berechtigung eines Projekts markieren Sie es und wählen Sie anschließend die Option 

Berechtigen aus dem Kontextmenü aus. Danach können Sie Berechtigungen entsprechend 

der folgenden Abbildung vergeben: 


Interaktive Installation 

Berechtigung: 

* 



6.3.13.4 Zeitplanung der Projekte 

Zur Festsetzung der Zeitplanung eines Projekts markieren Sie dieses und wählen Sie dann die 

Option Zeitplanung aus dem Kontextmenü aus. Danach können Sie Berechtigungen entsprechend 

der folgenden Abbildung vergeben: 

6.3.13.5 Berechtigen der Serverspezifikationen 

Schaltfläche: 

Interaktive Installation- 

Festlegen 

Zeitplanung: 

01.01.2001 – 00:00:00 

Bei den Serverspezifikationen handelt es sich um Projekte, die sich in der CONTROL-Datenbank 

unterhalb des Ordners Serverspezifikationen befinden. Diese Projekte steuern den Installationsablauf 

für die unterschiedlichen Farm- und Servertypen. Für jeden Farm- und Servertyp 

existiert jeweils eine Serverspezifikation. In der enteo NetInstall-Maschinengruppendatei 

(siehe Abschnitt “enteo NetInstall-Sitezugehörigkeit konfigurieren” auf Seite 8) existiert ebenfalls 

für jeden Farm- und Servertyp eine entsprechende Gruppe. Diese Maschinengruppen werden 

entsprechend auf die Serverspezifikationen berechtigt. 

Zur Berechtigung eines Serverspezifikationsprojekts markieren Sie dieses und wählen Sie 

anschließend die Option Berechtigen aus dem Kontextmenü aus. Danach können Sie die 

Berechtigungen entsprechend der folgenden Abbildung vergeben: 



6.3.13.6 Zeitplanung der Serverspezifikationen 

Linke Registerkarte: 

WTS (Server) 

Rechte Registerkarte: 

Maschinengruppen 

Berechtigung: 

Auswahl der korrespondierenden 

Maschinengruppe 

Linke Registerkarte: 

AutoInstall 

Rechte Registerkarte: 

Maschinengruppen 

Berechtigung: 

Auswahl der korrespondierenden 

Maschinengruppe 

Zur Festsetzung der Zeitplanung eines Serverspezifikationsprojekts markieren Sie dieses und 

wählen Sie dann die Option Zeitplanung aus dem Kontextmenü aus. 



Danach können Sie die Berechtigungen entsprechend der folgenden Abbildung vergeben: 

6.3.13.7 Berechtigen der PostInstall Projekte 


WTS Serverteil-Festlegen 

Zeitplanung: 

01.01.2001 – 00:00:00 

Häufigkeit der Ausführung: 

Einmalig 


AutoInstall-Festlegen 

Zeitplanung: 

01.01.2001 – 00:00:00 


Einmalig 

Die Projekte vom Typ PostInstall im Unterordner Installationsskripts erhalten im Unterschied 

zu normalen Projektdateien neben der üblichen Projektberechtigung eine zusätzliche 

Berechtigung. Mit der zusätzlichen Berechtigung kann das Skript als Nachversandskript für ein 

bereits fertig installiertes System verwendet werden, beispielsweise um Updates zu einem 

bestimmten Zeitpunkt in der Zukunft zu verteilen (Wartungsfenster am Wochenende). 



Um ein Projekt vom Typ PostInstall für den Nachversand zu berechtigen, markieren Sie das 

Projekt und wählen Sie dann die Option Berechtigen aus dem Kontxtmenü aus. Danach können 

Sie die Berechtigungen entsprechend der folgenden Abbildung vergeben: 

6.3.13.8 Zeitplanung der PostInstall-Projekte 

Alle PostInstall-Skripte 


Interaktive Installation 

Berechtigung: 

* 

PostInstall Skripte für WTS Server 


WTS Server 

Berechtigung 1: 

Auswahl der korrespondierend Maschinengruppe 


RegValueExists mit dem Wert HKLM\Software\visionapp\PostInstal 

PostInstall-Skripte für nicht WTS Server 


AutoInstall 


Auswahl der korrespondierend Maschinengruppe 


RegValueExists mit dem Wert HKLM\Software\visionapp\PostInstall 

Zur Festsetzung der Zeitplanung eines PostInstall-Projekts markieren Sie dieses und wählen 

Sie dann die Option Zeitplanung aus dem Kontextmenü aus. 



Danach können Sie die Berechtigungen entsprechend der folgenden Abbildung vergeben: 

PostInstall Skripte für WTS Server 


WTS-Serverteil-Festlegen 

Zeitplanung: 

Zeitpunkt in der Zukunft 


Einmalig 

PostInstall Skripte für nicht WTS Server 


AutoInstall-Festlegen 

Zeitplanung: 

Zeitpunkt in der Zukunft 


Einmalig 

6.3.13.9 Freigabe der PostInstall-Projekte 

Alle PostInstall Skripte 


Interaktive Installation- 

Festlegen 

Zeitplanung: 

01.01.2001 – 00:00:00 


Einmalig 

Bei der Freigabe eines PostInstall-Projekts muss für bereits installierte Projekte die interne 

enteo NetInstall-Versionsnummer beim Freigeben erhöht werden. Hierdurch wird sichergestellt, 

dass der zu aktualisierende Server die eventuell neu hinzugekommenen Projekte installiert. 



6.4 Funktionsbeschreibug der Teilkomponenten 

6.4.1 Funktionsweise des vADM-NetInstall-Moduls 

Die Funktionsweise des vADM-NetInstall-Moduls können Sie der vADM-Online-Hilfe entnehmen. 

6.4.2 Funktionsweise der Installationsprojekte 

Zur erneuten Ausführung des 

bereits bestehenden Systems 

aktivieren Sie die Option 

Versionsnummer erhöhen. 

Bei den Installationsprojekten handelt es sich um enteo NetInstall-Projekte, welche die Wise- 

Pakete der visionapp Base Installation Packages (vBIP) oder visionapp Advanced Installation 

Packages (vAIP) beinhalten und ausführen. 



Die folgende Abbildung zeigt ein beispielhaftes enteo NetInstall-Installationsprojekt: 

Die visionapp Advanced Installation Packages (vAIP) oder visionapp Based Installation 

Packages (vBIP) Wise-Paketdatei befindet sich im Verzeichnis Extern$ des zugehörigen Projektverzeichnisses. 

Diese Datei wird vor ihrer Ausführung vom Extern$-Verzeichnis in ein lokales 

temporäres Verzeichnis kopiert und von dort lokal ausgeführt. Anschließend wird die Wise- 

Paketdatei wieder vom lokalen System gelöscht und das temporäre Verzeichnis entfernt. Durch 

den Befehl ClearRestartFlags wird abschließend ein eventuell benötigter Rechnerneustart 

unterdrückt, da dies zu einem späteren Zeitpunkt erfolgt. 

Die enteo NetInstall-Projekte haben folgende angepasste Projekteigenschaften: 

> Ausführungsoptionen: maschinenbezogen, per Service installieren 

> Plattformen: Windows 2000, Windows 2003 

> Deinstallation: keine Deinstallationsinformationen schreiben 

Information zur Berechtigung und zur Zeitplanung der enteo NetInstall-Projekte sind im 

Abschnitt “Berechtigen der enteo NetInstall-Datenbanken und Pakete” auf Seite 23 zu finden. 

Informationen zur Funktion der einzelnen Pakete können Sie in der entsprechenden vBIP-und 

vAIP-Dokumentation nachlesen. 

6.4.3 Funktionsweise der Serverspezifikationsprojekte 

Bei den Serverspezifikationsprojekten handelt es sich um ein Hauptsteuerskript, welches für 

unterschiedliche Arten von Farm- und Servertypen verantwortlich ist. Das Skript steuert, welche 

Installationsskripts (Untersteuerskripte) in welcher Reihenfolge installiert werden. 

Der Aufruf der Installationsskripts erfolgt durch den enteo NetInstall-Befehl CallNIProc, dem 

als Parameter der Pfad und Name des Installationsskripts übergeben wird. 

Zusätzlich ist in dem Skript eine Logik enthalten, die bei Neustarts, die während eines Installationsverlaufs 

möglicherweise stattfinden, erkennt, bis zu welcher Stelle das Skript abgearbeitet 

wurde. Dadurch kann nach dem Neustart an der entsprechenden Stelle fortgefahren 

werden. Diese Logik wird mittels Sprungmarken realisiert, deren aktuelle Positionswerte in der 

Windows Registrierung zwischengespeichert werden. 



Die folgende Abbildung zeigt beispielhaft den Inhalt einer Serverspezifikation: 



6.4.4 Funktionsweise der Installationsskriptprojekte 

Bei den Installationsskriptprojekten handelt es sich um ein Untersteuerskript, welches für 

unterschiedliche Arten von Farm- und Servertypen existiert. Überdies steuert das Skript, welche 

Projekte in welcher Reihenfolge installiert werden sollen. 

Durch Setzen der Variable NI_PACKAGE_VARIABLE innerhalb des Installationsskripts werden die 

eigentlichen Installationsprojekte aufgerufen. Die Variable erhält als Wert die Projektvariable, 

die die GUID enthält. 

Anschließend wird das globale Projekt SYS_NI-PACKAGE-EXEC_ALL über den Befehl CallNiProc 

ausgeführt, welches dann die Projektinstallation durchführt. 

Zusätzlich ist in dem Skript eine Logik enthalten, die bei Neustarts, die während eines Installationsverlaufes 

stattfinden, erkennt, bis zu welcher Stelle das Skript abgearbeitet wurde. 

Dadurch kann nach dem Neustart an der entsprechenden Stelle fortgefahren werden. Diese 

Logik wird mittels Sprungmarken realisiert, deren aktuelle Positionswerte in der Windows 

Registrierung zwischengespeichert werden. 

Die folgende Abbildung zeigt beispielhaft den Inhalt eines Installationsskripts: 



6.4.5 Funktionsweise der PostInstall-Skript-Projekte 

Im Wesentlichen ist das PostInstall (Nachversand) Skript aufgebaut wie eine Serverspezifikation. 

Es unterscheidet sich darin, dass es sich auch zum nachträglichen Installieren von Projekten 

auf bereits fertig installierten Systemen eignet. 

Ein weiterer Unterschied zu einer üblichen Serverspezifikation besteht in der Art der Berechtigung, 

Zeitplanung und Freigabe. Dieses Skript soll nicht nur bei der Erstinstallation eines Systems 

ausgeführt werden, sondern gegebenenfalls auch in der Zukunft auf bereits installierten 

Systemen. Informationen hierzu finden Sie im Abschnitt “Berechtigen der enteo NetInstall- 

Datenbanken und Pakete” auf Seite 23. Eine weitere Besonderheit des PostInstall Installationsskripts 

besteht darin, dass neben dem globalen Variablenskript (060_SYS_NI-GLOBAL- 

VAR_ALL) und dem benutzerdefinierten Variablenskript (060_SYS_NI-CUSTOM-VAR_ALL) auch 

das gesonderte PostInstall-Variablenskript (060_SYS_NI-POSTINSTALL-VAR_ALL) verwendet 

wird. Die folgende Abbildung zeigt beispielhaft den Inhalt eines PostInstall Installationsskripts: 



6.4.6 Funktionsweise der ereignisorientierten Skripte 

Bei den ereignisorientierten Skripten handelt es sich um Skripte, die je nach Ereignis zusätzlich 

vor oder nach dem Installationsprojekt ausgeführt werden. 

6.4.6.1 $OnStartScript 

Das $OnStartScript-Skript wird immer vor der Ausführung des Installationsprojekts ausgeführt. 

Innerhalb des Skripts werden folgende Schritte durchgeführt: 

> Ermitteln von häufig verwendeten Variablen wie z.B. Betriebssystem- und Sprachversion. 

> Ermitteln des Pfades zur Installationsparameterdatei (üblicherweise visionapp.ini) und 

deren wichtiger Parameter. 

> Ermitteln der enteo NetInstall-Datenbank und Verzeichnispfade. 

> Prüfen und Reporting des aktuellen Installationsstatus, wie z.B. PacketInstallation, 

PacketInstallationComplete, PacketInstallationAborted und PacketInstallation- 

Paused. 

> Ermitteln der Variablen zu den globalen Projekten wie z.B. SYS_NI_SCRIPT_ABORTED_ALL, 

SYS_NI-GLOBAL-APP-CFG_ALL, SYS_NI-PACKAGE-EXEC_ALL und SYS_NI_REBOOT_ALL. 

6.4.6.2 $OnEndScriptDone 

Das $OnEndScriptDone-Skript wird immer nach der Ausführung des Installationsprojekts ausgeführt. 

Innerhalb des Skripts werden folgende Schritte durchgeführt: 

> Prüfen, ob es im zuvor ausgeführten Installationsprojekt zu einem unerwarteten Fehler 

gekommen ist. 

> Reporting von erfolgreichen und nicht erfolgreichen Paketausführungen. 

6.4.6.3 $OnEndScriptTerminated 

Das $OnEndScriptDone-Skript wird immer nach der Ausführung des eigentlichen Installationsprojekts 

ausgeführt, wenn enteo NetInstall einen schwerwiegenden Fehler erkennen konnte, 

der zum Abbruch des Installationsprojekts geführt hat. Innerhalb des Skripts werden folgende 

Schritte durchgeführt: 

> Auswerten des Abbruchgrunds und Reporting des Fehlers. 

> Anhalten des Installationsvorgangs. 



6.4.7 Funktionsweise der Variablenskript-Projekte 

Mit dem Variablenskript werden die absoluten Pfade der Installationsprojekte dynamisch 

ermittelt und in Variablen gespeichert, um die im Installationsskript 1 vorhandenen enteo 

NetInstall-Projekte mit ihrem Variablennamen ansprechen zu können. Damit ist kein absoluter 

Pfad notwendig. Der Vorteil liegt darin, dass Datenbanken mit Projekten kopiert werden können 

und die dabei entstehenden neuen absoluten Pfade nicht im Installationsskript angepasst 

werden müssen, da diese zur Laufzeit dynamisch vom Variablenskript ermittelt werden. 

Innerhalb des Variablenskripts werden im ersten Teil des Skripts die Ordnerpfade als Variable 

zur Verfügung gestellt, z.B. die Variable %APPLICATION_GLOBAL% mit dem Pfad 

DB:060_DB_x_APPLICATION\Global. 

Im zweiten Teil des Skripts werden die GUIDs der Projekte ermittelt und in Variablen gespeichert. 

Dies geschieht unter Verwendung des Befehls LookupGuidFromProjectName. Dieser 

ermittelt über den spezifischen Paketpfad und Projektnamen die Projekt-GUID und speichert 

diese in einer Variablen ab. Diese Variable wird später innerhalb des Installationsskripts zum 

Aufrufen des Pakets verwendet. 

Bei der Erweiterung der enteo NetInstall-Umgebung um eigene Projekte muss für jedes Projekt, 

das hinzugefügt wird, das Variablenskript entsprechend erweitert werden. 

Es stehen drei Arten von Variablenskripten zur Verfügung: 

1. Das globale Variablenskript 060_SYS_NI-GLOBAL-VAR_ALL, welches sich im Ordner Global 

der Control-Datenbank befindet. 

2. Das Variablenskript 060_SYS_NI-CUSTOM-VAR_ALL, welches pro Customized-Unterordner 

existiert. 

3. Das Variablenskript 060_SYS_NI-POSTINSTALL-VAR_ALL. Dieses Skript existiert pro Customized-Unterordner, 

welches für das PostInstall Skript verwendet wird. 

Im globalen Variablenskript sind alle globalen Pakete und im benutzerdefinierten Variablenskript 

alle Projekte referenziert, die sich in den Datenbanken unterhalb der Customized-Struktur 

befinden. Im PostInstall-Variablenskript sind alle Pakete referenziert, die sich in der 

PostInstall-Datenbank befinden und die nachträglich auf bestehende Systemen verteilt werden 

können. 

1. Das Installationsskript steuert die Installation 



Die folgende Abbildung zeigt beispielhaft den Inhalt des globalen Variablenskripts: 

6.4.8 Funktionsweise des NI-SCRIPT-ABORTED Projekts 

Das enteo NetInstall-Projekt NI-SCRIPT-ABORTED wird immer dann aufgerufen, wenn innerhalb 

eines anderen enteo NetInstall-Projekts ein unerwarteter Fehler erkannt wird. 

Durch NI-SCRIPT-ABORTED wird der Fehler im vADM-Reporting protokolliert und die Installation 

angehalten. 



Eine durch NI-SCRIPT-ABORTED angehaltene Installation kann auf Wunsch und nach Beseitigung 

des Fehlers über die vADM-Konsolenfunktion Installation-Fortsetzen fortgeführt werden. 

Folgende Arten von Fehlern werden erkannt und entsprechend behandelt: 

> Unerwarteter Returncode beim Ausführen eines visionapp Wise-Pakets. 

> Überschreitung des enteo NetInstall-Timeouts bei der Paketausführung. 

> Nicht aufgelöste enteo NetInstall-Variable innerhalb von Installationsskripts. 

> Nicht ausführbares enteo NetInstall-Projekt, z.B. durch falsche Berechtigung oder fehlende 

Freigabe oder fehlerhafte Replikation. 

6.4.9 Funktionsweise des NI-PACKAGE-EXEC Projektes 

Das enteo NetInstall-Projekt NI-PACKAGE-EXEC dient als Hilfsprojekt zum Ausführen von enteo 

NetInstall-Projekten. Zusätzlich werden vor und nach der Paketinstallation folgende Prüfungen 

vorgenommen, um bei eventuell auftretenden Fehlern entsprechend reagieren zu können: 

> Prüfung, ob das auszuführende Projekt spezifiziert wurde. 

> Prüfung, ob das Projekt eventuell schon installiert ist. 

> Prüfung, ob das Projekt nach der Ausführung erfolgreich installiert wurde. 

6.4.10 Funktionsweise des NI-GLOBAL-APP-CFG Projektes 

Das enteo NetInstall-Projekt NI-GLOBAL-APP-CFG dient zur globalen Anwendungskonfiguration 

innerhalb von enteo NetInstall-Anwendungspaketen, die mittels der enteo NetInstall-Skriptsprache 

erstellt wurden. Das Projekt dient in erster Linie der Abwärtskompatibilität für enteo 

NetInstall-Projekte, die für die Vorgängerversion von vSM erstellt worden sind und die NI-GLO- 

BAL-APP-CFG-Funktionalität nutzen. 

Die Funktionalität des NI-GLOBAL-APP-CFG enteo NetInstall-Skripts existiert mit gleichem 

Funktionsumfang wie Wise-Skript. 

Weitere Informationen hierzu finden Sie in Kapitel GlobalAppCfg innerhalb der visionapp Base 

Installation Packages Dokumentation.

enteo NetInstall mit vSM - Visionapp

Erfolgreiche ePaper selbst erstellen

Template löschen?

Als Template speichern?