Tableau Desktop 또는 Tableau Prep Builder 설치 문제 해결

Tableau Desktop 또는 Tableau Prep Builder를 설치할 때 항상 정확히 계획대로 설치되는 것은 아닙니다. 이 문서에서는 발생할 수 있는 문제를 해결하는 방법에 대한 정보와 제안 사항을 찾을 수 있습니다.

지원 기술 자료 검색

Tableau 기술 자료를 검색하면 질문에 대한 답을 빠르게 찾는 데 도움이 됩니다. 이 기술 자료에는 문제를 수정할 때 사용할 수 있는 문제 해결 기술이 포함되어 있고 해결된 알려진 문제가 설명되어 있으며 자주 묻는 질문에 대한 답이 나와 있습니다.

1. 문제 해결 문서를 검색하려면 기술 자료로 이동합니다.
2. 설명을 입력합니다.
3. 지원 페이지의 원본 탭에서 기술 자료를 선택합니다.

설치 복구(Windows만 해당)

설치 복구는 기존 설치 위에 동일한 버전의 새 빌드를 설치하는 프로세스입니다. 설치를 복구하면 변경된 파일을 덮어쓰고 누락된 파일을 다시 설치하여 소프트웨어를 작동 상태로 유지합니다.

설치 복구를 실행하려면:

1. 제어판 > 프로그램 > 프로그램 및 기능으로 이동합니다.
2. 목록에서 Tableau 프로그램을 선택합니다.
3. 제거/변경을 마우스 오른쪽 단추로 클릭합니다.
4. 설정 수정 창이 나타나면 복구를 클릭하고 복구 프로세스가 완료될 때까지 기다립니다.

설치 로그 만들기

Tableau 지원 팀과 협력하는 경우 설치 로그 파일을 제공해야 할 수 있습니다. Tableau Desktop 또는 Tableau Prep Builder는 설치 프로세스의 로그를 유지할 수 있습니다. Tableau 설치 프로그램에 대한 로깅은 Windows와 Mac에서 기본적으로 설정됩니다. 기본적으로 로그 파일은 Windows의 경우 사용자의 임시 폴더(%temp% 환경 변수에 지정된 위치)에 저장되고, Mac의 경우 /private/var/log에 저장됩니다. 문제가 발생할 경우 해결이 쉽도록 설치 프로세스에 대한 로그 파일을 유지하는 것이 좋습니다. 문제가 발생하면 로그 파일을 검토하고 Error 또는 Fail을 포함하는 항목을 검색하여 문제를 식별할 수 있습니다.

참고: DEBUG 수준에서 로깅하는 경우 Tableau가 시작될 때 전체 환경 정보가 수집됩니다. 즉, 환경 변수에 민감한 정보가 있는 경우 로그에 이 정보가 포함될 수 있습니다. 기본값인 INFO 수준의 로깅은 안전한 환경 정보만 수집합니다.

로그 파일의 위치 또는 이름을 변경하려는 경우 또는 로깅이 활성화되었는지 확실하지 않은 경우 다음 단계를 수행합니다. 설치를 시작하기 전에 로깅을 설정해야 합니다.

1. 설치 프로그램(.exe 파일)을 다운로드합니다.

2. 관리자로 명령 프롬프트를 엽니다.

3. 설치 프로그램 파일을 다운로드한 디렉터리로 이동합니다.

4. 다음 명령을 실행합니다.

   <installer> /log "<log_file_path_and_name>"

   installer를 Tableau 설치 프로그램 파일의 이름으로 바꾸고 log_file_path_and_name을 설치 로그 파일을 저장할 경로 및 파일 이름으로 바꿉니다.

   예:

   tableauDesktop-64bit-2021-3-1.exe /log "C:\Users\henryw\Desktop\install.txt".

Tableau Desktop 또는 Tableau Prep Builder를 활성화하거나 열 때 발생하는 FLEXnet 라이선스 오류 해결

Tableau 라이선스 서비스가 제품 키를 읽거나 액세스할 수 없는 경우 다음 오류 중 하나가 나타날 수 있습니다.

• 'TableauDesktop'용 라이선스를 찾을 수 없음

• 라이선스를 추가할 수 없음

• flxActCommonLicSpcPopulateFromTS 함수에서 50030, 71521, 0 오류가 반환됨

오류를 찾고 해결하려면 이 섹션의 단계를 순서대로 시도해 보십시오.

1. 시스템 날짜 및 시간 확인

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

2. FlexNet Licensing Service가 설치되어 있는지 확인

