Ändern einer Reporting Services-Konfigurationsdatei (RSreportserver.config)

  • Artikel

Reporting Services werden Anwendungseinstellungen in einem Satz von Konfigurationsdateien gespeichert. Beim Setup werden die Konfigurationsdateien für jede Berichtsserverinstanz erstellt, die Sie installieren. In jeder Datei werden Werte entweder während der Installation festgelegt oder aber wenn Sie Tools und Anwendungen zum Konfigurieren eines Servers für einen Vorgang verwenden. In einigen Fällen müssen Sie eine Datei direkt ändern, um erweiterte Einstellungen hinzuzufügen oder zu konfigurieren. Konfigurationseinstellungen werden als XML-Elemente oder -Attribute angegeben. Wenn Sie sich mit XML und Konfigurationsdateien auskennen, können Sie mit einem Text- oder Code-Editor benutzerdefinierbare Einstellungen ändern.

Einige Konfigurationseinstellungen können nur mithilfe eines Tools festgelegt werden. Einstellungen, die verschlüsselte Werte enthalten, müssen mit dem Reporting Services-Konfigurationstool, dem Setupprogramm oder dem Befehlszeilen-Hilfsprogramm rsconfig geändert werden. Zum Ausführen dieser Tools müssen Sie ein Mitglied der lokalen Administratorengruppe sein.

Wichtig

Gehen Sie beim Ändern der Konfigurationsdateien vorsichtig vor. Wenn Sie eine Einstellung ändern, die für die interne Verwendung reserviert ist, wird möglicherweise die Installation deaktiviert. Im Allgemeinen sollten Sie Konfigurationseinstellungen nur ändern, wenn ein bestimmtes Problem behoben werden muss. Weitere Informationen darüber, welche Einstellungen problemlos geändert werden können, finden Sie unter RSReportServer.config-Konfigurationsdatei oder RSReportDesigner-Konfigurationsdatei. Weitere Informationen zu Konfigurationsdateien finden Sie in der Produktdokumentation zu Microsoft.NET Framework.

In diesem Artikel:

Lesen und Verwenden von Konfigurationswerten

Ein Berichtsserver liest die Konfigurationsdateien beim Starten des Diensts und bei jedem Speichern der Konfigurationsdatei. Neue und überarbeitete Werte werden in einer neuen Anwendungsdomäne wirksam, nachdem die aktuelle Anwendungsdomäne abgelaufen ist. Wenn möglich werden Anforderungen, die in der aktuellen Anwendungsdomäne noch verarbeitet werden, noch abgeschlossen. Einige Einstellungen erfordern jedoch einen unmittelbaren Wiederverwendungsvorgang der Anwendungsdomäne. In diesem Fall werden alle Anforderungen, die gerade verarbeitet werden, in einer neuen Anwendungsdomäne neu gestartet.

Wenn der Berichtsserver einen ungültigen Wert entdeckt, schreibt er einen Fehler in das Windows-Anwendungsprotokoll und startet dann nicht oder verwendet den Standardwert, abhängig vom Fehler.

  • Wenn der Fehler wegen fehlerhafter XML auftritt, wird der Berichtsserver nicht gestartet. Wird der Berichtsserver ausgeführt, während Sie den Fehler einführen, ignoriert der Berichtsserver die ungültige Konfigurationsdatei. Er ignoriert die Datei, bis der Berichtsserver neu gestartet wird oder die Anwendungsdomäne wiederverwendet wird. Nach Erkennung des Fehlers wird der Berichtsserver nicht mehr gestartet.

  • Wenn der Fehler wegen eines fehlerhaften Konfigurationswerts auftritt, verwendet der Server interne Standardwerte und schreibt einen Fehler in das Ablaufverfolgungsprotokoll. In den wenigen Fällen, in denen interne Standardwerte nicht verfügbar sind, gibt der Server den Fehler rsServerConfigurationError zurück, wenn die ungültige Konfigurationseinstellung kritisch für Servervorgänge ist. Fehler zu fehlenden oder ungültigen kritischen Einstellungen werden an die Clientanwendung in Form einer HTML-Fehlerseite zurückgegeben und in das Ereignisprotokoll geschrieben.

Alle Konfigurationsdateiänderungen werden einschließlich erfolgreicher Änderungen im Ablaufverfolgungsprotokoll des Berichtsservers aufgezeichnet. Nur Fehler werden im Ereignisprotokolldatei der Anwendung protokolliert.

Informationen zu Standardwerten

Die meisten Konfigurationseinstellungen haben Standardwerte, die intern im Berichtsserver festgelegt sind. Der Berichtsserver verwendet diese Werte, wenn ein benutzerdefinierter Wert ungültig oder nicht angegeben ist. Wenn ein Standardwert wegen einer fehlerhaften Konfigurationseinstellung verwendet werden muss, wird ein Fehler in das Ablaufverfolgungsprotokoll geschrieben.

Löschen von Konfigurationseinstellungen

Bei Konfigurationseinstellungen, die Standardwerte aufweisen, hat die Löschung der Einstellung aus der Konfigurationsdatei keinerlei Auswirkungen. Die meisten Konfigurationseinstellungen werden intern definiert und konfiguriert. Wenn Sie ein Element aus der Konfigurationsdatei löschen, ist die interne Kopie nach wie vor vorhanden, und es wird der dafür definierte Standardwert verwendet.

Bearbeiten einer Reporting Services-Konfigurationsdatei

  1. Suchen Sie die Konfigurationsdatei, die Sie bearbeiten möchten:

    • RSReportServer.config befindet sich im folgenden Ordner:

      C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer

      Gilt für: Technische Vorschauversion von Power BI-Berichten in SQL Server Reporting Services, Januar 2017

      C:\Program Files\Microsoft SQL Server Reporting Services\RSServer\ReportServer

    • RSReportServerServices.exe.config befindet sich im folgenden Ordner:

      Hinweis

      Dies steht in der Technical Preview von Berichten von Power BI in SQL Server Reporting Services von Januar 2017 nicht zur Verfügung.

      C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer\bin

    • RSReportDesigner.config befindet sich im folgenden Ordner:

      C:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE\PrivateAssemblies

  2. Speichern Sie eine Kopie der Datei, falls Sie einen Rollback für die Änderungen ausführen müssen.

  3. Öffnen Sie die ursprüngliche Datei im Editor oder einem Code-Editor. Verwenden Sie nicht Textpad. Dadurch würde die Dateilänge vor dem Speichern der Datei festgelegt und ein Fehler wegen ungültiger Zeichen in das Ablaufverfolgungsprotokoll geschrieben.

  4. Geben Sie das Element oder den Wert ein, das bzw. den Sie hinzufügen oder verwenden möchten. Bei Elementen wird zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie ein Element hinzufügen, stellen Sie sicher, die richtigen Groß- und Kleinbuchstaben zu verwenden. Spezifische Anweisungen zum Bearbeiten von Konfigurationsdateien sind verfügbar, wenn Sie Renderingerweiterungen, Authentifizierungserweiterungen oder Datenverarbeitungserweiterungen anpassen:

  5. Speichern Sie die Datei .

  6. Überprüfen Sie in den Ablaufprotokolldateien, ob keine Fehler aufgetreten sind. Wenn Fehlerbedingungen auftreten, wurde eine Einstellung oder ihr Wert falsch angegeben. Gültige Werte für die Einstellungen, die Fehler verursachen, finden Sie unter RSReportServer.config-Konfigurationsdatei. Weitere Informationen zum Anzeigen von Ablaufprotokollen finden Sie unter Berichtsserverdienst-Ablaufprotokoll.

Zugehöriger Inhalt