Exemple de script Reporting Services rs.exe pour migrer le contenu entre des serveurs de rapports

  • Article

Cette rubrique inclut et décrit un exemple Reporting Services script RSS qui copie des éléments de contenu et des paramètres d’un serveur de rapports SQL Server Reporting Services vers un autre serveur de rapports, à l’aide 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.
S’applique à : Reporting Services en mode natif | Reporting Services en mode SharePoint

Dans cette rubrique :

Pour télécharger le script ssrs_migration.rss

Téléchargez le script à partir du site CodePlex Reporting Services RS.exe script migrates content dans un dossier local. Pour plus d’informations, consultez la section Pour utiliser le script dans cette rubrique.

Scénarios pris en charge

Il prend en charge le mode SharePoint et les serveurs de rapports en mode natif. Le script prend en charge les versions de serveur de rapports suivantes :

  • SQL Server 2014

  • SQL Server 2012

  • SQL Server 2008 R2

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 le contenu d’un serveur de rapports en mode natif SQL Server 2008 R2 vers un serveur de rapports SQL Server 2012 SP1 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.

Nom du serveur Mode du serveur de rapports
Serveur A Natif
serveur B. SharePoint
le serveur C. SharePoint

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 remplacera 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.

Élément Migré SharePoint Description
Mots de passe Non Non Les mots de passe NE sont PAS migrés. Une fois que les éléments de contenu sont migrés, mettez à jour les informations d'identification sur le serveur de destination. Par exemple, les sources de données avec les informations d'identification stockées.
Mes rapports Non Non La fonctionnalité « Mes rapports » du mode natif utilise les connexions utilisateur individuelles. Par conséquent, le service de script n’a pas accès au contenu des dossiers « Mes rapports » pour les utilisateurs, sauf pour le paramètre –u utilisé pour exécuter le script rss. En outre, « Mes rapports » n’est pas une fonctionnalité de Reporting Services mode SharePoint et les éléments des dossiers ne peuvent pas être copiés dans un environnement SharePoint. Par conséquent, le script ne copie pas les éléments de rapport qui se trouvent dans les dossiers « Mes rapports » sur un serveur de rapports en mode natif source. Pour migrer le contenu dans les dossiers « Mes rapports » avec ce script, procédez comme suit :

1) Créez un ou plusieurs dossiers dans le Gestionnaire de rapports. Éventuellement, créez des dossiers ou des sous-dossier pour chaque utilisateur.

2) Connectez-vous en tant qu’utilisateur avec le contenu « Mes rapports ».

3) Dans le Gestionnaire de rapports, cliquez sur le dossier Mes rapports .

4) Cliquez sur la vue Détails du dossier.

5) Sélectionnez chaque rapport que vous souhaitez copier.

6) Cliquez sur Déplacer dans la barre d’outils du Gestionnaire de rapports.

7) Sélectionnez le dossier de destination souhaité.

8) Répétez les étapes 2 à 7 pour chaque utilisateur.

9) Exécutez le script.
Historique Non Non
Paramètres d'historique Oui Oui Les paramètres d'historique sont migrés, cependant les informations d'historique NE SONT PAS migrées.
Planifications Oui Oui Pour migrer des planifications, il est nécessaire que SQL Server Agent soit en cours de exécution sur le serveur cible. Si SQL Server Agent n'est pas exécuté sur la cible, un message d'erreur semblable au suivant s'affiche :

Migrating schedules: 1 items found. Migrating schedule: theMondaySchedule ... FAILURE: The SQL Agent service is not running. This operation requires the SQL Agent service. ---> Microsoft.ReportingServices.Diagnostics.Utilities.SchedulerNotResponding Exception: The SQL Agent service is not running. This operation requires the SQL Agent service.
Rôles et stratégies système Oui Oui Par défaut, le script ne copie pas de schéma d'autorisation personnalisé entre les serveurs. Le comportement par défaut est que les éléments sont codés sur le serveur de destination avec l’indicateur « hériter des autorisations parentes » défini sur TRUE. Si vous voulez générer un script pour copier les autorisations pour chaque élément, utilisez le commutateur SECURITY.

