Мощные средства командной строки для администрирования служб SharePoint

Посмотрите, как люди работают с Windows или Microsoft Office. Некоторые пользователи для выполнения типовых задач активно используют мышь, передвигая курсор по меню и панелям инструментов. Другим удобнее

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

Действительно, графический интерфейс легок в использовании, равно как и утомителен при выполнении задач, требующих повторного выполнения одних и тех же действий. Некоторые действия проще выполнять с клавиатуры. Если вы занимаетесь администрированием сервера SharePoint®, то вам, вероятно, приходилось мучиться с графическим интерфейсом. Но в SharePoint есть более удобный способ для выполнения таких задач.

Основным интерфейсом управления службами Windows® SharePoint Services (WSS) и сервером Microsoft® Office SharePoint Server 2007 (MOSS) является интерфейс SharePoint Central Administration (на основе графического интерфейса). Но для решения более сложных задач администрирования в сервере SharePoint предусмотрено также и средство управления с помощью командной строки. Это средство, STSADM.exe, обеспечивает выполнение всех функций интерфейса SharePoint Central Administration с присущей командной строке гибкостью, о которой мечтают многие администраторы. В данной статье я проведу ускоренный курс использования средства STSADM для администрирования служб WSS и сервера MOSS. А также дам некоторые советы по настройке среды и опишу некоторые простые команды средства STSADM. Я покажу и более сложные команды средства STSADM, использование которых позволят вам выглядеть героем, если когда-нибудь в этих командах возникнет необходимость.

Начало работы

Если вы пока не сталкивались с средством STSADM, то это потому, что он как-то очень глубоко упрятан. В Windows SharePoint Services версии 2.0 он по умолчанию находится в папке c:\program files\common files\microsoft shared\web server extensions\60\bin. В версии 3.0 он по умолчанию находится в папке c:\program files\common files\microsoft shared\web server extensions\12\bin.

Для облегчения доступа к этому средству я использую два различных способа. Во-первых, я просто добавляю этот каталог в переменную среды PATH. Таким способом я могу использовать инструмент STSADM из любого места файловой системы. Однако это не всегда удобно. Второй способ — создать ярлык для CMD.EXE и указать папку, где находится средство STSADM, в качестве рабочей. Почему просто не создать ярлык непосредственно для средства STSADM? Это не сработает потому, что STSADM не является интерактивным средством. Если создать такой ярлык и вызвать с его помощью средство STSADM, то на экран будет выведена инструкция по его использованию, после чего средство STSADM закончит работу.

Чтобы использовать средство STSADM, нужно быть членом локальной группы «Администраторы» веб-сервера, и запускать это приложение локально. Это означает, что при помощи средства STSADM удаленно выполнять задачи администрировния сервера SharePoint невозможно.

Чтобы увидеть, какие операции можно выполнять при помощи средства STSADM, введите в командной строке команду stsadm.exe -help. Проверяйте этот список после установки обновлений или исправлений SharePoint, поскольку в него могут быть добавлены новые операции. Также хорошее руководство по работе с приложением stsadm.exe есть по адресу go.microsoft.com/fwlink/?LinkId=77516.

Основы STSADM

Начнем с некоторых команд, которые можно использовать для настройки существующего сервера SharePoint. средство STSADM можно использовать для добавления функций SharePoint и для изменения параметров его настройки.

В командной строке средства STSADM нужно использовать параметр -o, за которым должно следовать имя необходимой операции. Просто ввести команду STSADM -имя_операции недостаточно. Если, например, на сервер нужно добавить шаблоны, следует использовать следующую команду:

Stsadm -o addtemplate -filename <filename of the template> 
-title <title of template> -description <description of template>

Если же нужно установить пакет веб-частей, следует использовать такую команду:

Stsadm -o addwppack -filename <filename of the Web Part Package>

Для получения подробных сведений об использовании любой операции вызовите средство STSADM, указав только имя операции без параметров, и на экран будет выведен список возможных вариантов ввода. Эту же информацию можно получить, введя строку STSADM -help имя_операции.

При управлении шаблонами для просмотра списка установленных шаблонов можно использовать операцию enumtemplates, а для их удаления — операцию deletetemplate. Есть также команды для работы с пакетами веб-частей. Для перечисления пакетов веб-частей, установленных на каждом виртуальном сервере или использующихся в веб-приложении, можно использовать операцию enumwppacks, а для их удаления — операцию deletewppack.

