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

Статья
02/08/2024

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

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

Важно!

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

Содержание этой статьи

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

Чтение и использование значений конфигурации

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

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

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

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

Сведения о значениях по умолчанию

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

Удаление параметров конфигурации

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