维护--备份和还原

Tableau Server 管理员应执行常规数据库维护、监视服务器上的磁盘使用情况、清理不必要的文件来释放服务器上的空间，以及备份 Tableau Server 及其数据。采取这些步骤可帮助确保 Tableau Server 以最高效率运行。

您可以使用 Tableau 服务管理器 (TSM) 命令行工具来备份和还原 Tableau 数据。Tableau 数据包括数据提取文件，以及 Tableau Server 自己的 PostgreSQL 数据库，其中存储工作簿和用户元数据和服务器配置数据。Tableau Server 日志文件捕获活动并可帮助诊断问题。日志写入到服务器上的文件夹中，您可以存档并移除它们以节省磁盘空间。

注意：您可以使用 tsm maintenance restore 命令来还原使用 tabadmin backup 和 tsm maintenance backup 创建的 Tableau Server 备份 。在还原 Tableau Server 时，通过其他方式建立的数据库备份以及虚拟计算机快照是无效数据源。

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

平台兼容性

您可以使用通过 Linux 版 Tableau Server 创建的备份来还原 Windows 版 Tableau Server 版本 2018.2 及更高版本。

您无法使用通过 Linux 版 Tableau Server 创建的备份来还原 Windows 版 Tableau Server 的早期版本（版本 2018.1 及更低版本）。

您可以使用通过 Windows 版 Tableau Server（版本 2018.2 及更低版本）创建的备份来还原 Linux 版 Tableau Server。有关在 Linux 版 Tableau Server 上还原 Windows 备份的详细信息，请参见将 Tableau Server 从 Windows 迁移到 Linux(链接在新窗口中打开)。

备份和还原的磁盘空间使用情况

创建备份所需的可用磁盘空间因 Tableau Server 存储库和文件存储服务中的数据量及其与 tabadmincontroller 服务的搭配而异。在备份过程中，用于清理旧数据提取的后台任务会暂停。这意味着，在备份持续时间内，数据提取刷新将会将额外文件保留在原处，从而增加磁盘空间使用量。如果您的备份需要很长时间，或者您的组织使用许多定期更新的数据提取，则可能会导致使用大量的临时磁盘空间。备份完成后，将移除这些临时文件。

下表列出了备份的磁盘空间要求，具体取决于节点是承载存储库、文件存储、控制器还是它们的某些组合。

存储库	文件存储	控制器	所需的磁盘空间
			存储库数据的 3 倍 + 250 MB 若要获取存储库数据的估计值，请检查 目录的大小。 若要获取存储库数据的确切大小，请打开备份文件并使用 workgroup.pg_dump 文件的大小。
			文件存储数据的 1.5 倍 若要获取文件存储数据（数据提取、流程等）的估计值，请检查 目录的大小。
			存储库数据的 3 倍 + 250 MB + 文件存储数据的 2.5 倍
			存储库数据的 3 倍 + 250 MB + 文件存储数据的 1.5 倍
			存储库数据的 3 倍 + 250 MB + 文件存储数据的 1.5 倍
			存储库数据的 3 倍 + 250 MB + 文件存储数据的 2.5 倍
			存储库数据的 3 倍 + 250 MB + 文件存储数据的 1.5 倍

还原磁盘空间要求

您必须具有足够的磁盘空间才能成功运行数据库还原过程。

若要还原 Tableau Server，请执行以下操作：

• 在控制器节点上，您需要至少相当于备份存档大小的可用空间。

• 在存储库节点上，您需要至少相当于备份存档中存储库数据大小三倍的可用空间，加上 250 MB，再加上 pgsql 数据目录的大小。

• 在文件存储节点上，您需要至少相当于备份存档中 dataengine 文件夹大小两倍的可用空间。

备份 Tableau Server 的最佳做法

我们建议遵循这些安全性和性能最佳做法。

保护备份文件

尽管在以内部方式存储在磁盘上时配置密文已加密，但在将这些配置导出到备份文件时，某些密文将以纯文本形式写入文件。管理员负责采取措施来保护备份文件。有各种可用选项：

• 将文件写入加密的文件系统。

• 将文件写入受物理保护并仅限特定用户访问的磁盘。

• 对备份文件进行加密。

最大限度地提高备份效率

可通过若干方式来最大程度地提高备份效率。您的环境可能会对其中每种方式的效率产生影响，因此请使用您的数据进行测试，确定哪种方式效率最高。