В средстве STSADM есть также две операции, предназначенных для чтения и изменения свойств SharePoint: setproperty и getproperty. При выполнении этих операций без параметров выводится список свойств для просмотра или изменения. Этот список, как и само средство STSADM, может изменяться при обновлениях и исправлениях. Однако есть несколько свойств, более полезных, чем остальные. На рис. 1 приведены некоторые свойства, которые, возможно, придется настраивать после установки SharePoint, в том числе и те, которые, насколько мне известно, администраторы SharePoint используют чаще всего.

Рис. 1  Настройка некоторых важных параметров SharePoint

Параметр Функция

Alerts-enabled	Включает и отключает оповещения на виртуальном сервере или в веб-приложении.
Alerts-limited	Указывает, ограничено ли число оповещений, создаваемых пользователями на виртуальном сервере или в веб-приложении.
Alerts-maximum	Максимальное число оповещений, если установлено ограничение их количества.
Days-to-show-new-icon	Задает количество дней, в течение которых рядом с добавленными на веб-узел элементами, например, объявлениями, будет размещаться значок «Новое».
Job-immediate-alerts	Задает частоту проверки службой SharePoint наличия немедленных сообщений для отсылки. В службах SharePoint 2.0 значение по умолчанию равно пяти минутам. Здесь этот интервал можно изменить. Уменьшение этого времени приведет к увеличению загрузки веб-серверов и серверов баз данных, поэтому будьте внимательны при изменении этого значения.
Job-daily-alerts	Задает время дня для отправки ежедневных оповещений. В службах SharePoint 2.0 значение по умолчанию — «между 22:00 и 06:00». Если есть пользователи, которые находятся не в том часовом поясе, в котором заходится сервер, возможно, этот параметр придется изменить.
Job-weekly-alerts	Скорее всего, здесь будет показан шаблон. С его помощью устанавливается график отправки еженедельных оповещений.

Кратко рассмотрим использование одного из этих свойств. Выполнение следующей команды приведет к тому, что SharePoint будет отправлять немедленные оповещения каждые 10 минут

Stsadm -o setproperty -pn job-immediate-alerts -pv "Every 10 minutes"

Заметьте, что я ввел в командную строку -pn и -pv вместо -propertyname и -propertyvalue. Это допустимые сокращения, которые можно использовать, если не хочется набирать слово целиком. Также обратите внимание, что все примеры и команды, описанные в этом разделе, можно использовать как в службах Windows SharePoint Services версии 2.0, так и версии 3.0.

Повседневные задачи администрирования

Повседневное администрирование SharePoint довольно несложное. Для большинства администраторов SharePoint основные задачи сводятся к работе с пользователями и узлами. В средстве STSADM предусмотрены несколько операций для упрощения выполнения этих задач.

Начнем с узлов и дочерних узлов. Чтобы не запутать читателей, я буду использовать слово «узел» по отношению к содержимому узла целиком, и «дочерний узел» по отношению к его составляющим. Некоторые термины выглядят сложными, но если сопоставить их с командами и параметрами средства STSADM, то впоследствии будет легче найти требуемую команду.

В случае крупномасштабной установки SharePoint довольно много времени может уйти на создание новых узлов для пользователей. Я это знаю, так как сам регулярно этим занимался. Создавать новые узлы можно при помощи средства SharePoint Central Administration. Но при частом выполнении таких задач, можно убедиться, что при использовании средства STSADM времени требуется меньше.

Я использовал операцию createsite. Это довольно просто. Эту операцию можно использовать с такими параметрами:

• url <url>
• ownerlogin <ДОМЕН\имя>
• owneremail <someone@example.com>
• ownername <отображаемое имя>
• lcid <язык>
• sitetemplate <шаблон узла>
• title <название узла>
• description <описание узла>
• quota <шаблон квот>

Их можно увидеть в командной строке, введя stsadm -help createsite (см. рис. 2). Из этих девяти параметров обязательными являются только URL, ownerlogin и owneremail.

Рисунок 2 Параметры операции createsite

Если есть однотипные регулярно создаваемые узлы, можно пойти дальше в упрощении процесса, написав сценарий для автоматизации работы средства STSADM. Например, для автоматизации создания личных узлов можно создать текстовый файл createpersonalsite.cmd и сохранить в нем следующие команды:

stsadm -o createsite -url http://localhost/users/%1 -ownerlogin contoso\%1 
-owneremail %1@contoso.com -sitetemplate usersite.stp 
-title "Personal site for %1" -description "Personal site for %1" -quota "500 MB"

После этого для создания узла пользователя jsmith достаточно будет выполнить следующее:

createpersonalsite.cmd jsmith

