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

Windows 기반 Tableau Server는 이제 구성 유틸리티 및 tabadmin 명령줄 도구를 대체하는 TSM(Tableau 서비스 관리자)을 포함합니다. 이전 버전의 Tableau Server에 대한 도움말이 필요한 경우 Tableau 도움말 페이지를 참조하십시오.

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

일반적인 문제 해결 단계

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

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

  2. Tableau Server를 다시 시작합니다. 완전하게 시작되지 않는 인덱싱 및 프로세스 관련 문제는 Tableau Server를 통제되는 방식으로 다시 시작하여 해결할 수 있습니다. Tableau Server를 다시 시작하려면 tsm restart 명령을 사용합니다. 그러면 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 컴퓨터를 정리할 때 파일이 제거되지 않도록 하십시오.

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 기술 자료를 참조하십시오.

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 기술 자료를 참조하십시오.

설치 시도가 여러 번 실패함

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

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

이 문제를 해결하려면 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 기술 자료를 참조하십시오.

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

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

디스크 공간이 부족하여 Tableau Server 설치 프로그램을 실행하고 업그레이드할 수 없는 경우 설치가 실패합니다. 필요한 디스크 공간의 양은 리포지토리 데이터베이스의 크기와 추출의 수 및 크기에 따라 달라집니다. 버전 9.0으로 업그레이드하는 과정에서 설치 프로그램이 추출을 새 파일 저장소로 마이그레이션하며 이 작업에 공간이 필요합니다.

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

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

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

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

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 reindex-search 명령을 사용하여 검색 및 찾아보기 인덱스를 다시 작성합니다.

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 또는 licensing.tableausoftware.com에 액세스하기 위한 특별한 구성(예: 고정 IP 허용 목록)이 필요한 모든 환경을 업데이트해야 합니다.

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

  • licensing.tableau.com:443

  • atr.licensing.tableau.com:443

  • o.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

위 도메인에 대한 요청은 포트 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)에 문의합니다.

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