Procédure : modifier un fichier de configuration Reporting Services
Reporting Services stocke les paramètres des applications dans un jeu de fichiers de configuration. Le programme d'installation crée les fichiers de configuration de chaque instance du serveur de rapports que vous installez. Dans chaque fichier, les valeurs sont définies soit pendant l'installation, soit lorsque vous utilisez des outils et des applications pour configurer un serveur. Dans certains cas, vous devez modifier directement un fichier pour ajouter ou configurer des paramètres avancés. Les paramètres de configuration sont spécifiés soit comme des éléments, soit comme des attributs XML. Si le langage XML et les fichiers de configuration vous sont familiers, vous pouvez modifier les paramètres définissables par l'utilisateur dans un éditeur de texte ou de code.
Certains paramètres de configuration peuvent être définis uniquement à l'aide d'un outil. Les paramètres qui contiennent des valeurs chiffrées doivent être modifiés à l'aide de l'outil de configuration de Reporting Services, du programme d'installation ou de l'utilitaire de ligne de commande rsconfig. Vous devez être membre du groupe Administrateurs local pour exécuter ces outils.
Important
Soyez prudent lorsque vous modifiez les fichiers de configuration. Si vous modifiez un paramètre réservé à un usage interne, vous risquez de désactiver votre installation. En règle générale, il est déconseillé de modifier les paramètres de configuration, sauf pour essayer de résoudre un problème spécifique. Pour plus d'informations sur les paramètres pouvant être modifiés en toute sécurité, consultez Fichier de configuration RSReportServer ou Fichier de configuration RSReportDesigner. Pour plus d'informations sur les fichiers de configuration, consultez la documentation du produit Microsoft .NET Framework.
Lecture et utilisation des valeurs de configuration
Un serveur de rapports lit les fichiers de configuration lorsque le service démarre et chaque fois que le fichier de configuration est enregistré. Les valeurs nouvelles et modifiées prennent effet dans un nouveau domaine d'application après l'expiration du domaine d'application actuel. Chaque fois que possible, les requêtes en cours de traitement dans le domaine d'application actuel sont autorisées à se terminer. Toutefois, quelques paramètres requièrent une opération immédiate de recyclage du domaine d'application. Dans ce cas, toutes les requêtes en cours de traitement sont redémarrées dans un nouveau domaine d'application.
Si le serveur de rapports détecte une valeur non valide, il enregistre une erreur dans le journal des applications Windows et, selon la nature de l'erreur, ne démarre pas ou démarre en utilisant une valeur par défaut.
Si l'erreur est due à un code XML incorrect, le serveur de rapports ne démarre pas. Si ce serveur de rapports s'exécute tandis que vous déclenchez une erreur, il ignore le fichier de configuration incorrect tant qu'il n'est pas redémarré ou que le domaine d'application n'est pas recyclé. Dès que l'erreur est détectée, le serveur de rapports ne démarre plus.
Si l'erreur est liée à une valeur de configuration non valide, le serveur utilise les valeurs internes par défaut et enregistre une erreur dans les fichiers journaux des traces. Dans les rares cas où les valeurs internes par défaut ne sont pas disponibles, le serveur retourne l'erreur rsServerConfigurationError si le paramètre de configuration non valide est indispensable au fonctionnement du serveur. Les erreurs relatives à des paramètres critiques manquants ou non valides sont retournées à l'application cliente dans une page d'erreurs HTML et sont enregistrées dans le journal des événements.
Toutes les modifications des fichiers de configuration, qu'elles soient réussies ou non, sont enregistrées dans le fichier journal des traces du serveur de rapports. Seules les erreurs sont enregistrées dans le journal d'événements d'applications.
À propos des valeurs par défaut
La plupart des paramètres de configuration ont des valeurs par défaut qui sont spécifiées de manière interne sur le serveur de rapports. Le serveur de rapports utilise ces valeurs si une valeur définie par l'utilisateur n'est pas valide ou si elle n'est pas spécifiée. Si une valeur par défaut doit être utilisée en raison d'un paramètre de configuration non valide, une erreur est écrite dans le fichier journal des traces.
Suppression de paramètres de configuration
Pour les paramètres de configuration qui ont des valeurs par défaut, la suppression du paramètre du fichier de configuration n'a aucun effet. La plupart des paramètres de configuration sont en fait définis et configurés en interne. Si vous supprimez un élément du fichier de configuration, la copie interne reste disponible et utilise la valeur par défaut définie pour cet élément.
Pour modifier un fichier de configuration Reporting Services
Recherchez le fichier de configuration à modifier :
RSReportServer.config est situé dans le dossier \Program Files\Microsoft SQL Server\MSSQL.n\Reporting Services\ReportServer.
RSReportServerServices.exe.config est situé dans le dossier \Reporting Services\Report Server\Bin.
RSReportDesigner.config est situé dans le dossier \Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies.
Enregistrez une copie du fichier pour pouvoir restaurer vos modifications le cas échéant.
Ouvrez le fichier d'origine dans le Bloc-notes ou un éditeur de code. N'utilisez pas Textpad ; il définit la longueur du fichier avant que ce dernier ne soit enregistré, ce qui entraîne l'écriture d'une erreur de type caractère non valide dans le fichier journal des traces.
Tapez l'élément ou la valeur à ajouter ou à utiliser. Les éléments respectent la casse. Si vous ajoutez un élément, veillez à utiliser les majuscules et minuscules appropriées. Des instructions spécifiques relatives à la modification des fichiers de configuration sont disponibles si vous personnalisez des extensions de rendu, des extensions d'authentification ou des extensions pour le traitement des données :
Enregistrez le fichier.
Consultez les fichiers journaux des traces pour vous assurer qu'aucune erreur ne s'est produite. Si vous trouvez une erreur, cela signifie qu'un paramètre ou sa valeur ont été spécifiés de manière incorrecte. Examinez le Fichier de configuration RSReportServer pour connaître les valeurs valides du paramètre à l'origine de l'erreur. Pour plus d'informations sur l'affichage du journal des traces, consultez Journal des traces du service Report Server.
Voir aussi