Средство обновления и миграции сервера для Microsoft Office

Средство обновления и
миграции сервера для
Microsoft Office InfoPath 2007
Обзор
Средство обновления и миграции сервера для Microsoft® Office InfoPath® 2007 позволяет
администратору фермы продуктов и технологий SharePoint® изменять жестко
запрограммированные URL-адреса в шаблонах форм InfoPath, универсальных файлах
подключения к данным (UDCX-файл) версии 2 и типах содержимого для обеспечения
правильной работы шаблонов форм при следующих обстоятельствах:

при постепенном обновлении служб Microsoft Windows® SharePoint Services
версии 2.0 до версии 3.0 или сервера SharePoint Portal Server 2003 до Microsoft
Office SharePoint Server 2007;

при миграции форм InfoPath и шаблонов форм из одних служб Windows
SharePoint Services 3.0, серверов Microsoft Office SharePoint 2007 или семейств
веб-узлов в другие.
Во время постепенного обновления сервер Windows SharePoint Services 2.0 временно
переименовывается. Чтобы формы InfoPath на переименованном сервере продолжали
работать во время обновления, с помощью средства обновления и миграции сервера
можно изменить жестко запрограммированные URL-адреса для подключений данных,
содержащихся в шаблоне формы InfoPath, к локальному серверу. После обновления
семейства веб-узлов можно повторно использовать данное средство для задания URLадресам их исходных имен.
Средство также можно использовать на сервере со службами Windows SharePoint Services
3.0 после миграции содержимого из одного местоположения в другое. Это позволит
исправить URL-адреса, которые могли быть повреждены во время перемещения. Таким же
образом это средство можно использовать для исправления URL-адресов при
восстановлении на новом сервере резервной копии базы данных содержимого или
подключении существующей базы данных содержимого к новому серверу. При запуске
средства в веб-приложении или семействе веб-узлов версии 3.0 также обновляются
следующие компоненты:

подключения данных к локальному серверу, содержащиеся в файлах
подключения к данным библиотеки подключений к данным;

URL-адрес шаблона формы, содержащийся в типе содержимого.
Требования к системе
Это средство работает со следующими серверными продуктами:

Microsoft Windows SharePoint Services 2.0 с пакетом обновления 2 (SP2);

Windows SharePoint Services 3.0;

Microsoft Office SharePoint Server 2007.
Для работы средства требуются следующие версии Microsoft .NET Framework:

.NET Framework версии 1.1 (при использовании со службами Windows SharePoint
Services 2.0);

.NET Framework версии 2.0 (при использовании со службами Windows SharePoint
Services 3.0 или сервером Office SharePoint Server 2007).
Случаи использования
Средство следует использовать в случаях перемещения содержимого веб-узла SharePoint,
содержащего формы InfoPath, шаблоны форм или типы содержимого, на сервер с другим
именем или переименования самого сервера. Это может произойти в следующих
ситуациях:

запуск постепенного обновления одних версий продуктов и технологий SharePoint
до других;

завершение постепенного обновления;

миграция содержимого с помощью средства копирования и перемещения;

миграция содержимого путем экспорта в CAB-файл с последующим импортом на
другой сервер;

миграция содержимого путем подключения базы данных другого сервера;

переименование сервера;

восстановление резервной копии содержимого на новом сервере;

