Guide de référence sur Config.xml (Windows SharePoint Services)

  • Article

Mise à jour : 2008-09-18

Lorsque vous souhaitez contrôler les paramètres d’installation de Windows SharePoint Services 3.0, utilisez le fichier Config.xml avec le programme d’installation Setup.exe. Grâce au fichier config.xml, vous pouvez notamment :

  • Installer Windows SharePoint Services 3.0 en mode silencieux.

  • Installer Windows SharePoint Services 3.0 en utilisant une configuration commune à plusieurs serveurs.

  • Installer Windows SharePoint Services 3.0 de manière automatisée ou à l’aide d’un script.

Dans cet article :

  • Personnalisation du fichier Config.xml

  • Aide-mémoire sur les éléments du fichier Config.xml

  • Fonctionnement

  • Format du fichier Config.xml

  • Guide de référence sur les éléments du fichier Config.xml

Personnalisation du fichier Config.xml

Pour contrôler les options d’installation, vous devez commencer par modifier le fichier Config.xml dans un éditeur de texte afin d’y inclure les éléments que vous souhaitez ainsi que leurs paramètres. Exécutez ensuite setup.exe /config [path and file name] pour faire en sorte que le fichier Setup.exe soit exécuté en utilisant les options définies dans Config.xml.

ImportantImportant :

Utilisez un éditeur de texte comme le Bloc-notes pour modifier le fichier Config.xml. N’utilisez pas un éditeur XML générique comme Microsoft Office Word 2007.

Le DVD du produit contient un certain nombre d’exemples de fichiers Config.xml. Ces fichiers se trouvent dans le dossier \Files présent à la racine du DVD, dans des dossiers correspondant à différents scénarios. En voici la liste :

  • Setup : contient un fichier config.xml à utiliser pour configurer une nouvelle installation. Une fois l’installation terminée, vous devez exécuter psconfig.exe pour terminer la configuration du serveur ou de la batterie de serveurs.

  • SetupFarmSilent : contient un fichier config.xml à utiliser pour configurer une batterie de serveurs en mode silencieux.

  • SetupGradualUpgradeSilent : contient un fichier config.xml à utiliser pour mettre progressivement à niveau une batterie de serveurs existante.

  • SetupSilent : contient un fichier config.xml à utiliser pour configurer une nouvelle installation d’un serveur unique (serveur autonome avec base de données interne Windows) en mode silencieux.

  • SetupUpgradeSilent : contient un fichier config.xml à utiliser pour mettre progressivement à niveau une batterie de serveurs existante.

ImportantImportant :

Les fichiers de configuration par défaut inclus dans Windows SharePoint Services 3.0 ne mentionnent pas le paramètre SETUP_REBOOT. Vous devez inclure ce paramètre si vous souhaitez éviter des redémarrages pendant une installation en ligne de commande.

Pour plus d’informations sur les différences existant entre les différents scénarios de mise à niveau, reportez-vous à la section Déterminer l’approche de mise à niveau [Windows SharePoint Services].

Aide-mémoire sur les éléments du fichier Config.xml

Le tableau ci-dessous répertorie les éléments du fichier Config.xml. Ces éléments peuvent être placés dans n’importe quel ordre, à l’exception de l’élément Configuration, qui doit être le premier élément du fichier, et des éléments tels que Command, dont la place dans le fichier Config.xml influe sur le traitement au cours de l’installation.

Élément

Description

Configuration

Élément de niveau supérieur.

ARP

Valeurs déterminant le texte affiché pour le produit dans la rubrique Ajouter ou supprimer des programmes du Panneau de configuration ainsi que le comportement du produit dans cette rubrique.

Command

Exécute une commande au cours de l’installation.

Display

Niveau d’interface utilisateur affiché pour l’utilisateur par le programme d’installation.

Logging

Options déterminant le type de journalisation mis en œuvre par le programme d’installation.

DATADIR

Emplacement à utiliser pour stocker les fichiers de données.

Package

Package ou produit à installer.

Setting

Valeurs des propriétés de Windows Installer.

Fonctionnement

