Referencia de Config.xml (Office SharePoint Server)

Si desea controlar cómo se instala Microsoft Office SharePoint Server 2007, use el archivo Config.xml junto con Setup.exe. Por ejemplo, puede usar el archivo config.xml para:

• Realizar una instalación no interactiva de Office SharePoint Server 2007.

• Instalar Office SharePoint Server 2007 con una configuración común entre varios servidores.

• Realizar una instalación automatizada o con scripts de Office SharePoint Server 2007.

En este artículo:

• Personalización de Config.xml

• Referencia rápida de los elementos de Config.xml

• Funcionamiento

• Formato del archivo Config.xml

• Referencia de los elementos de Config.xml

Personalización de Config.xml

Para controlar la instalación, primero edite el archivo Config.xml en un editor de texto para incluir los elementos necesarios con la configuración adecuada para dichos elementos. A continuación, ejecute setup.exe /config [path and file name] para especificar que Setup.exe se ejecuta y usa las opciones establecidas en el archivo Config.xml.

El DVD del producto contiene ejemplos de archivos Config.xml. Los archivos de ejemplo están almacenados en la carpeta \Files de la raíz del DVD, en carpetas correspondientes a distintos escenarios. Las carpetas son:

• Setup   Contiene un archivo Config.xml que se usa al configurar una instalación limpia de un único servidor (independiente, con SQL Express).

• SetupFarm   Contiene un archivo Config.xml que se usa al configurar una instalación limpia de una granja de servidores.

• SetupFarmSidebySide   Contiene un archivo Config.xml que se usa al actualizar una granja de servidores existente gradualmente.

• SetupFarmSilent. Contiene un archivo config.xml que se usa al instalar una granja de servidores en modo silencioso.

• SetupFarmUpgrade   Contiene un archivo Config.xml que se usa al actualizar una granja de servidores existente.

• SetupSilent   Contiene un archivo config.xml que se usa al configurar una instalación limpia de un solo servidor (independiente, con SQL Express) en modo silencioso.

• SetupSingleUpgrade   Contiene un archivo config.xml que se usa al actualizar un solo servidor existente (independiente) instalado.

Para obtener más información acerca de las diferencias entre los distintos escenarios de actualización, vea Determinación del enfoque de actualización (Office SharePoint Server).

Referencia rápida de los elementos de Config.xml

La tabla siguiente contiene una lista de los elementos de Config.xml. Estos elementos pueden aparecer en cualquier orden, a excepción de Configuration, que debe ser el primero, y elementos como Command, cuyo orden en Config.xml afecta a la forma en que se procesan durante la instalación.

Elemento	Descripción
Configuration	Elemento de nivel superior.
ARP	Valores que controlan el texto y el comportamiento de Agregar o quitar programas en el Panel de control del producto.
Command	Ejecuta un comando durante la instalación.
Display	El nivel de interfaz de usuario que el programa de instalación muestra al usuario.
INSTALLLOCATION	La ruta de acceso completa a la carpeta en el equipo del usuario en la que se instala el producto.
Logging	Opciones para el tipo de registro que realiza el programa de instalación.
DATADIR	La ubicación que se usará para almacenar los archivos de datos.
Package	El paquete o producto que se instalará.
PIDKEY	La clave de licencia por volumen de 25 caracteres.
Setting	Valores de las propiedades de Windows Installer.

Funcionamiento

El programa de instalación busca una copia de Config.xml en la misma carpeta que Setup.exe. Si no encuentra una copia en esta ubicación, el programa de instalación usa el archivo Config.xml que se encuentra en la carpeta \Files principal del producto que está instalando.

También puede usar la opción de la línea de comandos del programa de instalación /config para especificar la ubicación del archivo Config.xml. Por ejemplo:

\\<servidor>\<recursoCompartido>\setup.exe /config \\<servidor>\<recursoCompartido>\<carpeta>\config.xml

Formato del archivo Config.xml

Los elementos XML de Config.xml empiezan con < y terminan con />.

El formato básico de los elementos es:

<nombre_de_elemento [nombre_de_atributo="valor"] [nombre_de_atributo="valor"] … />

Por ejemplo:

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

