准备升级 - tsm 之前的版本 (Windows)

若要正确地准备从 Windows 版 Tableau Server 2018.1 或更低版本升级到版本 2018.2 或更高版本,请收集有关您的现有安装、与安装和升级相关的关键文件的信息,并完成升级前任务。

收集自定义配置信息

如果要升级现有硬件,则将保留您的配置,但是由于以下一些原因,好的做法是收集关于现有安装的此配置信息:当您配置测试环境时,您需要此信息;如果要在升级过程中迁移到新硬件,则您需要此信息;如果您在升级后发现一些异常,则可以使用此信息确认已按预期方式配置了升级的 Tableau Server

收集此信息和任何关联的文件,并将它们保存到不在任何 Tableau Server 计算机上的位置。

以下列表包括您应收集的信息类型的示例:

  • 自定义 这包括非默认端口、超时值、自定义徽标图像和字体。

    此外,请记下影响 Tableau Server 的 Windows 路径环境变量。

  • SMTP 配置。

    对于 TSM 之前的 Tableau Server 版本(版本 2018.1 或更低版本),您可以在配置实用工具的“SMTP 设置”选项卡上看到您当前的 SMTP 配置。有关详细信息,请参见配置_smtp.htm(链接在新窗口中打开)

  • SSL 配置和证书。

    对于 TSM 之前的 Tableau Server 版本(版本 2018.1 或更低版本),您可以在配置实用工具的“SSL”选项卡上看到您的 SSL 配置。此选项卡还会列出证书和证书密钥文件的位置。您应该复制这些文件并将其保存在安全位置。有关详细信息,请参见配置外部 SSL(链接在新窗口中打开)

  • SAML 配置、证书和任何 IdP 元数据文件。

    对于 TSM 之前的 Tableau Server 版本(版本 2018.1 或更低版本),您可以在配置实用工具的“SAML”选项卡上看到您的当前 SAML 配置,包括证书、密钥和元数据文件。将这些文件的副本保存到安全位置。有关详细信息,请参见“配置服务器范围 SAML”(链接在新窗口中打开)

  • Kerberos 配置。

    对于 TSM 之前的 Tableau Server 版本(版本 2018.1 或更低版本),您可以在配置实用工具的“Kerberos”选项卡上看到您的当前 Kerberos 配置,包括应该复制和保存的密钥表文件的位置。有关详细信息,请参见配置 Kerberos(链接在新窗口中打开)

  • OpenID 配置。

    对于 TSM 之前的 Tableau Server 版本(版本 2018.1 或更低版本),您可以在配置实用工具的“OpenID”选项卡上看到您的当前 OpenID 配置详细信息。有关详细信息,请参见针对 OpenID 配置 Tableau Server(链接在新窗口中打开)

  • 附加节点配置。收集任何附加 Tableau Server 节点的配置,包括您复制到这些节点的任何证书或其他支持文件。

    对于 TSM 之前的 Tableau Server 版本(版本 2018.1 或更低版本),您可以在配置实用工具的“服务器”选项卡上找到有关每个节点上配置的进程数的详细信息。

  • 其他值。请记下您在生产环境中具有的项目、组、工作簿、视图、数据源和用户的数目。具有此信息便于在升级后进行快速检查,以确保按预期方式还原了一切内容。

收集环境配置

您在升级过程中需要采取的步骤取决于是要在相同的硬件上安装升级,还是要迁移到新硬件。在相同硬件上升级非常简单,需要的手动步骤最少(需要采取的步骤取决于您要升级的版本、您要迁移到的版本,以及您的现有安装是否在默认位置)。迁移到新硬件要求您手动还原您的 Tableau Server 数据,并在安装新版本后重新配置您的设置。

将安装程序文件复制到本地文件共享

