使用外部文件存储进行备份和还原

如果在 Tableau Server 上启用了外部文件存储,则无法使用 tsm maintenance backup 命令对 Tableau Server 存储库和文件存储数据进行备份。相反,请使用“快照”备份过程创建网络共享的时间点快照。

备份策略:

您使用的备份策略取决于您的恢复计划。快照备份过程本身可能不够,因为它只创建文件存储的备份(如果需要,还创建存储库数据的备份),并且您可能需要其他配置和设置才能进行完全恢复。

重要信息:我们强烈建议您在执行升级之前禁用计划任务。这包括对数据内容的所有更新,应在创建升级前备份之前完成。这可能涉及禁用在 Tableau Server 之外触发的作业,例如通过基于 REST API 的数据提取刷新或使用 tabcmd 启动的作业。

下面是一些方案,阐明了快照备份过程何时可能足够,何时可能不够:

  • 备用 Tableau Server — 如果您维护备用 Tableau Server 以便在生产服务器停机时使用,创建快照备份并定期将其还原到备用服务器可能就足够了。您的备份计划应依据恢复点目标制定。

  • 新的 Tableau Server,不需要现有配置- 如果您计划在发生灾难时使用新的 Tableau Server 安装,但不一定需要使用现有 Tableau Server 安装中的配置和设置,您可以安装新的 Tableau Server 实例并使用快照来还原您的数据。
  • 新的 Tableau Server,需要现有配置 - 如果您计划使用包括现有配置和设置以及备份日期的新 Tableau Server 安装,则需要额外的文件以及快照备份。若要执行完整备份(包括所有配置和设置),请按照以下说明操作:

    1. 导出拓扑和配置数据。这将导出大多数 Tableau Server 配置和拓扑。有关详细信息,请参见执行 Tableau Server 的完整备份和还原
    2. 创建文件存储(以及存储库数据,如果需要)的网络共享快照,如本主题的使用外部文件存储进行备份和还原部分所述。
    3. 记录导出中未包括的设置。其中包括系统用户帐户的值、协调服务部署配置以及自定义设置。有关详细信息,请参见执行 Tableau Server 的完整备份和还原

配置为具有外部文件存储的 Tableau Server

如果您的 Tableau Server 配置为具有外部文件存储,您的备份过程需要包括创建具有外部文件存储的网络共享的时间点快照备份。以下过程描述了如何实现这一点。

注意:如果您同时拥有外部文件存储和外部存储库,请参见配置为具有外部文件存储和外部存储库的 Tableau Server

创建快照备份

使用以下步骤创建快照备份:

  1. 准备快照备份。

    运行以下命令创建存储库备份文件,并将其暂时复制到网络共享。在快照准备过程中,Tableau Server 将继续正常运行。为确保快照一致,删除未使用的数据提取的内部进程将暂停。完成后面的步骤中描述的备份过程后,此过程将恢复。

    tsm maintenance snapshot-backup prepare

    准备步骤完成后,您应该会看到以下消息:准备快照备份成功

    确认存储库备份文件是在网络共享上创建的。

    注意:准备步骤将创建存储库、KMS 和资产密钥的备份文件。如果您使用的是加密密钥解决方案的云解决方案,您将需要访问用于解密还原所需密钥的 CMK。有关 AWS 加密密钥解决方案的详细信息,请参见AWS 密钥管理系统。有关 Azure 加密密钥解决方案的详细信息,请参见Azure Key Vault

  2. 创建网络共享的快照。

    使用适当的过程创建网络共享的快照。快照是共享的只读版本,在特定时间点拍摄。这将包括您的文件存储数据,以及在上一步中临时复制到共享的存储库备份文件。创建此网络共享快照所采取的步骤取决于您的网络。有关详细信息,请参见网络文档。

  3. 完成快照备份过程。

    运行以下命令以完成备份过程并重新启动暂停的内部进程。这将会移除复制到网络共享的临时存储库备份文件。

    tsm maintenance snapshot-backup complete

    确认临时存储库备份文件已从网络共享中移除。

还原快照备份