переименование типа содержимого.
При выполнении постепенного обновления служб Windows SharePoint Services 2.0 до
Windows SharePoint Services 3.0 запустите средство для всего веб-приложения, которое
было переименовано в начале обновления. (Если известно, что только некоторые
семейства веб-узлов содержат шаблоны форм и типы содержимого InfoPath, можно
выполнить данное действие только для них.) Поскольку отдельные семейства веб-узлов
обновляются до версии 3.0, это средство можно использовать для обновленных семейств
веб-узлов, чтобы восстановить предыдущее имя сервера.
Предварительное сканирование перед обновлением
Перед началом обновления или миграции следует запустить средство в режиме «только
сканирование», чтобы определить, следует ли предварительно исправить что-либо. Режим
«только сканирование» является режимом по умолчанию и позволяет узнать о том, какие
компоненты будут изменены при запуске средства в режиме исправлений.
Принцип работы
Средство обновления и миграции сервера запускается в веб-приложении служб Windows
SharePoint Services 2.0 или Windows SharePoint Services 3.0, семействе веб-узлов или в
отдельном шаблоне формы InfoPath и выполняет операцию поиска и замены для
определенных URL-адресов в файлах InfoPath, обнаруженных при сканировании. В режиме
исправлений средство изменяет значения этих файлов на новые.
Во время сканирования изменяются следующие типы файлов:

файлы шаблонов форм (XSN), связанные с библиотеками форм или документов;

файлы шаблонов форм (.xsn), связанные с типами содержимого InfoPath;

файлы шаблонов форм (.xsn), которые представляют области сведений о
документе, связанные с типами содержимого приложений Microsoft Office Word,
Office Excel® и Office PowerPoint®;

шаблоны типов содержимого, которые ссылаются на формы шаблонов InfoPath;

UDC-файлы, хранящиеся в библиотеках подключений к данным.
Следующие типы файлов не изменяются:

файлы шаблонов форм, защищенные с помощью компонента управления
правами на доступ к данным (IRM);

утвержденные администратором шаблоны форм, которые управляются с
помощью страниц центра администрирования SharePoint;

UDC-файлы, управляемые с помощью страниц центра администрирования
SharePoint;

шаблоны форм, не связанные с библиотекой документов или типом
содержимого;

заполненные экземпляры форм (XML-файлы) (в большинстве случаев
обновляются во время процесса повторного создания связей сервера);

файлы подключения к данным Office (ODC-файлы);

другие файлы, не связанные с InfoPath или библиотеками подключений к
данным.
Примечание. В случае с подписанными шаблонами, шаблонами, защищенными
управлением правами на доступ к данным, или одобренными администратором
шаблонами форм, средство может обновить тип содержимого, относящийся к шаблону,
даже если пропущен сам шаблон.
Обновляемые URL-адреса
Средство обновляет следующие URL-адреса в шаблонах форм:

URL-адрес отправки в библиотеку SharePoint;

URL-адрес запроса по списку SharePoint;

URL-адрес главной веб-службы;

URL-адрес языка Wsdl главной веб-службы;

URL-адрес дополнительной веб-службы;

URL-адрес языка Wsdl дополнительной веб-службы;

URL-адрес времени разработки для UDC-файлов (все типы подключений
данных);

URL-адрес HTTP Post;

URL-адрес подключения файла XML;

URL-адрес настраиваемой области задач;

URL-адрес шаблона формы, на который ссылается правило;

главный URL-адрес отправки SharePoint;

ключ соответствия веб-службы для автономного кэша;

ключ соответствия списка SharePoint для автономного кэша;

ключ соответствия XML-файла для автономного кэша.
Средство обновляет следующие URL-адреса в UDC-файлах:

URL-адрес языка WSDL веб-службы;

URL-адрес веб-службы;

URL-адрес XML-файла;


URL-адрес списка SharePoint;
URL-адрес HTTP Post;

URL-адрес отправки SharePoint;

