Riferimento per Config.xml (Office SharePoint Server)

Se si desidera controllare il modo in cui Microsoft Office SharePoint Server 2007 viene installato, utilizzare il file Config.xml insieme al file Setup.exe. È ad esempio possibile utilizzare il file config.xml file per:

• Eseguire un'installazione invisibile all'utente di Microsoft Office SharePoint Server 2007.

• Installare Microsoft Office SharePoint Server 2007 utilizzando una configurazione comune su più server.

• Eseguire un'installazione automatica o tramite script di Microsoft Office SharePoint Server 2007.

Contenuto dell'articolo:

• Personalizzazione di Config.xml

• Riferimento rapido per l'elemento Config.xml

• Modalità di funzionamento

• Formato file di Config.xml

• Riferimento per l'elemento Config.xml

Personalizzazione di Config.xml

Per controllare l'installazione, modificare innanzitutto 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 il file Setup.exe viene eseguito e utilizza le opzioni impostate nel file Config.xml.

Il DVD del prodotto include esempi di file Config.xml. Tali file sono memorizzati nella cartella \Files nella directory principale del DVD, in cartelle che corrispondono ai diversi scenari. Le cartelle sono:

• Setup Include un file config.xml da utilizzare per l'impostazione di un'installazione pulita per un singolo server (autonomo, con SQL Express).

• SetupFarm Include un file config.xml da utilizzare per l'impostazione di un'installazione pulita per una server farm.

• SetupFarmSidebySide Include un file config.xml da utilizzare per l'aggiornamento graduale di una server farm esistente.

• SetupFarmSilent Include un file config.xml da utilizzare per l'impostazione di una server farm in modalità invisibile all'utente.

• SetupFarmUpgrade Include un file config.xml da utilizzare per l'aggiornamento di una server farm esistente sul posto.

• SetupSilent Include un file config.xml da utilizzare per l'impostazione di un'installazione pulita per un singolo server (autonomo, con SQL Express) in modalità invisibile all'utente.

• SetupSingleUpgrade Include un file config.xml da utilizzare per l'aggiornamento di un singolo server esistente (autonomo) sul posto.

Per ulteriori informazioni sulle differenze tra i diversi scenari di aggiornamento, vedere Determinare il metodo di aggiornamento (Office SharePoint Server).

Riferimento rapido per l'elemento Config.xml

Nella tabella seguente è incluso un elenco degli elementi presenti nel file Config.xml. Questi elementi possono essere visualizzati in qualsiasi ordine, ad eccezione di Configuration, che deve essere visualizzato per primo, e di elementi quali Command, il cui ordine nel file Config.xml influisce sul modo in cui vengono elaborati durante l'installazione.

Elemento	Descrizione
Configuration	Elemento di primo livello.
ARP	Valori che controllano il testo e il comportamento di Installazione applicazioni nel Pannello di controllo per il prodotto.
Command	Consente di eseguire un comando durante l'installazione.
Display	Livello di interfaccia utente visualizzato all'utente dal programma di installazione.
INSTALLLOCATION	Percorso completo della cartella sul computer dell'utente in cui viene installato il prodotto.
Logging	Opzioni per il tipo di registrazione eseguita dal programma di installazione.
DATADIR	Percorso da utilizzare per memorizzare i file di dati.
Package	Pacchetto o prodotto da installare.
PIDKEY	Codice "Product Key"di 25 caratteri per licenze Volume License.
Setting	Valori per le proprietà di Windows Installer.

Modalità di funzionamento

Il programma di installazione ricerca una copia del file Config.xml nella stessa cartella in cui si trova il file Setup.exe. Se in tale cartella non è disponibile alcuna copia, verrà utilizzato il file Config.xml che si trova nella cartella \Files di base del prodotto che si sta installando.

È inoltre possibile utilizzare l'opzione della riga di comando /config del programma di installazione per specificare il percorso del file Config.xml. Ad esempio:

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

Formato file di Config.xml

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

Il formato di base dell'elemento è:

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

Ad esempio:

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

