---
schema_version: "1"
id: b4f0db2a6e0e0a059c12e603afab89689d57a637a03d8bb2a7f60cf60fa064cc
title: 라이선스 작업 자동화
collection: tableau
version: current
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/current/ko-kr/server/license_automating.md
canonical_url: https://help.tableau.com/current/server/ko-kr/license_automating.htm
source_site: help.tableau.com
content_type: documentation
content_hash: c21b7b93954091c0439867a66ad020806bb38f970d5f422989831aa0690871f8
description: Automate Tableau Server licensing tasks using command line tools and scripts.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# 라이선스 작업 자동화

다양한 명령줄 옵션을 사용하여 자동화된 스크립트를 통해 Tableau Server의 일반적인 라이선스 작업을 수행할 수 있습니다.

자동화된 스크립트를 사용하여 Tableau Desktop에 대해 이러한 라이선스 작업을 수행하려면 Desktop 배포 가이드의 [Tableau Desktop 배포](https://help.tableau.com/current/desktopdeploy/ko-kr/desktop_deploy_automate.htm)를 참조하십시오.

## 명령줄 도구 옵션 및 향상된 스크립트 자동화

`tabinstallck.exe`라는 유틸리티를 사용하여 서버 제품 키의 활성화, 새로 고침 및 비활성화를 스크립트로 작성할 수 있습니다. `tabinstallck.exe`는 초기 노드의 Tableau Server \\bin 디렉터리에 설치됩니다. 기본적으로 다음과 같습니다.

`C:\Program Files\Tableau\Tableau Server\packages\bin.<version_code>`

또한 `tsm licenses`를 사용하여 Tableau Server 제품 키를 온라인 또는 오프라인에서 활성화하거나 비활성화하고, 오프라인 활성화 또는 비활성화에 사용할 관련 파일을 가져오는 등, 라이선스 작업을 수행할 수 있습니다. 하지만 Tableau Server 제품이 이미 배포되고 구성되어 있어야 합니다. [Tableau 서비스 관리자 API](http://onlinehelp.tableau.com/v0.0/api/tsm_api/ko-kr/index.htm)를 사용하여 이러한 라이선스 작업을 자동화할 수 있습니다. 또한 `tabinstallck.exe`를 사용하면 완전히 구성되지 않은 새 Tableau Server 설치에 대한 라이선스 단계를 스크립트로 작성할 수 있습니다.

`tabinstallck.exe`를 사용하려면 주 Tableau Server 노드에서 관리자로 명령이나 스크립트를 실행해야 합니다.

**참고**: `tabinstallck.exe`는 오프라인 활성화 및 비활성화를 지원하지 않습니다. 자세한 내용은 [오프라인으로 Tableau Server 활성화](https://help.tableau.com/current/server/ko-kr/activate_off.htm)를 참조하십시오.

## 전방향 프록시 서버에서 제품 키 작동

Tableau Server를 실행 중인 컴퓨터가 정방향 프록시를 통해 인터넷에 연결하도록 구성된 경우 제품 키를 활성화하거나 새로 고치거나 비활성화하기 전에 [정방향 프록시에서 제품 키 작업 구성](https://help.tableau.com/current/server/ko-kr/activate_proxy.htm) 항목의 절차를 따릅니다.

## 활성화

`-activate` 옵션을 사용하여 Tableau Server 라이선스를 활성화합니다.

start/wait tabinstallck.exe -activate <product\_key>

## 새로 고침

`-refresh` 옵션을 사용하여Tableau Server 라이선스를 새로 고칩니다.

start/wait tabinstallck.exe -refresh <product\_key>

## 비활성화

`-return` 옵션을 사용하여 Tableau Server 라이선스를 비활성화합니다.

start/wait tabinstallck.exe -return <product\_key>

## 예

다음은 Tableau Server을 활성화하는 스크립트의 예입니다.

@echo off
start/wait tabinstallck.exe -activate <product\_key>
if %errorlevel% EQU 0 (ECHO SUCCESS) ELSE (ECHO FAILED)

## 오류 처리

`tabinstallck.exe` 를 사용하여 Tableau Server 라이선스 작업을 자동화할 때 상태 정보가 ERRORLEVEL 환경 변수의 종료 코드로 반환됩니다. 활성화가 성공한 경우 종료 코드는 `0`입니다. 아래 표에 활성화 프로세스의 종료 코드와 해당 의미가 나와 있습니다. `tabinstallck.log` 파일에서도 오류 정보를 찾을 수 있습니다. 이 로그 파일은 기본적으로 Tableau Server \\logs 폴더에 있습니다.

`C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\`

ProgramData 폴더는 기본적으로 숨겨집니다.

이 예제 스크립트에서는 Tableau Server을 활성화하고 잘못된 제품 키(536871018) 같은 특정 오류와 일반 라이선스 문제(536871012)를 확인하는 방법을 보여 줍니다.

@echo off
start/wait tabinstallck.exe -activate  _<product\_key>_
if %errorlevel% EQU 536871018 (ECHO TABLEAU\_ERROR\_LICENSING\_INVALID\_KEY)
if %errorlevel% EQU 536871012 (ECHO TABLEAU\_ERROR\_LICENCING\_GENERAL)
if %errorlevel% EQU 0 (ECHO SUCCESS)

<table class="simple-table"><colgroup><col><col><col></colgroup><tbody><tr><th>종료 코드</th><th>메시지</th><th>값</th></tr><tr><td><code>536871012</code></td><td><code>TABLEAU_ERROR_LICENSING_GENERAL</code></td><td>라이선스 작업 중에 알 수 없는 오류가 발생했습니다.</td></tr><tr><td><code>536871013</code></td><td><code>TABLEAU_ERROR_LICENSING_INTERNAL</code></td><td>내부 라이선스 오류로 인해 제품을 시작할 수 없습니다.</td></tr><tr><td><code>536871014</code></td><td><code>TABLEAU_ERROR_LICENSING_SETUP</code></td><td>내부 라이선스 오류로 인해 제품을 시작할 수 없습니다.</td></tr><tr><td><code>536871015</code></td><td><code>TABLEAU_ERROR_LICENSING_CONNECT</code></td><td>Tableau 라이선스 서버에 연결하는 동안 오류가 발생했습니다.</td></tr><tr><td><code>536871017</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_ASR</code></td><td>ASR을 활성화하는 동안 오류가 발생했습니다.</td></tr><tr><td><code>536871016</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_GENERAL</code></td><td>활성화하지 못했습니다. 다시 시도하십시오.</td></tr><tr><td><code>536871018</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_KEY</code></td><td>제품 키가 잘못되었습니다.</td></tr><tr><td><code>536871019</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_OFFLINE</code></td><td>오프라인 활성화를 완료할 수 없습니다.</td></tr><tr><td><code>536871020</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_MODEL</code></td><td>라이선스 서버에서 오류가 반환되었습니다. 자세한 내용은 Tableau 로그 파일을 참조하십시오.</td></tr><tr><td><code>536871021</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_REHOSTS</code></td><td>이 라이선스의 비활성화 제한에 도달했기 때문에 라이선스를 비활성화하지 못했습니다.</td></tr><tr><td><code>536871033</code></td><td><code>TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_EXTRA_ACTIVATIONS</code></td><td>이 라이선스에 대한 활성화 제한에 도달하여 라이선스를 활성화하지 못했습니다.</td></tr><tr><td><code>536871022</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_GENERAL</code></td><td>라이선스 해제 작업 도중 알 수 없는 오류가 발생했습니다. 제품 키를 확인하거나 지원 팀에 문의하십시오.</td></tr><tr><td><code>536871023</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_NONE_FOUND</code></td><td>라이선스를 찾을 수 없습니다.</td></tr><tr><td><code>536871024</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED</code></td><td>만료된 제품 키만 찾았습니다.</td></tr><tr><td><code>536871025</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_TRIAL</code></td><td>이 버전의 평기 기간이 끝났습니다.</td></tr><tr><td><code>536871026</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_SUBSCRIPTION</code></td><td>제품 키가 만료되었습니다.</td></tr><tr><td><code>536871027</code></td><td><code>TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_MAINTENANCE</code></td><td>유지 관리가 만료되었습니다.</td></tr><tr><td><code>536871028</code></td><td><code>TABLEAU_ERROR_LICENSING_RESYNC_GENERAL</code></td><td>제품 키를 동기화할 수 없습니다.</td></tr><tr><td><code>536871029</code></td><td><code>TABLEAU_ERROR_LICENSING_REGISTRATION_GENERAL</code></td><td>제품 등록 중에 오류가 발생했습니다.</td></tr><tr><td><code>536871030</code></td><td><code>TABLEAU_ERROR_LICENSING_SERVICE_INSTALL</code></td><td>라이선스 작업 중에 알 수 없는 오류가 발생했습니다.</td></tr><tr><td><code>536871031</code></td><td><code>TABLEAU_ERROR_LICENSING_SERVICE_UNINSTALL</code></td><td>라이선스 작업 중에 알 수 없는 오류가 발생했습니다.</td></tr><tr><td><code>536871032</code></td><td><code>TABLEAU_ERROR_LICENSING_SERVICE_NOT_PRESENT</code></td><td>FLEXnet 라이선스 서비스가 시스템에 없습니다.</td></tr></tbody></table>