Los elementos y atributos distinguen entre mayúsculas y minúsculas. Los valores de atributo deben incluirse entre comillas (") y no distinguen entre mayúsculas y minúsculas.

Una definición de elemento puede abarcar varias líneas. En una definición de elemento se omiten espacios, retornos de carro, saltos de línea y caracteres de tabulación.

Por ejemplo:

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

El elemento Configuration es un caso especial y es obligatorio. Todos los demás elementos se incluyen dentro del elemento Configuration y el elemento se cierra con </Configuration>.

En el ejemplo siguiente se muestra un archivo de configuración de ejemplo para realizar una instalación limpia del paquete de 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>

Se pueden agregar comentarios en cualquier lugar, delimitados por "<!--" y "-->".

Por ejemplo:

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

Referencia de los elementos de Config.xml

En las descripciones de esta referencia se usan las convenciones siguientes:

negrita	Nombre de elemento o atributo
normal	Texto que debe escribirse exactamente como se muestra
Cursiva	Marcador de posición para un valor que se va a agregar
*x*|*y*	Elegir entre varios valores
[*x*]	Valor opcional

Elemento Configuration

Elemento de nivel superior. Este elemento es obligatorio y todos los demás elementos deben aparecer dentro de este elemento.

Sintaxis

<Configuration>

<Package Id="identificador">

...

</Package>

...

</Configuration>

Atributos

Atributo	Valor	Descripción
Package ID	*Identificador de paquete*	El paquete que se va a instalar.

Comentarios

El atributo Package Id identifica los productos y tecnologías afectados por este archivo Config.xml.

Ejemplo

El identificador del paquete para Office SharePoint Server 2007 es spswfe. Dado que Office SharePoint Server 2007 se basa en la tecnología de plataforma de Windows SharePoint Services 3.0, también debe instalar el paquete sts (Windows SharePoint Services 3.0); de lo contrario, la instalación no se realizará correctamente.

Use los identificadores de paquetes sts y spswfe en Config.xml para especificar Windows SharePoint Services 3.0 y Office SharePoint Server 2007 escribiendo para ello lo siguiente:

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

Elemento ARP

Especifica los valores que controlan el texto y el comportamiento de Agregar o quitar programas en el Panel de control del producto.

Sintaxis

<ARP atributo**="valor"** [atributo**="valor"**] ... />

Atributos

Atributo	Valor	Descripción
ARPCOMMENTS	*texto*	Texto adicional; puede tener un máximo de 255 caracteres, aunque es posible que no se muestren todos los caracteres.
ARPCONTACT	*texto*	Lista de contactos de soporte técnico.
ARPNOMODIFY	Sí	Impide que los usuarios modifiquen la instalación del producto al hacer que el botón Cambiar no esté disponible.
	No (valor predeterminado)	Permite al usuario modificar la instalación del producto.
ARPNOREMOVE	Yes	Impide que los usuarios quiten el producto al hacer que el botón Quitar no esté disponible.
	No (valor predeterminado)	Permite a los usuarios quitar el producto.
ARPURLINFOABOUT	*Dirección URL*	Dirección URL de la página principal del producto.
ARPURLUPDATEINFO	*Dirección URL*	Dirección URL de información acerca de las actualizaciones del producto.
ARPHELPLINK	*Dirección URL*	Dirección URL de un sitio web desde el que los usuarios pueden recibir soporte técnico.
ARPHELPTELEPHONE	*texto*	Números de teléfono de soporte técnico.

Elemento Command

Especifica la ejecución de una línea de comandos. Los comandos del elemento Command se procesan únicamente durante las instalaciones y desinstalaciones iniciales. Si se usan para personalizaciones después de la instalación inicial, se omiten.

Sintaxis

<Command

Path="rutaDeAcceso"

[QuietArg="argumentos"]

[Args="argumentos"]

[ChainPosition="Before" | "After"(valor predeterminado)]

[Wait="milisegundos"]

[QuietWait="milisegundos"]

[Execute="Install"(valor predeterminado) | "Uninstall"]

[Platform="x86"(valor predeterminado) | "x64"]

/>

Atributos

Puede especificar comillas dobles (") en los atributos Path y Args si especifica dos comillas dobles juntas ("").

Atributo	Valor	Descripción
Path	*ruta de acceso*	Ruta de acceso completa al archivo del paquete ejecutable de Microsoft® Windows Installer (MSI).
QuietArg	*cadena*	Cadena de argumentos que se anexarán a la línea de comandos cuando el valor de Display sea Level=None.
Args	*cadena*	Cadena de argumentos que se pasará al archivo ejecutable.
ChainPosition	Before	Este comando se ejecuta antes de la instalación del producto principal.
	After (valor predeterminado)	Este comando se ejecuta después de la instalación del producto principal.
Wait	*milisegundos*	Cuando realiza la instalación con el atributo Level de Display establecido en "Full" o "Basic", es el número de milisegundos que hay que esperar después de ejecutar el programa, antes de continuar con la instalación. El valor predeterminado es 0 (cero), que indica que no hay espera.
QuietWait	*milisegundos*	Cuando realiza la instalación con el atributo Level de Display establecido en "None", es el número de milisegundos que hay que esperar después de ejecutar el programa, antes de continuar con la instalación. El valor predeterminado es 0 (cero), que indica que no hay espera.
Execute	Install (valor predeterminado)	El programa de instalación ejecuta este comando cuando se instala el producto principal.
	Uninstall	El programa de instalación ejecuta este comando cuando se desinstala el producto principal.
Platform	x86 (valor predeterminado)	Especifica que este programa requiere la plataforma Intel x86. Este comando sólo se ejecuta si el equipo en el que se ejecuta la instalación coincide con este requisito de plataforma.
	x64	Especifica que este programa requiere un procesador de 64 bits que admita las extensiones x64 de la arquitectura x86. Este comando sólo se ejecuta si el equipo en el que se ejecuta la instalación coincide con este requisito de plataforma.

Comentarios

La línea de comandos se puede especificar para una instalación encadenada o un archivo ejecutable que se ejecute cuando se instala el producto. Si se especifica, debe especificar una línea de comandos para Setup.exe, en vez de un único archivo MSI.

Si hay dos o más elementos Command en el archivo Config.xml, se ejecutarán en el orden en que se especifican en Config.xml.

Ejemplo

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

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

Elemento DATADIR

La ubicación que se usará para almacenar los archivos de datos, incluidos los archivos del índice de búsqueda.

Sintaxis

<DATADIR Value="rutaDeAcceso"/>

Atributos

Atributo	Valor	Descripción
Value	rutaDeAcceso	El programa de instalación almacena los archivos de datos en la ubicación especificada.

Comentarios

Puede usar variables de entorno del sistema en la ruta de acceso. Si este elemento no se especifica, los datos se almacenan en la ruta de acceso siguiente:

%PROGRAMFILES%\Microsoft Office Servers\12.0\Data

Ejemplo

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

Elemento Display

El nivel de interfaz de usuario que el programa de instalación muestra al usuario.

Sintaxis

<Display

Level="None" | "Basic" | "Full"(valor predeterminado)

CompletionNotice="Yes"(valor predeterminado) | "No"

SuppressModal="Yes" | "No"(valor predeterminado)

NoCancel="Yes" | "No"(valor predeterminado)

AcceptEula="Yes" | "No"(valor predeterminado)

/>

Atributos

Atributo	Valor	Descripción
Level	None	No se muestra la interfaz de usuario del programa de instalación.
	Basic	El programa de instalación muestra la pantalla de bienvenida, la página Clave de producto (PIDKEY) (si es necesario), la página Términos de licencia de software de Microsoft (si es necesario), una barra de progreso y el aviso de finalización (si se permite).
	Full (valor predeterminado)	El programa de instalación muestra toda la interfaz de usuario al usuario.
CompletionNotice	Yes	Sólo se aplica si Level se establece en "Basic" o "None": el programa de instalación muestra el aviso de finalización.
	No (valor predeterminado)	Sólo se aplica si Level se establece en "Basic": el programa de instalación no muestra el aviso de finalización.
SuppressModal	Yes	Sólo se aplica si Level se establece en "Basic": el programa de instalación no muestra mensajes de error y otros cuadros de diálogo que podrían interrumpir la instalación.
	No (valor predeterminado)	Sólo se aplica si Level se establece en "Basic": el programa de instalación muestra los errores y otros cuadros de diálogo cuando es necesario.
NoCancel	Yes	Si Level se establece en "Full" o "Basic", deshabilita el botón de cancelación (la X en la esquina superior derecha del cuadro de diálogo de progreso).
	No (valor predeterminado)	Si Level se establece en "Full" o "Basic", permite al usuario cancelar la instalación desde la barra de progreso.
AcceptEULA	Yes	Los Términos de licencia del software de Microsoft se aceptan en nombre del usuario; el programa de instalación no muestra la página Términos de licencia del software de Microsoft.
	No (valor predeterminado)	Si Level no está establecido en "None", el programa de instalación muestra la página Términos de licencia del software de Microsoft.

Comentarios

Si este elemento no está definido, se usa la configuración predeterminada. Si se especifica un valor no válido, el programa de instalación finaliza la instalación.

Si el atributo Level se establece en "Basic" o "None" y proporciona una clave de producto mediante el uso del elemento PIDKEY, el programa de instalación asume que también acepta los términos de la licencia por parte del usuario. En este caso, independientemente de cómo establezca el atributo AcceptEULA, al usuario no se le solicita que acepte los términos de la licencia durante la instalación.

Ejemplo

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

Elemento INSTALLLOCATION

Especifica la ruta de acceso completa a la carpeta en el equipo del usuario en la que está instalado el producto del usuario.

Sintaxis

<INSTALLLOCATION Value="rutaDeAcceso" />

Atributos

Atributo	Valor	Descripción
Value	rutaDeAcceso	La ruta de acceso completa a la carpeta en el equipo del usuario en la que se instala el producto.

Comentarios

Puede usar variables de entorno del sistema en la ruta de acceso. Si este elemento no se especifica, el producto se instala en la siguiente ruta de acceso:

%PROGRAMFILES%\Microsoft Office Servers\12.0\

Tenga en cuenta que la tecnología de Windows SharePoint Services 3.0 no se ve afectada por este elemento; está instalado en la ruta de acceso siguiente:

%PROGRAMFILES%\Archivos comunes\Microsoft Shared\web server extensions\12

Ejemplo

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

Elemento Logging

Especifica el tipo de registro que realiza el programa de instalación.

Sintaxis

<Logging

Type="Off" | "Standard"(valor predeterminado) | "Verbose"

Path="rutaDeAcceso"

Template="nombreDeArchivo.txt"

/>

Atributos

Atributo	Valor	Descripción
Type	Off	El programa de instalación no realiza ningún registro.
	Standard (valor predeterminado)	El programa de instalación escribe la información de instalación en el archivo de registro.
	Verbose	El programa de instalación escribe toda la información de instalación en el archivo de registro.
Path	*rutaDeAcceso*	La ruta de acceso completa a la carpeta usada para el archivo de registro. Puede usar variables de entorno. El valor predeterminado es %temp%.
Template	*nombreDeArchivo*.txt	Nombre del archivo de registro. Si inserta la cadena * en cualquier lugar del nombre de archivo, se crea un archivo de registro único para cada instalación realizada por Setup.exe (vea la explicación a continuación). Si * no se incluye y el nombre de archivo especificado ya existe, la información de registro se anexa al archivo existente. La extensión de archivo .txt debe incluirse. La plantilla predeterminada es SetupExe(*).log.

Comentarios

Puede especificar un * en cualquier lugar del valor de Template. El programa de instalación inserta una cadena en esa ubicación con el formato siguiente:

YYYYMMDDHHMMSSxxx

donde:

1. YYYY = año

2. MM = mes

3. DD = día

4. HH = hora

5. MM = minutos

6. SS = segundos

7. xxx = una cadena única generada por el programa de instalación

Ejemplo

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

Con este ejemplo, el programa de instalación crea un archivo de registro cada vez que instala el producto. Usa nombres de archivo únicos, como los siguientes:

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

Elemento Package

El paquete o producto que se instalará.

El identificador del paquete para Office SharePoint Server 2007 es spswfe. Dado que Office SharePoint Server 2007 se basa en la tecnología de plataforma de Windows SharePoint Services 3.0, también debe instalar el paquete sts (Windows SharePoint Services 3.0); de lo contrario, la instalación no se realizará correctamente.

Elemento PIDKEY

La clave de licencia por volumen de 25 caracteres.

Sintaxis

<PIDKEY Value="clave de 25 caracteres" />

Atributos

Atributo	Valor	Descripción
Value	*clave de 25 caracteres*	La clave de licencia por volumen de 25 caracteres.

Comentarios

Cuando se establece el valor de PIDKEY , los usuarios no tienen que escribir una clave de producto cuando ejecuten el programa de instalación.

Ejemplo

<PIDKEY Value="1234512345123451234512345" />

Elemento Setting

Permite especificar los valores para las propiedades de Windows Installer.

Sintaxis

<Setting Id="nombre" Value="valor" />

Atributos

Atributo	Valor	Descripción
Id	*nombre*	El nombre de la propiedad de Windows Installer.
Value	*valor*	El valor que se va a asignar a la propiedad.

Valores

Los identificadores de configuración siguientes se usan para instalaciones de servidor:

Id.	Valores aceptados	Descripción
LAUNCHEDFROMSETUPSTS	Sí | No	Úselo como parte del atributo Package Id. La opción predeterminada es Sí.
REBOOT	ReallySuppress	Especifica (para Windows Installer) si se va a permitir o no un reinicio después de completar el programa de instalación. Use ReallySuppress para especificar que no se produzca ningún reinicio. Debe especificarse en el nivel global, no por paquete.
SETUP_REBOOT	Never, AutoAlways, Always, AutoIfNeeded, IfNeeded	Especifica (para Setup.exe) si se va a permitir o no un reinicio después de completar el programa de instalación. Use Never para especificar que no se produzca ningún reinicio. Debe especificarse en el nivel global, no por paquete.
SETUPTYPE	CLEAN_INSTALL, V2V_GRADUAL_UPGRADE, V2V_INPLACE_UPGRADE, SKU2SKU_UPGRADE	Especifica si instalar una nueva copia del producto o la tecnología (CLEAN_INSTALL), instalar la nueva versión frente a frente con la versión anterior para realizar una actualización gradual (V2V_GRADUAL_UPGRADE), instalar la nueva versión y actualizar la versión anterior instalada (V2V_INPLACE_UPGRADE), o actualizar de un producto a otro (por ejemplo, de Windows SharePoint Services 3.0 a Office SharePoint Server 2007. Debe especificarse en el nivel global, no por paquete.
SETUPCALLED	0 | 1	Úselo como parte del atributo Package Id.
OFFICESERVERPREMIUM	0 | 1	Úselo como parte del atributo Package Id. Especifica qué versión de Office SharePoint Server 2007 está instalando: Standard (0) o Enterprise (1). Recuerde que el valor de PIDKEY usado sobrescribe esta configuración.
SERVERROLE	SINGLESERVER, WFE, APPLICATION	Especifica el tipo de servidor en el que va a realizar la instalación: independiente (SINGLESERVER), servidor cliente web (WFE) o aplicación (aplicación).
USINGUIINSTALLMODE	0 | 1	Especifica si se realizará una instalación silenciosa (0) o se usará la interfaz de usuario para la instalación (1).

Comentarios

No todas las propiedades de Windows Installer se pueden especificar en el elemento Setting. Si se especifica una propiedad bloqueada, el programa de instalación finaliza el proceso de instalación. Si se especifica una propiedad compatible, el programa de instalación pasa la propiedad directamente a Windows Installer. Para obtener una lista completa de las propiedades de Windows Installer, incluida una explicación de las propiedades admitidas y bloqueadas, vea Setup properties in the 2007 Office system.

Ejemplo

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

Descarga de este libro

En este tema se incluye el siguiente libro descargable para facilitar la lectura y la impresión:

• Guía de instalación de Microsoft Office SharePoint Server 2007

Vea la lista completa de libros disponibles en Libros descargables para Office SharePoint Server 2007.