Reporting Services 구성 파일 수정(RSreportserver.config)Modify a Reporting Services Configuration File (RSreportserver.config)

Reporting ServicesReporting Services는 응용 프로그램 설정을 구성 파일 집합에 저장합니다. stores application settings in a set of configuration files. 설치 프로그램은 사용자가 설치하는 각 보고서 서버 인스턴스에 대한 구성 파일을 만듭니다.Setup creates the configuration files for each report server instance you install. 각 파일 내에서 값은 설치 중 설정되거나 도구 및 응용 프로그램을 사용하여 작업을 위해 서버를 구성할 때 설정됩니다.Within each file, values are either set during installation or when you use tools and applications to configure a server for operation. 경우에 따라 파일을 직접 수정하여 고급 설정을 추가하거나 구성해야 합니다.In some cases, you must modify a file directly to add or configure advanced settings. 구성 설정은 XML 요소나 특성으로 지정됩니다.Configuration settings are specified as either XML elements or attributes. XML과 구성 파일에 대해 이해하고 있으면 텍스트나 코드 편집기를 사용하여 사용자 정의 가능한 설정을 수정할 수 있습니다.If you understand XML and configuration files, you can use a text or code editor to modify user-definable settings.

일부 구성 설정은 도구를 통해서만 설정할 수 있습니다.Some configuration settings can be set only through a tool. 암호화된 값이 포함된 설정은 Reporting Services 구성 도구, 설치 프로그램 또는 rsconfig 명령줄 유틸리티를 통해 수정해야 합니다.Settings that contain encrypted values must be modified through the Reporting Services Configuration tool, the Setup program, or the rsconfig command line utility. 이러한 도구를 실행하려면 로컬 관리자 그룹의 멤버여야 합니다.You must be a member of the local Administrators group to run these tools.'

중요

구성 파일을 수정할 때는 주의해야 합니다.Use caution when modifying configuration files. 내부용으로 예약된 설정을 수정할 경우 설치가 불가능할 수도 있습니다.If you modify a setting that is reserved for internal use, you may disable your installation. 일반적으로 특정 문제를 해결하려는 경우 외에는 구성 설정을 수정하지 않는 것이 좋습니다.Generally, modifying configuration settings is not recommended unless you are trying to solve a specific problem. 변경해도 문제가 없는 설정에 대한 자세한 내용은 RsReportServer.config 구성 파일 또는 RSReportDesigner 구성 파일을 참조하세요.For more information about which settings are safe to change, see RsReportServer.config Configuration File or RSReportDesigner Configuration File. 구성 파일에 대한 자세한 내용은 MicrosoftMicrosoft .NET Framework.NET Framework 제품 설명서를 참조하세요.For more information about configuration files, see the MicrosoftMicrosoft .NET Framework.NET Framework product documentation.

항목 내용In this topic:

구성 값 읽기 및 사용 Reading and Using Configuration Values

보고서 서버는 서비스가 시작될 때 및 구성 파일이 저장될 때마다 구성 파일을 읽습니다.A report server reads the configuration files when the service starts and whenever the configuration file is saved. 새 값 및 수정된 값은 현재 응용 프로그램 도메인이 만료된 후 새 응용 프로그램 도메인에 적용됩니다.New and revised values take effect in a new application domain after the current application domain expires. 가능하면 현재 응용 프로그램 도메인에서 아직 처리 중인 요청이 완료되도록 허용됩니다.Whenever possible, requests that are still processing in the current application domain are allowed to complete. 그러나 일부 설정의 경우 응용 프로그램 도메인 재활용 작업을 바로 수행해야 합니다.However, a few settings require an immediate application domain recycle operation. 이 경우 처리 중인 모든 요청이 새 응용 프로그램 도메인에서 다시 시작됩니다.In this case, all requests that are in process are restarted in a new application domain.

잘못된 값이 감지되면 보고서 서버는 Windows 응용 프로그램 로그에 오류를 기록하고 오류에 따라 시작되지 못하거나 기본값을 사용합니다.If the report server detects an invalid value, the report server logs an error to the Windows application log and either fails to start or uses a default value, depending on the error:

  • XML 형식이 잘못되었음을 나타내는 오류인 경우 보고서 서버는 시작되지 않습니다.If the error is malformed XML, the report server will not start. 오류가 발생할 때 보고서 서버가 실행 중이면 보고서 서버는 다시 시작되거나 응용 프로그램 도메인이 재활용될 때까지 잘못된 구성 파일을 무시합니다.If the report server is running when you introduce the error, the report server ignores the invalid configuration file until the report server restarts or the application domain is recycled. 오류가 감지되면 보고서 서버는 더 이상 시작되지 않습니다.Once the error is detected, the report server will no longer start.

  • 잘못된 구성 값 오류인 경우 서버는 내부 기본값을 사용하고 추적 로그 파일에 오류를 기록합니다.If the error is an invalid configuration value, the server will use internal default values and log an error to the trace log files. 내부 기본값을 사용할 수 없는 드문 경우 잘못된 구성 설정이 서버 작업에 중요하면 서버가 rsServerConfigurationError 오류를 반환합니다.In the few cases where internal default values are not available, the server will return the rsServerConfigurationError error if the invalid configuration setting is critical to server operations. 누락되었거나 잘못된 중요한 설정에 대한 오류는 클라이언트 응용 프로그램의 HTML 오류 페이지에 반환되고 이벤트 로그에 기록됩니다.Errors about missing or invalid critical settings are returned to the client application in an HTML error page and logged to the event log.

    성공적으로 적용된 변경 내용을 비롯하여 모든 구성 파일 변경 내용은 보고서 서버 추적 로그 파일에 기록됩니다.All configuration file changes, including successful changes, are recorded in the report server trace log file. 오류만 응용 프로그램 이벤트 로그에 기록됩니다.Only errors are logged to the application event log.