Le programme d’installation recherche une copie du fichier Config.xml dans le dossier où se trouve Setup.exe. Si aucune copie n’est détectée, il utilise le fichier Config.xml présent dans le dossier \Files principal du produit que vous installez.

Vous pouvez également utiliser l’option de ligne de commande /config du programme d’installation pour indiquer l’emplacement du fichier Config.xml. Exemple :

\\<serveur>\<partage>\setup.exe /config \\<serveur>\<partage>\<dossier>\config.xml

Format du fichier Config.xml

Les éléments XML du fichier Config.xml commencent par < et se terminent par />.

Le format de base des éléments est le suivant :

<nom_élément [nom_attribut="valeur"] [nom_attribut="valeur"] … />

Exemple :

<Display Level="none" CompletionNotice="no" />

Les éléments et les attributs respectent la casse. Les valeurs des attributs doivent être entourées de guillemets (" ") et ne respectent pas la casse.

Une définition d’élément peut s’étendre sur plusieurs lignes. Les espaces, retours chariot, sauts de ligne et caractères de tabulation insérés dans une définition d’élément sont ignorés.

Exemple :

<Display
   Level="none"
   CompletionNotice="no"
/>
TipConseil :

Dans le cas de définitions d’élément longues, placez les attributs sur des lignes séparées et utilisez des retraits pour faciliter la lecture du fichier.

L’élément Configuration est un cas particulier. Cet élément est obligatoire. Tous les autres éléments sont contenus dans cet élément de niveau supérieur. Il est fermé par </Configuration>.

L’exemple ci-dessous présente un fichier de configuration pour une nouvelle installation du package 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>

Important : Les fichiers de configuration par défaut inclus dans Windows SharePoint Services 3.0 ne mentionnent pas le paramètre SETUP_REBOOT. Vous devez inclure ce paramètre si vous souhaitez éviter les redémarrages pendant l’installation en ligne de commande.

Vous pouvez ajouter des commentaires où vous le souhaitez en les délimitant par « <!-- » et « -->».

Exemple :

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

Guide de référence sur les éléments du fichier Config.xml

Les conventions ci-dessous sont utilisées dans les descriptions de ce guide de référence :

gras

Nom d’élément ou d’attribut

normal

Texte à entrer en recopiant exactement le texte indiqué

*italique*

Espace réservé pour une valeur à ajouter

*x*|*y*

Choisissez entre plusieurs valeurs

[*x*]

Valeur facultative

Élément Configuration

Élément de niveau supérieur. Cet élément est obligatoire et tous les autres éléments doivent être inclus dans cet élément.

Syntaxe

<Configuration>

<Package Id="ID">

...

</Package>

...

</Configuration>

Attributs

Attribut

Valeur

Description

Package ID

*ID de package*

Package à installer.

Remarques

L’attribut Package Id identifie le produit et les technologies concernés par ce fichier Config.xml.

Exemple

L’ID de package de Windows SharePoint Services 3.0 est sts. Utilisez l’ID de package sts dans le fichier Config.xml pour indiquer que vous souhaitez installer Windows SharePoint Services 3.0 en entrant la chaîne suivante :

<Configuration>
   <Package Id="sts">
   ...
   </Package>
   ...
</Configuration>

Élément ARP

Spécifie des valeurs déterminant le texte affiché pour le produit dans la rubrique Ajouter ou supprimer des programmes du Panneau de configuration ainsi que le comportement du produit dans cette rubrique.

Syntaxe

<ARP attribut**="valeur"** [attribut**="valeur"**] ... />

Attributs

Attribut

Valeur

Description

ARPCOMMENTS

*texte*

Texte supplémentaire pouvant comprendre jusqu’à 255 caractères. Sachez cependant que tous les caractères risquent de ne pas s’afficher.

ARPCONTACT

*texte*

Liste de coordonnées de services de support technique.

ARPNOMODIFY

Yes

Empêche les utilisateurs de modifier les paramètres d’installation du produit en masquant le bouton Modifier.

No (par défaut)

Autorise les utilisateurs à modifier les paramètres d’installation du produit.

ARPNOREMOVE

Yes

Empêche les utilisateurs de supprimer le produit en masquant le bouton Supprimer.

No (par défaut)

Autorise les utilisateurs à supprimer le produit.