URL-адрес списка SharePoint.
Также обновляется URL-адрес шаблона формы, связанного с типом содержимого.
Другие URL-адреса, содержащиеся в шаблоне формы InfoPath, не обновляются. Например,
не обновляются относительные пути к настраиваемым изображениям, связанным с
кнопками панели команд.
Подписанные шаблоны форм
Шаблоны форм, имеющие цифровой сертификат, нельзя повторно подписать с помощью
этого средства. Поскольку изменение этих шаблонов форм требует дополнительных
действий, они копируются в место, указанное параметром командной строки /s. Это
средство может изменить только копию. Исходный шаблон формы изменить нельзя. При
работе с InfoPath в режиме конструктора конструктор форм снова создаст цифровую
подпись шаблона формы и повторно опубликует его в новое место перед использованием
формы.
Примечание. Это средство не изменяет шаблоны форм с подписью «Полное доверие». В
большинстве случаев шаблоны форм с уровнем безопасности «Домен» будут работать
даже после удаления подписи. Обратите внимание, что средство не различает
действительные и недействительные подписи. Перед тем как повторно подписать шаблон
формы, перемещенный во временную папку, следует убедиться в правильности исходной
подписи.
Новые атрибуты для перенаправления HTTP
Кроме описанных выше изменений в URL-адресах это средство управляет новыми
атрибутами в файле manifest.xsf, который является частью шаблона формы. Эти атрибуты
управляют способом, которым приложение InfoPath обрабатывает кэшированные шаблоны
форм во время их перенаправления в качестве части постепенного обновления.
Дополнительная информация приведена далее в главе «Особые сведения» этого файла
сведений о продукте.
Установка и использование средства
При установке средства с помощью самораскрывающегося EXE-файла в каталог bin
сервера продуктов и технологий SharePoint помещаются два исполняемых файла и
связанные с ними библиотеки (в этом же каталоге содержится файл StsAdm.exe). Оба
двоичных файла выполняют похожие задачи, но скомпилированы для объектных моделей
версий 2.0 и 3.0 соответственно.
Исполняемый файл
Назначение
IpWssUpg.exe
Используйте этот исполняемый файл при
работе с содержимым на веб-узле версии
2.0, например содержимым на
переименованном сервере версии 2.0,
который еще не был обновлен до версии
3.0.
IpWssMig.exe
Используйте этот исполняемый файл при
работе с содержимым на веб-узле версии
3.0, например содержимым, обновленным с
версии 2.0. Также этим средством можно
воспользоваться для обработки
содержимого, миграция которого была
выполнена с одного веб-узла версии 3.0 на
другой.
Это средство необходимо запустить на локальном компьютере пользователем, который
обладает правами глобального администратора служб Windows SharePoint Services. По
умолчанию такими правами обладает любой пользователь, включенный в группу
локальных администраторов при первой установке служб Windows SharePoint Services, а
также пользователи, запустившие мастер настройки продуктов и технологий SharePoint.
Синтаксис
Все параметры не учитывают регистр.
IPWSSUpg.exe /f <искомый префикс URL-адреса> /r <префикс URL-адреса для замены> /p <URL-адрес
для начала проверки> /s <место для копирования подписанных шаблонов форм> /m [scan | fix] /l
[application | sitecollection | template] /g <путь к файлу журнала> /k
Примечание. Синтаксис для файла IPWssMig.exe тот же самый.
Параметры описаны в указанной ниже таблице.
Переключатель
Значение
Тип
Описание
f
Поиск
URL-адрес
Обязательный.
URL-адрес, который необходимо
заменить URL-адресом, указанном
в параметре /r.
Этот параметр должен начинаться
с http:// или https://
r
Замена
URL-адрес
Обязательный.
Новый URL-адрес веб-приложения
p
Путь
URL-адрес
Необязательный. Назначает
стандартный URL-адрес вебприложения, указанный в
параметре /r.
Путь к веб-приложению, семейству
веб-узлов или шаблону формы,
которые требуется обновить.
s
m
Каталог для
сохранения
измененных
подписанных
шаблонов форм
Путь
Режим
Перечисление
Необязательный. Назначает
стандартный путь
%temp%\IPWSSUpg
Подписанные шаблоны форм будут
изменены и перемещены в этот
каталог. Исходные подписанные
шаблоны форм не будут изменены.
Необязательный. Назначает
значение по умолчанию scan
Значения:

scan или s;

