백업을 복원할 수 없음

Tableau Server 2022.1 이상으로 업그레이드한 후 Tableau Server 백업을 복원할 때 다음 오류가 발생합니다.

“Tableau Server에 기본적으로 새 ID 서비스 테이블이 사용되기 때문에 백업을 복원할 수 없습니다.”

이 문제는 Tableau Server에서 ID 마이그레이션을 실행해야 하기 때문에 발생합니다. Tableau Server 2022.1 이상에서는 사용자를 프로비저닝하고 인증할 때 ID 서비스라는 ID 스키마를 사용하는데, 이 ID 서비스를 채우려면 마이그레이션이 필요합니다. 잠재적 문제를 방지하기 위해 Tableau Server 백업에 Tableau Server 2022.1 이상과 다른 ID 스키마가 사용되는 것이 감지되면 업그레이드 프로세스를 진행할 수 없습니다.

이 문제를 해결하려면 아래에 설명된 단계를 수행합니다.

1단계: legacy-idenity-mode를 사용하도록 설정한 후 백업 복원

  1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다.
  2. 다음 명령을 실행하여 레거시 ID 저장소 모드를 사용하도록 Tableau Server 2022.1 이상을 설정합니다.

    tsm authentication legacy-identity-mode enable
    tsm pending-changes apply

    ID 서비스를 채우려면 Tableau Server에서 레거시 ID 저장소 모드를 사용해야 합니다. tsm 명령에 대한 자세한 내용은 tsm authentication legacy-identity-mode를 참조하십시오.

  3. 다음 명령을 실행하여 백업을 다시 복원하고 마이그레이션이 시작될 수 있도록 합니다.

    tsm restore
    tsm pending-changes apply

    중요: 백업이 복원된 후 마이그레이션이 시작되면 ID 서비스가 ID 정보로 채워집니다.

2단계: ID 마이그레이션 확인 및 완료

  1. Tableau Server에 관리자로 로그인합니다.
  2. 왼쪽 탐색 패널에서 사용자(또는 다중 사이트 Tableau Server의 경우 모든 사이트 > 사용자)를 선택한 다음 ID 마이그레이션 페이지를 클릭하여 마이그레이션이 시작되었는지 확인합니다.

    Tableau Server의 사용자 페이지에 있는 전용 ID 마이그레이션 페이지를 사용하여 진행률을 모니터링하고 관리할 수 있습니다. 자세한 내용은 ID 마이그레이션 관리를 참조하십시오.

  3. ID 마이그레이션 충돌 해결에 설명된 모든 ID 충돌을 해결하거나 확인합니다.

  4. 다음 작업 중 하나를 수행합니다.

    • ID 마이그레이션 작업을 지금 실행하려면 마이그레이션 개요 제목 옆에서 일정 편집 드롭다운 화살표를 클릭한 다음 지금 실행을 선택합니다.
    • 또는 다음 예약 시간에 마이그레이션 작업이 실행될 때까지 기다려도 됩니다.
  5. 마이그레이션이 완료되면 ID 마이그레이션 페이지에서 마이그레이션 개요에 100% 완료가 표시되는지 확인합니다.

3단계: ID 서비스를 사용하도록 Tableau Server 구성

  1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다.
  2. 다음 명령을 실행합니다.

    tsm authentication legacy-identity-mode disable
    tsm pending-changes apply

ID 서비스를 사용하도록 Tableau Server를 구성한 후에 사용자가 Tableau Server에 로그인하면 Tableau Server가 구성된 ID 저장소의 식별자를 사용하여 사용자 ID를 검색합니다. 이 식별자에서 UUID(범용 고유 식별자)가 반환되고 일치하는 기존 Tableau Server 사용자 ID를 찾는 데 사용됩니다. 그런 다음에는 사용자 세션이 생성되고 인증 워크플로우가 완료됩니다.

ID 마이그레이션 페이지의 “예기치 않은 오류”

ID 마이그레이션 페이지에서 모든 사용자 ID를 해결하거나 확인한 후에 “예기치 않은 오류” 메시지가 표시됩니다. 이 메시지는 한 번에 1,000명이 넘는 사용자를 해결하거나 확인하려고 할 때 표시될 수 있습니다.

이 문제를 해결하려면 1,000명 이하의 사용자 ID를 선택하여 해결하거나 확인한 다음 다시 시도하십시오.

ID 충돌 관리에 대한 자세한 내용은 ID 마이그레이션 충돌 해결을 참조하십시오.

ID 마이그레이션 되돌리기

특정 사용자가 Tableau Server에 로그인할 수 없는 것과 같이 ID 서비스로 인한 문제가 있다고 생각되면 tsm authentication legacy-identity-mode 명령을 사용하여 레거시 ID 저장소 모드를 사용하도록 되돌릴 수 있습니다. 되돌린 후에는 ID 마이그레이션 이후에 추가된 새 사용자와 마이그레이션 전의 Tableau Server에만 로그인할 수 있었던 사용자 모두 문제 없이 Tableau Server에 로그인할 수 있게 됩니다.

ID 서비스에서 레거시 ID 저장소 모드로 되돌린 후 ID 마이그레이션 페이지에서 문제가 있는 사용자 ID의 마이그레이션을 실행할 수 있습니다. ID 충돌 관리에 대한 자세한 내용은 ID 마이그레이션 충돌 해결을 참조하십시오.

피드백을 제공해 주셔서 감사합니다!