Reporting Services の構成ファイルを変更する方法
Reporting Services では、一連の構成ファイルにアプリケーション設定を格納します。構成ファイルはセットアップ時に作成され、インストールしたレポート サーバー インスタンスごとに存在します。各ファイル内の値は、インストール中に設定されるか、ツールやアプリケーションを使用してサーバーの動作を構成したときに設定されます。場合によっては、高度な設定を追加したり構成したりするために、ファイルを直接変更する必要があります。構成設定は、XML 要素または XML 属性のいずれかとして指定されます。XML ファイルおよび構成ファイルを理解している場合は、テキスト エディタまたはコード エディタを使用して、ユーザーが定義可能な設定を変更できます。
一部の構成設定は、ツールを使ってのみ設定できます。暗号化された値を含んだ設定は、Reporting Services 構成ツール、セットアップ プログラム、または rsconfig コマンド ライン ユーティリティで変更する必要があります。これらのツールを実行するには、ローカルの Administrators グループのメンバである必要があります。
.gif "重要な注意事項") 重要 |
|---|
構成ファイルを変更する場合は注意が必要です。内部で使用するために予約されている設定を変更すると、インストールが無効になることがあります。一般的に、特定の問題を解決しようとしている場合を除いて、構成設定を変更することはお勧めしません。変更できる設定の詳細については、「RSReportServer 構成ファイル」または「RSReportDesigner 構成ファイル」を参照してください。構成ファイルの詳細については、Microsoft.NET Framework の製品ドキュメントを参照してください。 |
構成値の読み取りと使用
レポート サーバーが構成ファイルを読み取るタイミングは、サービスが開始されたときと、構成ファイルが保存されたときです。新しい値や変更された値は、現在のアプリケーション ドメインの有効期間が切れた後、新しいアプリケーション ドメインで有効になります。現在のアプリケーション ドメインで処理中の要求は、できる限り最後まで完了するように配慮されます。ただし、いくつかの設定については、アプリケーション ドメインのリサイクルが直ちに必要となります。この場合、処理中の要求はすべて、新しいアプリケーション ドメインで再開されます。
無効な値が検出された場合、レポート サーバーによって Windows アプリケーション ログにエラーが記録され、エラーの内容に応じてレポート サーバーの起動が失敗するか、または既定値が使用されます。
エラーの内容が不適切な形式の XML である場合は、レポート サーバーが起動されません。レポート サーバーの実行中にエラーが発生した場合、レポート サーバーが再起動されるまで、またはアプリケーション ドメインのリサイクルが発生するまで、レポート サーバーは無効な構成ファイルを無視します。エラーが検出されると、レポート サーバーは起動されなくなります。
エラーの内容が無効な構成値である場合、内部の既定値が使用され、エラーがトレース ログ ファイルに記録されます。サーバーの動作にきわめて重要な意味を持つ構成設定が無効であった場合で、かつ、内部の既定値が使用できないごく限られた状況では、サーバーから rsServerConfigurationError エラーが返されます。設定が欠落している場合や、きわめて重要な設定が無効であった場合、クライアント アプリケーションには、それに関するエラーが HTML 形式のエラー ページとして返され、イベント ログに記録されます。
正常な変更も含め、構成ファイルに対するすべての変更は、レポート サーバーのトレース ログ ファイルに記録されます。アプリケーション イベント ログには、エラーだけが記録されます。
既定値について
ほとんどの構成設定には、レポート サーバー内部で指定される既定値があります。ユーザー定義の値が無効であったり、指定されていなかった場合は、既定値が使用されます。構成設定が無効であるため既定値を使用した場合は、トレース ログ ファイルにエラーが書き込まれます。
構成設定の削除
既定値がある構成設定の場合は、構成ファイルから設定を削除しても影響はありません。ほとんどの構成設定は、実際には内部的に定義および構成されます。構成ファイルから項目を削除しても、内部コピーは引き続き使用でき、その項目に対して定義されている既定値が使用されます。
Reporting Services の構成ファイルを編集するには
編集する構成ファイルを探します。
RSReportServer.config は、\Program Files\Microsoft SQL Server\MSSQL.n\Reporting Services\ReportServer フォルダに格納されています。
RSReportServerServices.exe.config は、\Reporting Services\Report Server\Bin フォルダに格納されています。
RSReportDesigner.config は、\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies フォルダに格納されています。
変更をロールバックする必要がある場合は、ファイルのコピーを保存します。
元のファイルをメモ帳またはコード エディタで開きます。Textpad は使用しないでください。ファイルの保存前にファイルの長さが設定されるため、無効な文字を示すエラーがトレース ログ ファイルに書き込まれます。
追加または使用する要素 (または値) を入力します。要素では大文字と小文字が区別されます。要素を追加する場合は、大文字と小文字を正しく区別して入力してください。表示拡張機能、認証拡張機能、またはデータ処理拡張機能をカスタマイズしている場合は、対応する構成ファイルの編集方法を説明したトピックが用意されています。
このファイルを保存します。
トレース ログ ファイルを見て、エラーが発生していないことを確認します。エラー状態が記録されていた場合は、設定またはその値が正しく指定されていません。「RSReportServer 構成ファイル」を参照し、エラーの原因となっている設定について有効な値を確認してください。トレース ログの確認方法の詳細については、「レポート サーバー サービスのトレース ログ」を参照してください。