此页面是否有用?

从 Tableau Server 2018.1 或更低版本升级到包含 TSM 的 Tableau Server

Windows 版 Tableau Server 现在包括 Tableau 服务管理器 (TSM),它取代了配置实用工具和命令行工具。如果您需要更低版本 Tableau Server 的帮助,请参见 Tableau 帮助页面。

从版本 2018.2 开始,Windows 版 Tableau Server 附带 Tableau 服务管理员 (TSM)。TSM 是基于 Web 的服务器配置和管理实用工具,替代了服务器配置实用工具和 tabadmin 命令行实用工具。随着 TSM 的引入,Tableau Server 升级过程已发生变化。有关升级如何变化的信息,请参见升级过程更改

从 Tableau Server TSM 之前的版本(2018.1 或更低版本)升级到运行 TSM 的版本时,您需要执行一些特殊升级步骤。只需要为从 TSM 之前的版本到 TSM 版本的升级执行这些步骤。TSM 之前的 Windows 版 Tableau Server 是指早于 2018.2 版本。TSM 之前的版本的示例包括 9.3、10.5 和 2018.1。

注意:对于 TSM,我们更改了用于描述分布式安装中的 Tableau Server 节点的语言。在 TSM 版本之前,我们将第一个节点称为“主”节点,并将任何其他节点称为“工作服务器”节点。对于 TSM,节点更接近于对等,因此我们将第一个节点称为“初始”节点,并将其他节点称为“附加”节点。

升级之前

升级基于服务器的产品需要进行规划和准备。将 Tableau Server 从版本 2018.1 或更低版本升级到版本 2018.2 或更高版本也不例外。在升级生产环境之前,请确保您已通读并完成了以下部分:研究升级准备升级测试升级

作为最佳做法,您应始终在升级之前建立 Tableau Server 数据的备份,并将此备份保存在不属于 Tableau 安装一部分的一个安全位置。如果在升级过程中发生意外情况,或者您需要恢复为以前版本的 Tableau Server,此备份可保留您的 Tableau 数据。有关详细信息,请参见备份 Tableau Server 数据

了解升级到 TSM 的各个关键方面

下面是将 Tableau Server 从版本 2018.1 或更低版本升级到版本 2018.2 的一些关键方面,您需要加以注意。

所有升级:

  • 本地管理员 — 以本地管理员身份登录。您需要以“本地管理员”身份登录到 Tableau Server 计算机来运行 Tableau Server 安装程序,以及运行与升级相关的脚本。“本地管理员”用户是 Windows 的“本地用户和组”管理控制台中的“管理员”组的成员。

  • 许可

    • 试用产品密钥 — 您无法将运行试用产品密钥的服务器从一个主要版本直接升级到另一个主要版本(例如,从版本 10.5.x 升级到版本 2018.x)。若要使用试用产品密钥从另一个主要版本升级到另一个主要版本,请在单独的计算机上安装新版本的 Tableau Server,在该计算机上激活试用密钥,然后还原来自现有版本的备份。有关详细信息,请参见确认许可要求

    • 过期的维护 — 对于其维护已过期或过期日期早于所升级到的版本的发布日期的产品密钥,您无法使用该产品密钥来升级服务器。如果尝试在这种状态下进行升级,服务器将变为未许可,并且升级可能会失败。如果您的维护已过期或太旧,请使用“管理产品密钥”应用程序刷新产品密钥,之后再卸载原始版本。如果密钥刷新操作未将维护更新为有效日期,请在 Tableau 客户门户中检查是否有具有最新维护的 Tableau Server 密钥。

  • 卸载 — 在升级之前,使用 Windows 控制面板卸载现有 TSM 之前的 Tableau Server 版本。这种特殊情况的升级与早期版本中的升级不同,后者会自动卸载以前版本的 Tableau Server。从版本 2018.1 或更低版本升级到版本 2018.2 或更高版本时,您必须自行卸载更低版本。如果未卸载更低版本,当您尝试安装新版本时,系统将提示您这样做。此情况特定于从 2018.1 或更低版本到 2018.2 或更高版本的升级。

  • 备份 — 将更低版本的备份保存到其他计算机上的一个安全位置。卸载以前版本的 Tableau Server 时,将会在 Tableau 数据目录(默认情况下为 C:\ProgramData\Tableau\Tableau Server)中创建一个备份。我们强烈建议您在升级之前将此备份复制到不是 Tableau Server 安装一部分的计算机。这可以为您提供数据的最新版本,如果您需要返回到更低版本的 Tableau Server,您可以使用该数据。有关正确准备升级的详细信息,请参见准备升级

  • 防火墙管理 — 防火墙管理是手动进行的。与更低版本的 Tableau Server 不同,您必须在运行 Tableau Server 的任何计算机上管理本地防火墙。有关详细信息,请参见本地防火墙配置

  • 升级脚本 — 安装新版本之后,通过运行 upgrade-tsm.cmd 脚本完成升级并切换到新版本。

