tsm maintenance

您可以使用 tsm maintenance 命令来管理服务器维护任务,例如创建定期备份或从先前创建的备份还原 Tableau Server

tsm maintenance backup

创建 Tableau Server 管理的数据的备份。此数据包括 Tableau PostgreSQL 数据库(存储库),其中包含工作簿和用户元数据,以及数据提取(.tde 或 .hyper)文件。此数据不包括配置数据。请参见执行 Tableau Server 的完整备份和还原

注意:不要在包含外部文件存储的 Tableau Server 安装上使用此命令。请参见使用外部文件存储进行备份和还原

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

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

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

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

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\<filename>.tsbak

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

概要

tsm maintenance backup --file <backup_file> [options] [global options]

选项

-d, --append-date

可选。

将当前日期附加到备份文件名。

-f, --file <backup_file>

必需。

有关备份存储库数据的详细信息,请参见备份 Tableau Server 数据

-i, --description <string>

可选。

包括备份文件的指定说明。

--ignore-prompt

可选。版本 2020.2 中新增

备份而不提示,即使文件存储不在管理控制器所在的同一节点上(通常是初始节点)。如果自动执行备份(例如,使用脚本),请使用此提示。

--skip-compression

可选。

在不使用压缩的情况下创建备份。这会生成较大的备份文件,但可以缩短完成备份所花费的时间。如果在多节点安装中使用此选项,我们强烈建议您在初始节点上配置文件存储实例。

-k, --skip-verification

可选。

不验证数据库备份的完整性。

--override-disk-space-check

可选。

即使在出现磁盘空间不足警告时也尝试创建备份。

-po,--pg-only

可选。

只生成存储库备份。

--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。默认值为 86400(1440 分钟)。

示例

此示例在 <安装目录>\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\ 文件夹中创建一个名为 ts_backup-<yyyy-mm-dd>.tsbak 的备份:

tsm maintenance backup -f ts_backup -d

tsm maintenance cleanup

默认情况下,会删除早于 7 天的日志文件和临时文件。命令选项可以修改删除哪些文件。

此命令的效果取决于 Tableau Server 是否正在运行。如果服务器正在运行,则可以删除大多数旧文件和 http_requests 表条目,但无法删除正在使用的任何文件(由操作系统锁定),因此不会移除临时文件和活动日志文件。若要删除临时文件和当前日志文件,您必须在运行此命令之前停止服务器。

如果在分布式部署中运行 Tableau Server,请在运行管理控制器(也称为 TSM 控制器)进程的节点上运行此命令。默认情况下,控制器位于群集中的初始节点上。

概要

tsm maintenance cleanup [options] [global options]

选项

-a, --all

可选。

使用默认保留值执行所有清理操作。相当于使用以下选项运行 cleanup 命令: -l -t -r -q -ic

--http-requests-table-retention <天数>

可选。

默认值:7 天

指定应保留 http_requests 表条目的天数。将此选项与 -q 选项结合敷衍以删除超过指定天数的条目。此选项指定表条目保留期限,但不会触发表条目的实际删除。-q 选项触发条目的删除。

-ic, --sheet-image-cache

可选。

清除图像缓存。此缓存可以包含脱机预览的图像、订阅电子邮件的快照、订阅 PDF 以及从发布 rest API 端点请求的任何图像(有关详细信息,请参见 rest_api_ref.htm(Link opens in a new window))。

注意:版本 2019.4 中新增的选项

-l, --log-files

可选。

删除 retention-period 之前的日志文件。将删除 data\tabsvc\logs 下的子目录中的文件。

--log-files-retention <天数>

可选。

默认值:1(24 小时)

删除此天数之前的日志。此命令不适用于临时文件。

-q, --http-requests-table

可选。

删除旧的 http_requests 表条目。Tableau Server 必须正在运行才能删除表条目。如果 Tableau Server 已停止,则会忽略此选项。此选项可单独用于指定删除早于默认保留期(7 天)的条目,或与 --http-requests-table-retention 一起使用来指定非默认保留期。

注意:删除 http_requests 表条目会永久删除可用于自定义管理视图的数据。确保移除此数据不会影响所需的任何自定义视图。

-r, --redis-cache

可选。

清除 Redis 缓存。

--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。

-t, --temp-files

可选。

