---
schema_version: "1"
id: e3a5181d13c45a920e99506cb0eadfa0b7c5712b2932e26ae2d8520f0647f9ff
title: 克隆 Tableau Server
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/server-linux/server_clone.md
canonical_url: https://help.tableau.com/v0.0/server-linux/zh-cn/server_clone.htm
source_site: help.tableau.com
content_type: documentation
content_hash: fe4c72fd3613e88d34ed069695e2ad66bf428a28d9c62b70af720f2241d24cfc
description: Clone a Tableau Server deployment using the tsm settings clone command.
---
[跳转到主要内容](#main-content)

# 克隆 Tableau Server

从 Tableau Server 版本 2022.3 开始，新的 tsm 命令使您能够创建 Tableau Server 部署的配置和拓扑的副本，并使用该副本创建原始部署的精确复制副本。`tsm settings clone` 命令创建一组文件（“克隆有效负载”），其中包括设置、密文、配置和拓扑，包括正在使用的端口以及有关外部服务的信息。

## 安全注意事项

`tsm settings clone` 命令生成一组文件（“克隆有效负载”），其中包括由 Tableau Server 生成的所有密文以及服务器管理员在配置期间提供的密文，包括包含密钥对和证书的密钥存储。保持克隆有效负载和输出位置的安全对于安全性极其重要。为此，请执行以下操作：

- 如果输出目录不存在，tsm 将创建该目录，并且只有运行 `tsm settings clone` 命令的用户才能访问该目录。
- 如果运行该命令时输出目录存在，tsm 将确认它属于运行该命令的用户，并且只有该用户拥有权限。如果目录没有预期的权限，将显示一条消息：
    
    The output directory '<path/to/directory>' exists, but must be restricted to owner only.

## 克隆有效负载的限制

- 所克隆的 Tableau Server 版本必须与所创建的版本相匹配。您不能使用来自旧版本的克隆有效负载来安装较新版本的 Server。

## 使用克隆命令创建 Tableau Server 的副本

创建 Tableau Server 的克隆副本是一个多步骤的过程，其中两个高级步骤是：

1. 从您想要复制的 Tableau Server 安装创建克隆有效负载。
2. 使用克隆有效负载安装 Tableau Server 的第二个部署。您负责匹配两个安装的拓扑、添加其他节点以匹配原始部署。

### 创建克隆有效负载

若要生成一组包含 Tableau Server 的配置和拓扑设置的文件（克隆有效负载），请使用 `[tsm settings clone](https://help.tableau.com/v0.0/server-linux/zh-cn/cli_settings_tsm.htm#TSMSettingsClone)` 命令。该命令采用单个参数，即应在其中保存这一组文件的输出目录：

tsm settings clone --output-directory <output\_directory>

创建克隆有效负载后，您可以在安装与源安装具有相同配置和拓扑的 Tableau Server 新实例时使用该有效负载。

### 使用克隆有效负载创建 Tableau Server 的副本

1. 在初始节点上安装 Tableau Server 软件包。不要初始化 Tableau Server。[安装 Tableau Server 软件包](https://help.tableau.com/v0.0/server-linux/zh-cn/setup.htm#Install)
2. 运行 `initialize-tsm` 脚本，并指定由 `tsm settings clone` 命令创建的克隆有效负载的路径：
    
    sudo /opt/tableau/tableau\_server/packages/scripts.<version>/initialize-tsm --accepteula --clone-artifact-dir=<path-to-clone-directory>
    
    **注意：**Tableau Server 以非特权 tableau 用户身份运行，因此管理员必须确保 tableau 用户具有对克隆目录和文件的读取访问权限。在大多数情况下，这需要向“其他人”授予对克隆目录内容的读取权限以及对所有父目录的执行权限（用于遍历）。
3. （可选）安装附加节点，以匹配原始（克隆）Tableau Server 安装的节点数。如果原始安装有附加节点，则需要执行此步骤。仅安装附加节点以匹配原始安装上的数量。
    
    1. 在初始节点上生成引导程序文件：
    2. 在每个附加节点上安装 Tableau Server 并运行 initialize-tsm 脚本：
        
        [安装和配置附加节点](https://help.tableau.com/v0.0/server-linux/zh-cn/install_additional_nodes.htm)
4. 在初始节点上，完成初始化：
    
    tsm initialize

### 容器

在容器中使用 Tableau Server 时克隆功能很方便，尤其是在与外部存储库和存储一起使用时。克隆命令允许管理员快速重新创建 Tableau Server 环境并重新连接外部服务。

**注意：**重新创建 Tableau Server 群集的步骤可能会有所不同，这取决于所使用的容器技术（例如：docker、docker compose 或 Kubernetes）。

以下信息专门针对使用 docker 的情况。启动初始节点容器时，您需要使用 `CLONE_ARTIFACT_DIR` 环境变量指定克隆有效负载的位置。

例如：

docker run \\
-v <path-to-clone-directory>:/docker/custom-clone-path \\
-e CLONE\_ARTIFACT\_DIR=/docker/custom-clone-path \\
-e LICENSE\_KEY=<key> \\
-p 8080:8080 -p 8800-9000:8800-9000 -p 27000-27010:27000-27010 \\
--hostname=<static (internal) name of host machine> \\
-d <Tableau Server in a Container image ID or tag>

### 重新创建“容器中的 Tableau Server”的多节点部署

如果您的克隆有效负载来自多节点 Tableau Server 部署，您的初始容器将等待其他节点加入群集。

使用克隆时在群集中设置附加节点与在常规部署中添加节点相同，并且需要：

- 装载卷以在节点之间共享引导程序文件
- 指定 `ALWAYS_WRITE_BOOTSTRAP_FILE` 和 `BOOTSTRAP_INSTALL` 环境变量

在容器部署中创建多节点环境的详细步骤可以在这里找到：[多节点“容器中的 Tableau Server”](https://help.tableau.com/v0.0/server-linux/zh-cn/server-in-container_image.htm#MultiNode-container)。

**注意：**克隆有效负载只需要在群集中的初始节点上装载和使用。您无需在附加节点上装载克隆有效负载。