使用拓扑配置进行优化：

• 将文件存储与管理控制器放在同一节点上可以减少或消除备份过程中在节点之间传输数据的需要，从而缩短备份 Tableau Server 所需的时间。如果您的组织使用许多数据提取，则情况尤其如此。

• 将存储库 (Pgsql) 与管理控制器节点放在同一位置也有助于缩短备份时间，但节省的时间不如文件存储显著。

管理控制器通常位于初始节点上，除非您遇到初始节点故障并且将控制器转移到另一节点。

使用备份策略进行优化：

备份是一个资源密集型过程。如果可能，在非高峰时段进行备份通常是一个很好的策略。但是，这取决于您的要求以及 Tableau Server 数据的更新频率以及您的还原要求。有关备份和灾难恢复的详细解释，请参见Tableau Server 灾难恢复。以下是一些备份策略，请采纳它们以适应您的需求

• 存储类型：通常建议为备份使用固态磁盘。与传统旋转磁盘相比，SSD 可帮助您更快地完成备份。

• 备份压缩：您可以选择在进行或不进行压缩的情况下运行备份。使用压缩进行备份时，备份大小将相对较小，但性能可能会变慢。因此，如果您的目标更注重速度，请选择 --skip-compression 选项：

  在备份 Tableau Server 时使用 --skip-compression 选项。这样，将会在不使用压缩的情况下创建备份，从而生成较大的备份文件，但可缩短备份完成所需的时间。有关详细信息，请参见tsm maintenance backup。

• 快照备份：仅当您将 Tableau Server 配置具有外部文件存储时，此选项才可用。尽管快照备份的性能取决于网络连接存储的类型，但一般快照备份比传统的 Tableau Server 备份要快。有关详细信息，请参见Tableau Server 外部文件存储。

此部分中的其他文章

• 执行 Tableau Server 的完整备份和还原

您可以使用以下步骤来备份 Tableau Server 部署。具体而言，这些步骤介绍如何通过备份数据和资产的集合恢复服务器的克隆。

注意：备份过程可能会长时间运行。由于备份在运行时无法运行其他作业，因此我们建议您在非工作时间运行备份。

备份数据类型

Tableau Server 可以生成两种类型的备份数据。如果您必须在恢复方案中还原服务器，我们建议对每种类型都执行定期备份：

• Tableau Server 管理的数据包含 Tableau PostgreSQL 数据库或存储库以及文件存储，其中包含工作簿和用户元数据、数据提取文件以及配置数据。使用 TSM 创建备份时，所有这些数据都保存在一个扩展名为 .tsbak 的文件中。此数据使用 tsm maintenance backup 命令进行备份。

  注意：如果文件存储是在 Tableau Server 外部配置的，则不能使用 tsm maintenance backup 命令来备份 Tableau Server 数据。有关如何备份此数据的详细信息，请参见使用外部文件存储进行备份和还原。

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

  您只能将备份文件还原到与在其上创建备份的版本相同或比该版本新的 Tableau Server 版本。您无法还原到 Tableau 的较旧版本。

• 您只能将备份文件还原到与在其上创建备份的版本相同或比该版本新的 Tableau Server 版本。您无法还原到 Tableau 的较旧版本。

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

• 配置和拓扑数据：包括完全恢复服务器所需的大多数服务器配置信息。SMTP、通知、某些身份验证资产都是可导出进行备份的配置数据的示例。拓扑数据定义 Tableau Server 进程在单服务器和多节点部署中的配置方式。配置和拓扑数据使用 tsm settings export 命令进行备份。

注意：您可以更改 tsm maintenance backup 命令使用的文件路径的默认值。有关详细信息，请参见tsm File Paths。

备份需要手动过程的资产

某些配置数据未包括在 tsm settings export 命令中，因此必须手动记录和还原。tsm settings export 操作中会排除以下配置数据。在备份维护过程中，您应记录以下 Tableau Server 配置数据：

• 系统用户帐户。Tableau Server 安装程序使用非特权用户帐户 NetworkService。此帐户用于访问 Tableau Server 资源。如果您未更改此帐户，则无需记录它。

• 协调服务部署配置。如果运行多节点群集，请记录哪些群集在运行协调服务进程。若要查看节点上的进程配置，请运行 tsm topology list-nodes -v。