Tableau Desktop을 설치할 때 FlexNet Licensing Service가 자동으로 설치됩니다. Tableau를 실행하려면 이 서비스가 필요합니다. Mac에서 Tableau Desktop을 설치할 때 설치 프로그램에 FlexNet을 설치할 수 있는 사용 권한을 제공하기 위해 암호를 입력하라는 메시지가 표시될 수 있습니다. Windows에서는 FlexNet을 설치하는 사용 권한이 사용자 계정 설정에서 암시적으로 제공됩니다.

컴퓨터에 라이선스 서비스가 올바르게 설치되어 있는지 여부를 확인하려면 다음 단계를 수행하십시오.

Windows

1. 다음 폴더로 이동합니다.

   C:\Program Files\Common Files\Macrovision Shared\FlexNet Publisher

2. 폴더에 FNPLicensingService 응용 프로그램이 있는지 확인하십시오.

   FlexNet Licensing Service가 설치되어 있지 않은 경우 Tableau Desktop을 다시 설치하거나 사용자 계정의 사용 권한 설정을 확인합니다.

Mac

1. 터미널 응용 프로그램을 시작합니다.

2. 다음 명령을 입력하여 FlexNet 디렉터리의 내용을 나열합니다.

   ls '/Library/Application Support/FLEXnet Publisher/Service/11.16.2/FNPLicensingService'

   이 명령에서 아무 내용도 반환되지 않거나 No such file or directory 메시지가 반환되면 라이선스 서비스가 설치되지 않은 상태입니다. FlexNet Licensing Service를 수동으로 설치하는 방법에 대한 자세한 내용은 Tableau 기술 자료에서 Mac에서 활성화하는 동안 "FLEXNet 라이선스 서비스가 시스템에 없습니다" 오류를(링크가 새 창에서 열림) 참조하십시오.

3. FlexNet Licensing Service가 실행되고 있는지 확인

FlexNet Licensing Service가 설치된 것을 확인한 경우 라이선스 서비스가 실행되고 있는지 확인합니다. 실행되고 있지 않다면 수동으로 서비스를 시작해야 할 수 있습니다. 서비스를 시작하려면 운영 체제에 따라 아래 단계를 완료한 다음 Tableau Desktop을 다시 시작합니다.

Windows

1. Windows 시작 메뉴에서 services.msc를 엽니다.

2. 서비스 대화 상자에서 FlexNet Licensing Service의 상태가 시작됨인지 확인합니다.

   시작 옵션이 회색으로 나타나는 경우 목록에서 FlexNet Licensing Service를 마우스 오른쪽 단추로 클릭하고 속성을 선택합니다. 일반 탭에서 시작을 클릭한 다음 확인을 클릭하여 대화 상자를 닫습니다.

Mac

1. 터미널 응용 프로그램을 시작합니다.

2. FlexNet 디렉터리로 이동합니다.

   '/Applications/Tableau Desktop <Tableau version.app>/Contents/Frameworks/FlexNet/'custactutil -view

   예: '/Applications/Tableau Desktop 2021.3.app/Contents/Frameworks/FlexNet/'custactutil -view

3. FlexNet Licensing Service가 실행되고 있는지 확인합니다. Trust Flags = FULLY TRUSTED및 Status = ENABLED가 표시되어야 합니다.

   

4. 다음 명령을 사용하여 출력을 바탕 화면의 파일로 저장합니다.

   /Applications/Tableau\ Desktop\ <Tableau version.app>/Contents/Frameworks/FlexNet/custactutil -view > /users/$(whoami)/Desktop/licresults.txt

4. 신뢰할 수 있는 저장소 복구

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

참고: 이 단계를 수행하려면 bin 폴더에 위치한 고객 활성화 유틸리티에 액세스해야 합니다.

Windows

1. 명령 창을 열고 고객 활성화 유틸리티가 있는 디렉터리로 이동합니다. 예:

   cd "C:\Program Files\Tableau\Tableau <version>\bin"

   여기서, <version>은 설치한 Tableau 제품 버전입니다.

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

   custactutil –localrepair

3. Tableau를 시작합니다.

   복구가 실패하는 경우 다음 명령을 입력하여 LicResults.txt 파일을 만듭니다.

   custactutil -view >LicResults.txt

   앞서 만든 LicResults.txt 파일을 포함시켜 기술 지원(링크가 새 창에서 열림) 팀에 문의합니다.

Mac

1. 터미널 응용 프로그램을 시작합니다.