在升级 Tableau Server 之前,您将需要以下安装程序文件:

  • 现有 Tableau Server 版本的安装程序。

    您可能不需要安装程序。但是,我们建议您将它准备好,以防在升级过程中出现问题。这样,您可以使用安装程序与您的服务器备份将您的安装还原到其升级前的状态。

    注意:如果您没有现有版本的安装程序,则可以从备用下载站点(链接在新窗口中打开)下载该程序。将安装程序保存在不在 Tableau Server 的生产或测试版本中的一个安全位置。如果您需要在升级后恢复为现有版本,则将需要安装程序。

  • 新版本 Tableau Server 的安装程序。

更新 tabcmd

每个版本的 Tableau Server 都会发布新版本的 tabcmd。如果您安装 tabcmd 所在的计算机不是 Tableau Server 安装的一部分,则作为升级过程的一部分,您需要在这些计算机上更新 tabcmd。有关详细信息,请参见tabcmd

备份 Tableau Server 数据

在开始升级过程之前备份 Tableau Server 的安装,并将备份文件保存到一个安全位置(例如,网络共享)。不要将其保存到作为 Tableau Server 安装一部分的任何计算机上。此备份提供设置升级环境测试版本所需的数据。如果升级过程失败,则还允许您进行恢复。

注意: 

  • 建议您在即将进行备份之前在您的生产环境中禁用订阅和计划,并在备份完成之后重新启用它们。当您在测试环境中恢复您的备份时,这样做将有助于避免您的用户收到重复的订阅和电子邮件。

  • 如果具有大型安装或具有许多数据提取,完整备份可能需要大量时间。

  • 从进行备份到进行升级这段时间所做的任何更改都将丢失,因为它们未包括在备份中。

  • 您只能从身份存储与运行服务器类型相同的备份中进行还原。例如,使用本地身份验证的服务器中的备份只能还原到使用本地身份验证初始化的 Tableau Server,但使用 Active Directory 身份验证的服务器中的备份无法还原到使用本地身份验证初始化的服务器。

有关详细信息,请参见“删除不需要的文件”(链接在新窗口中打开)“备份 Tableau Server 数据”(链接在新窗口中打开)

在卸载 Windows 版 Tableau Server 2018.1.x 或更低版本之前保存资产密钥文件

如果从 Windows 版 Tableau Server 版本 2018.1.x 或更低版本升级,并且生成了自定义资产密钥,请在卸载更低版本之前保存 asset_keys.yml 文件的副本。将此文件存储在不是 Tableau Server 安装一部分的安全位置(例如,网络共享)。

大多数情况下,您不需要此文件。升级成功时,升级过程会自动更新资产密钥。只有在升级失败,并且需要安装新版本的 Tableau Server 并手动还原备份文件时,您才需要此文件。在这种情况下,您还需要在执行还原时指定资产密钥文件。

查找现有的资产密钥文件

如果生成了自定义资产密钥文件,数据目录中将有一个 asset_keys.yml 文件。默认情况下,此目录为:

\ProgramData\Tableau\Tableau Server\data\tabsvc\config

如果未看到 asset_keys.yml 文件,您可以跳过此步骤。

还原 2018.2 之前的 Windows 版 Tableau Server 备份并指定资产密钥文件

若要将备份从 Windows 版 Tableau Server 2018.1.x 或更低版本手动还原到 Tableau Server 2018.2 或更高版本,并包括资产密钥,请使用 tsm,例如:

tsm maintenance restore --file <backup> --ak <asset_key_file>

有关详细信息,请参见tsm maintenance restore

检查产品维护状态

如果您尝试升级安装的 Tableau Server,但它的产品密钥过了维护期,则您升级的 Tableau Server 将不会获得许可,并且升级将失败。在升级之前,请确保服务器维护没有过期。

如果您的维护已过期,请选择产品密钥并单击“刷新”。如果此操作未能更新维护日期,请在 Tableau 客户门户中检查是否有具有更新维护日期的替代 Tableau Server 产品密钥。如有任何疑问或疑虑,请与 Tableau 技术支持(链接在新窗口中打开)联系。升级过程中将重新激活产品密钥。

有关详细信息,请参见激活并注册 Tableau Server。如果服务器无法访问 Internet,请参见脱机激活 Tableau Server - 添加许可证