这些步骤同时适用于单节点和多节点 Tableau Server 安装。

  1. 停止 Tableau Server。

    在命令提示符处,运行以下命令:

    tsm stop

  2. 通过将网络共享快照还原到网络来还原文件存储数据。具体步骤将取决于您的网络。

  3. 还原存储库数据。

    使用以下命令来还原存储库数据:

    tsm maintenance snapshot-backup restore

    注意:如果您正在使用加密密钥解决方案的云解决方案,请确保正在还原备份的服务器对部署 CMK 的云实例具有解密访问权限。

  4. 重新启动 Tableau Server。

    在命令提示符处,运行以下命令:

    tsm start

配置为具有外部文件存储和外部存储库的 Tableau Server

如果您的 Tableau Server 配置为具有外部文件存储和外部存储库,您需要执行一些特殊步骤来创建备份。这些步骤包括创建具有外部文件存储的网络共享的时间点快照备份,并可能包括单独备份您的外部存储库。以下过程描述了如何实现这一点。

注意:如果您有外部文件存储但使用的是默认存储库,请参见配置为具有外部文件存储的 Tableau Server

备份存储库

当您同时拥有外部文件存储和外部存储库时,您有两种备份存储库数据的选项。您可能会选择其中每一个的原因如下:

  • 将存储库备份包含在网络共享快照中:

    便于管理。您不必单独备份存储库,备份与文件存储数据同步。

  • 独立备份存储库:

    单独备份外部存储库可能会更快,尤其是在使用允许实例快照备份的云解决方案的情况下。备份文件的大小会显著影响准备网络共享快照所需的时间。

选项 1:将存储库备份包含在网络共享快照中

创建快照备份

  1. 准备快照备份。

    运行以下命令创建存储库备份文件,并将其暂时复制到网络共享。在快照准备过程中,Tableau Server 将继续正常运行。为确保快照一致,删除未使用的数据提取的内部进程将暂停。完成后面的步骤中描述的备份过程后,此过程将恢复。

    tsm maintenance snapshot-backup prepare --include-pg-backup

    注意:从 2021.1 开始,如果您同时启用了外部文件存储和外部存储库,则必须使用 --include-pg-backup 选项创建存储库备份。如果您从 2021.1 之前的版本升级,有脚本要运行或计划备份,并且希望继续包含存储库备份,请在准备命令中添加 --include-pg-backup 选项,如下所示。对于 2021.1 之前的版本,您不需要该选项,系统会自动包含存储库备份。

    准备步骤完成后,您应该会看到以下消息:准备快照备份成功

    确认存储库备份文件是在网络共享上创建的。

    注意:准备步骤将创建存储库、KMS 和资产密钥的备份。如果您使用的是加密密钥解决方案的云解决方案,您将需要访问用于解密还原所需密钥的 CMK。有关 AWS 加密密钥解决方案的详细信息,请参见AWS 密钥管理系统。有关 Azure 加密密钥解决方案的详细信息,请参见Azure Key Vault

  2. 创建网络共享的快照。

    使用适当的过程创建网络共享的快照。快照是共享的只读版本,在特定时间点拍摄。这将包括您的文件存储数据,以及在上一步中临时复制到共享的存储库备份文件。创建此网络共享快照所采取的步骤取决于您的网络。有关详细信息,请参见网络文档。

  3. 完成快照备份过程。

    运行以下命令以完成备份过程并重新启动暂停的内部进程。这还会移除复制到网络共享的临时存储库备份文件。

    tsm maintenance snapshot-backup complete

还原快照备份

这些步骤同时适用于单节点和多节点 Tableau Server 安装。

重要信息: 如果您使用 tsm maintenance(备份和还原)方法执行蓝/绿升级或手动升级 Tableau Server 2021.4(或更低版本),则必须启用 legacy-identity-mode,然后才能还原到 Tableau Server 2022.1(或更高版本)。有关详细信息,请参见对身份迁移问题进行故障排除

  1. 停止 Tableau Server。

    在命令提示符处,运行以下命令:

    tsm stop

  2. 通过将网络共享快照还原到网络来还原文件存储数据。具体步骤将取决于您的网络。

  3. 还原存储库数据。

    使用以下命令来还原存储库数据:

    tsm maintenance snapshot-backup restore

    注意:如果您正在使用加密密钥解决方案的云解决方案,请确保正在还原备份的服务器对部署 CMK 的云实例具有解密访问权限。

  4. 重新启动 Tableau Server。

    在命令提示符处,运行以下命令:

    tsm start

