Linux 기반 Tableau Server 도움말

설치 로그 app-install.log는 /var/opt/tableau/tableau_server/logs에 위치합니다.

업그레이드 로그 app-upgrade.log는 /var/opt/tableau/tableau_server/logs에 위치합니다.

설치 시도가 여러 번 실패함

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

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

Enabling and starting all services
+ services=(appzookeeper* tabadmincontroller* tabsvc* licenseservice* fnplicenseservice* tabadminagent* clientfileservice*)
+ systemctl_user enable appzookeeper_0.service 'tabadmincontroller*' 'tabsvc*' 'licenseservice*' fnplicenseservice_0.service 'tabadminagent*' 'clientfileservice*'
++ id -ru a_tabadminpoc
+ local unprivileged_uid=222954
+ su -l a_tabadminpoc -c 'XDG_RUNTIME_DIR=/run/user/222954 systemctl --user enable appzookeeper_0.service tabadmincontroller* tabsvc* licenseservice* fnplicenseservice_0.service tabadminagent* clientfileservice*'
Failed to execute operation: No such file or directory

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

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

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

설치에 사용하는 컴퓨터가 최소 하드웨어 요구 사항을 충족하지 못하는 경우 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 버전 2019.2부터 맵에 대한 인터넷 액세스 요구 사항이 변경되었습니다. 버전 2019.1.x 이하에서 버전 2019.2.x 이상으로 업그레이드하는 경우 맵이 예상대로 표시되지 않으면 포트 443에서 mapsconfig.tableau.com 및 api.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 설치 프로그램을 실행하고 업그레이드할 수 없는 경우 설치가 실패합니다. 필요한 디스크 공간의 양은 리포지토리 데이터베이스의 크기와 추출의 수 및 크기에 따라 달라집니다.

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

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 디렉터리에 위치합니다.

  opt/tableau/tableau_server/packages/scripts.<version_code>/upgrade-tsm

  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의 새 버전으로 업그레이드하는 중에 파일에 쓸 수 있고 위치에서 읽을 수 있는지 확인합니다.

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

The tableau 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 이상으로 업그레이드하십시오.

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

일반 설정 가져오기 문제

>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

>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

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

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

날짜 및 시간 확인

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

제품 키를 다시 읽게 만들기

1. 초기 Tableau Server 컴퓨터에서 sudo 액세스 권한이 있는 사용자로 로그온합니다.

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

   /opt/tableau/tableau_server/packages/bin.<version_code>/

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

   tsm stop
   
   ./lmreread
   tsm start

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

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

1. 초기 Tableau Server 컴퓨터에서 sudo 액세스 권한이 있는 사용자로 로그온합니다.

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는 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.