Linux 기반 Tableau Server 도움말

참고: Tableau Server에서 Tableau Cloud로 사이트를 마이그레이션하는 방법에 대한 자세한 내용은 Tableau Cloud 수동 마이그레이션 가이드(링크가 새 창에서 열림)를 참조하십시오.

다른 사이트의 정보를 가져와서(마이그레이션하여) 새 Tableau Server 사이트를 제공할 수 있습니다. 이 작업을 수행하려면 기존 사이트(원본 사이트) 정보를 파일로 내보냅니다. 그런 다음 해당 정보를 확인하고 대상 사이트로 가져와 단계를 완료합니다.

사이트 마이그레이션 옵션

다음과 같은 방법으로 사이트를 마이그레이션할 수 있습니다.

• 동일한 Tableau Server 인스턴스의 다른 사이트로 마이그레이션합니다.

• 별도의 Tableau Server 인스턴스에 있는 사이트로 마이그레이션합니다.

• Windows 기반의 Tableau Server에서 Linux 기반의 Tableau Server로 또는 그 반대로 마이그레이션합니다.

참고: Tableau Server 인스턴스 간에 사이트를 마이그레이션하는 경우 대상 사이트는 원본 사이트의 Tableau Server 버전보다 높거나 같은 Tableau Server 버전에 있어야 합니다. 원본 사이트와 대상 사이트 모두 지원되는 Tableau Server 버전에 있어야 합니다.

사이트 마이그레이션 제한

사이트 내보내기에서 보존되는 정보

• 생성되는 내보내기 파일은 통합 문서, 프로젝트, 데이터 원본 및 사용자를 보존합니다. 여기에는 콘텐츠에 대한 사용 권한 설정, 사용자 즐겨찾기 목록 및 사이트 할당량이 포함됩니다.

• 사용자의 사용자 지정 뷰는 보존되지만, 사이트 마이그레이션 유형에 따라 사용자 지정 뷰 URL이 변경되어 사용자의 뷰에 대한 책갈피가 손실될 수 있습니다.

• Tableau Server에서 다른 Tableau Server 사이트로 가져올 사이트를 내보내는 경우 구독 및 추출 새로 고침 일정이 보존됩니다.

사이트 내보내기에서 보존되지 않는 정보

• 사이트 관리 뷰에 나타나는 사용량 데이터는 보존되지 않습니다. 예를 들어 뷰 및 데이터 원본 수, 사용자 동작 및 성능 데이터가 여기에 포함됩니다.

• 사이트를 내보내는 동안 진행되는 백그라운더 작업은 내보내지 않으며 가져오기가 완료된 후 새 사이트에 표시되지 않습니다.

• 데이터 연결에 내장된 OAuth 액세스 토큰이 재설정됩니다. 이러한 데이터 원본의 경우 연결을 편집하여 기초 데이터에 대해 인증을 다시 수행해야 합니다.

• Prep 흐름과 흐름 일정은 포함되지 않습니다. 이러한 항목은 수동으로 마이그레이션해야 합니다.

• 사용자의 개인 공간에 저장된 콘텐츠는 포함되지 않습니다.

원본 및 대상 사이트 준비

사이트를 내보내려면 먼저 다음 검사 목록을 완성하여 두 환경을 모두 준비합니다. 이러한 지침 중 일부는 두 사이트가 모두 동일한 서버에 있는지, 아니면 별도의 서버에 있는지에 따라 달라집니다.

오래된 콘텐츠 삭제

원본 사이트에 새 사이트로 가져올 항목만 포함되어 있는지 확인합니다. 가장 좋은 방법은 새 사이트에 포함하지 않으려는 항목을 원본 사이트에서 제거하는 것입니다. 그렇지 않으면 이들 항목이 내보내기/가져오기에 포함되거나 수동으로 마이그레이션해야 합니다. 사용되지 않는 통합 문서, 데이터 원본 또는 프로젝트를 삭제합니다. 더 이상 사용하지 않는 Prep 흐름이나 흐름 일정이 있는 경우 이것도 삭제하십시오.

사용되지 않는 사용자 제거

모든 서버 사용자에게 라이선스가 부여되는지 확인하고 더 이상 사용하지 않는 계정을 제거합니다. 가져오기 프로세스 중에는 사용자를 제거할 수 없으므로 두 사이트가 동일한 서버 인스턴스에 있는 경우 원본 사이트에서 내보낸 모든 사용자가 대상 사이트로 가져와집니다.

대상 사이트 만들기 또는 식별

사이트 파일을 대상 Tableau Server 인스턴스에 이미 있는 사이트로 가져와야 합니다. 가져오기 프로세스에서는 가져오기 파일에 포함되지 않은 모든 항목을 대상 사이트에서 제거하므로 빈 사이트에 가져오는 것이 좋습니다. 자세한 내용은 사이트 추가 또는 편집을 참조하십시오.

사이트 ID 찾기