删除以下目录中的所有文件和子目录:

  • <install dir>\ProgramData\Tableau\Tableau Server\data\tabsvc\temp:只会删除存储已过期(未在运行)会话文件的目录。

  • <install dir>\ProgramData\Tableau\Tableau Server\data\tabsvc\httpd\temp

  • <install dir>\ProgramData\Tableau\Tableau Server\temp

示例

此示例将清理 2 天之前的所有日志文件:

tsm maintenance cleanup -l --log-files-retention 2

tsm maintenance metadata-services disable

注意:版本 2019.3 中新增的命令。

使用 tsm maintenance metadata-services disable 命令来禁用 Tableau 元数据 API。

禁用元数据 API 会停止持续摄取有关 Tableau Server 上的内容的信息并将其编入索引,删除有关发布到 Tableau Server 的内容及该内容的关联资产的信息,并禁用查询元数据 API 和访问 Tableau Catalog 的功能。

运行此命令并会停止和启动 Tableau Server 使用的某些服务,从而导致某些功能(例如“建议”)对于用户暂时不可用。

概要

                        tsm maintenance metadata-services disable
                    

选项

--ignore-prompt

可选。

禁用元数据 API 时关闭确认提示。

tsm maintenance metadata-services enable

注意:版本 2019.3 中新增的命令。

使用 tsm maintenance metadata-services enable 命令为 Tableau Server 启用 Tableau 元数据 API。

如果 Tableau Server 使用 数据管理加载项 获得许可,则启用元数据 API 将会启用 Tableau Catalog。

启用元数据 API 时,有关 Tableau Server 上的内容的信息将被摄取并随后编入元数据 API 存储索引。可以使用元数据 API 来查询有关发布到 Tableau Server 的内容的架构、世系及用户管理的元数据。启用元数据 API 后,系统将会持续地摄取元数据并将其编入索引,直至禁用元数据 API 为止。

运行此命令时,请谨记以下内容:

  • 此命令并会停止和启动 Tableau Server 使用的某些服务,从而导致某些功能(例如“建议”)对于用户暂时不可用。
  • 每次使用此命令时,系统都会创建新的元数据索引,并替换以前的索引。

有关 Tableau Catalog 的详细信息,请参见关于 Tableau Catalog

概要

                        tsm maintenance metadata-services enable
                    

选项

--ignore-prompt

可选。

启用元数据 API 时关闭确认提示。

tsm maintenance metadata-services get-status

注意:版本 2019.3 中新增的命令。

使用 tsm maintenance metadata-services get-status 命令获取有关元数据服务的状态信息。

元数据服务的状态指明元数据 API 存储是否已初始化,或者 Tableau 元数据 API 是否正在运行。

概要

                        tsm maintenance metadata-services get-status
                    

tsm maintenance preflight-check permissions

注意:Windows 版 Tableau Server 版本 2020.3 中新增的命令。

Use the tsm maintenance preflight-check permissions command to verify the directory permissions.

概要

tsm maintenance preflight-check permissions [options] [global options]

选项

-d, --data-dir <数据目录>

可选。

指定要验证权限的数据目录。如果未包括在内,则根据当前 Tableau Server 配置确定数据目录。

-i, --install-dir <安装目录>

可选。

指定要验证权限的安装目录。如果未包括在内,则根据当前 Tableau Server 配置确定安装目录。

-n --nodes <nodeID,nodeID,...>

可选。

要在权限检查中专门包括的节点的节点 ID。如果未指定,则对群集中的所有节点执行检查。

--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。

-ru --runas-user <以秒为单位的超时>

可选。

要验证权限的用户运行身份名称。如果未提供,则从当前配置中确定用户运行身份。

tsm maintenance preflight-check ports

注意:Windows 版 Tableau Server 版本 2020.3 中新增的命令。

使用 tsm maintenance preflight-check ports 命令验证端口是否可用于当前安装的所有服务。指定服务和端口以验证端口是否可用于该服务,即使当前未安装该服务。

概要

tsm maintenance preflight-check ports [options] [global options]

选项

-a, --tabadminagent-addresses <主机名:端口>

可选。

指定要检查在其上检查管理代理访问权限的主机和端口。地址的格式为 hostname:port。如果检查多个地址,请用逗号分隔多个地址。在安装或更改端口之前,使用此选项查看端口是否可用。

-g, --gateway-addresses <主机名:端口>

可选。

