Tableau Server 설치 및 업그레이드 문제 해결

이 항목의 제안에 따라 Tableau Server에서 발생하는 공통적인 문제를 해결하십시오. 상태 페이지에 표시되는 프로세스 상태에 기반하는 추가적인 문제 해결 단계에 대해서는 서버 프로세스 문제 해결을 참조하십시오.

 

일반적인 문제 해결 단계

많은 Tableau Server 문제는 몇 가지 기본적인 단계에 따라 해결할 수 있습니다.

  1. Tableau Server를 실행하는 각 컴퓨터에 충분한 디스크 공간이 있는지 확인합니다. 디스크 공간이 제한되면 Tableau Server 설치 또는 업그레이드가 실패하거나 실행에 문제가 발생할 수 있습니다.

  2. Tableau Server를 다시 시작합니다. 완전하게 시작되지 않는 프로세스 관련 문제는 Tableau Server를 통제되는 방식으로 다시 시작하여 해결할 수 있습니다. Tableau Server를 다시 시작하려면 tsm restart 명령을 사용합니다. 그러면 Tableau Server와 관련된 모든 프로세스가 중지된 다음 다시 시작됩니다.

  3. Tableau Server 인덱스를 다시 작성합니다. 인덱싱과 관련된 문제는 Tableau Server 인덱스를 다시 작성하여 해결할 수 있습니다. Tableau Server 인덱스를 다시 작성하려면 tsm maintenance reindex-search 명령을 사용합니다. 자세한 내용은 아래에서 Tableau Server 검색 및 찾아보기 인덱스 다시 작성을 참조하십시오.

  4. Tableau Server가 실행되는 컴퓨터를 다시 시작합니다. 데이터 원본 연결과 관련된 문제를 비롯한 일부 문제는 서버 컴퓨터를 다시 시작하는 것으로 해결될 수 있습니다.

일반적인 Tableau Server 설치 문제

설치 로그 위치

설치 로그는 설치를 실행하는 사용자 계정의 \Temp 디렉터리에 기록됩니다. 대부분의 경우 이 디렉터리는 C:\Users\<user>\AppData\Local\Temp에 있습니다.

로그온한 사용자의 \Temp 디렉터리 위치를 확인하려면 Windows 명령 프롬프트에서 ECHO %Temp% 명령을 실행합니다.

설치 프로그램에서 설치할 위치를 묻지 않음

Tableau Server를 처음 설치할 때 설치할 위치를 묻는 메시지가 나타납니다. 이 메시지가 표시되지 않는 경우 Tableau를 제거했더라도 이전 설치의 파일 또는 디렉터리가 남아 있는 것일 수 있습니다. Tableau 버전 2018.2 이상의 모든 흔적을 완전히 제거하기 위해 tableau-server-obliterate.cmd 스크립트를 실행한 다음 컴퓨터를 다시 시작하고 설치를 다시 시도해 보십시오. 이전 설치가 2018.2 이전 버전인 경우 설치 프로그램을 실행하기 전에 수동으로 모든 Tableau 관련 폴더를 삭제해야 합니다.

중요: 예를 들어 새 설치로 복원하기 위해 유지하려는 Tableau 백업(<file>.tsbak)을 만든 경우 해당 파일을 다른 컴퓨터의 안전한 위치에 복사하여 Tableau 컴퓨터를 정리할 때 파일이 제거되지 않도록 하십시오.

설치 프로그램이 Windows를 다시 시작하지 않음

Tableau Server를 설치할 때 설치 프로그램의 끝 부분에서 Windows를 다시 시작하라는 메시지가 나타날 수 있습니다. 일부 경우 다시 시작을 클릭해도 컴퓨터가 다시 시작되지 않습니다. 타사 구성 요소 설치 프로그램이 Windows 다시 시작을 요청하고 있을 때 이 문제가 발생할 수 있습니다.

다시 시작을 클릭해도 Windows가 다시 시작되지 않으면 Windows를 수동으로 다시 시작하여 설치를 완료하십시오.

TSM 설치가 실패하고 "초기화 실패" 오류가 나타남

Tableau Server를 설치하려고 하면 설치가 실패하고 다음 오류가 나타납니다.

Tableau server initialization failed
See install log at C:\ProgramData\Tableau\Tableau Server\logs

이 오류는 컴퓨터의 사용 권한 문제와 관련이 있을 수 있습니다. Windows에 로그인하여 Tableau를 설치하는 사용자에게는 C 드라이브, C:\Windows 및 C:\Windows\System32 폴더와 cmd.exe 파일에 대한 관리자 권한이 있어야 합니다. C 드라이브에 Tableau를 설치하지 않는 경우에도 마찬가지입니다.

자세한 내용은 Tableau 기술 자료(링크가 새 창에서 열림)를 참조하십시오.

TSM 초기화 화면이 표시되지 않음

Tableau Server를 설치하거나 업그레이드할 때 브라우저가 열리지만 아무것도 표시되지 않는 경우 신뢰할 수 있는 사이트 목록에 호스트 이름을 추가해야 할 수 있습니다. 또는 브라우저 캐시를 지우거나 다른 브라우저를 사용합니다. 자세한 내용은 Tableau 기술 자료(링크가 새 창에서 열림)를 참조하십시오.

