Пример скрипта служб Reporting Services rs.exe для копирования содержимого между серверами отчетов

Область применения: SQL Server Reporting Services (2008 R2 и более поздней версии) Сервер отчетов Power BI

Эта статья содержит и описывает пример скрипта RSS служб Reporting Services, который копирует элементы содержимого и параметры с одного сервера отчетов SQL Server Reporting Services на другой сервер отчетов с помощью программы RS.exe . RS.exe устанавливается вместе со службами Reporting Services как в режиме работы в собственной системе команд, так и в режиме SharePoint. Скрипт копирует с одного сервера на другой элементы служб Reporting Services, например отчеты и подписки. Скрипт поддерживает как режим интеграции с SharePoint, так и собственный режим сервера отчетов.

Скачивание скрипта ssrs_migration.rss

Скачайте скрипт с сайта GitHub Скрипт переноса RS.exe служб Reporting Services в локальную папку. Дополнительные сведения см. в разделе Использование скрипта данной статьи.

Поддерживаемые сценарии

Скрипт поддерживает как режим интеграции с SharePoint, так и собственный режим сервера отчетов. Скрипт поддерживает версии SQL Server 2008 R2 (10.50.x) и более поздних версий, а также Сервер отчетов Power BI.

Скрипт может копировать содержимое между серверами отчетов, работающих в одном или разных режимах. Например, можно запустить скрипт для копирования содержимого из сервера отчетов в собственном режиме SQL Server 2008 R2 (10.50.x) в сервер отчетов в режиме sql Server 2012 с пакетом обновления 1 (SP1) (11.0.3x) в режиме отчетов SharePoint. Можно запустить скрипт с любого сервера, на котором установлена программа RS.exe. Например, в таком развертывании можно сделать следующее.

• Запустите RS.exe и скрипт НА сервере A.

• Скопировать содержимое С сервера В.

• НА сервер С

Дополнительные сведения об утилите RS.exe см. в разделе Служебная программа RS.exe (SSRS).

Элементы и ресурсы, которые переносит скрипт

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

Необходимые разрешения

Разрешения, необходимые для чтения и записи элементов и ресурсов, различные для разных методов, используемых в скрипте. В следующей таблице перечислены методы, используемые для каждого элемента или ресурса, и ссылки на соответствующее содержимое. Ознакомьтесь с отдельными статьям, в которых описаны необходимые разрешения. Например, в статье метода ListChildren указаны необходимые разрешения:

• Обязательные разрешения для собственного режима: свойства ReadProperties для элемента

• Обязательные разрешения в режиме SharePoint: ViewListItems

Дополнительные сведения см. в статье "Сравнение ролей и задач в службах Reporting Services" с группами и разрешениями SharePoint.

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

1. Загрузите файл скрипта в локальную папку, например c:\rss\ssrs_migration.rss.

2. Откройте командную строку с правами администратора.

3. Перейдите к папке, содержащей файл ssrs_migration.rss.

4. Выполните команду с параметрами, соответствующими сценарию.

Простой пример, из сервера отчетов в собственном режиме на сервер отчетов в собственном режиме.

В следующем примере выполняется миграция содержимого с Sourceserver в собственном режиме на Targetserverв собственном режиме.

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://SourceServer/ReportServer -u Domain\User -p password -v ts="https://TargetServer/reportserver" -v tu="Domain\Userser" -v tp="password"

Заметки по использованию.

