org.postgresql.util.PSQLException: Connection to localhost:8060 refused" 오류 발생

문제

Tableau Server 로그인이 실패하고, 내부 PostgreSQL 리포지토리에 연결하는 tabadmin 명령이 다음 오류를 반환합니다.

The driver encountered an unknown error: org.postgresql.util.PSQLException: Connection to localhost:8060 refused. Check that the hostname and port are correct and that the postmaster is accepting TCP/IP connections.(드라이버에서 알 수 없는 오류가 발생함: org.postgresql.util.PSQLException: localhost:8060에 대한 연결이 거부되었습니다. 호스트 이름과 포트가 정확하고 포스트 마스터가 TCP/IP 연결을 수락하는지 확인하십시오.)

환경

Tableau Server

해결 방법

명령 프롬프트에서 tabadmin status -v를 실행하여 Tableau Server의 현재 상태를 확인합니다. 자세한 내용은 tabadmin 명령: status를 참조하십시오.

tabadmin status에서 Tableau Server 리포지토리가 Stopped로 표시되는 경우:
1. 서비스 계정 사용자에게 필수적인 '서비스 계정' 서비스 계정 설정에 설명된 필수 사용 권한이 있는지 확인합니다.
2. Tableau Server를 다시 시작합니다.
tabadmin status에서 Tableau Server 리포지토리가 Setting up으로 표시되면 리포지토리의 연결 시간 초과를 늘립니다.

관리자로 명령 프롬프트를 열고 다음 명령을 실행합니다.
tabadmin stop tabadmin set clustercontroller.pgsql_connection_timeout_ms 6000 tabadmin config tabadmin start

값을 6000으로 설정한 후에도 문제가 지속되면 값을 최대 60000까지 다시 늘릴 수 있습니다. 최상의 결과를 얻으려면 가장 낮은 값을 사용하는 것이 좋습니다.
tabadmin status가 Running인 경우:

방화벽 또는 바이러스 차단 프로그램으로 인해 Tableau Server 리포지토리와의 통신이 차단되는 것일 수 있습니다. 자세한 내용은 인터넷 통신 구성을 참조하십시오.

원인

Tableau Server 리포지토리를 올바르게 시작할 수 없습니다. Tableau Server 리포지토리에 로그인 실패를 야기하는 모든 인증 정보가 포함되어 있습니다.

추가 정보

Tableau Server는 데이터베이스를 다시 시도하거나 다시 시작하기 전에 설정된 시간(기본적으로 60초) 동안 데이터베이스가 시작되기를 기다립니다.시간 초과는 다음 2개의 workgroup.yml 설정에 따라 결정됩니다.

clustercontroller.pgsql_connection_attempts (기본값=20)
clustercontroller.pgsql_connection_timeout_ms(기본값=3000)

이 2개 값에 따라 총 시간 초과 값이 결정됩니다. (60000밀리초 또는 60초).

clustercontroller.pgsql_connection_timeout_ms 값을 늘리면 clustercontroller가 장애 조치를 시도하기 전에 Postgres의 응답을 기다리는 시간이 늘어납니다. 이 설정의 값을 늘리면 Tableau Server의 성능이 저하될 수 있습니다. 예를 들어 장애 발생 시 Tableau Server가 응답하지 않는 시간이 늘어날 수 있습니다. Postgres가 실제로 중단된 경우 clustercontroller가 다시 시작하기 전에 대기하는 시간이 길어지기 때문입니다. 따라서 이 설정에는 가장 낮은 값을 사용하는 것이 좋습니다.
가장 좋은 해결 방법은 Postgres의 시작을 지연시키는 환경적 요인에 대해 조사하는 것입니다. 성능 조사에 대한 해결 시간이 길어지는 경우 빠른 해결 방법으로 clustercontroller.pgsql_connection_timeout_ms 설정을 수정하는 것이 유용할 수 있습니다.