Informazioni di riferimento per Config.xml (Windows SharePoint Services)

Se si desidera controllare la modalità di installazione di Microsoft Windows SharePoint Services 3.0, utilizzare il file Config.xml insieme a Setup.exe. È ad esempio possibile utilizzare il file Config.xml per eseguire le operazioni seguenti:

• Eseguire un'installazione invisibile all'utente di Microsoft Windows SharePoint Services 3.0.

• Installare Microsoft Windows SharePoint Services 3.0 utilizzando una configurazione comune in più server.

• Eseguire un'installazione automatica o tramite script di Microsoft Windows SharePoint Services 3.0.

Contenuto dell'articolo:

• Personalizzazione di Config.xml

• Informazioni di riferimento rapido sugli elementi di Config.xml

• Funzionamento

• Formato del file Config.xml

• Informazioni di riferimento sugli elementi di Config.xml

Personalizzazione di Config.xml

Per controllare l'installazione, è necessario innanzitutto modificare il file Config.xml in un editor di testo in modo da includere gli elementi necessari con le impostazioni appropriate per tali elementi. Eseguire quindi setup.exe /config [path and file name] per specificare che Setup.exe venga eseguito utilizzando le opzioni impostate nel file Config.xml.

Nel DVD del prodotto sono contenuti esempi di file Config.xml. Tali file di esempio sono disponibili nella sottocartella \Files della cartella principale del DVD, all'interno di cartelle corrispondenti a diversi scenari. Tali cartelle sono le seguenti:

• Setup   Contiene un file Config.xml da utilizzare per effettuare un'installazione pulita. Dopo aver eseguito il programma di installazione, è necessario eseguire psconfig.exe per completare la configurazione del server o della server farm.

• SetupFarmSilent   Contiene un file Config.xml da utilizzare per installare una server farm in modalità invisibile all'utente.

• SetupGradualUpgradeSilent   Contiene un file Config.xml da utilizzare per aggiornare gradualmente una server farm esistente.

• SetupSilent   Contiene un file Config.xml da utilizzare per effettuare un'installazione pulita per un singolo server (autonomo e con Database interno di Windows) in modalità invisibile all'utente.

• SetupUpgradeSilent   Contiene un file Config.xml da utilizzare per aggiornare in modalità automatica una server farm esistente.

Per ulteriori informazioni sulle differenze tra i diversi scenari di aggiornamento, vedere Determinare il metodo di aggiornamento [Windows SharePoint Services].

Informazioni di riferimento rapido sugli elementi di Config.xml

Nella tabella che segue è riportato un elenco degli elementi inclusi in Config.xml. Tali elementi possono comparire in qualsiasi ordine, ad eccezione di Configuration, che deve essere il primo, e di elementi quali Command, il cui ordine in Config.xml influisce sull'ordine di elaborazione durante l'installazione.

Elemento	Descrizione
Configuration	Elemento principale.
ARP	Valori che controllano il testo e il comportamento di Installazione applicazioni nel Pannello di controllo del prodotto.
Command	Esegue un comando durante l'installazione.
Display	Livello di interfaccia utente visualizzato all'utente dal programma di installazione.
Logging	Opzioni per il tipo di registrazione effettuata dal programma di installazione.
DATADIR	Percorso da utilizzare per l'archiviazione dei file di dati.
Package	Pacchetto o prodotto da installare.
Setting	Valori delle proprietà di Windows Installer.

Funzionamento

Il programma di installazione cerca una copia di Config.xml nella stessa cartella di Setup.exe. Se non viene trovata una copia in tale percorso, viene utilizzato il file Config.xml disponibile nella cartella \Files del prodotto che si sta installando.

Per specificare il percorso del file Config.xml, è inoltre possibile utilizzare l'opzione della riga di comando /config di Setup. Ad esempio:

\\<server>\<condivisione>\setup.exe /config \\<server>\<condivisione>\<cartella>\config.xml

Formato del file Config.xml

Gli elementi XML di Config.xml iniziano con < e terminano con />.

Il formato di base degli elementi è il seguente:

<nome_elemento [nome_attributo="valore"] [nome_attributo="valore"] … /> 

Ad esempio:

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