• Скрипт выполняется в два шага.

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

  Скрипт можно отменить после шага 1, если вы хотите просмотреть только возможный список миграции или изменить параметры. Зависимые параметры не перечислены на шаге 1. Например, не перечисляются параметры кэша отчета, а только сам отчет.

  Совет

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

  Хорошее применение данных аудита, получаемых после выполнения первого шага, — просмотреть существующие роли как на исходном, так и на целевом серверах, работающих в собственном режиме. В следующем примере показан список аудита шага 1. Обратите внимание, что список содержит "роли" раздела, так как был использован параметр -v security="True".

  • Retrieve and report the list of items that will be migrated. You can cancel the script after step 1 if you do not want to start the actual migration.

    Retrieving roles:

    Role: Browser

    Role: Content Manager

    Role: Model Item Browser

    Retrieve and report the list of items that will be migrated. You can cancel the script after step 1 if you do not want to start the actual migration.

    Retrieving roles:

    Role: Browser

    Role: Content Manager

    Role: CustomRole

    Role: Model Item Browser

    Role: My Reports

    Role: Publisher

    Role: Report Builder

    Role: System Administrator

    Role: System User

    Retrieving system policies:

    Retrieving system policies:

    System policy: BUILTIN\Administrators

    System policy: domain\user1

    System policy: domain\ueser2

    Retrieving schedules:

    Schedule: theMondaySchedule

    Retrieving catalog items. This may take a while.

    Folder: /Data Sources

    DataSource: /Data Sources/Aworks2012_oltp

    Folder: /images

    Resource: /images/Boba Fett.png

    Resource: /images/R2-D2.png

    Folder: /Reports

    Report: /Reports/products

    Report: /Reports/test

    Report: /Reports/TitleOnly

• SOURCE_URL и TARGET_URL должны быть действительными URL-адресами сервера отчетов, которые указывают на исходный и целевой сервер отчетов служб Reporting Services. В собственном режиме URL-адрес сервера отчетов выглядит следующим образом:

  • https://servername/reportserver

  В режиме SharePoint URL-адрес выглядит следующим образом:

  • https://servername/_vti_bin/reportserver

• Виртуальная структура папок, представленная пользователю в режиме интеграции с SharePoint, может отличаться от базовой. Откройте https://servername/_vti_bin/reportserver или https://servername/sites/site_name/_vti_bin/reportserver в браузере, чтобы увидеть структуру невиртуальных папок. Эта структура полезна для задания исходной папки и целевой папки другим, кроме /сервера в режиме SharePoint.

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

Описание параметра

Дополнительные примеры

Сервер отчетов в собственном режиме для сервера отчетов в собственном режиме

В следующем примере выполняется миграция содержимого с Sourceserver в собственном режиме на Targetserverв собственном режиме.

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://SourceServer/ReportServer -u Domain\User -p password -v ts="https://TargetServer/reportserver" -v tu="Domain\Userser" -v tp="password"  

В следующем примере добавляется параметр безопасности:

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://SourceServer/ReportServer -u Domain\User -p password -v ts="https://TargetServer/reportserver" -v tu="Domain\Userser" -v tp="password" -v security="True"  

Собственный режим в режиме SharePoint — корневой сайт

В следующем примере выполняется миграция содержимого с SourceServer в собственном режиме на "корневой сайт" на сервере TargetServer в режиме интеграции с SharePoint. Папки "Отчеты" и "Источники данных" на сервере в собственном режиме переносятся в развертывание SharePoint как библиотеки.

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://SourceServer/ReportServer -u Domain\User -p Password -v ts="https://TargetServer/_vti_bin/ReportServer" -v tu="Domain\User" -v tp="Password"  

Собственный режим в режиме SharePoint -'bi' семейства веб-сайтов

В следующем примере выполняется миграция содержимого с сервера в собственном режиме на сервер в режиме интеграции с SharePoint, который содержит семейство веб-сайтов, сайтов бизнес-аналитики и библиотеку общих документов. Скрипт создает папки в целевой библиотеке документов. Например, скрипт создает папку "Отчеты" и папку "Источники данных" в целевой библиотеке документов.

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://SourceServer/ReportServer -u Domain\User -p Password -v ts="https://TargetServer/sites/bi/_vti_bin/reportserver" -v tst="sites/bi" -v tf="Shared Documents" -v tu="Domain\User" -v tp="Password"  

Режим SharePoint в режиме SharePoint -'bi' семейства веб-сайтов