多节点升级:

  • 卸载 — 在升级之前,使用 Windows 控制面板从所有节点中卸载现有 TSM 之前的 Tableau Server 版本。如果未卸载更低版本,当您尝试安装新版本时,系统将提示您这样做。

  • 节点安装 — 在群集中的所有节点上运行安装程序。与 2018.2 之前版本中的某些分布式安装升级不同,将不会自动升级任何附加节点。

  • 单一安装程序 — 在所有节点上使用同一安装程序。从 2018.2 开始,您可以在所有节点上使用同一安装程序,并在出现提示时指定您是要升级初始(主)节点还是附加(工作服务器)节点。没有用于附加节点的单独安装程序。

  • 升级脚本 — 在群集中的所有节点上安装新版本之后,通过运行 upgrade-tsm.cmd 脚本完成升级并切换到新版本。

Closed确认用户运行身份格式是否包括域 确认用户运行身份格式是否包括域

Tableau Server 安装为用户运行身份默认使用本地“网络服务”帐户 (NT Authority\Network Service)。如果使用此默认帐户,您可以跳过此部分。如果更改了默认帐户,或者不确定您是否在使用自定义用户运行身份,请按下面的步骤操作。

在升级到版本 2018.2 或更高版本之前,请确保用户运行身份的格式正确。格式应包括域,像这样:<domain>\<runasuser>

  1. 通过在 Windows“开始”菜单上选择“所有程序”>“Tableau Server <版本>”>“停止 Tableau Server”来停止服务器。

  2. 在 Windows“开始”菜单上选择“配置 Tableau Server”

  3. 如果使用 Active Directory 帐户作为服务器的“用户运行身份”帐户,请在“常规”选项卡上输入其密码。

  4. 确认您的“用户运行身份”帐户的格式:

    • 如果用户运行身份是“NT AUTHORITY\NetworkService”,则您在使用默认值,并且无需进行任何更改。单击“取消”退出配置实用工具。

    • 如果用户名包括域,您无需进行任何更改。单击“取消”退出配置实用工具。

    • 如果用户名未包括域,请在用户名开头添加域,并使用反斜杠 (\) 将域与名称分隔开来。

      举例来说,如果服务器用户运行身份为“MYCO”域中的“TableauServer”,请将“用户”字段更改为如下:MYCO\TableauServer

  5. 单击“确定”

  6. 重新启动服务器。

Closed收集现有文件 收集现有文件

您将需要从现有 Tableau Server 部署中收集以下文件。稍后在升级过程结束时,您将需要上载这些文件来完成升级。

其中一些文件包含必须加以保护的密文。使用安全的过程来复制、存储和传输这些文件。

  • 自定义徽标。如果使用自定义图像对 Tableau Server 门户进行了自定义,则升级将需要这些文件的副本。

    有关详细信息,请参见 Tableau Server 2018.1 联机帮助主题更改名称或徽标

  • SAML 文件。您将需要 SAML 证书、密钥和 IdP 元数据文件。这些文件的默认位置为 C:\Program Files\Tableau\Tableau Server\SAML

    有关详细信息,请参见 Tableau Server 2018.1 联机帮助主题配置 SAML

  • Kerberos 密钥表文件。如果为 Tableau Server 启用了 Kerberos SSO,您将需要在该配置过程中生成的密钥表文件。

    有关详细信息,请参见 Tableau Server 2018.1 联机帮助主题 Kerberos 配置脚本

  • SSL

    • CA 证书文件。如果针对相互 SSL 配置了现有 Tableau Server,您将需要重新提交 CA 证书文件。这些文件的默认位置为 C:\Program Files\Tableau\Tableau Server\SSL.

    • 证书和密钥文件。您无需对这些文件执行任何操作。这些文件会自动升级。

  • Open ID 文件。如果组织使用静态发现文件(而不是联机发现文件),则升级将需要该文件的副本。

    有关详细信息,请参见 Tableau Server 2018.1 联机帮助主题针对 OpenID Connect 配置 Tableau Server

