tsm topology

您可以使用 tsm topology 命令准备文件存储节点以便安全删除或使其恢复为读写模式。您还可以启动存储库故障转移、获取节点或端口列表、获取为群集添加其他节点所需的引导程序配置文件、移除节点,以及配置外部存储库。

tsm topology cleanup-coordination-service

部署新整体后,使用 tsm topology cleanup-coordination-service 命令删除非生产 Tableau Server 协调服务整体。此命令将移除非生产协调服务整体中所有节点上的旧协调服务实例,并且在部署新协调服务整体后需要执行该命令。若要了解有关协调服务整体的详细信息,请参见部署协调服务整体

概要

tsm topology cleanup-coordination-service [option] [global options]

选项

--request-timeout <timeout in seconds>

可选。

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

tsm topology deploy-coordination-service

您可以使用 tsm topology deploy-coordination-service 命令部署 Tableau Server 协调服务。此命令将部署协调服务整体,这是在服务器群集中的指定节点上运行的一组协调服务实例。若要了解有关协调服务整体的详细信息,包括群集中多少个节点应该有一个协调服务实例,请参见部署协调服务整体

概要

tsm topology deploy-coordination-service --nodes <nodeID,nodeID,...> [option] [global-options]

选项

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

必需。

要包括在新协调服务整体中的节点的节点 ID,用逗号分隔。您可以指定 1、3 或 5 个协调服务节点,具体取决于群集中的节点总数。有关详细信息,请参见协调服务法定数量

--request-timeout <timeout in seconds>

可选。

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

tsm topology external-services list

使用 tsm topology external-service-list 命令获取用于 Tableau Server 外部存储库的服务。举例来说,如果已将 Tableau Server 配置为使用 Amazon RDS,您将看到以下消息:

这些外部配置的服务由 Tableau Server 使用:

- pgsql

概要

tsm topology external-service list [global options]

选项

此命令没有选项。

tsm topology external-services repository enable

使用 tsm topology external-services repository enable 命令将 Tableau Server 配置为使用外部存储库。可以在安装新 Tableau Serve 期间使用此命令配置外部存储库。如果在已存在并正在运行 Tableau Server 上运行此命令,它会将数据从本地节点迁移到外部存储库,并将 Tableau Server 配置为在迁移完成后使用外部存储库。

概要

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

选项

-f <file name>

必需。

将用于保存配置文件的完整路径和文件名。有关详细信息,请参见重新配置 Tableau Server 存储库

-c <ssl certificate file>

必需。

如果为外部存储库使用 Amazon RDS,则您必须使用 SSL。下载 .pem 文件,并指定要用于此选项的 .pem 文件。有关如何获取 .pem 文件的详细信息,请参见使用 SSL 对 DB 实例连接加密

tsm topology external-services repository disable -n nodeN

使用 tsm topology external-services repository disable 命令停止使用外部存储库,并重新配置安装以使用本地存储库。这会将数据迁移到本地存储库,并将 Tableau Server 配置为使用本地存储库。

概要

tsm topology external-services repository disable -n nodeN

选项

-n, --node-name <nodeID>

必需。

指定应将存储库移入其中的节点的节点 ID。

这不会停止或删除 RDS 实例。有关如何删除 RDS 实例的详细信息,请参见 AWS 网站上的删除 DB 实例

全局选项

-h, --help

可选。

显示命令帮助。

-p, --password <password>

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

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

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

--password "my password"

-s, --server <url_to_tsm>

可选。

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

--trust-admin-controller-cert

可选。

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

-u, --username <user>

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

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

tsm topology failover-repository

您可以使用 tsm topology failover-repository 手动启动从当前主动存储库到第二个被动存储库的存储库故障转移。

tsm topology failover-repository 命令是永久性的。故障转移存储库将一直是主动存储库,直至您再次发出命令为止。或者,如果针对其配置了 Tableau Server,则会一直保持到发生自动故障转移为止。如果配置了首选主动存储库,请使用 --preferred 选项切换回该存储库。有关配置首选主动存储库的详细信息,请参见Tableau Server 存储库。如果针对高可用性配置了 Tableau Server,则会自动进行存储库故障转移。使用 failover-repository 命令对存储库进行手动故障转移。