설치 시도가 여러 번 실패함

Tableau Server를 설치하려는 시도가 실패한 경우 tableau-server-obliterate.cmd 스크립트를 실행하여 컴퓨터에서 Tableau를 정리하지 않는 한 후속 설치 시도가 실패할 수 있습니다.

중요: 64비트 명령 프롬프트에서 tableau-server-obliterate.cmd 스크립트를 실행해야 합니다. 예를 들어 C:\Windows\System32 폴더에서 cmd.exe를 실행합니다. 32비트 명령 프롬프트에서 이 스크립트를 실행하면 Tableau가 완전하게 제거되지 않으므로 후속 설치가 실패할 수 있습니다. 64비트 명령 프롬프트를 실행 중인지 확인하려면 명령 창에 echo %processor_architecture%를 입력하십시오. 결과에 "64"(예: AMD64)가 포함된 경우 명령 프롬프트는 64비트 프롬프트입니다. 결과에 "x86"이 포함된 경우 32비트 프롬프트를 실행하고 있는 것입니다. 자세한 내용은 사용 중인 Windows 버전에 해당하는 Microsoft 설명서를 참조하십시오.

설치가 실패하는 경우 컴퓨터는 후속 설치 시도가 실패하지만 이전 설치 시도와 직접적으로 관련이 없는 것으로 보이는 오류가 발생하는 상태가 될 수 있습니다.

이 문제를 해결하려면 tableau-server-obliterate.cmd 스크립트를 실행하여 이전 설치 시도의 남은 부분을 정리한 다음 컴퓨터를 다시 시작합니다. 자세한 내용은 tableau-server-obliterate 스크립트 실행을 참조하십시오.

중요: 예를 들어 새 설치로 복원하기 위해 유지하려는 Tableau 백업(<file>.tsbak)을 만든 경우 해당 파일을 다른 컴퓨터의 안전한 위치에 복사하여 Tableau 컴퓨터를 정리할 때 파일이 제거되지 않도록 하십시오.

obliterate 스크립트에서 “refresh-environment-variables.cmd”가 내부 또는 외부 명령으로 인식되지 않음 오류 발생

제어판을 사용하여 Tableau Server를 제거한 다음 tableau-server-obliterate.cmd 스크립트를 실행하여 컴퓨터에서 Tableau를 완전히 제거하는 경우 스크립트에서 refresh-environment-variables에 관한 오류가 생성될 수 있습니다. 이 오류는 obliterate 스크립트가 호출한 두 번째 스크립트가 temp 디렉터리로 이동하지 않았기 때문에 발생합니다. 이 오류는 무시해도 됩니다.

하드웨어 요구 사항으로 인한 설치 실패

설치에 사용하는 컴퓨터가 최소 하드웨어 요구 사항을 충족하지 못하는 경우 Tableau Server를 설치할 수 없습니다. 이 요구 사항은 Tableau Server를 설치하는 모든 컴퓨터에 적용됩니다. 최소 하드웨어 요구 사항에 대한 자세한 내용은 Tableau Server의 최소 하드웨어 요구 사항 및 권장 사항을 참조하십시오.

CPU 요구 사항으로 인한 설치 또는 업그레이드 실패

2020.4.0 버전부터 Tableau Server에는 SSE4.2 및 POPCNT 명령 집합을 지원하는 CPU가 필요합니다. 이러한 명령 집합을 지원하지 않는 CPU가 있는 컴퓨터에서는 Tableau Server 2020.4.0 이상을 설치하거나 업그레이드할 수 없습니다.

새 설치를 설치할 때 또는 기존 설치의 업그레이드를 준비할 때 다음 오류 메시지가 표시될 수 있습니다. 

Your computer’s processor doesn’t meet the minimum requirements that Tableau requires to install the software. If you are using a VM, make sure Processor compatibility mode is off.

SSE4.2 및 POPCNT 명령 집합은 10년 넘게 일반적으로 사용되어 왔고 최신 CPU가 이를 지원하지만 VM(가상 컴퓨터)에서 Tableau Server의 설치 또는 업그레이드를 시도할 때 프로세서 최소 요구 사항과 관련된 오류가 발생한다면 VM에 프로세서 호환성 모드가 사용되는 것일 수 있습니다. VM에서 Tableau를 성공적으로 설치하거나 업그레이드하려면 프로세서 호환성 모드가 해제되어 있는지 확인하십시오.

일반적인 Tableau Server 업그레이드 문제

업그레이드 로그 위치

기본적으로 업그레이드 로그 app-upgrade.logC:\ProgramData\Tableau\Tableau Server\logs에 작성됩니다.

오류: Active Directory 연결 설정 실패

Tableau 버전 2021.2부터 Tableau Server에서 비보안 Active Directory 연결이 허용되지 않습니다. Tableau Server의 현재 인스턴스에서 암호화되지 않은 채널을 사용하여 Active Directory와 통신하는 경우 업그레이드가 실패합니다.

