Техническая справка по Microsoft SharePoint Server 2010


Справочник по элементам Config.xml



страница78/118
Дата17.11.2018
Размер6.49 Mb.
ТипКнига
1   ...   74   75   76   77   78   79   80   81   ...   118

Справочник по элементам Config.xml


Ниже перечислены обозначения, используемые в данном справочнике.



полужирный шрифт

Имя элемента или атрибута

обычный шрифт

Текст нужно ввести именно так, как показано

курсив

Заполнитель для добавляемого значения

x|y

Выбор из нескольких значений

[x]

Необязательное значение

Элемент Configuration

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

Синтаксис






...




...



Атрибуты



Атрибут

Значение

Описание

Package ID

Идентификатор пакета

Устанавливаемый пакет.



Примечания

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



Пример

Идентификатор пакета для SharePoint Server 2010 — spswfe. Поскольку SharePoint Server 2010 основывается на платформенной технологии в SharePoint Foundation 2010, необходимо также установить пакет sts (SharePoint Foundation 2010), в противном случае установка не будет успешно выполнена.

Используйте идентификаторы пакетов sts и spswfe в файле Config.xml, чтобы указать SharePoint Foundation 2010 и SharePoint Server 2010, введя следующие элементы:




...

...

...

...


Элемент ARP

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

Синтаксис

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

Атрибуты



Атрибут

Значение

Описание

ARPCOMMENTS

текст

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

ARPCONTACT

текст

Список контактов службы технической поддержки.

ARPNOMODIFY

Yes

Не позволяет пользователям изменять установку продукта, блокируя кнопку Изменить.




No (значение по умолчанию)

Позволяет пользователям изменять установку продукта.

ARPNOREMOVE

Yes

Не позволяет пользователям удалить продукт, блокируя кнопку Удалить.




No (значение по умолчанию)

Позволяет пользователям удалить продукт.

ARPURLINFOABOUT

URL-адрес

URL-адрес домашней страницы продукта.

ARPURLUPDATEINFO

URL-адрес

URL-адрес информации об обновлениях продукта.

ARPHELPLINK

URL-адрес

URL-адрес веб-сайта, на котором пользователи могут получать техническую поддержку.

ARPHELPTELEPHONE

текст

Номера телефонов службы технической поддержки.

Элемент Command

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

Синтаксис



Path="путь"

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

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

[ChainPosition="Before" | "After"(значение по умолчанию)]

[Wait="мс"]

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

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

/>

Атрибуты