2. FlexNet 디렉터리로 이동합니다.

   cd /Applications/Tableau Desktop <version>.app>/Contents/Frameworks/Flexnet

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

   ./custactutil -localrepair

4. Tableau를 시작합니다.

복구가 실패하는 경우 다음 명령을 입력하여 LicResults.txt 파일을 만듭니다.

./custactutil -view > /users/<username>/licresults.txt

앞서 만든 LicResults.txt 파일을 포함시켜 기술 지원(링크가 새 창에서 열림) 팀에 문의합니다.

활성화 종료 코드를 사용하여 활성화 오류 문제 해결

Tableau를 시작하고 -activate 옵션을 포함시키면 활성화 프로세스가 ERRORLEVEL 환경 변수를 종료 코드로 설정하여 상태 정보를 반환합니다. 활성화가 성공한 경우 Tableau 응용 프로그램 종료 코드는 0입니다. 아래 표에 활성화 프로세스의 종료 코드와 해당 의미가 나와 있습니다.

활성화가 실패한 경우 Tableau 로그 파일에서도 오류 정보를 찾을 수 있습니다. 로그 파일은 현재 사용자의 Documents 폴더에 있는 My Tableau Repository 폴더의 Logs 폴더에 있습니다. 예:

/Users/<user>/Documents/My Tableau Repository/Logs

다음 예제 스크립트에서는 Windows용 Tableau Desktop을 활성화하고 잘못된 제품 키(536871018) 같은 특정 오류와 일반 라이선스 문제(536871012)를 확인하는 방법을 보여 줍니다.

@echo off
start/wait tableau.exe -activate  <product_key>
if %errorlevel% EQU 536871018 (ECHO TABLEAU_ERROR_LICENSING_INVALID_KEY)
if %errorlevel% EQU 536871012 (ECHO TABLEAU_ERROR_LICENCING_GENERAL)
if %errorlevel% EQU 0 (ECHO SUCCESS)

인터넷 오류 문제 해결

Tableau Desktop 및 Tableau Prep Builder에서 맵 뷰를 로드하고, 웹 페이지를 로드하고, 라이선스 요청을 처리하려면 특정 방화벽 및 프록시 설정이 필요합니다. 다음 오류 중 하나가 발생하는 경우 조직의 네트워크 관리자가 네트워크 웹 프록시 및 방화벽 구성 설정을 변경해야 합니다.

• 라이선스 프로세스에서 오프라인 활성화를 요청합니다.

• Tableau Desktop에서 맵 뷰가 빈 상태로 나타납니다.

• 대시보드의 웹 페이지를 로드하지 못합니다.

• 온라인 맵을 로드할 수 없습니다.

Tableau Desktop에 대한 인터넷 액세스를 구성하는 방법에 대한 자세한 내용은 필요한 주소, 프록시 및 포트를 참조하십시오.필요한 주소, 프록시 및 포트

라이선스 서버 액세스 문제 해결

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

이 사항이 문제가 되는지 확인하려면

1. 웹 브라우저에서 다음 주소로 이동합니다.

   • https://licensing.tableau.com

   • https://licensing.tableau.com

     “테스트 성공” 페이지가 표시되어야 합니다.

2. 성공 페이지가 표시되지 않으면 로컬 환경을 업데이트해야 라이선스 서비스에 액세스할 수 있습니다. 자세한 내용은 Tableau 커뮤니티(링크가 새 창에서 열림)를 참조하십시오.

라이선스 보고 문제 해결(Tableau Desktop만 해당)

Tableau Server 및 Tableau Desktop 인스턴스가 올바르게 구성된 경우 2개의 관리 뷰, 즉 Desktop 라이선스 사용량(링크가 새 창에서 열림) 및 Desktop 라이선스 만료에서(링크가 새 창에서 열림) Tableau Desktop 라이선스 사용량 정보를 볼 수 있습니다. 이러한 뷰가 표시되지 않거나 뷰에 데이터가 없는 경우 라이선스 보고에 문제가 있을 수 있습니다. 아래 섹션에 문제 해결에 도움이 되는 정보가 나옵니다.

Tableau Desktop 보고 구성 방법에 대한 자세한 내용은 Tableau Desktop 라이선스 사용량 관리을 참조하십시오.

관리 뷰를 사용할 수 없음

Desktop 라이선스 보고 관리 뷰는 Tableau Server 관리자만 사용할 수 있습니다. 서버 상태 페이지(사이트 메뉴에서 모든 사이트 관리 선택)에 Desktop 라이선스 사용량 및 Desktop 라이선스 만료 뷰에 대한 링크가 표시되지 않는 경우 다음을 확인합니다.

