기술 자료

TSM 명령 실행 시 "Could not connect to TSM Controller at 'https://servername:8850("'https://servername:8850'에서 TSM 컨트롤러에 연결할 수 없습니다.)" 오류 발생


게시 날짜: 28 Nov 2018
마지막 수정 날짜: 29 Feb 2024

문제

TSM 명령을 실행하면 다음 오류가 발생합니다. 

Could not connect to TSM Controller at 'https://servername:8850'('https://servername:8850'에서 TSM 컨트롤러에 연결할 수 없습니다.)

몇 가지 기본적인 확인 단계를 수행하여 다른 가능한 원인이 아닌 TSM 인증서 만료로 인해 이 오류가 발생했는지 확인할 수 있습니다.

1단계:
다음 명령(Linux 예제)을 실행하여 Tableau Server 포털이 정상적으로 실행 중이지만 TSM WebUI에 액세스할 수 없는지 확인합니다.
# sudo su -l tableau
# systemctl status tabadmincontroller_0 
이러한 명령은 서비스가 활성 상태이고 실행 중이지만 TSM에 연결할 수 없음을 나타냅니다.

2단계:

포트 8850에 텔넷 연결하여 작동 중인지 확인합니다.
# telnet localhost 8850
::1를 시도하는 중...
localhost에 연결되었습니다.
이스케이프 문자는 '^]'입니다.

인증서가 잘못된 경우 ~/.tableau/tsm/tsm.log에 다음 오류 메시지가 표시됩니다.
 
2019-03-15 15:09:57 main : ERROR com.tableausoftware.tabadmin.ServerApi - Exception sending request
org.springframework.web.client.ResourceAccessException: I/O error on POST request for "https://localhost.localdomain:8850/api/0.5/login": 
sun.security.validator.ValidatorException: PKIX path validation failed: java.security.cert.CertPathValidatorException: 
validity check failed; nested exception is javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: 
PKIX path validation failed: java.security.cert.CertPathValidatorException: validity check failed
TSM 로그에 위 오류 메시지의 접미사로 'validity check failed(유효성 검사 실패)' 대신 'timestamp check failed(타임스탬프 검사 실패)'가 표시될 수 있습니다.
       

환경

  • Tableau Server 

해결 방법

TSM은 설치 시 생성되는 자체 서명 SSL 인증서를 사용합니다.  이전 버전에서는 새 SSL 인증서를 재생성하려면 전체 Tableau Server를 다시 설치해야 했습니다.  현재 버전에서는 tabadmin 컨트롤러를 다시 설치하여 새 인증서를 생성할 수 있습니다. 

현재 릴리스에서는 --trust-admin-controller-cert 플래그를 tsm 및 upgrade-tsm 스크립트에 추가했습니다.  이 해상도를 적용하려면 동일한 버전의 제품군을 설치해야 합니다.  예를 들어 Tableau 서버 2021.4.1을 사용하는 경우 Tableau 서버 2021.4.1+를 설치해야 합니다.

옵션 1
명령줄에서 TSM에 액세스할 수 없고 이전 버전에서 새 플래그가 있는 현재 버전으로 업그레이드하려면 다음 작업을 수행합니다.

다음과 같이 --trust-admin-controller-cert 플래그를 사용하여 해당 버전의 TSM에 액세스합니다.  

/opt/tableau/tableau_server/packages/bin.<version_code>/tsm stop
--trust-admin-controller-cert

여기서, <version code>는 새로 설치된 Tableau Server 빌드 버전 번호이며, 해당 Tableau Server 버전에 대한 릴리스 페이지에서 찾을 수 있습니다.

예를 들어 tsm data-access repository-access enable --repository-username readonly --repository-password <PASSWORD> --trust-admin-controller-cert를 실행하십시오.
(참고: 원격 컴퓨터에서 TSM CLI를 연결하는 경우 TSM Administration Controller를 실행하는 Tableau Server에 처음 연결할 때 Tableau 설치 CA 인증서를 신뢰하라는 메시지가 표시됩니다. CA 인증서를 신뢰한다고 선택할 수 있습니다. 이러한 경우 인증서가 만료될 때까지 해당 컴퓨터에서 다시 메시지가 표시되지 않습니다(기본값의 경우 3년 유지됨). 또는 --trust-admin-controller-cert 플래그를 사용하여 TSM 명령을 실행하여 일회성 신뢰로 연결할 수 있습니다.)

옵션 2
지원되는 현재 버전에서 tabadmin 컨트롤러를 다시 설치하여 다음을 포함한 새 인증서를 생성할 수 있습니다.

  1. 명령 프롬프트를 관리자로 엽니다(명령 프롬프트를 마우스 오른쪽 버튼으로 클릭하고 "관리자로 실행" 선택).
  2. "tsm stop --trust-admin-controller-cert"를 실행하여 명령 프롬프트에서 Tableau Server를 중지합니다.
  3. C:\ProgramData\Tableau\Tableau Server\data\tabsvc\services\tabadmincontroller_<version>으로 이동하세요. (참고: 기본 경로가 아닌 경로에 설치된 경우 경로가 다를 수 있습니다.)
  4. "uninstall.cmd"를 실행합니다. (종료 코드 0은(는) 작업 성공을 의미함)
  5. "Install.cmd"를 실행합니다. (종료 코드 0은(는) 작업 성공을 의미함)
  6. - Tableau Computer를 다시 시작합니다.
  7. TSM 웹 UI 또는 TSM Start를 사용하여 Tableau Server를 시작합니다.
옵션 3
사용 중인 적절한 운영 체제에 해당하는 Tableau 온라인 도움말의 지침에 따라 Tableau Server를 업그레이드하고 upgrade-tsm 스크립트를 실행할 경우 --trust-admin-controller-cert 플래그를 사용합니다.

 

 

원인

이전 버전의 Tableau Server는 1년 후에 만료되는 TSM 컨트롤러 인증서를 사용했습니다.  현재 이 인증서는 최대 3년 동안 지속되며 업그레이드 시 새 인증서가 설치됩니다.

추가 정보

TSM 컨트롤러 SSL 인증서의 만료 날짜를 확인하려면 Tableau Server를 실행하는 컴퓨터의 터미널에서 다음 명령을 입력합니다(Linux 지침).

 #openssl s_client -connect servername:8850
 # echo | openssl s_client -connect servername:8850  2>/dev/null | openssl x509 -noout -dates




 
이 문서로 문제가 해결되었습니까?