기본값 정보 About Default Values

대부분의 구성 설정에는 보고서 서버에서 내부적으로 지정된 기본값이 있습니다.Most configuration settings have default values that are specified internally in the report server. 사용자 정의 값이 올바르지 않거나 지정되지 않은 경우 보고서 서버는 이러한 값을 사용합니다.The report server will use these values if a user-defined value is invalid or not specified. 잘못된 구성 설정으로 인해 기본값을 사용해야 하는 경우 추적 로그 파일에 오류가 기록됩니다.If a default value must be used due to an invalid configuration setting, an error is written to the trace log file.

구성 설정 삭제 Deleting Configuration Settings

기본값이 지정된 구성 설정의 경우 구성 파일에서 해당 설정을 제거해도 아무런 영향이 없습니다.For configuration settings that have default values, removing the setting from the configuration file has no effect. 실제로 대부분의 구성 설정은 내부적으로 정의되고 구성됩니다.Most configuration settings are actually defined and configured internally. 구성 파일에서 항목을 삭제해도 내부 복사본은 계속 사용할 수 있으며 해당 항목에 대해 정의된 기본값이 사용됩니다.If you delete an item from the configuration file, the internal copy is still available and uses the default value that is defined for it.

Reporting Services 구성 파일을 편집하려면 To Edit a Reporting Services Configuration File

  1. 편집할 구성 파일을 찾습니다.Find the configuration file you want to edit:

    • RSReportServer.config 는 다음 디렉터리에 있습니다.RSReportServer.config is located in the following folder:

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

      ||
      |-|
      | 적용 대상:Applies to: 2017년 1월 SQL Server Reporting Services의 Power BI 기술 미리 보기 보고서 적용 대상:Applies to: January 2017 Technical Preview of Power BI reports in SQL Server Reporting Services|

      C:\Program Files\Microsoft SQL Server Reporting Services\RSServer\ReportServer
      
    • RSReportServerServices.exe.config 는 다음 디렉터리에 있습니다.RSReportServerServices.exe.config is located in the following folder:

      참고

      이 1 월 2017 사용할 수 있는 SQL Server Reporting Services에서 보고서를 Power BI의 기술 미리 보기.This is not available with the January 2017 Technical Preview of Power BI reports in SQL Server Reporting Services.

      C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer\bin  
      
    • RSReportDesigner.config 는 다음 디렉터리에 있습니다.RSReportDesigner.config is located in the following folder:

      C:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE\PrivateAssemblies  
      
  2. 변경 내용을 롤백해야 하는 경우에 대비하여 파일의 복사본을 저장합니다.Save a copy of the file in case you need to roll back your changes.

  3. 메모장 또는 코드 편집기에서 원래 파일을 엽니다.Open the original file in Notepad or a code editor. Textpad는 파일이 저장되기 전에 파일 길이를 설정하여 추적 로그 파일에 잘못된 문자 오류가 기록되게 하므로 사용하지 마세요.Do not use Textpad; it sets the file length before the file is saved, causing an invalid character error to be written to the trace log file.

  4. 추가 또는 사용할 요소나 값을 입력합니다.Type the element or value that you want to add or use. 요소는 대/소문자를 구분합니다.Elements are case-sensitive. 요소를 추가하는 경우 올바른 대/소문자를 사용해야 합니다.If you are adding an element, be sure to use the correct upper and lower case letters. 렌더링 확장 프로그램, 인증 확장 프로그램 또는 데이터 처리 확장 프로그램을 사용자 지정하는 경우 구성 파일 편집에 대한 특정 지침을 사용할 수 있습니다.Specific instructions for editing configuration files are available if you are customizing rendering extension, authentication extensions, or data processing extensions:

  5. 파일을 저장합니다.Save the file.

  6. 추적 로그 파일에서 오류가 발생하지 않았는지 확인합니다.Check the trace log files to verify that errors did not occur. 오류 상태가 표시되는 경우 설정 또는 해당 값이 잘못 지정된 것입니다.If you see error conditions, a setting or its value is specified incorrectly. 오류를 발생시키는 설정에 대한 유효한 값을 보려면 RsReportServer.config 구성 파일 을 검토하세요.Review the RsReportServer.config Configuration File for valid values for any setting that is causing an error. 추적 로그를 보는 방법은 보고서 서버 서비스 추적 로그를 참조하세요.For more information about how to view the trace log, see Report Server Service Trace Log.

관련 항목:See Also

RsReportServer.config 구성 파일 RsReportServer.config Configuration File
ReportingServicesService 구성 파일 ReportingServicesService Configuration File
RSReportDesigner 구성 파일 RSReportDesigner Configuration File
데이터 처리 확장 프로그램 배포 Deploying a Data Processing Extension
배달 확장 프로그램 배포 Deploying a Delivery Extension
렌더링 확장 프로그램 배포 Deploying a Rendering Extension
Reporting Services 구성 파일Reporting Services Configuration Files