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.
Importante
Use un editor de texto, como el Bloc de notas, para editar el archivo Config.xml. No use un editor XML de uso general como Microsoft Office Word 2007.
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.
Importante
Los archivos de configuración predeterminados incluidos con Office SharePoint Server 2007 omiten la opción SETUP_REBOOT. Debe incluir esta opción si desea suprimir los reinicios durante una instalación con la línea de comandos.
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"
/>
Sugerencia
En las definiciones de elemento largas, coloque los atributos en líneas separadas y aplique sangría para que el archivo sea más fácil de leer.
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>
Importante
Los archivos de configuración predeterminados incluidos con Office SharePoint Server 2007 omiten la opción SETUP_REBOOT. Debe incluir esta opción si desea suprimir los reinicios durante una instalación con la línea de comandos.
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.
Nota
El programa de instalación sólo usa el elemento Display si aquél encuentra el archivo Config.xml en la misma carpeta que setup.exe o si el archivo Config.xml se especifica mediante la opción de línea de comandos del programa de instalación /config.
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:
YYYY = año
MM = mes
DD = día
HH = hora
MM = minutos
SS = segundos
xxx = una cadena única generada por el programa de instalación
Nota
El programa de instalación sólo usa el elemento Logging si especifica el archivo Config.xml con la opción de la línea de comandos del programa de instalación /config. Si no especifica el archivo Config.xml que debe usarse, el programa de instalación usa las opciones de registro predeterminadas.
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" />
Nota
Si el atributo Level del elemento Display 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 del elemento Display, al usuario no se le solicita que acepte los términos de la licencia durante la instalación.
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:
Vea la lista completa de libros disponibles en Libros descargables para Office SharePoint Server 2007.