SharePoint Server에서 웹 애플리케이션에 대한 캐시 설정 구성
적용 대상:2013 2016 2019 Subscription Edition SharePoint in Microsoft 365
이 문서에서는 SharePoint Server의 웹 애플리케이션에 대한 디스크 기반 BLOB 캐시, 페이지 출력 캐시 프로필 및 개체 캐시를 구성하는 방법을 설명합니다.
BLOB 캐시를 사용하도록 설정하고 구성한 다음 변경 내용을 적용할 웹 응용 프로그램의 Web.config 파일에서 페이지 출력 캐시 프로필 및 개체 캐시의 구성을 변경합니다. Web.config 파일의 변경 내용은 웹 응용 프로그램 내의 모든 사이트 모음에 적용됩니다.
SharePoint Server에는 팜 캐시 설정이 올바르고 캐싱이 최대 성능으로 실행되고 있는지 확인할 수 있는 캐시 성능 모니터가 포함되어 있습니다. 자세한 내용은 SharePoint Server 2016에서 캐시 성능 모니터링을 참조하세요.
참고
웹 응용 프로그램 수준의 페이지 출력 캐시 프로필 및 개체 캐시 구성은 사이트 관리자가 사이트 모음 수준 이하에서 수행한 구성보다 우선합니다.
팁
BLOB 캐시가 콘텐츠와 동기화되지 않는 경우가 있을 수 있습니다. 예를 들어 콘텐츠 데이터베이스를 복원한 후에는 BLOB 캐시가 콘텐츠와 동기화되지 않습니다. 이러한 상황을 해결하려면 BLOB 캐시를 플러시해야 합니다. 자세한 내용은 SharePoint Server에서 BLOB 캐시 플러시를 참조하세요.
자세한 내용은 SharePoint Server의 캐시 설정 작업을 참조하세요.
BLOB 캐시 설정 구성
기본적으로 디스크 기반 BLOB 캐시는 꺼져 있으며, 사용하려는 경우 프런트 엔드 웹 서버에서 사용하도록 설정해야 합니다. 웹 응용 프로그램에 대한 디스크 기반 캐시 설정을 구성하려면 다음 절차를 따르세요.
중요
web.config 파일을 변경하기 전에 다른 이름(예: web.config1)으로 파일 복사본을 만들어 파일을 잘못 수정할 경우 원본 파일을 복원할 수 있게 하세요.
BLOB 캐시 설정을 구성하려면
다음 관리자 자격 증명이 있는지 확인합니다. BLOB 캐시 설정을 구성하려면 로컬 컴퓨터에서 Administrators 그룹 구성원이어야 합니다.
서버 관리자를 열고 도구를 클릭한 후 IIS(인터넷 정보 서비스) 관리자를 클릭합니다.
IIS(인터넷 정보 서비스) 관리자의 연결 창에서 웹 애플리케이션이 포함된 서버 이름을 확장한 다음 사이트를 확장하여 생성된 웹 애플리케이션 또는 애플리케이션을 봅니다.
디스크 기반 캐시를 구성하려는 웹 응용 프로그램의 이름을 마우스 오른쪽 단추로 클릭하고 탐색을 클릭합니다. Windows 탐색기가 열리고 선택한 웹 응용 프로그램에 대한 디렉터리가 나열됩니다.
다음으로 열기 대화 상자에서 메모장을 클릭한 다음 확인을 클릭합니다.
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메가 픽셀에서 작동하도록 설정됩니다.이 줄에서 특성을 변경
location
하여 캐시 크기를 수용할 수 있는 충분한 공간이 있는 디렉터리를 지정합니다.참고
서버 운영 체제 스왑 파일이나 서버 로그 파일이 저장된 드라이브와 다른 드라이브에 있는 디렉터리를 지정하는 것이 좋습니다.
캐시할 파일 형식 목록에서 파일 형식을 추가하거나 제거하려면 특성에
path
대해 해당 파일 확장자를 포함하거나 제거하도록 정규식을 수정합니다. 파일 확장명을 추가하는 경우 다음 코드 줄과 같이 각 파일 형식을 파이프(|)로 구분해야 합니다.캐시 크기를 변경하려면 에 새 숫자를 입력합니다
maxSize
. 이 크기는 GB(기가바이트) 단위로 표시되며, 기본값은 10GB입니다.중요
캐시 크기를 10GB보다 작게 설정하지 않는 것이 좋습니다. 캐시 크기를 설정하는 경우 캐시에 저장될 콘텐츠의 예상 크기보다 20% 이상 큰 버퍼를 제공할 수 있는 숫자를 지정해야 합니다.
BLOB 캐시를 사용하도록 설정하려면 특성을 에서
"false"
로"true"
변경enabled
합니다.메모장 파일을 저장한 후 닫습니다.
주의
변경 내용을 web.config 파일에 저장하면 IIS(인터넷 정보 서비스) 7.0의 웹 애플리케이션이 자동으로 재활용됩니다. 이 재순환으로 인해 해당 웹 응용 프로그램에 포함된 사이트에 대한 서비스가 잠시 중단되고 사용자의 세션 상태가 손실될 수 있습니다. IIS 7.0에서 웹 애플리케이션을 재활용하는 방법에 대한 자세한 내용은 IIS 프로세스 재활용을 참조하세요.
캐시 프로필 설정 구성
캐시 프로필 설정은 사이트 모음 관리자가 사용자 인터페이스에서 사이트 모음 수준으로 구성할 수 있으며, 관리자가 프런트 엔드 웹 서버에서 웹 응용 프로그램 수준으로 구성할 수도 있습니다. 먼저 사이트 모음 수준에서 페이지 출력 캐시를 사용하도록 설정해야 사이트 모음 수준이나 웹 응용 프로그램 수준에서 페이지 출력 캐시 프로필을 구성할 수 있습니다. 웹 응용 프로그램 수준에서 페이지 출력 캐시 프로필을 사용하도록 설정한 경우 Web.config에 지정된 설정이 모든 페이지 출력 캐시 프로필에 사용되고, 사이트 모음 수준에서 사용자 인터페이스를 통해 입력된 값을 모두 재정의합니다.
참고
페이지 출력 캐시 및 연결된 캐시 프로필 설정을 사용하려면 사이트에서 게시 기능을 사용해야 합니다.
참고
콘텐츠 검색 웹 파트에 알려진 문제가 있습니다. 웹 파트의 SendContentBeforeQuery 설정이 출력 캐싱을 사용하는 페이지에서 제대로 작동하지 않습니다. 이 문제는 2013년 3월 SharePoint Server 2013 누적 업데이트에서 해결되었습니다. 자세한 내용은 Microsoft 기술 자료 문서 2767999: SharePoint Server 2013 업데이트 설명: 2013년 3월 12일을 참조하세요.
웹 응용 프로그램에 대한 캐시 프로필 설정을 구성하려면 다음 절차를 따르세요.
중요
web.config 파일을 변경하기 전에 다른 이름(예: web.config1)으로 파일 복사본을 만들어 파일을 잘못 수정할 경우 원본 파일을 복원할 수 있게 하세요.
페이지 출력 캐시 프로필 설정을 구성하려면
다음 관리자 자격 증명이 있는지 확인합니다. 캐시 프로필 설정을 구성하려면 로컬 컴퓨터에서 Administrators 그룹 구성원이어야 합니다.
서버 관리자를 열고 도구를 클릭한 후 IIS(인터넷 정보 서비스) 관리자를 클릭합니다.
IIS(인터넷 정보 서비스) 관리자의 연결 창에서 웹 애플리케이션이 포함된 서버 이름을 확장한 다음 사이트를 확장하여 생성된 웹 애플리케이션 또는 애플리케이션을 봅니다.
디스크 기반 캐시를 구성하려는 웹 응용 프로그램의 이름을 마우스 오른쪽 단추로 클릭하고 탐색을 클릭합니다. Windows 탐색기가 열리고 선택한 웹 응용 프로그램에 대한 디렉터리가 나열됩니다.
web.config마우스 오른쪽 단추로 클릭하고 이 파일을 여는 데 사용할 프로그램을 찾으라는 메시지가 표시되면 열기를 클릭하고 메모장을 선택합니다.
web.config 메모장 파일에서 다음 줄을 찾습니다.
<OutputCacheProfiles useCacheProfileOverrides="false" varyByHeader="" varyByParam="*" varyByCustom="" varyByRights="true" cacheForEditRights="false" />
웹 애플리케이션 수준에서 캐시 프로필을 사용하도록 설정하려면 특성을 에서
"false"
"true"
로 변경useCacheProfileOverrides
합니다.참고
이 설정을 true로 설정하면 Web.config 지정된 설정이 모든 페이지 출력 캐시 프로필에 사용됩니다. 사이트 모음 수준에서 사용자 인터페이스를 통해 입력된 모든 값을 재정의합니다.
특성을 재정의
varyByHeader
하려면 .NET Framework 클래스 라이브러리 항목 HttpCachePolicy.VaryByHeaders 속성에 지정된 대로 사용자 지정 매개 변수를 입력합니다.특성을 재정의
varyByParam
하려면 .NET Framework 클래스 라이브러리 항목 HttpCachePolicy.VaryByParams 속성에 지정된 대로 사용자 지정 매개 변수를 입력합니다.특성을 재정의
varyByCustom
하려면 .NET Framework 클래스 라이브러리 항목 HttpCachePolicy.SetVaryByCustom 메서드에 지정된 대로 사용자 지정 매개 변수를 입력합니다.특성을 재정의
varyByRights
하려면 값을 에서"true"
"false"
로 변경합니다. 그러면 사용자가 다른 사용자와 동일한 캐시된 페이지를 보기 위해 모든 보안 객체에 대해 동일한 유효 권한이 있어야 한다는 요구 사항이 제거됩니다.특성을 재정의
cacheForEditRights
하려면 특성을 에서"false"
"true"
로 변경cacheForEditRights
합니다. 그러면 편집 권한이 있는 사용자가 해당 페이지를 캐시되도록 하는 정상적인 동작이 무시됩니다.메모장 파일을 저장한 후 닫습니다.
주의
변경 내용을 web.config 파일에 저장하면 IIS(인터넷 정보 서비스) 7.0의 웹 애플리케이션이 자동으로 재활용됩니다. 이 재순환으로 인해 해당 웹 응용 프로그램에 포함된 사이트에 대한 서비스가 잠시 중단되고 사용자의 세션 상태가 손실될 수 있습니다. IIS 7.0에서 웹 애플리케이션을 재활용하는 방법에 대한 자세한 내용은 웹 서버 시작 또는 중지(IIS 8)를 참조하세요.
개체 캐시 설정 구성
개체 캐시 설정은 사이트 모음 관리자가 사용자 인터페이스에서 사이트 모음 수준으로 구성할 수 있으며 기본적으로 켜져 있습니다. 프런트 엔드 웹 서버에서 웹 응용 프로그램 수준으로 최대 캐시 크기를 구성하여 캐시가 모든 사이트 모음에 사용하는 최대 메모리 크기를 제한할 수 있습니다. 예를 들어 개별 사이트 모음에는 개체 캐시가 100MB로 설정되고 웹 응용 프로그램에는 1GB로 설정될 수 있습니다. 이 경우 서버의 모든 캐시에 1GB 이하의 메모리가 사용됩니다.
참고
개체 캐시를 사용하려면 사이트에서 게시 기능을 사용해야 합니다.
프런트 엔드 웹 서버에서 웹 응용 프로그램에 대한 개체 캐시 설정을 구성하려면 다음 절차를 따르세요.
중요
web.config 파일을 변경하기 전에 다른 이름(예: web.config1)으로 파일 복사본을 만들어 파일을 잘못 수정할 경우 원본 파일을 복원할 수 있게 하세요.
개체 캐시 설정을 구성하려면
다음 관리자 자격 증명이 있는지 확인합니다. 개체 캐시 설정을 구성하려면 로컬 컴퓨터에서 Administrators 그룹 구성원이어야 합니다.
서버 관리자를 열고 도구를 클릭한 후 IIS(인터넷 정보 서비스) 관리자를 클릭합니다.
IIS(인터넷 정보 서비스) 관리자의 연결 창에서 웹 애플리케이션이 포함된 서버 이름을 확장한 다음 사이트를 확장하여 생성된 웹 애플리케이션 또는 애플리케이션을 봅니다.
디스크 기반 캐시를 구성하려는 웹 응용 프로그램의 이름을 마우스 오른쪽 단추로 클릭하고 탐색을 클릭합니다. Windows 탐색기가 열리고 선택한 웹 응용 프로그램에 대한 디렉터리가 나열됩니다.
web.config마우스 오른쪽 단추로 클릭하고 열기를 클릭하고 이 파일을 여는 데 사용할 프로그램을 찾으라는 메시지가 표시되면 메모장을 선택합니다.
Web.config 메모장 파일에서 다음 줄을 찾습니다.
<ObjectCache maxSize="100" />
캐시 크기를 변경하려면 에 새 숫자를 입력합니다
maxSize
. 이 크기는 MB(메가바이트) 단위로 표시되며, 기본값은 100MB입니다.메모장 파일을 저장한 후 닫습니다.
주의
변경 내용을 web.config 파일에 저장하면 IIS(인터넷 정보 서비스) 7.0의 웹 애플리케이션이 자동으로 재활용됩니다. 이 재순환으로 인해 해당 웹 응용 프로그램에 포함된 사이트에 대한 서비스가 잠시 중단되고 사용자의 세션 상태가 손실될 수 있습니다. IIS 7.0에서 웹 애플리케이션을 재활용하는 방법에 대한 자세한 내용은 웹 서버 시작 또는 중지(IIS 8)를 참조하세요.