Si les serveurs source et cible n’ont pas le même mode de serveur de rapports, par exemple si le serveur source est en mode natif et le serveur cible est en mode SharePoint, et si vous utilisez le commutateur SECURITY, le script tente de mapper les rôles et les groupes par défaut en effectuant une comparaison comme décrit dans la rubrique Comparer des rôles et des tâches dans Reporting Services avec les autorisations et les groupes SharePoint. Les rôles et les groupes personnalisés ne sont pas copiés sur le serveur de destination.

Quand le script copie entre des serveurs qui ont le même mode, et si vous utilisez le commutateur SECURITY, le script crée des rôles (mode natif) ou des groupes (mode SharePoint) sur le serveur de destination.

Si un rôle existe déjà sur le serveur de destination, le script crée un message d’échec similaire au suivant et poursuit la migration des autres éléments. Une fois le script terminé, vérifiez que les rôles sur le serveur de destination sont configurés conformément à vos besoins. Rôles de migration : 8 éléments trouvés.

Migrating role: Browser ... FAILURE: The role 'Browser' already exists and cannot be created. ---> Microsoft.ReportingServices.Diagnostics.Utilities.RoleAlreadyExistsException: The role 'Browser' already exists and cannot be created.

Pour plus d’informations, consultez Accorder à l’utilisateur l’accès à un serveur de rapports (Gestionnaire de rapports).

Remarque : Si un utilisateur qui existe sur le serveur source n’existe pas sur le serveur de destination, le script ne peut pas appliquer les attributions de rôles sur le serveur de destination, même si le commutateur SECURITY est utilisé.
Source de données partagée Oui Oui Le script ne remplace pas les éléments existants sur le serveur cible. Si un élément sur le serveur cible portant le même nom existe déjà, vous verrez un message d'erreur similaire à suivant :

Migrating DataSource: /Data Sources/Aworks2012_oltp ... FAILURE:The item '/Data Sources/Aworks2012_oltp' already exists. ---> Microsoft.ReportingServices.Diagnostics.Utilities.ItemAlreadyExistsException: The item '/Data Source s/Aworks2012_oltp' already exists.

Les informations d’identification NE sont PAS copiées dans le cadre de la source de données. Une fois que les éléments de contenu sont migrés, mettez à jour les informations d'identification sur le serveur de destination.
Dataset partagé Oui Oui
Dossier Oui Oui Le script ne remplace pas les éléments existants sur le serveur cible. Si un élément sur le serveur cible portant le même nom existe déjà, vous verrez un message d'erreur similaire à suivant :

Migrating Folder: /Reports ... FAILURE: The item '/Reports' already exists. ---> Microsoft.ReportingServices.Diagnostics.Utilities.ItemAlreadyExistsException: The item '/Reports' already exists.
Rapport Oui Oui Le script ne remplace pas les éléments existants sur le serveur cible. Si un élément sur le serveur cible portant le même nom existe déjà, vous verrez un message d'erreur similaire à suivant :

Migrating Report: /Reports/testThe item '/Reports/test' already exists. ---> Microsoft.ReportingServices.Diagnostics.Utilities.ItemAlreadyExistsException: The item '/Reports/test' already exists.
Paramètres Oui Oui
Abonnements Oui Oui
Paramètres d'historique Oui Oui Les paramètres d'historique sont migrés, cependant les informations d'historique NE SONT PAS migrées.
options de traitement Oui Oui
options d'actualisation du cache Oui Oui Les paramètres dépendants sont migrés en tant qu'éléments du catalogue. Ce qui suit est un exemple hors du script car il migre un rapport (.rdl) et les paramètres liés tels que les options d'actualisation du cache :

Migrating parameters for report TitleOnly.rdl 0 items found.

Migrating subscriptions for report TitleOnly.rdl: 1 items found.