Closed升级单节点 Tableau Server 升级单节点 Tableau Server
  1. 确认“管理产品密钥”应用程序未打开后,使用 Windows 控制面板来卸载 Tableau Server。与以前版本的安装程序不同,版本 2018.2 及更高版本将不会卸载以前的版本。

    卸载操作将会创建数据备份并停止 Tableau。数据目录将保留在原处。

    卸载创建的备份文件稍后将用于升级,并且以“uninstall-<version>.tsbak”形式保存在 Tableau 数据目录中,默认情况下该目录为:C:\ProgramData\Tableau\Tableau Server

    重要信息:将备份的副本保存在其他计算机上。这可确保在 Tableau Server 计算机发生故障的情况下您有备份。创建备份并将其保存到非 Tableau 位置是您应始终执行的最佳做法步骤。

  2. 在初始节点(旧的主节点)上运行包含 TSM 的 Tableau Server 新版本的安装程序。

    如果未卸载以前版本的 Tableau,则会显示一条消息,告知您当前版本无法自动升级。如果看到此消息,请使用控制面板卸载以前的版本。

  3. 出现安装位置提示时,选择以前的安装使用的相同位置。如果不选择正确的位置,安装程序将假定为全新安装,并且将不会包括您的数据。

    如果升级非默认位置中的安装,请参见在非默认位置中升级 Tableau Server

  4. 出现“安装类型”提示时,确认“升级 Tableau Server”“如果为多节点,升级现有群集的主节点。”处于选定状态(这是默认值):

    重要信息:如果您未看到安装选项提示,而是看到“创建新 Tableau Server 安装”选项,则您可能未导航到以前的安装的正确位置。如果继续,安装将不会包括以前安装中的数据或配置信息。

  5. 单击“下一步”继续。

    如果 Windows Defender 防火墙提示,请单击“允许访问”。您可能需要执行此操作多次才能完成安装。

  6. 安装完成后,安装程序的最后一页会告知您升级尚未完成。您需要运行升级脚本来完成升级。您可以从安装程序中运行脚本,或者通过命令行自行运行。

  7. 通过两种方式之一来运行升级脚本。

    • 通过安装程序:

      1. 选择“自动启动升级脚本”,并单击“确定”

      2. 将为脚本打开一个命令窗口。由于您以具有管理员权限的用户身份登录,因此脚本将使用您的凭据运行,并且会提示您输入 TSM 管理员的密码。如果旧 Tableau Server 安装使用非默认用户运行身份,则会提示您输入用户运行身份密码。

        升级脚本将在 Tableau 数据文件夹 (C:\ProgramData\Tableau\Tableau Server) 中查找卸载以前的版本时创建的备份文件。您可以使用 --backup-path 选项指定其他位置中的备份文件,但您需要从命令行中运行脚本才能这样做。

    • 在命令行上:

      1. 在初始节点上,以管理员身份打开命令提示符。

      2. 导航到新安装位置中的 scripts 文件夹。

        默认情况下:

        C:\Program Files\Tableau\Tableau Server\packages\scripts.<version>\

      3. 运行升级脚本:

        upgrade-tsm

        脚本将假定以前安装中的备份文件的位置,并提示您输入密码:

        • 默认情况下,升级脚本将在 Tableau 数据文件夹 (C:\ProgramData\Tableau\Tableau Server) 中查找卸载以前的版本时创建的备份文件。您可以使用 --backup-path 选项指定其他位置。例如:

          upgrade-tsm --backup-path "C:\path\to\backup\file\uninstall-10.5.tsbak"

        • 由于您以具有管理员权限的用户身份登录,因此脚本将使用您的凭据运行,并且会提示您输入 TSM 管理员的密码。使用 --username--password 选项运行脚本时,您可以指定其他用户和密码。

        • 如果旧 Tableau Server 安装使用非默认用户运行身份,则会提示您输入用户运行身份密码。在使用 --service-runas-password 选项运行脚本时,您可以提供此密码。

        若要查看 upgrade-tsm 脚本的所有选项,请使用 -h 选项:
        upgrade-tsm -h

  8. 升级完成后,一个浏览器窗口将打开,并显示 TMS 登录页面。登录到 TSM。将会提示您激活或注册 Tableau Server(如果需要执行这些步骤)。

    如果窗口未自动打开,请打开浏览器窗口并转到:

    https://<tsm-computer-name>:8850

  9. 启动 Tableau Server。

    • 在 Web UI 中:

      • 单击“Tableau Server 已停止”,并单击“启动 Tableau Server”

    • 在命令行上:

      1. 在初始节点上,以管理员身份打开命令提示符。

      2. 导航到新安装位置中的 bin 目录。默认情况下,此目录为:

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

      3. 启动 Tableau Server:

        tsm start

  10. 上载文件。使用以下 TSM 命令从以前的 Tableau Server 中上载文件。必须使用 TSM 上载这些文件。不要将这些文件复制到 Tableau Server 文件夹分层结构中的目标,而是要将它们复制到临时目录(例如,C:\temp),然后运行 TSM 命令将文件复制到系统中。

    • 自定义徽标文件。如果使用自定义图像对 Tableau Server 门户进行了自定义,请运行以下命令:

      tsm customize --header-logo <file> --signin-logo <file> --logo <file>

    • SAML 文件。为 SAML SSO 运行以下命令:

      tsm authentication saml configure --cert-file <file> --key-file <file> --idp-metadata <file>

      如果为数据源委派使用 SAML,请运行以下命令:

      tsm data-access set-saml-delegation --cert-file <file> --key-file <file>

    • Kerberos 密钥表文件。运行以下命令:

      tsm authentication kerberos configure --keytab-file <file>

    • 相互 SSL 文件。按照此处的说明进行操作:

      配置相互 SSL 身份验证

    • Open ID 文件。运行以下命令:

      tsm authentication openid configure --metadata-file <file>

    如果运行上述任何命令,您还需要应用未完成的更改:

    tsm pending-changes apply

