Настройка параметров кэша для веб-приложения в SharePoint Server

ОБЛАСТЬ ПРИМЕНЕНИЯ:2013 2016 2019 Subscription Edition SharePoint в Microsoft 365

В этой статье описывается настройка кэша больших двоичных объектов на диске, профилей кэша вывода страниц и кэша объектов для веб-приложения в SharePoint Server.

Включение и настройка кэша BLOB, а также изменение конфигурации для профилей кэша вывода страниц и кэша объектов осуществляются в файле Web.config того веб-приложения, к которому требуется применить эти изменения. Изменения, вносимые в файл Web.config, применяются ко всем семействам сайтов в данном веб-приложении.

SharePoint Server включает мониторы производительности кэша, которые позволяют проверить правильность параметров кэша фермы и работу кэширования с максимальной производительностью. Дополнительные сведения см. в статье Мониторинг производительности кэша в SharePoint Server 2016.

Примечание.

Настройка профилей кэша вывода страниц и кэша объектов на уровне веб-приложения переопределяет любую конфигурацию, примененную администраторами сайтов на уровне семейства сайтов или ниже.

Совет

В некоторых ситуациях кэш BLOB может рассинхронизироваться с контентом. Например, после восстановления базы данных контента кэш BLOB потеряет синхронизацию с контентом. Чтобы исправить ситуацию, необходимо очистить кэш. Дополнительные сведения см. в статье Очистка кэша BLOB-объектов в SharePoint Server.

Дополнительные сведения см. в статье Операции с параметрами кэша в SharePoint Server.

Настройка параметров кэша BLOB

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

Важно!

Перед внесением изменений в файл web.config создайте его копию под другим именем (например, web.config1), чтобы в случае ошибки можно было восстановить исходный файл.

Настройка параметров кэша BLOB

1. Проверьте наличие следующих административных учетных данных: для настройки параметров кэша BLOB вы должны быть членом группы "Администраторы" на локальном компьютере.

2. Откройте диспетчер серверов и в меню Сервис выберите Диспетчер служб IIS.

3. В диспетчере служб IIS в области Подключения разверните имя сервера, содержащего веб-приложение, а затем узел Сайты , чтобы просмотреть созданные веб-приложения или приложения.

4. Щелкните правой кнопкой имя веб-приложения, для которого требуется настроить дисковый кэш, а затем выберите пункт Просмотреть. Открывается проводник Windows с каталогами для выбранного веб-приложения.

5. В диалоговом окне Открыть с помощью щелкните Блокнот, а затем нажмите кнопку ОК.

6. В файле блокнота web.config найдите следующую строку: <BlobCache location="C:\BlobCache\14" path="\.(gif|jpg|jpeg|jpe|jfif|bmp|dib|tif|tiff|themedbmp|themedcss|themedgif|themedjpg|themedpng|ico|png|wdp|hdp|css|js|asf|avi|flv|m4v|mov|mp3|mp4|mpeg|mpg|rm|rmvb|wma|wmv|ogg|ogv|oga|webm|xap)$" maxSize="10" enabled="false" />

   По умолчанию максимальный размер изображения при использовании представлений изображений составляет 40 мегапикселей. При необходимости это значение можно изменить, добавив параметр imageRenditionMaxSourcePixels. Например: <BlobCache location="C:\BlobCache\14" path="\.(gif|jpg|jpeg|jpe|jfif|bmp|dib|tif|tiff|themedbmp|themedcss|themedgif|themedjpg|themedpng|ico|png|wdp|hdp|css|js|asf|avi|flv|m4v|mov|mp3|mp4|mpeg|mpg|rm|rmvb|wma|wmv|ogg|ogv|oga|webm|xap)$" maxSize="10" imageRenditionMaxSourcePixels="100000000" enabled="true" /> Это позволит задать максимальный размер изображения для представления изображений на уровне около 100 мегапикселей.

