업그레이드 문제 해결(SharePoint Server 2010)

  • 아티클

 

적용 대상: SharePoint Server 2010

마지막으로 수정된 항목: 2016-11-30

업그레이드 프로세스를 테스트하여 잠재적인 문제를 확인한 후에도 Microsoft Office SharePoint Server 2007에서 Microsoft SharePoint Server 2010으로 업그레이드하는 동안 예기치 않은 문제가 발생할 수 있습니다. 업그레이드 후 문제가 발생하는 경우 빠르게 문제를 감지하여 수정할수록 최종 사용자 환경이 더 향상됩니다.

이 문서에서는 업그레이드 문제를 확인하고 해결하는 일반적인 원칙을 설명하고 일반적인 문제의 목록을 제공합니다. 문제를 확인하여 해결한 후 업그레이드를 다시 시작할 수 있습니다. 업그레이드를 다시 시작하는 방법에 대한 자세한 내용은 업그레이드 다시 시작(SharePoint Server 2010)을 참조하십시오.

이 문서의 내용

  • 문제를 확인하는 일반적인 원칙

  • 일반적인 문제

    • 누락되거나 더 이상 사용되지 않는 서버 쪽 파일 또는 사용자 지정 내용

    • 서버 팜, 웹 응용 프로그램 또는 서비스에 대해 잘못 구성되거나 누락된 설정

    • 일관되지 않거나 잘못된 업데이트 수준

    • 블로그에 대한 누락된 전역 탐색

    • 데이터 문제

    • UI 변경

    • 공간 부족

    • 양식 기반 인증

    • 보안 및 사용 권한

    • 업그레이드 후 .stp 파일이 올바르게 작동하지 않는 문제

    • 새 버전의 40개의 멋진 응용 프로그램 서식 파일을 찾을 수 없는 문제

    • SharePoint Portal Server 2003의 데이터 업그레이드: 업그레이드 사전 검사 도구에서 손상된 데이터베이스 보고

문제를 확인하는 일반적인 원칙

먼저 업그레이드 상태를 확인하여 업그레이드가 중지된 위치(중지된 경우)를 파악하고 로그 파일에 오류나 경고가 있는지 살펴봅니다. 그런 다음 업그레이드를 다시 시작하기 전에 발견한 문제를 해결합니다.

먼저 업그레이드 상태 및 로그 파일 확인