• 自定义设置。如果组织为 Tableau Server 网页使用自定义标题或登录徽标，您应随备份组合一起包括这些资产的副本。请参见tsm customize。

• 大多数身份验证资产。TSM 不会备份大多数证书文件、密钥文件、密钥表文件或者其他身份验证相关资产。有三种例外情况。

  但是，将不会备份所有其他身份验证相关资产。举例来说，如果您使用 tsm data-access repository-access enable 命令启用了对 PostgreSQL 数据库的访问，请确保记录您配置的每个帐户的名称/密码对。将不会备份这些凭据。相互 SSL 的证书和密钥不会包括在备份中。

• 将对内部 PostgreSQL 数据库（如果启用）的公共证书和私钥进行备份。

• 将对外部 SSL 的证书和密钥进行备份并包括在配置数据中。

• 将对通过 tsm security custom-cert add（如果添加）安装的自定义证书进行备份。

• LDAP 资产。TSM 不会备份密钥表文件、配置文件或者其他 LDAP 相关资产。

内部服务器密文和存储库密码是不会导出的加密相关配置。不过，您无需记录配置值。在还原过程中初始化新实例时，将会创建新的密文。

为恢复备份 Tableau Server

Tableau Server 包括一些命令，您可以运行这些命令来生成 Tableau Server 的备份数据。

在备份 Tableau Server 之前，请验证是否已针对以下方案正确配置了权限：

• 安装在非默认驱动器上的 Tableau Server：如果您在非默认驱动器或文件夹中安装了 Tableau Server，则需要为“网络服务”帐户手动配置权限。您还可能需要为运行身份帐户配置其他权限。请参见安装在非默认位置。

• 将 Windows 版 Tableau Server 备份到网络驱动器时，计算机帐户必须对在其中写入备份文件的网络共享具有写入访问权限（通常情况下不是这样，如果您想将服务器备份到网络共享，您有责任进行配置）。

若要备份服务器拓扑和配置数据，请使用 tsm settings 命令。

1. 运行 tsm settings export 命令时，拓扑和配置数据都会包括在内。数据以 json 文件形式导出。通过运行以下命令来指定 json 文件的名称和位置：

   tsm settings export -f

   注意：由于备份包含密文，因此我们建议您对备份进行加密，并将其存储在安全的地方。有关 Tableau Server 密文的详细信息，请参见管理服务器密文。

2. 备份存储库和文件存储数据。存储库数据使用 tsm maintenance backup 命令进行备份。通过运行以下命令来指定备份文件的名称和位置：

   tsm maintenance backup -f

   系统将在数据目录的临时位置中汇编备份文件，并将该文件写入 TSM basefilepath.backuprestore变量中定义的目录。默认情况下：

   C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\

   有关备份文件的写入位置以及如何更改该位置的详细信息，请参见tsm File Paths。注意：即使您更改备份位置，备份过程也会使用数据目录中的临时位置来汇编备份文件。

   注意：如果文件存储是在 Tableau Server 外部配置的，则不能使用 tsm maintenance backup 命令来备份 Tableau Server 数据。有关如何备份此数据的详细信息，请参见使用外部文件存储进行备份和还原。

还原核心 Tableau Server 功能

在恢复方案中，以下过程使用前两个部分中的资产重建 Tableau Server。

注意：如果只需要恢复其他方面功能正常的 Tableau Server 上的存储库，请参见还原备份内容。如果运行分布式部署，并且初始节点已出现故障，请参见从初始节点故障中恢复。

您必须准备好以下资产：

• 拓扑和配置数据：这是 tsm settings export 命令生成的 json 文件。

• 存储库备份文件：这是 tsm maintenance backup 命令生成的文件，扩展名为 .tsbak。

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

  使用 tsm maintenance restore 还原 Tableau 数据时，备份文件 (.tsbak) 中的内容会覆盖数据提取文件以及 PostgreSQL 数据库的内容。如果您正在运行 Tableau Server 的分布式安装，请在运行 TSM 控制器的节点（通常是初始节点）上执行还原。

• 备份资产：如前一部分中所述，这些资产包括记录的配置的列表。

还原独立 Tableau Server

1. 在要还原 Tableau Server 的计算机上，安装 TSM。如果您的组织使用非默认系统用户帐户（如本主题的前面部分中所述），则您必须在此步骤中指定用户。

2. 激活并注册 Tableau Server。

