--- schema_version: "1" id: 51e37fff168b7f35be7ceaa75816adea841c6daafc5041643886d7bd0d0388fe title: TSM 설치 및 초기화 collection: tableau version: current locale: ko-kr portal_url: https://docs.salesforce.com/tableau/current/ko-kr/server-linux/setup.md canonical_url: https://help.tableau.com/current/server-linux/ko-kr/setup.htm source_site: help.tableau.com content_type: documentation content_hash: 66a3b2cfd5cd813903ee64090fc9772c7e8ba0256e87ebebac3cc9849a9d6dbb description: Install Tableau Services Manager (TSM) and Tableau Server. --- [주요 콘텐츠로 건너뛰기](#main-content) # TSM 설치 및 초기화 이 항목에서는 Tableau Server를 설치하고 TSM(Tableau 서비스 관리자)을 초기화하는 과정을 안내합니다. **중요:** 프로덕션 환경에 Tableau Server의 베타 버전을 설치하지 마십시오. 또한 베타 버전의 백업을 사용하여 프로덕션 Tableau Server 설치를 복원해서는 안 됩니다. ## 필수 요건 계속 진행하기 전에 [설치 전 수행할 작업...](https://help.tableau.com/current/server-linux/ko-kr/requ.htm) 항목을 검토하십시오. ### 선택적 초기화 매개 변수 검토 TSM을 설치하고 초기화하기 전에 초기화 작업의 일부로 선택적으로 설정할 수 있는 매개 변수를 검토하는 것이 중요합니다. `initialize-tsm`은 한 번만 실행할 수 있으므로 조직에서 필요로 하는 모든 옵션을 사용하여 실행해야 합니다. 기본값이 아닌 시스템 사용자 및 그룹과 같은 일부 옵션은 초기화 작업의 일부로만 구성할 수 있습니다. 정방향 프록시 및 동적 포트 설정과 같은 다른 구성은 초기화를 실행한 후에 수동으로 설정할 수 있지만 이렇게 하려면 훨씬 더 많은 작업이 필요합니다. 선택적 매개 변수의 전체 목록을 보려면 [initialize-tsm 스크립트의 도움말 출력](https://help.tableau.com/current/server-linux/ko-kr/initialize_tsm-h.htm)을 참조하십시오. 선택적 초기화 매개 변수가 사용되는 몇 가지 일반적인 시나리오는 다음과 같습니다. - 정방향 프록시 서버를 사용하도록 Tableau Server 구성 설치 중에 Tableau Server를 구성하려면 이 항목의 나중에 나오는 [선택 사항: 일반적인 initalize-tsm 매개 변수](#optional_parameters)를 참조하십시오. 설치 후에 Tableau Server를 구성할 수도 있습니다. 이 경우 [Linux에서 정방향 프록시를 사용하도록 Tableau Server 구성](https://help.tableau.com/current/server-linux/ko-kr/proxy.htm#Configur3)을 참조하십시오. - 동적 포트 매핑 지정 기본적으로 Tableau Server에 필요한 대부분의 포트는 미리 정의된 포트 범위에서 동적으로 할당(매핑)됩니다. 포트 할당은 설치 중에 각 서비스 또는 프로세스에 대해 수행됩니다. 포트 매핑을 수정하려는 경우 설치 중에 구성하는 것이 좋습니다. [initialize-tsm을 사용하여 포트 재매핑 제어](https://help.tableau.com/current/server-linux/ko-kr/ports.htm#PortsAtInitializeTSM)을 참조하십시오. - 기본값이 아닌 시스템 사용자 또는 그룹 지정. 이 구성 변경은 설치 중에만 수행할 수 있습니다. [시스템 사용자 및 그룹](https://help.tableau.com/current/server-linux/ko-kr/plan_identity_store.htm#System)을 참조하십시오. - 기본값이 아닌 데이터 디렉터리 지정 이 구성 변경은 설치 중에만 수행할 수 있습니다. [데이터 디렉터리](https://help.tableau.com/current/server-linux/ko-kr/requ.htm#Data)를 참조하십시오. - FIPS 모드로 실행하도록 Tableau Server를 구성합니다. 설치 중에 Tableau Server를 구성하려면 이 항목의 나중에 나오는 [선택 사항: 일반적인 initalize-tsm 매개 변수](#optional_parameters)를 참조하십시오. 초기화 시에만 FIPS 모드로 실행되도록 Tableau Server를 구성할 수 있습니다. [Linux 기반 Tableau Server의 FIPS 규정 준수](https://help.tableau.com/current/server-linux/ko-kr/fips-compliance_tsm.htm#Configur3)를 참조하십시오. 보안 모범 사례로, TSM 포트(기본값은 `8850`)를 인터넷에 노출하지 않는 것이 좋습니다. ## Tableau Server 설치 배포판의 패키지 관리자를 사용하여 Tableau Server 제품을 설치한 다음 스크립트를 실행하여 TSM을 초기화합니다. 스크립트는 설치된 패키지에 포함되어 있습니다. **중요**: TSM을 시작한 후에는 서버의 호스트 이름을 변경해서는 안 됩니다. 예를 들어 cloud-init 패키지를 사용하여 가상 컴퓨터를 초기화하고 해당 가상 컴퓨터에 Tableau Server를 설치할 경우 이 문제가 발생할 수 있습니다. ### Tableau Server 패키지 설치 기본적으로 Tableau Server는 `/opt` 디렉터리에 설치됩니다. RHEL과 같은 배포판에서는 다른 설치 위치를 지정할 수 있습니다. 1. Tableau Server를 설치하려는 컴퓨터에 `sudo` 액세스 권한이 있는 사용자로 로그온합니다. **참고:** 문제가 발생하지 않도록 특수 문자(예: ASCII 이외 문자, "+", "-")를 포함하지 않는 사용자 계정을 사용하는 것이 좋습니다. 이 경우 사용자 환경의 구성 방식에 따라 Tableau Server를 완전히 설치하지 못하는 등의 문제가 발생할 수 있습니다. 2. [Tableau Server 다운로드 및 릴리스 정보](https://www.tableau.com/ko-kr/support/releases/server/) 페이지에서 `.rpm` 또는 `.deb` 설치 프로그램 패키지를 다운로드합니다. 3. `.rpm` 또는 `.deb` 패키지를 복사한 디렉터리로 이동합니다. 4. 패키지 관리자를 사용하여 Tableau Server 패키지를 설치합니다. 기존 버전과 동일한 위치에 새 버전을 설치해야 합니다. 설치 위치는 모든 노드에서 동일해야 합니다. 심볼릭 링크를 사용하는 위치 또는 NFS(네트워크 파일 시스템) 볼륨의 디렉터리에는 설치하지 마십시오. - CentOS를 포함하여 RHEL 유사 배포에서는 기본 위치가 아닌 위치에 Tableau를 설치할 수 있습니다. - **기본 위치** - 기본 위치(`/opt/tableau/tableau_server`)에 설치하려면 다음을 실행합니다. 여기서, ``은 주-부-유지 관리 형식입니다(예: `2025-3-5`). `sudo yum update` `sudo yum install tableau-server-.x86_64.rpm` - **기본이 아닌 위치** - 기본이 아닌 위치에 설치하려면 `rpm -i`를 사용해야 합니다. 또한 모든 종속 패키지를 설치해야 합니다. 아래의 참고 사항을 참조하십시오. 다음 명령을 실행합니다. sudo rpm -i --prefix /preferred/install/path tableau-server.rpm **참고:** `yum` 을 사용하여 Tableau Server를 설치하는 경우 모든 종속 패키지가 자동으로 다운로드되고 설치됩니다. 이는 Tableau 설치의 기본 설정 방법입니다. 기본이 아닌 위치에 설치하려는 경우 또는 조직에서 `yum` 사용을 허용하지 않고 `rpm -i`를 사용하여 설치해야 하는 경우 모든 종속 패키지도 개별적으로 설치해야 합니다. 종속 패키지 설치에 대한 자세한 내용은 [Linux를 실행하는 Air-Gapped 환경에 Tableau Server 설치](https://help.tableau.com/current/server-linux/ko-kr/install_air_gapped.htm#InstallAirgap)를 참조하십시오. - Ubuntu에서 다음 명령을 실행합니다. 여기서, ``은 주-부-유지 관리 형식입니다(예: `2019-2-5`). sudo apt-get update sudo apt-get upgrade sudo apt-get -y install gdebi-core sudo gdebi -n tableau-server-\_amd64.deb ### TSM 초기화 Tableau를 기본 위치에 설치하는지 여부에 관계없이 데이터(추출 및 추출 메타데이터) 저장소에 대한 별도 위치를 지정할 수 있습니다. 1. `scripts` 디렉터리로 이동합니다. cd /opt/tableau/tableau\_server/packages/scripts./ 2. 다음 스크립트를 실행하여 TSM을 시작합니다. `sudo ./initialize-tsm --accepteula --activation-service --` `initialize-tsm` 스크립트의 유일한 필수 매개 변수는 `--accepteula`입니다. Tableau Server EULA(최종 사용자 사용권 계약)에 동의하려면 이 매개 변수를 포함시켜야 합니다. EULA는 다음 위치에서 확인할 수 있습니다. `/opt/tableau/tableau_server/packages/docs./Commercial_EULA.txt` 하지만 스크립트를 실행하기 전에 다음과 같은 공통 매개 변수를 검토하십시오. 선택 사항: 일반적인 initalize-tsm 매개 변수 `initialize-tsm`을 실행할 때 설정할 수 있는 많은 매개 변수(_플래그_라고도 함)가 있습니다. 아래에 공통 플래그가 나와 있습니다. 전체 목록을 보려면 `sudo ./initialize-tsm -h` 명령을 실행하거나 [initialize-tsm 스크립트의 도움말 출력](https://help.tableau.com/current/server-linux/ko-kr/initialize_tsm-h.htm)을 참조하십시오. - `--activation-service` 옵션을 사용하여 Tableau ATR(Tableau Authorization to Run) 서비스를 사용하여 Tableau Server를 활성화합니다. Tableau Server 2021.4 이상부터 이 옵션은 Microsoft Windows 기반 Tableau Server, LInux 기반 Tableau Server 및 컨테이너의 Tableau Server에 대한 기본값입니다. Server ATR은 업그레이드가 아닌 새 설치에만 적용됩니다. 이 옵션은 클라우드 기반 또는 가상 환경에 적합하지만 Tableau Server 복사본을 온라인으로 활성화할 수 있는 모든 사용자에게 제공됩니다. 제품 활성화에 ATR을 선택하는 것은 영구적인 선택이며 나중에 실행 취소할 수 없습니다. 자세한 내용은 [ATR(Authorization to Run) 서비스를 사용하여 Tableau Server 활성화](https://help.tableau.com/current/server-linux/ko-kr/atr_service.htm)를 참조하십시오. Tableau Server를 활성화하는 데 Server ATR을 사용하지 않으려면 `--no-activation-service` 옵션을 사용합니다. - `-a` 플래그를 사용하여 이 스크립트를 실행하는 사용자 대신 tsmadmin 및 tableau 그룹에 추가할 사용자를 지정할 수 있습니다. 루트 계정으로 설치하는 경우 `-a` 플래그를 지정해야 합니다. - `--unprivileged-user` 플래그를 사용하여 다른 서비스 계정을 설정할 수 있습니다. 기본적으로 `tableau`라는 새 사용자가 생성됩니다. 이 계정은 대부분의 Tableau 프로세스가 실행되는 권한 없는 서비스 계정입니다. `tableau` 사용자 계정이 컴퓨터에 이미 있는 경우에만 다른 사용자를 만드는 것이 좋습니다. - `-d` 플래그를 사용하여 Tableau Server가 추출, 추출 관련 정보 등을 저장하는 "데이터 디렉터리"의 위치를 기본이 아닌 위치로 지정할 수 있습니다. 기본적으로 Tableau Server는 이 디렉터리에 대해 다음 위치를 사용합니다. `/var/opt/tableau/tableau_server` 이 플래그를 설정하면 `intialize-tsm` 스크립트가 지정된 디렉터리에 대한 사용 권한을 만들고 적용합니다. 기본 디렉터리 경로 변경에 적용되는 중요한 제한 사항이 있습니다. [데이터 디렉터리](https://help.tableau.com/current/server-linux/ko-kr/requ.htm#Data)를 참조하십시오. - 설치 중에 Tableau Server에 정방향 프록시 솔루션을 구성하는 것이 좋습니다. 이 작업을 수행하려면 정방향 프록시 서버를 지정하기 위한 `--http_proxy` 및/또는 `--https_proxy` 플래그를 포함합니다. 다음 예와 같이 URL과 함께 포트를 지정합니다. `--http_proxy=http://proxy.exampe.lan:80/` `--https_proxy=http://1.2.3.4:443/` `http`를 사용하여 `https_proxy` 환경 변수의 URL을 지정해야 합니다. `https_proxy` 환경 변수의 값으로 `https` 프로토콜을 지정하지 마십시오. 정방향 프록시를 우회하도록 Tableau Server를 구성하려면 `--no_proxy` 플래그를 포함시킵니다. 또한 이 프록시 구성에 예외를 추가하여 로컬 Tableau Server 클러스터(지금 하나 있고 나중에 하나를 추가하려는 경우) 모든 내부 통신이 프록시 서버로 라우팅되지 않도록 해야 합니다. 예를 들면 다음과 같습니다. `--no_proxy=localhost,127.0.0.1,localaddress,.localdomain.com`. - TSM 및 Tableau Server 프로세스의 포트 할당을 수동으로 관리하려면 `initialize-tsm`과 함께 하나 이상의 포트 관련 스위치를 사용해야 할 수 있습니다. 자세한 내용은 [initialize-tsm을 사용하여 포트 재매핑 제어](https://help.tableau.com/current/server-linux/ko-kr/ports.htm#PortsAtInitializeTSM)를 참조하십시오. - `--enable-fips` 플래그는 FIPS(Federal Information Processing Standard) 모드의 Tableau Server를 초기화합니다. FIPS 모드에 있으면 서버를 FIPS 미지원 모드로 전환할 수 없습니다. 이는 설치 시 선택해야 하며 설치 후 변경할 수 없습니다. 다중 노드 구성에서 모든 노드가 전부 FIPS를 사용하거나 사용하지 않아야 합니다. 혼합하는 환경은 지원되지 않습니다. 자세한 내용은 [Linux 기반 Tableau Server의 FIPS 규정 준수](https://help.tableau.com/current/server-linux/ko-kr/fips-compliance_tsm.htm)를 참조하십시오. FIPS 미지원 Tableau Server를 FIPS 지원 Tableau Server로 마이그레이션하려면 해당 페이지의 지침을 따르십시오. **참고:** 이 옵션은 버전 2025.3.1에서 추가되었습니다. - 문제 해결을 위한 `--debug` 플래그. 이 옵션을 사용하면 스크립트가 실행될 때 각 명령이 표시되기 때문에 문제를 더 쉽게 해결할 수 있습니다. 이 옵션을 사용하면 화면에 광범위한 출력이 표시됩니다. **참고:** 버전 2021.3부터 이 옵션은 제거되었으며 표시된 스크립트는 `/var/tmp/`에 기록됩니다. 3. Tableau Server를 구성하기 전에 터미널에서 로그오프한 후 다시 로그온합니다. 다시 로그온하면 그룹 멤버 자격 변경 사항이 적용된 새 세션이 생성됩니다. 새 세션도 `initialize-tsm` 스크립트에 의해 추가된 환경 변수에 액세스할 수 있습니다. ## 다음 단계 - [Tableau Server 활성화 및 등록](https://help.tableau.com/current/server-linux/ko-kr/activate.htm)