업그레이드 상태 표시기 및 로그 파일에는 업그레이드 프로세스 중 발생한 문제가 표시됩니다. 업그레이드 로그 파일에 기록된 모든 오류를 주의 깊게 검토하는 것이 좋습니다. 경고가 항상 문제를 나타내는 것은 아니지만, 모든 경고를 검토하여 이러한 경고로 인해 훨씬 더 많은 문제가 발생할 가능성이 있는지 여부를 확인해야 합니다.

  1. 다음 중 하나 또는 두 가지 모두를 수행하여 업그레이드 상태를 확인합니다.

    • SharePoint 중앙 관리 웹 사이트의 업그레이드 상태 페이지를 검토합니다.

    • Stsadm.exe 작업 localupgradestatus를 사용하여 업그레이드 상태를 확인합니다.

    업그레이드 상태를 확인하는 방법에 대한 자세한 내용은 업그레이드 확인 및 업그레이드된 사이트 검토(SharePoint Server 2010)를 참조하십시오.

  2. 다음 로그 파일을 검토합니다.

    • Setup.exe 로그 파일

    • SharePoint 제품 구성 마법사(Psconfig.exe) 로그 파일

    • 업그레이드 오류 로그 파일 및 업그레이드 로그 파일(업그레이드 오류 로그 파일보다 자세한 정보 포함)

    • ULS 또는 추적 로그 파일

      이러한 파일은 %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\14\LOGS 폴더에 저장되며 서버 이름_YYYYMMDD-MMSS.log로 이름이 지정됩니다.

    • 응용 프로그램 이벤트 로그 파일

      이 파일은 이벤트 뷰어를 사용하여 볼 수 있습니다.

    Setup.exe, PSconfig.exe 및 업그레이드 로그 파일에 대한 자세한 내용은 업그레이드 확인 및 업그레이드된 사이트 검토(SharePoint Server 2010)를 참조하십시오. 추적 로그 파일에 대한 자세한 내용은 MSDN의 추적 로그(영문일 수 있음)(https://go.microsoft.com/fwlink/?linkid=182380&clcid=0x412)(영문일 수 있음)를 참조하십시오.

그런 다음 순서대로 문제 해결

일부 문제는 다른 문제보다 더 큰 영향을 미칩니다. 예를 들어 서버 쪽 파일이 누락되면 사이트 수준에서 관련되지 않은 것처럼 보이는 많은 오류가 발생할 수 있습니다.

다음 순서대로 문제를 해결합니다.

  1. 서버 쪽 파일 또는 사용자 지정 내용(예: 기능 또는 웹 파트) 누락

  2. 서버 팜, 웹 응용 프로그램 또는 서비스의 구성 문제(예: 시작되지 않는 서비스 또는 관리 경로)

  3. 큰 영향력을 미치는 주요 사이트부터 시작하여 사이트별로 발견한 추가 문제

최상위 수준 문제를 확인하고 수정할 때 업그레이드를 다시 실행하여 업그레이드 프로세스에서 이후의 모든 문제도 수정되었는지 여부를 확인할 수 있습니다.

일반적인 문제

다음과 같은 문제로 인해 업그레이드 오류 또는 경고가 발생하는지 여부를 확인합니다.

누락되거나 더 이상 사용되지 않는 서버 쪽 파일 또는 사용자 지정 내용

업그레이드 중 발생하는 일반적인 오류 한 가지는 서버 쪽 파일(Office SharePoint Server 2007과 함께 설치된 파일 또는 사용자 지정된 파일) 누락입니다. 업그레이드를 준비할 때 사이트에 필요한 서버 쪽 사용자 지정 내용(예: 사이트 정의, 서식 파일, 기능, 웹 파트, 어셈블리)의 인벤토리를 만들었어야 하는데, 그렇게 하지 않았기 때문에 이러한 오류가 발생합니다. 업그레이드 사전 검사 도구를 사용하면 이러한 항목을 쉽게 확인할 수 있습니다. 이 인벤토리를 검토하여 사용자 지정 내용에 필요한 모든 파일이 업그레이드 환경에 설치되는지 확인하십시오.

데이터베이스 연결 업그레이드를 수행하는 경우 데이터베이스를 업그레이드하여 누락된 파일을 확인하기 전에 test-spcontentdatabaseWindows PowerShell cmdlet을 사용할 수 있습니다. 또한 Stsadm.exe에서 enumallwebs 작업을 사용하여 사용 중인 서버 쪽 사용자 지정 내용을 확인할 수도 있습니다.

업그레이드 로그 파일에 다음과 같은 오류가 표시될 수 있습니다.

  • ERROR Found Reference Count web(s) using missing web template Site Template Identifier (lcid: Site Template Language Code) in ContentDatabase Content Database Name.(오류: 콘텐츠 데이터베이스 [콘텐츠 데이터베이스 이름]에서 누락된 웹 서식 파일 [사이트 서식 파일 ID](lcid: [사이트 서식 파일 언어 코드])을(를) 사용하는 웹이 [참조 횟수]회 있습니다.)

  • ERROR Found a missing feature Id = [Feature Identifier] (오류: 누락된 기능 ID = [기능 ID] 이(가) 있습니다.)

  • ERROR File [Relative File Path] is referenced [Reference Count] times in the database, but is not installed on the current farm.(오류: 파일 [상대 파일 경로] 이(가) 데이터베이스에서 [참조 횟수] 회 참조되지만 현재 팜에 설치되어 있지 않습니다.)

  • WARNING WebPart class [Web Part Identifier] is referenced [Reference Count] times in the database, but is not installed on the current farm.(경고: 웹 파트 클래스 [웹 파트 ID] 이(가) 데이터베이스에서 [참조 횟수] 회 참조되지만 현재 팜에 설치되어 있지 않습니다.)

  • WARNING Assembly [Assembly Path] is referenced in the database, but is not installed on the current farm.(경고: 어셈블리 [어셈블리 경로] 이(가) 데이터베이스에서 참조되지만 현재 팜에 설치되어 있지 않습니다.)

  • WARNING Feature could not be upgraded. Exception: Feature definition id 'Feature Identifier' could not be found.(경고: 기능을 업그레이드할 수 없습니다. 예외: 기능 정의 ID '기능 ID' 을(를) 찾을 수 없습니다.)

누락된 서버 쪽 파일 또는 종속성을 가져올 수 있는 경우 해당 파일 또는 종속성을 설치한 다음 영향을 받는 사이트에 대해 다시 업그레이드를 실행하십시오. 파일 또는 종속성(예: 웹 파트)이 더 이상 사용되지 않는 경우 다른 서식 파일, 기능 또는 웹 파트를 사용하도록 사이트, 페이지 또는 웹 파트를 다시 구축할지 여부를 조사해야 합니다. 계속 사용되는 종속성을 사용하여 사용자 지정을 다시 실행할 수 있는 경우 영향을 받는 사이트에 대해 업그레이드를 다시 실행할 수 있습니다. 종속성을 제거할 수 없는 경우에는 사이트를 업그레이드할 수 없습니다.

누락된 파일 또는 종속성을 설치한 후 테스트 서버에서 test-SPContentDatabaseWindows PowerShell cmdlet을 사용하여 해당 데이터베이스에 대해 다른 누락된 파일이 있는지 여부를 확인하십시오. 업그레이드 사전 검사 도구를 실행하거나 업그레이드를 다시 실행하는 것만으로는 오류가 계속 발생하더라도 로그 파일에 나타나지 않을 수 있습니다.

서버 팜, 웹 응용 프로그램 또는 서비스에 대해 잘못 구성되거나 누락된 설정

팜 및 웹 응용 프로그램 설정을 확인하고 누락된 모든 서비스를 만들어 시작합니다.

각 웹 응용 프로그램에 대해 모든 관리 경로(포함되거나 제외된 경로)가 올바르게 구성되었는지 확인합니다.

업그레이드 로그 파일에 다음과 같은 오류가 표시될 수 있습니다.

  • ERROR Template Template Id: SPSite Id=Site Id could not be accessed due to exception. Skipping SPWeb Id=Web Id for template upgrade. Exception: System.IO.FileNotFoundException: The site with the id Site Id could not be found.(오류: 서식 파일 서식 파일 ID: 예외로 인해 SPSite ID=사이트 ID에 액세스할 수 없습니다. 서식 파일 업그레이드에 대해 SPWeb ID=웹 ID을(를) 건너뜁니다. 예외: System.IO.FileNotFoundException: ID가 사이트 ID인 사이트를 찾을 수 없습니다.)

    이 오류는 관리 경로가 누락되었음을 나타냅니다. 웹 응용 프로그램에 사이트 모음의 관리 경로를 추가하고 이 사이트 모음이 포함된 콘텐츠 데이터베이스의 업그레이드를 다시 시작하십시오.

일관되지 않거나 잘못된 업데이트 수준

업그레이드를 실행하려면 Office SharePoint Server 2007 서비스 팩 2를 실행 중이어야 합니다. 이와 같은 최소 요구 사항을 충족하지 않는 경우 오류가 발생하고 업그레이드가 실행되지 않습니다.

또한 서버를 올바르게 업데이트해야 합니다. 예를 들어 Windows SharePoint Services 3.0 버전의 업데이트는 적용했지만 Office SharePoint Server 2007 버전의 업데이트는 적용하지 않은 경우 업그레이드가 실행되지 않습니다. Windows SharePoint Services 3.0의 버전 번호는 SharePoint 중앙 관리에서 팜의 서버 페이지에 표시됩니다. Office SharePoint Server 2007의 버전 번호는 %COMMONPROGRAMFILES%\Microsoft Shared\Web server extensions\12\ISAPI 폴더에 있는 Microsoft.SharePoint.portal.dll 파일의 버전 번호입니다. 팜의 서버 페이지에 표시되는 버전 번호와 Microsoft.SharePoint.portal.dll 파일의 버전 번호는 일치해야 하며, 업그레이드하려면 12.0.6420.1000 이상 버전이어야 합니다. 자세한 내용은 Office SharePoint Server 2007의 소프트웨어 업데이트 배포를 참조하십시오.

블로그에 대한 누락된 전역 탐색

또 다른 일반적인 오류는 업그레이드된 블로그에 대한 전역 탐색이 누락되는 것입니다. 이러한 문제가 발생하는 이유는 업그레이드 과정에서 MySiteNavigation(6adff05c-d581-4c05-a6b9-920f15ec6fd9) 기능이 사용하도록 설정되지 않기 때문입니다. 이 기능을 사용하도록 설정하려면 Enable-SPFeatureWindows PowerShell 2.0 cmdlet을 실행합니다.

자세한 내용은 Enable-SPFeature을 참조하십시오.

데이터 문제

다음과 같은 데이터 문제로 인해 업그레이드 중 오류 또는 경고가 발생할 수 있습니다.

  • 데이터 원본에 대한 연결. 서버에서 데이터베이스에 연결할 수 없는 경우 서버를 업그레이드할 수 없습니다.

  • 고아 사이트 또는 목록이나 기타 데이터베이스 손상. 자세한 내용은 업그레이드 전 환경 정리(SharePoint Server 2010)를 참조하십시오.

  • 숨겨진 열 데이터. 업그레이드 프로세스에서 목록에 열을 추가하는 경우 해당 목록에 동일한 이름의 사용자 지정 열이 이미 있으면 사용자 지정 열의 이름이 바뀝니다. 업그레이드 후 이름이 바뀐 열을 포함하도록 보기를 다시 조정해야 할 수 있습니다.

업그레이드 로그 파일에 다음과 같은 오류가 표시될 수 있습니다.

  • WARNING The orphaned sites could cause upgrade failures.(경고: 고아 사이트로 인해 업그레이드 오류가 발생할 수 있습니다.)

  • ERROR Database [Content Database Name] contains a site (Id = [Site Collection Identifier] , Url = [Site Collection URL] ) that is not found in the site map.(오류: 데이터베이스 [콘텐츠 데이터베이스 이름] 에 사이트 맵에서 찾을 수 없는 사이트(ID = [사이트 모음 ID] , URL = [사이트 모음 URL] )가 포함됩니다.)

모든 고아 항목 또는 데이터베이스 손상을 수정한 다음 업그레이드를 다시 실행하십시오.

UI 변경

Fluent UI('리본'이라고도 함) 추가 또는 XHTML 표준 준수와 같은 UI(사용자 인터페이스) 변경으로 인해 사이트에 문제가 발생할 수 있습니다. 경우에 따라 사용자 지정 요소(예: 콘텐츠 형식)의 이름이 새 버전의 이름과 충돌할 수 있습니다. 또한 표준 사이트 정의로 되돌려야 하는 페이지가 있거나 새로운 보기를 만들어야 하는 큰 목록이 있을 수도 있습니다.

사이트의 UI 문제를 검토하는 방법에 대한 자세한 내용은 업그레이드 확인 및 업그레이드된 사이트 검토(SharePoint Server 2010)를 참조하십시오.

업그레이드 로그 파일에 다음과 같은 오류가 표시될 수 있습니다.

  • Failed to activate site collection features on site Site Url. Exception: A duplicate content type name "name" was found.(사이트 [사이트 URL]에서 사이트 모음 기능을 활성화하지 못했습니다. 예외: 중복 콘텐츠 형식 이름 "이름" 이(가) 있습니다.)

    이 오류는 타사 "요약 정보" 콘텐츠 형식이 o12에서 지정된 사이트에 추가되었으며 o14로 업그레이드하는 동안 해당 이름이 기본 "요약 정보" 콘텐츠 형식과 충돌한다는 것을 나타냅니다. 지정된 사이트에서 타사 콘텐츠 형식을 삭제하거나 "요약 정보" 이외의 이름으로 이름을 바꾼 다음 업그레이드를 다시 실행하십시오.

공간 부족

데이터베이스 서버의 트랜잭션 로그 파일 등에 대한 공간이 부족한 경우 업그레이드를 계속 수행할 수 없습니다. 업그레이드를 다시 시작하기 전에 공간을 비우거나 트랜잭션 로그 파일의 크기를 늘리십시오. 자세한 내용은 트랜잭션 로그 파일의 크기 관리(https://go.microsoft.com/fwlink/?linkid=124882&clcid=0x412)를 참조하십시오.

폼 기반 인증

폼 기반 인증을 사용하는 환경을 업그레이드하는 경우 추가 단계가 필요합니다. 클레임 기반 웹 응용 프로그램에 대해 폼 기반 인증 구성(SharePoint Server 2010)의 단계에 따라 폼 기반 인증 공급자를 업그레이드하십시오.

보안 및 사용 권한

알 수 없는 계정과 관련된 오류가 발생하거나 데이터베이스가 업그레이드되지 않는 경우 다음을 확인합니다.

  • 전체 업그레이드의 경우 SharePoint 제품 구성 마법사를 실행하는 데 사용하는 계정이 업그레이드할 모든 데이터베이스에 대한 db_owner 고정 데이터베이스 역할의 구성원인지 확인합니다. 이 역할의 구성원이 아닌 경우 마법사에서 데이터베이스 업그레이드를 시작하면 알 수 없는 계정과 관련된 오류가 발생할 수 있습니다.

  • 데이터베이스 연결 업그레이드의 경우 SQL Server 인스턴스 간에 데이터베이스를 이동할 때 보안 구성이 올바른지 확인합니다. 사용하는 계정에 데이터베이스에 대한 적절한 사용 권한 및 고정 역할이 있으며, 도메인 간에 업그레이드를 수행하는 경우에도 여전히 유효하게 사용할 수 있는지 확인합니다.

업그레이드 후 .stp 파일이 올바르게 작동하지 않는 문제

사이트 서식 파일(.stp 파일)은 SharePoint Server 2010에서 더 이상 사용되지 않으며 이 파일을 사용하여 새 사이트를 만들 수 없습니다. .stp 파일을 기반으로 하는 기존 사이트는 평소처럼 계속 작동합니다. 솔루션 패키지(.wsp 파일)는 SharePoint Server 2010의 서식 파일을 기반으로 하는 사이트를 만들도록 하기 위해 지원되는 방식입니다. 업그레이드 후 서식 파일을 계속 사용하도록 하려면 .stp 파일을 .wsp 파일로 변환하면 됩니다.

.stp 파일을 .wsp 파일로 변환하려면

  1. Office SharePoint Server 2007에서 서식 파일을 기반으로 하는 사이트를 만든 다음 사이트를 SharePoint Server 2010으로 업그레이드합니다.

  2. SharePoint Server 2010에서 업그레이드된 사이트의 사이트 작업 메뉴에서 사이트 설정을 클릭합니다.

  3. 사이트 설정 페이지의 사이트 작업에서 사이트를 서식 파일로 저장을 클릭합니다.

  4. 서식 파일로 저장 페이지에서 파일 이름 및 서식 파일 이름을 입력한 다음 확인을 클릭합니다.

    사이트 서식 파일이 해당 사이트 모음의 솔루션 갤러리에 .wsp 파일로 저장되며 해당 솔루션을 기반으로 하는 새 사이트를 만들 수 있게 됩니다.

새 버전의 40개의 멋진 응용 프로그램 서식 파일을 찾을 수 없는 문제

이미 많은 사용자들이 Windows SharePoint Services 3.0용으로 만들어진 "40개의 멋진" 서식 파일을 사용하고 있습니다. 이러한 서식 파일 중 일부는 사이트 관리 서식 파일(.stp 파일)로 만들어졌고 또 일부는 서버 관리 서식 파일(.wsp 파일)로 만들어졌습니다. Microsoft에서는 SharePoint 2010 제품을 위한 이러한 서식 파일의 새 버전을 릴리스하고 있지 않습니다. 또한 .stp 파일은 더 이상 사용되지 않으며 SharePoint Server 2010으로 업그레이드할 때 이 파일을 사용하여 새 사이트를 만들 수 없습니다.

이러한 서식 파일을 기반으로 하는 사이트를 업그레이드할 수 있습니다. 하지만 잠재적인 문제를 발견할 수 있도록 프로덕션 환경을 업그레이드하기 전에 테스트 환경에서 이러한 사이트의 업그레이드를 시험해야 합니다. 문제를 발견하려면 업그레이드 사전 검사 도구를 사용합니다. 일부 사용자에게는 서식 파일의 사용자 지정 워크플로 또는 CAML 기반 보기에 문제가 있는 것으로 확인되었습니다. 업그레이드 후에는 .stp 파일을 사용하여 새 서식 파일을 만들 수 없습니다.

다음 표에서는 서식 파일을 사용하는 방법에 대해 설명합니다.

서식 파일 유형 이 서식 파일을 기반으로 하는 사이트의 업그레이드 가능 여부 업그레이드 후 서식 파일의 사용 가능 여부

사이트 관리(.stp 파일 또는 사이트 서식 파일)

예

아니요

서버 관리(.wsp 파일 또는 솔루션 패키지)

예*

예*

*업그레이드 후 일부 .wsp 파일에 문제가 발생합니다. 특히 업그레이드 후 일부 고객은 휴가 신청서 및 휴가 일정 관리, 콜 센터, 지원 센터, IT 팀원 작업 공간, 기술 자료, 실제 자산 추적 및 관리 같은 서식 파일을 기반으로 하는 새 사이트를 만들 수 없습니다. 이러한 서식 파일을 사용하는 데 문제가 있는 경우 SharePoint 2010 ? Setup, Upgrade, Administration and Operation TechNet 포럼(영문일 수 있음)(https://go.microsoft.com/fwlink/?linkid=201600&clcid=0x412)(영문일 수 있음)에 문제를 게시하거나 Microsoft 고객 지원 서비스에 문의하면 됩니다.

SharePoint Server 2010에서 사이트 관리 서식 파일(.stp 파일)을 기반으로 하는 사이트를 계속 만들려는 경우 이를 솔루션 패키지(.wsp 파일)로 변환해야 합니다. 자세한 내용은 이 문서 앞부분의 업그레이드 후 .stp 파일이 올바르게 작동하지 않는 문제 섹션을 참조하십시오.

SharePoint Portal Server 2003의 데이터 업그레이드: 업그레이드 사전 검사 도구에서 손상된 데이터베이스 보고

Office SharePoint Server 2007 팜의 콘텐츠 데이터베이스를 Microsoft Office SharePoint Portal Server 2003 콘텐츠 데이터베이스에서 업그레이드한 경우 업그레이드 사전 검사 도구를 실행하면 다음과 같은 오류 메시지가 나타날 수 있습니다.

실패: 데이터베이스 스키마가 수정된 콘텐츠 데이터베이스

데이터베이스의 스키마를 수동으로 변경하지 않은 경우 이 오류 메시지를 무시하고 계속 업그레이드를 수행하면 됩니다. 이는 SharePoint Portal Server 2003에서 Office SharePoint Server 2007로 업그레이드하는 과정에 불필요하게 발생하는 오류입니다. 자세한 내용은 Microsoft 기술 자료 문서 954772를 참조하십시오.

See Also

Concepts

테스트 업그레이드를 사용하여 잠재적 문제 발견(SharePoint Server 2010)
업그레이드 확인 및 업그레이드된 사이트 검토(SharePoint Server 2010)
업그레이드 다시 시작(SharePoint Server 2010)