3. （可选）。配置本地防火墙。请参见安装之前...(链接在新窗口中打开)中的“本地防火墙配置”。

4. （可选）。验证 LDAP。

5. 初始化 Tableau Server。请参见配置初始节点设置。

6. 导入拓扑和配置数据。将拓扑和配置 json 备份文件复制到计算机。通过运行以下命令来导入 json 文件：

   tsm settings import -f

7. （可选）。应用待处理的更改。在命令提示符处，运行：

   tsm pending-changes apply

8. 重新启动 Tableau Server。在命令提示符处，运行：

   tsm restart

9. 还原存储库数据。请参见还原备份内容。

还原 Tableau Server 群集

1. 在初始节点上，安装 TSM。如果您的组织使用非默认系统用户帐户（如本主题的前面部分中所述），则您必须在此步骤中指定用户。

2. 在初始节点上，激活并注册 Tableau Server。

3. （可选）。在初始节点上，配置本地防火墙。请参见安装之前...(链接在新窗口中打开)中的“本地防火墙配置”。

4. 在初始节点上，验证 LDAP（可选），并初始化 Tableau Server。请参见配置初始节点设置。

5. 在初始节点上，运行 tsm topology nodes get-bootstrap-file --file。

6. 将 bootstrap.json 文件复制到群集中的所有附加节点。

7. 在群集中的每个附加节点上，安装 Tableau Server 软件包。

8. 在初始节点上，运行 tsm topology list-nodes -v，并确保节点名称在导出的拓扑设置中未更改。如果节点名称已更改，则应使用新名称手动更新拓扑设置，或者应手动配置进程。

9. 每个节点上都需要群集控制器进程，并且需要显式添加。从初始节点中，向每个附加节点添加一个群集控制器实例，其中 是附加节点之一的 ID。将进程分别添加到每个节点。在本例中，我们将群集控制器添加到节点 2 和 3：

   tsm topology set-process -n node2 -pr clustercontroller -c 1
   tsm topology set-process -n node3 -pr clustercontroller -c 1
   tsm pending-changes apply

10. 从初始节点中部署协调服务整体。整体配置必须与以前的配置匹配。

11. 在初始节点上，导入拓扑和配置数据。将拓扑和配置 json 备份文件复制到计算机。通过运行以下命令来导入 json 文件：

    tsm settings import -f

12. 在初始节点上，应用未完成的更改。在命令提示符处，运行：

    tsm pending-changes apply

13. 在初始节点上，重新启动 Tableau Server。在命令提示符处，运行：

    tsm restart

14. 在初始节点上，还原存储库数据。请参见还原备份内容。

还原其他功能

如果以前的服务器配置为具有以下功能，则您将需要在还原的服务器上重新启用和重新配置这些功能：

• 身份验证解决方案：OpenID、外部 SSL 和受信任的身份验证。请参见身份验证。

• 站点自定义项：请参见tsm customize。

• 启用对 PostgreSQL 存储库的访问：请参见tsm data-access repository-access enable。

在还原之后重新加密数据提取

（可选）如果要使用静态数据提取加密功能，您可以在还原备份之后使用不同的加密密钥对数据提取进行重新加密。请参见静态数据提取加密。

运行 tabcmd reencryptextracts 以对给定站点上的数据提取进行重新加密。有关详细信息，请参见reencryptextracts。在您存储加密数据提取的每个站点上运行此命令。根据站点上加密数据提取的数量，此操作可能会占用大量的服务器处理负载。考虑在工作时间以外运行此操作。

• 备份 Tableau Server 数据

定期备份 Tableau Server 是正确管理和维护服务器的重要步骤。您可以使用 tsm maintenance restore 命令来还原使用 tabadmin backup 和 tsm maintenance backup 创建的 Tableau Server 备份 。在还原 Tableau Server 时，通过其他方式建立的数据库备份以及虚拟计算机快照是无效数据源，因此拥有最新的备份是至关重要的。

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

期望使用 Linux 版 Tableau Server？请参见备份 Tableau Server 数据(链接在新窗口中打开)。

Tableau Server 数据包括数据提取文件，以及 Tableau PostgreSQL 数据库，其中存储工作簿和用户元数据和服务器配置数据。使用 TSM 创建备份时，所有这些数据都保存在一个扩展名为 .tsbak 的文件中。如果您正在运行 Tableau Server 的分布式安装软件，则将备份来自所有节点的数据。