概要

tsm topology failover-repository --preferred | --target <node_id> [global options]

选项

-r, --preferred

如果未使用 -t 或 --target,则为必需。

使用配置的首选节点作为存储库故障转移的目标。

--request-timeout <timeout in seconds>

可选。

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

-t, --target <node_id>

如果未使用 -r 或 --preferred,则为必需。

将在其中发生故障转移的目标节点的节点 ID。使用 tsm topology list-nodes 命令查找节点 ID。

tsm topology filestore decommission

您必须使用 tsm topology filestore decommission 命令来准备一个或多个文件存储节点以便安全删除。此命令会将指定节点置于只读模式,并确保指定节点上没有唯一内容。

如果停止使用单个文件存储节点中的结果,则必须使用 --override 选项,否则停止使用将失败。

概要

tsm topology filestore decommission --nodes <nodeID,nodeID,...> [options] [global options]

选项

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

必需。

由节点 ID 指定并用逗号分隔的一个或多个待停用节点的列表。

--delete-filestore

可选。

强制移除文件存储,即使尚未将其停止使用。只有在文件存储所在的节点处于错误状态并且无法完成停止使用操作时,才应使用此选项。将永久性删除该节点上的任何唯一文件。

-o, --override

可选。

如果删除目标文件存储节点会将剩余文件存储节点的数量减少到一个,则覆盖通常会发生的警告或故障。

--request-timeout <timeout in seconds>

可选。

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

tsm topology filestore recommission

使用 tsm topology filestore recommission 命令将任何已停用的节点恢复为读写模式。

概要

tsm topology filestore recommission --nodes <nodeID,nodeID,...> [global options]

选项

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

必需。

由节点 ID 指定并用逗号分隔的一个或多个待重新使用节点的列表。

tsm topology list-nodes

显示群集中的节点和(可选)每个节点上的服务。

概要

tsm topology list-nodes [options] [global options]

选项

-v, --verbose

可选。

显示每个节点 ID、节点角色(有关详细信息,请参见下面的 set-node-role)、节点地址以及每个节点上的进程。

 

tsm topology list-ports

显示群集中的端口。

概要

tsm topology list-ports [options] [global options]

选项

--node-name <nodeID>

可选。

指定要列出其端口的节点。

--service-name

可选。

指定要列出其端口的服务。

 

tsm topology nodes get-bootstrap-file

您可以使用 tsm topology nodes get-bootstrap-file 命令获取将新节点添加到群集所需的引导程序文件。

重要信息:引导程序文件包含用于对配置密码加密的主密钥存储文件的副本。该文件还可包含有效的嵌入式凭据一段预定义的时间(请参见tabadmincontroller.auth.expiration.minutes)并充当会话 Cookie。我们强烈建议您采取其他措施,以使用保护用于导入和导出操作的密文中描述的机制来保护引导程序文件。

概要

tsm topology nodes get-bootstrap-file --file <path\file>.json [global options]

选项

-f,--file <file>

必需。

将用于保存配置文件的完整路径和文件名。如果存在重复文件,则将覆盖文件。

-nec,--no-embedded-credential

可选。

版本 2019.3 中新增。

默认情况下,引导程序文件中包括嵌入式凭据。如果引导程序文件中不应包括凭据,请使用此选项。嵌入式凭据是临时的,并会根据 tabadmincontroller.auth.expiration.minutes配置键的值(默认值为 120 分钟)过期。

注意:可以使用配置选项在服务器级别禁用包括嵌入式凭据的功能。有关详细信息,请参见features.PasswordlessBootstrapInit

 

tsm topology remove-nodes

从群集中删除节点。

若要完成节点移除,您还必须运行 tsm pending-changes apply 命令。某些情况下,需要在删除节点之前移动或重新部署进程。请参见移除节点

如果移除节点并想要将其重新添加到群集,您需要首先运行 obliterate 脚本将 Tableau 从群集中擦除,然后使用用于添加新节点的正常过程重新安装节点。有关详细信息,请参见从计算机中移除 Tableau Server以及安装和配置附加节点

