Config.xml-Referenz (Windows SharePoint Services)
Wenn Sie steuern möchten, wie Windows SharePoint Services 3.0 installiert wird, verwenden Sie die Datei Config.xml zusammen mit Setup.exe. Die Datei Config.xml bietet unter anderem folgende Möglichkeiten:
Ausführen einer automatischen Installation von Windows SharePoint Services 3.0.
Installieren von Windows SharePoint Services 3.0 mithilfe einer gemeinsamen Konfiguration auf mehreren Servern.
Ausführen einer automatisierten oder skriptgesteuerten Installation von Windows SharePoint Services 3.0.
Inhalt dieses Artikels:
Anpassen von "Config.xml"
Kurzübersicht zu den Elementen in "Config.xml"
Funktionsweise
Dateiformat von "Config.xml"
Elementreferenz zu "Config.xml"
Anpassen von "Config.xml"
Wenn Sie die Installation steuern möchten, bearbeiten Sie zunächst die Datei Config.xml in einem Text-Editor, um die benötigten Elemente mit den entsprechenden Einstellungen für diese Elemente einzuschließen. Führen Sie dann setup.exe /config [path and file name] aus, um anzugeben, dass Setup.exe ausgeführt wird und die in der Datei Config.xml von Ihnen festgelegten Optionen verwendet.
Wichtig
Verwenden Sie zum Bearbeiten von Config.xml einen Text-Editor wie beispielsweise Editor. Sie sollten keinen allgemeinen XML-Editor wie beispielsweise Microsoft Office Word 2007 verwenden.
Die Produkt-DVD enthält Beispiele für Config.xml. Diese Beispieldateien sind im Ordner \Files im Stammverzeichnis der DVD gespeichert, und zwar in den betreffenden Ordnern für die verschiedenen Szenarien. Folgende Ordner sind vorhanden:
Setup Enthält eine Datei Config.xml zum Einrichten einer Neuinstallation. Nach der Ausführung von Setup müssen Sie psconfig.exe ausführen, um die Konfiguration des Servers oder der Serverfarm abzuschließen.
SetupFarmSilent Enthält eine Datei Config.xml zum Einrichten einer Serverfarm im unbeaufsichtigten Modus.
SetupGradualUpgradeSilent Enthält eine Datei Config.xml für das schrittweise Upgrade einer vorhandenen Serverfarm.
SetupSilent Enthält eine Datei Config.xml zum Einrichten einer Neuinstallation für einen einzelnen Server (eigenständig, mit Windows Internal Database) im unbeaufsichtigten Modus.
SetupUpgradeSilent Enthält eine Datei Config.xml für das schrittweise Upgrade einer vorhandenen Serverfarm.
Wichtig
In den in Windows SharePoint Services 3.0 vorhandenen Standardkonfigurationsdateien ist die Option SETUP_REBOOT nicht vorhanden. Sie müssen diese Option einschließen, wenn Sie Neustarts während einer Befehlszeileninstallation unterdrücken möchten.
Weitere Informationen zu den Unterschieden der verschiedenen Upgradeszenarien finden Sie unter Bestimmen der Upgrademethode [Windows SharePoint Services].
Kurzübersicht zu den Elementen in "Config.xml"
Die folgende Tabelle enthält eine Liste der Elemente in Config.xml. Diese Elemente können in beliebiger Reihenfolge verwendet werden. Eine Ausnahme ist das Configuration-Element, das als erstes angegeben werden muss, sowie Elemente wie beispielsweise Command, deren Reihenfolge in der Datei Config.xml bestimmt, wie sie während der Installation verarbeitet werden.
Element |
Beschreibung |
Configuration |
Element der obersten Ebene. |
ARP |
Werte, die für das Produkt den Text und das Verhalten der Option Software in der Systemsteuerung steuern. |
Command |
Führt während der Installation einen Befehl aus. |
Display |
Die Ebene der Benutzeroberfläche, die dem Benutzer angezeigt wird. |
Logging |
Optionen für den von Setup ausgeführten Protokollierungstyp. |
DATADIR |
Der Speicherort für die Datendateien. |
Package |
Das zu installierende Paket oder Produkt. |
Setting |
Werte für Windows Installer-Eigenschaften. |
Funktionsweise
Setup sucht im selben Ordner, in dem Setup.exe gespeichert ist, nach einem Exemplar von Config.xml. Wenn keine Datei gefunden wird, wird die Datei Config.xml verwendet, die im Ordner \Files für das zu installierende Produkt gespeichert ist.
Sie können auch mit der Setup-Befehlszeilenoption /config den Speicherort der Datei Config.xml angeben. Beispiel:
\\<Server>\<Freigabe>\setup.exe /config \\<Server>\<Freigabe>\<Ordner>\config.xml
Dateiformat von "Config.xml"
XML-Elemente in Config.xml beginnen mit < und enden mit />.
Das grundlegende Elementformat lautet:
<Elementname [Attributname="Wert"] [Attributname="Wert"] … />
Beispiel:
<Display Level="none" CompletionNotice="no" />
Bei Elementen und Attributen wird die Groß- und Kleinschreibung berücksichtigt. Attributwerte müssen in Anführungszeichen (") eingeschlossen werden und werden nicht nach Groß- und Kleinschreibung unterschieden.
Eine Elementdefinition kann mehrere Zeilen umfassen. Leerzeichen, Wagenrücklaufzeichen, Zeilenvorschubzeichen und Tabulatoren werden innerhalb einer Elementdefinition ignoriert.
Beispiel:
<Display
Level="none"
CompletionNotice="no"
/>
Tipp
Bei langen Elementdefinitionen sollten Sie Attribute auf separaten Zeilen platzieren und Einzüge verwenden, um die Lesbarkeit der Datei zu erhöhen.
Das Configuration-Element ist ein Sonderfall und erforderlich. Alle anderen Elemente sind innerhalb des Configuration-Elements enthalten, wobei dieses Element mit </Configuration> beendet wird.
Es folgt ein Beispiel einer Konfigurationsdatei für die Neuinstallation von Windows SharePoint Services 3.0:
<Configuration>
<Package Id="sts">
<Setting Id="REBOOT" Value="ReallySuppress"/>
<Setting Id="SETUPTYPE" Value="CLEAN_INSTALL"/>
</Package>
<DATADIR Value="%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\12\Data"/>
<Logging Type="verbose" Path="%temp%" Template="Microsoft Windows SharePoint Services 3.0 Setup(*).log"/>
<Setting Id="UsingUIInstallMode" Value="1"/>
<Setting Id="SETUP_REBOOT" Value="Never"/>
</Configuration>
Wichtig In den in Windows SharePoint Services 3.0 vorhandenen Standardkonfigurationsdateien ist die Option SETUP_REBOOT nicht vorhanden. Sie müssen diese Option einschließen, wenn Sie Neustarts während einer Befehlszeileninstallation unterdrücken möchten.
Kommentare können überall hinzugefügt werden und werden durch "<!--" und "-->" getrennt.
Beispiel:
<!-- Install Windows SharePoint Services for clean install, using UI-->
<Configuration>
<Package Id="sts">
<Setting Id="REBOOT" Value="ReallySuppress"/>
<!-- Tells Windows Installer not to reboot -->
<Setting Id="SETUPTYPE" Value="CLEAN_INSTALL"/>
</Package>
<DATADIR Value="%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\12\Data"/>
<Logging Type="verbose" Path="%temp%" Template="Microsoft Windows SharePoint Services 3.0 Setup(*).log"/>
<Setting Id="UsingUIInstallMode" Value="1"/>
<Setting Id="SETUP_REBOOT" Value="Never"/>
<!-- Tells Setup.exe not to reboot -->
</Configuration>
Elementreferenz zu "Config.xml"
Die folgenden typografischen Vereinbarungen werden in den Beschreibungen dieser Referenz verwendet:
Fett |
Element- oder Attributname |
Normal |
Genau wie angezeigt einzugebender Text |
*Kursiv* |
Platzhalter für einen hinzuzufügenden Wert |
*x*|*y* |
Auswahl zwischen mehreren Werten |
[*x*] |
Optionaler Wert |
Configuration-Element
Element der obersten Ebene. Dieses Element ist erforderlich, und alle anderen Elemente müssen in diesem Element enthalten sein.
Syntax
<Configuration>
<Package Id="ID">
...
</Package>
...
</Configuration>
Attribute
Attribut |
Wert |
Beschreibung |
Package ID |
*Paket-ID* |
Das zu installierende Paket. |
Hinweise
Mit dem Attribut Package Id werden das Produkt und die Technologien identifiziert, die von der Datei Config.xml betroffen sind.
Beispiel
Die Paket-ID für Windows SharePoint Services 3.0 lautet sts. Verwenden Sie die Paket-ID sts in Config.xml, um Windows SharePoint Services 3.0 anzugeben, indem Sie Folgendes eingeben:
<Configuration>
<Package Id="sts">
...
</Package>
...
</Configuration>
ARP-Element
Gibt Werte an, die für das Produkt den Text und das Verhalten der Option Software in der Systemsteuerung steuern.
Syntax
<ARP Attribut**="Wert"** [Attribut**="Wert"**] ... />
Attribute
Attribut |
Wert |
Beschreibung |
ARPCOMMENTS |
*Text* |
Zusätzlicher Text mit bis zu 255 Zeichen. Möglicherweise werden jedoch nicht alle Zeichen angezeigt. |
ARPCONTACT |
*Text* |
Liste der Kontaktpersonen für den technischen Support. |
ARPNOMODIFY |
Yes |
Hindert die Benutzer am Ändern der Produktinstallation, indem die Schaltfläche Ändern nicht verfügbar ist. |
No (Standard) |
Erlaubt dem Benutzer das Ändern der Produktinstallation. |
|
ARPNOREMOVE |
Yes |
Hindert die Benutzer am Entfernen des Produkts, indem die Schaltfläche Entfernen nicht verfügbar ist. |
No (Standard) |
Erlaubt den Benutzern das Entfernen des Produkts. |
|
ARPURLINFOABOUT |
*URL* |
URL für die Homepage des Produkts. |
ARPURLUPDATEINFO |
*URL* |
URL für Informationen zu Produktupdates. |
ARPHELPLINK |
*URL* |
URL einer Website, auf der Benutzer technischen Support erhalten. |
ARPHELPTELEPHONE |
*Text* |
Telefonnummern für den technischen Support. |
Command-Element
Gibt eine auszuführende Befehlszeile an. Die Command-Elementbefehle werden nur bei Erstinstallationen und Deinstallationen verarbeitet. Wenn Command-Elementbefehle für Anpassungen nach der Erstinstallation verwendet werden, werden sie ignoriert.
Syntax
<Command
Path="Pfad"
[QuietArg="Argumente"]
[Args="Argumente"]
[ChainPosition="Before" | "After"(Standard)]
[Wait="Millisekunden"]
[QuietWait="Millisekunden"]
[Execute="Install"(Standard) | "Uninstall"]
[Platform="x86"(Standard) | "x64"]
/>
Attribute
Sie können doppelte Anführungszeichen (") für die Attribute Path und Args angeben, indem Sie zwei doppelte Anführungszeichen verwenden ("").
Attribut |
Wert |
Beschreibung |
Path |
*Pfad* |
Vollqualifizierter Pfad zur ausführbaren Paketdatei von Microsoft® Windows Installer (MSI). |
QuietArg |
*Zeichenfolge* |
Eine Argumentzeichenfolge, die an die Befehlszeile angefügt wird, wenn Display Level=None. |
Args |
*Zeichenfolge* |
Eine Argumentzeichenfolge, die an die ausführbare Datei übergeben wird. |
ChainPosition |
Before |
Dieser Befehl wird vor der primären Produktinstallation ausgeführt. |
After (Standard) |
Dieser Befehl wird nach der primären Produktinstallation ausgeführt. |
|
Wait |
*Millisekunden* |
Wenn bei der Installation das Attribut Display Level auf Full oder Basic festgelegt wird, wird hiermit angegeben, wie viele Millisekunden nach der Ausführung des Programms gewartet wird, bevor Sie die Installation fortsetzen. Der Standardwert ist 0 (null), womit überhaupt nicht gewartet wird. |
QuietWait |
*Millisekunden* |
Wenn bei der Installation Display Level auf None festgelegt wird, wird hiermit angegeben, wie viele Millisekunden nach der Ausführung des Programms gewartet wird, bevor Sie die Installation fortsetzen. Der Standardwert ist 0 (null), womit überhaupt nicht gewartet wird. |
Execute |
Install (Standard) |
Dieser Befehl wird bei der Installation des primären Produkts installiert. |
Uninstall |
Dieser Befehl wird bei der Installation des primären Produkts deinstalliert. |
|
Platform |
x86 (Standard) |
Gibt an, dass für dieses Programm die Intel x86-Plattform erforderlich ist. Dieser Befehl wird nur ausgeführt, wenn der Computer, auf dem die Installation ausgeführt wird, diese Plattformanforderung erfüllt. |
x64 |
Gibt an, dass für dieses Programm ein 64-Bit-Prozessor erforderlich ist, der die x64-Erweiterungen zur x86-Architektur unterstützt. Dieser Befehl wird nur ausgeführt, wenn der Computer, auf dem die Installation ausgeführt wird, diese Plattformanforderung erfüllt. |
Hinweise
Die Befehlszeile kann für eine verkettete Installation oder eine ausführbare Datei angegeben werden, die bei der Installation dieses Produkts ausgeführt wird. Wenn dies angegeben ist, müssen Sie für Setup.exe eine Befehlszeile anstelle einer einzigen MSI-Datei angeben.
Wenn mindestens zwei Command-Elemente in der Datei Config.xml vorhanden sind, werden sie in der in Config.xml angegebenen Reihenfolge ausgeführt.
Beispiel
<Command Path=”myscript.exe” Args=”/id ""123 abc"" /q”/>
<Command Path="\\<server>\<share>\setup.exe /config \\<server>\<share>\<folder>\config.xml"
DATADIR-Element
Der Speicherort für die Datendateien, einschließlich der Suchindexdateien.
Syntax
<DATADIR Value="Pfad"/>
Attribute
Attribut |
Wert |
Beschreibung |
Value |
Pfad |
Die Datendaten werden im angegebenen Pfad gespeichert. |
Hinweise
Sie können im Pfad Systemumgebungsvariablen verwenden. Wenn dieses Element nicht angegeben ist, werden die Daten im folgenden Pfad gespeichert:
%ProgramFiles%\Microsoft SQL Server\MSSQL$SHAREPOINT\Data
Beispiel
<DATADIR Value=”d:\data”/>
Display-Element
Die Ebene der Benutzeroberfläche, die dem Benutzer angezeigt wird.
Syntax
<Display
Level="None" | "Basic" | "Full"(Standard)
CompletionNotice="Yes"(Standard) | "No"
SuppressModal="Yes" | "No"(Standard)
NoCancel="Yes" | "No"(Standard)
AcceptEula="Yes" | "No"(Standard)
/>
Attribute
Attribut |
Wert |
Beschreibung |
Level |
None |
Es wird keine Setupbenutzeroberfläche angezeigt. |
Basic |
Die Willkommensseite, die Seite Microsoft-Software-Lizenzbedingungen (falls erforderlich), eine Statusanzeige und der Abschlusshinweis (sofern zulässig) werden angezeigt. |
|
Full (Standard) |
Dem Benutzer wird die komplette Benutzeroberfläche angezeigt. |
|
CompletionNotice |
Yes |
Trifft nur zu, wenn Level auf Basic oder None festgelegt ist. In diesem Fall wird der Abschlusshinweis angezeigt. |
No (Standard) |
Trifft nur zu, wenn Level auf Basic festgelegt ist. In diesem Fall wird der Abschlusshinweis nicht angezeigt. |
|
SuppressModal |
Yes |
Trifft nur zu, wenn Level auf Basic festgelegt ist. In diesem Fall werden keine Fehlermeldungen und anderen Dialogfelder angezeigt, die die Installation unterbrechen könnten. |
No (Standard) |
Trifft nur zu, wenn Level auf Basic festgelegt ist. In diesem Fall werden bei Bedarf Fehlermeldungen und andere Dialogfelder angezeigt. |
|
NoCancel |
Yes |
Wenn Level auf Full oder Basic festgelegt ist, wird die Schaltfläche zum Abbrechen (X in der rechten oberen Ecke des Statusdialogfelds) angezeigt. |
No (Standard) |
Wenn Level auf Full oder Basic festgelegt ist, kann der Benutzer die Installation über die Statusanzeige abbrechen. |
|
AcceptEULA |
Yes |
Die Microsoft-Software-Lizenzbedingungen werden im Namen des Benutzers akzeptiert. Die Seite Microsoft-Software-Lizenzbedingungen wird nicht angezeigt. |
No (Standard) |
Wenn Level nicht auf None festgelegt ist, wird die Seite Microsoft-Software-Lizenzbedingungen angezeigt. |
Hinweise
Wenn dieses Element nicht definiert ist, werden die Standardeinstellungen verwendet. Wenn ein ungültiger Wert angegeben wird, wird die Installation beendet.
Hinweis
Das Display-Element wird von Setup nur verwendet, wenn die Datei Config.xml im selben Ordner wie setup.exe vorhanden ist oder wenn Sie die Datei Config.xml mithilfe der Befehlszeilenoption /config von Setup angeben.
Beispiel
<Display Level=”basic”
CompletionNotice=”yes”
SupressModal=”no”
AcceptEula=”yes”
/>
Logging-Element
Gibt den von Setup ausgeführten Protokollierungstyp an.
Syntax
<Logging
Type="Off" | "Standard"(Standard) | "Verbose"
Path="Pfad"
Template="Dateiname.txt"
/>
Attribute
Attribut |
Wert |
Beschreibung |
Type |
Off |
Es wird keine Protokollierung vorgenommen. |
Standard (Standard) |
Installationsinformationen werden in die Protokolldatei geschrieben. |
|
Verbose |
Alle Installationsinformationen werden in die Protokolldatei geschrieben. |
|
Path |
*Pfad* |
Der vollqualifizierte Pfad zu dem für die Protokolldatei verwendeten Ordner. Sie können Umgebungsvariablen verwenden. Der Standardwert ist %temp%. |
Template |
*Dateiname*.txt |
Der Name der Protokolldatei. Wenn Sie die Zeichenfolge * an einer beliebigen Stelle des Dateinamens einfügen, wird eine eindeutige Protokolldatei für jede von Setup.exe ausgeführte Installation erstellt (siehe die Erklärung weiter unten). Wenn * nicht verwendet wird und der angegebene Dateiname bereits vorhanden ist, werden Protokollinformationen an die vorhandene Datei angefügt. Die Dateierweiterung TXT muss angegeben werden. Die Standardvorlage ist SetupExe(*).log. |
Hinweise
Sie können * überall für Template angeben. Eine Zeichenfolge wird an dieser Stelle mit folgendem Format eingefügt:
JJJJMMTTHHMMSSxxx
Dabei gilt:
JJJJ = Jahr
MM = Monat
TT = Tag
HH = Stunde
MM = Minuten
SS = Sekunden
xxx = eine von Setup generierte eindeutige Zeichenfolge
Hinweis
Das Logging-Element wird von Setup nur verwendet, wenn Sie die Datei Config.xml mithilfe der Befehlszeilenoption /config von Setup angeben. Wenn Sie keine Datei Config.xml angeben, werden die Standardprotokollierungsoptionen verwendet.
Beispiel
<Logging Type=”standard” Path=”%temp%”
Template=”MyLog(*).txt”
/>
In diesem Beispiel wird bei jeder Installation des Produkts eine Protokolldatei erstellt. Setup verwendet eindeutige Dateinamen, wie beispielsweise:
%temp%\MyLog(20060428110717CFC).txt
%temp%\MyLog(20060429113143C70).txt
Package-Element
Das zu installierende Paket oder Produkt.
Die Paket-ID für Windows SharePoint Services 3.0 lautet sts.
Setting-Element
Hiermit können Sie Werte für Windows Installer-Eigenschaften angeben.
Syntax
<Setting Id="Name" Value="Wert" />
Attribute
Attribut |
Wert |
Beschreibung |
Id |
*Name* |
Der Name der Windows Installer-Eigenschaft. |
Value |
*Wert* |
Der Wert, der der Eigenschaft zugewiesen werden soll. |
Werte
Die folgenden Einstellungs-IDs werden für Serverinstallationen verwendet:
ID |
Akzeptierte Werte |
Beschreibung |
REBOOT |
ReallySuppress |
Gibt (für Windows Installer) an, ob nach Abschluss von Setup ein Neustart zulässig ist. Verwenden Sie ReallySuppress, um keinen Neustart festzulegen. Diese Option muss auf globaler Ebene, nicht pro Paket angegeben werden. |
SETUP_REBOOT |
Never, AutoAlways, Always, AutoIfNeeded, IfNeeded |
Gibt (für Setup.exe) an, ob nach Abschluss von Setup ein Neustart zulässig ist. Verwenden Sie Never, um keinen Neustart festzulegen. Diese Option muss auf globaler Ebene, nicht pro Paket angegeben werden. |
SETUPTYPE |
CLEAN_INSTALL, V2V_GRADUAL_UPGRADE, V2V_INPLACE_UPGRADE |
Gibt an, ob eine neue Kopie des Produkts oder der Technologie (CLEAN_INSTALL) installiert, ob die neue Version parallel zur vorherigen Version für ein schrittweises Upgrade (V2V_GRADUAL_UPGRADE) oder ob die neue Version installiert und die vorherige Version direkt aktualisiert werden soll (V2V_INPLACE_UPGRADE). Diese Option muss auf globaler Ebene, nicht pro Paket angegeben werden. |
SETUPCALLED |
0 | 1 |
Verwenden Sie dies als Teil des Attributs Package Id. |
SERVERROLE |
SINGLESERVER, WFE |
Gibt an, welchen Servertyp Sie installieren: eigenständiger Server (SINGLESERVER) oder Front-End-Webserver (WFE). |
USINGUIINSTALLMODE |
0 | 1 |
Gibt an, ob Sie eine unbeaufsichtigte Installation (0) durchführen oder die Benutzeroberfläche für die Installation (1) verwenden. |
Hinweise
Nicht alle Windows Installer-Eigenschaften können für das Setting-Element angegeben werden. Bei Angabe einer blockierten Eigenschaft wird der Installationsvorgang beendet. Wenn eine unterstützte Eigenschaft angegeben wird, wird die Eigenschaft direkt an Windows Installer übergeben.
Beispiel
<Setting Id="REBOOT" Value="ReallySuppress" />
Herunterladen dieses Buchs
Dieses Thema wurde zum leichteren Lesen und Ausdrucken in das folgende Buch zum Herunterladen aufgenommen:
Die vollständige Liste der verfügbaren Bücher finden Sie unter Bücher zum Herunterladen für Windows SharePoint Services.