备份的频率取决于您的环境，包括服务器的使用量以及内容和用户变更量和频率。如果出现系统故障，则在备份之后发生的任何更改或更新将丢失，并且您需要还原 Tableau Server。存在的活动越多，就需要更频繁地对服务器进行备份。

除了定期备份之外，您还应始终在升级到新版本的 Tableau Server 之前创建备份。

为了防止数据丢失，应该在创建备份后将 .tsbak 文件存储在不是 Tableau Server 安装一部分的计算机上。

备份的磁盘空间使用情况

创建备份所需的可用磁盘空间因 Tableau Server 存储库和文件存储服务中的数据量及其与 tabadmincontroller 服务的搭配而异。在备份过程中，用于清理旧数据提取的后台任务会暂停。这意味着，在备份持续时间内，数据提取刷新将会将额外文件保留在原处，从而增加磁盘空间使用量。如果您的备份需要很长时间，或者您的组织使用许多定期更新的数据提取，则可能会导致使用大量的临时磁盘空间。备份完成后，将移除这些临时文件。

下表列出了备份的磁盘空间要求，具体取决于节点是承载存储库、文件存储、控制器还是它们的某些组合。

存储库	文件存储	控制器	所需的磁盘空间
			存储库数据的 3 倍 + 250 MB 若要获取存储库数据的估计值，请检查 目录的大小。 若要获取存储库数据的确切大小，请打开备份文件并使用 workgroup.pg_dump 文件的大小。
			文件存储数据的 1.5 倍 若要获取文件存储数据（数据提取、流程等）的估计值，请检查 目录的大小。
			存储库数据的 3 倍 + 250 MB + 文件存储数据的 2.5 倍
			存储库数据的 3 倍 + 250 MB + 文件存储数据的 1.5 倍
			存储库数据的 3 倍 + 250 MB + 文件存储数据的 1.5 倍
			存储库数据的 3 倍 + 250 MB + 文件存储数据的 2.5 倍
			存储库数据的 3 倍 + 250 MB + 文件存储数据的 1.5 倍

优化 Tableau Server 备份

可通过若干方式来最大程度地提高备份效率。您的环境可能会对其中每种方式的效率产生影响，因此请使用您的数据进行测试，确定哪种方式效率最高。

使用拓扑配置进行优化：

• 将文件存储与管理控制器放在同一节点上可以减少或消除备份过程中在节点之间传输数据的需要，从而缩短备份 Tableau Server 所需的时间。如果您的组织使用许多数据提取，则情况尤其如此。

• 将存储库 (Pgsql) 与管理控制器节点放在同一位置也有助于缩短备份时间，但节省的时间不如文件存储显著。

管理控制器通常位于初始节点上，除非您遇到初始节点故障并且将控制器转移到另一节点。

使用备份策略进行优化：

备份是一个资源密集型过程。如果可能，在非高峰时段进行备份通常是一个很好的策略。但是，这取决于您的要求以及 Tableau Server 数据的更新频率以及您的还原要求。有关备份和灾难恢复的详细解释，请参见Tableau Server 灾难恢复。以下是一些备份策略，请采纳它们以适应您的需求

• 存储类型：通常建议为备份使用固态磁盘。与传统旋转磁盘相比，SSD 可帮助您更快地完成备份。

• 备份压缩：您可以选择在进行或不进行压缩的情况下运行备份。使用压缩进行备份时，备份大小将相对较小，但性能可能会变慢。因此，如果您的目标更注重速度，请选择 --skip-compression 选项：

  在备份 Tableau Server 时使用 --skip-compression 选项。这样，将会在不使用压缩的情况下创建备份，从而生成较大的备份文件，但可缩短备份完成所需的时间。有关详细信息，请参见tsm maintenance backup。

• 快照备份：仅当您将 Tableau Server 配置具有外部文件存储时，此选项才可用。尽管快照备份的性能取决于网络连接存储的类型，但一般快照备份比传统的 Tableau Server 备份要快。有关详细信息，请参见Tableau Server 外部文件存储。

使用 TSM 命令行界面 (CLI) 创建备份

使用 tsm maintenance backup 命令创建由 Tableau Server 管理的数据的备份。此数据包括数据提取文件及 Tableau PostgreSQL 数据库，其中包含工作簿和用户元数据。