注意:要从群集中删除节点,必须在过去的某个时刻已为该节点配置了进程。如果要删除尚未配置任何进程的节点,则必须在其上添加一个进程,运行 tsm pending-changes apply,然后删除该节点。

概要

tsm topology remove-nodes --nodes <nodeID,nodeID,...> [global options]

选项

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

必需。

指定要移除的节点。如果要指定多个节点,请使用逗号分隔节点 ID。

 

tsm topology set-node-role

设置“后台程序”和“数据提取查询”节点角色。这确定将在节点上执行的任务的类型。如果有多节点群集并且需要加载项许可证,则以下节点角色非常有用。有关详细信息,请参见通过节点角色管理工作负载

注意:对节点角色进行配置需要重新启动服务器,并且将需要停机一段时间。有关详细信息,请参见tsm pending-changes

概要

tsm topology set-node-role [options] [global options]

选项

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

必需。

要为其设置节点角色的一个或多个节点的列表,由节点 ID 指定并用逗号分隔,各节点之间没有空格。

-r --role <all-jobs,flows,no-flows,extract-refreshes,subscriptions,extract-refreshes-and-subscriptions,no-extract-refreshes,no-subscriptions,no-extract-refreshes-and-subscriptions,extract-queries>

必需

设置指定节点的角色。此选项的有效值为:

  • all-jobs:后台程序将运行所有类型的作业。

  • flows:后台程序将仅运行流程运行作业。

  • no-flows:后台程序将不运行流程运行作业。

  • extract-refreshes:后台程序将仅运行数据提取刷新作业。这包括对所有数据提取(包括流程输出创建的数据提取)进行的增量刷新、完全刷新、加密和解密。

  • subscriptions:后台程序将仅运行订阅作业。

  • extract-refreshes-and-subscriptions:后台程序对所有数据提取(包括流程输出创建的数据提取)运行数据提取刷新、加密和解密,以及运行订阅作业。

  • no-extract-refreshes:后台程序将运行除数据提取刷新、数据提取加密和解密(包括通过流程输出创建的数据提取)之外的所有作业。

  • no-subscriptions:后台程序将运行除订阅之外的所有作业。

  • no-extract-refreshes-and-subscriptions:后台程序将运行除对数据提取(包括通过流程输出创建的数据提取)进行数据提取刷新、加密和解密以及订阅作业之外的所有作业。

  • Extract-queries:选定节点将以 all-jobs 方式运行,并将优先处理数据提取查询。

tsm topology set-ports

设置服务实例的端口。

概要

tsm topology set-ports --node-name <nodeID> --port-name <port_name> --port-value <port_value> [options] [global options]

选项

-i, --instance <instance_id>

可选。

指定服务的实例 ID。如果未指定,默认为 0(零)。

-n, --node-name <nodeID>

必需。

指定节点的节点 ID。

-pn, --port-name <port_name>

必需。

要设置的端口的名称,格式为:service_name:port_type。如果没有指定端口类型,则假定为主端口。有关端口名称语法,请参见动态映射端口

-pv, --port-value <port_value>

必需。

要设置的端口。

-r, --restart

可选。

需要时,隐藏重新启动提示并重新启动 Tableau Server

 

tsm topology set-process

设置节点上的进程实例数。如果节点已经具有指定的进程,则将该数目更新为与指定的计数匹配。

一次只能设置一个进程。如果指定多个进程,则会在无提示的情况下忽略第一个进程后面的任何进程。

注意:有关进程名称的完整列表,请参见Tableau Server 进程

概要

tsm topology set-process --count <process_count> --node <nodeID> --process <process_name> [global options]

选项

-c, --count <process_count>

必需。

要设置的进程数(实例数)。

-n, --node <nodeID>

必需。

指定要对其设置进程的节点的节点 ID。

-pr, --process <process_name>

必需。

要设置的进程的名称。

 

tsm topology toggle-coordination-service

您可以使用 tsm topology toggle-coordination-service 命令在协调服务整体之间切换。若要了解有关协调服务整体的详细信息,请参见部署协调服务整体

概要

tsm topology toggle-coordination-service [option] [global options]

选项

--request-timeout <timeout in seconds>

可选。

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

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