Closed升级多节点 Tableau Server 升级多节点 Tableau Server
  1. 确认“管理产品密钥”应用程序未打开后,使用 Windows 控制面板来卸载 Tableau Server。与以前版本的安装程序不同,版本 2018.2 及更高版本将不会卸载以前的版本。

    卸载操作将会创建数据备份并停止 Tableau。数据目录将保留在原处。

    卸载创建的备份文件稍后将用于升级,并且以“uninstall-<version>.tsbak”形式保存在 Tableau 数据目录中,默认情况下该目录为:C:\ProgramData\Tableau\Tableau Server

    重要信息:将备份的副本保存在其他计算机上。这可确保在 Tableau Server 计算机发生故障的情况下您有备份。创建备份并将其保存到非 Tableau 位置是您应始终执行的最佳做法步骤。

  2. 如果在主节点上卸载了 Tableau Server,请在继续之前使用控制面板在所有工作服务器节点上卸载 Tableau。

  3. 在初始节点(旧的主节点)上运行包含 TSM 的 Tableau Server 新版本的安装程序。

    如果未卸载以前版本的 Tableau,则会显示一条消息,告知您当前版本无法自动升级。如果看到此消息,请使用控制面板卸载以前的版本。

  4. 出现安装位置提示时,选择以前的安装使用的相同位置。如果不选择正确的位置,安装程序将假定为全新安装,并且将不会包括您的数据。

    如果升级非默认位置中的安装,请参见在非默认位置中升级 Tableau Server

  5. 出现“安装类型”提示时,确认“升级 Tableau Server”“如果为多节点,升级现有群集的主节点。”处于选定状态(这是默认值)。

    重要信息:如果您未看到安装选项提示,而是看到“创建新 Tableau Server 安装”选项,则您可能未导航到以前的安装的正确位置。如果继续,安装将不会包括以前安装中的数据或配置信息。

  6. 单击“下一步”继续。

    如果 Windows Defender 防火墙提示,请单击“允许访问”。您可能需要执行此操作多次才能完成安装。

    安装完成后,不要运行升级脚本。在运行脚本之前,您需要生成引导程序文件并安装其他节点。

  7. 在初始节点上生成引导程序文件:

    1. 在初始节点上,以管理员身份打开命令提示符。

    2. 导航到新安装位置中的 bin 目录。默认情况下,此目录为:

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

    3. 生成引导程序文件:

      tsm topology nodes get-bootstrap-file -f <path_to_save_file>

  8. 将引导程序文件复制到每个附加(工作服务器)节点,或复制到这些节点可访问的网络位置。

  9. 在每个附加节点上,运行安装程序来安装 Tableau Server 的新版本。与以前版本的 Tableau Server 不同,版本 2018.2 及更高版本将只有一个同时用在初始节点和所有附加节点上的安装程序。

    如果未卸载以前版本的 Tableau,则会显示一条消息,告知您当前版本无法自动升级。如果看到此消息,请使用控制面板卸载以前的版本。

  10. 出现安装位置提示时,选择以前的安装使用的相同位置。如果不选择正确的位置,安装程序将假定为全新安装,并且将不会包括您的数据。

    如果升级非默认位置中的安装,请参见在非默认位置中升级 Tableau Server

  11. 出现“安装类型”提示时,选择“升级现有 Tableau Server 群集的工作服务器节点”(仅适用于多节点)选项:

    重要信息:如果您未看到安装选项提示,而是看到“创建新 Tableau Server 安装”选项,则您可能未导航到以前的安装的正确位置。如果继续,安装将不会包括以前安装中的数据或配置信息。

  12. 单击“下一步”继续。

    如果 Windows Defender 防火墙提示,请单击“允许访问”。您可能需要执行此操作多次才能完成安装。

  13. 出现提示时:

    1. 导航到您复制的引导程序文件的位置。

    2. 输入在创建了引导程序文件的计算机上具有管理权限的用户(例如,创建了引导程序文件的 TSM 管理员)的用户名和密码。

    3. 单击“下一步”继续。

  14. 节点安装完成后,一个对话框将告知您升级尚未完成:

    单击“确定”关闭对话框。

  15. 在所有节点上安装了新版本之后,在初始节点上运行升级脚本:

    1. 导航到新版本的 scripts 目录。

      默认情况下:

      C:\Program Files\Tableau\Tableau Server\packages\scripts.<version>\

    2. 运行升级脚本:

      upgrade-tsm

      由于您以具有管理员权限的用户身份登录,因此脚本将使用您的凭据运行,并且会提示您输入 TSM 管理员的密码。

      默认情况下,升级脚本将在 Tableau 数据文件夹 (C:\ProgramData\Tableau\Tableau Server) 中查找卸载以前的版本时创建的备份文件。

      注意:如果旧 Tableau Server 安装使用非默认用户运行身份,则会提示您输入用户运行身份密码。如果知道是这种情况,您可以包括 --service-runas-password 选项。若要查看 upgrade-tsm 脚本的所有选项,请使用 -h 选项:
      upgrade-tsm -h

  16. 升级完成后,一个浏览器窗口将打开,并显示 TMS 登录页面。登录到 TSM。将会提示您激活或注册 Tableau Server(如果需要执行这些步骤)。

    注意:如果窗口未自动打开,请打开浏览器窗口并转到:

    https://<tsm-computer-name>:8850

  17. 启动 Tableau Server:

    在 Web UI 中

    • 单击“Tableau Server 已停止”,并单击“启动 Tableau Server”

    • 在命令行上:

      1. 在初始节点上,以管理员身份打开命令提示符。

      2. 启动 Tableau Server:

        tsm start

        如果遇到指出无法识别命令的错误,请关闭所有命令窗口,然后以管理员身份打开命令提示符。

  18. 上载文件。使用以下 TSM 命令从以前的 Tableau Server 中上载文件。必须使用 TSM 上载这些文件。不要将这些文件复制到 Tableau Server 文件夹分层结构中的目标,而是要将它们复制到临时目录(例如,C:\temp),然后运行 TSM 命令将文件复制到系统中。

    上载了文件后,客户端文件服务进程会将文件分发到安装中的相应节点。

    • 自定义徽标文件。如果使用自定义图像对 Tableau Server 门户进行了自定义,请运行以下命令:

      tsm customize --header-logo <file> --signin-logo <file> --logo <file>

    • SAML 文件。为 SAML SSO 运行以下命令:

      tsm authentication saml configure --cert-file <file> --key-file <file> --idp-metadata <file>

      如果为数据源委派使用 SAML,请运行以下命令:

      tsm data-access set-saml-delegation --cert-file <file> --key-file <file>

    • Kerberos 密钥表文件。运行以下命令:

      tsm authentication kerberos configure --keytab-file <file>

    • 相互 SSL 文件。按照此处的说明进行操作:

      配置相互 SSL 身份验证

    • Open ID 文件。运行以下命令:

      tsm authentication openid configure --metadata-file <file>

    如果运行上述任何命令,您还需要应用未完成的更改:

    tsm pending-changes apply