Migration de l’abonnement Enregistrer dans \\server\public\savedreports en tant que TitleOnly ... SUCCÈS

Migration des paramètres d’historique pour le rapport TitleOnly.rdl ... SUCCÈS

Migration des options de traitement pour le rapport TitleOnly.rdl ... 0 éléments trouvés.

Migration des options d’actualisation du cache pour le rapport TitleOnly.rdl ... SUCCÈS

Migrating cache refresh plans for report TitleOnly.rdl: 1 items found.

Migration du plan d’actualisation du cache titleonly_refresh735amM2F ... SUCCÈS
Plans d’actualisation du cache Oui Oui
Images Oui Oui
Parties de rapports Oui Oui

Autorisations requises

Les autorisations requises pour les éléments et les ressources de lecture ou d'écriture 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. Accédez à chaque rubrique pour voir les autorisations requises. Par exemple, la rubrique 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

Élément ou ressource Source Cible
Éléments du catalogue ListChildren

GetProperties

GetItemDataSources

GetItemReferences

GetDataSourceContents

GetItemLink		 CreateCatalogItem

SetItemDataSources

GetItemReferences

CreateDataSource

CreateLinkedItem

CreateFolder
Role ListRoles

GetRoleProperties		 CreateRole
Stratégie système GetSystemPolicies SetSystemPolicies
Planifier ListSchedules CreateSchedule
Abonnement ListSubscriptions

GetSubscriptionProperties

GetDataDrivenSubscriptionProperties		 CreateSubscription

CreateDataDrivenSubscription
Plan d'actualisation du cache ListCacheRefreshPlans

GetCacheRefreshPlanProperties		 CreateCacheRefreshPlan
Paramètres GetItemParameters SetItemParameters
Options d'exécution GetExecutionOptions SetExecutionOptions
Options de cache GetCacheOptions SetCacheOptions
Paramètres d'historique GetItemHistoryOptions SetItemHistoryOptions
Stratégie d'élément GetPolicies SetPolicies

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 http://SourceServer/ReportServer -u Domain\User -p password -v ts="http://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 seront 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 répertoriés lors de 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, 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. Ce qui suit est un exemple de 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 similaire à ce qui suit :

    • https://servername/reportserver

    En mode SharePoint l'URL est similaire à ce qui suit :

    • 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. Cela est utile pour définir le dossier source et le dossier cible autrement qu'avec « / », pour un serveur en mode SharePoint.

  • Les mots de passe ne sont pas migrés, et doivent être entrés de nouveau, par exemple via des sources de données avec des informations d'identification stockées.

Description du paramètre

Paramètre Description Obligatoire
-s Source_URL URL du serveur de rapports source Oui
-u Domain\password -p password Informations d'identification pour le serveur source. FACULTATIF, les informations d'identification par défaut sont utilisées si manquantes
-v st="SITE" FACULTATIF. Ce paramètre n'est utilisé que pour les serveurs de rapports en mode SharePoint.
- v f="SOURCEFOLDER" Défini sur « / » pour tout migrer, ou bien sur « /dossier/sous-dossier » pour une migration. Tout le contenu du dossier sera copié FACULTATIF, la valeur par défaut est « / ».
-v ts="TARGET_URL" 'URL of the target RS server"
-v tu="domain\username" -v tp="password" Informations d'identification du serveur cible. FACULTATIF, les informations d'identification par défaut sont utilisées si manquantes. Remarque : l’utilisateur est listé comme « créateur » des planifications partagées et « modifié par » représente les éléments de rapport, sur le serveur cible.
-v tst="SITE" FACULTATIF. Ce paramètre n'est utilisé que pour les serveurs de rapports en mode SharePoint.
-v tf ="TARGETFOLDER" Défini sur « / » pour migrer vers le niveau racine. Défini sur « /dossier/sous-dossier » pour copier dans un répertoire existant. Tout le contenu de « SOURCEFOLDER » sera copié dans « TARGETFOLDER. FACULTATIF, la valeur par défaut est « / ».
-v security= "True/False" Si la valeur est « False », les éléments du catalogue de destination héritent du paramètre de sécurité en fonction des paramètres du système cible. Il s'agit du paramètre recommandé pour les migrations entre des types de serveur de rapports différents, par exemple mode natif vers mode SharePoint. Si la valeur est « True », le script tente de migrer les paramètres de sécurité. FACULTATIF, la valeur par défaut est « False ».