fix или f.
Если выбрано значение scan,
средство выполнит обновление и
зарегистрирует изменения, но не
будет обновлять шаблоны форм.
Если выбрано значение fix,
средство обновит шаблоны форм,
заменив повторения параметра /f
параметром /r.
l
Уровень
Перечисление
Необязательный. Назначает
значение по умолчанию
sitecollection
Определяет, обрабатывает ли
средство веб-приложение,
семейство веб-узлов или
отдельный шаблон
Значения:

application или a;

sitecollection или s;

template или t.
Примечание. Средство оценит
параметр /p согласно этому
значению. Например, параметр
http://foo может означать как вебприложение, так и семейство
корневых узлов. Если параметр
http://foo не содержит семейство
корневых узлов, а средство находит
синтаксис /p http://foo /l
sitecollection, происходит сбой с
сообщением об ошибке invalid site
collection («неверное семейство
веб-узлов»)
g
Расположение
журнала
Путь
Необязательный. Назначает путь
по умолчанию к каталогу журнала
служб Windows SharePoint Services
с названием IPWSSUpg_mm-ddyyyy_hh-mm-ss.log (где mm —
месяц и т. д.), в котором
отображается дата и время
запуска.
Если каталога не существует,
средство его создаст.
Если указанный файл уже
существует, он будет перезаписан.
k
Пропуск
подписанных
шаблонов форм
Нет параметров
Необязательный. Если этот
переключатель включен, средство
не будет обрабатывать
подписанные шаблоны форм.
Последовательность действий при постепенном обновлении с версии
2.0 до версии 3.0
Для обеспечения правильной работы шаблонов форм во время постепенного обновления
служб Windows SharePoint Services с версии 2.0 до версии 3.0 необходимо выполнить
указанные ниже действия.
Эти действия подразумевают, что сервер имеет имя http://someserver и в начале процесса
постепенного обновления переименовывается в http://someserverV2.
1. Запустите обновление. При этом сервер версии 2.0 переименовывается, по
исходному URL-адресу создается сервер версии 3.0, а все содержимое
перенаправляется на сервер версии 2.0.
2. Запустите программу IpWssUpg.exe в режиме сканирования для веб-приложения
версии 2.0.
Пример
IpWssUpg.exe /f http://someserver /r http://someserverV2 /p http://someserverV2 /l
application /m scan
Примечание. Если известно, что только некоторые семейства веб-узлов содержат
шаблоны форм и типы содержимого InfoPath, можно выполнить эту команду для отдельных
семейств веб-узлов, указав параметр /l sitecollection.
3. Проверьте журнал, чтобы убедиться в правильности результатов. Например, при
обнаружении шаблонов форм, подписанных или защищенных управлением
правами на доступ к данным, может потребоваться связаться с их владельцами с
просьбой изменить эти шаблоны вручную вне диапазона.
4. Чтобы исправить все шаблоны форм в веб-приложении, запустите программу
IpWssUpg.exe для веб-приложения версии 2.0.
Пример
IpWssUpg.exe /f http://someserver /r http://someserverV2 /p http://someserverV2 /l
application /m fix
Примечание. Если известно, что только определенные семейства веб-узлов содержат
шаблоны форм и типы содержимого InfoPath, можно выполнить эту команду для отдельных
семейств веб-узлов, указав параметр /l sitecollection.