ARPURLINFOABOUT

*URL*

URL de la page d’accueil du produit.

ARPURLUPDATEINFO

*URL*

URL permettant d’obtenir des informations sur les mises à jour du produit.

ARPHELPLINK

*URL*

URL d’un site Web à partir de laquelle les utilisateurs peuvent bénéficier d’un support technique.

ARPHELPTELEPHONE

*texte*

Numéros de téléphone du service de support technique.

Élément Command

Spécifie une ligne de commande à exécuter. Les commandes de l’élément Command sont traitées uniquement dans le cadre des installations initiales et des désinstallations. Si les commandes de l’élément Command sont utilisées pour des personnalisations après l’installation initiale, elles sont ignorées.

Syntaxe

<Command

Path="chemin_d’accès"

[QuietArg="arguments"]

[Args="arguments"]

[ChainPosition="Before" | "After"(par défaut)]

[Wait="millisecondes"]

[QuietWait="millisecondes"]

[Execute="Install"(par défaut) | "Uninstall"]

[Platform="x86"(par défaut) | "x64"]

/>

Attributs

Vous pouvez insérer des guillemets droits (") dans les attributs Path et Args en utilisant deux guillemets consécutifs ("").

Attribut

Valeur

Description

Path

*chemin d’accès*

Chemin d’accès complet au fichier exécutable du package Microsoft® Windows Installer (MSI).

QuietArg

*chaîne*

Chaîne d’arguments à ajouter à la fin de la ligne de commande lorsque Level=None pour l’élément Display.

Args

*chaîne*

Chaîne d’arguments à transmettre à l’exécutable.

ChainPosition

Before

Cette commande est exécutée avant l’installation du produit principal.

After (par défaut)

Cette commande est exécutée après l’installation du produit principal.

Wait

*millisecondes*

Lorsque vous effectuez une installation en définissant l’attribut Level de l’élément Display sur « Full » ou « Basic », cette valeur définit le nombre de millisecondes à attendre entre l’exécution du programme et la poursuite de l’installation. La valeur par défaut est 0 (zéro), qui définit un délai d’attente nul.

QuietWait

*millisecondes*

Lorsque vous effectuez une installation en définissant l’attribut Level de l’élément Display sur « None », cette valeur définit le nombre de millisecondes à attendre entre l’exécution du programme et la poursuite de l’installation. La valeur par défaut est 0 (zéro), qui définit un délai d’attente nul.

Execute

Install (par défaut)

Le programme d’installation exécute cette commande lorsque le produit principal est installé.

Uninstall

Le programme d’installation exécute cette commande lorsque le produit principal est désinstallé.

Platform

x86 (par défaut)

Permet de spécifier que ce programme requiert une plateforme Intel x86. Cette commande s’exécute uniquement si l’ordinateur sur lequel l’installation est exécutée correspond à cette plateforme.

x64

Permet de spécifier que ce programme requiert un processeur 64 bits prenant en charge les extensions x64 de l’architecture x86. Cette commande s’exécute uniquement si l’ordinateur sur lequel l’installation est exécutée correspond à cette plateforme.

Remarques

La ligne de commande peut être spécifiée pour une installation chaînée ou un fichier exécutable qui s’exécute lorsque ce produit est installé. Si elle est spécifiée, vous devez spécifier une ligne de commande pour Setup.exe plutôt qu’un seul fichier MSI.

Si deux éléments Command ou plus sont présents dans le fichier Config.xml, ils sont exécutés dans l’ordre spécifié dans Config.xml.

Exemple

<Command Path=”myscript.exe” Args=”/id ""123 abc"" /q”/>

<Command Path="\\<server>\<share>\setup.exe /config \\<server>\<share>\<folder>\config.xml"

Élément DATADIR

Emplacement à utiliser pour stocker les fichiers de données, y compris les fichiers d’index de recherche.

Syntaxe

<DATADIR Value="chemin_d’accès"/>

Attributs

Attribut

Valeur

Description

Value

chemin d’accès

Le programme d’installation stocke les fichiers de données dans l’emplacement spécifié.

Remarques

Vous pouvez utiliser les variables d’environnement du système dans le chemin d’accès. Si cet élément n’est pas spécifié, les données sont stockées dans le chemin d’accès suivant :

%ProgramFiles%\Microsoft SQL Server\MSSQL$SHAREPOINT\Data

Exemple

<DATADIR Value=”d:\data”/>

Élément Display

Niveau d’interface utilisateur affiché pour l’utilisateur par le programme d’installation.

Syntaxe

<Display

Level="None" | "Basic" | "Full"(par défaut)

CompletionNotice="Yes"(par défaut) | "No"

SuppressModal="Yes" | "No"(par défaut)

NoCancel="Yes" | "No"(par défaut)

AcceptEula="Yes" | "No"(par défaut)

/>

Attributs

Attribut

Valeur

Description

Level

None

Aucune interface de programme d’installation ne s’affiche.

Basic

Le programme d’installation affiche l’écran d’accueil, la page Termes du contrat de licence logiciel Microsoft (le cas échéant), une barre de progression et l’avertissement de fin d’opération (s’il est autorisé).

Full (par défaut)

Le programme d’installation affiche l’ensemble de l’interface à l’utilisateur.

CompletionNotice

Yes

S’applique uniquement si Level est défini sur « Basic » ou « None » : le programme d’installation affiche l’avertissement de fin d’opération.

No (par défaut)

S’applique uniquement si Level est défini sur « Basic » : le programme d’installation n’affiche pas l’avertissement de fin d’opération.

SuppressModal

Yes

S’applique uniquement si Level est défini sur « Basic » : le programme d’installation n’affiche pas les messages d’erreur ni les autres boîtes de dialogue susceptibles d’interrompre l’installation.

No (par défaut)

S’applique uniquement si Level est défini sur « Basic » : le programme d’installation affiche les erreurs et les autres boîtes de dialogue, le cas échéant.

NoCancel

Yes

Si Level est défini sur « Full » ou « Basic », cette valeur désactive le bouton d’annulation (la croix qui se trouve dans le coin supérieur droit de la boîte de dialogue de progression).

No (par défaut)

Si Level est défini sur « Full » ou « Basic », cette valeur autorise l’utilisateur à annuler l’installation à partir de la boîte de dialogue de progression.

AcceptEULA

Yes

Les termes du contrat de licence logiciel Microsoft sont acceptés pour le compte de l’utilisateur ; le programme d’installation n’affiche pas la page Termes du contrat de licence logiciel Microsoft.

No (par défaut)

Si Level n’est pas défini sur « None», le programme d’installation affiche la page Termes du contrat de licence logiciel Microsoft.

Remarques

Si cet élément n’est pas défini, les paramètres par défaut sont utilisés. Si une valeur non valide est spécifiée, le programme d’installation termine l’installation.

NoteRemarque :

L’élément Display n’est utilisé par le programme d’installation que si ce dernier détecte le fichier Config.xml dans le même dossier que setup.exe ou si vous spécifiez le fichier Config.xml en utilisant l’option de ligne de commande /config du programme d’installation.

Exemple

<Display Level=”basic”
   CompletionNotice=”yes”
   SupressModal=”no”
   AcceptEula=”yes”
/>

Élément Logging

Spécifie le type de journalisation mise en œuvre par le programme d’installation.

Syntaxe

<Logging

Type="Off" | "Standard"(par défaut) | "Verbose"

Path="chemin_d’accès"

Template="nom_fichier.txt"

/>

Attributs

Attribut

Valeur

Description

Type

Off

Le programme d’installation n’effectue pas de journalisation.

Standard (par défaut)

Le programme d’installation écrit les informations d’installation dans le fichier journal.

Verbose

Le programme d’installation écrit toutes les informations d’installation dans le fichier journal.

Path

*Chemin d’accès*

Chemin d’accès complet au dossier utilisé pour stocker le fichier journal. Vous pouvez utiliser des variables d’environnement. La valeur par défaut est %temp%.

Template

*nom_fichier*.txt

Nom du fichier journal. Si vous insérez la chaîne * dans le nom du fichier, un fichier journal unique est créé pour chaque installation réalisée par Setup.exe (consultez les explications ci-dessous). Si vous n’insérez pas * dans le nom de fichier et que le nom spécifié existe déjà, les informations sont ajoutées à la fin du fichier journal existant. L’extension de fichier .txt doit être incluse. Le modèle par défaut est SetupExe(*).log.

Remarques

Vous pouvez spécifier un signe * n’importe où dans la valeur Template. Le programme d’installation insère une chaîne à cet endroit en utilisant le format suivant :

AAAAMMJJHHMMSSxxx

où :

  1. AAAA = Année

  2. MM = Mois

  3. JJ = Jour

  4. HH = Heure

  5. MM = Minutes

  6. SS = Secondes

  7. xxx = chaîne unique générée par le programme d’installation

NoteRemarque :

L’élément Logging est utilisé par le programme d’installation uniquement si vous spécifiez le fichier Config.xml par le biais de l’option de ligne de commande /config du programme d’installation. Si vous ne spécifiez pas de fichier Config.xml à utiliser, le programme d’installation utilise les options de journalisation par défaut.

Exemple

<Logging Type=”standard” Path=”%temp%”
   Template=”MyLog(*).txt”
/>

Dans cet exemple, le programme d’installation crée un fichier journal à chaque installation du produit. Il utilise des noms de fichier uniques tels que :

%temp%\MyLog(20060428110717CFC).txt
%temp%\MyLog(20060429113143C70).txt

Élément Package

Package ou produit à installer.

L’ID de package de Windows SharePoint Services 3.0 est sts.

Élément Setting

Permet de spécifier des valeurs pour les propriétés de Windows Installer.

Syntaxe

<Setting Id="nom" Value="valeur" />

Attributs

Attribut

Valeur

Description

Id

*nom*

Nom de la propriété Windows Installer.

Value

*valeur*

Valeur à attribuer à la propriété.

Valeurs

Les ID de paramètres ci-dessous sont utilisés pour les installations de serveur :

ID

Valeurs acceptées

Description

REBOOT

ReallySuppress

Spécifie (pour Windows Installer) s’il faut ou non autoriser un redémarrage une fois l’installation terminée. Utilisez ReallySuppress pour éviter un redémarrage. Ce paramètre doit être spécifié au niveau global et non pour chaque package.

SETUP_REBOOT

Never, AutoAlways, Always, AutoIfNeeded, IfNeeded

Spécifie (pour Setup.exe) s’il faut ou non autoriser un redémarrage une fois l’installation terminée. Utilisez Never pour éviter un redémarrage. Ce paramètre doit être spécifié au niveau global et non pour chaque package.

SETUPTYPE

CLEAN_INSTALL, V2V_GRADUAL_UPGRADE, V2V_INPLACE_UPGRADE

Spécifie s'il est nécessaire d'installer une nouvelle copie du produit ou de la technologie (CLEAN_INSTALL), installer la nouvelle version parallèlement à la version précédente pour une mise à niveau progressive (V2V_GRADUAL_UPGRADE), installer la nouvelle version et mettre à niveau la version précédente existante (V2V_INPLACE_UPGRADE). Ce paramètre doit être spécifié au niveau global et non pour chaque package.

SETUPCALLED

0 | 1

Utilisez cette valeur dans l’attribut Package ID.

SERVERROLE

SINGLESERVER, WFE

Spécifie le type de serveur sur lequel vous installez le produit : serveur autonome (SINGLESERVER) ou serveur Web frontal (WFE).

USINGUIINSTALLMODE

0 | 1

Spécifie si l’installation est effectuée en mode silencieux (0) ou par le biais de l’interface utilisateur du programme d’installation (1).

Remarques

Les propriétés Windows Installer ne peuvent pas toutes être spécifiées dans l’élément Setting. Si une propriété bloquée est spécifiée, le programme d’installation met un terme au processus d’installation. Si une propriété prise en charge est spécifiée, le programme d’installation transmet directement la propriété à Windows Installer.

Exemple

<Setting Id="REBOOT" Value="ReallySuppress" />

Télécharger ce livre

Cette rubrique figure dans le livre à télécharger suivant pour faciliter la lecture et l'impression :

Voir la liste complète des livres disponibles sur Livres à télécharger pour Windows SharePoint Services.