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 스크립트를 실행한 다음 컴퓨터를 다시 시작하고 설치를 다시 시도해 보십시오. 이전 설치가 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 기술 자료(Link opens in a new window)를 참조하십시오.

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

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

TSM 또는 Tableau Server에 로그인할 수 없음(자격 증명을 입력한 후 로그인 화면이 다시 표시됨)

Internet Explorer 또는 Edge를 사용하여 TSM 또는 Tableau Server 로그인 화면에 자격 증명을 입력하면 로그인되지 않고 페이지가 다시 표시되는 경우 URL의 호스트 이름 또는 도메인에 밑줄(_)이 포함되지 않는지 확인하십시오. Tableau Server 컴퓨터의 호스트 이름이나 도메인에 밑줄(_)이 포함되어 있으면 Internet Explorer 또는 Edge 브라우저가 쿠키를 설정하지 않기 때문에 로그인되지 않고 페이지가 다시 표시됩니다. 이 문제를 해결하려면 URL에 "localhost" 또는 컴퓨터의 IP 주소를 사용하십시오. 예: https://localhost:8850.

참고: Tableau Server ID 저장소로 AD를 사용하는 경우 로그인을 너무 많이 시도하면 Active Directory가 잠길 수 있습니다.

자세한 내용은 Tableau 기술 자료(Link opens in a new window)를 참조하십시오.

설치 시도가 여러 번 실패함

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

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

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

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

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

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

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

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

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

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

업그레이드 로그 위치

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

다중 노드를 업그레이드하고 추가 노드를 초기화하면 실패하고 "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를 처음 설치한 컴퓨터에 대한 관리 권한이 있는 사용자의 자격 증명이어야 합니다. 부트스트랩 파일을 만든 사용자의 자격 증명을 사용할 필요는 없지만 그렇게 하면 유효한 자격 증명을 사용할 수 있습니다.

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

업그레이드가 12%, 78% 또는 92%에서 중지됨

일부 경우 upgrade-tsm.cmd 스크립트가 멈추거나 중간에 실패할 수 있습니다. 이 문제의 원인은 스크립트가 중지되는 지점에 따라 다릅니다.

  • 스크립트가 12% 또는 78%에서 멈추면 SSL을 사용하는 중에 업그레이드하는 것과 관련된 알려진 문제(버전 2018.2.1에서 해결됨)가 원인일 수 있습니다. 자세한 내용은 Tableau 기술 자료(Link opens in a new window)를 참조하십시오.

  • 스크립트가 "인덱싱에 필요한 서비스를 사용하도록 설정"하는 단계를 실행하는 중에 92%에서 멈추면 Tableau Services를 시작하는 데 문제가 있을 수 있습니다. Tableau Server 서비스 관리자를 수동으로 다시 시작하면 이 문제를 해결할 수 있습니다. 자세한 내용은 Tableau 커뮤니티(Link opens in a new window)를 참조하십시오.

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

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

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

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

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

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

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

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

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

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

                                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. 설정 파일을 저장하고 다시 가져옵니다.

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

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는 라이선스 관리 용도로 다음과 같은 인터넷 위치에 연결해야 합니다.

  • licensing.tableau.com:443

  • atr.licensing.tableau.com:443

  • s.ss2.us

  • ocsp.rootg2.amazontrust.com

  • ocsp.rootca1.amazontrust.com

  • ocsp.sca1b.amazontrust.com

  • crt.sca1b.amazontrust.com

  • crt.rootca1.amazontrust.com

  • ocsp.sca0a.amazontrust.com

  • crt.sca0a.amazontrust.com

  • ocsp.sca1a.amazontrust.com

  • crt.sca1a.amazontrust.com

  • ocsp.sca2a.amazontrust.com

  • crt.sca2a.amazontrust.com

  • ocsp.sca3a.amazontrust.com

  • crt.sca3a.amazontrust.com

  • ocsp.sca4a.amazontrust.com

  • crt.sca4a.amazontrust.com

  • crl.rootca1.amazontrust.com

  • crl.rootg2.amazontrust.com

  • crl.sca1b.amazontrust.com

위 도메인에 대한 요청은 포트 80 또는 443을 사용할 수 있습니다.

날짜 및 시간 확인

초기 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(Link opens in a new window))에 문의합니다.

피드백을 제공해 주셔서 감사합니다! 피드백을 제출하는 동안 오류가 발생했습니다. 다시 시도하거나 메시지를 보내주십시오.