В следующем примере выполняется миграция содержимого:

• С сервера SourceServer в режиме интеграции с SharePoint, содержащего семейство веб-сайтов бизнес-аналитики и общую библиотеку документов.

• На TargetServer в режиме интеграции с SharePoint, который содержит семейство веб-сайтов бизнес-аналитики и общую библиотеку документов.

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://SourceServer/_vti_bin/reportserver -v st="sites/bi" -v f="Shared Documents" -u Domain\User1 -p Password -v ts="https://TargetServer/sites/bi/_vti_bin/reportserver" -v tst="sites/bi" -v tf="Shared Documents" -v tu="Domain\User" -v tp="Password"  

Собственный режим в собственном режиме — виртуальная машина Azure

Следующий пример переносит содержимое из сервера отчетов в собственном режиме SourceServer на сервер отчетов TargetServer Native mode, работающий на виртуальной машине Azure. Сервер TargetServer не входит в домен SourceServer, при этом User2 является администратором на виртуальной машине Azure, где работает TargetServer.

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://SourceServer/ReportServer -u Domain\user1 -p Password -v ts="https://ssrsnativeazure.cloudapp.net/ReportServer" -v tu="user2" -v tp="Password2"  

Семейство веб-сайтов SharePoint —'bi' на сервере собственного режима на виртуальной машине Azure.

В следующем примере содержимое переносится с сервера отчетов в режиме SharePoint SourceServer , содержащего семейство веб-сайтов "sites/bi" и общую библиотеку документов, на сервер отчетов TargetServer Native mode, работающий на виртуальной машине Azure. Сервер TargetServer не входит в домен SourceServer, при этом User2 является администратором на виртуальной машине Azure, где работает TargetServer.

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s https://uetesta02/_vti_bin/reportserver -u user1 -p Password -v ts="https://ssrsnativeazure.cloudapp.net/ReportServer" -v tu="user2" -v tp="Passowrd2"  

Проверка

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

Расписания

Проверка расписаний на целевом сервере.

Native Mode

1. Откройте веб-портал на целевом сервере.

2. В верхнем меню выберите Параметры сайта.

3. На левой панели выберите Расписания.

Режим интеграции с SharePoint:

1. Перейдите к Параметры сайта.

2. В группе служб Reporting Services выберите "Управление общими расписаниями".

Роли и группы

Native Mode

1. Откройте SQL Server Management Studio и подключитесь к серверу отчетов в режиме работы в собственной системе команд.

2. В обозреватель объектов выберите "Безопасность".

3. Выберите Роли.

Устранение неполадок

Используйте флаг трассировки -t для получения дополнительных сведений. Например, если при выполнении скрипта появляется сообщение следующего вида:

• Не удалось подключиться к серверу: https://\<servername>/ReportServer/ReportService2010.asmx

Запустите скрипт еще раз с флагом -t, чтобы получить сообщение следующего вида:

• System.Exception: Couldn't connect to server: https://\<servername>/ReportServer/ReportService2010.asmx ---> System.Net.WebException: **The request failed with HTTP status 401: Unauthorized**. at System.Web.Services.Protocols.SoapHttpClientProtocol.ReadResponse(SoapClientMessage message, WebResponse response, Stream responseStream, Boolean asyncCall) at System.Web.Services.Protocols.SoapHttpClientProtocol.Invoke(String methodName, Object[] parameters) at Microsoft.SqlServer.ReportingServices2010.ReportingService2010.IsSSLRequired() at Microsoft.ReportingServices.ScriptHost.Management2010Endpoint.PingService(String url, String userName, String password, String domain, Int32 timeout) at Microsoft.ReportingServices.ScriptHost.ScriptHost.DetermineServerUrlSecurity() --- End of inner exception stack trace ---

Связанный контент

служебная программа RS.exe (SSRS)
Сравнение ролей и задач в Службах Reporting Services с группами и разрешениями SharePoint