ID 마이그레이션 관련 문제 해결

백업을 복원할 수 없음

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-identity-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 maintenance restore --file <file_name>
    tsm start

    중요: 백업이 복원된 후 마이그레이션이 시작되면 ID 서비스가 ID 정보로 채워집니다. 백업 복원에 대한 일반적인 내용은 백업에서 복원을 참조하십시오.

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

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

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

  3. ID 마이그레이션 충돌 해결에 설명된 대로 모든 ID 충돌을 해결하거나 승인하여 아래의 이미지와 같이 모든 실패 탭에 '0'이 표시되도록 합니다.

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

    • ID 마이그레이션 작업을 지금 실행하려면 마이그레이션 개요 제목 옆에서 일정 편집 드롭다운 화살표를 클릭한 다음 지금 실행을 선택합니다.

    • 또는 다음 예약 시간에 마이그레이션 작업이 실행될 때까지 기다려도 됩니다.
  5. 마이그레이션이 완료되면 ID 마이그레이션 페이지에서 마이그레이션 개요에 100% 완료가 표시되는지 확인합니다.

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

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

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

    참고: 위의 명령을 실행한 후 설명된 ID 마이그레이션 페이지가 제거되고 더 이상 액세스할 수 없게 됩니다. 이 페이지에는 tsm authentication legacy-identity-mode를 사용하도록 설정한 경우에만 액세스할 수 있습니다.

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

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

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

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

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

마이그레이션 진행률이 응답하지 않거나 멈춘 것으로 보임

마이그레이션 상태 또는 마이그레이션 진행률 표시기가 응답하지 않거나 멈춘 것으로 보이는 경우 마이그레이션 실패 아래에서 모든 사용자 충돌이 해결되었고 승인되었는지 검증합니다.

이 문제를 해결하려면 모든 실패 탭에서 하나 이상의 사용자 ID를 선택하고 동작 드롭다운 메뉴에서 승인을 클릭하여 모든 충돌이 해결되고 승인되었는지 확인합니다. 모든 실패 탭에 '0'이 표시될 때까지 이 작업을 수행합니다. ID 충돌 관리에 대한 자세한 내용은 ID 마이그레이션 충돌 해결을 참조하십시오.

참고: 모든 ID 충돌을 해결한 후 모든 마이그레이션 작업을 실행해야 합니다. 그래야 Tableau Server에 ID 서비스를 사용하도록 설정할 수 있습니다. 이제 마이그레이션 개요 제목 옆의 일정 편집 드롭다운 화살표를 클릭한 다음 지금 실행을 선택하여 마이그레이션 작업을 실행할 수 있습니다. 마이그레이션 개요에 100% 완료가 표시되면 ID 서비스를 사용하도록 Tableau Server를 구성할 수 있습니다. 자세한 내용은 3단계: ID 마이그레이션 완료를 참조하십시오.

"ID 마이그레이션이 진행 중입니다" 팝업이 지속됨

ID 서비스가 아직 사용하도록 설정되지 않았기 때문에 ID 마이그레이션을 완료했는데도 "ID 마이그레이션이 진행 중입니다"라는 알림이 계속 표시됩니다. ID 마이그레이션을 완료하려면 Tableau Server가 ID 풀 기능을 사용하는 ID 구조를 사용할 수 있도록 4단계: ID 서비스를 사용하도록 Tableau Server 구성를 참조하여 ID 서비스를 사용하도록 설정해야 합니다.

ID 마이그레이션 페이지가 사라짐

ID 마이그레이션이 완료되고 Tableau Server가 ID 서비스를 사용하도록 구성되면 전용 ID 마이그레이션 페이지가 제거되고 더 이상 액세스할 수 없게 됩니다. ID 마이그레이션 페이지는 ID 마이그레이션에만 필요하거나 tsm authentication legacy-identity-mode를 사용하는 경우에만 필요합니다.

사용자가 로그인할 수 없음

ID 마이그레이션이 완료되고 ID 서비스를 사용하도록 설정한 후 일부 사용자가 Tableau Server에 로그인할 수 없습니다. 대부분의 경우 이 문제는 ID가 충돌하고 나중에 ID 마이그레이션 중에 확인된 사용자에게 발생합니다. 확인된 사용자 ID는 ID 서비스로 마이그레이션되지 않으며 이후 AD(Active Directory) 또는 LDAP 그룹 동기화 중에 무시됩니다.

확인된 사용자 ID와 연결된 사용자가 Tableau Server에 다시 액세스해야 하는 경우 해당 사용자를 Tableau Server에 수동으로 추가해야 합니다. 사용자가 수동으로 추가된 후 후속 AD 또는 LDAP 그룹 동기화를 통해 사용자 ID가 인식되고 예상대로 동기화됩니다.

ID 마이그레이션 되돌리기

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

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

피드백을 제공해 주셔서 감사합니다!귀하의 피드백이 제출되었습니다. 감사합니다!