---
schema_version: "1"
id: b217ae9d707a3ed62fb6f38faa5a0ba8453dc7d67ba2866fe1db8fa010a75313
title: ID 마이그레이션 관리
collection: tableau
version: next
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/next/ko-kr/server/identity_migration_manage.md
canonical_url: https://help.tableau.com/v0.0/server/ko-kr/identity_migration_manage.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 9729f7be59c18f25d953c936eb0581f2932528e2e8ec019bae9d605746314d05
description: Monitor and manage identity migration jobs and settings on Tableau Server.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# ID 마이그레이션 관리

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

![ID 마이그레이션 개요 페이지입니다.](/tableau/next/ko-kr/server/ko-kr/Img/id_mig_main.png)

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

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

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

## ID 마이그레이션 작업 관리

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

ID 충돌 해결

마이그레이션 중에 발생할 수 있는 ID 충돌을 검토하려면 [ID 마이그레이션 충돌 해결](https://help.tableau.com/v0.0/server/ko-kr/identity_migration_conflicts.htm)을 참조하십시오.

일별 마이그레이션 작업 일정 변경

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

1. 마이그레이션 개요 머리글 옆에서 일정 편집 단추를 클릭합니다.
2. 일정 편집 대화 상자에서 작업 실행 시기 및 빈도를 변경합니다.
    
    **참고:** 이 대화 상자에서 우선 순위 및 실행 옵션은 무시해도 됩니다.
    
    ![마이그레이션 빈도를 편집하기 위한 옵션이 있는 일정 편집 대화 상자입니다.](/tableau/next/ko-kr/server/ko-kr/Img/id_mig_schedule.png)
3. 마치면 업데이트를 클릭합니다.

마이그레이션 작업 시작

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

1. 아무 탭에서 한 명 이상의 사용자를 선택합니다.
2. 동작 메뉴에서 필요한 작업에 따라 마이그레이션 다시 시도 또는 확인을 선택합니다.
    
    ![마이그레이션 다시 시도 또는 승인 옵션이 있는 ID 마이그레이션 동작 드롭다운 메뉴입니다.](/tableau/next/ko-kr/server/ko-kr/Img/id_mig_actions.png)
3. 마이그레이션 개요 머리글 옆에서 일정 편집 드롭다운 화살표를 클릭합니다.
4. 지금 실행을 선택합니다.
    
    ![마이그레이션 일정을 편집하기 위한 드롭다운 메뉴로, 지금 실행 옵션이 하이라이트되어 있습니다.](/tableau/next/ko-kr/server/ko-kr/Img/id_mig_runnow.png)

ID 마이그레이션 일시 중지

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

1. 마이그레이션 개요 머리글 옆에서 일정 편집 드롭다운 화살표를 클릭합니다.
2. 사용 안 함을 선택합니다.

ID 마이그레이션 다시 시작

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

1. 마이그레이션 개요 머리글 옆에서 일정 편집 드롭다운 화살표를 클릭합니다.
2. 사용을 선택합니다.

## ID 마이그레이션 설정 변경

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

### 마이그레이션 설정

<table style="width: 90%;mc-table-style: url('Resources/TableStyles/Basic-Border-Light.css');margin-left: 0;margin-right: auto;" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;text-align: center;">유형</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;text-align: center;">tsm 명령</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1" style="font-weight: bold;text-align: center;">기본값</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1"><b>절차</b></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">작업 일정</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">해당 없음</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">오전 3:00, 완료될 때까지 매일</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">ID 마이그레이션 페이지에서 구성 가능함. 위의 <a href="#schedule" class="xref">일별 마이그레이션 작업 일정 변경</a> 참조.</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">사용자 ID 요청/초(속도)</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tsm authentication identity-migration configure -–rate</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">최대 5</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1" rowspan="2"><p>필요한 경우 <code>tsm authentication identity-migration</code> 명령을 사용하여 아래의 단계에 따라 위에 나열된 마이그레이션 설정을 변경할 수 있습니다.</p><ol><li value="1">클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다.</li><li value="2"><p><a href="https://help.tableau.com/v0.0/server/ko-kr/cli_authentication_tsm.htm#tsm_identity_mig_config"><code>tsm authentication identity-migration</code></a>에 설명된 명령을 하나 또는 둘 다 실행합니다.</p><p>예를 들어 개별 작업 런타임 및 속도를 기본값에서 변경하려면 다음 명령을 실행하면 됩니다.</p><p><code>tsm authentication identity-migration configure --job-run-time 180 --rate 3</code></p></li></ol></td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">개별 작업 런타임</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1"><code>tsm authentication identity-migration configure -–job-run-time</code></td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">120분</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><a name="enable"></a>ID 마이그레이션 사용</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>tsm configuration set -k features.IdentityMigrationBackgroundJob</code></td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1"><code>false</code></td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1"><p>ID 마이그레이션을 사용하도록 설정하면 Tableau Server는 ID 서비스를 사용하여 사용자 ID 정보를 저장하고 관리할 수 있습니다.</p><ol><li value="1"><p>클러스터의 초기 노드(TSM이 설치된 노드)에서 관리자로 명령 프롬프트를 엽니다.</p></li><li value="2"><p>다음 명령을 실행합니다.</p><p><code>tsm configuration set -k features.IdentityMigrationBackgroundJob -v true</code></p></li></ol><p><b>참고:</b> <a href="https://help.tableau.com/v0.0/server/ko-kr/identity_pools.htm" target="_blank">ID 풀</a>과 같은 특정 기능을 사용하려면 ID 마이그레이션 및 ID 서비스 사용이 전제되어야 합니다. tsm 명령에 대한 자세한 내용은 <a href="https://help.tableau.com/v0.0/server/ko-kr/cli_configuration-set_tsm.htm#identity_migration" class="xref">features.IdentityMigrationBackgroundJob</a>을 참조하십시오.</p></td></tr></tbody></table>

### 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 풀](https://help.tableau.com/v0.0/server/ko-kr/identity_pools.htm)과 같은 특정 기능을 사용하려면 ID 마이그레이션 및 ID 서비스 사용이 전제되어야 합니다.

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

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

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

1. Tableau Server에 관리자로 로그인합니다.
2. 왼쪽 탐색 패널에서 사용자(또는 다중 사이트 Tableau Server의 경우 모든 사이트 > 사용자)를 선택한 다음 ID 마이그레이션 페이지를 클릭하여 마이그레이션이 시작되었는지 확인합니다.
    
    Tableau Server의 사용자 페이지에 있는 전용 ID 마이그레이션 페이지를 사용하여 진행률을 모니터링하고 관리할 수 있습니다. 자세한 내용은 [ID 마이그레이션 관리](#)를 참조하십시오.
3. [ID 마이그레이션 충돌 해결](https://help.tableau.com/v0.0/server/ko-kr/identity_migration_conflicts.htm)에 설명된 대로 모든 ID 충돌을 해결하거나 승인하여 아래의 이미지와 같이 모든 실패 탭에 '0'이 표시되도록 합니다.
    
    ![실패 0개가 표시되어 있는 ID 마이그레이션 요약입니다.](/tableau/next/ko-kr/server/ko-kr/Img/id_mig_failures_acknowledge.png)
4. 다음 작업 중 _하나_를 수행합니다.
    
    - ID 마이그레이션 작업을 지금 실행하려면 마이그레이션 개요 제목 옆에서 일정 편집 드롭다운 화살표를 클릭한 다음 지금 실행을 선택합니다.
        
        ![마이그레이션 일정을 편집하기 위한 드롭다운 메뉴로, 사용 안 함 또는 지금 실행 옵션이 있습니다.](/tableau/next/ko-kr/server/ko-kr/Img/id_mig_overview_runnow.png)
    - 또는 다음 예약 시간에 마이그레이션 작업이 실행될 때까지 기다려도 됩니다.
5. 마이그레이션이 완료되면 ID 마이그레이션 페이지에서 마이그레이션 개요에 100% 완료가 표시되는지 확인합니다.
    
    ![100% 완료를 나타내는 ID 마이그레이션 진행률 표시줄입니다.](/tableau/next/ko-kr/server/ko-kr/Img/id_mig_complete.png)

### 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.enabled`가 `true`이거나 `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가 다시 시작됩니다.