CentOS 8에서 Tableau 게이트웨이 프로세스 시작 오류 해결하기

Tableau(태블로)는 데이터를 쉽게 이해할 수 있도록 도와주는 시각화 소프트웨어이며, 리눅스 서버에서 Tableau 소프트웨어를 설치해서 운영할 때 발생한 에러를 살펴보고, 실습을 통해 쉽게 해결할 수 있습니다.

Tableau 게이트웨이 서비스 시작 오류 화면

Tableau(태블로)는 데이터를 쉽게 이해할 수 있도록 도와주는 시각화 소프트웨어이며, 리눅스 서버에서 Tableau 소프트웨어를 설치해서 운영할 때 발생한 에러를 살펴보고, 실습을 통해 쉽게 해결할 수 있습니다.
Tableau Software가 설치되어 있는 CentOS 7서버를 강제 재부팅 후 위 그림과 같은 게이트웨이 프로세스 시작 오류가 발생했습니다. 강제 재부팅으로 인해 httpd 프로세스가 정상적으로 종료되지 않아서 pid 파일이 남아 있어서 생긴 오류입니다. httpd.pid 파일을 삭제 후 서비스를 재시작하면 정상화됩니다.

실습 환경

• 운영 체제(OS) : CentOS 8
• 권한이 있는 root 및 사용자 계정으로 실행
• IP 설정 및 인터넷이 가능한 환경

Tableau 서비스 상태 확인하기

[tsm status -v]

[root@runit.cloud ~]# tsm status -v node1: localhost Status: DEGRADED 'Tableau Server Gateway 0' is in an error state. 'Tableau Server Application Server 0' is running. 'Tableau Server Interactive Microservice Container 0' is running. 'Relationship Query Microservice 0' is running. 'Content Model Microservice 0' is running. 'Tableau Server VizQL Server 0' is running. 'Tableau Server VizQL Server 1' is running. 'Tableau Server VizQL Server 2' is running. 'Tableau Server VizQL Server 3' is running. 'Tableau Server Cache Server 0' is running. 'Tableau Server Cache Server 1' is running. 'Tableau Server Coordination Service 0' is running. 'Tableau Server Cluster Controller 0' is running. 'Tableau Server Search And Browse 0' is running. 'Tableau Server Backgrounder 0' is running. 'Tableau Server Backgrounder 1' is running. 'Tableau Server Non-Interactive Microservice Container 0' is running. 'Relationship Ingestor Microservice 0' is running. 'External Content Provider Microservice 0' is running. 'Content Provider Microservice 0' is running. 'Flow Provider Microservice 0' is running. 'Tableau Server Data Server 0' is running. 'Tableau Server Data Server 1' is running. 'Tableau Server Data Engine 0' is running. 'Tableau Server File Store 0' is running. 'Tableau Server Repository 0' is running (Active Repository). 'Tableau Server Elastic Server 0' is running. 'Tableau Server Ask Data 0' is running. 'Tableau Server Administration Agent 0' is running. 'Tableau Server Administration Controller 0' is running. 'Tableau Server Service Manager 0' is running. 'Tableau Server License Manager 0' is running. 'Tableau Server Client File Service 0' is running. 'Tableau Server Database Maintenance 0' is stopped. 'Tableau Server Backup/Restore 0' is stopped. 'Tableau Server Site Import/Export 0' is stopped. 'Tableau Server SAML Service 0' is stopped.

Tableau 아파치 로그 확인하기

Apache 서버 로그 파일의 내용을 확인합니다.

[cat /var/opt/tableau/tableau_server/data/tabsvc/logs/httpd/startup.log]

[root@runit.cloud ~]# cat /var/opt/tableau/tableau_server/data/tabsvc/logs/httpd/startup.log httpd (pid 10266) already running httpd (pid 10266) already running httpd (pid 10266) already running httpd (pid 10266) already running httpd (pid 10266) already running httpd (pid 10266) already running httpd (pid 10266) already running httpd (pid 10266) already running httpd (pid 10266) already running httpd (pid 10266) already running

• [message]
• ##exclamation-triangle## Apache 서버 에러 로그 확인하기
• httpd 프로세스가 이미 실행 중이라는 로그를 확인 할 수 있습니다.
  httpd (pid 10266) already running

Tableau 아파치 pid 파일 삭제하기

Apache 서비스가 정상적으로 종료되지 않아서 pid 파일이 존재하고 있어서 발생한 에러이므로, 수동으로 rm 명령을 사용해서 pid 파일을 삭제합니다.

[rm -rf /var/opt/tableau/tableau_server/data/tabsvc/logs/httpd/httpd.pid]

Tableau 서비스 재시작하기

쉘에서 tsm restart 명령으로 태블로 서비스를 재시작합니다.

[tsm restart]

[root@runit.cloud ~]# tsm restart Stopping service... Job id is '30', timeout is 60 minutes. Service stopped successfully. Starting service... Service was started successfully.

Tableau 서비스 상태 확인하기

쉐렝서 tsm status 명령으로 태블로 서비스 상태를 확인합니다.

[tsm status -v]

[root@runit.cloud ~]# tsm status -v node1: localhost Status: RUNNING 'Tableau Server Gateway 0' is running. 'Tableau Server Application Server 0' is running. 'Tableau Server Interactive Microservice Container 0' is running. 'Relationship Query Microservice 0' is running. 'Content Model Microservice 0' is running. 'Tableau Server VizQL Server 0' is running. 'Tableau Server VizQL Server 1' is running. 'Tableau Server VizQL Server 2' is running. 'Tableau Server VizQL Server 3' is running. 'Tableau Server Cache Server 0' is running. 'Tableau Server Cache Server 1' is running. 'Tableau Server Coordination Service 0' is running. 'Tableau Server Cluster Controller 0' is running. 'Tableau Server Search And Browse 0' is running. 'Tableau Server Backgrounder 0' is running. 'Tableau Server Backgrounder 1' is running. 'Tableau Server Non-Interactive Microservice Container 0' is running. 'Relationship Ingestor Microservice 0' is running. 'External Content Provider Microservice 0' is running. 'Content Provider Microservice 0' is running. 'Flow Provider Microservice 0' is running. 'Tableau Server Data Server 0' is running. 'Tableau Server Data Server 1' is running. 'Tableau Server Data Engine 0' is running. 'Tableau Server File Store 0' is running. 'Tableau Server Repository 0' is running (Active Repository). 'Tableau Server Elastic Server 0' is running. 'Tableau Server Ask Data 0' is running. 'Tableau Server Administration Agent 0' is running. 'Tableau Server Administration Controller 0' is running. 'Tableau Server Service Manager 0' is running. 'Tableau Server License Manager 0' is running. 'Tableau Server Client File Service 0' is running. 'Tableau Server Database Maintenance 0' is stopped. 'Tableau Server Backup/Restore 0' is stopped. 'Tableau Server Site Import/Export 0' is stopped. 'Tableau Server SAML Service 0' is stopped.

Tableau 게이트웨이 프로세스 정상화

마무리

리눅스 서버에서 Tableau 게이트웨이 서비스 시작 장애의 원인을 확인하고, 쉽게 해결되었습니다.
리눅스 서버 강제 종료로 인해 발생한 문제였지만, 다른 장애 요인도 위와 같은 로그 분석을 통해 문제점을 찾고 해결할 수 있습니다.