tsm File Paths

  • 版本 :2022.1 及更高版本

某些 tsm 命令都从默认位置读取文件或将文件写入默认位置。这些默认位置由为每个命令定义的 basefilepath 配置键确定。您可以使用 tsm 来查看键的当前值,以及更改位置。

某些 tsm 命令都从默认位置读取文件或将文件写入默认位置。这些默认位置由为每个命令定义的 basefilepath 配置键确定。您可以使用 tsm 来查看键的当前值,以及更改位置。

NetworkService 系统帐户

某些组织中实施了一些安全策略,这些策略限制系统帐户(例如 NetworkService 帐户)访问文件。如果更改 tsm 文件路径,您应验证 NetworkService 系统帐户是否具有所生成路径的完整权限(已启用权限继承)。此外,如果更改最初位于 *\data\tabsvc\* 路径中的文件路径,则必须保持对原始路径的 NetworkService 权限。之所以必须保持此权限,原因是 NetworkService 系统帐户通过 Tableau Server 管理控制器、Tableau Server 客户端文件服务以及 Tableau Server 协调服务处理操作。

备份/还原文件位置的权限

备份/还原文件位置所需的权限:

  • NetworkService:读/写/执行权限

  • 运行身份服务帐户:读/写/执行权限

文件的默认位置

tsm maintenance backuprestoresend-logsziplogs 过程中以及 tsm sites exportsites import 过程中,Tableau Server 为这些命令创建或使用的文件使用默认位置。

有关备份 Tableau Server 的磁盘空间要求的详细信息,请参见备份的磁盘空间使用情况

默认情况下:

  • Tsm 维护命令

    • 备份 — 备份 .tsbak 文件在初始节点上数据目录中的临时位置中创建,然后保存在:

      默认情况下,此目录为:

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

      但如果已将 Tableau 安装到非默认位置,此目录将有所不同。举例来说,如果您安装到 D:\Tableau Server,则将在以下位置中保存备份:

      D:\Tableau Server\data\tabsvc\files\backups

      注意:tsm maintenance backup 命令不支持使用 Microsoft Windows UNC(通用命名约定)文件路径(也称为“网络路径”,\\<计算机名称>\<文件夹>\<文件名>)作为在其中写入备份文件的位置的路径。请改为使用本地文件系统路径(<驱动器号>:\<文件夹名称>\<文件名>)。

    • restore — restore 过程从以下位置还原备份文件:

      默认情况下,此目录为:

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

      但如果已将 Tableau 安装到非默认位置,此目录将有所不同。举例来说,如果您安装到 D:\Tableau Server,则还原过程将使用以下位置中的备份:

      D:\Tableau Server\data\tabsvc\files\backups

    • send-logs — send-logs 从以下位置发送日志文件:

      默认情况下,此目录为:

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

      但如果已将 Tableau 安装到非默认位置,此目录将有所不同。举例来说,如果您安装到 D:\Tableau Server,则发送日志过程将从以下位置中发送日志文件:

      D:\Tableau Server\data\tabsvc\files\backups

    • ziplogs — 将在以下位置中生成 ziplogs 文件:

      默认情况下,此目录为:

      C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives

      但如果已将 Tableau 安装到非默认位置,此目录将有所不同。举例来说,如果您安装到 D:\Tableau Server,则将在以下位置中生成 ziplogs 文件:

      D:\Tableau Server\data\tabsvc\files\log-archives

  • tsm sites

    • export — 将在以下目录中生成导出 .zip 文件:

      默认情况下,此目录为:

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

      但如果已将 Tableau 安装到非默认位置,此目录将有所不同。举例来说,如果您安装到 D:\Tableau Server,则将在以下位置中导出 .zip 文件:

      D:\Tableau Server\data\tabsvc\files\siteexports

    • import — 在导入过程中,Tableau Server 将在以下位置中查找文件:

      默认情况下,此目录为:

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

      但如果已将 Tableau 安装到非默认位置,此目录将有所不同。举例来说,如果您安装到 D:\Tableau Server,则导入过程将在以下位置中查找文件:

      D:\Tableau Server\data\tabsvc\files\siteimports

获取当前文件位置

可以使用 tsm configuration get 查看特定命令的当前文件位置:

  • 对于 tsm 维护命令:

    • Backup、restore 和 send-logs:

      tsm configuration get -k basefilepath.backuprestore

    • ziplogs:

      tsm configuration get -k basefilepath.log_archive

  • 对于 tsm 站点命令:

    • export

      tsm configuration get -k basefilepath.site_export.exports

    • import

      tsm configuration get -k basefilepath.site_import.exports

更改当前文件位置

您可以使用 tsm configuration set 命令更新 basefilepath 变量以更改预期文件位置。有关特定基本文件路径的详细信息,请参见tsm configuration set 选项

更改 basefilepath 变量不会将现有文件从原始目录移到新目录。如果希望现有备份、还原、日志文件或者站点导出或导入文件位于指定的新目录中,您必须手动移动这些文件。您负责创建新的位置并设置正确的权限,以允许 TSM 访问将放置在那里的任何文件,以及包含这些文件的目录结构。如果您更改备份/还原基本文件路径,则应运行 tsm maintenance validate-backup-basefilepath 命令(在 2022.1 及更高版本中可用)以验证权限设置是否正确。

tsm maintenance backup 命令在数据目录中的临时位置汇编备份,然后再将备份文件保存到 basefilepath.backuprestore 变量指定的位置。更改 basefilepath 不会影响 tsm maintenance backup 命令汇编备份文件的位置。

  • 对于 tsm 维护命令:

    • 若要更改 backup、restore 或 send-logs 目录,请运行以下命令:

      tsm configuration set -k basefilepath.backuprestore -v "

    • 更改 ziplogs 目录:

      tsm configuration set -k basefilepath.log_archive -v "

  • 对于 tsm 站点命令:

    • 更改站点导出目录:

      tsm configuration set -k basefilepath.site_export.exports -v "

    • 更改站点导入目录:

      tsm configuration set -k basefilepath.site_import.exports -v "

更改默认文件位置之后,您需要执行以下操作:

  1. 应用待处理的更改:

    tsm pending-changes apply

    如果待定更改需要重新启动服务器,pending-changes apply 命令将显示一个提示,告知您将进行重新启动。即使服务器已停止,此提示也会显示,但在这种情况下不会重新启动。您可以使用 --ignore-prompt 选项隐藏提示,但这样做不会改变重新启动行为。如果更改不需要重新启动,则会在不提示的情况下应用更改。有关详细信息,请参阅tsm pending-changes apply

  2. 停止 Tableau Server:

    tsm stop

  3. 重新启动 TSM 控制器:

    net stop tabadmincontroller_0

    net start tabadmincontroller_0

  4. 等待几分钟,让控制器重新启动。您可以使用此命令确认控制器是否已重新启动:

    tsm status -v

    当您可以运行该命令并且 Tableau Server 管理控制器被列为“正在运行”时,控制器已重新启动。

  5. 启动 Tableau Server:

    tsm start