在备份 Tableau Server 之前，请验证是否已针对以下方案正确配置了权限：

• 安装在非默认驱动器上的 Tableau Server：如果您在非默认驱动器或文件夹中安装了 Tableau Server，则需要为“网络服务”帐户手动配置权限。您还可能需要为运行身份帐户配置其他权限。请参见安装在非默认位置。

• 将 Windows 版 Tableau Server 备份到网络驱动器时，计算机帐户必须对在其中写入备份文件的网络共享具有写入访问权限（通常情况下不是这样，如果您想将服务器备份到网络共享，您有责任进行配置）。

若要备份服务器配置数据，请使用 tsm settings 命令。使用 tsm maintenance backup 命令时，会将当前日期附加到备份文件：

tsm maintenance backup -f

有关详细信息，请参见tsm maintenance backup。

创建升级前备份

在升级 Tableau Server 之前，您应始终创建备份。您可以在 Tableau Server 运行时创建备份，最大程度地缩短服务器在升级期间不可用的时间。用于创建升级前备份的过程与用于创建定期备份的过程相同，但有一项针对分布式安装的额外注意事项。

注意：从未包括在新安装中的任何节点中卸载 Tableau Server，以避免旧节点与新安装发生冲突。

升级期间的备份

在 Tableau Server 升级期间，将创建数据库的临时备份，以允许在升级过程中进行迁移。这是在升级期间完成的，大多数情况下不会对升级过程产生明显影响。在某些特殊情况下，可能会产生其他影响：

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

• 主要版本 pgsql 更新 — 如果升级包括对用于 Tableau 存储库的数据库的主要版本更新，则会在不压缩的情况下完成内部升级备份，以便节省时间。这需要在升级过程中有额外的临时磁盘空间。

  Tableau Server 版本，包括主要版本数据库更新；2020.4。

计划和管理备份

从 2020.4.0 开始，您可以使用 tsm 命令来计划备份。您需要通过命令行执行此操作（没有用于计划备份的 TSM UI）。tsm maintenance backup 命令允许您创建和更新备份计划。tsm schedules 命令使您可以查看、删除、暂停、恢复和更新计划。

计划备份：

1. 在初始节点（安装了 TSM 的节点）上以管理员身份打开命令提示符。

2. 运行以下命令：

   tsm maintenance backup -f <backup-file> -sr <recurrence> -st <time-to-run> -sd <days-to-run> -sn <schedule-name>

   例如，若要创建名为“monthly-backup”（每月备份）的备份计划，该备份计划每月 15 日凌晨 2 点运行，并生成名为 的文件：

   tsm maintenance backup -f ts-mid_month_backup -sr monthly -st 02:00 -sd 15 -sn monthly-backup

查看计划的备份：

1. 在初始节点（安装了 TSM 的节点）上以管理员身份打开命令提示符。

2. 运行以下命令：

   tsm schedules list

   您可以使用 --next-run 或 --schedule-name 选项，按计划运行时间、最早到最新时间或名称对计划进行排序。您可以使用 --schedule-id 选项交替显示单个计划的详细信息。当您查看单个计划时，您会看到有关它的其他详细信息，包括创建时间、运行次数以及运行时使用的特定选项。作业选项以 JSON 格式显示为“Job args”。

更新计划的备份：

1. 在初始节点（安装了 TSM 的节点）上以管理员身份打开命令提示符。

2. 运行以下命令：

   tsm schedules update --schedule-id <ID> --schedule-time <time-to-run> --schedule-recurrence <frequency> --schedule-days <day-to-run>

   注意：若要添加或更改名称，请使用 tsm-maintenance-backup 命令。

挂起或恢复备份计划：

1. 在初始节点（安装了 TSM 的节点）上以管理员身份打开命令提示符。

2. 运行以下命令之一：

• 挂起计划：

  tsm schedules suspend --schedule-id <scheduleID>

• 恢复挂起的计划：

  tsm schedules resume --schedule-id <scheduleID>

将备份过程编成脚本

如果您经常备份，您可能希望创建一个脚本来为您执行备份及相关任务。这些任务包括：

• 在运行备份之前清理文件和文件夹。

• 自行运行备份。

• 将备份文件复制到单独的计算机以便妥善保管。

此部分讨论您可结合使用来执行备份及相关任务的 tsm 命令。