选项 2:单独备份存储库

仅当外部存储库的主机平台允许您进行快照备份时,才建议使用此选项。如果您使用 Azure 作为主机平台,我们建议使用选项 1。

创建快照备份

  1. 准备快照备份。

    运行以下命令创建存储库备份文件,并将其暂时复制到网络共享。在快照准备过程中,Tableau Server 将继续正常运行。为确保快照一致,删除未使用的数据提取的内部进程将暂停。完成后面的步骤中描述的备份过程后,此过程将恢复。

    tsm maintenance snapshot-backup prepare

    准备步骤完成后,您应该会看到以下消息:准备快照备份成功

    注意:准备步骤将创建 KMS 和资产密钥的备份。如果您使用的是加密密钥解决方案的云解决方案,您将需要访问用于解密还原所需密钥的 CMK。有关 AWS 加密密钥解决方案的详细信息,请参见AWS 密钥管理系统。有关 Azure 加密密钥解决方案的详细信息,请参见Azure Key Vault

  2. 创建网络共享的快照。

    使用适当的过程创建网络共享的快照。快照是共享的只读版本,在特定时间点拍摄。这将包括您的文件存储数据。创建此网络共享快照所采取的步骤取决于您的网络。有关详细信息,请参见网络文档。

  3. 创建存储库的备份:使用托管外部存储库的平台的备份技术来创建备份。

    重要信息:网络共享和存储库备份的快照必须在完成准备步骤(步骤 1)后的 3 小时 30 分钟内完成。这是为了确保文件存储和存储库备份保持同步,并使还原正常工作。

    有关创建 AWS DB 实例快照的详细信息,请参见创建 DB 快照

    有关创建 Azure DB 实例备份的详细信息,请参见灵活服务器中的备份和还原(PostgreSQL 12 及更高版本)或在单一服务器中进行备份和还原(PostgreSQL 11 或更低版本)。

    注意:如果您正在使用加密密钥解决方案的云解决方案,请确保正在还原备份的服务器对部署 CMK 的云实例具有解密访问权限。

  4. 完成快照备份过程。

    运行以下命令以完成备份过程并重新启动暂停的内部进程。

    tsm maintenance snapshot-backup complete

还原快照备份

这些步骤同时适用于单节点和多节点 Tableau Server 安装。

  1. 使用外部存储库的数据库备份。如果您正在使用云平台托管您的存储库,通常这需要您创建一个新的数据库实例,将备份恢复到该实例中。

    有关创建新实例的详细说明,请参见安装外部存储库中的托管解决方案选项。

  2. 使用随外部 PostgreSQL 存储库一起安装 Tableau Server主题的步骤 1 中的说明,为新实例创建配置文件。
  3. 停止 Tableau Server。

    在命令提示符处,运行以下命令:

    tsm stop

  4. 如果外部存储库的还原需要新的数据库实例,请使用以下命令将 Tableau Server 指向新的数据库实例:

    tsm topology external-services repository replace-host -f <filename>.json -c <ssl certificate file>.pem

    .json 文件是您在步骤 2 中创建的配置文件。证书文件是您从新的数据库实例下载的 SSL 证书。

  5. 通过将网络共享快照还原到网络来还原文件存储数据。具体步骤将取决于您的网络。

    意:某些技术要求您在进行还原时创建新的网络共享。如果这适用于您的网络连接存储,您可以在停止 Tableau 服务器之前进行还原。如果您正在将文件存储数据还原到新的网络共享,则必须将 Tableau Server 配置为使用新的网络共享。有关详细信息,请参见将 Tableau Server 配置为使用其他外部存储

  6. 运行以下命令以还原 KMS 和资产密钥:

    tsm maintenance snapshot-backup restore

    注意:如果您正在使用加密密钥解决方案的云解决方案,请确保正在还原备份的服务器对部署 CMK 的云实例具有解密访问权限。

  7. 运行以下命令以重新启动 Tableau Server:

    tsm start

 

谁可以执行此操作

Tableau Server 管理员可以备份和还原 Tableau Server。此外,您必须具有访问和在外部存储上执行快照备份的权限。

感谢您的反馈!您的反馈已成功提交。谢谢!