С помощью сценариев создания узлов можно уберечь себя от набора множества команд на клавиатуре и обеспечить согласованность создаваемых узлов. Операция createweb обеспечивает ту же функциональность на уровне дочерних узлов.

При использовании служб Windows SharePoint Services 2.0 использование средства STSADM — это единственный простой способ получить полный список семейства узлов на каждом конкретном виртуальном сервере. Операция enumsites служит для перечисления в формате XML всех семейств узлов на конкретном виртуальном сервере или в веб-приложении. Эту операцию можно совместить с использованием веб-части «Представление данных» (Data View) для более удобного просмотра списка семейств узлов. (Подробнее см. врезку «Использование веб-части "Представление данных" (Data View)».

В средстве STSADM есть операция deletesite, предназначенная, как можно догадаться, для удаления узлов. Единственное, что нужно сделать — задать URL-адрес. При желании можно использовать параметр -deleteadaccounts и удалить учетные записи из службы каталогов Active Directory®. При работе с дочерними узлами следует использовать операцию deleteweb.

Можно также добавлять, удалять и перечислять пользователей узла или дочернего узла при помощи операций adduser, deleteuser и enumusers соответственно. Эти операции удобны, когда нужно добавить сразу несколько пользователей узла, или если нужно вести список пользователей, имеющих доступ к узлу для аудита.

При работе с дочерними узлами можно использовать также дополнительную операцию renameweb, которая позволяет изменять имя и URL-адрес дочернего узла. Например, чтобы изменить имя дочернего узла с "oldname" на "coolnewname", используйте следующую команду:

Stsadm -o renameweb -url http://localhost/oldname -newname coolnewname

Это очень выручает в случае изменения названия проекта или изменения организационной структуры. Для служб Windows SharePoint Services 2.0 это большая проблема, поскольку единственным средством переноса дочерних узлов является программа SMIGRATE.exe, которая не сохраняет пользовательские параметры, такие как принадлежность к группам и оповещения. При использовании служб Windows SharePoint Services 3.0 это не так важно, поскольку при помощи средства STSADM можно сохранять резервные копии и восстанавливать из них узлы и дочерние узлы.

Резервное копирование и восстановление

Одним из полезных применений средства STSADM является создание резервных копий и восстановление узлов и дочерних узлов. Для систем малых и средних размеров эти функции можно использовать как основу плана восстановления на случай аварийной ситуации. Операция backup (резервное копирование) говорит сама за себя и ее легко использовать. Просто укажите в командной строке средства STSADM, какой узел нужно скопировать и где создать файл резервной копии, например:

Stsadm -o backup -url http://localhost -filename site.bak

Эта операция копирует все семейство узлов в файл site.bak, включая все содержимое — дочерние узлы, версии документов, списки и пользователей. Однако описания узлов и изменения, сделанные на уровне файловой системы серверов, не копируются.

Резервное копирование весьма важно, при этом имеются некоторые трудности, о которых нельзя забывать. Если узел довольно велик, база данных его содержимого (Content Database) на время резервного копирования может быть заблокирована. Это может препятствовать доступу пользователей к узлам этой базы данных, пока операция копирования не завершится. Эта проблема смягчена при помощи пакетов обновлений, но все же за ростом объема данных узлов нужно следить. Кроме того, поскольку при резервном копировании и восстановлении средство STSADM использует временный каталог на сервере, нужно следить за наличием свободного места на дисках.

Использование веб-части «Представление данных» (Data View)

Чтобы удобнее было просматривать списки семейства узлов, команду enumsites можно использовать вместе с веб-частью «Представление данных». Это можно сделать следующим образом.

Сначала создайте назначенное задание, выполняющее следующую операцию:

stsadm –o enumsites –url http://localhost
>c:\inetpub\wwwroot\excludedsite\sites.xml 

Убедитесь, что XML-файл помещен в каталог, доступный через сервер IIS, но не контролируемый сервером SharePoint. Затем при помощи приложения Microsoft FrontPage® (или его преемника Microsoft Office SharePoint Designer 2007) добавьте веб-часть Data View на страницу веб-частей и укажите в нем URL-адрес XML-файла.

Веб-часть Data View позволяет выполнять такие функции как сортировка, фильтрации и группировка. В поле URL можно также поместить ссылку непосредственно на узел. Если же нужен список дочерних веб-узлов, то при выполнении операции enumsubwebs будет выведена информация о дочерних веб-узлах данного веб-узла в формате XML.

И последнее: помните, что резервное копирование с помощью STSADM хорошо работает только на узлах небольшого и среднего размеров, и эта функция плохо масштабируется. На очень больших узлах (объемом несколько гигабайт и больше) процесс резервного копирования и восстановления может выполняться несколько медленнее.

Восстановление узла тоже довольно несложная операция. Команда STSADM -o restore использует файл, созданный командой STSADM -o backup и записывает его содержимое на узел SharePoint. Это довольно универсальная команда: можно восстановить содержимое узла на его исходном месте (если, например, оно было удалено по ошибке), можно восстановить его на другом узле того же виртуального сервера (если нужно протестировать узел, не рискуя потерять данные) или же можно восстановить узел на другом сервере или виртуальном сервере.

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

При использовании средства STSADM со службами Windows SharePoint Services версии 2.0 есть одно серьезное ограничение. Можно выполнять резервное копирование только веб-узлов, а дочерних узлов — нет. Администраторы сумели довести свое недовольство до корпорации Майкрософт, и это замечание было учтено. В версии 3.0 служб Windows SharePoint Services уже можно выполнять резервное копирование и восстановление дочерних узлов. Были также добавлены еще две команды — для импорта (import) и экспорта (export).

Для экспорта дочернего узла используется следующая команда:

Stsadm -o export -url http://localhost/web -filename backup.dat

С операцией export можно использовать дополнительные параметры, например, ключ -version. С помощью этого ключа можно контролировать размер файла резервной копии путем ограничения количества версий копируемых файлов.

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

Stsadm -o import -url http://localhost/web2 -filename backup.dat

Если узел довольно большой, резервная копия может состоять из нескольких частей. В этом случае укажите в команде STSADM -o import файл первой части, а остальные части будут найдены автоматически.

Раздел для специалистов

Теперь, поскольку вы уже освоились с STSADM, я покажу несколько операций, которые позволяют устанавливать связи. Первая — это недавно добавленная операция migrateuser. Службы версии 2.0 не синхронизируются со службами Active Directory. Если выполнялось переименование учетной записи, пользователь больше не мог войти на сервер SharePoint. Раньше также не было возможности переносить данные о правах доступа пользователя из одной учетной записи пользователя домена в другую. До выпуска пакета обновления 2 (SP2) для Windows SharePoint Services 2.0 приходилось удалять пользователя с каждого дочернего узла и вручную добавлять новую учетную запись.

В пакет обновления 2 (SP2) был включен новый интерфейс API, и средство STSADM позволяет использовать его преимущества. При переименовании учетной записи jsmith в jjones можно использовать следующую команду:

Stsadm -o migrateuser -oldlogin domain\jsmith -newlogin domain\jjones -ignoresidhistory

Поскольку учетные записи на самом деле не переносятся, данные журнала идентификаторов безопасности Windows (SID) можно игнорировать. Обратите внимание, что данная команда не требует URL-адреса. Она производит изменения в базах данных содержимого безотносительно узла или дочернего узла.

Другая полезная операция — unextendvs. Если не нужно, чтобы служба SharePoint отображала виртуальный сервер или веб-приложение, можно его отключить. Обычно это делается при помощи средства SharePoint Configuration Analyzer. Однако в случае установки службы в веб-ферме средство SharePoint Configuration Analyzer требует, чтобы на всех серверах были установлены одинаковые пакеты исправлений. Однако какой-либо сервер может быть не синхронизирован с остальными серверами веб-фермы, и в этом случае средство SharePoint Configuration Analyzer не сможет его отключить. Тем не менее, можно отключить виртуальный сервер с помощью следующей команды STSADM :

Stsadm -o unextendvs -url http://localhost

Если сервер больше не входит в состав веб-фермы, можно провести необходимое обслуживание сервера.

При установке SharePoint в веб-ферме для облегчения администрирования можно на всех серверах настроить средство SharePoint Configuration Analyzer на использование одного и того же порта. Порт выбирается случайным образом при установке SharePoint, однако средство STSADM включает операцию для изменения номера порта на номер порта, заданный пользователем:

Stsadm -o setadminport -port 1026

При этом производятся все необходимые изменения в базе данных, изменения параметров настройки сервера IIS и корректируется ярлык средства SharePoint Configuration Analyzer в меню Administrative Tools.

Заключение

Службы Windows SharePoint Services являются мощным средством и требуют соответствующих средств администрирования. Средство STSADM обеспечивает возможность администрирования служб SharePoint, в том числе автоматизацию настройки и выполнения повседневных задач. По сути, иногда это единственно возможный способ выполнения задачи.