Tableau 部署指南

本文介绍如何使用命令行安装 Tableau Desktop、Tableau Prep Builder 或 Tableau Desktop Public Edition，并执行其他安装操作（例如激活和注册），以及如何卸载产品。

有关查找安装程序和产品密钥的更多详细信息，请参见安装程序在何处？和查找产品密钥。

注意：如果您要升级，请参见升级 Tableau Desktop 和 Tableau Prep Builder，了解有关准备升级的信息。

默认情况下，Tableau 会为您启用某些功能，例如使用报告或自动产品更新（仅限 Tableau Desktop）。有关如何关闭这些功能及其他功能的信息，请参见在安装之后更改安装设置(链接在新窗口中打开)。

开始之前

• 与服务器的兼容性：Tableau 产品并不总是同时发布。安装新版本 Tableau Desktop 时，请确保它与 Tableau Server 兼容。请参见查找和解决兼容性问题。
• 在同一台计算机上安装 Desktop 和 Prep：Tableau Prep Builder 设计为可与 Tableau Desktop 配合使用。建议您将 Tableau Prep Builder 和 Tableau Desktop 安装在同一台计算机上。
• 不要在运行 Tableau Server 的同一台计算机上安装 Tableau Prep Builder：Tableau Server 资源管理器 (SRM) 无法区分 Tableau Server 协议服务器进程和 Tableau Prep Builder 协议服务器进程。如果计算机资源耗尽，SRM 可能会终止属于 Tableau Prep Builder 的协议服务器进程，而该进程没有恢复机制。
• Windows 安装程序要求：如果使用需要 Windows 安装程序（.msi 文件）的部署工具来安装 Tableau Prep 或 Tableau Prep Builder，请按照提取并运行 Windows (MSI) 安装程序中的说明进行操作，从 Tableau 安装程序 .exe 文件中提取 .msi 文件。

单击下面适用于您所安装的产品的选项卡，查看安装步骤。

<dict>
	<key>attributeSetting</key>
	<integer>1</integer>
	<key>choiceAttribute</key>
	<string>selected</string>
	<key>choiceIdentifier</key>
	<string>com.tableau.oracle</string>
</dict>

<dict>
	<key>attributeSetting</key>
	<integer>0</integer>
	<key>choiceAttribute</key>
	<string>selected</string>
	<key>choiceIdentifier</key>
	<string>com.tableau.desktopShortcut</string>
</dict>

提取并运行 Windows (MSI) 安装程序

如果您使用需要 Windows 安装程序（.msi 文件）的部署工具来安装 Tableau Desktop 或 Tableau Prep Builder，您可以从 Tableau 安装程序 .exe 文件中提取 .msi 文件。在提取 .msi 文件时，您将看到安装程序 .msi 文件，以及包括在 Tableau Desktop 安装过程中的每个数据库驱动程序的 .msi 文件。

若要提取 .msi 文件，您可以使用像 WiX Toolset 这样的第三方工具。

免责声明： 此解决方案包括有关第三方产品的信息。尽管我们会尽力保持第三方内容引用的正确性，但是 WiX Toolset 选项可能会进行更改而不另行通知。有关最新信息，请查阅 WiX 文档。若要在使用 WiX 实用工具时获得帮助，请联系 WiX 用户邮件列表。