重要信息:如果从 Tableau Server 版本 2018.1 或更低版本升级,请确保在卸载 Tableau 之前关闭“管理产品密钥”应用程序。保持该应用程序打开可能导致升级失败。

禁用数据提取刷新

从 10.5 开始,数据提取使用 .hyper 格式,而不是 .tde 格式。将文件格式升级到 .hyper 后,无法恢复为 .tde 格式,并且无法在 10.5 之前的 Tableau Desktop 版本中打开。有关详细信息,请参见数据提取升级为 .hyper 格式

Tableau Server 上,以下任务会将 .tde 数据提取升级为 .hyper 数据提取:

  • 手动刷新

  • 计划的完全或增量数据提取刷新

  • 通过 tabcmd、Extract API 2.0 或数据提取命令行实用工具执行的自动刷新任务

  • 使用 tabcmd 或数据提取命令行实用工具自动将数据追加到数据提取的任务

注意:我们建议您禁用任何导致数据提取升级的自动化任务和计划。如果您的 Desktop 版本尚未升级到 10.5,则 Desktop 用户将无法打开升级的 .hyper 数据提取。在进行服务器升级之后,您可能还需要先手动测试一些数据提取,然后重新启用任何计划或自动刷新任务。

有关数据提取刷新计划的详细信息,请参见启用数据提取刷新计划和失败通知

确保您的许可证具有足够的用户容量

从具有旧站点角色的 Tableau 2018.1 或更低版本许可证升级时,所有用户都将自动映射到其当前等效站点角色。在升级之前,请务必确保您的新许可证支持您拥有的用户数。否则,某些用户可能会在升级后变为未许可。

下表显示了旧站点角色与当前站点角色的映射。

2018.1 旧站点角色 2018.1 基于用户的站点角色 2018.2 及更高版本的站点角色
服务器管理员 服务器管理员 服务器管理员
站点管理员 站点管理员 Explorer 站点管理员 Explorer
Publisher Explorer(可发布) Explorer(可发布)
Interactor Explorer Explorer
Viewer(查看者) 只读 Viewer(查看者)

用户始终使用他们在任何站点上拥有的最高级别角色,称为“最大站点角色”。在转换许可证之前,您可以查看用户的最大站点角色。有关详细信息,请参见权限

如果当前角色的用户数多于许可证,则应通过更改用户角色、取消许可用户或移动用户,将用户重新分配给可用角色或平衡用户。在升级到 2018.2 或更高版本后,可以使用以下步骤同步新用户组:

  1. 取消许可所有用户。

  2. 创建五个 Active Directory (AD) 组(每个站点角色一个)。

  3. 将用户导入相应站点角色的正确 AD 组中,然后将这些组与 Tableau Server 同步。有关详细信息,请参见通过 Active Directory 创建组

  4. 重新启动 Tableau Server。用户将自动迁移到其新站点角色。内容权限不受影响。

在使用虚拟机 (VM) 的情况下规划您的策略

如果在 VM 上(本地或云)上运行 Tableau Server,请注意与许可相关的复杂情况。如果只是在 VM 上升级 Tableau Server,则无需执行与许可相关的任何额外操作。如果计划克隆 VM 以创建要升级的新的生产环境或测试环境,则需要在克隆之前停用任何 Tableau Server 许可证。如果不这样做,新的 VM 环境可能会最终具有不可信的许可证,并且任何升级尝试都将失败。您最终还可能达到许可证的最大激活次数。

为了避免在 VM 上出现许可问题,请先停用所有 Tableau 许可证,然后再克隆 VM 或允许永久关闭 VM。

若要克隆 VM,请在克隆之前确保 Tableau 处于未许可状态(已停用所有许可证)。克隆 VM 之后,在该处激活 Tableau 许可证并继续升级。如果您有基于角色的许可,请确保激活的第一个许可证是 Creator 或 Explorer 许可证,否则您可能会失去对新 Tableau 安装的管理员访问权限。

感谢您的反馈!