사이트를 내보내거나 가져오기 위해 사용하는 tsm 명령에는 사이트 ID를 사용하는 매개 변수가 필요합니다. 사이트 ID는 웹 브라우저에서 사이트에 로그인하면 나타나는 URL에서 얻을 수 있습니다.

서버에 사이트가 하나만 있는 경우 해당 사이트는 이름이 기본입니다. 기본 사이트에 로그인하는 경우 브라우저 URL은 다음과 같습니다.

https://server-name/#/projects

URL에 /site 매개 변수가 없으면 기본 사이트라는 의미입니다. 기본 사이트에 대한 사이트 ID는 "기본"입니다(따옴표 제외).

다중 사이트 Tableau Server 배포에서는 브라우저 URL에서 #/site/ 다음에 사이트 ID가 나타납니다. 예를 들어 사이트 ID가 finance인 사이트에서 뷰 페이지로 이동하면 다음과 같은 URL이 나타납니다.

https://localhost/#/site/finance/views

ID 저장소 확인

동일한 사용자 ID 저장소 유형을 사용하지 않는 사이트에서 내보내고 가져올 수 있지만 가져오는 데 사용되는 매핑 파일을 수정해야 합니다. 이 단계는 가져오기 프로세스를 기반으로 하며 3단계: 사이트 설정이 올바르게 매핑되었는지 확인에 설명되어 있습니다.

필요한 경우 대상 서버에서 사용자 만들기

사이트 가져오기 프로세스에서 사용자를 대상 사이트에 할당합니다. 원본 사이트가 대상 사이트가 아닌 Tableau Server 인스턴스에 있는 경우 먼저 대상 서버에서 사용자를 만들어야 가져오기를 수행할 수 있습니다. 두 사이트가 동일한 Tableau Server 인스턴스에 있는 경우 대상 사이트에서 기존 사용자를 액세스할 수 있으며 이 단계를 건너뛸 수 있습니다.

구독을 제공하도록 대상 서버 구성

가져오기에 구독이 포함되지만 구독을 제공하도록 서버를 구성해야 합니다. 자세한 내용은 구독을 위한 사이트 설정을 참조하십시오.

일정 확인

일정 페이지에는 추출 새로 고침 및 구독에 대한 기존 일정이 나열됩니다.

한 Tableau Server 사이트를 다른 사이트로 마이그레이션하는 경우 원본 사이트의 기본 일정에 할당된 새로 고침 및 구독은 대상 사이트의 동일한 일정에 매핑됩니다. 원본 사이트에 대상 사이트에 존재하지 않는 일정이 있으며 대상 사이트가 다른 Tableau Server 인스턴스에 있는 경우 원본 일정을 매핑할 대상 사이트에 일정을 만들어야 합니다. 일정이 예상대로 수행되도록 매핑 파일을 편집해야 합니다.

사용자 또는 일정 수가 적은 대상으로 가져오기 위한 팁

대상 사이트의 사용자 또는 일정 수가 원본 사이트보다 적은 경우 다대일 가져오기가 지원되지 않습니다. 이 문제를 해결하는 방법은 원본 및 대상 사이트가 동일한 Tableau Server 인스턴스에 있는지 여부에 따라 달라집니다.

다음 중에서 사이트 마이그레이션 활용 사례와 일치하는 방법을 사용할 수 있습니다.

• 내보내기 전에 원본 사이트에서 불필요한 사용자 또는 일정을 제거합니다. 두 사이트가 동일한 서버 인스턴스에 있는 경우 선호되는 옵션입니다.

• 가져오기를 시작하기 전에 대상 사이트에 누락된 사용자 또는 일정을 추가합니다. 대상 사이트가 다른 서버 인스턴스에 있는 경우 필요합니다.

• 가져오기 프로세스 도중에 대상 사이트에 누락된 사용자 또는 일정을 추가하고 수동으로 매핑 파일을 업데이트합니다. 사이트가 동일한 인스턴스에 있는 경우에만 선택 사항입니다.

• 가져오기 프로세스 도중에 사용자 또는 일정을 대상 사이트의 다른 사용자 및 일정에 수동으로 매핑합니다. 서버 간에서 사용자 이름이 다른 경우 필요합니다. 예를 들어 이름이 adavis@company.com인 내보낸 사용자가 대상 사이트에서 davisa로 정의되어 있을 수 있습니다.

사이트 마이그레이션

tsm sites 명령을 사용하여 사이트 마이그레이션 프로세스를 완료해야 합니다. 아래 단계에서는 원본 사이트에서 정보를 내보내고, 사이트 설정을 매핑하고, 매핑된 파일을 대상 사이트로 가져오는 과정을 안내합니다.

1단계: 사이트 내보내기

2단계: 가져오기 매핑 파일 생성

대상 사이트에 사용할 가져오기 파일을 생성하려면 1단계: 사이트 내보내기 단계를 완료할 때 만든 .zip 파일이 필요합니다.