В процессе обновления отдельных семейств веб-узлов до версии 3.0 запустите
программу IpWssMig.exe для восстановления URL-адресов исходного сервера в
шаблонах форм в данных семействах веб-узлов.
Пример
IpWssMig.exe /f http://someserverV2/sites/somesitecollection
/r
http://someserver/sites/somesitecollection /p
http://someserver/sites/somesitecollection /l sitecollection /m fix
Особые сведения
Альтернативное сопоставление доступа
Шаблоны форм на сервере с двумя или более URL-адресами альтернативного доступа
могут содержать подключения данных со ссылками на некоторые или все альтернативные
имена сервера. В таких случаях может потребоваться запустить средство несколько раз —
по одному разу для каждого URL-адреса альтернативного доступа.
Например, имя сервера во внутренней сети — http://someserver, но в Интернете это имя
отображается как http://someinternetdomain. Во время постепенного обновления исходный
сервер переименовывается в http://someserverV2, а его URL-адрес в Интернете становится
http://someinternetdomainV2.
В таких случаях может потребоваться запустить средство сначала для замены имени
http://someserver на http://someserverV2, а затем для замены имени
http://someinternetdomain на http://someinternetdomainV2.
Подключения к списку SharePoint
InfoPath использует идентификатор списка SharePoint для подключения к нему во время
запуска. В некоторых сценариях идентификатор списка восстанавливается при миграции
списка на другой веб-узел. Таким образом, все подключения форм InfoPath к списку
прерываются.
По возможности миграцию списков SharePoint, подключение к которым выполняется с
помощью шаблонов форм InfoPath, следует осуществлять способом, позволяющим
сохранять идентификатор списка. Если это невозможно, следует обновлять шаблон формы
в режиме конструктора в приложении InfoPath, чтобы создать ссылки для списка на новое
местоположение.
Следующие сценарии позволяют сохранить идентификатор списка при перемещении
списка:

миграция содержимого с использованием пользовательского кода при
установленном значении true параметра retainObjectIdentity объекта
SPImportSettings;

обновление сервера с версии 2.0 до версии 3.0 на месте;

постепенное обновление сервера с версии 2.0 до версии 3.0;

восстановление содержимого из резервной копии или путем подключения базы
данных содержимого;

перемещение веб-узла с помощью страницы копирования и перемещения;

миграция содержимого с помощью страницы развертывания.
Следующие сценарии будут восстанавливать идентификаторы списков:

миграция содержимого с помощью средства командной строки StsAdm;