이 문제를 해결하려면 아래의 단계를 수행합니다.

  • 실패한 보안 연결을 조사하고 해결합니다. Microsoft 항목 SSL을 통한 LDAP 연결 문제(영문)(링크가 새 창에서 열림)를 참조하십시오.
  • 업그레이드 전에 현재 버전의 Tableau Server에서 비보안 연결을 허용하려면 다음 명령을 실행합니다.

    tsm configuration set -k wgserver.domain.allow_insecure_connection -v true --force-keys

    tsm pending-changes apply

    업그레이드가 완료된 후에는 채널 보안을 적용한 다음 이 옵션을 false로 설정하는 것이 좋습니다.

    참고: Active Directory와의 통신 채널이 암호화되지 않으면 기본적으로(wgserver.domain.allow_insecure_connectionfalse로 설정된 경우) Active Directory 그룹 동기화가 실패합니다.

업그레이드 후 맵이 표시되지 않거나 불완전하게 표시됨

Tableau 버전 2019.2부터 맵에 대한 인터넷 액세스 요구 사항이 변경되었습니다. 버전 2019.1.x 이하에서 버전 2019.2.x 이상으로 업그레이드하는 경우 맵이 예상대로 표시되지 않으면 포트 443에서 mapsconfig.tableau.comapi.mapbox.com에 대한 액세스를 허용하도록 환경이 구성되었는지 확인합니다.

2019.1.x 이하 버전에서는 maps.tableausoftware.com에 대한 액세스가 필요했습니다.

인터넷 액세스 요구 사항에 대한 자세한 내용은 인터넷 통신을 참조하십시오.

업그레이드 스크립트 오류: “Tableau Server 버전 변경 유효성 검사가 실패했습니다.”

업그레이드할 때 이전 버전에 대한 scripts.<version_code> 디렉터리에서 upgrade-tsm 스크립트를 실행하면 다음 오류와 함께 업그레이드가 실패합니다.

Tableau Server Version change validation failed.
Tableau Server <version> is already installed.

이 오류가 표시되면 방금 설치한 버전의 scripts.<version_code> 디렉터리로 변경하고 거기에서 스크립트를 실행합니다.

다중 노드를 업그레이드하고 추가 노드를 초기화하면 실패하고 "Enter your credentials again" 오류가 나타남

Tableau Server를 업그레이드할 때 추가 노드를 초기화하려고 하면 다음 오류가 나타납니다.

Enter your credentials again. The credentials you enter must provide administrative access to the computer where you generated the configuration file.

이 오류는 노드가 초기 노드에 연결하거나 초기 노드와 통신할 수 없음을 나타냅니다. 이 오류는 여러 가지 이유로 발생할 수 있습니다.

  • 입력한 자격 증명이 유효하지 않거나 자격 증명을 잘못 입력했습니다. 자격 증명은 Tableau Server를 처음 설치한 컴퓨터에 대한 관리 권한이 있는 사용자의 자격 증명이어야 합니다. 부트스트랩 파일을 만든 사용자의 자격 증명을 사용할 필요는 없지만 그렇게 하면 유효한 자격 증명을 사용할 수 있습니다.

  • 추가하려는 컴퓨터의 로컬 방화벽이 초기 노드와의 통신을 허용하지 않습니다. 자세한 내용은 로컬 방화벽 구성을 참조하십시오.

디스크 공간 부족으로 인한 업그레이드 실패

디스크 공간이 부족하여 Tableau Server 설치 프로그램을 실행하고 업그레이드할 수 없는 경우 설치가 실패합니다. 필요한 디스크 공간의 양은 리포지토리 데이터베이스의 크기와 추출의 수 및 크기에 따라 달라집니다.

참고: TSM 이전 버전(2018.2.0 이전 버전)의 Tableau Server에서 업그레이드하는 경우 Tableau를 제거하면 데이터 디렉터리에 서버 백업 파일이 만들어집니다. 이 백업 파일은 확장명이 .tsbak이며 업그레이드에 필요합니다. 성공적으로 업그레이드한 이 파일을 삭제하여 공간을 확보할 수 있습니다(어떤 이유로든 이 파일이 필요한 경우 Tableau Server 설치의 일부가 아닌 컴퓨터에 복사본을 만들어야 함). 업그레이드를 완료하고 작동하는 것을 확인하기 전에는 이 파일을 삭제하지 마십시오.

디스크 공간을 확보하려면 다음을 수행합니다.

  1. tsm maintenance ziplogs 명령을 사용하여 로그 아카이브 스냅샷을 만듭니다.

    ziplogs 파일을 만든 후 Tableau Server 설치에 사용되지 않는 안전한 장소에 저장합니다.

  2. tsm maintenance cleanup 명령을 사용하여 불필요한 파일을 정리합니다. 자세한 내용은 불필요한 파일 제거를 참조하십시오.

RebuildSearchIndex 작업에서 업그레이드 실패