• Tableau Server 관리자로 로그인되어 있습니다.

• 관리자가 실행하는 Tableau Server 버전이 10.0 이상이고 사용자가 실행하는 Tableau Desktop 버전이 10.0 이상입니다. Tableau Desktop 라이선스 보고는 Tableau Server 및 Tableau Desktop 10.0 버전부터 제공됩니다.

• Tableau Server에 라이선스 보고 기능이 설정되어 있습니다. (이 기능은 기본적으로 해제되어 있습니다.) 자세한 내용은 이 가이드의 Tableau Desktop 라이선스 사용량 관리 문서에서 Tableau Server에 대한 라이선스 보고 설정의 절차를 참조하십시오.

관리 뷰에 예상한 콘텐츠가 포함되지 않음

예상한 데이터가 표시되지 않는 경우 이유는 다음 중 하나일 수 있습니다.

Tableau Desktop이 구성된 지 8시간이 지나지 않음

기본적으로 Tableau Desktop은 8시간 간격으로 라이선스 데이터를 보고합니다. Tableau Desktop 인스턴스에 보고를 구성한 후 8시간이 지나지 않은 경우 사용량 데이터가 관리 뷰에 표시되지 않을 수 있습니다. 사용자가 적절히 구성된 Tableau Desktop 인스턴스를 시작한 시점부터 Tableau Desktop은 실행되면서 시간을 계산하여 8시간마다 보고합니다.

8시간 간격에 도달했을 때 Tableau Desktop이 실행되고 있지 않으면 다음번에 Tableau Desktop을 시작할 때 보고가 전송됩니다. Tableau Desktop 인스턴스를 구성하고 8시간 이상 기다린 후에 Desktop 라이선스 보고 뷰에서 라이선스를 확인하십시오.

올바르게 구성된 Tableau Desktop 인스턴스의 경우 다음 이벤트 시 즉시 Tableau Server로 강제 보고됩니다.

• Tableau Desktop 10.0 이상 버전 활성화.

• Tableau Desktop 10.0 이상 버전 비활성화.

• Tableau Desktop 버전 10.0 이상의 라이선스에 대한 유지 관리 갱신

라이선스 보고를 구성한 후 Tableau Desktop을 다시 시작하지 않음

보고할 서버 주소를 사용하여 라이선스 보고를 구성할 때 Tableau Desktop이 실행되고 있었다면 Tableau Desktop을 다시 시작해야 합니다.

라이선스 보고를 구성한 후 Tableau Desktop을 열지 않음

보고를 구성한 이후로 Tableau Desktop을 열지 않았다면 관리 뷰에 사용량 데이터가 표시되지 않을 수 있습니다. 라이선스 정보는 Tableau Desktop이 실행되고 있는 경우에만 보고됩니다.

Tableau Desktop의 라이선스 보고가 잘못 구성됨

Tableau Desktop의 인스턴스가 보고할 Tableau Server의 주소로 올바르게 구성되었는지 확인합니다.

Tableau Desktop 컴퓨터의 로그 파일에서 인스턴스가 올바르게 구성되었는지 여부를 확인할 수 있습니다. 로그 파일 %Documents%\My Tableau Repository\Logs\log.txt를 찾습니다. "licUsageReport"를 검색하여 라이선스 보고와 관련된 항목을 확인합니다.

라이선스 보고에 대한 오류 메시지

다음 표에 라이선스 보고와 관련된 문제를 식별하는 데 도움이 되는 로그 메시지가 나열되어 있습니다.

기본 보고 간격 변경

Desktop 라이선스 보고를 구성하면 Tableau Desktop이 기본적으로 8시간마다 구성된 서버에 보고합니다. Tableau Desktop 컴퓨터에서 레지스트리 또는 .plist 파일을 수정하여 이 간격을 변경할 수 있습니다. 이 작업은 문제 해결 시 특히 유용합니다.

Windows

Windows 컴퓨터에서 Tableau Desktop이 서버에 보고하는 빈도를 변경하려면 레지스트리를 편집하여 ReportingServer 키에 문자열 값을 추가합니다.

• 경로: HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\ReportingServer

• 이름: 이름이 scheduleReportInterval인 문자열 값을 추가합니다.