注意：TSM 是一个批处理文件。若要在另一个批处理文件中运行 tsm 命令，请使用 call 命令。例如，“call tsm maintenance ziplogs”。这样做会将控制交还给批处理文件。在发出任何命令之前，您还需要向 TSM 进行身份验证。有关详细信息，请参阅tsm CLI 身份验证。

有关对 TSM 命令进行脚本处理的其他信息，请参见 Tableau 社区论坛(链接在新窗口中打开)。

移除日志文件并清除临时文件夹

您可以清理旧日志文件和临时文件，以减少创建备份所需的时间，并确保备份文件尽可能小。

若要清理几天前的日志文件，请运行以下命令：

tsm maintenance cleanup

运行备份

注意：将 Windows 版 Tableau Server 备份到网络驱动器时，计算机帐户必须对在其中写入备份文件的网络共享具有写入访问权限（通常情况下不是这样，如果您想将服务器备份到网络共享，您有责任进行配置）。

若要创建备份，请使用 tsm maintenance backup 命令：

tsm maintenance backup --file

注意有关该命令的以下信息：

• 向命令添加 --append-date 可以在备份文件名中包括日期。

• 系统将在数据目录的临时位置中汇编备份文件，并将该文件写入 TSM basefilepath.backuprestore变量中定义的目录。默认情况下：

  C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\

  有关备份文件的写入位置以及如何更改该位置的详细信息，请参见tsm File Paths。注意：即使您更改备份位置，备份过程也会使用数据目录中的临时位置来汇编备份文件。

将备份文件复制到另一台计算机

作为最佳做法，请在创建备份后将备份文件复制到独立于 Tableau Server 的另一个位置。

• 还原备份内容

使用 tsm maintenance restore 命令来还原 Tableau Server 数据。如果出现系统故障并且需要还原数据、如果您需要切换回 Tableau Server 以前的版本（举例来说，如果升级过程中出现问题），或者如果您将 Tableau Server 迁移到新硬件，则您可以这样做。您可以使用 tsm maintenance restore 命令来还原使用 tabadmin backup 和 tsm maintenance backup 创建的 Tableau Server 备份 。

还原 Tableau Server 时的限制

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

• 如果要还原使用 tabadmin backup 创建的备份，并且您使用了自定义资产密钥，则必须保存 asset_keys.yml 文件的副本，以便能够在进行还原时包括该文件。 有关详细信息，请参见在卸载 Windows 版 Tableau Server 2018.1.x 或更低版本之前保存资产密钥文件。

• 在还原 Tableau Server 时，通过其他方式建立的数据库备份以及虚拟计算机快照是无效数据源。

• 使用 tsm maintenance restore 还原 Tableau 数据时，备份文件 (.tsbak) 中的内容会覆盖数据提取文件以及 PostgreSQL 数据库的内容。如果您正在运行 Tableau Server 的分布式安装，请在运行 TSM 控制器的节点（通常是初始节点）上执行还原。

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

• 您只能将备份文件还原到与在其上创建备份的版本相同或比该版本新的 Tableau Server 版本。您无法还原到 Tableau 的较旧版本。

• 在还原过程中，还原过程将启动 Tableau Server 管理的内容和外部资产的完整重新索引。此过程消耗 CPU 资源，在备份和还原过程中可能会明显。

从备份文件还原 Tableau Server

注意：此操作包括您可能需要使用 TSM 命令行执行的步骤。若要使用 TSM CLI，您需要在安装中的一个节点上对命令行具有管理员访问权限，并需要 TSM 管理员凭据来运行 TSM 命令。

1. （可选）将 .tsbak 文件复制到默认文件位置。

   restore 命令需要 TSM basefilepath.backuprestore 变量定义的目录中有备份文件。默认情况下：

   C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\

   有关文件路径及其修改方式的详细信息，请参见tsm File Paths。

   注意：如果要还原复制到备份文件夹中的备份，请确保运行身份服务帐户（可在 TSM Web UI 中的“安全性”下找到）至少具有备份文件的“读取”访问权限。否则，还原过程可能无法解压缩备份文件，并且还原将失败。

2. 停止服务器。在命令提示符处，键入：

   tsm stop

3. 从备份文件进行还原。在命令提示符处，键入：

   tsm maintenance restore --file

   在上面的行中，将 替换为要用来进行还原的备份文件的名称。

4. 重新启动服务器：

   tsm start