Exemple de script Reporting Services rs.exe pour copier du contenu entre des serveurs de rapports

S’applique à : SQL Server Reporting Services (2008 R2 et ultérieur) SharePoint Power BI Report Server

Cet article inclut et décrit un exemple de script RSS Reporting Services qui copie les éléments de contenu et les paramètres d’un serveur de rapports SQL Server Reporting Services vers un autre serveur de rapports au moyen de l’utilitaire RS.exe. RS.exe est installé avec Reporting Services, en mode natif et SharePoint. Le script copie les éléments de Reporting Services, par exemple les rapports et les abonnements, de serveur à serveur. Il prend en charge le mode SharePoint et les serveurs de rapports en mode natif.

Télécharger le script ssrs_migration.rss

Téléchargez le script de migration Reporting Services RS.exe à partir du site GitHub dans un dossier local. Pour plus d’informations, consultez la section Pour utiliser le script dans cet article.

Scénarios pris en charge

Il prend en charge le mode SharePoint et les serveurs de rapports en mode natif. Le script peut être exécuté sur des serveurs de rapports version SQL Server 2008 R2 (10.50.x) ou ultérieure, et Power BI Report Server.

Il peut être utilisé pour copier le contenu entre des serveurs de rapports ayant le même mode ou des modes différents. Par exemple, vous pouvez exécuter le script pour copier du contenu à partir d’un serveur de rapports SQL Server 2008 R2 (10.50.x) en mode natif vers un serveur de rapports SQL Server 2012 SP1 (11.0.3x) en mode SharePoint. Exécutez le script à partir de n'importe quel serveur sur lequel RS.exe est installé. Par exemple, dans le déploiement suivant, vous pouvez :

• Exécuter RS.exe et le script SUR le serveur A.

• Copier le contenu À PARTIR DU serveur B.

• VERS le serveur C.

Pour plus d’informations sur l’utilitaire RS.exe, consultez Utilitaire RS.exe (SSRS).

Éléments et ressources migrés par le script

Le script ne remplace pas les éléments de contenu existants ayant le même nom. Si le script détecte des éléments sur le serveur de destination qui ont le même nom sur le serveur source, chaque élément génère un message d’échec et le script se poursuit. Le tableau suivant répertorie les types de contenu et les ressources que le script peut migrer vers les modes de serveur de rapports cibles.

Autorisations requises

Les autorisations requises pour lire ou écrire des éléments et ressources ne sont pas les mêmes pour toutes les méthodes utilisées dans le script. Le tableau suivant résume les méthodes utilisées pour chaque élément ou ressource et renvoie à une rubrique spécifique. Naviguez vers l’article individuel pour afficher les autorisations requises. Par exemple, l’article qui traite de la méthode ListChildren indique les autorisations requises pour :

• Autorisations requises en mode natif : ReadProperties on Item

• Autorisations requises en mode SharePoint : ViewListItems

Pour plus d’informations, consultez Comparer des rôles et des tâches dans Reporting Services pour des autorisations et des groupes SharePoint.

Utilisation du script

1. Téléchargez le fichier de script dans un dossier local, par exemple c:\rss\ssrs_migration.rss.

2. Ouvrez une invite de commandes avec des privilèges d’administrateur.

3. Accédez au dossier qui contient le fichier ssrs_migration.rss.

4. Exécutez la commande avec les paramètres appropriés pour votre scénario.

Exemple de base, serveur de rapports en mode natif vers serveur de rapports en mode natif :

L’exemple suivant migre le contenu du mode natif Sourceserver au mode natif 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"

Notes d’utilisation :

• Le script s'exécute en deux étapes.

  La première étape est un audit, qui retourne la liste des éléments qui sont migrés, et la deuxième étape est le processus de migration.

  Vous pouvez annuler le script après la première étape si vous voulez uniquement afficher la liste de migration possible ou si vous souhaitez changer les paramètres. Les paramètres dépendants ne sont pas listés dans la première étape. Par exemple, les options de cache d’un rapport ne figurent pas dans la liste, mais le rapport lui-même y figure.

  Conseil

  Si vous voulez uniquement auditer un serveur unique, utilisez le même serveur pour la source et la destination et annulez après l'étape 1.

  Pour utiliser à bon escient les informations d'audit de la première étape, vérifiez les rôles existants sur les serveurs en mode natif source et cible à la fois. L’exemple suivant illustre la liste d’audit de la première étape. Notez que la liste comprend une section « roles », car le commutateur switch-v security="True" a été utilisé :

  • 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 et TARGET_URL doivent être des URL de serveur de rapports valides qui pointent vers les serveurs de rapports Reporting Services source et cible. En mode natif, une URL de serveur de rapports est semblable à cette URL :

  • https://servername/reportserver

  En mode SharePoint, l’URL ressemble l’exemple suivant :

  • https://servername/_vti_bin/reportserver

