ID 마이그레이션 관리

관리자는 Tableau Server의 사용자 페이지에서 사용할 수 있는 전용 ID 마이그레이션 페이지에서 ID 마이그레이션을 모니터링하고 관리할 수 있습니다. 예를 들어 마이그레이션 작업 실행 시기를 변경할 수 있습니다. 이 페이지는 마이그레이션 프로세스 중에 사용할 수 있습니다.

ID 마이그레이션 개요 페이지입니다.

마이그레이션 작업은 Tableau Server 사용 중단 또는 방해 없이 백그라운드에서 실행되도록 설계되었습니다. 그러나 필요한 경우 마이그레이션 작업 실행 빈도, 실행 시기 및 실행 기간에 영향을 미치는 조정을 수행할 수 있습니다.

일반적으로 마이그레이션은 Tableau Server 배포의 크기와 마이그레이션 중에 변경한 기본 설정에 따라 3분에서 10일이 걸릴 수 있습니다. 예를 들어 사용자 수가 10,000명인 경우 마이그레이션에 약 30분이 소요될 수 있습니다.

참고: 마이그레이션 작업이 실행되는 동안 모든 인증 및 사용자 관련 기능은 정상적으로 작동합니다.

ID 마이그레이션 작업 관리

ID 마이그레이션의 다음 측면을 관리할 수 있습니다.

ID 충돌 해결
일별 마이그레이션 작업 일정 변경
마이그레이션 작업 시작
ID 마이그레이션 일시 중지
ID 마이그레이션 다시 시작

ID 마이그레이션 설정 변경

ID 마이그레이션으로 인해 Tableau Server에 발생할 수 있는 부하를 줄이기 위해 마이그레이션은 아래에 나열된 기본 설정으로 실행되도록 구성됩니다.

마이그레이션 설정

유형tsm 명령기본값절차
작업 일정해당 없음오전 3:00, 완료될 때까지 매일ID 마이그레이션 페이지에서 구성 가능함. 위의 일별 마이그레이션 작업 일정 변경 참조.
사용자 ID 요청/초(속도)tsm authentication identity-migration configure -–rate최대 5

필요한 경우 tsm authentication identity-migration 명령을 사용하여 아래의 단계에 따라 위에 나열된 마이그레이션 설정을 변경할 수 있습니다.

  1. 클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다.
  2. tsm authentication identity-migration에 설명된 명령을 하나 또는 둘 다 실행합니다.

    예를 들어 개별 작업 런타임 및 속도를 기본값에서 변경하려면 다음 명령을 실행하면 됩니다.

    tsm authentication identity-migration configure --job-run-time 180 --rate 3

개별 작업 런타임tsm authentication identity-migration configure -–job-run-time120분
ID 마이그레이션 사용tsm configuration set -k features.IdentityMigrationBackgroundJobfalse

ID 마이그레이션을 사용하도록 설정하면 Tableau Server는 ID 서비스를 사용하여 사용자 ID 정보를 저장하고 관리할 수 있습니다.

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

  2. 다음 명령을 실행합니다.

    tsm configuration set -k features.IdentityMigrationBackgroundJob -v true

참고: ID 풀(링크가 새 창에서 열림)과 같은 특정 기능을 사용하려면 ID 마이그레이션 및 ID 서비스 사용이 전제되어야 합니다. tsm 명령에 대한 자세한 내용은 features.IdentityMigrationBackgroundJob을 참조하십시오.

ID 마이그레이션 사용 안 함

Tableau Server 버전 2021.4.21, 2022.1.17, 2022.3.9 및 2023.1.5로 업그레이드한 경우 ID 마이그레이션을 사용하지 않도록 설정해야 할 수 있습니다. ID 마이그레이션을 사용하지 않도록 설정하면 Tableau Server는 ID 서비스를 사용하여 사용자 ID 정보를 저장하고 관리할 수 없습니다.

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

  2. 다음 명령을 실행합니다.

    tsm configuration set -k features.IdentityMigrationBackgroundJob -v false

참고: ID 풀(링크가 새 창에서 열림)과 같은 특정 기능을 사용하려면 ID 마이그레이션 및 ID 서비스 사용이 전제되어야 합니다.

ID 마이그레이션 완료 및 ID 서비스 구성

모든 사용자 충돌을 해결하고 마이그레이션 작업을 실행한 후에는 ID 서비스를 사용하도록 Tableau Server를 구성해야 ID 마이그레이션 프로세스가 완료됩니다.

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

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

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

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

    실패 0개가 표시되어 있는 ID 마이그레이션 요약입니다.

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

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

      마이그레이션 일정을 편집하기 위한 드롭다운 메뉴로, 사용 안 함 또는 지금 실행 옵션이 있습니다.

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

    100% 완료를 나타내는 ID 마이그레이션 진행률 표시줄입니다.

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

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

    • Tableau Server 버전 2022.1.8 이상, 2022.3.10 이상, 2023.1.6 이상의 경우:

      tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false
    • Tableau Server 버전 2022.1~2022.1.7, 2022.3~2022.3.9 또는 2023.1~2023.1.5의 경우:

      tsm authentication legacy-identity-mode disable

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

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

3단계: ID 풀을 사용하도록 설정

  1. 다음 명령을 실행합니다.

    tsm configuration set -k features.IdentityPools -v true
    tsm pending-changes apply

참고: 이러한 명령을 실행하면 Tableau Server가 다시 시작됩니다.