SharePoint 2013에서 데이터베이스 업그레이드 문제 해결

적용 대상:2013 2016 2019 Subscription Edition SharePoint in Microsoft 365

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

이 문서에서는 일반적으로 발생하는 문제의 목록을 제공하며 업그레이드 문제를 확인 및 해결하는 데 도움이 되는 일반적인 원칙에 대해 설명합니다. 문제를 확인하여 해결한 후 업그레이드를 다시 시작할 수 있습니다. 업그레이드를 다시 시작하는 방법에 대한 자세한 내용은 데이터베이스 연결 업그레이드 다시 시작 또는 SharePoint 2013으로 사이트 모음 업그레이드를 참조하세요.

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

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

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

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

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

   업그레이드 상태를 확인하는 방법에 대한 자세한 내용은 SharePoint 2013에서 데이터베이스 업그레이드 확인을 참조하세요.

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

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

• ULS 또는 추적 로그 파일

  이러한 파일은 %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\15\LOGS 폴더에 저장되며 Servername_ YYYYMMDD- MMSS.log로 명명됩니다.

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

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

  업그레이드 로그 파일에 대한 자세한 내용은 SharePoint 2013에서 데이터베이스 업그레이드 확인을 참조하세요. 추적 로그 파일에 대한 자세한 내용은 MSDN의 추적 로그를 참조하세요.

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

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

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

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

   기능, 웹 파트 등과 같은 모든 서버 쪽 사용자 지정을 설치해야 합니다. 새 팜의 올바른 위치에 사용자 지정을 설치해야 합니다. 예를 들어 SharePoint 2010 제품용으로 추가 스타일시트를 설치해야 하며 업그레이드하지 않은 사이트 모음에서 사용할 수 있도록 새 /15 경로가 아니라 /14 경로에 설치해야 합니다. 또한 각 웹 애플리케이션의 Web.config 파일에서 새 서버로 모든 고유 설정을 전송해야 합니다.

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

3. 영향력이 크거나 매우 중요한 사이트부터 시작하여 사이트별로 발견한 추가 문제

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

일반적인 문제

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

Q: 시험판 버전의 SharePoint 2013에서 업그레이드하려는 경우

• A: SharePoint 2013의 시험판 버전에서 SharePoint 2013의 릴리스 버전으로 업그레이드할 수는 없습니다.

  시험판 버전은 테스트 전용이며 프로덕션 환경에서 사용해서는 안 됩니다. 시험판 버전 간 업그레이드도 지원되지 않습니다.

Q: 서식 파일, 기능 또는 기타 서버 쪽 사용자 지정 항목이 누락되었다는 메시지가 로그에 표시되는 경우

• A: 업그레이드 전에 모든 서버 쪽 사용자 지정 항목을 확인하고 설치합니다.

업그레이드 중에 한 가지 일반적인 오류는 SharePoint 2010 제품 또는 사용자 지정된 파일과 함께 설치된 파일과 같은 서버 쪽 파일이 없다는 것입니다. 업그레이드를 준비할 때 사이트에 필요한 서버 쪽 사용자 지정 항목(예: 사이트 정의, 서식 파일, 기능, 웹 파트, 어셈블리)의 인벤토리를 만들었어야 하는데, 그렇게 하지 않았기 때문에 이러한 오류가 발생합니다. 이 인벤토리를 검토하여 사용자 지정 항목에 필요한 모든 파일이 새 환경에 설치되는지 확인하십시오.

데이터베이스를 업그레이드하기 전에 test-spcontentdatabase Microsoft PowerShell cmdlet을 사용하여 누락된 파일을 식별할 수 있습니다. 또한 Stsadm.exe에서 enumallwebs 작업을 통해 사용 중인 서버 쪽 사용자 지정 항목을 확인할 수도 있습니다.

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

• 오류: 콘텐츠 데이터베이스 [콘텐츠 데이터베이스 이름]에서 누락된 웹 서식 파일 [사이트 서식 파일 ID](lcid: [사이트 서식 파일 언어 코드])을(를) 사용하는 웹이 [참조 횟수]회 있습니다.

• 오류 누락된 기능 ID = [기능 식별자]를 찾았습니다.

• 경고 파일 [상대 파일 경로] 는 데이터베이스에서 [참조 수] 시간을 참조하지만 현재 팜에 설치되어 있지 않습니다.

• WARNING WebPart 클래스 [웹 파트 식별자] 는 데이터베이스에서 [참조 수] 시간을 참조하지만 현재 팜에는 설치되지 않습니다.