• La structure de dossiers virtuelle présentée à l'utilisateur dans SharePoint peut être différente que celle sous-jacente. Ouvrez https://servername/_vti_bin/reportserver ou https://servername/sites/site_name/_vti_bin/reportserver dans un navigateur pour afficher la structure de dossiers non virtuelle. Cette structure est utile pour définir le dossier source et le dossier cible à autre chose que /, pour un serveur en mode SharePoint.

• Les mots de passe ne sont pas migrés et doivent être saisis à nouveau. C’est le cas, par exemple, pour les sources de données avec des identifiants stockées.

Description des paramètres

Autres exemples

Serveur de rapports en mode natif vers serveur de rapports en mode natif

L’exemple suivant migre le contenu du mode natif Sourceserver au mode natif 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"  

L'exemple suivant ajoute le commutateur de sécurité :

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"  

Mode natif vers mode SharePoint - site racine

L’exemple suivant migre le contenu d’un Sourceserver en mode natif vers le « site racine » sur un serveur Targetserver en mode SharePoint. Les dossiers « Rapports » et « Sources de données » sur le serveur en mode natif sont migrés comme nouvelles bibliothèques sur le déploiement 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"  

Mode natif vers mode SharePoint - collection de sites « bi »

L'exemple suivant migre le contenu d'un serveur en mode natif vers un serveur SharePoint qui contient une collection de sites « sites/bi » et une bibliothèque de documents partagés. Le script crée des dossiers dans la bibliothèque de destination. Par exemple, le script crée les dossiers « Rapports » et « Sources de données » dans la bibliothèque de documents cible.

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"  

Mode SharePoint vers mode SharePoint - collection de sites « bi »

L'exemple suivant migre le contenu :

• À partir d’un serveur SharePoint SourceServer qui contient une collection de sites « sites/bi » et une bibliothèque de documents partagés.

• Vers un serveur SharePoint TargetServer qui contient une collection de sites « sites/bi » et une bibliothèque de documents partagés.

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"  

Mode natif vers mode natif - Machine virtuelle Azure

L’exemple suivant migre le contenu d’un serveur de rapports en mode natif SourceServer vers un serveur de rapports en mode natif TargetServer s’exécutant sur une machine virtuelle Azure. TargetServer n’est pas joint au domaine de SourceServer et User2 est un administrateur de TargetServer sur la machine virtuelle Azure.

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"  

Mode SharePoint - Collection de sites « bi » vers un serveur en mode natif sur une machine virtuelle Azure.

L’exemple suivant migre le contenu d’un serveur de rapports en mode SharePoint SourceServer qui contient une collection de sites « sites/bi » et une bibliothèque de documents partagés vers un serveur de rapports en mode natif TargetServer fonctionnant sur une machine virtuelle Azure. TargetServer n’est pas joint au domaine de SourceServer et User2 est un administrateur de TargetServer sur la machine virtuelle Azure.

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"  

Vérification

La section résume les étapes à effectuer sur le serveur de destination pour vérifier si le contenu et les stratégies ont été correctement migrés.

Planifications

Pour vérifier les planifications sur le serveur cible :

Native Mode

1. Ouvrez le portail web sur le serveur de destination.

2. Dans le menu supérieur, sélectionnez Paramètres du site .

3. Dans le volet gauche, sélectionnez Planifications .

Mode SharePoint :

1. Accédez à Paramètres du site.

2. Dans le groupe Reporting Services, sélectionnez Gérer les planifications partagées.

Rôles et groupes

Native Mode

1. Ouvrez SQL Server Management Studio et connectez-vous à votre serveur de rapports en mode natif.

2. Dans l’Explorateur d’objets, sélectionnez Sécurité.

3. Sélectionnez Rôles.

Dépannage

Utilisez l’indicateur de trace -t pour recevoir plus d’informations. Par exemple, si vous exécutez le script et voyez un message similaire au suivant

• Couldn’t connect to server: https://\<servername>/ReportServer/ReportService2010.asmx

Réexécutez le script avec l’indicateur -t pour voir un message de ce type :

• 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 ---

Contenu connexe

Utilitaire RS.exe (SSRS)
Comparer des rôles et des tâches dans Reporting Services pour des autorisations et des groupes SharePoint