버전 2020.1.x부터 업그레이드의 마지막 단계는 검색 인덱스를 다시 작성하는 것입니다. 이 시점에는 모든 서비스가 업그레이드되었으므로 이 작업이 실패하면 tsm maintenance reset-searchserver 명령을 실행하여 검색 서버를 수동으로 재설정할 수 있습니다. obliterate를 실행하여 다시 시작할 필요가 없습니다.

오류는 다음과 같습니다.

An error occurred while rebuilding search index.

검색 서버를 재설정하려면:

  1. 초기 노드에서 관리자 권한으로 명령 프롬프트를 엽니다.

    업그레이드 스크립트는 새 버전에 대한 시스템 환경을 업데이트하므로 새 명령 프롬프트이어야 합니다.

  2. tsm maintenance reset-searchserver 명령을 사용하여 검색 인덱스를 다시 작성합니다.

2022.1 이상의 업그레이드 실패

Tableau Server 2022.1 이상을 업그레이드한 후 업그레이드 프로세스의 일부로 Tableau Server 백업을 복원할 때 다음 오류가 발생할 수 있습니다.

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

이 문제는 백업에 사용된 ID 스키마와 다른 ID 스키마가 Tableau Server 2022.1 이상에 사용되는 경우 발생합니다. 이 문제를 해결하려면 ID 마이그레이션 관련 문제 해결을 참조하십시오.

2020.4.0 이상에서 업그레이드 실패

버전 2020.4.0부터 체크포인트 업그레이드 기능을 사용하여 실패한 업그레이드를 다시 시도할 수 있습니다. 일반적으로 이 기능은 Tableau Server 로그 파일에 대해 잘 알고 검색할 수 있는 숙련된 서버 관리자 및 IT 전문가에게 가장 유용합니다. 그러나 이 기능을 사용하면 upgrade-tsm 스크립트를 다시 실행할 수 있으며 스크립트는 마지막으로 성공한 단계부터 실행되어 시간을 절약할 수 있기 때문에 실패한 모든 업그레이드에서 도움이 될 수 있습니다. 숙련된 사용자인 경우 디스크 공간 문제 또는 사용 권한 문제와 같은 문제를 식별하고 수정한 다음 업그레이드를 다시 실행할 수 있습니다.

버전 2020.4.0 이상으로 업그레이드하는 중에 업그레이드가 실패하는 경우 다음 단계를 통해 업그레이드를 완료할 수 있습니다.

  • upgrade-tsm 스크립트를 다시 실행합니다. 업그레이드 실패가 업그레이드 프로세스 중의 시간 초과로 인해 발생하는 경우가 있으며 스크립트를 다시 실행하면 업그레이드에서 간헐적이거나 가끔 발생하는 타이밍 문제가 해결되는 경우도 있습니다. 또한 안전하고 쉽게 수행할 수 있는 단계이기도 합니다. 스크립트를 다시 실행해도 아무 문제가 없으며 최악의 경우 업그레이드가 동일한 지점에서 다시 실패하지만 이전 단계를 거치지 않습니다.

    스크립트는 \scripts 디렉터리에 위치합니다.

    기본적으로 다음과 같습니다.

    C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\upgrade-tsm.cmd

    upgrade-tsm 스크립트를 다시 실행해도 Tableau Server 업그레이드가 성공하지 못하는 경우 Tableau Server 로그에 익숙하다면 다음과 같은 추가 문제 해결 단계를 수행할 수 있습니다.

  • 명령 창에서 스크립트 출력을 확인합니다(열려 있는 명령 창이 없는 경우 스크립트 다시 실행). 관리자 액세스 권한이 있는 명령 창에서 스크립트를 실행해야 합니다. 유용한 오류 메시지는 업그레이드 실패의 원인을 식별하는 데 도움이 되며 문제 해결 방법에 대한 몇 가지 아이디어를 제공할 수 있습니다.

  • app-upgrade.log 파일을 확인합니다. 명령줄에 표시되는 모든 오류는 app-upgrade.log 파일에도 나타나며 더 자세한 정보를 포함하는 경우가 많습니다.

  • tabadmincontroller.log 파일을 확인합니다. 위의 두 방법으로 쉽게 식별할 수 없는 업그레이드 문제는 작업의 문제로 인해 발생한 것일 수 있습니다. tabadmincontroller.log 파일에 문제 진단에 도움이 되는 보다 자세한 정보가 있을 수 있습니다.

    참고: 로그 파일 위치에 대한 자세한 내용은 Tableau Server 로그 및 로그 파일 위치를 참조하십시오.

백업/복원 파일 위치의 사용 권한 문제로 인한 업그레이드 실패

2022.1.0 이전의 Tableau Server 버전에서 백업/복원 파일의 파일 위치에 올바른 사용 권한이 없으면 백업 파일을 읽을 수 없거나 리포지토리를 복원할 수 없다는 내용의 오류와 함께 업그레이드 스크립트가 실패합니다.

버전 2022.1부터 업그레이드 스크립트는 업그레이드를 시작하기 전에 백업/복원 파일에 대한 파일 위치의 사용 권한을 확인하여 Tableau Server의 새 버전으로 업그레이드하는 중에 파일에 쓸 수 있고 위치에서 읽을 수 있는지 확인합니다.

