Установка и развертывание решения фермы

Дата последнего изменения: 3 августа 2011 г.

Применимо к: SharePoint Foundation 2010

В этой статье
Основные этапы установки решения фермы
Хранилище решений фермы
Сведения об этапе развертывания
Отмена задания развертывания
Ошибки установки

Установка решения фермы в Microsoft SharePoint Foundation — это система, которая позволяет разработчикам упаковывать пользовательские решения фермы, а администраторам — развертывать эти решения однозначным, безопасным и согласованным образом. В частности, процесс установки затрагивает отправку и распаковку пакетов решений (файлов .wsp) на интерфейсных веб-серверах, а также развертывание контента.

Основные этапы установки решения фермы

Установка решения фермы состоит из двух или трех основных этапов:

  1. Добавление: пакет решения добавляется администратором фермы в хранилище решений фермы, которое находится в базе данных конфигурации фермы. Это выполняется с помощью SharePoint (или с помощью объектной модели). Это действие нельзя выполнить в центре администрирования.

  2. Развертывание: пакет решения распаковывается и его элементы копируются в соответствующие местоположения.

    Администратор фермы выполняет это действие с помощью центра администрирования, SharePoint или объектной модели. Примеры развертывания элементов: файлы пользовательских элементов управления (.ascx) копируются в папку %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\ControlTemplates или во вложенную папку этой папки, а сборки разворачиваются в глобальный кэш сборок или в папку \bin веб-приложения. При наличии компонентов в фермы они копируются на этом этапе во вложенную папку папки %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES и устанавливаются в коллекцию компонентов фермы, веб-приложения, семейства веб-сайтов или веб-сайта, в зависимости от области действия компонента.

    Администраторы не должны развертывать решение сразу после его добавления в хранилище решений. Срок хранения решения в неразвернутом состоянии не ограничен.

  3. Активация компонента: компоненты должны быть активированы перед использованием, поэтому активация становится третьим этапом установки решений, содержащих компоненты. Компоненты могут содержать типы контента, элементы управления, настраиваемые действия, настраиваемые поля, файлы, рабочие процессы, экземпляра списков, шаблоны списков, приемники событий и конвертеры документов; хотя некоторые из них не могут быть включены в определенные области.

ПримечаниеПримечание

Терминология SharePoint Foundation в отношении установки и удаления решений фермы непоследовательна. Термины Добавление, Развертывание и Активация наиболее часто используются для обозначения трех этапов установки; однако, в зависимости от используемого для выполнения этапа средства, терминология может отличаться. Например, второй этап называется развертыванием в центре администрирования и установкой в SharePoint. Существует похожая противоречивость и в терминах обратного выполнения этих этапов; однако обратное выполнение второго этапа чаще всего называется отзывом (удалением в SharePoint), обратное выполнение первого этапа называется удалением. Третий этап, применяемый только к компонентам, всегда называется активацией, а обратный ему этап всегда называется деактивацией.

Хранилище решений фермы

Хранилище решений фермы — это таблица в базе данных конфигурации SharePoint Foundation, в котором хранятся пакеты решений.

Администраторы могут добавлять решения фермы в хранилище решений фермы одним из двух способов:

  • Командная строка: администратор может добавлять и удалять файлы решений из хранилища решений фермы с помощью SharePoint. Дополнительные сведения см. в статье, посвященной командлетам для компонентов и решений (SharePoint Server 2010).

  • Объектная модель: при добавлении решения фермы в хранилище содержимое файла решения проверяется на соответствие с XSD-файлом. Это позволяет убедиться, что файлы, содержащиеся в нем, соответствуют схемам SharePoint Foundation. В случае неудачи при выполнении проверки возвращается сообщение об ошибке. Если проверка выполнена успешно, процедура добавления решения фермы продолжается.

    ПримечаниеПримечание

    Решение можно развернуть только на одном сервере, даже если ферма состоит из нескольких серверов. Для этого используется свойство DeployLocal. Такое развертывание должно быть временным — оно выполняется только для поиска и устранения неполадок. В остальное время конфигурация интерфейсных веб-серверов должна быть одинаковой.

Сведения об этапе развертывания

На этапе развертывания решения фермы создается задание таймера. Это задание выполняется службой таймера на каждом веб-сервере фермы. Задание таймера использует веб-службу администрирования SharePoint Foundation для доступа к соответствующим правам, необходимым для развертывания файлов решения на каждом компьютере, поэтому для успешного развертывания обе службы должны выполняться на всех серверах.

Сначала выполняется анализ манифеста пакета для поиска файлов сборок, страниц приложения, ECMAScript и других файлов, которые не входят в состав компонента. Эти файлы копируются в расположения, указанные в манифесте. Все файлы, содержащиеся в компоненте, копируются в подкаталог %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES каталога компонента. После того как файлы решения скопированы на целевые компьютеры, планируется операция смены конфигурации для всех интерфейсных веб-серверов, при выполнении которой разворачиваются файлы и перезапускаются службы IIS. Администраторы фермы могут задать время выполнения этой операции.

Наконец, компоненты решения фермы регистрируются, а файлы схем и определений фиксируются в хранилище конфигурации.

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

Отмена задания развертывания

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

Но после того как задание таймера на развертывание начало выполняться на каком-либо целевом компьютере, отменить это задание нельзя.

Ошибки установки

Во время установки на интерфейсных веб-серверах могут возникнуть следующие ошибки:

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

  • Если служба администрирования SharePoint Foundation не активна на каком-либо компьютере, в объекте SPRunningJob устанавливается код ошибки, отмечая данный этап как ошибочный и запрещая дальнейшие операции. После неудачного развертывания создается административное оповещение, которое информирует администратора, что задание выполнилось с ошибкой вследствие того, что служба администрирования SharePoint Foundation не запущена.

  • Если при извлечении файлов из пакета решения (WSP-файла) произошла ошибка на каком-либо сервере, то этап отмечается как ошибочный и выполнение останавливается. "Ошибка" будет выделена красным цветом в поле решения Состояние на странице центра администрирования Управление решениями.

  • Если не удалось скопировать один или несколько файлов (например, существующий файл помечен как доступный только для чтения), то этап отмечается как ошибочный и выполнение процедуры развертывания останавливается.

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

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

См. также

Концепции

Удаление и отзыв решения для фермы

Обновление решения фермы