Plus d'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 http://SourceServer/ReportServer -u Domain\User -p password -v ts="http://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 http://SourceServer/ReportServer -u Domain\User -p password -v ts="http://TargetServer/reportserver" -v tu="Domain\Userser" -v tp="password" -v security="True"

Mode natif en 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.

ssrs_rss_migrate_root_site

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

Mode natif en mode SharePoint -'bi' collection de sites

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 http://SourceServer/ReportServer -u Domain\User -p Password -v ts="http://TargetServer/sites/bi/_vti_bin/reportserver" -v tst="sites/bi" -v tf="Shared Documents" -v tu="Domain\User" -v tp="Password"

SharePoint Mode to SharePoint Mode -'bi' collection de sites

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 http://SourceServer/_vti_bin/reportserver -v st="sites/bi" -v f="Shared Documents" -u Domain\User1 -p Password -v ts="http://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 :

  • À partir d’un serveur de rapports en mode natif SourceServer.

  • Vers un serveur de rapports en mode natif TargetServer sur une machine virtuelle Azure. Le Serveur cible n’est pas joint au domaine du serveur source et l’utilisateur2 est un administrateur sur la machine virtuelle Azure TargetServer.

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

Conseil

Pour plus d’informations sur l’utilisation de Windows PowerShell pour créer des serveurs de rapports Reporting Services sur des machines virtuelles Azure, consultez Utiliser PowerShell pour créer une machine virtuelle Azure avec un serveur de rapports en mode natif.

Mode SharePoint -'bi' collection de sites sur un serveur en mode natif sur une machine virtuelle Azure

L'exemple suivant migre le contenu :

  • À partir 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 sur une machine virtuelle Azure. Le Serveur cible n’est pas joint au domaine du serveur source et l’utilisateur2 est un administrateur sur la machine virtuelle Azure TargetServer.

rs.exe -i ssrs_migration.rss -e Mgmt2010 -s http://uetesta02/_vti_bin/reportserver -u user1 -p Password -v ts="http://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. Accédez au Gestionnaire de rapports sur le serveur de destination.

  2. Dans le menu supérieur, cliquez sur Paramètres du site .

  3. Dans le volet gauche, cliquez sur Planifications .

Mode SharePoint :

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

  2. Dans le groupe Reporting Services , cliquez sur 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 , cliquez sur Sécurité.

  3. Cliquez sur 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

  • Impossible de se connecter au serveur : http://< servername>/ReportServer/ReportService2010.asmx

Réexécutez le script avec l’indicateur -t pour afficher un message semblable au suivant :

  • System.Exception : Impossible de se connecter au serveur : http:// servername>/ReportServer/ReportService2010.asmx ---> System.Net.WebException : La demande a échoué avec HTTP status 401 : Non autorisé.< à System.Web.Services.Protocols.SoapHttpClientProtocol.ReadResponse (SoapClientMessage message, WebResponse response, Stream responseStream, Boolean asyncCall) à System.Web.Services.Protocols.SoapHttpClientProtocol.Invoke (String methodName, Object [] parameters) à Microsoft.SqlServer.reportingservices2010.reportingservice2010.issslrequired () à Microsoft.ReportingServices.ScriptHost.Management2010Endpoint.PingService (String url, String userName, String password String domain, Int32 timeout) à Microsoft.ReportingServices.scripthost.scripthost.determineserverurlsecurity ()---fin de la trace de pile d’exception interne---

Voir aussi

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