SharePoint 2013으로 업그레이드하는 중에 현재 사용자 지정 내용에 대한 계획 세우기
적용 대상:
2013 
2016 2019 Subscription Edition SharePoint in Microsoft 365
SharePoint 2010 제품을 기반으로 사이트를 광범위하게 사용자 지정한 경우 SharePoint 2013으로 업그레이드할 때 사용자 지정을 처리하는 방법을 결정해야 합니다. 처리 방식은 사용자 지정의 정도, 사용자 지정의 종류, 사이트의 복잡도 및 업그레이드 목표에 따라 달라집니다. 업그레이드하기 전에 사용자 환경에서 사용자 지정을 식별하고 평가하고 업그레이드 여부와 방법을 결정해야 합니다.
환경의 사용자 지정 내용 파악
업그레이드 테스트 프로세스의 일부로 해당 환경의 서버 쪽 사용자 지정 내용(솔루션, 기능, 웹 파트, 이벤트 처리기, 마스터 페이지, 페이지 레이아웃, CSS 파일 등)의 인벤토리를 만들어야 합니다. 사용자 지정 내용을 파악하는 방법에 대한 자세한 내용은 Use a trial upgrade to SharePoint 2013 to find potential issues을 참조하십시오.
사용자 지정 내용 평가
사용자 지정을 식별한 후 각 사용자 지정의 잠재적인 업그레이드 효과에 대해 생각해 보세요. 다음 표에서는 사용자 지정 내용의 유형과 업그레이드 중에 이러한 유형이 줄 수 있는 영향의 종류에 대해 설명합니다.
| 사용자 지정 범주 | 사용자 지정 유형 | 업그레이드에 대한 잠재적 영향 |
|---|---|---|
| 시각적으로 영향을 주는 |
마스터 페이지 테마 웹 페이지 웹 파트 사용자 지정 JavaScript 사용자 지정 CSS 파일 |
데이터베이스 업그레이드에 영향을 주지 않아야 합니다. 사이트 업그레이드의 경우 2010 모드에서는 정상적으로 작동하지만 2013 모드에서는 변경해야 작동합니다. 두 모드에서 모두 철저하게 테스트를 수행해야 합니다. |
| 데이터 구조에 영향을 주는 요소 |
콘텐츠 형식 목록 형식 웹 서식 파일 사이트 정의 |
콘텐츠 또는 목록 형식 이름이 제품의 새 콘텐츠 또는 목록 형식과 충돌하거나 서식 파일 또는 정의가 누락되는 경우 데이터베이스 업그레이드에 영향을 줄 수 있습니다. |
| 표시에 영향을 주지 않는 요소 |
웹 서비스 Windows 서비스 HTTP 처리기 HTTP 모듈 |
SharePoint 2013과 호환되지 않을 수 있습니다. 신중하게 테스트하여 효과를 확인합니다. 제거하거나 바꿀 준비를 합니다. |
사용자 지정 내용 및 유형을 파악한 후에는 해당 내용에 대해 수행할 작업을 결정할 수 있습니다. 다음과 같은 사항을 고려하면 사용자 지정 내용을 평가하는 데 도움이 됩니다.
사용자 지정 내용이 여전히 가치가 있는지 여부
유용한 비즈니스 요구 사항을 충족하는지 여부
광범위하게 배포되어 사용되는지 여부
제품의 표준 기능으로는 할 수 없는 작업을 수행하나요?
올바르게 디자인되어 있는지 여부
지원되는 미리 정의된 사이트 정의를 기반으로 구축되어 있는지 여부
사용자 지정 내용에 대한 최상의 방법을 따르는지 여부
지원되는 사용자 지정인가요, 아니면 사용자 환경에 위험을 초래하나요?
모든 사용자 지정 내용을 평가하면서 사용자 지정 내용의 전반적인 처리 방식에 대해서도 생각해 볼 수 있습니다. 다음과 같은 옵션 중에서 선택할 수 있습니다.
사용자 지정 내용을 보존하고 사이트 업그레이드 안 함 업그레이드된 항목에서 사이트를 계속 2010 모드로 실행할 수 있습니다. 이 방법을 사용하여 동일한 기능을 유지할 수 있지만 새 버전에서 사용할 수 있는 기능과 기능을 활용할 수 없습니다. 이 방식은 일시적으로만 사용해야 하며, 최종적으로는 다음 제품 버전으로의 업그레이드하기 전과 같은 시기에 문제를 해결해야 합니다.
사용자 지정 내용 바꾸기 또는 다시 실행 새로운 기능을 사용하거나, 사이트를 다시 디자인하거나, 정보 아키텍처를 크게 변경하려는 경우에는 업그레이드를 통해 새 기능, 새 모양 또는 새 구성으로 다시 시작할 수 있습니다. 사용자 지정 내용을 바꾸거나 다시 실행할 때 새 기능을 활용하거나, 필요한 경우 디자인을 약간 수정하거나, 관리가 보다 용이한 디자인으로 수정할 수 있습니다.
사용자 지정 내용 삭제 기본 기능을 사용하여 사용자 지정 내용을 바꿉니다. 기본 사이트 정의로 페이지를 다시 설정하고 더 이상 지원하지 않을 모든 웹 파트 또는 기능을 제거할 수 있습니다. 실제로 사이트 모음 상태 검사에서는 고스트되지 않은 페이지를 검사하며 페이지를 기본 버전으로 다시 설정할 수 있습니다. 사용자 지정 내용을 삭제하려는 경우 해당 사용자 지정 내용을 사용한 사이트에서 해당 내용을 제거함으로써 발생하는 모든 문제를 수정해야 합니다. 업그레이드 전이나 후에 사용자 지정 내용 인벤토리를 사용하여 이와 같이 신경 써야 할 사이트를 파악할 수 있습니다.
특정 사용자 지정 내용에 대한 고려 사항
업그레이드 중 해당 환경에서 사용자 지정 내용을 처리하는 방법을 전반적으로 결정할 뿐 아니라 특정 유형의 사용자 지정 내용을 검토하여 업그레이드된 환경에서 작동하도록 하기 위해 추가 작업을 수행해야 하는지 여부를 확인해야 합니다.
다음 표에는 일반적인 사용자 지정 내용 및 해당 종류의 사용자 지정 내용을 해결하기 위한 권장 사항이 나와 있습니다.
| 사용자 지정 유형 | 권장 사항 |
|---|---|
| 사이트 정의 |
지원되는 미리 정의된 사이트 정의로 사이트를 마이그레이션한 다음 솔루션 배포를 사용하여 사용자 지정 기능을 적용합니다. 사용자 지정 사이트 정의를 계속 사용할 수도 있습니다. SharePoint 2013을 기반으로 하는 새 사이트 정의를 만들 필요가 없습니다. 그러나 정의에 대해 사용자 지정 업그레이드 작업을 수행해야 하는 경우 해당 사이트 정의에 대한 업그레이드 정의 파일을 만들어야 할 수 있습니다. 자세한 내용은 MSDN의 업그레이드 정의 파일을 참조하세요. |
| 사용자 지정 사이트 서식 파일 |
SharePoint 2013으로 업그레이드한 후에 계속 사용할 사용자 지정 사이트 서식 파일(사용자 지정한 후 WSP 서식 파일로 저장한 사이트 서식 파일)이 있는 경우 사이트 모음을 업그레이드하기 전에 2013 모드에서 다시 만들어야 합니다. 사용자 지정 사이트 서식 파일은 특정 버전에 적용되며 후속 버전에서 항상 동일한 방식으로 표시되거나 작동되는 것은 아니므로 다시 만들어야 합니다. 뿐만 아니라 서식 파일을 사용하여 다양한 2010 사이트를 만든 경우 SharePoint 2013에서 제대로 작동되고 렌더링되기 위해 수동 조정이 필요할 수 있습니다. |
| 유용한 응용 프로그램 서식 파일 40개 |
Microsoft는 이러한 템플릿의 새 버전을 만들지 않습니다. 이러한 서식 파일을 기반으로 하는 사이트가 포함된 환경은 서식 파일이 설치되어 있으면 업그레이드할 수 있습니다. 그러나 사이트 모음 업그레이드 시 문제가 발생할 수 있습니다. 프로덕션 환경을 업그레이드하기 전에 각 사이트를 테스트해야 합니다. 자세한 내용은 Troubleshoot database upgrade issues in SharePoint 2013을 참조하십시오. |
| 기능 |
필요한 경우 평가한 다음 다시 디자인하거나 다시 배포합니다. |
| 워크플로 및 서버 컨트롤 |
솔루션에 따라 다릅니다. 업데이트된 솔루션이 있는지 확인하려면 공급업체에 문의하세요. 워크플로가 새 버전과 호환되는 경우 다시 배포합니다. |
| 이벤트 처리기 |
대부분의 이벤트 처리기는 변경하지 않아도 계속 작동합니다. 그러나 이벤트 처리기의 코드가 사용되지 않는 API를 호출하는 경우 다시 작성하고 기능으로 다시 배포해야 합니다. |
| 관리 경로(포함/제외) |
해당 경로에서 모든 사이트 모음에 액세스할 수 있도록 포함을 다시 만듭니다. SharePoint 2010 제품에서는 제외가 사용되지 않았습니다. 이전 버전에서 남은 항목이 있는 경우 다시 만들 필요가 없습니다. |
| 테마 |
SharePoint 2013 테마 작성 지침에 따라 테마를 다시 만들거나 SharePoint 2013에서 사용 가능한 새 테마를 선택합니다. 자세한 내용은 Branding issues that may occur when upgrading to SharePoint 2013 [Migrated]를 참조하세요. |
| 마스터 페이지 및 CSS 파일 |
새 사용자 환경을 수용하도록 다시 작업합니다. 자세한 내용은 Branding issues that may occur when upgrading to SharePoint 2013 [Migrated]를 참조하세요. |
| 자바 스크립트 |
테스트를 통해 필요한 작업이 있는지 여부를 확인합니다. 일부 경우 새 페이지 모델에서 작동하도록 스크립트를 조정해야 할 수 있습니다. 스크립트가 2010 모드와 2013 모드에서 모두 작동하는지 확인하십시오. |
| 검색 공급자 또는 보안 트리머 |
테스트를 통해 필요한 작업이 있는지 여부를 확인합니다. |
| 웹 파트 |
테스트를 통해 필요한 작업이 있는지 여부를 확인합니다. Strict XHMTL 모드에서 작동하도록 웹 파트를 조정해야 할 수 있습니다. 테스트하여 웹 파트에서 호출하는 개체 모델 또는 웹 서비스가 변경되지 않았는지 확인합니다. 웹 파트가 페이지에는 있지만 웹 파트 영역에는 없는 경우(웹 파트가 기본적으로 페이지에 직접 포함된 HTML 코드가 됨) 페이지를 기본 서식 파일로 다시 설정할 경우 해당 웹 파트가 작동하지 않습니다. 사이트 모음 내에서 이 상태의 파일을 식별하는 사이트 모음 상태 규칙이 있습니다. 해당 규칙에서 템플릿으로 다시 설정할 수 있는 페이지로 연결되는 링크가 있습니다. |
| 서비스 |
테스트를 통해 필요한 작업이 있는지 여부를 확인합니다. 필요에 따라 코드를 다시 디자인하거나 조정합니다. |
| 인증 공급자 |
테스트를 통해 필요한 작업이 있는지 여부를 확인합니다. 동일한 공급자 이름을 사용하여 공급자를 다시 배포합니다(정확히 일치). 여기에는 테스트 팜의 문자 대/소문자)가 포함되며 올바르게 작동하는지 확인합니다. |
| SQL 구문을 사용하는 사용자 지정 검색 솔루션 |
FQL 구문 및 KQL 구문을 사용하도록 다시 작성합니다. SharePoint 2013의 사용자 지정 검색 솔루션은 SQL 구문을 지원하지 않습니다. SharePoint 2013의 검색에서는 사용자 지정 검색 솔루션에 대해 FQL 구문 및 KQL 구문을 지원합니다. 어떤 기술도 사용하여 사용자 지정 검색 솔루션에서 SQL 구문을 사용할 수 없습니다. 여기에는 쿼리 서버 개체 모델, 클라이언트 개체 모델 및 Search REST Service가 포함됩니다. 인덱스 서버 개체 모델과 SharePoint Server 2010에서 만든 쿼리 웹 서비스에서 SQL 구문을 사용하는 사용자 지정 검색 솔루션은 SharePoint 2013으로 업그레이드할 때 작동하지 않습니다. 이러한 응용 프로그램을 통해 쿼리를 전송하면 오류가 발생합니다. FQL 구문 및 KQL 구문을 사용하는 방법에 대한 자세한 내용은 KQL(Keyword Query Language) 구문 참조 및 FQL(FAST Query Language) 구문 참조를 참조하세요. |
사용자 환경에서 사용자 지정을 검토하는 동안 환경이 더 이상 사용되지 않는 기능이나 요소를 사용하지 않는지 확인해야 합니다. 예를 들어 SharePoint 2010 제품의 Web Analytics는 SharePoint 2013에서 사용할 수 없으며 업그레이드하기 전에 해제해야 합니다. 또한 SQL Server 검색 쿼리는 SharePoint 2013에서 사용할 수 없습니다. 자세한 내용은 Changes from SharePoint 2010 to SharePoint 2013을 참조하십시오.
일부 사용자 지정 내용 배포 방법을 사용하는 경우 SharePoint 2013에서 추가 단계를 수행해야 할 수 있습니다. 다음 표에는 특정 사용자 지정 내용 배포 방법을 사용할 때 발생할 수 있는 문제가 나와 있습니다.
| 배포 방법** | **추천 |
|---|---|
| MSI 파일로 배포된 사용자 지정 내용 |
공급업체에 업데이트된 파일을 요청하세요. 대부분의 경우 SharePoint 2013과 호환되는 대체 파일을 가져와야 합니다. |
| 수동으로 배포된 기능, 파일 또는 변경 내용 |
SharePoint 2013의 해당하는 디렉터리에 다시 배포해야 합니다. 그러나 손쉬운 관리를 위해 이러한 항목을 배포 가능한 솔루션 패키지로 만들 수도 있습니다. |
| 샌드박스 솔루션 |
특별한 단계는 없습니다. 샌드박스 솔루션은 콘텐츠 데이터베이스를 사용하여 업그레이드됩니다. |
| 솔루션 패키지 |
SharePoint 2013로 다시 배포합니다. 버전에 따라 적절한 디렉터리(/14 또는 /15)로 다시 배포합니다. 더 이상 부분 신뢰 솔루션 패키지를 \bin 디렉터리에 추가할 수 없습니다. \bin 디렉터리에 배포하는 모든 파일은 완전히 신뢰할 수 있어야 합니다. 이러한 솔루션을 완전 신뢰로 배포해도 보안 취약성이 발생하지 않도록 이러한 솔루션을 테스트해야 합니다. 또한 올바른 신뢰 수준을 지정하도록 배포 스크립트를 업데이트하십시오. 자세한 내용은 Install-SPSolution을 참조하십시오. |
| 관리자가 배포한 양식 서식 파일 |
SharePoint Server 2010에서 추출한 다음 SharePoint 2013로 다시 배포해야 합니다. 자세한 내용은 Upgrade service applications to SharePoint 2013를 참조하십시오. |
다음 종류의 사용자 지정은 지원되지 않습니다. 해당 환경에 이러한 사용자 지정 내용이 있는 경우 업그레이드하기 전에 지원되는 종류의 사용자 지정 내용을 사용하여 해당 내용을 바꿔야 합니다. 그렇지 않으면 수정할 수 없는 업그레이드 문제가 발생할 수 있습니다.
변경된 미리 정의된 파일, 기능 또는 사이트 정의
주의
문서 아이콘 또는 작업과 같은 일부 미리 정의된 파일 형식은 지원 가능한 방식으로 전달할 수 있지만 자동으로 수행되지는 않습니다. 다른 문제가 발생할 수 있으므로 이전 버전 파일을 복사하지 마세요. 대신, 사이트 서식 파일로 다시 설정하거나 새 버전 파일에서 동일한 변경을 수행하지 않으면 업그레이드 중에 서버 쪽 ASPX 페이지와 같은 다른 미리 정의된 파일 수정 내용이 손실됩니다. 변경된 파일 및 이러한 변경의 정도에 따라 업그레이드 환경이 크게 달라질 수 있습니다.
데이터를 직접 변경하거나 스키마를 변경하여 변경된 SharePoint 데이터베이스입니다. 여기에는 트리거, 테이블, 뷰 또는 인덱스 추가 또는 제거가 포함됩니다.
이런 종류의 사용자 지정 내용이 있는 경우 업그레이드하기 전에 해당 사용자 지정 내용을 제거하고 지원되는 사용자 지정 내용으로 바꿉니다. 이는 현재 업그레이드가 제대로 작동할 뿐 아니라 이후 모든 업그레이드가 보다 순조롭게 수행되도록 하기 위한 최상의 방법입니다. 미리 정의된 파일 및 데이터베이스를 변경하는 것은 계속 지원되지 않습니다.
이후 사용자 지정 내용이 최상의 방법을 따르도록 확인
해당 환경이 올바르게 작동하고 최상의 방법을 따르는지 확인합니다. MSDN: 개발자 모범 사례 리소스 센터의 다음 페이지에 설명된 대로 모범 사례를 따르는 사용자 지정만 배포합니다.
참고 항목
기타 리소스
SharePoint 2010에서 SharePoint 2013으로의 업그레이드 모범 사례