Описание файла Config.xml (Office SharePoint Server)

Если требуется контролировать, каким образом устанавливается Microsoft Office SharePoint Server 2007, используйте файл Config.xml вместе с файлом Setup.exe. Например, файл config.xml можно использовать для выполнения следующих действий.

• Выполнение автоматической установки Office SharePoint Server 2007.

• Установка Office SharePoint Server 2007 с использованием общей конфигурации для нескольких серверов.

• Выполнение автоматической установки или установки по сценарию Office SharePoint Server 2007.

В этой статье:

• Настройка файла Config.xml

• Краткий справочник по элементам файла Config.xml

• Как это работает

• Формат файла Config.xml

• Перечень элементов файла Config.xml

Настройка файла Config.xml

Для управления установкой сначала отредактируйте файл Config.xml в текстовом редакторе, включив в него необходимые элементы и соответствующие параметры для этих элементов. Затем запустите файл setup.exe /config [path and file name], чтобы указать, что файл Setup.exe запускается с использованием параметров, установленных в файле Config.xml.

Диск DVD продукта содержит примеры файлов Config.xml. Файлы примеров хранятся в папке \Files в корневой папке диска DVD, в папках, соответствующих различным сценариям. Это следующие папки:

• Setup   Содержит файл config.xml для использования в настройке чистой установки одного сервера (автономного с SQL Express).

• SetupFarm   Содержит файл config.xml для использования в настройке чистой установки для фермы серверов.

• SetupFarmSidebySide   Содержит файл config.xml для использования в постепенном обновлении фермы серверов.

• SetupFarmSilent   Содержит файл config.xml для использования при настройке фермы серверов в автоматическом режиме.

• SetupFarmUpgrade   Содержит файл config.xml для использования в обновлении существующей фермы серверов.

• Setup   Содержит файл config.xml для использования в настройке чистой установки одного сервера (автономного с SQL Express) в автоматическом режиме.

• SetupFarmUpgrade   Содержит файл config.xml для использования в обновлении существующего отдельного сервера (автономного).

Дополнительные сведения о различиях с между различными сценариями обновления см. в разделе Определение концепции обновления (Office SharePoint Server).

Краткий справочник по элементам файла Config.xml

В следующей таблице приведет список элементов в файле Config.xml. Эти элементы могут отображаться в любом порядке за исключением элемента Configuration, который обязательно должен быть первым, а также таких элементов, как Command, от порядка использования которых в файле Config.xml зависит то, каким образом они обрабатываются во время установки.

Элемент	Описание
Configuration	Элемент верхнего уровня.
ARP	Значения, которые управляют текстом и поведением окна Установка и удаление программ в панели управления для продукта.
Command	Выполнение команды во время установки.
Display	Уровень интерфейса пользователя, который отображает программа установки.
INSTALLLOCATION	Полный путь к папке на компьютере пользователя, в которую устанавливается продукт.
Logging	Параметры для типа регистрации, выполняемой программой установки.
DATADIR	Папка, которая используется для хранения файлов данных.
Package	Пакет или продукт, который необходимо установить.
PIDKEY	25-значный лицензионный ключ.
Setting	Значения для свойств установщика Windows.

Как это работает

Программа установки выполняет поиск копии файла Config.xml в той же папке, что и файл Setup.exe. Если искомую копию там не удается найти, программа установки использует файл Config.xml, который находится в корневой папке \Files для устанавливаемого продукта.

Можно также использовать параметр командной строки /config программы установки для указания местоположения файла Config.xml. Например:

\\<server>\<share>\setup.exe /config \\<server>\<share>\<folder>\config.xml

Формат файла Config.xml

Элементы XML в файле Config.xml начинаются с < и заканчиваются символом />.

Формат основного элемента:

<имя_элемента [имя_атрибута="значение"] [имя_атрибута="значение"] … />

Пример:

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