копирование веб-узла с помощью страницы копирования и перемещения.
Прерывание процесса
Если работа средства прервана (вручную, из-за сбоев электропитания или неожиданной
ошибки программы) во время записи файла, файл может повредиться и его следует
восстановить вручную.
Обновление отдельных шаблонов форм
Некоторые шаблоны форм, которые обычно не обрабатываются средством, также требуют
обновления. Сюда относятся шаблоны форм, ранее связанные с типом содержимого,
который был обновлен с помощью новых шаблонов форм, и сохраненные в библиотеке
документов, но не связанные с типом содержимого. В таких случаях средство следует
использовать с параметром /l template для обновления каждого шаблона формы по
отдельности.
Примечание. При обновлении отдельного шаблона формы указатель шаблона формы,
расположенный в XML-файле типа содержимого, не обновляется.
Типы содержимого и UDC-файлы нельзя изменить по отдельности.
Обновление нескольких URL-адресов веб-узла в подписанных
шаблонах форм
Измененная версия подписанного шаблона формы сохраняется во временной папке. В
некоторых случаях, подобных описанному выше сценарию альтернативного сопоставления
доступа, может потребоваться запустить средство несколько раз для веб-приложения,
семейства веб-узлов и шаблона формы. Чтобы применить все изменения в подписанном
шаблоне формы, любые изменения в шаблоне формы после первого запуска следует
выполнять с помощью параметра /l template, работая с уже измененным шаблоном
формы. Поскольку для изменения шаблона формы требуется, чтобы он находился на вебузле SharePoint, шаблоны форм следует копировать из временной папки в библиотеку
документов на веб-узле SharePoint перед осуществлением дальнейших изменений.
Зависимости межузловых семейств
Если шаблон формы в одном семействе веб-узлов содержит URL-адреса ресурсов другого
семейства веб-узлов на том же сервере, после обработки первого семейства могут
остаться неразрешимые ссылки на ресурсы второго семейства. По этой причине семейства
веб-узлов, зависящие друг от друга, следует обновлять вместе, а средство следует
запускать для всех семейств веб-узлов в цепи зависимости.
Перенаправление HTTP и кэшированное содержимое
При обновлении веб-приложения Windows SharePoint Services версии 2.0 до версии 3.0
(или SharePoint Portal Server 2003 до Microsoft Office SharePoint Server 2007)
осуществляется перенаправление HTTP. Приложение InfoPath 2003 не поддерживает
перенаправление HTTP для обновления локального кэша шаблона формы. Приложение
InfoPath 2007 поддерживает коды перенаправления HTTP 301, 302 или 307 для доступа к
шаблонам форм и обновления локального кэша. При выполнении перенаправления всегда
запрашивается подтверждение пользователя.
Указанные ниже параметры реестра определяют, будет ли приложение InfoPath 2007
использовать перенаправление HTTP в таких ситуациях.
Подраздел
Тип
Параметр
ы
Значени
е по
умолчан
ию
HKEY_CURRENT_USER\Software\Microsoft\Office\
12.0\InfoPath\Security\GradualUpgradeRedirection
REG_DWORD
0
(отключить
)
1
1
(внутрення
я сеть)
2
(внутрення
я сеть /
Интернет)
Параметр
Поведение
Отключить
Все перенаправления URL-адресов будут
блокироваться. При попытке перенаправления
формой или ее шаблоном будет выведено сообщение
о междоменной ошибке.
Внутренняя сеть
Все веб-узлы внутренней сети смогут следовать
перенаправлению URL-адресов на другое
расположение во внутренней сети. Во время этих
перенаправлений будет выводиться запрос
безопасности в разделе 10.2.
Внутренняя сеть / Интернет
Все веб-узлы внутренней сети и Интернета смогут
следовать перенаправлению URL-адресов на другое
расположение во внутренней сети или Интернете. Во
время этих перенаправлений будет выводиться
запрос безопасности в разделе 10.2.
Чтобы правильно определить, какое расположение шаблона форм является каноническим
для кэширования, средство обновления и миграции сервера прочитает и запишет два
новых атрибута в файле manifest.xsf, который является частью шаблона форм, согласно
следующей таблице.
gradualUpgradeTemporaryUrl
Обозначает URL-адрес
временного (версия 2.0)
веб-узла.
Создается программой
IPWSSUpg.exe согласно
параметру /r.
gradualUpgradePermanentUrl
Обозначает URL-адрес
временного (версия 3.0)
веб-узла.
Создается программой
IPWssUpg.exe согласно
параметру /f.
В процессе обновления, а также для возврата к постоянному расположению по окончании
обновления приложение InfoPath будет обращаться к временной папке с шаблоном формы.
Оба атрибута удаляются в следующих случаях:


шаблон формы обрабатывается программой IPWSSMig.exe;
шаблон формы публикуется на веб-узле SharePoint с URL-адресом,
совпадающим либо со значением gradualUpgradeTemporaryUrl, либо со
значением gradualUpgradePermanentUrl;

шаблон формы публикуется как сообщение электронной почты;

шаблон формы публикуется как пакет установщика Windows (MSI-файл).
Если веб-узел версии 2.0 необходимо сохранять долгое время, до того как все веб-узлы
будут обновлены до версии 3.0, может потребоваться добавить новые шаблоны форм или
изменить текущие шаблоны на веб-узле версии 2.0. Для успешного обновления
ознакомьтесь с приведенными ниже рекомендациями.

Добавление новых шаблонов форм на веб-узел версии 2.0 после запуска
средства обновления может вызвать неправильную миграцию кэшированных
шаблонов форм с компьютеров пользователей на сервер версии 3.0. Чтобы
устранить эту проблему, пользователи могут создать новую форму в библиотеке
форм на веб-узле версии 3.0; это позволит обновить локальный кэш правильным
шаблоном формы.

Обновление шаблонов форм, уже находящихся на веб-узле версии 2.0, следует
выполнять с помощью шаблона форм в каталоге Forms библиотеки, а не с
помощью локальной копии конструктора форм. Благодаря этому сохранятся все
атрибуты, добавленные средством обновления.