• 데이터: Tableau Desktop이 서버로 전송하는 보고서 사이의 시간(초)입니다. 기본적으로 이 값은 8시간이며 값을 입력하지 않을 경우 기본값이 사용됩니다. 문제 해결에 필요한 경우 이 값을 늘리십시오. 그러나 간격이 짧아지면 네트워크 트래픽도 증가합니다.

  예를 들어 다음 이미지는 Tableau Desktop이 구성된 Tableau Server에 한 시간(3600초)마다 보고하도록 구성된 레지스트리를 보여 줍니다.

  

Mac

Tableau Desktop이 Mac용 서버로 보고하는 빈도를 변경하려면 /Library/Preferences의 com.tableau.ReportingServer.plist 파일을 편집하고 scheduleReportInterval 키를 추가합니다. Tableau Desktop에서 구성된 Tableau Server로 전송하는 보고서 사이의 시간(초)으로 이 값을 설정합니다. 다음 예제에서는 https://mytableau02:8010 및 http://mytableau의 두 서버로 한 시간(3600초)마다 정보를 보내도록 구성된 .plist 파일의 내용을 보여 줍니다.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
  <plist version="1.0">
    <dict>
      <key>Server</key>
      <string>https://mytableau02:8010,http://mytableau</string> 
      <key>scheduleReportInterval</key>
      <string>3600</string>
    </dict>
</plist>

메모리 오류 해결

컴퓨터에서 Tableau를 실행할 메모리가 부족한 경우 메모리 부족 오류가 표시됩니다. Tableau Desktop 또는 Tableau Prep Builder를 사용할 때 다음과 같은 요소가 메모리에 영향을 줄 수 있습니다.

• Tableau Desktop 버전

  • 64비트 Windows 운영 체제에 64비트 Tableau Desktop을 설치하는 경우 Tableau가 최대 8TB의 시스템 메모리에 액세스할 수 있습니다.

• 분석하는 데이터의 크기 및 형식. 예를 들어 많은 열과 수백만 개의 값 행이 포함된 대규모 크로스탭 또는 수많은 마크를 표시하는 뷰는 메모리를 빠르게 소모할 수 있습니다.

• 컴퓨터에서 실행되는 다른 응용 프로그램

• 컴퓨터의 운영 체제

가능한 해결 방법

메모리 부족 문제를 해결하려면 운영 체제 또는 Tableau 버전을 64비트 컴퓨터로 업그레이드합니다. 이렇게 하면 Tableau가 더 많은 양의 시스템 메모리에 액세스할 수 있습니다.

통합 문서의 데이터를 검토하고 뷰에 데이터를 표시할 때 집계하는 방식을 검토합니다. 데이터 검토를 위해 많은 양을 스크롤해야 할 수도 있는 많은 값 행을 표시하는 대신 요약 데이터를 표시하도록 하십시오. 뷰의 데이터를 더 큰 그림으로 나타내면 Tableau Desktop의 효율성이 개선되고 메모리 사용량이 감소하며 사용자가 뷰의 특정 영역으로 드릴다운하여 세부 정보를 볼 수 있습니다.

통합 문서 성능을 최적화하는 방법에 대한 자세한 내용은 Tableau 도움말에서 통합 문서 성능 최적화(링크가 새 창에서 열림)를 참조하십시오.

Dell 컴퓨터에서 파일을 열거나 저장할 때 문제 해결(Tableau Desktop만 해당)

Dell 컴퓨터에 Tableau Desktop을 설치하고 해당 컴퓨터에 이전 버전의 Dell 백업 및 복구(DBAR) 응용 프로그램이 설치되어 있다면 통합 문서를 열거나 저장할 때 또는 데이터 원본에 액세스할 때 Tableau가 예기치 않게 종료될 수 있습니다. 이것은 Dell 백업 및 복구 소프트웨어가 64비트 버전 Tableau Desktop의 열기 및 저장 작업에 방해하기 때문입니다. 이 문제를 해결하는 방법에 대한 자세한 내용은 Tableau 기술 자료에서 Dell 컴퓨터에서 파일 열기 또는 저장 도중 "Tableau 작동이 중지됨" 오류(링크가 새 창에서 열림) 문서를 참조하십시오.

유지 관리 업데이트 문제 해결(Tableau Desktop만 해당)

Tableau는 현재 지원되는 모든 버전의 Tableau Desktop에 대해 정기적으로 유지 관리 업데이트를 제공합니다. 다음 표에는 설치된 특정 버전의 Tableau Desktop에 유지 관리 업데이트가 설치되지 않는 이유가 나와 있습니다.