7. В этой строке измените location атрибут, чтобы указать каталог, который имеет достаточно места для размещения размера кэша.

   Примечание.

   Мы настоятельно рекомендуем указать каталог, который находится не на том диске, где хранятся файлы подкачки серверной операционной системы или файлы журналов сервера.

8. Чтобы добавить или удалить типы файлов из списка типов файлов для кэширования, измените регулярное выражение для атрибута path , чтобы включить или удалить соответствующее расширение файла. При добавлении расширений файлов обязательно отделяйте каждый тип файлов вертикальной чертой (|), как показано в этой строке кода.

9. Чтобы изменить размер кэша, введите новое значение для maxSize. Этот размер задается в гигабайтах (ГБ) и по умолчанию равен 10 ГБ.

   Важно!

   Не рекомендуется задавать размер кэша менее 10 ГБ. При установке размера кэша обязательно укажите достаточно большое число для того, чтобы предусмотреть резерв не менее 20 процентов от предполагаемого размера контента, который будет храниться в этом кэше.

10. Чтобы включить кэш BLOB-объектов, измените enabled атрибут с "false" на "true".

11. Сохраните файл Блокнота и закройте его.

Предостережение

При сохранении изменений в файле web.config веб-приложение в службах IIS 7.0 автоматически перезапускает. Такой перезапуск может привести к кратковременному перебою в обслуживании сайтов в этом веб-приложении, а пользователи могут потерять состояние сеанса. Сведения о повторном использовании веб-приложений в IIS 7.0 см. в разделе Обработка процессов IIS.

Настройка параметров профилей кэша

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

Примечание.

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

Примечание.

Существует известная проблема с веб-частью "Поиск контента". Параметр SendContentBeforeQuery в веб-части не работает должным образом на страницах, на которых используется кэширование выводимых данных. Эта проблема устранена в накопительном обновлении SharePoint Server 2013 за март 2013 г. Дополнительные сведения см. в статье базы знаний Майкрософт 2767999 : Описание обновления SharePoint Server 2013: 12 марта 2013 г.

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

Важно!

Перед внесением изменений в файл web.config создайте его копию под другим именем (например, web.config1), чтобы в случае ошибки можно было восстановить исходный файл.

Настройка параметров профиля кэша вывода страниц

1. Проверьте наличие следующих административных учетных данных: для настройки параметров профилей кэша вы должны быть членом группы "Администраторы" на локальном компьютере.

2. Откройте диспетчер серверов и в меню Сервис выберите Диспетчер служб IIS.

3. В диспетчере служб IIS в области Подключения разверните имя сервера, содержащего веб-приложение, а затем узел Сайты , чтобы просмотреть созданные веб-приложения или приложения.

4. Щелкните правой кнопкой имя веб-приложения, для которого требуется настроить дисковый кэш, а затем выберите пункт Просмотреть. Открывается проводник Windows с каталогами для выбранного веб-приложения.

5. Щелкните правой кнопкой мыши web.config, щелкните Открыть и выберите Блокнот , если вам будет предложено найти программу для открытия этого файла.

6. В файле блокнота web.config найдите следующую строку: <OutputCacheProfiles useCacheProfileOverrides="false" varyByHeader="" varyByParam="*" varyByCustom="" varyByRights="true" cacheForEditRights="false" />

7. Чтобы включить профиль кэша на уровне веб-приложения, измените useCacheProfileOverrides атрибут с "false" на "true".

   Примечание.

   Если задать значение true, параметры, указанные в Web.config, будут использоваться для всех профилей кэша вывода страниц. Это переопределяет все значения, введенные через пользовательский интерфейс на уровне семейства веб-сайтов.

8. Чтобы переопределить varyByHeader атрибут, введите настраиваемый параметр, указанный в записи библиотеки классов .NET Framework HttpCachePolicy.VaryByHeaders Property.

9. Чтобы переопределить varyByParam атрибут, введите настраиваемый параметр, указанный в записи библиотеки классов .NET Framework HttpCachePolicy.VaryByParams Property.