Per gli elementi e gli attributi viene rilevata la distinzione tra maiuscole e minuscole. I valori degli attributi devono essere delimitati da virgolette ("), ma per essi non viene rilevata la distinzione tra maiuscole e minuscole.

La definizione di un elemento può estendersi su più righe e all'interno di tale definizione vengono ignorati gli spazi, i ritorni a capo, gli avanzamenti riga e i caratteri di tabulazione.

Ad esempio:

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

L'elemento Configuration è particolare ed obbligatorio. Tutti gli altri elementi sono contenuti all'interno di Configuration e tale elemento è chiuso da </Configuration>.

Nell'esempio seguente è illustrato un file di configurazione di esempio per un'installazione pulita del pacchetto Microsoft 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>

Importante   Nei file di configurazione predefiniti disponibili in Microsoft Windows SharePoint Services 3.0 non è presente l'impostazione SETUP_REBOOT. Se si desidera che non vengano eseguiti i riavvii durante un'installazione da riga di comando, è necessario includere questa impostazione.

I commenti possono essere aggiunti in qualsiasi punto e devono essere delimitati da "<!--" e "-->".

Ad esempio:

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

Informazioni di riferimento sugli elementi di Config.xml

Nelle descrizioni di questa sezione di riferimento vengono utilizzate le convenzioni seguenti:

grassetto	Nome di elemento o di attributo
normale	Testo da immettere esattamente come mostrato
*corsivo*	Segnaposto per un valore da aggiungere
*x*|*y*	Scelta tra più valori
[*x*]	Valore facoltativo

Elemento Configuration

Elemento principale. È obbligatorio e tutti gli altri elementi devono comparire all'interno di esso.

Sintassi

<Configuration>

<Package Id="ID">

...

</Package>

...

</Configuration>

Attributi

Attributo	Valore	Descrizione
Package ID	*ID pacchetto*	Pacchetto da installare.

Osservazioni

L'attributo Package Id identifica il prodotto e le tecnologie interessati dal file Config.xml.

Esempio

L'ID pacchetto (Package Id) per Microsoft Windows SharePoint Services 3.0 è sts. Utilizzare l'ID pacchetto sts ID in Config.xml per specificare Microsoft Windows SharePoint Services 3.0 immettendo quanto segue:

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

Elemento ARP

Specifica valori che controllano il testo e il comportamento di Installazione applicazioni nel Pannello di controllo del prodotto.

Sintassi

<ARP attributo**="valore"** [attributo**="valore"**] ... /> 

Attributi

Attributo	Valore	Descrizione
ARPCOMMENTS	*testo*	Testo aggiuntivo fino a un massimo di 255 caratteri, anche se è possibile che non vengano visualizzati tutti.
ARPCONTACT	*testo*	Elenco di contatti di supporto tecnico.
ARPNOMODIFY	Yes	Impedisce agli utenti di modificare l'installazione del prodotto rendendo non disponibile il pulsante Cambia.
	No (valore predefinito)	Consente agli utenti di modificare l'installazione del prodotto.
ARPNOREMOVE	Yes	Impedisce agli utenti di rimuovere il prodotto rendendo non disponibile il pulsante Rimuovi.
	No (valore predefinito)	Consente agli utenti di rimuovere il prodotto.
ARPURLINFOABOUT	*URL*	URL della home page del prodotto.
ARPURLUPDATEINFO	*URL*	URL delle informazioni sugli aggiornamenti del prodotto.
ARPHELPLINK	*URL*	URL di un sito Web da cui gli utenti possono ricevere supporto tecnico.
ARPHELPTELEPHONE	*testo*	Numeri telefonici di supporto tecnico.

Elemento Command

Specifica una riga di comando da eseguire. I comandi dell'elemento Command vengono elaborati solo durante le installazioni iniziali e le disinstallazioni. Se utilizzati per le personalizzazioni dopo l'installazione iniziale, vengono ignorati.

Sintassi

<Command

Path="percorso"

[QuietArg="argomenti"]

[Args="argomenti"]

[ChainPosition="Before" | "After"(valore predefinito)]

[Wait="millisecondi"]

[QuietWait="millisecondi"]

[Execute="Install"(valore predefinito) | "Uninstall"]

[Platform="x86"(valore predefinito) | "x64"]

/>

Attributi

È possibile specificare le virgolette (") all'interno degli attributi Path e Args inserendo due volte di seguito il carattere corrispondente ("").

Attributo	Valore	Descrizione
Path	*percorso*	Percorso completo del file del pacchetto MSI (Microsoft® Windows Installer) eseguibile.
QuietArg	*stringa*	Stringa di argomenti da aggiungere alla riga di comando quando Display Level=None.
Args	*stringa*	Stringa di argomenti da passare all'eseguibile.
ChainPosition	Before	Questo comando viene eseguito prima dell'installazione del prodotto principale.
	After (valore predefinito)	Questo comando viene eseguito dopo l'installazione del prodotto principale.
Wait	*millisecondi*	Quando si esegue l'installazione con l'attributo Display Level impostato su "Full" o "Basic", questo è il numero di millisecondi da attendere dopo l'esecuzione del programma prima di proseguire con l'installazione. Il valore predefinito è 0 (zero), ovvero nessun tempo di attesa.
QuietWait	*millisecondi*	Quando si esegue l'installazione con l'attributo Display Level impostato su "None", questo è il numero di millisecondi da attendere dopo l'esecuzione del programma prima di proseguire con l'installazione. Il valore predefinito è 0 (zero), ovvero nessun tempo di attesa.
Execute	Install (valore predefinito)	Questo comando viene eseguito quando viene installato il prodotto principale.
	Uninstall	Questo comando viene eseguito quando viene disinstallato il prodotto principale.
Platform	x86 (valore predefinito)	Specifica che il programma richiede la piattaforma Intel x86. Questo comando viene eseguito solo se il computer in cui viene effettuata l'installazione è della piattaforma richiesta.
	x64	Specifica che il programma richiede un processore a 64 bit in grado di supportare le estensioni x64 per l'architettura x86. Questo comando viene eseguito solo se il computer in cui viene effettuata l'installazione è della piattaforma richiesta.

Osservazioni

La riga di comando può essere specificata per un'installazione concatenata o per un eseguibile da eseguire al momento dell'installazione del prodotto. In tal caso, è necessario specificare una riga di comando per Setup.exe anziché un singolo file MSI.

Se nel file Config.xml sono presenti due o più elementi Command, questi verranno eseguiti nell'ordine in cui sono specificati nel file Config.xml.

Esempio

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

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

Elemento DATADIR

Percorso da utilizzare per archiviare i file di dati, inclusi i file degli indici di ricerca.

Sintassi

<DATADIR Value="percorso"/>

Attributi

Attributo	Valore	Descrizione
Value	percorso	I file di dati vengono archiviati nel percorso specificato.

Osservazioni

Nel percorso è possibile utilizzare variabili di ambiente di sistema. Se questo elemento non viene specificato, i dati verranno archiviati nel percorso seguente:

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

Esempio

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

Elemento Display

Livello di interfaccia utente visualizzato all'utente dal programma di installazione.

Sintassi

<Display

Level="None" | "Basic" | "Full" (valore predefinito)

CompletionNotice="Yes" (valore predefinito) | "No"

SuppressModal="Yes" | "No" (valore predefinito)

NoCancel="Yes" | "No" (valore predefinito)

AcceptEula="Yes" | "No" (valore predefinito)

/>

Attributi

Attributo	Valore	Descrizione
Level	None	L'interfaccia utente del programma di installazione non viene visualizzata.
	Basic	Vengono visualizzati la schermata di benvenuto, la pagina Condizioni di licenza software Microsoft (se necessaria), un indicatore di stato e l'avviso di completamento (se consentito).
	Full (valore predefinito)	Viene visualizzata l'interfaccia utente completa.
CompletionNotice	Yes	Si applica solo se Level è impostato su "Basic" o "None". Viene visualizzato l'avviso di completamento.
	No (valore predefinito)	Si applica solo se Level è impostato su "Basic". Non viene visualizzato l'avviso di completamento.
SuppressModal	Yes	Si applica solo se Level è impostato su "Basic". Non vengono visualizzati messaggi di errore o altre finestre di dialogo che potrebbero interrompere l'installazione.
	No (valore predefinito)	Si applica solo se Level è impostato su "Basic". Vengono visualizzati gli errori e le altre finestre di dialogo secondo i casi.
NoCancel	Yes	Se Level è impostato su "Full" o "Basic", disabilita il pulsante di annullamento (X nell'angolo superiore destro della finestra di dialogo relativa allo stato).
	No (valore predefinito)	Se Level è impostato su "Full" o "Basic", consente all'utente di annullare l'installazione dall'indicatore di stato.
AcceptEULA	Yes	Le condizioni di licenza software Microsoft vengono accettate per conto dell'utente. Non viene pertanto visualizzata la pagina Condizioni di licenza software Microsoft.
	No (valore predefinito)	Se Level è impostato su "None", viene visualizzata la pagina Condizioni di licenza software Microsoft.

Osservazioni

Se questo elemento non viene definito, vengono utilizzate le impostazioni predefinite. Se viene specificato un valore non valido, l'installazione viene interrotta.

Esempio

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

Elemento Logging

Specifica il tipo di registrazione effettuata dal programma di installazione.

Sintassi

<Logging

Type="Off" | "Standard" (valore predefinito) | "Verbose"

Path="percorso"

Template="nomefile.txt"

/>

Attributi

Attributo	Valore	Descrizione
Type	Off	Non viene effettuata alcuna registrazione.
	Standard (valore predefinito)	Nel file di registro vengono scritte alcune informazioni relative all'installazione.
	Verbose	Non file di registro vengono scritte tutte le informazioni relative all'installazione.
Path	*percorso*	Percorso completo della cartella utilizzata per il file di registro. È possibile utilizzare variabili di ambiente. Il valore predefinito è %temp%.
Template	*nomefile*.txt	Nome del file di registro. Se si inserisce la stringa * in un punto qualsiasi del nome del file, verrà creato un file di registro per ogni installazione eseguita da Setup.exe. Vedere più avanti la descrizione specifica. Se non si inserisce * e il nome del file specificato già esiste, le informazioni di registrazione verranno aggiunte alla fine del file esistente. È necessario includere l'estensione .txt del file. Il modello predefinito è SetupExe(*).log.

Osservazioni

È possibile specificare * in qualsiasi punto del valore Template. In tale punto verrà quindi inserita una stringa nel formato seguente:

AAAAMMGGHHMMSSxxx

dove:

1. AAAA = Anno

2. MM = Mese

3. GG = Giorno

4. HH = Ora

5. MM = Minuti

6. SS = Secondi

7. xxx = stringa univoca generata dal programma di installazione

Esempio

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

Con questo esempio viene creato un file di registro ogni volta che si installa il prodotto. Verranno utilizzati nomi di file univoci, come mostrato di seguito:

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

Elemento Package

Pacchetto o prodotto da installare.

L'ID pacchetto (Package Id) per Microsoft Windows SharePoint Services 3.0 è sts.

Impostazione Setting

Consente di specificare valori per le proprietà di Windows Installer.

Sintassi

<Setting Id="nome" Value="valore" />

Attributi

Attributo	Valore	Descrizione
Id	*nome*	Nome della proprietà di Windows Installer.
Value	*valore*	Valore da assegnare alla proprietà.

Valori

Per le installazioni server vengono utilizzati i valori seguenti per l'attributo ID dell'elemento Setting:

ID	Valori accettati	Descrizione
REBOOT	ReallySuppress	Specifica (per Windows Installer) se consentire o meno un riavvio dopo il completamento dell'installazione. Utilizzare ReallySuppress per specificare di non eseguire riavvii. Deve essere specificato a livello globale, non per il singolo pacchetto.
SETUP_REBOOT	Never, AutoAlways, Always, AutoIfNeeded, IfNeeded	Specifica (per Setup.exe) se consentire o meno un riavvio dopo il completamento dell'installazione. Utilizzare Never per specificare di non eseguire riavvii. Deve essere specificato a livello globale, non per il singolo pacchetto.
SETUPTYPE	CLEAN_INSTALL, V2V_GRADUAL_UPGRADE, V2V_INPLACE_UPGRADE	Specifica se installare una nuova copia del prodotto o della tecnologia (CLEAN_INSTALL), installare la nuova versione affiancata alla versione precedente per un aggiornamento graduale (V2V_GRADUAL_UPGRADE), installare la nuova versione e aggiornare quella precedente sul posto (V2V_INPLACE_UPGRADE). Deve essere specificato a livello globale, non per il singolo pacchetto.
SETUPCALLED	0 | 1	Da utilizzare come parte dell'attributo Package Id.
SERVERROLE	SINGLESERVER, WFE	Specifica il tipo di server in cui si intende effettuare l'installazione: server autonomo (SINGLESERVER) o server Web front-end (WFE).
USINGUIINSTALLMODE	0 | 1	Specifica se eseguire un'installazione in modalità invisibile all'utente (0) o utilizzando l'interfaccia utente per il programma di installazione (1).

Osservazioni

Nell'elemento Setting non è possibile specificare tutte le proprietà di Windows Installer. Se si specifica una proprietà bloccata, il processo di installazione verrà interrotto. Se invece si specifica una proprietà supportata, questa verrà passata direttamente a Windows Installer.

Esempio

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

Scaricare il manuale

Questo argomento è incluso nel manuale seguente, che può essere scaricato per una lettura e una stampa più agevoli:

• Guida all'installazione di Windows SharePoint Services 3.0

Per un elenco completo dei manuali disponibili che è possibile scaricare per Windows SharePoint Services, vedere Downloadable books for Windows SharePoint Services (informazioni in lingua inglese).