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

Статья
06/25/2013

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

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

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

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

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

Считывание и применение значений конфигурации
Значения по умолчанию
Удаление настроек конфигурации
Изменение файла конфигурации служб Reporting Services

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

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

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

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

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

Значок стрелки, используемый со ссылкой «В начало» В начало

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

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

Значок стрелки, используемый со ссылкой «В начало» В начало

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

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

Значок стрелки, используемый со ссылкой «В начало» В начало