• 경고 어셈 블리 [어셈블리 경로] 는 데이터베이스에서 참조되지만 현재 팜에는 설치되지 않습니다.

• 경고 기능을 업그레이드할 수 없습니다. 예외: 기능 정의 ID '기능 식별자'를 찾을 수 없습니다.

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

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

Q: 팜, 웹 응용 프로그램 또는 서비스 응용 프로그램 구성 설정에 문제가 있다는 메시지가 로그 파일에 표시되는 경우

• A: 팜 및 웹 응용 프로그램 설정을 확인합니다.

• A: 누락된 서비스 응용 프로그램을 만들고 시작합니다.

• A: 각 웹 응용 프로그램에 대해 관리 경로(포함된 경로)가 올바르게 구성되어 있는지 확인합니다.

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

• 오류 템플릿 템플릿 ID: SPSite ID= 예외로 인해 사이트 ID 에 액세스할 수 없습니다. 템플릿 업그레이드를 위해 SPWeb ID= 웹 ID 를 건너뜁니다. 예외: System.IO.FileNotFoundException: ID 가 사이트 ID 인 사이트를 찾을 수 없습니다.

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

Q: 업그레이드 중에 연결 또는 손상 관련 오류와 경고가 표시되는 경우

• A: 네트워크 및 SQL Server 대한 전원 연결 및 연결을 확인합니다. 데이터 원본에 대한 연결이 끊어질 경우 오류가 발생할 수 있습니다. 서버가 데이터베이스에 연결할 수 없는 경우 업그레이드할 수 없습니다.

Q: 디스크 공간이 부족한 경우

• A: 일부 공간을 확보하거나 업그레이드를 다시 시작하기 전에 트랜잭션 로그 파일의 크기를 늘입니다. 공간이 부족한 경우(예: 데이터베이스 서버의 트랜잭션 로그 파일) 업그레이드를 계속할 수 없습니다.

  자세한 내용은 트랜잭션 로그 파일 크기 관리를 참조하세요.

Q: 인증 관련 오류가 표시되는 경우

• A: 웹 응용 프로그램에서 적절한 인증 방법을 사용하고 있는지 확인합니다.

인증 방법이 일치하지 않으면 업그레이드 시 문제가 발생할 수 있습니다. 인증 방법이 일치하지 않는 경우 다음 리소스를 참조하면 도움이 될 수 있습니다.

• 클래식 인증과 클레임 인증 간 변경

  SharePoint 2013에서 만든 웹 애플리케이션이 SharePoint 2010 제품에서 사용된 것과 동일한 인증 방법을 사용하는지 확인합니다. 클레임 기반 인증은 SharePoint 2013의 웹 애플리케이션에 대한 기본 인증 방법입니다. 웹 응용 프로그램이 클래식 모드를 사용 중이었다면 데이터베이스를 업그레이드하기 전에 클레임 인증으로 업데이트하거나, 웹 응용 프로그램을 클래식 모드에서 만든 다음 클레임 모드로 마이그레이션할 수 있습니다. 클래식 모드를 사용하는 웹 애플리케이션을 만든 다음 클레임으로 마이그레이션하는 방법에 대한 자세한 내용은 [SharePoint Server에서 클래식 모드 인증을 사용하는 웹 애플리케이션 만들기]/previous-versions/office/sharepoint-server-2010/gg276326(v=office.14)) 및 SharePoint 2013에서 클래식 모드에서 클레임 기반 인증으로 마이그레이션을 참조하세요.

• 양식 기반 인증

  양식 기반 인증을 사용하는 환경을 업그레이드하는 경우 추가 단계가 필요합니다. SharePoint Server에서 클레임 기반 웹 애플리케이션에 대한 양식 기반 인증 구성의 단계에 따라 양식 기반 인증 공급자를 업그레이드합니다.

Q: SQL Server에서 사용 권한이 없다는 메시지가 표시되는 경우

• A: 알 수 없는 계정에 대한 오류가 발생하거나 데이터베이스가 업그레이드되지 않은 경우 데이터베이스에 대한 권한을 확인합니다. 특히 SQL Server 인스턴스 간에 보안이 올바르게 구성되었는지 확인해야 합니다. 사용하는 로그인 계정에 데이터베이스에 대한 적절한 고정 역할 및 권한이 있고 도메인 간에 업그레이드하는 경우에도 여전히 유효한지 확인합니다.

• A: 데이터베이스를 연결하는 데 사용하는 계정이 업그레이드할 데이터베이스에 대한 db_owner 고정 데이터베이스 역할의 구성원인지 확인합니다.

