Изменение файла конфигурации служб Reporting Services (RSreportserver.config)

Службы Reporting Services сохраняют параметры приложения в наборе файлов конфигурации. Программа установки создает файлы конфигурации для каждого устанавливаемого экземпляра сервера отчетов. Значения в каждом файла задаются либо во время установки, либо при использовании средств и приложений для настройки сервера и подготовки его к работе. В некоторых случаях приходится изменять непосредственно сам файл, чтобы добавить дополнительные параметры или настроить их. Параметры конфигурации задаются либо как элементы XML, либо как атрибуты. Если вы знакомы с XML и файлами конфигурации, то можете использовать редактор текста или кода для настройки пользовательских параметров.

Некоторые параметры конфигурации можно задать только с помощью средств. Параметры, которые содержат зашифрованные значения, должны изменяться с помощью программы настройки служб Reporting Services, программы установки или программы командной строки rsconfig . Чтобы иметь возможность запускать эти средства, необходимо членство в локальной группе «Администраторы».

Важно!

При изменении файлов конфигурации следует соблюдать осторожность. Если изменяется параметр для внутреннего использования, можно блокировать свою установку. Как правило, изменять параметры конфигурации не рекомендуется, если не пытаетесь устранить конкретную проблему. Дополнительные сведения о параметрах, изменение которых безопасно, см. в разделе Файл конфигурации RsReportServer.config или Файл конфигурации RSReportDesigner. Дополнительные сведения о файлах конфигурации см. в документации по продукту Microsoft.NET Framework .

В этом разделе:

Считывание и применение значений конфигурации

Сервер отчетов считывает файлы конфигурации во время запуска службы и после каждого сохранения файла конфигурации. Новые и пересмотренные значения вступают в силу в новом домене приложения после истечения срока действия текущего домена приложения. Если есть такая возможность, допускается завершение запросов, которые все еще обрабатываются в текущем домене приложения. Однако некоторые параметры требуют немедленного выполнения операции очистки домена приложений. В этом случае все обрабатываемые запросы перезапускаются в новом домене приложения.

Если сервер отчетов обнаруживает недопустимое значение, он регистрирует ошибку в журнале приложений Windows, после чего либо завершает запуск аварийно, либо использует значение по умолчанию, в зависимости от ошибки.

  • Если ошибка в XML, сервер отчетов не запустится. Если сервер отчетов работает в момент возникновения ошибки, он не учитывает неверный файл конфигурации до своего перезапуска или до перезапуска цикла домена приложений. После обнаружения ошибки сервер отчетов не будет запускаться.

  • Если ошибка связана с недопустимым значением параметра конфигурации, сервер использует внутренние значения по умолчанию и регистрирует ошибку в файлах журнала трассировки. В некоторых случаях, если внутренние значения по умолчанию недоступны, сервер возвращает ошибку rsServerConfigurationError, если недопустимое значение конфигурации является важным для работы сервера. Сообщения об ошибках, касающихся недостающих или недопустимых важных настройках, возвращаются в клиентское приложение на HTML-странице ошибок и регистрируются в журнале событий.

Все изменения в файле конфигурации, в том числе успешные, регистрируются в файле журнала трассировки сервера отчетов. В журнале событий приложений регистрируются только ошибки.

Значения по умолчанию

Большинство параметров конфигурации имеет значения по умолчанию, которые указаны непосредственно в коде сервера отчетов. Эти значения используются в сервере отчетов, если какое-то определяемое пользователем значение является недопустимым или не указано. Если значение по умолчанию использовано из-за недопустимого значения параметра конфигурации, в файле журнала трассировки регистрируется ошибка.

Удаление настроек конфигурации

Если настройки конфигурации имеют значения по умолчанию, удаление настройки из файла конфигурации не оказывает никакого эффекта. Определения и настройка большинства параметров конфигурации внутренние. Если удалить элемент из файла конфигурации, внутренняя копия остается доступной и использует определенные для нее значения по умолчанию.

Изменение файла конфигурации служб Reporting Services

  1. Найдите файл конфигурации, который необходимо изменить.

    • Файл RSReportServer.config расположен в следующей папке:

      C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer  
      
      Применимо к: Техническая версия отчетов Power BI в службах SQL Server Reporting Services (январь 2017 г.)
      C:\Program Files\Microsoft SQL Server Reporting Services\RSServer\ReportServer
      
    • Файл RSReportServerServices.exe.config находится в следующей папке:

      Примечание

      Он недоступен в технической версии отчетов Power BI (январь 2017 г.) в службах SQL Server Reporting Services.

      C:\Program Files\Microsoft SQL Server\MSRS13.MSSQLSERVER\Reporting Services\ReportServer\bin  
      
    • Файл RSReportDesigner.config расположен в следующей папке:

      C:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE\PrivateAssemblies  
      
  2. Сохраните копию файла на тот случай, если потребуется выполнить откат внесенных изменений.

  3. Откройте исходный файл в Блокноте или редакторе кода. Не используйте программу Textpad, так как она задает длину файла еще до сохранения файла, что приводит к записи в файл журнала трассировки сообщения об ошибке, связанного с наличием недопустимого символа.

  4. Введите элемент или значение, которое необходимо добавить или использовать. Элементы вводятся с учетом регистра. При добавлении элемента следите за правильным использованием букв верхнего и нижнего регистра. При настройке модуля подготовки отчетов, модуля проверки подлинности или модулей обработки данных можно руководствоваться конкретными инструкциями по изменению файлов конфигурации:

  5. Сохраните файл.

  6. Проверьте файлы журнала трассировки, чтобы убедиться в том, что не возникли ошибки. Найденные ошибки означают, что какой-то параметр или его значение указаны неправильно. Просмотрите раздел Файл конфигурации RSReportServer , чтобы определить допустимые значения для каждого из параметров, ставшего причиной ошибки. Дополнительные сведения о просмотре журнала трассировки см. в разделе Журнал трассировки службы сервера отчетов.

См. также:

RsReportServer.config Configuration File
Файл конфигурации ReportingServicesService
Файл конфигурации RSReportDesigner
Развертывание модуля обработки данных
Развертывание модуля доставки
Развертывание модуля подготовки отчетов
Файлы конфигурации служб Reporting Services