참고: 내보낸 파일은 “다른 사용자”에게 기본적으로 읽기 권한을 제공하지 않습니다. 파일을 가져오는 사용자에 따라 파일에 대한 사용 권한을 조정하여 소유자 외의 사용자가 읽는 것을 허용해야 할 수 있습니다.

1. 대상 Tableau Server 컴퓨터에서 내보낸 .zip 파일을 Tableau Server가 가져오기에 사용할 파일을 찾는 디렉터리로 복사합니다. 예:

   /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports

2. 가져오기 프로세스는 새 사이트를 만들지 않으므로 Tableau Server에 대상 사이트가 이미 있는지 확인합니다. 자세한 내용은 원본 및 대상 사이트 준비를 참조하십시오.

3. 대상 Tableau Server 컴퓨터에서 다음 명령을 실행합니다(Tableau Server가 실행되고 있어야 함).

   tsm sites import --site-id <target-siteID> --file <export-file.zip>

   이 명령은 원본 사이트 설정이 대상 사이트에 매핑되는 방식을 보여 주는 일련의 .csv 파일을 생성합니다. 이 문서의 다음 섹션에 설명되어 있는 단계에서 이러한 매핑을 확인하고 필요한 경우 수정합니다.

   기본적으로 이러한 .csv 파일은 siteimports 아래에 생성되는 mappings 디렉터리에 생성됩니다. 예:

   /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports/working/import_<id>_<date-time>/mappings

   자세한 내용은 tsm 파일 경로를 참조하십시오.

3단계: 사이트 설정이 올바르게 매핑되었는지 확인

이전 섹션에서 생성한 .csv 파일은 가져오기가 완료될 때 원본 사이트의 리소스가 대상 사이트에 할당되는 방식을 기술합니다. 파일에서 Tableau Server가 매핑하지 못해 사용자가 편집해야 하는 항목은 일련의 물음표(???)로 표시됩니다. 먼저 이 물음표를 대상 사이트의 유효한 할당으로 대체해야 가져오기 프로세스를 완료할 수 있습니다.

중요: 사용자, 일정 및 게시된 콘텐츠 리소스 매핑에 몇 가지 요구 사항이 적용되며, 특히 원본 사이트와 대상 사이트가 별도의 Tableau Server 인스턴스에 있는 경우 이 요구 사항이 중요합니다. 자세한 내용은 이 문서 앞부분에서 원본 및 대상 사이트 준비를 참조하십시오.

매핑 파일을 확인하려면

1. tsm sites import 명령으로 생성된 .csv 맵 파일에 들어 있는 디렉터리로 이동합니다. 기본적으로 다음과 같습니다.

   /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports/working/import_<id>_<date-time>/mappings

2. 선호하는 텍스트 편집기를 사용하여 mappings 디렉터리에서 .csv 파일 중 하나를 열고 다음을 수행합니다.

   1. 매핑이 올바른지 확인합니다.

   2. 항목이 일련의 물음표(???)로 표시되는 경우 유효한 값으로 바꿉니다.

      이러한 파일 각각의 설정에 대한 설명은 이 문서 뒷부분에 있는 매핑 파일 콘텐츠 참조의 표를 참조하십시오.

   3. 변경 내용을 저장하고 CSV 파일의 서식을 유지합니다.

   나머지 .csv 파일에 대해 이 프로세스를 반복합니다.

4단계: 올바르게 매핑된 파일을 대상 사이트로 가져오기

.csv 파일에서 사이트 매핑을 확인했으면 설정을 새 사이트로 가져와 마이그레이션 프로세스를 완료할 수 있습니다.

1. 대상 Tableau Server 컴퓨터에서 다음 명령을 실행합니다.

   tsm sites import-verified --import-job-dir <import-id-directory> --site-id <target-siteID>

   예:

   tsm sites import-verified --import-job-dir /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports/working/import_ff00_20180102022014457
--site-id new-site

2. 성공 메시지가 나타나면 새 사이트에 로그인하여 모든 가져오기가 예상대로 수행되었는지 확인합니다.

참고: tsm sites import 및 tsm sites export 명령에서 오류가 발생할 경우 사이트가 잠긴 상태로 유지될 수 있습니다. 사이트 잠금을 해제하려면 tsm sites unlock 명령을 사용합니다.

매핑 파일 콘텐츠 참조

다음 표에는 tsm site import 명령 실행 시 만들어지는 각 매핑 파일의 열이 나와 있습니다.

CSV 파일 이름: mappingsDomainMapperForGroups

CSV 파일 이름: mappingsScheduleMapper

CSV 파일 이름: mappingsSiteMapper

CSV 파일 이름: mappingsSystemUserNameMapper

CSV 파일 이름: MappingsScheduleRecurrenceMapperWithAutoCreation

이 파일은 업데이트할 필요가 없습니다.