Q: 데이터베이스가 업그레이드되지 않는 경우

• **A: ** 데이터베이스가 읽기 전용으로 설정되어 있지 않은지 확인합니다. 읽기 전용으로 설정된 데이터베이스는 업그레이드할 수 없습니다. 데이터베이스를 연결하고 업그레이드하기 전에 데이터베이스를 읽기-쓰기로 설정해야 합니다.

Q: 복원 중에 데이터베이스 이름을 변경했는데 해당 이름의 파일을 찾을 수 없는 경우

• **A: ** 복원 시에 데이터베이스 이름을 바꿀 때는 파일 시스템에서 데이터베이스 및 로그 파일(MDF 파일 및 LDF 파일) 이름이 일치하도록 이름을 바꿔야 합니다.

Q: Search Service 응용 프로그램 관리 데이터베이스를 백업할 수 없는 경우

• **A: ** Search Service 애플리케이션 관리 데이터베이스를 백업하려면 SharePoint Server 2010 팜에서 Search Service 중지해야 합니다. Search Service 중지하려면 원래 팜의 시작 메뉴에서 관리 도구를 클릭한 다음 서비스를 클릭합니다. SharePoint Server Search 14를 마우스 오른쪽 단추로 클릭한 다음 중지를 클릭합니다. 데이터베이스를 백업한 후 서비스를 다시 시작해야 합니다.

Q: 업그레이드 후 Excel Services에 대해 신뢰할 수 있는 연결이 작동하지 않는 경우

• **A: ** 업그레이드 후에 Excel Services에 대한 모든 신뢰할 수 있는 데이터 연결을 수동으로 만들어야 합니다.

Q: 워크플로가 더 이상 올바르게 연결되지 않는 경우

• **A: ** 워크플로 자동 정리 타이머 작업이 꺼져 있는지 확인합니다. SharePoint 2010 제품 환경에서 워크플로 자동 정리 타이머 작업을 사용하지 않도록 설정한 경우 새 환경에서도 이 타이머 작업을 사용하지 않도록 설정해야 합니다. 이 타이머 작업이 새 환경에서는 사용하도록 설정되어 있고 SharePoint 2010 제품 환경에서는 사용하지 않도록 설정되어 있는 경우에는 업그레이드할 때 워크플로 연결이 손실될 수 있습니다.

Q: 업그레이드 후 클래식 인증에서 클레임 기반 인증으로 사용자를 마이그레이션했습니다. 그러나 일부 사용자에게는 오래된 정보가 있습니다.

• **A: ** 사용자 프로필에 문제가 있는 경우 사용자 프로필에서 SharePoint로의 전체 동기화 작업을 실행했는지 확인합니다.

  마이그레이션 프로세스가 완료되기 전에 작동 또는 수동으로 사용자 프로필에서 SharePoint로의 전체 동기화 작업을 시작했으면 일부 사용자가 마이그레이션되지 않을 수 있습니다. 마이그레이션이 완료된 후 Microsoft PowerShell에서 다음 cmdlet을 실행하여 동기화 데이터를 지울 수 있으며, 사용자 프로필을 SharePoint 전체 동기화 작업으로 다시 실행하여 추가 사용자를 포함할 수 있습니다.

  $database = Get-SPContentDatabase "DatabaseName"
  [Microsoft.Office.Server.UserProfiles.WSSProfileSynch]::ClearSyncDataForContentDatabase($database)
  

  여기서 DatabaseName 은 오래된 사용자 프로필과 연결된 사이트 모음의 콘텐츠 데이터베이스 이름입니다.

• **A: ** Active Directory 도메인에 해당 사용자가 존재하지 않는지 확인합니다.

  사용자가 존재하지 않으면 해당 사용자를 사용자 정보 테이블에서 삭제된 것으로 지정할 수 있습니다. 사용자가 존재하는 경우에는 마이그레이션을 다시 실행할 수 있습니다. 자세한 내용은 Migrate from classic-mode to claims-based authentication in SharePoint 2013을 참조하세요.

참고 항목

기타 리소스

SharePoint 2013으로의 테스트 업그레이드를 사용하여 잠재적 문제 발견

SharePoint 2013에서 데이터베이스 업그레이드 확인

SharePoint 2013으로 업그레이드된 사이트 모음 검토

[SharePoint 2013으로 데이터베이스 연결 업그레이드 또는 사이트 모음 업그레이드 다시 시작] (/previous-versions/office/sharepoint-server-2010/ff382638(v=office.14)