Gli elementi e gli attributi prevedono la distinzione tra maiuscole e minuscole. I valori di attributo devono essere racchiusi tra virgolette (") e non prevedono la distinzione tra maiuscole e minuscole.

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

Ad esempio:

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

L'elemento Configuration è un caso speciale ed è obbligatorio. Tutti gli altri elementi sono contenuti all'interno dell'elemento Configuration e tale elemento termina con </Configuration>.

Nell'esempio riportato di seguito viene 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>

I commenti possono essere aggiunti ovunque e sono 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>

Riferimento per l'elemento Config.xml

Le convenzioni seguenti vengono utilizzate nelle descrizioni in questo riferimento:

grassetto	Nome di elemento o 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 di primo livello. Questo elemento è obbligatorio e tutti gli altri elementi devono trovarsi al suo interno.

Sintassi

<Configuration>

<Package Id="ID">

...

</Package>

...

</Configuration>

Attributi

Attributo	Valore	Descrizione
Package ID	*ID del pacchetto*	Pacchetto in fase di installazione.

Osservazioni

L'attributo Package ID identifica i prodotti e le tecnologie interessate da questo file Config.xml.

Esempio

L'attributo Package ID per Microsoft Office SharePoint Server 2007 is spswfe. Poiché Microsoft Office SharePoint Server 2007 si basa sulla tecnologia di piattaforma di Microsoft Windows SharePoint Services 3.0, per l'esito positivo dell'installazione è necessario installare anche il pacchetto sts (Microsoft Windows SharePoint Services 3.0).

Utilizzare gli attributi Package ID sts e spswfe nel file Config.xml per specificare Microsoft Windows SharePoint Services 3.0 e Microsoft Office SharePoint Server 2007 immettendo quanto segue:

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

Elemento ARP

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

Sintassi

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

Attributi

Attributo	Valore	Descrizione
ARPCOMMENTS	*testo*	Testo aggiuntivo. Può contenere fino a 255 caratteri, anche se è possibile che non vengano visualizzati tutti i caratteri.
ARPCONTACT	*testo*	Elenco di contatti di supporto tecnico.
ARPNOMODIFY	Yes	Impedisce agli utenti di modificare l'installazione del prodotto rendendo il pulsante Cambia non disponibile.
	No (impostazione predefinita)	Consente agli utenti di modificare l'installazione del prodotto.
ARPNOREMOVE	Yes	Impedisce agli utenti di rimuovere il prodotto rendendo il pulsante Rimuovi non disponibile.
	No (impostazione predefinita)	Consente agli utenti di rimuovere il prodotto.
ARPURLINFOABOUT	*URL*	URL della home page del prodotto.
ARPURLUPDATEINFO	*URL*	URL relativo alle informazioni sugli aggiornamenti del prodotto.
ARPHELPLINK	*URL*	URL di un sito Web da cui gli utenti possono ricevere supporto tecnico.
ARPHELPTELEPHONE	*testo*	Numeri di telefono per il 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 tali comandi vengono utilizzati per personalizzazioni successive all'installazione iniziale, verranno ignorati.

Sintassi

<Command

Path="percorso"

[QuietArg="argomenti"]

[Args="arg"]

[ChainPosition="Before" | "After"(default)]

[Wait="millisecondi"]

[QuietWait="millisecondi"]

[Execute="Install"(default) | "Uninstall"]

[Platform="x86"(default) | "x64"]

/>

Attributi

È possibile specificare simboli di virgolette doppie (") negli attributi Path and Args specificando insieme due simboli di virgolette doppie ("").

Attributo	Valore	Descrizione
Path	*percorso*	Percorso completo del file eseguibile del pacchetto Microsoft® Windows Installer (MSI).
QuietArg	*stringa*	Stringa di argomenti da aggiungere alla riga di comando quando Display Level=None.
Args	*stringa*	Stringa di argomenti da passare al file eseguibile.
ChainPosition	Before	Questo comando viene eseguito prima dell'installazione del prodotto primario.
	After (impostazione predefinita)	Questo comando viene eseguito dopo l'installazione del prodotto primario.
Wait	*millisecondi*	Quando si esegue l'installazione con l'attributo Display Level impostato su "Full" o "Basic", tale valore rappresenta il numero di millisecondi di attesa dopo l'esecuzione del programma prima di procedere con l'installazione. Il valore predefinito è 0 (zero), che indica l'assenza di tempo di attesa.
QuietWait	*millisecondi*	Quando si esegue l'installazione con l'attributo Display Level impostato su "None", tale valore rappresenta il numero di millisecondi di attesa dopo l'esecuzione del programma prima di procedere con l'installazione. Il valore predefinito è 0 (zero), che indica l'assenza di tempo di attesa.
Execute	Install (impostazione predefinita)	Questo comando viene eseguito dal programma di installazione quando viene installato il prodotto primario.
	Uninstall	Questo comando viene eseguito dal programma di installazione quando viene disinstallato il prodotto primario.
Platform	x86 (impostazione predefinita)	Specifica che questo programma necessita della piattaforma Intel x86. Questo comando viene eseguito solo se il computer in cui viene eseguita l'installazione soddisfa questo requisito relativo alla piattaforma.
	x64	Specifica che questo programma necessita di un processore a 64 bit che supporta le estensioni x64 all'architettura x86. Questo comando viene eseguito solo se il computer in cui viene eseguita l'installazione soddisfa questo requisito relativo alla piattaforma.

Osservazioni

È possibile specificare la riga di comando per un'installazione concatenata o per un file eseguibile che viene eseguito quando si installa questo prodotto. Se viene specificata, è necessario specificare una riga di comando per il file Setup.exe, anziché per un singolo file MSI.

Se il file Config.xml include due o più elementi Command, tali elementi 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 memorizzare i file di dati, inclusi i file degli indici della ricerca.

Sintassi

<DATADIR Value="percorso"/>

Attributi

Attributo	Valore	Descrizione
Value	percorso	Il programma di installazione memorizza i file di dati nella posizione specificata.

Osservazioni

È possibile utilizzare le variabili di ambiente del sistema nel percorso. Se questo elemento non è specificato, i dati vengono memorizzati nel percorso seguente:

%PROGRAMFILES%\Microsoft Office Servers\12.0\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"(impostazione predefinita)

CompletionNotice="Yes"(default) | "No"

SuppressModal="Yes" | "No"(impostazione predefinita)

NoCancel="Yes" | "No"(impostazione predefinita)

AcceptEula="Yes" | "No"(impostazione predefinita)

/>

Attributi

Attributo	Valore	Descrizione
Level	Nessuna	Non viene visualizzata alcuna interfaccia utente di installazione.
	Basic	Il programma di installazione visualizza la schermata iniziale, la pagina relativa al codice "Product Key" (PIDKEY) (se necessario), la pagina Condizioni di licenza software Microsoft (se necessario), un indicatore di stato e l'avviso di completamento (se consentito).
	Full (impostazione predefinita)	Il programma di installazione visualizza all'utente tutte le interfacce utente.
CompletionNotice	Yes	Si applica solo se Level è impostato su "Basic" o "None". Il programma di installazione visualizza l'avviso di completamento.
	No (impostazione predefinita)	Si applica solo se Level è impostato su "Basic". Il programma di installazione non visualizza l'avviso di completamento.
SuppressModal	Yes	Si applica solo se Level è impostato su "Basic". Il programma di installazione non visualizza messaggi di errore e altre finestre di dialogo che potrebbero interrompere l'installazione.
	No (impostazione predefinita)	Si applica solo se Level è impostato su "Basic". Il programma di installazione visualizza messaggi di errore e altre finestre di dialogo in base alla necessità.
NoCancel	Yes	Se Level è impostato su "Full" o "Basic", disattiva il pulsante di annullamento (la X nell'angolo superiore destro della finestra di dialogo di stato).
	No (impostazione predefinita)	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. La pagina Condizioni di licenza software Microsoft non viene visualizzata dal programma di installazione.
	No (impostazione predefinita)	Se Level non è impostato su "None", la pagina Condizioni di licenza software Microsoft viene visualizzata dal programma di installazione.

Osservazioni

Se questo elemento non è definito, vengono utilizzate le impostazioni predefinite. Se viene specificato un valore non valido, il programma di installazione termina l'installazione.

Se l'attributo Level è impostato su "Basic" o "None" e si specifica un codice "Product Key" utilizzando l'elemento PIDKEY, il programma di installazione presupporrà che vengano accettate anche le condizioni di licenza per conto del'utente. In tale caso, indipendentemente dall'impostazione dell'attributo AcceptEULA, l'approvazione delle condizioni di licenza non verrà richiesta all'utente durante l'installazione.

Esempio

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

Elemento INSTALLLOCATION

Specifica il percorso completo della cartella sul computer dell'utente in cui viene installato il prodotto.

Sintassi

<INSTALLLOCATION Value="percorso" />

Attributi

Attributo	Valore	Descrizione
Value	percorso	Percorso completo della cartella sul computer dell'utente in cui viene installato il prodotto.

Osservazioni

È possibile utilizzare le variabili di ambiente del sistema nel percorso. Se questo elemento non è specificato, il prodotto viene installato nel percorso seguente:

%PROGRAMFILES%\Microsoft Office Servers\12.0\

Si noti che la tecnologia Microsoft Windows SharePoint Services 3.0 non viene influenzata da tale elemento, poiché viene installata nel percorso seguente:

%PROGRAMFILES%\Common Files\Microsoft Shared\web server extensions\12

Esempio

<INSTALLLOCATION VALUE=”%ProgramFiles%\MyApps” />

Elemento Logging

Specifica il tipo di registrazione eseguita dal programma di installazione.

Sintassi

<Logging

Type="Off" | "Standard"(default) | "Verbose"

Path="percorso"

Template="nomefile.txt"

/>

Attributi

Attributo	Valore	Descrizione
Type	Off	Il programma di installazione non esegue alcuna registrazione.
	Standard (default)	Il programma di installazione scrive le informazioni di installazione di file di registro.
	Verbose	Il programma di installazione scrive tutte le informazioni di installazione il file di registro.
Path	*Percorso*	Percorso completo della cartella utilizzata per il file di registro. È possibile utilizzare le variabili di ambiente. Il valore predefinito è %temp%.
Template	*nomefile*.txt	Nome del file di registro. Se si inserisce la stringa * in qualsiasi punto del nome del file, verrà creato un file di registro univoco per ogni installazione eseguita da Setup.exe (vedere la spiegazione riportata di seguito). Se * non viene incluso e il nome file specificato esiste già, le informazioni di registrazione verranno aggiunte al file esistente. È necessario includere l'estensione di file txt. Il modello predefinito è SetupExe(*).log.

Osservazioni

È possibile specificare un * in qualsiasi punto del valore Template. Il programma di installazione inserisce una stringa in tale posizione con il formato seguente:

AAAAMMGGHHMMSSxxx

dove:

1. AAAA = Anno

2. MM = Mese

3. GG = Giorno

4. HH = Ora

5. MM = Minuti

6. SS = Secondi

7. xxx = una stringa univoca generata dal programma di installazione

Esempio

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

Con questo esempio, il programma di installazione crea un file di registro ogni volta che installa il prodotto. Vengono utilizzati nomi di file univoci, ad esempio:

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

Elemento Package

Pacchetto o prodotto da installare.

L'attributo Package ID per Microsoft Office SharePoint Server 2007 è spswfe. Poiché Microsoft Office SharePoint Server 2007 si basa sulla tecnologia di piattaforma di Microsoft Windows SharePoint Services 3.0, per l'esito positivo dell'installazione è necessario installare anche il pacchetto sts (Microsoft Windows SharePoint Services 3.0).

Elemento PIDKEY

Codice "Product Key" di 25 caratteri per licenze Volume License.

Sintassi

<PIDKEY Value="codice-di-25-caratteri" />

Attributi

Attributo	Valore	Descrizione
Value	*codice-di-25-caratteri*	Codice "Product Key" di 25 caratteri per licenze Volume License.

Osservazioni

Quando viene impostato il valore PIDKEY, gli utenti non devono immettere un codice "Product Key" durante l'esecuzione del programma di installazione.

Esempio

<PIDKEY Value="1234512345123451234512345" />

Elemento Setting

Consente di specificare i 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

Gli ID dell'elemento Setting seguenti vengono utilizzati per le installazioni server:

ID	Valori accettati	Descrizione
LAUNCHEDFROMSETUPSTS	Yes | No	Utilizzare come parte dell'attributo Package ID. Il valore predefinito è Yes.
REBOOT	ReallySuppress	Specifica (per Windows Installer) se consentire o meno il riavvio dopo il completamento del programma di installazione. Utilizzare ReallySuppress per specificare che non si desidera alcun riavvio. Deve essere specificato a livello globale, non a livello di singolo pacchetto.
SETUP_REBOOT	Never, AutoAlways, Always, AutoIfNeeded, IfNeeded	Specifica (per Setup.exe) se consentire o meno il riavvio dopo il completamento del programma di installazione. Utilizzare Never per specificare che non si desidera alcun riavvio. Deve essere specificato a livello globale, non a livello di singolo pacchetto.
SETUPTYPE	CLEAN_INSTALL, V2V_GRADUAL_UPGRADE, V2V_INPLACE_UPGRADE, SKU2SKU_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 la versione precedente sul posto (V2V_INPLACE_UPGRADE) oppure eseguire l'aggiornamento da un prodotto a un altro (ad esempio da Microsoft Windows SharePoint Services 3.0 a Microsoft Office SharePoint Server 2007). Deve essere specificato a livello globale, non a livello di singolo pacchetto.
SETUPCALLED	0 | 1	Utilizzare come parte dell'attributo Package ID.
OFFICESERVERPREMIUM	0 | 1	Utilizzare come parte dell'attributo Package ID. Specifica quale versione di Microsoft Office SharePoint Server 2007 si sta installando: Standard (0) o Enterprise (1). Si noti che il PIDKEY utilizzato sostituisce questa impostazione.
SERVERROLE	SINGLESERVER, WFE, APPLICATION	Specifica il tipo di server in cui si sta eseguendo l'installazione: autonomo (SINGLESERVER), server Web front-end (WFE) o applicazione (APPLICATION).
USINGUIINSTALLMODE	0 | 1	Specifica se si sta eseguendo un'installazione invisibile all'utente (0) o se si utilizza l'interfaccia utente del programma di installazione (1).

Osservazioni

Non tutte le proprietà di Windows Installer possono essere specificate nell'elemento Setting. Se viene specificata una proprietà bloccata, il programma di installazione termina il processo di installazione. Se viene specificata una proprietà supportata, tale proprietà viene passata direttamente a Windows Installer. Per un elenco completo delle proprietà di Windows Installer, inclusa una spiegazione delle proprietà supportate e bloccate, vedere Setup properties in the 2007 Office system.

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 Microsoft Office SharePoint Server 2007

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