10. Чтобы переопределить varyByCustom атрибут, введите настраиваемый параметр, указанный в записи библиотеки классов .NET Framework HttpCachePolicy.SetVaryByCustom Method.

11. Чтобы переопределить varyByRights атрибут, измените значение с "true" на "false". Это устранит требование о том, что пользователи должны иметь идентичные действительные разрешения на всех защищаемых объектах, чтобы просматривать одну и ту же кэшированную страницу в качестве любого другого пользователя.

12. Чтобы переопределить cacheForEditRights атрибут, измените cacheForEditRights атрибут с "false" на "true". При этом будет выполнен обход нормального режима работы, при котором страницы людей с разрешениями на правку кэшируются.

13. Сохраните файл Блокнота и закройте его.

Предостережение

При сохранении изменений в файле web.config веб-приложение в службах IIS 7.0 автоматически перезапускает. Такой перезапуск может привести к кратковременному перебою в обслуживании сайтов в этом веб-приложении, а пользователи могут потерять состояние сеанса. Сведения о повторном использовании веб-приложений в IIS 7.0 см. в статье Запуск или остановка веб-сервера (IIS 8).

Настройка параметров кэша объектов

Администратор семейства сайтов может настроить параметры кэша объектов в пользовательском интерфейсе на уровне семейства сайтов, по умолчанию этот кэш включен. Максимальный размер кэша можно настроить на уровне веб-приложения на интерфейсном веб-сервере, чтобы установить ограничение на максимальный объем памяти, занимаемый кэшем для всех семейств сайтов. Например, отдельные семейства сайтов могут иметь кэш объектов, равный 100 МБ, а для веб-приложения может быть установлено значение 1 ГБ. В этом случае все кэши на сервере вместе не могут использовать более 1 ГБ памяти.

Примечание.

Чтобы использовать кэш объектов, на сайте следует использовать компонент публикации.

Чтобы настроить параметры кэша объектов для веб-приложения на интерфейсном веб-сервере, используйте следующую процедуру.

Важно!

Перед внесением изменений в файл web.config создайте его копию под другим именем (например, web.config1), чтобы в случае ошибки можно было восстановить исходный файл.

Настройка параметров кэша объектов

1. Проверьте наличие следующих административных учетных данных: для настройки параметров кэша объектов вы должны быть членом группы "Администраторы" на локальном компьютере.

2. Откройте диспетчер серверов и в меню Сервис выберите Диспетчер служб IIS.

3. В диспетчере служб IIS в области Подключения разверните имя сервера, содержащего веб-приложение, а затем узел Сайты , чтобы просмотреть созданные веб-приложения или приложения.

4. Щелкните правой кнопкой имя веб-приложения, для которого требуется настроить дисковый кэш, а затем выберите пункт Просмотреть. Открывается проводник Windows с каталогами для выбранного веб-приложения.

5. Щелкните правой кнопкой мыши web.config, щелкните Открыть и выберите Блокнот , если вам будет предложено найти программу для открытия этого файла.

6. В файле блокнота Web.config найдите следующую строку: <ObjectCache maxSize="100" />

7. Чтобы изменить размер кэша, введите новое значение для maxSize. Этот размер задается в мегабайтах (МБ) и по умолчанию равен 100 МБ.

8. Сохраните файл Блокнота и закройте его.

Предостережение

При сохранении изменений в файле web.config веб-приложение в службах IIS 7.0 автоматически перезапускает. Такой перезапуск может привести к кратковременному перебою в обслуживании сайтов в этом веб-приложении, а пользователи могут потерять состояние сеанса. Сведения о повторном использовании веб-приложений в IIS 7.0 см. в статье Запуск или остановка веб-сервера (IIS 8).

См. также

Концепции

Cache settings operations in SharePoint Server

Планирование кэширования и производительности в SharePoint Server