SharePoint Server 2016에서 사이트 모음 업그레이드 문제를 해결하는 방법
적용 대상:2013 2016 2019 Subscription Edition SharePoint in Microsoft 365
사이트 모음을 SharePoint Server 2016으로 업그레이드할 때 오류가 발생할 수 있습니다. 이 문서에서는 해당 오류를 파악하고 해결하는 방법을 설명합니다.
업그레이드 상태 및 로그 파일 확인
업그레이드 상태 표시기 및 로그 파일에는 업그레이드 프로세스 중 발생한 문제가 표시됩니다. 업그레이드 로그 파일의 모든 오류를 주의 깊게 검토하는 것이 좋습니다. 경고가 항상 문제를 나타내는 것은 아니지만, 모든 경고를 검토하여 이러한 경고로 인해 훨씬 더 많은 문제가 발생할 가능성이 있는지 여부를 확인해야 합니다.
사이트 모음의 업그레이드 상태 페이지를 검토합니다.
사이트 모음의 사이트 설정 페이지 사이트 모음 관리 섹션에서 사이트 모음 업그레이드를 클릭합니다. 사이트 모음 업그레이드 페이지에서 사이트 모음 업그레이드 상태 검토를 클릭합니다.
페이지가 렌더링되지 않으면 사이트 설정 페이지를 확인합니다. 사이트 설정 페이지가 작동하고 업그레이드가 성공한 경우 마스터 페이지 또는 홈페이지 관련 문제가 있을 수 있습니다. 사이트 설정 페이지가 작동하지 않으면 사이트 모음 업그레이드 로그 파일에서 문제에 대한 정보를 확인합니다.
사이트 모음 업그레이드 로그 파일을 검토합니다. 다음 위치에서 사이트 모음 업그레이드 로그를 검토할 수 있습니다.
사이트 모음 관리자의 경우: 사이트 모음 자체 내에 저장된 사이트 모음 업그레이드에 대한 로그 파일도 유지 관리 로그 카탈로그(
http://<SiteName>/_catalogs/MaintenanceLogs/YYYYMMDD-HHMMSS-SSS.txt
여기서 YYYYMMDD는 날짜이고 HHMMSS-SSS는 시간(24시간 클록 형식, 분, 초 및 밀리초)입니다.팜 관리자의 경우: 사이트 모음 업그레이드 로그 파일 및 업그레이드 오류 로그 파일은 %COMMONPROGRAMFILES%\Microsoft Shared\Web server extensions\16\LOGS에 있습니다. 로그의 이름은 SiteUpgrade- YYYYMMDD-HHMMSS-SSS.log 형식으로 지정됩니다. 여기서 YYYYMMDD 는 날짜이고 HHMMSS-SSS 는 시간(24시간 시계 형식, 분, 초 및 밀리초)입니다. 문제에 대해 자세히 확인하려면 이러한 파일 시스템 로그에서 추가 정보를 확인할 수 있습니다.
일반적인 문제
다음과 같은 문제로 인해 업그레이드 오류, 경고 또는 사이트 문제가 발생하는지 확인합니다.
Q: 페이지에서 UI 컨트롤이 원래 위치에 표시되지 않음
- A: 페이지를 기본 버전으로 다시 설정(고스트 다시 생성)합니다.
사이트 UI를 변경하면 사이트 업그레이드 시 문제가 발생할 수 있습니다. 페이지를 사용자 지정하여 UI 컨트롤을 표준 위치가 아닌 다른 위치에 배치한 경우에는 페이지를 기본 버전으로 다시 설정하여 컨트롤을 복구할 수 있습니다.
페이지를 다시 설정하려면 사이트 설정 페이지 사이트 작업 아래의 사이트 정의로 다시 설정 링크를 사용하거나 SharePoint Designer의 서식 파일로 다시 설정을 사용할 수 있습니다.
Q: 큰 목록의 보기가 더 이상 작동하지 않음
- A: 큰 목록의 인덱싱된 열, 폴더 또는 새 보기를 만듭니다. 인덱싱된 열을 기존 보기에 추가해야 할 수 있습니다.
목록이 매우 큰데 사용자가 임계값 제한을 초과하는 보기를 사용하거나 쿼리를 수행하면 보기나 쿼리가 허용되지 않습니다. 필터링된 보기를 사용하여 인덱싱된 열을 만들거나, 항목을 폴더로 구성하거나, 큰 보기의 페이지에서 항목 제한을 설정하거나, 외부 목록을 사용할 수 있습니다. 큰 목록 제한 및 큰 목록의 문제를 해결하는 방법에 대한 자세한 내용은 많은 항목을 사용하여 목록 및 라이브러리 관리를 참조하세요.
Q: 중복 콘텐츠 형식 이름 관련 오류가 표시됨
- A: 기본 이름과 충돌하는 콘텐츠 형식 또는 필드의 이름을 바꿉니다.
경우에 따라 사용자 지정 요소(예: 콘텐츠 형식)의 이름이 새 버전의 이름과 충돌할 수 있습니다.
업그레이드 로그 파일에 다음과 같은 오류가 표시될 수 있습니다.
- 사이트 사이트 URL에서 사이트 모음 기능을 활성화하지 못했습니다. 예외: 중복된 콘텐츠 형식 이름 "이름" 이 발견되었습니다.
이 오류는 Sp1(서비스 팩 1)을 사용하여 SharePoint Server 2013의 지정된 사이트에 타사 콘텐츠 형식이 추가되었음을 나타냅니다. SharePoint Server 2016으로 업그레이드하는 동안 해당 이름이 동일한 이름으로 기본 콘텐츠 형식과 충돌했습니다. 지정된 사이트의 타사 콘텐츠 형식 이름을 다른 이름으로 바꾸고 업그레이드를 다시 실행합니다. 자세한 내용은 사이트 콘텐츠 형식 만들기 또는 사용자 지정을 참조하세요.
참고
콘텐츠 형식의 이름을 바꾸거나 제거하면 해당 콘텐츠 형식에 종속된 사용자 지정이 더 이상 작동하지 않을 수 있습니다.
Q: 사이트가 예상대로 표시 또는 동작하지 않거나 스크립트 오류가 표시됨
A: 페이지를 편집하거나 기본 버전으로 다시 설정합니다. 또는 사용자 지정 파일을 제거하거나 바꿉니다.
사용자 지정 또는 인라인 JavaScript/CSS 파일에 문제가 있으면 이러한 현상이 발생할 수 있습니다.
Q: 사이트의 사용자 지정 콘텐츠가 없어졌거나 작동하지 않음
A: 특정 영역이 필요하지 않도록 콘텐츠를 변경하거나 마스터 페이지를 변경합니다.
마스터 페이지에는 다른 영역 레이아웃이 있을 수 있으며 콘텐츠가 더 이상 올바르게 참조되지 않을 수 있습니다. 최후의 수단으로 페이지를 기본 버전으로 다시 설정할 수도 있습니다. 그러나 페이지를 다시 설정하면 영역별 콘텐츠가 손실될 수 있습니다.
Q: 컨트롤 또는 페이지를 렌더링할 수 없다는 오류가 표시됨
A: 다음 중 하나를 수행합니다.
설치되지 않은 웹 파트가 추가된 경우 팜 관리자에게 문의하여 설치합니다. 가 더 이상 사용할 수 없거나 지원되지 않는 웹 파트인 경우 웹 파트 유지 관리 보기를 사용하여 페이지에서 웹 파트를 제거합니다(제거, 웹 파트를 닫지 마세요).
페이지를 직접 편집한 경우에는 다시 편집하여 컨트롤 또는 웹 파트를 제거하거나 페이지를 기본 버전으로 다시 설정합니다.
설치되어 있지 않거나 더 이상 지원되지 않는 웹 파트 또는 기타 컨트롤을 페이지에 추가했을 수 있습니다. 웹 파트를 영역에 추가하거나 페이지를 직접 편집하여 컨트롤 또는 웹 파트 참조를 인라인으로 직접 추가했습니다(대개 마스터 페이지에서).
SharePoint 기능을 활성화해야 할 수도 있습니다. 자세한 내용은 사이트 모음 기능 사용 또는 사용 안 함 및 웹 파트 유지 관리 페이지 열기 및 사용을 참조하세요.
Q: 업그레이드된 사이트가 렌더링되지 않고 상관 관계 ID와 함께 "예기치 않은 오류"가 표시됨
A: 사용자 지정 브랜딩은 사용자 지정 콘텐츠 자리 표시자가 포함된 사용자 지정 마스터 페이지를 사용할 수 있습니다.
사용자 지정 마스터 페이지에 사용자 지정 콘텐츠 자리 표시자가 포함되어 있고 사용자 지정 페이지 레이아웃에도 이 사용자 지정 콘텐츠 자리 표시자가 포함된 경우 업그레이드 후에 오류로 인해 사이트의 홈페이지가 렌더링되지 않을 수 있습니다. 대신 업그레이드 후 "예기치 않은 오류가 발생했습니다."라는 오류 메시지가 표시될 수 있습니다.