1. 在下载了 Tableau 安装程序的计算机上，从 WiX 网站 (http://wixtoolset.org/(链接在新窗口中打开)) 下载并安装最新版本的 WiX Toolset。

2. 以管理员身份打开命令窗口，并导航到安装了 WiX Toolset 的文件夹的根目录。

3. 运行以下命令：

   Dark.exe <path_to_the_Tableau_exe_installer> -x <output_folder>

   例如，运行以下命令：

   Dark.exe C:\tableau-setup-std-tableau-2021-1.21.0125.1838-x64.exe -x c:\output

输出文件夹将包含一个名为 AttachedContainer 的文件夹，其中包括 .msi 文件。

激活 Tableau Desktop 和 Tableau Prep Builder

安装 Tableau Desktop 或 Tableau Prep Builder 后，您可以使用 基于登录名的许可证管理 通过登录 Tableau Cloud 或 Tableau Server 进行激活。否则，您需要通过向 Tableau 发送激活请求来提供产品密钥以激活产品。您可以在安装过程中 (Windows) 或在安装后（Windows 及 Mac）通过命令行输入产品密钥。

若要在安装期间自动执行此过程，请添加一个包括安装程序选项 ACTIVATE_KEY "<key>” 的命令行，并在引号中输入产品密钥。安装程序将在安装过程中应用产品密钥。

若要在安装后自动执行此过程，请在安装后使用 -activate <key> 选项运行 Tableau.exe 或 Tableau Prep Builder.exe，例如 tableau.exe -activate <my_product_key>。

注意：如果要使用自动化脚本激活 Tableau Server，请参见 Tableau Server 帮助中的自动执行许可任务(链接在新窗口中打开)。

Windows

使用 -activate 选项和产品密钥运行 tableau.exe 或 Tableau Prep Builder.exe。

例如：

Tableau Desktop："C:\Program Files\Tableau\Tableau <version>\bin\tableau.exe" -activate <product_key>

Tableau Prep Builder：“C:\Program Files\Tableau\Tableau Prep Builder <version>\Tableau Prep Builder.exe" -activate <product_key>

Mac

在 /Applications 路径中使用 -activate 选项和产品密钥运行 Tableau 或 Tableau Prep Builder 可执行文件。

例如：

Tableau Desktop："Tableau Desktop <version>.app/Contents/MacOS/Tableau" –activate <product_key>

Tableau Prep Builder："Tableau Prep Builder <vesion>.app/Contents/MacOS./Tableau Prep Builder" –activate <product_key>

有关在许可失败的情况下可以获取和评估的退出代码的信息，请参见本指南内“安装疑难解答”一文中的使用激活退出代码排除激活错误。

注册 Tableau Desktop 和 Tableau Prep Builder

您可通过自动执行注册 Tableau 单独副本的任务来确保组织中一致的注册。若要为 Windows 自动完成此过程，请添加一个包括安装程序选项 REGISTER="1” 的命令行。安装程序将运行 -register 并注册产品。

若要通过命令行注册 Tableau，您需要在将运行 Tableau Desktop 和 Tableau Prep Builder 的每台计算机上预先填充注册表 (Windows) 或属性列表 (Mac) 值。对于 Windows，您可以在安装过程中触发此过程。对于 Windows 和 Mac，您可以执行安装过程并使用 register 命令行选项。当 Tableau 启动时，它将读取注册信息并为该用户注册 Tableau。

注册信息存储在计算机上 Tableau 的安装位置中。

• Windows：该信息位于注册表中。

• Mac：该信息位于属性列表 (.plist) 文件中。

注册信息包括对于多个用户可能相同的位置字段（例如，city、country 和 zip），以及通常对于每个用户唯一的字段（email、first_name、last_name、title）。

对于 Tableau Desktop，您必须包括"opt_in"和"privac_consent"字段才能使用命令行选项成功注册产品。

注册信息保存在以下位置之一中：

• Windows。注册表：HKEY_CURRENT_USER\Software\Tableau\Registration\Data

• Mac。.plist 文件位置：/Users/<user_name>/Library/Preferences/<.plist_file_name>

在多台计算机上预先填充注册表或属性列表值的最简单方式是：在一台计算机上手动安装和注册 Tableau，然后使用通过该过程填写的注册表项或属性列表文件作为模板来更新其他计算机上的注册表。

Windows

注册 Tableau 并创建模板

1. 作为计算机上的管理员，请在对注册表文件进行任何更改之前将其备份。

2. 在至少一台 Windows 计算机上安装并手动注册产品。在其他计算机上安装 Tableau 时，您可以使用该注册信息作为模板。

   注册信息保存在 Windows 注册表中的以下条目下：

   HKEY_CURRENT_USER\Software\Tableau\Registration\Data

3. 将数据（项）导出为注册表文本文件。

4. 创建一个执行以下操作的脚本：

   1. 建立模板注册表文本文件的副本，并更新对于用户唯一的字段。

   2. 将更新的注册表文本文件复制到用户的计算机。

   3. 在该计算机上更新注册表。

   更新的字段将取决于您想要随注册一起发送的信息。有关如何自动更新注册的信息，请参见 Microsoft 文档。

   下图显示了您可能会在导出的注册表文件中看到的注册表值的示例：

   [HKEY_CURRENT_USER\Software\Tableau\Registration\Data]
"campaign_id"=""
"company"=""
"country"=""
"db_title"=""
"department"=""
"elqCustomerGUID"=""
"elqFormName"=""
"email"=""
"first_name"=""
"form_environment"=""
"form_variant"=""
"ga_client_id"=""
"job_role"=""
"last_name"=""
"lead_source"=""
"lead_source_detail"=""
"phone"=""
"product_key"=""
"product_name"=""
"state"=""
"title"=""
"zip"=""
"registration_date"=""
"city"=""
"industry"=""
"opt_in"=""
"privac_consent"=""
   

使用模板在另一台计算机上注册 Tableau

1. 在另一台计算机上，安装 Tableau Desktop 或 Tableau Prep Builder。

2. 带 -register 选项运行 tableau.exe 或 Tableau Prep Builder.exe。

   例如：

   Tableau Desktop：“Program Files\Tableau\Tableau <version>\bin\tableau.exe -register”

   Tableau Prep Builder：“Program Files\Tableau\Tableau Prep Builder<version>\Tableau Prep Builder.exe -register”

   如果注册成功，安装日志文件将具有以下条目：

   Current registration state: complete / not needed

   如果注册未成功，Tableau 将关闭，并显示错误代码 error 117。您也可以检查日志文件，其中包含有关无效或缺失的字段的信息。日志文件位于此位置中：

   Documents >我的 Tableau 存储库 or 我的 Tableau Prep Builder 存储库 > Logs> log.txt

   如果注册失败，则需要更新您创建的自动化脚本。有关疑难解答提示，请参见 Tableau Desktop 或 Tableau Prep Builder 安装疑难解答。

Mac

注册 Tableau 并创建模板

若要在 Mac 上注册 Tableau Desktop 或 Tableau Prep Builder，您可以使用 Xcode 或 defaults 命令来更新以下属性列表文件：com.tableau.Registration.plist。

可在 Apple Support 上找到有关如何编辑 OS X 属性列表文件的详细信息。

1. 在至少一台 Mac 计算机上安装并手动注册产品。这将创建 .plist 文件，您可将其用作模板在其他计算机上注册 Tableau Desktop 或 Tableau Prep Builder。

2. 转到 /Users/<user_name>/Library/Preferences，并备份想要用作模板的 com.tableau.Registration.plist 文件。

3. 将模板 com.tableau.Registration.plist 文件复制到要安装 Tableau Desktop 的 Mac 上的 /Users/<user_name</Library/Preferences 文件夹。

4. 运行以下命令：

   cd /Users/<user_name>/Library/Preferences

   例如：

   cd /Users/agarcia/Library/Preferences

5. 对于要更新的每个 .plist 项，运行以下命令：

   defaults write com.tableau.Registration.plist <key_value>

   例如：

   defaults write com.tableau.Registration.plist Data.first_name Ashley

   defaults write com.tableau.Registration.plist Data.last_name Garcia

使用模板在另一台计算机上注册 Tableau

• 在另一台计算机上，安装 Tableau Desktop 或 Tableau Prep Builder。

  在安装过程中，系统会提示您输入产品密钥，然后会运行激活向导。如果您在完成激活或注册之前退出程序，或者以无提示方式进行安装，请启动终端应用程序，然后运行以下命令：

  • 若要激活 Tableau Desktop 或 Tableau Prep Builder，请运行以下命令：

    Tableau Desktop："Tableau Desktop <version>.app/Contents/MacOS/Tableau" –activate <product_key>

    Tableau Prep Builder："Tableau Prep Builder <vesion>.app/Contents/MacOS./Tableau Prep Builder" –activate <product_key>

  • 若要注册 Tableau Desktop 或 Tableau Prep Builder，请运行以下命令：

    Tableau Desktop："Tableau Desktop <version>.app/Contents/MacOS./Tableau" –register

    Tableau Prep Builder："Tableau Prep Builder <vesion>.app/Contents/MacOS./Tableau Prep Builder" –register

卸载 Tableau Desktop 和 Tableau Prep Builder

尽管在安装较新版本时不必卸载以前版本的 Tableau Desktop 和 Tableau Prep Builder，但如果计算机上不再需要任何版本的这些应用程序，您可以将其卸载。

Windows

若要通过命令行以无提示方式卸载 Tableau Desktop 或 Tableau Prep Builder，请执行以下操作：

1. 以管理员身份打开命令提示符。

2. 在 .exe 的安装位置中，运行以下命令：

   TableauDesktop-<product_installer_name>.exe /uninstall /quiet

   或

   TableauPrepBuilder-<product_installer_name>.exe /uninstall /quiet

   例如：

   Downloads\TableauPrepBuilder-2021-1-4.exe /uninstall /quiet

若要通过命令行卸载 Tableau Desktop 的多个版本，请执行以下操作。

注意：此选项不可用于 Tableau Prep Builder。

1. 使用 REMOVEINSTALLEDAPP 选项安装最新版本的 Tableau Desktop。

   例如：tableauDesktop-64bit-2021-4-4.exe /quiet /norestart ACCEPTEULA=1 REMOVEINSTALLEDAPP=1

2. 确认除最新版本外的所有旧版本均已卸载。

3. 卸载最新版本。例如：tableauDesktop-64bit-2021-4-4.exe /uninstall /quiet /norestart

4. 按照彻底移除 Tableau Desktop(链接在新窗口中打开)中的步骤删除所有未使用的文件夹。

Mac

若要在 Mac 上卸载 Tableau Desktop，请执行以下操作：

1. 如果需要停用或退回产品密钥，请在 /Applications 路径中的 Tableau 对象上运行 -return 选项。有关详细信息，请参见转移或停用产品密钥。转移或停用产品密钥.
2. 将应用程序和 Desktop 快捷方式（如果有）拖到废纸篓文件夹，然后清空废纸篓。
3. 卸载自动安装的任何驱动程序。

此部分中的其他文章