Ссылка на Config.xml (Windows SharePoint Services)
Если необходимо управлять установкой Windows SharePoint Services 3.0, используйте файл Config.xml наряду с Setup.exe. Например файл config.xml можно использовать в следующих целях:
Выполнение автоматической установки Windows SharePoint Services 3.0.
Установка стандартной конфигурации Windows SharePoint Services 3.0 на нескольких серверах.
Выполнение автоматической или заданной сценарием установки Windows SharePoint Services 3.0.
Содержание:
Настройка Config.xml
Быстрая справка по элементам Config.xml
Принципы работы
Формат файла Config.xml
Справка по элементам Config.xml
Настройка Config.xml
Чтобы управлять установкой, сначала измените файл Config.xml в текстовом редакторе, чтобы включить элементы с соответствующими параметрами. Затем выполните setup.exe /config [path and file name], чтобы указать, что файл Setup.exe выполняется и используется с параметрами, заданными в файле Config.xml.
Важно!
Для изменения файла Config.xml используйте текстовый редактор, например Блокнот. Не следует использовать XML-редактор общего назначения, например Microsoft Office Word 2007.
На DVD-диске с продуктом представлены образцы файлов Config.xml. Образцы файлов хранятся в папке \Files в корневом каталоге DVD-диска, в папках, соответствующих различным сценариям. Папки:
Setup содержит файл config.xml для использования при установке с нуля. Чтобы завершить настройку сервера или серверной фермы, после выполнения установки необходимо запустить файл psconfig.exe.
SetupFarmSilent содержит файл config.xml для использования при установке на серверной ферме в автоматическом режиме.
SetupGradualUpgradeSilent содержит файл config.xml для использования при постепенном обновлении существующей фермы серверов.
SetupSilent содержит файл config.xml для использования при установке с нуля на одном сервере (изолированный, с внутренней базой данных Windows) в автоматическом режиме.
SetupUpgradeSilent содержит файл config.xml для использования при постепенном обновлении существующей фермы серверов.
Важно!
Файлы конфигурации по умолчанию, включенные в Windows SharePoint Services 3.0, опускают параметр SETUP_REBOOT. Этот параметр необходимо включить, если требуется блокировка перезагрузок в ходе установки с помощью командной строки.
Подробно о различиях между разного рода сценариями обновления см. в разделе Определение концепции обновления [Windows SharePoint Services].
Быстрая справка по элементам Config.xml
В следующей таблице представлен список элементов файла Config.xml. Эти элементы могут появляться в любом порядке, за исключением элемента Configuration, который всегда первый, а также таких элементов, как Command, чей порядок в файле Config.xml влияет на способ их обработки в ходе установки.
Элемент |
Описание |
Configuration |
Элемент верхнего уровня. |
ARP |
Значения, которые управляют текстом и режимом команды Добавить или удалить программы на панели управления продукта. |
Command |
Выполняет команду в ходе установки. |
Display |
Уровень пользовательского интерфейса, который отображает программа установки для пользователя. |
Logging |
Параметры для типа сбора данных диагностики, который выполняет программа установки. |
DATADIR |
Папка для хранения файлов с данными. |
Package |
Устанавливаемый пакет или продукт. |
Setting |
Значения для свойств установщика Windows. |
Принципы работы
Программа установки ищет копию файла Config.xml в той же папке, что и Setup.exe. Если установщик не обнаруживает там копии, он использует файл Config.xml, размещенный в корневой папке \Files устанавливаемого продукта.
Кроме того, можно использовать параметр командной строки /config программы установки, чтобы указать расположение файла Config.xml. Например:
\\<сервер>\<общая_папка>\setup.exe /config \\<сервер>\<общая_папка>\<папка>\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>
Важно! Файлы конфигурации по умолчанию, включенные в Windows SharePoint Services 3.0, опускают параметр SETUP_REBOOT. Этот параметр необходимо включить, если требуется блокировать перезагрузки в ходе установки через командную строку.
В любом месте можно вставить примечание, которые отделяются "<!--" и "-->".
Например:
<!-- 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>
<Package Id="ID">
...
</Package>
...
</Configuration>
Атрибуты
Атрибут |
Значение |
Описание |
Package ID |
*Код_пакета* |
Устанавливаемый пакет. |
Примечания
Атрибут Код_пакета обозначает продукт и технологии, затронутые данным файлом Config.xml.
Пример
Кодом пакета для Windows SharePoint Services 3.0 является sts. Используйте код пакета sts в Config.xml для указания Windows SharePoint Services 3.0. Для этого ввредите:
<Configuration>
<Package Id="sts">
...
</Package>
...
</Configuration>
Элемент ARP
Задает значения, которые управляют текстом и режимом команды Добавить или удалить программы на панели управления продукта.
Синтаксис
<ARP атрибут**="значение"** [атрибут**="значение"**] ... />
Атрибуты
Атрибут |
Значение |
Описание |
ARPCOMMENTS |
*текст* |
Дополнительный текст; может содержать до 255 символов, однако не все символы могут отображаться. |
ARPCONTACT |
*текст* |
Список контактов технической поддержки. |
ARPNOMODIFY |
Yes |
Предотвращает изменение пользователями установки продукта, отключая кнопку Изменить. |
No (по умолчанию) |
Позволяет пользователям изменять установку продукта. |
|
ARPNOREMOVE |
Yes |
Предотвращает удаление продукта пользователями, отключая кнопку Удалить. |
No (по умолчанию) |
Позволяет пользователям удалять продукт. |
|
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"(default) | "Uninstall"]
[Platform="x86"(default) | "x64"]
/>
Атрибуты
Можно использовать двойные кавычки (") в атрибутах Path и Args, поставив двое двойных кавычек вместе ("").
Атрибут |
Значение |
Описание |
Path |
*путь* |
Полный путь до исполняемого файла пакета с установщиком Microsoft® Windows (MSI). |
QuietArg |
*строка* |
Строка аргументов, которая добавляется в конец командной строки, когда Display Level=None. |
Args |
*строка* |
Строка аргументов, передаваемых в исполняемый файл. |
ChainPosition |
Before |
Эта команда выполняется до основной установки продукта. |
After (по умолчанию) |
Эта команда выполняется после установки основного продукта. |
|
Wait |
*мсек* |
При установке с атрибутом Display Level, для которого задано значение "Полный" или "Базовый", параметр обозначает количество милисекунд для ожидания после выполнения программы и перед продолжением установки. Значение по умолчанию равно 0 (нуль), которое означает отсутствие ожидания. |
QuietWait |
*мсек* |
При установке с атрибутом Display Level, для которого задано значение "Нет", параметр обозначает количество милисекунд для ожидания после выполнения программы и перед продолжением установки. Значение по умолчанию равно 0 (нуль), которое означает отсутствие ожидания. |
Execute |
Install (по умолчанию) |
Программа установки выполняет эту команду, когда устанавливается основной продукт. |
Uninstall |
Программа установки выполняет эту команду, когда удаляется основной продукт. |
|
Platform |
x86 (по умолчанию) |
Указывает, что для этой программы требуется платформа Intel x86. Эта команда выполняется, только если компьютером, на котором производится установка, соблюдается это требование по платформе. |
x64 |
Указывает, что для этой программы требуется 64-разрядный процессор, поддерживающий расширения х64 до архитектуры х86. Эта команда выполняется, только если компьютером, на котором производится установка, соблюдается это требование по платформе. |
Примечания
Командную строку можно задать для цепной установки или для исполняемого файла, который выполняется при установке этого продукта. Если указывается строка команды, ее следует задавать для файла Setup.exe, а не одного файла MSI.
Если существует два или более элементов Command в файле Config.xml, они выполняются в порядке, указанном в файле 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 SQL Server\MSSQL$SHAREPOINT\Data
Пример
<DATADIR Value=”d:\data”/>
Элемент Display
Уровень пользовательского интерфейса, который отображает программа установки для пользователя.
Синтаксис
<Display
Level="None" | "Basic" | "Full"(по умолчанию)
CompletionNotice="Yes"(default) | "No"
SuppressModal="Yes" | "No"(default)
NoCancel="Yes" | "No"(default)
AcceptEula="Yes" | "No"(default)
/>
Атрибуты
Атрибут |
Значение |
Описание |
Level |
None |
Интерфейс пользователя программы установки не отображается. |
Basic |
Программа установки отображает экран приветствия, страницу лицензионного соглашения для ПО корпорации Майкрософт (при необходимости), индикатор хода выполнения и сообщение о завершении выполнения (если разрешено). |
|
Full (по умолчанию) |
Программа установки отображает для пользователя весь пользовательский интерфейс. |
|
CompletionNotice |
Yes |
Применимо, только если для Level задано значение "Basic" или "None": Программа установки отображает сообщение о завершении выполнения. |
No (по умолчанию) |
Применимо, только если для Level задано значение "Basic". Программа установки не отображает сообщение о завершении выполнения. |
|
SuppressModal |
Yes |
Применимо, только если для Level задано значение "Basic". Программа установки не отображает сообщения об ошибках и другие диалоговые окна, которые могут прервать установку. |
No (по умолчанию) |
Применимо, только если для Level задано значение "Basic". Программа установки отображает сообщения об ошибках и другие диалоговые окна по мере необходимости. |
|
NoCancel |
Yes |
Если для Level задано значение "Full" или "Basic", будет отключена кнопка отмены (X — верхнем правом углу диалогового окна хода выполнения). |
No (по умолчанию) |
Если для Level задано значение "Full" или "Basic", пользователи получают возможность отменить установку с помощью индикатора хода выполнения. |
|
AcceptEULA |
Yes |
Условия лицензионного соглашения на использование программного обеспечения корпорации Майкрософт принимаются от лица пользователя. Программа установки не отображает страницу "Прочтите лицензионное соглашение на использование программного обеспечения корпорации Майкрософт". |
No (по умолчанию) |
Если для Level не задано значение "None", программа установки отображает страницу "Прочтите лицензионное соглашение на использование программного обеспечения корпорации Майкрософт". |
Примечания
IЕсли этот элемент не определен, используются параметры по умолчанию. Если задано допустимое значение, программа установки завершает установку.
Примечание
Элемент Display используется программой установки, только если программа обнаруживает файл Config.xml в той же папке, что и setup.exe, либо если задать файл Config.xml с помощью параметра командной строки /config программы установки.
Пример
<Display Level=”basic”
CompletionNotice=”yes”
SupressModal=”no”
AcceptEula=”yes”
/>
Элемент Logging
Задает тип сбора данных диагностики, который выполняет программа установки.
Синтаксис
<Logging
Type="Off" | "Standard"(default) | "Verbose"
Path="путь"
Template="имя_файла.txt"
/>
Атрибуты
Атрибут |
Значение |
Описание |
Type |
Off |
Программа установки не собирает данные диагностики. |
Standard (default) |
Программа установки записывает сведения об установке в файл журнала. |
|
Verbose |
Программа установки записывает все сведения об установке в файл журнала. |
|
Path |
*путь* |
Полный путь до папки, используемой для файла журнала. Возможно использование переменных среды. Значение по умолчанию равно %temp%. |
Template |
*имя_файла*.txt |
Имя файла журнала. Если в имя файла вставить строку *, для каждой установки, выполняемой Setup.exe, создается уникальный файл журнала (см. пояснения далее). Если строка * не включена, а указанное имя файла уже существует, сведения для журнала будут добавляться в конец существующего файла. Необходимо указать расширение файла TXT. Шаблон по умолчанию: SetupExe(*).log. |
Примечания
Можно вставить строку * в любое место значения Template. Программа установки вставит строку в это расположение в следующем формате:
YYYYMMDDHHMMSSxxx
где
YYYY = год
MM = месяц
DD = день
HH = час
MM = минуты
SS = секунды
xxx = уникальная строка, создаваемая программой установки
Примечание
Элемент Logging используется программой установки, только если файл Config.xml задать с помощью параметра командной строки /config программы установки. Если используемый файл Config.xml не указать, программа установки будет использовать параметры сбора данных диагностики по умолчанию.
Пример
<Logging Type=”standard” Path=”%temp%”
Template=”MyLog(*).txt”
/>
В данном примере программа установки создает файл журнала при каждой установке продукта. Программой установки используются уникальные имена файлов, например:
%temp%\MyLog(20060428110717CFC).txt
%temp%\MyLog(20060429113143C70).txt
Элемент Package
Устанавливаемый пакет или продукт.
Код пакета для Windows SharePoint Services 3.0 — sts.
Элемент Setting
Позволяет задать значения для свойств установщика Windows.
Синтаксис
<Setting Id="имя" Value="значение" />
Атрибуты
Атрибут |
Значение |
Описание |
Id |
*имя* |
Имя свойства установщика Windows. |
Value |
*значение* |
Значение, задаваемое свойству. |
Значения
Для установок на сервере используются следующие коды параметров:
Код |
Принимаемые значения |
Описание |
REBOOT |
ReallySuppress |
Указывает (для установщика Windows), разрешена ли перезагрузка после завершения установки. Значение ReallySuppress означает запрет перезагрузки. Значение задается на глобальном уровне, а не для пакета. |
SETUP_REBOOT |
Never, AutoAlways, Always, AutoIfNeeded, IfNeeded |
Указывает (для файла Setup.exe), разрешена ли перезагрузка после завершения установки. Для запрета перезагрузки используйте значение "Never". Значение задается на глобальном уровне, а не для пакета. |
SETUPTYPE |
CLEAN_INSTALL, V2V_GRADUAL_UPGRADE, V2V_INPLACE_UPGRADE |
Указывает, следует ли установить новую копию продукта или технологии (CLEAN_INSTALL), установить новую версию рядом с предыдущей версией для постепенного обновления (V2V_GRADUAL_UPGRADE) или установить новую версию и обновить предыдущую версию на месте (V2V_INPLACE_UPGRADE). Значение задается на глобальном уровне, а не для пакета. |
SETUPCALLED |
0 | 1 |
Входит в атрибут кода пакета. |
SERVERROLE |
SINGLESERVER, WFE |
Указывает тип сервера, на который происходит установка: изолированный (SINGLESERVER) или интерфейсный веб-сервер (WFE). |
USINGUIINSTALLMODE |
0 | 1 |
Указывает, автоматическая ли это установка (0) или установка через интерфейс пользователя для программы установки (1). |
Примечания
Не все свойства установщика Windows можно задать в элементе Setting. Если задается заблокированное свойство, программа установки завершает работу. Если задается поддерживаемое свойство, программа установки передает свойство непосредственно установщику Windows.
Пример
<Setting Id="REBOOT" Value="ReallySuppress" />
Загрузите эту книгу
Этот раздел включен в следующую загружаемую книгу для более легкого чтения и печати:
Полный список доступных книг см. в разделе Загружаемые книги по Windows SharePoint Services.