指定要在其上检查网关服务访问权限的主机和端口。地址的格式为 hostname:port。如果检查多个地址,请用逗号分隔多个地址。在安装或更改端口之前,使用此选项查看端口是否可用。

-n --nodes <nodeID,nodeID,...>

可选。

要在其上运行前检查的节点的节点 ID。如果未指定,则对群集中的所有节点执行检查。

-r, --repository-addresses <主机名:端口>

可选。

指定要在其上检查存储库服务访问权限的主机和端口。地址的格式为 hostname:port。如果检查多个地址,请用逗号分隔多个地址。在安装或更改端口之前,使用此选项查看端口是否可用。

-re --remote

可选。

检查所有节点对管理代理的远程访问权限。默认情况下不会这样做。

--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。

-t, --tabadmincontroller-addresses <主机名:端口>

可选。

指定要在其上检查管理控制器访问权限的主机和端口。地址的格式为 hostname:port。如果检查多个地址,请用逗号分隔多个地址。在安装或更改端口之前,使用此选项查看端口是否可用。

tsm maintenance reindex-search

使用 tsm maintenance reindex-search 命令建立搜索索引。

概要

tsm maintenance reindex-search [options] [global options]

选项

--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。

tsm maintenance reset-searchserver

将搜索服务器重置为干净状态,同时删除搜索信息并重建搜索索引。

概要

tsm maintenance reset-searchserver [options] [global options]

选项

--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。

tsm maintenance restore

使用指定的备份文件还原 Tableau Server。还原备份文件不会还原任何配置数据。请参见执行 Tableau Server 的完整备份和还原

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

概要

tsm maintenance restore --file <file_name> [--restart-server] [global options]

选项

-ak, --asset-key-file <file_name>

可选。仅当从通过 Tableau Server(版本 2018.1 及更低版本)上的 tabadmin 创建的资产还原时,才指定此选项。

要从中还原的资产密钥文件的名称。资产密钥文件通过 tabadmin assetkeys 命令(Link opens in a new window)创建。该文件必须位于服务器上的预定义备份/还原位置。

-f, --file <file_name>

必需。

指定要还原的备份文件。

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

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

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

-k, --skip-identity-store-verification

可选。仅当从通过 Tableau Server(版本 2018.1 及更低版本)上的 tabadmin 创建的备份文件进行还原时,才指定此选项。

不要使用此密钥尝试从创建原始备份文件的 Tableau Sever 中更改身份存储类型。若要更改身份存储,请参见更改身份存储

-po,--pg-only

可选。

仅还原存储库。

-r, --restart-server

可选。

还原后重新启动服务器。

--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。

tsm maintenance send-logs

将指定的文件上载到 Tableau 并将其与支持案例相关联。若要成功将文件上载到 Tableau,Tableau Server 必须能够与 https://report-issue.tableau.com 上的 send-logs 服务器进行通信。

概要

tsm maintenance send-logs --case <case_number> --email <contact_email> --file <path/to/file> [global options]

选项

-c,--case <case_number>

必需。

支持案例编号。

-e,--email <contact_email>

必需。

联系人电子邮件。

-f, --file <path/to/file>

必需。

指定要发送的日志文件存档的位置和名称。

--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。

tsm maintenance snapshot-backup complete

注意:版本 2020.1 中新增的命令,仅在针对外部文件存储配置了 Tableau Server 时可用。

在 Tableau Server 上完成快照备份过程。在获取了外部存储的快照备份后运行此项。

tsm maintenance snapshot-backup preparetsm maintenace snapshot-backup complete 命令用于为配置为包含外部文件存储的 Tableau Server 安装创建 Tableau Server 数据备份。有关详细信息,请参见使用外部文件存储进行备份和还原

概要

tsm maintenance snapshot-backup complete [options] [global options]

选项

--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。

tsm maintenance snapshot-backup prepare

注意:版本 2020.1 中新增的命令,仅在针对外部文件存储配置了 Tableau Server 时可用。

准备快照备份。准备步骤完成后,您可以对网络存储进行快照备份。

tsm maintenance snapshot-backup preparetsm maintenace snapshot-backup complete 命令用于为配置为包含外部文件存储的 Tableau Server 安装创建 Tableau Server 数据备份。有关详细信息,请参见使用外部文件存储进行备份和还原

概要

tsm maintenance snapshot-backup prepare [options] [global options]

选项

--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。

tsm maintenance snapshot-backup restore

