自动执行许可任务
一些命令行选项允许您使用自动脚本执行常见的 Tableau Server 许可任务。
如果要使用自动脚本执行这些 Tableau Desktop 许可任务,请参阅《桌面部署指南》中的部署 Tableau Desktop(链接在新窗口中打开)。
命令行工具选项和更好的脚本自动化
您可以使用名为 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 来自动执行这些许可任务。此外,tabinstallck.exe
提供了一种方法来为未完全配置的新 Tableau Server 安装的许可步骤编写脚本。
若要使用 tabinstallck.exe
,需要在主 Tableau Server 节点上以管理员身份运行命令或脚本。
注意:tabinstallck.exe
不支持脱机激活和停用。若要了解详细信息,请参见脱机激活 Tableau Server。
转发代理服务器的产品密钥操作
如果已将运行 Tableau Server 的计算机配置为通过转发代理连接到 Internet,请按照使用转发代理配置产品密钥操作主题的过程进行操作,然后再尝试激活、刷新或停用产品密钥。
激活
使用 -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)
退出代码 | 消息 | 值 |
---|---|---|
536871012 | TABLEAU_ERROR_LICENSING_GENERAL | 许可操作过程中发生未知错误。 |
536871013 | TABLEAU_ERROR_LICENSING_INTERNAL | 产品由于内部许可错误而无法启动。 |
536871014 | TABLEAU_ERROR_LICENSING_SETUP | 产品由于内部许可错误而无法启动。 |
536871015 | TABLEAU_ERROR_LICENSING_CONNECT | 与 Tableau 许可证服务器联系时出错。 |
536871017 | TABLEAU_ERROR_LICENSING_ACTIVATION_ASR | 激活 ASR 时出错。 |
536871016 | TABLEAU_ERROR_LICENSING_ACTIVATION_GENERAL | 激活失败,请重试。 |
536871018 | TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_KEY | 产品密钥无效。 |
536871019 | TABLEAU_ERROR_LICENSING_ACTIVATION_OFFLINE | 无法完成脱机激活。 |
536871020 | TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_MODEL | 许可服务器返回了错误。请检查 Tableau 日志文件以了解详细信息。 |
536871021 | TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_REHOSTS | 由于已达到此许可证的停用次数限制,因此未能停用许可证。 |
536871033 | TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_EXTRA_ACTIVATIONS | 由于已达到此许可证的激活次数限制,因此未能激活许可证。 |
536871022 | TABLEAU_ERROR_LICENSING_UNLICENSED_GENERAL | 取消许可操作过程中发生未知错误。请检查产品密钥或与支持人员联系。 |
536871023 | TABLEAU_ERROR_LICENSING_UNLICENSED_NONE_FOUND | 找不到许可证。 |
536871024 | TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED | 只找到过期的产品密钥。 |
536871025 | TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_TRIAL | 此版本的试用期已结束。 |
536871026 | TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_SUBSCRIPTION | 产品密钥已过期。 |
536871027 | TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_MAINTENANCE | 维护已过期。 |
536871028 | TABLEAU_ERROR_LICENSING_RESYNC_GENERAL | 无法同步产品密钥。 |
536871029 | TABLEAU_ERROR_LICENSING_REGISTRATION_GENERAL | 产品注册过程中出错。 |
536871030 | TABLEAU_ERROR_LICENSING_SERVICE_INSTALL | 许可操作过程中发生未知错误。 |
536871031 | TABLEAU_ERROR_LICENSING_SERVICE_UNINSTALL | 许可操作过程中发生未知错误。 |
536871032 | TABLEAU_ERROR_LICENSING_SERVICE_NOT_PRESENT | 系统中不存在 FLEXnet 许可服务。 |