백업/복원 파일 위치에 대해 필요한 사용 권한:

  • NetworkService: 읽기/쓰기/실행 권한
  • ‘서비스 계정’ 서비스 계정: 읽기/쓰기/실행 권한

오류는 다음과 유사합니다.

The runas user does not have permission to read the backup file: <backup/restore basefilepath>.

Repository restore failed.
An error occurred during installation.
An error occurred while restoring repository.

백업 및 복원을 위해 TSM에 사용되는 위치는 basefilepath.backuprestore 구성 키로 정의되며 올바른 사용 권한으로 설치 프로그램에 의해 설정된 기본값을 포함하지만 조직의 IT 규칙에 의해 영향을 받거나 사용자가 직접 만든 위치로 변경할 경우 영향을 받을 수 있습니다. 2022.1부터 제공되는 새 명령을 사용하면 백업/복원 파일 위치를 만든 직후에 해당 파일 위치에 대한 사용 권한을 확인하여 사용 권한 관련 문제를 방지할 수 있습니다. 이 명령에 대한 자세한 내용은 tsm maintenance validate-backup-basefilepath를 참조하십시오.

백업/복원 파일 경로에 대한 자세한 내용은 tsm 파일 경로를 참조하십시오.

업그레이드는 성공했지만 게시된 데이터 원본에 액세스할 수 없음

제한적이고 특정한 시나리오에서, Tableau Server를 버전 2021.3에서 2023.1 또는 2023.3의 초기 버전으로 업그레이드한 후 기존 게시된 데이터 원본에 연결하거나 새로 고치려고 하면 이 오류와 함께 실패합니다.

java.io.FileNotFoundException: Unable to fetch data from any other host. This may indicate a lost or invalid folder.

다음과 같은 경우 이 오류가 발생할 수 있습니다.

  1. 어느 시점에서든 2021.3.x 버전이었던 Tableau Server 설치를 업그레이드합니다(2021.3을 실행 중이거나 2021.3에서 2022.x 버전으로 업그레이드했을 수 있음).

  2. 해당 설치를 2023.1 또는 2023.3의 초기 버전으로 업그레이드합니다.

영향 없음

다음과 같은 상황에서는 문제가 없습니다.

  • 2021.3 이후의 다른 모든 업그레이드 경로

  • 2023.1 또는 2023.3으로의 다른 모든 업그레이드 경로

  • 2023.1 및 2023.3의 모든 신규 설치

자세한 정보

2024년 9월 16일을 기준으로 문제가 있는 모든 버전은 다운로드 사이트에서 제거되었습니다. 2023.1.x 또는 2023.3.x 버전으로 업그레이드해야 하는 경우, 유지 관리 버전 2023.1.16 이상 또는 2023.3.9 이상으로 업그레이드하십시오.

이 문제에 대한 자세한 내용은 알려진 문제(영문)(링크가 새 창에서 열림)를 참조하십시오.

일반 설정 가져오기 문제

설정 파일을 가져오면 누락된 서비스로 인해 "어떤 노드에도 없음" 유효성 검사 오류가 발생함

새 버전의 Tableau Server를 설치하고 이전 버전에서 설정 파일을 가져와 업그레이드하는 경우 tsm settings import 명령을 실행할 때 토폴로지 유효성 검사 오류가 발생할 수 있습니다.

이 문제는 이전 버전의 Tableau Server에서 설정 파일을 내보낸 후 새 버전으로 가져올 때 두 버전 사이에 새 서비스가 Tableau에 추가된 경우에 발생할 수 있습니다.

오류는 다음과 유사합니다(특정 서비스는 다를 수 있음).

c:\Users\mytableau\Desktop>tsm settings import -f 20183-export.json

Pending topology set.
There are 1 topology validation errors/warnings.

Service 'elasticserver' is not present on any node in the cluster.
Service: Elastic Server

이 문제를 해결하려면 모든 누락된 서비스를 Tableau Server에 추가하십시오.

  1. 유효성 검사 오류를 생성한 서비스의 경우 인스턴스 수 1을 사용하여 서비스를 추가합니다.

    예를 들어, 클러스터에 탄력적 서버가 없는 경우 검증 오류 메시지의 첫 줄에 나타나는 서비스 이름을 사용하여 프로세스 인스턴스 수를 1로 설정합니다.

    tsm topology set-process -n node1 -pr elasticserver -c 1

    오류가 발생한 각 서비스에 대해 이 단계를 반복합니다.

  2. 더 이상 경고나 오류가 없는 경우 보류 중인 변경 내용을 적용합니다.

    tsm pending-changes apply

설정을 성공적으로 가져와야 합니다.

설정 파일을 가져오면 "지정한 구성 값이 일치하지 않음" 오류가 발생함

새 버전의 Tableau Server를 설치하고 이전 버전에서 설정 파일을 가져오는 경우 tsm settings import 명령을 실행할 때 구성 유효성 검사 오류가 발생할 수 있습니다. 이러한 오류는 설정 파일에 Tableau에서 제거된 구성 값이 포함된 경우 발생할 수 있습니다.