В элементах и атрибутах учитывается состояние регистра. Значения атрибутов должны заключаться в кавычки ("), состояние регистра в них не учитывается.

Определение элемента может занимать несколько строк. Внутри определения элемента пробелы, возвраты каретки и символы табуляции игнорируются.

Пример:

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

Элемент Configuration является исключением. Он является обязательным. Все остальные элементы содержатся внутри элемента Configuration, и этот элемент заключен внутри </Configuration>.

В следующем примере показан пример файла настройки для чистой установки пакета 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>

Комментарии можно добавлять в любом месте. Они отделяются с помощью символов "<!--" и "-->".

Пример:

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

Перечень элементов файла Config.xml

В данном справочнике используются следующие условные обозначения:

полужирный шрифт	Имя элемента или атрибута
обычный	Текст, который необходимо ввести в точности так, как показано.
*курсив*	Заполнитель для добавляемого значения
*x*|*y*	Выбор между несколькими значениями
[*x*]	Дополнительное значение

Элемент Configuration

Элемент верхнего уровня. Этот элемент является обязательным. Все остальные элементы должны отображаться внутри этого элемента.

Синтаксис

<Configuration>

<Package Id="ID">

...

</Package>

...

</Configuration>

Атрибуты

Атрибут	Значение	Описание
Package ID	*Идентификатор пакета*	Устанавливаемый пакет.

Примечания

Атрибут Package Id определяет продукт и технологии, на которые влияет этот файл Config.xml.

Пример

Идентификатор пакета для Office SharePoint Server 2007 — spswfe. Поскольку Office SharePoint Server 2007 зависит от технологии платформы в Windows SharePoint Services 3.0, необходимо также установить пакет sts (Windows SharePoint Services 3.0), в противном случае установка не будет выполнена.

Идентификаторы пакетов sts и spswfe используются в файле Config.xml для указания Windows SharePoint Services 3.0 и Office SharePoint Server 2007 путем ввода следующих данных:

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

Элемент ARP

Определяет значения, которые управляют текстом и поведением окна Установка и удаление программ в панели управления для продукта.

Синтаксис

<ARP атрибут**="значение"** [атрибут**="значение"**] ... />

Атрибуты

Атрибут	Значение	Описание
ARPCOMMENTS	*текст*	Дополнительный текст; может быть длиной до 255 знаков, однако могут отображаться не все символы.
ARPCONTACT	*текст*	Список контактов среди специалистов технической поддержки.
ARPNOMODIFY	Yes	Запрет изменения установки продукта пользователями — кнопка Изменить является недоступной.
	No (по умолчанию)	Разрешение пользователям изменять установку продукта.
ARPNOREMOVE	Yes	Запрет удаления продукта — кнопка Удалить является недоступной.
	No (default)	Разрешение пользователям удалять продукт.
ARPURLINFOABOUT	*URL-адрес*	URL-адрес домашней страницы продукта.
ARPURLUPDATEINFO	*URL-адрес*	URL-адрес для получения информации об обновлениях продукта.
ARPHELPLINK	*URL-адрес*	URL-адрес веб-сайта, на котором пользователи могут получить техническую поддержку.
ARPHELPTELEPHONE	*текст*	Номера телефонов для получения технической поддержки.

Элемент Command

Задание командной строки для выполнения. Команды внутри элемента Command обрабатываются только во время первоначальных установок и удалений. Если команды внутри элемента Command используются для настройки после первоначальной установке, то они пропускаются.

Синтаксис

<Command

Path="путь"

[QuietArg="аргументы"]

[Args="аргументы"]

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

[Wait="миллисекунд"]

[QuietWait="миллисекунд"]

[Execute="Install"(по умолчанию) | "Uninstall"]

[Platform="x86"(по умолчанию) | "x64"]

/>

Атрибуты

Внутри атрибутов Path и Args можно указывать двойные кавычки. Для этого необходимо рядом ввести двойные кавычки дважды ("").

Атрибут	Значение	Описание
Path	*путь*	Полный путь к исполняемому файлу пакета установщика Microsoft® Windows (MSI).
QuietArg	*строка*	Строка аргументов, добавляемым в командную строку, когда Display Level=None.
Args	*строка*	Строка аргументов, передаваемых в исполняемый файл.
ChainPosition	Before	Эта команда выполняет перед основной установкой продукта.
	After (default)	Эта команда выполняет после основной установки продукта.
Wait	*миллисекунд*	При установке, когда для атрибута Display Level установлено значение "Full" или "Basic", это количество миллисекунд ожидания после выполнения программы перед продолжением установки. Значение по умолчанию — 0 (ноль), при котором ожидание отсутствует.
QuietWait	*миллисекунд*	При установке, когда для атрибута Display Level установлено значение "None", это количество миллисекунд ожидания после выполнения программы перед продолжением установки. Значение по умолчанию — 0 (ноль), при котором ожидание отсутствует.
Execute	Install (по умолчанию)	Программа установки выполняет эту команду при установке основного продукта.
	Uninstall	Программа установки выполняет эту команду при удалении основного продукта.
Platform	x86 (по умолчанию)	Указывает, что данная программа требует платформы Intel x86. Эта команда выполняется только в том случае, если компьютер, на котором выполняется установка, соответствует данной необходимой платформе.
	x64	Указывает, что данная программа требует 64-разрядного процесса, который поддерживает расширения x64 для архитектуры x86. Эта команда выполняется только в том случае, если компьютер, на котором выполняется установка, соответствует данной необходимой платформе.

Примечания

Можно указать командную строку для последовательной установки или исполняемый файл, который выполняется при установке этого продукта. Если это указано, необходимо указать командную строку для файла Setup.exe, а не для одного файла MSI.

Если в файле Config.xml имеются два или более элементов Command, они будут выполняться в той последовательности, в которой они указаны в файле Config.xml.

Пример

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

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

Элемент DATADIR

Местоположение, которое необходимо использовать для хранения файлов данных, включая файлы индекса поиска.

Синтаксис

<DATADIR Value="путь"/>

Атрибуты

Атрибут	Значение	Описание
Value	путь	Программа установки сохраняет файлы данных в указанной папке.

Примечания

В пути можно использовать системные переменные среды. Если этот элемент не указан, данные сохраняются по следующему пути:

%PROGRAMFILES%\Microsoft Office Servers\12.0\Data

Пример

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

Элемент Display

Уровень интерфейса пользователя, который отображает программа установки.

Синтаксис

<Display

Level="None" | "Basic" | "Full"(default)

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

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

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

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

/>

Атрибуты

Атрибут	Значение	Описание
Level	None	Интерфейс программы установки не отображается.
	Basic	Программа установки отображает экран приветствия, страницу ключа продукта (PIDKEY) (если необходимо), страницу "Условия лицензии на использование программного обеспечения корпорации Microsoft" (если необходимо), индикатор хода выполнения и уведомление о выполнении (если разрешено).
	Full (default)	Программа установки отображает весь интерфейс для пользователя.
CompletionNotice	Yes	Отображается только в том случае, если для параметра Level установлено значение "Basic" или "None": программа установки отображает уведомление о выполнении.
	No (по умолчанию)	Применяется только в том случае, если для параметра Level установлено значение "Basic": программа установки не отображает уведомление о выполнении.
SuppressModal	Yes	Применяется только в том случае, если для параметра Level установлено значение "Basic": программа установки не отображает сообщения об ошибках и другие диалоговые окна, которые могут прерывать установку.
	No (default)	Применяется только в том случает, если для параметра Level установлено значение "Basic": программа установки отображает ошибки и другие диалоговые окна по мере необходимости.
NoCancel	Yes	Если для параметра Level установлено значение "Full" или "Basic", кнопка отмены отключается (X в правом верхнем углу диалогового окна хода выполнения).
	No (по умолчанию)	Если для параметра Level установлено значение "Full" или "Basic", пользователь может отменить установку из окна с индикатором хода выполнения.
AcceptEULA	Yes	Условия лицензионного соглашения на использование программного обеспечения корпорации Майкрософт принимаются от имени пользователя; программа установки не отображает страницу "Условия лицензионного соглашения на использование программного обеспечения корпорации Майкрософт".
	No (default)	Если для параметра Level установлено значение "None", то программа установки отображает страницу Условия лицензионного соглашения на использование программного обеспечения корпорации Майкрософт.

Примечания

Если этот элемент не определен, используются настройки по умолчанию. Если указано недопустимое значение, программа установки завершает установку.

Если для атрибута Level установлено значение "Basic" или "None" и указан ключ продукта с помощью элемента PIDKEY, то программа установки предполагает, что вы также приняли условия лицензии от имени пользователя. В этом случае независимо от того, как настроен атрибут AcceptEULA во время установки пользователю не выдается запрос об условиях лицензии.

Пример

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

Элемент INSTALLLOCATION

Задает полный путь к папке на компьютере пользователя, в которую устанавливается продукт.

Синтаксис

<INSTALLLOCATION Value="path" />

Атрибуты

Атрибут	Значение	Описание
Значение	путь	Полный путь к папке на компьютере пользователя, в которую устанавливается продукт.

Примечания

В пути можно использовать системные переменные среды. Если этот элемент не указан, продукт устанавливается по следующему пути:

%PROGRAMFILES%\Microsoft Office Servers\12.0\

Следует иметь в виду, что это элемент не влияет на технологию Windows SharePoint Services 3.0; она устанавливается по следующему пути:

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

Пример

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

Элемент Logging

Тип регистрации, выполняемой программой установки.

Синтаксис

<Logging

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

Path="путь"

Template="имя_файла.txt"

/>

Атрибуты

Атрибут	Значение	Описание
Type	Off	Программа установки не выполняет регистрацию
	Standard (по умолчанию)	Программа установки записывает сведения об установке в файл журнала.
	Verbose	Программа установки записывает все сведения об установке в файл журнала.
Path	*Путь*	Полный путь к папке, используемой для хранения файла журнала. Можно использовать переменные среды. Значение по умолчанию — %temp%.
Template	*имя_файла*.txt	Имя файлы журнала. Если вставить строку * в любом месте в имени файла, для каждой установки, выполняемой с помощью программы Setup.exe, будет создаваться уникальное имя файла (см. описание ниже). Если * не указана, а имя файла уже существует, то данные журнала добавляются в существующий файл. Необходимо обязательно указать расширение TXT. Шаблон по умолчанию — SetupExe(*).log.

Примечания

Можно указывать * в любом месте внутри значения Template. Программа установки вставляет строку в этом месте в следующем формате:

YYYYMMDDHHMMSSxxx,

где

1. YYYY = год,

2. MM = месяц,

3. DD = день,

4. HH = час,

5. MM = минуты,

6. SS = секунды,

7. xxx = уникальная строка, создаваемая программой установки.

Пример

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

В этом примере программа установки создает файл журнала при каждой установке продукта. Программа установки использует уникальные имена файлов, например:

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

Элемент Package

Пакет или продукт, который необходимо установить.

Идентификатор пакета для Office SharePoint Server 2007 — spswfe. Поскольку Office SharePoint Server 2007 зависит от технологии платформы в Windows SharePoint Services 3.0, необходимо также установить пакет sts (Windows SharePoint Services 3.0), в противном случае установка не будет выполнена.

Элемент PIDKEY

25-значный лицензионный ключ.

Синтаксис

<PIDKEY Value="25-значный ключ" />

Атрибуты

Атрибут	Значение	Описание
Value	*25-значный ключ*	25-значный лицензионный ключ.

Примечания

Когда задано значение PIDKEY, пользователям не нужно вводить ключ продукта при запуске программы установки.

Пример

<PIDKEY Value="1234512345123451234512345" />

Элемент Setting

Позволяет указать значения для свойств установщика Windows.

Синтаксис

<Setting Id="имя" Value="значение" />

Атрибуты

Атрибут	Значение	Описание
Id	*имя*	Имя свойства установщика Windows.
Value	*значение*	Значение, которое назначается для свойства.

Значения

Следующие идентификаторы параметров используются для установок серверов:

Код	Допустимые значения	Описание
LAUNCHEDFROMSETUPSTS	Yes | No	Используется как часть атрибута Package Id. Значение по умолчанию — Yes.
REBOOT	ReallySuppress	Указывает (для установщика Windows) следует ли разрешить перезагрузку после завершения установки. Идентификатор ReallySuppress используется для запрета перезагрузки. Его необходимо указывать глобально, а не для каждого пакета.
SETUP_REBOOT	Never, AutoAlways, Always, AutoIfNeeded, IfNeeded	Указывает (для программы Setup.exe) следует ли разрешить перезагрузку после завершения установки. Идентификатор Never используется для запрета перезагрузки. Его необходимо указывать глобально, а не для каждого пакета.
SETUPTYPE	CLEAN_INSTALL, V2V_GRADUAL_UPGRADE, V2V_INPLACE_UPGRADE, SKU2SKU_UPGRADE	Указывает, должна ли устанавливаться новая копия продукта или технологии (CLEAN_INSTALL), выполняться установка новой версии рядом с предыдущей для постепенного обновления (V2V_GRADUAL_UPGRADE), установка новой версии и обновление существующей предыдущей версии (V2V_INPLACE_UPGRADE) или обновление одного продукта на другой (например, Windows SharePoint Services 3.0 на Office SharePoint Server 2007. Необходимо указывать глобально, а не для каждого пакета.
SETUPCALLED	0 | 1	Используется как часть атрибута Package Id.
OFFICESERVERPREMIUM	0 | 1	Используется как часть атрибута Package Id. Указывает устанавливаемую версию приложения Office SharePoint Server 2007: Standard (0) или Enterprise (1). Следует иметь в виду, что использование идентификатора PIDKEY отменяет эту настройку.
SERVERROLE	SINGLESERVER, WFE, APPLICATION	Указывает тип сервера, на который выполняется установка: автономный (SINGLESERVER), интерфейсный веб-сервер (WFE) или сервер приложения (APPLICATION).
USINGUIINSTALLMODE	0 | 1	Указывает, выполняется ли автоматическая установка (0) или для установки используется интерфейс пользователя (1).

Примечания

В элементе Setting задаются не все свойства установщика Windows. Если указано заблокированное свойство, процесс установки завершается. Если указано поддерживаемое свойство, программа установки передает свойство непосредственно установщику Windows. Например, список свойств установщика Windows, включая описание поддерживаемых и заблокированных свойств, можно просмотреть в разделе Setup properties in the 2007 Office system.

Пример

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

Загрузить эту книгу

Данный раздел включается в следующую книгу, доступную для загрузки, чтобы упростить ее чтение и печать:

• Руководство по установке Microsoft Office SharePoint Server 2007

Полный список доступных для загрузки книг по Office SharePoint Server 2007 см. в разделе Доступные для загрузки книги для пакета MS Office SharePoint Server 2007 .