Чтобы указать двойные кавычки (") в атрибутах Path и Args, нужно указать две последовательные двойные кавычки ("").





Атрибут

Значение

Описание

Path

путь

Полный путь к исполняемому файлу пакета установщика Windows.

QuietArg

строка

Строка аргументов, добавляемых к командной строке, если элемент DisplayLevel=None.

Args

строка

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

ChainPosition

Before

Эта команда выполняется перед установкой основного продукта.




After (значение по умолчанию)

Эта команда выполняется после установки основного продукта.

Wait

мс

Если выполняется установка и при этом для элемента Display атрибут Level задан как Full или Basic, это число указывает время ожидания в миллисекундах после выполнения программы до продолжения установки. По умолчанию используется значение 0, т. е. отсутствие ожидания.

Execute

Install (значение по умолчанию)

Программа установки выполняет эту команду при установке основного продукта.




Uninstall

Программа установки выполняет эту команду при удалении основного продукта.

Platform

x86 (значение по умолчанию)

Указывает, что для этой программы требуется платформа Intel x86. Эта команда выполняется только в том случае, если компьютер, на котором запускается установка, соответствует данному требованию к платформе.




x64

Указывает, что для этой программы требуется 64-разрядный процессор, поддерживающий x64-расширения архитектуры x86. Эта команда выполняется только в том случае, если компьютер, на котором запускается установка, соответствует данному требованию к платформе.



Примечания

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

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

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

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

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





Важно!

Формирование последовательностей не так надежно, как установка каждого из продуктов по отдельности. Например, если при объединении в последовательность двух установок установка одного из продуктов не удается или в ней возникает непредвиденная ошибка, основная установка и следующая установка в последовательности могут закончиться неудачно. Таким образом, подход с формированием последовательностей использовать не рекомендуется. Рекомендуемым способом совместной установки нескольких продуктов в средах предприятий является использование программы управления развертыванием, такой как Microsoft System Center Configuration Manager 2010 или Microsoft Systems Management Server (SMS) 2003 либо ПО стороннего производителя вместо последовательности.

Атрибуты Args и QuietArg используются следующим образом.

Атрибут Args всегда добавляется к команде. С ним могут использоваться такие параметры, как /install или Company=моя_компания.

Атрибут QuietArg также добавляется при автоматическом выполнении программы установки (когда атрибут Display задан как Display="none"

). В таких случаях можно указать атрибут QuietArg с параметром "/quiet". Например, можно использовать: QuietArg="/quiet"

.

Если значение элемента Args содержит кавычки, можно заключить полное значение в одинарные кавычки ('), как показано в следующем примере: Args='"/param значение"'



Следующие утверждения применимы только к атрибуту Wait.

Если для атрибута Wait задано значение 0 мс, то после запуска программы не будет ожидания продолжения установки. Команда будет выполнена и сразу после этого операция будет продолжена.

Коды возврата ожидаются, только если у Wait ненулевое значение. Если указать 0, программа установки не будет ждать после запуска указанной программы. Поэтому кода возврата в этом случае не будет.

Если задать для атрибута Wait любое положительное значение, то программа установки будет ждать указанное в миллисекундах время. Если процесс завершится раньше, программа установки продолжит свое выполнение. Если процесс не успел завершиться в указанное время, программа установки завершает работу с ошибкой.

Если задать для атрибута Wait значение -1, программа установки будет ждать бесконечно долго. Это может вызвать проблемы, так как если процесс выполнения команды перестанет отвечать (зависнет), программа установки также перестает отвечать и будет бесконечно долго ожидать выполнения команды.

Пример



Элемент DATADIR

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

Синтаксис



Атрибуты



Атрибут

Значение

Описание

Значение

путь

Программа установки хранит файлы данных в указанной папке.



Примечания

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

%PROGRAMFILES%\Microsoft Office Servers\14.0\Data

Пример





Элемент Display



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

Синтаксис



Level="None" | "Basic" | "Full"(значение по умолчанию)

CompletionNotice="Yes"(значение по умолчанию) | "No"

SuppressModal="Yes" | "No"(значение по умолчанию)

NoCancel="Yes" | "No"(значение по умолчанию)

AcceptEula="Yes" | "No"(значение по умолчанию)

/>

Атрибуты



Атрибут

Значение

Описание

Level

None

Интерфейс программы установки не отображается.




Basic

Программа установки отображает экран приветствия, страницу ключа продукта (PIDKEY) (если необходимо), страницу условий лицензионного соглашения на использование программного обеспечения корпорации Майкрософт (если необходимо), строку хода выполнения и уведомление о завершении (если разрешено).




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, программа установки отображает страницу с условиями лицензионного соглашения на использование программного обеспечения корпорации Майкрософт.

Примечания

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

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



Примечание

Элемент Display используется программой установки, только если файл Config.xml расположен в той же папке, что и файл Setup.exe, или если файл Config.xml задан с помощью параметра командной строки /config программы установки.



Пример



CompletionNotice="yes"
SupressModal="no"
AcceptEula="yes"
/>


Элемент INSTALLLOCATION

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

Синтаксис



Атрибуты



Атрибут

Значение

Описание

Значение

путь

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



Примечания

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

%PROGRAMFILES%\Microsoft Office Servers\14.0\

Учтите, что этот элемент не влияет на платформу SharePoint Foundation 2010, которая устанавливается в следующую папку:

%COMMONPROGRAMFILES%\Common Files\Microsoft Shared\Web Server Extensions\14

Пример





Элемент Logging

Задает тип ведения журнала программой установки.

Синтаксис



Type="Off" | "Standard"(значение по умолчанию) | "Verbose"

Path="путь"

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

/>

Атрибуты



Атрибут

Значение

Описание

Type

Off

Программа установки не ведет журнал.




Standard (значение по умолчанию)

Программа установки записывает данные об установке в файл журнала.




Verbose

Программа установки записывает все данные об установке в файл журнала.

Path

путь

Полный путь к папке с файлом журнала. Можно использовать переменные среды. Значение по умолчанию — %temp%.

Template

имя_файла.txt

Имя файла журнала. Если вставить строку * в имя файла, для каждой установки, выполняемой с помощью программы установки, создается уникальный файл журнала (см. описание ниже). Если символ * не включен в имя файла, а указанный файл уже существует, данные добавляются к существующему файлу. В имени файла требуется указать расширение TXT. Шаблон по умолчанию — SetupExe(*).log.



Примечания

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



ГГГГММДДЧЧММССxxx

При этом:



  1. ГГГГ — год.

  2. ММ — месяц.

  3. ДД — день.

  4. ЧЧ — час.

  5. ММ — минуты.

  6. СС — секунды.

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



Примечание

Элемент Logging используется программой установки, только если файл Config.xml задается с помощью параметра командой строки /config. Если файл Config.xml не указан, программа установки использует параметры ведения журнала по умолчанию.



Пример



Template="MyLog(*).txt"
/>


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





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


Элемент Package

Устанавливаемый пакет или продукт.

Идентификатор пакета для SharePoint Server 2010 — spswfe. Поскольку SharePoint Server 2010 основывается на платформенной технологии в SharePoint Foundation 2010, необходимо также установить пакет sts (SharePoint Foundation 2010), в противном случае установка не будет успешно выполнена.

Элемент PIDKEY

25-значный ключ многократной установки.



Синтаксис


25-значный ключ" />

Атрибуты



Атрибут

Значение

Описание

Value

25-значный ключ

25-значный ключ многократной установки.



Примечания

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



Пример








Примечание

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

Элемент Setting

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

Синтаксис



Атрибуты



Атрибут

Значение

Описание

Id

имя

Имя свойства установщика Windows.

Value

значение

Значение, присваиваемое свойству.



Значения

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





Код

Принимаемые значения

Описание

LAUNCHEDFROMSETUPSTS

Yes | No

Используется как часть атрибута Package Id. По умолчанию используется значение Yes.

REBOOT

ReallySuppress

Определяет (для установщика Windows), разрешена ли перезагрузка после завершения установки. Используйте параметр ReallySuppress, чтобы не выполнять перезагрузку. Необходимо задавать на глобальном уровне, а не на уровне пакетов.

SETUP_REBOOT

Never, AutoAlways, Always, AutoIfNeeded, IfNeeded

Определяет (для программы установки), разрешена ли перезагрузка после завершения установки. Используйте параметр Never, чтобы не выполнять перезагрузку. Необходимо задавать на глобальном уровне, а не на уровне пакетов.

SETUPTYPE

CLEAN_INSTALL, V2V_INPLACE_UPGRADE, SKU2SKU_UPGRADE

Определяет, выполняется ли установка новой копии продукта или технологии (CLEAN_INSTALL), установка новой версии и обновление предыдущей версии на месте (V2V_INPLACE_UPGRADE) или обновление одного продукта до другого (например, SharePoint Foundation 2010 до SharePoint Server 2010). Необходимо задавать на глобальном уровне, а не на уровне пакетов.

SETUPCALLED

0 | 1

Используется как часть атрибута Package Id.

SERVERROLE

SINGLESERVER, APPLICATION

Указывает тип сервера, на который выполняется установка: отдельный (SINGLESERVER) или сервер приложений (APPLICATION).

USINGUIINSTALLMODE

0 | 1

Указывает, выполняется ли автоматическая установка (0) или при установке применяется пользовательский интерфейс (1).



Примечания

Не все свойства установщика Windows можно указать в элементе Setting. Если задано заблокированное свойство, программа установки завершает работу. Если задано поддерживаемое свойство, программа установки передает его непосредственно установщику Windows. Полный список свойств установщика Windows, в том числе описание поддерживаемых и заблокированных свойств, см. в разделе Свойства программы установки в Office 2010 (Возможно, на английском языке) (http://technet.microsoft.com/ru-ru/library/41f07f9b-f0d0-489d-a185-d7b96f21f561(Office.14).aspx) (Возможно, на английском языке).



Пример







Поделитесь с Вашими друзьями:
1   ...   74   75   76   77   78   79   80   81   ...   118


База данных защищена авторским правом ©vossta.ru 2019
обратиться к администрации

    Главная страница