注意:版本 2020.1 中新增的命令,仅在针对外部文件存储配置了 Tableau Server 时可用。

将存储库备份从存储快照还原到 Tableau Server。

有关详细信息,请参见使用外部文件存储进行备份和还原

概要

tsm maintenance snapshot-backup restore [options] [global options]

选项

--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。

tsm maintenance validate-resources

验证站点的工作簿和数据源。在迁移站点之前使用此命令,以检测站点资源(例如工作簿和数据源)将导致站点导入失败的问题。某些资源问题可以通过从本地源重新发布来纠正。其他问题可能需要 Tableau 支持的协助。

概要

tsm maintenance validate-resources --site-id <site ID> [global options]

选项

-id,--site-id <site ID>

必需。

要验证其资源的站点的 ID。

-r,--repair

可选。

尝试修复无效资源。输出中会注明无法修复的资源。

--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。

 

tsm maintenance ziplogs

使用 ziplogs 命令创建 Tableau Server 日志文件的存档。

概要

tsm maintenance ziplogs [options] [global options]

选项

-a, --all

可选。

包括 msinfo、netstat 和最新转储。相当于使用以下选项运行命令:-mi -t -l。不包括 PostgreSQL 数据。

-d, --with-postgresql-data

可选。

如果 Tableau Server 已停止,则包括 PostgreSQL 数据文件夹,如果 Tableau Server 正在运行,则包括 PostgreSQL 转储文件。

--description <string>

可选。

包括存档文件的指定说明。

--enddate <mm/dd/yyyy>

可选。

要包括的日志文件的最后日期。此选项必须与 --startdate 结合使用,不能与 --minimumdate 一起使用。如果未指定此选项,则最多包含两天的日志。

版本 2019.3 中新增

-f, --file <name>

可选。

指定压缩存档文件的名称。如果没有提供名称,则将存档创建为 logs.zip。文件将写入 TSM basefilepath.log_archive 变量中定义的目录。默认情况下:

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

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

-i, --description <string>

可选。

包括存档文件的指定说明。

-mi, --with-msinfo

可选。

包括 msinfo32 报告,其中包含有关 OS、硬件和正在运行的软件的系统信息。

-l, --with-latest-dump

可选。

当任何服务崩溃时,Tableau Server 会生成一个转储文件。设置此选项以包括最近服务崩溃转储文件。如果未设置此选项,则生成的 ziplog 中将不包括任何转储文件。

-m, --minimumdate <mm/dd/yyyy>

可选。

要包括的日志文件的最早日期。如果未指定,则最多包含两天的日志文件。日期格式应为“mm/dd/yyyy”。此选项不能与 --startdate--enddate 一起使用。

-o, --overwrite

可选。

用于覆盖现有的 ziplog 文件。如果已经存在同名的文件,并且未使用此选项,则 ziplogs 命令将失败。

默认情况下会将文件写入到:

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

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

--startdate <mm/dd/yyyy>

可选。

要包括的日志文件的最早日期。此选项必须与 --enddate 结合使用,不能与 --minimumdate 一起使用。如果未指定此选项,则最多包含两天的日志。

版本 2019.3 中新增。

--request-timeout <timeout in seconds>

可选。

等待指定的时间以完成命令。默认值为 7200(120 分钟)。

-t, --with-netstat-info

可选。

包括 netstat 信息。

 

全局选项

-h, --help

可选。

显示命令帮助。

-p, --password <password>

在会话不是活动状态的情况下为必需,-u--username 也为必需。

为在 -u--username 中指定的用户指定密码。

如果密码包括空格或特殊字符,请将其括在引号中:

--password "my password"

-s, --server https://<hostname>:8850

可选。

对 Tableau 服务管理器使用指定的地址。URL 必须以 https 开头,包括端口 8850,并使用服务器名称(而不是 IP 地址)。例如 https://<tsm_hostname>:8850。如果没有指定服务器,则假定为 https://<localhost | dnsname>:8850

--trust-admin-controller-cert

可选。

使用此标志来信任 TSM 控制器上的自签名证书。有关证书信任和 CLI 连接的详细信息,请参见 连接 TSM 客户端

-u, --username <user>

在会话不是活动状态的情况下为必需,-p--password 也为必需。

指定用户帐户。如果未包括此选项,则使用您登录所使用的凭据运行该命令。

 

感谢您的反馈! 提交反馈时出错。请重试,或向我们发送消息