오류는 다음과 유사합니다(구성 키는 다를 수 있음).

c:\Users\mytableau\Desktop>tsm settings import -f 20183-export.json
Configuration error: At least one configuration value you specified does not match a known configuration key. This applies to the following keys: '[features.TsmConfigFileService]'
Use this parameter to override unknown key error: --force-keys

이 문제를 해결하려면 가져오는 설정 파일을 편집하여 오류가 있는 구성 키에 대한 참조를 제거합니다.

  1. JSON 설정 파일을 복사하고 백업용 사본을 저장합니다.

  2. 일반 텍스트 편집기에서 JSON 설정 파일을 엽니다.

  3. 키가 포함된 전체 줄을 찾아 삭제합니다. 이 예에서는 features.TsmConfigFileService입니다.

    "configKeys" : {
      "config.version" : 19,
      "tabadmincontroller.port" : "8850",
      "endpoints.enabled" : false,
      "endpoints.health.enabled" : true,
      "features.TsmConfigFileService" : true,
      "tableau_projects.language" : "en",

    위의 예는 내보낸 설정 파일의 작은 섹션이며 파일의 전체 내용을 나타내지 않습니다.

  4. 설정 파일을 저장하고 다시 가져옵니다.

토폴로지 유효성 검사와 관련된 추가 오류가 발생할 수 있습니다. 이러한 오류를 해결하는 것에 대한 자세한 내용은 위에서 설정 파일을 가져오면 누락된 서비스로 인해 "어떤 노드에도 없음" 유효성 검사 오류가 발생함을 참조하십시오.

"조정 서비스 인스턴스를 직접 수정할 수 없습니다." 오류

이 오류는 두 가지 상황에서 발생할 수 있습니다.

  • Tableau Server 설정 파일을 조정 서비스 토폴로지가 설정 파일의 토폴로지와 다른 설치로 가져오는 경우
  • tsm topology set-process 명령을 사용하여 조정 서비스를 구성하려고 한 경우

설정 파일을 가져온 후 이 오류가 표시되는 경우:

Tableau Server 설정 파일에 대상 서버와 다른 조정 서비스 토폴로지가 있습니다. 새 버전을 설치하고 이전 버전에서 설정 파일을 가져와 Tableau Server를 업그레이드하는 경우 이러한 상황이 발생할 수 있습니다. 대상 서버에 조정 서비스 집합을 명시적으로 배포하지 않은 경우 초기 노드에 조정 서비스의 단일 인스턴스가 있습니다.

이 오류를 해결하려면 명령줄에서 불일치를 수정하거나 설정 가져오기 파일을 편집하면 됩니다. 보류 중인 모든 변경 사항을 무시하고 가져오기 파일의 설정과 일치하도록 대상 컴퓨터에 조정 서비스를 배포한 다음 설정 파일을 다시 가져올 수도 있습니다.

명령줄에서 불일치를 수정하려면 오류를 생성하는 각 노드에 대해 tsm topology set-process 명령을 사용하여 조정 서비스의 인스턴스 수를 되돌립니다.

  1. tsm pending-changes list 명령을 실행합니다. 출력에 변경된 노드가 표시됩니다.

  2. 조정 서비스 수가 변경된 하나 이상의 노드를 찾습니다.

    예를 들어 설정 파일에는 노드 2의 조정 서비스 인스턴스가 있지만 대상 시스템에 해당 노드의 조정 서비스 인스턴스가 없는 경우 노드 2의 개수는 설정 파일을 가져옴에 따라 0에서 1로 변경되어 표시됩니다.

    C:\Windows\system32>tsm pending-changes list
    Configuration
    There are no pending configuration changes.
    Topology
    node2:
                Coordination Service
                                    New Instance Count:1 
                                    Old Instance Count:0
  3. tsm topology set-process 명령을 사용하여 개수를 "이전 인스턴스" 값으로 다시 설정합니다.

    위 예의 경우 다음과 같이 합니다.

    tsm topology set-process -n node2 -c 0 -pr "Coordination Service"
  4. 변경된 조정 서비스 인스턴스 개수를 재설정한 후 보류 중인 변경 내용을 적용합니다.

    tsm pending-changes apply

조정 서비스에 대한 프로세스 수를 수동으로 설정할 때 오류가 표시되는 경우:

이 오류는 조정 서비스 관리를 위해 tsm topology 명령 대신 tsm topology set-process 명령을 사용하여 조정 서비스를 직접 업데이트하려는 경우에도 발생할 수 있습니다. 위와 같은 경우:

  1. tsm pending-changes discard 명령을 사용하여 보류 중인 변경 내용을 무시합니다.
  2. 조정 서비스를 구성하는 올바른 명령을 사용합니다. 자세한 내용은 조정 서비스 집합 배포를 참조하십시오.

TSM 연결 문제 해결

TSM에 연결할 수 없음

Tableau를 설치한 컴퓨터(예: https://localhost:8850 사용)에서 TSM에 연결할 수 있지만 다른 컴퓨터(https://<server-name>:8850 사용)에서 연결할 수 없는 경우 Tableau Server 컴퓨터에서 로컬 방화벽을 구성해야 할 수 있습니다.

2018.2 버전부터 방화벽을 수동으로 구성해야 합니다. 자세한 내용은 로컬 방화벽 구성을 참조하십시오.

Tableau Server 시작

Tableau Server가 완전하게 시작되었는지 여부를 확인할 수 없음

Tableau Server 시작 시 모든 구성 요소가 올바르게 시작되었는지 확인할 수 없다는 표시가 나타나는 경우가 있습니다. 이 경우 다음 메시지가 표시됩니다. "서비스의 모든 구성 요소가 올바르게 시작되었는지 여부를 확인할 수 없습니다."

시작한 후 이 메시지가 표시되는 경우 tsm status -v 명령을 사용하여 Tableau Server가 예상대로 실행되고 있는지 확인합니다.

상태가 실행 중("Status: RUNNING")으로 표시되는 경우 서버가 성공적으로 시작된 것이며 이 메시지를 무시할 수 있습니다. 상태가 DEGRADED 또는 STOPPED인 경우 다음 섹션에서 "Tableau Server가 시작되지 않음"을 참조하십시오.

Tableau Server가 시작되지 않음

Tableau Server가 시작되지 않거나 성능이 저하된 상태에서 실행되는 경우 명령 프롬프트에서 tsm restart 명령을 실행합니다. 그러면 실행되고 있는 모든 프로세스가 종료되고 Tableau Server가 다시 시작됩니다.

Tableau Server 검색 및 찾아보기 인덱스 다시 작성

검색 및 찾아보기 인덱스를 다시 작성하여 해결할 수 있는 문제

다음과 같은 증상이 있는 경우 인덱스를 다시 작성해야 합니다.

  • 사용자가 로그인하려고 하면 빈 사이트 목록이 나타남
  • 사용자가 프로젝트를 선택하려고 하면 빈 프로젝트 목록이 나타남
  • 콘텐츠(통합 문서, 뷰, 대시보드)가 누락됨
  • 예기치 않은 또는 잘못된 알림(예: 추출을 포함하지 않는 통합 문서에서 "새로 고침 실패" 알림)

이러한 동작이 나타나는 경우 tsm maintenance reset-searchserver 명령을 사용하여 검색 및 찾아보기 인덱스를 재설정하고 다시 작성합니다.

Tableau Server 활성화

Tableau Server 라이선스 활성화가 실패함

일부 경우 Tableau Server 라이선스 활성화가 실패할 수 있습니다. 이 경우 다음과 같은 매우 일반적인 오류 메시지가 나타날 수 있습니다.

  • An error has occurred

또는 다음과 같은 보다 구체적인 메시지가 나타날 수 있습니다.

  • Function flxActCommonLicSpcPopulateFromTS returned error 50030, 71521,
  • No license found for 'Tableau Server'

이 문제를 해결하려면 다음 솔루션을 나와 있는 순서대로 시도해 보십시오.

라이선스 서버에 액세스할 수 있는지 확인

Tableau 라이선스 서비스는 2018년 10월 6일에 새로운 데이터 센터로 이전되었습니다. 따라서 Tableau 제품 키 활성화, 갱신 또는 비활성화를 수행하려면 먼저 licensing.tableau.com에 액세스하기 위한 특별한 구성(예: 고정 IP 허용 목록)이 필요한 모든 환경을 업데이트해야 합니다.

액세스를 테스트하려면 브라우저에 라이선스 서버의 URL과 포트를 입력합니다.

https://licensing.tableau.com:443

및:

https://atr.licensing.tableau.com/_status/healthz

서버에 액세스할 수 있는 경우 첫 번째 서버에는 "테스트 성공" 메시지가 표시되고 두 번째 서버에는 "확인" 메시지가 표시됩니다.

Tableau Server는 라이선스 관리 용도로 다음과 같은 인터넷 위치에 연결해야 합니다.

  • atr.licensing.tableau.com:443

  • licensing.tableau.com:443

  • register.tableau.com:443

  • o.ss2.us

  • s.ss2.us

  • crt.rootca1.amazontrust.com

  • crt.sca1b.amazontrust.com

  • crt.sca0a.amazontrust.com

  • crt.sca1a.amazontrust.com

  • crt.sca2a.amazontrust.com

  • crt.sca3a.amazontrust.com

  • crt.sca4a.amazontrust.com

  • *.digicert.com

  • ocsp.*.amazontrust.com

  • crl.*.amazontrust.com

  • crt.rootg2.amazontrust.com

위 도메인에 대한 요청은 포트 80 또는 443을 사용할 수 있습니다. 포트 80은 인증서 유효성 검사(해지, 인증서 체인 등)에 사용됩니다. 포트 443은 SSL 연결에 사용됩니다.

인증서 해지 정보를 위해 ocsp.*.amazontrust.comcrl.*.amazontrust.com 도메인에 대한 요청은 Amazon에서 관리합니다. 자세한 내용은 ACM 인증서 특성(링크가 새 창에서 열림)을 참조하십시오. Tableau를 실행하는 컴퓨터의 인증서 신뢰 저장소에 Amazon 루트 인증서를 설치하는 것이 좋습니다. Amazon 루트 인증서를 다운로드하고 설치하려면 Amazon Trust Services 웹사이트에서 인증 기관(영문)(링크가 새 창에서 열림)을 참조하십시오.

날짜 및 시간 확인

초기 Tableau Server 컴퓨터의 날짜와 시간이 올바른지 확인합니다. 시계가 현재 날짜보다 이전 날짜로 설정되어 있으면 Tableau Server를 활성화할 수 없습니다.

FlexNet Licensing Service가 시작되었는지 확인

Tableau Server 컴퓨터의 날짜 및 시간이 올바르다면 초기 Tableau Server 컴퓨터에서 FlexNet Licensing Service가 실행되고 있는지 확인합니다.

  1. 초기 컴퓨터의 Windows 시작 메뉴에서 services.msc를 엽니다.

  2. 서비스 대화 상자에서 FlexNet Licensing Service 64(64비트) 또는 FlexNet Licensing Service(32비트)의 상태가 시작됨인지 확인합니다.

    FlexNet이 시작됨으로 나열되지 않은 경우 FlexNet Licensing Service를 마우스 오른쪽 단추로 클릭하고 시작을 선택합니다.

    시작 옵션이 회색으로 표시되면 서비스가 사용 안 함으로 설정된 것일 수 있습니다. 서비스를 사용하려면

    1. FlexNet Licensing Service를 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다.

    2. 시작 유형 드롭다운 목록에서 자동을 선택합니다.

    3. 시작 단추를 클릭한 다음 확인을 클릭합니다.

제품 키를 다시 읽게 만들기

  1. 초기 Tableau Server 컴퓨터에서 관리자로 로그인하고 명령 프롬프트를 엽니다.

  2. Tableau Server bin 디렉터리로 변경합니다. 기본적으로 다음과 같습니다.

    C:\Program Files\Tableau\Tableau Server\packages\bin.<version_code>

  3. 다음 명령을 입력합니다.

    tsm stop
    lmreread
    tsm start

신뢰할 수 있는 저장소의 콘텐츠를 Tableau 지원 팀에 보내기

FlexNet Licensing Services가 설치되어 실행되고 있지만 여전히 오류가 나타나는 경우 Tableau 제품 키 정보에 문제가 있을 수 있습니다. 이 문제를 해결하려면 다음 단계에 따라 신뢰할 수 있는 저장소의 키 정보가 포함된 파일을 만드십시오.

  1. 초기 Tableau Server 컴퓨터에서 관리자로 로그인하고 명령 프롬프트를 엽니다.

  2. 아래 명령을 입력합니다.

    serveractutil -view > <machine_name>-LicResults.txt

    그러면 현재 디렉터리에 <machine_name>-LicResults.txt 파일이 만들어집니다. 해당 위치에 대한 쓰기 권한이 없고 오류가 표시되는 경우 파일을 만들 수 있는 권한이 있는 위치로 변경하고 명령을 다시 실행하십시오.

  3. 앞서 만든 <machine_name>-LicResults.txt 파일을 포함시켜 Tableau 지원 팀(http://www.tableau.com/ko-kr/support/request(링크가 새 창에서 열림))에 문의합니다.

tabcmd 설치 문제

tabcmd를 별도로 설치

tabcmd는 Tableau Server를 설치할 때 초기 Tableau Server 노드에 자동으로 설치되지만 다른 컴퓨터에서 실행하려면 tabcmd를 별도로 다운로드하여 설치해야 합니다. 자세한 내용은 tabcmd 설치를 참조하십시오.

Linux의 tabcmd 설치 문제

tabcmd가 올바르게 실행되려면 Java 11이 필요합니다. RHEL 형식 시스템에서는 tabcmd를 설치할 때 종속 항목으로 설치됩니다. Debian 형식 시스템에서는 Java 11이 설치되어 있지 않은 경우 별도로 설치해야 합니다.

2022년 7월 기준으로 Debian 배포는 더 이상 지원되지 않습니다. 자세한 내용은 이 Tableau 커뮤니티 게시물(링크가 새 창에서 열림)을 참조하십시오.

Java가 설치되지 않음

tabcmd를 설치할 때 다음과 유사한 오류가 표시되면 Linux 컴퓨터에 Java 11이 설치되어 있는지 확인합니다.

Cannot find 'java' in your PATH. Install 'java' and make sure it is in your PATH to continue.

잘못된 버전의 Java가 설치됨

다음과 유사한 오류가 표시되면 Java 11이 설치되어 있는지 확인합니다.

Exception in thread "main" java.lang.UnsupportedClassVersionError: com/tableausoftware/tabcmd/Tabcmd : Unsupported major.minor version 52.0

또는

*** Uncaught exception NoClassDefFoundError: javax/xml/bind/JAXBException
*** See the logs for the stacktrace.
피드백을 제공해 주셔서 감사합니다!귀하의 피드백이 제출되었습니다. 감사합니다!