---
schema_version: "1"
id: f8726060d68a05200808aeef03e65e71e9b0f877e6039b083847ab2c544382b6
title: 安装和配置附加节点
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/server-linux/install_additional_nodes.md
canonical_url: https://help.tableau.com/v0.0/server-linux/zh-cn/install_additional_nodes.htm
source_site: help.tableau.com
content_type: documentation
content_hash: e2d6febf4cdf26eb5cbad912f881c8549b789c6110e93742f322bf5ab6faaf25
description: Install and configure additional Tableau Server nodes for redundancy and capacity.
---
[跳转到主要内容](#main-content)

# 安装和配置附加节点

在一台计算机（或节点）上安装 Tableau Server 后，服务器功能正常并且可以使用，但没有冗余。如果程序出现问题或计算机本身出现问题，则 Tableau Server 可能无法使用。此外，所有进程都在单台计算机上运行，因此可能会争用该计算机上的资源。

您可以通过将 Tableau 添加到其他节点来扩展 Tableau Server 安装，从而创建分布式安装。本文介绍了在其他节点上安装 Tableau Server 的一般步骤，并假设您已经在初始节点上安装了 Tableau。有关在初始节点上安装 Tableau 的详细信息，请参见[安装和初始化 TSM](https://help.tableau.com/v0.0/server-linux/zh-cn/setup.htm)。

如果要在多个节点上安装 Tableau Server，则应该一次在一个节点上进行安装和配置。这样可以更容易地解决任何可能遇到的问题。

**重要信息**：您应在可通过应用未完成的更改来完全完成过程时添加和配置附加节点。如果未通过应用未完成的更改完成操作便添加节点，可能会导致用户无法登录到 Tableau Server。

## 安装位置

请记住以下要求和限制：

- Tableau Server 的安装和数据目录位置在群集中的所有节点上必须相同。
- 您可以在类似于 RHEL 的分发版上指定非默认安装位置，但不能在 Ubuntu 上更改该位置。有关详细信息，请参见[安装目录](https://help.tableau.com/v0.0/server-linux/zh-cn/requ.htm#InstallDir)。
- 初始化 Tableau 时，可以为数据目录指定非默认位置。有关详细信息，请参见[数据目录](https://help.tableau.com/v0.0/server-linux/zh-cn/requ.htm#Data)。

### 生成节点引导程序文件

1. 在浏览器中打开 TSM：
    
    `https://<tsm-computer-name>:8850`
    
    有关详细信息，请参见[登录到 Tableau 服务管理器 Web UI](https://help.tableau.com/v0.0/server-linux/zh-cn/sign_in_tsm.htm)。
2. 单击“配置”选项卡，并在“添加节点”框中单击“下载引导程序文件”。
    
    ![Tableau Server 部署中的进程和实例数列表。](/tableau/next/zh-cn/server-linux/zh-cn/Img/tsm-ui-linux-generate-bootstrap.png)
    
    即会创建引导程序文件并将其复制到您的本地计算机。
    
    默认情况下，引导程序文件中包括嵌入式凭据。如果不需要嵌入在引导程序文件中的凭据，请清除“在文件中包括临时凭据”选项。如果要完全禁用在节点引导文件中包括嵌入式凭据的功能，则可以为服务器设置配置选项。有关更多详细信息，请参见[features.PasswordlessBootstrapInit](https://help.tableau.com/v0.0/server-linux/zh-cn/cli_configuration-set_tsm.htm#pwdlessbootstrap)。

### 安装和初始化附加节点

在开始之前，请验证您的节点引导程序文件是否为最近的文件。举例来说，如果在生成引导程序文件后运行了 `[tsm security regenerate-internal-tokens](https://help.tableau.com/v0.0/server-linux/zh-cn/cli_security_tsm.htm#regenerate-tokens)`，则初始化将失败。

1. 复制您在第一个计算机上使用的原始安装程序，以及您生成的引导程序文件，并将其放在可从 Tableau Server 所要添加到的新计算机访问的位置中。此位置可以是装载的网络共享，或者直接位于新计算机上。
2. 如果正在运行本地防火墙，则您需要为群集中的所有节点配置防火墙规则。有关详细信息，请参见[配置本地防火墙](https://help.tableau.com/v0.0/server-linux/zh-cn/config_firewall_linux.htm)。
3. 在新节点上，运行 Tableau Server 安装程序：
    
    使用软件包管理器来安装 Tableau Server 软件包。
    
    您必须将新版本安装到与现有版本相同的位置。所有节点上的安装位置必须相同。请不要安装到使用符号链接的位置，或安装到网络文件系统 (NFS) 卷上的目录。
    
    - 在类似于 RHEL 分发（包括 CentOS）中，您可以选择将 Tableau 安装到非默认位置。
        
        - **默认位置** — 若要安装到默认位置 (`/opt/tableau/tableau_server`)，请运行以下命令，其中 `<version>` 的格式为主要-次要-维护（例如：`2025-3-5`）：
            
            `sudo yum update`
            
            `sudo yum install tableau-server-<version>.x86_64.rpm`
        - **非默认位置** — 若要安装到非默认位置，您必须使用 `rpm -i`。您还需要安装所有依赖包。请参见下面的注释。
            
            运行以下命令：
            
            sudo rpm -i --prefix /preferred/install/path tableau-server.rpm
        
        **注意：**当您使用 `yum` 安装 Tableau Server 时，将会自动下载和安装所有依赖包。这是安装 Tableau 的首选方法。如果要安装到非默认位置，或者组织不允许您使用 `yum` 并且必须使用 `rpm -i` 进行安装，则您还必须单独安装所有依赖包。有关安装依赖包的信息，请参见[在运行 Linux 的无网络连接计算机上安装 Tableau Server](https://help.tableau.com/v0.0/server-linux/zh-cn/install_air_gapped.htm#InstallAirgap)。
    - 在 Ubuntu 上，运行以下命令，其中 `<version>` 的格式为主要-次要-维护（例如：`2019-2-5`）：
        
        sudo apt-get update
        sudo apt-get upgrade
        sudo apt-get -y install gdebi-core
        sudo gdebi -n tableau-server-<version>\_amd64.deb
4. 若要初始化新节点与初始节点之间的通信，请运行安装 Tableau Server 时安装的 initialize-tsm 脚本。
    
    导航到 `scripts` 目录：
    
    cd /opt/tableau/tableau\_server/packages/scripts.<version\_code>/
    
    ：更新环境设置。
5. 运行 initialize-tsm 脚本：
    
    ```
    sudo ./initialize-tsm -b /path/to/<bootstrap>.json --accepteula
    ```
    
    - 使用 `-b` 标志提供复制到计算机的引导程序文件的路径。如果已对引导程序文件进行加密，则必须使用 pipe 命令对文件进行处理，如[保护用于导入和导出操作的密文](https://help.tableau.com/v0.0/server-linux/zh-cn/security_secret_storage.htm#Securing)中所述。
    - 如果生成的引导程序文件没有嵌入凭据，请使用 `-u` 标志来指定初始节点上管理用户的用户名。这是计算机上管理用户的名称，而不是 Tableau Server 管理员。将会提示您输入用户密码。有关详细信息，请参见[tsm topology nodes get-bootstrap-file](https://help.tableau.com/v0.0/server-linux/zh-cn/cli_topology_tsm.htm#TSMGetBootstrap)。
        
        ```
        sudo ./initialize-tsm -b /path/to/<bootstrap>.json -u <admin-user-on-first-node> --accepteula
        ```
        
        **重要信息：**您必须输入在初始节点上进行安装期间所使用的相同用户的凭据。
    - `--accepteula` 标志用于接受 Tableau Server 最终用户许可协议 (EULA)。EULA 可在以下位置中找到：[最终用户许可协议](https://www.tableau.com/zh-cn/legal/eula)。[](https://www.tableau.com/zh-cn/legal/eula)

### 使用群集控制器配置附加节点

1. 在浏览器中打开 TSM：
    
    https://<tsm-computer-name>:8850
    
    有关详细信息，请参见[登录到 Tableau 服务管理器 Web UI](https://help.tableau.com/v0.0/server-linux/zh-cn/sign_in_tsm.htm)。
2. 单击“配置”选项卡。一条消息应会指出添加了新节点。
    
    ![指示已向 Tableau Server 中的群集添加新节点的消息。](/tableau/next/zh-cn/server-linux/zh-cn/Img/tsm-ui-node-added.png)
    
    单击“继续”关闭消息。
3. 群集控制器是最小拓扑的一部分，并且已选定。每个节点都必须运行群集控制器。
    
    如果只想为节点设置最小拓扑，请转到下面的步骤 4。如果将要添加附加节点并且不准备将此节点配置为超出最小范围，则可以执行此操作。
    
    如果要将附加进程添加到最小拓扑，请指定应在节点上运行的进程。通过选择所需的进程或指定应在节点上运行的进程数来完成此操作。
    
    例如，若要在节点上添加一个网关和后台程序的两个实例：
    
    1. 选择“网关”。
    2. 将“后台程序”计数设置为 2。
        
        向节点中添加后台程序时，还会添加数据引擎的实例（如果节点上还没有该实例）。
    
    您设置的具体进程和进程数将取决于您的组织环境和需求。添加其他进程时会自动添加一些进程。有关详细信息，请参见[配置节点](https://help.tableau.com/v0.0/server-linux/zh-cn/config_nodes.htm)和[Tableau Server 进程](https://help.tableau.com/v0.0/server-linux/zh-cn/processes.htm)。
    
    **注意：**TSM Web UI 限制您最多使用 8 个允许选择实例数的进程的实例。若要配置比此实例数更多的实例，请使用命令行和 `TSM topology set-process` 命令。有关详细信息，请参见[tsm topology set-process](https://help.tableau.com/v0.0/server-linux/zh-cn/cli_topology_tsm.htm#TSMSetProcess)。
4. 单击页面顶部的“待定更改”：
    
    ![指示有待定更改的 Tableau Server Manager 工具栏。](/tableau/next/zh-cn/server-linux/zh-cn/Img/tsm-ui-pending-changes-btn.png)
    
    如果在配置包含三个或更多节点的群集，则会显示协调服务整体警告。您可以继续。您将在一个单独步骤中部署协调服务整体。
5. 单击“应用更改并重新启动”和“确认”确认重新启动 Tableau Server。
    
    Tableau Server 重新启动之后，加入的节点带有必需的最小拓扑以及您配置的其他进程。

### 生成节点引导程序文件

若要在其他计算机上安装 Tableau Server，请使用为初始节点使用的相同安装程序，以及您在初始节点上生成的“引导程序”文件。

**重要信息**：引导程序文件包含用于对配置密码加密的主密钥存储文件的副本。该文件还可包含有效的嵌入式凭据一段预定义的时间（请参见[tabadmincontroller.auth.expiration.minutes](https://help.tableau.com/v0.0/server-linux/zh-cn/cli_configuration-set_tsm.htm#tabadminctrlrauthexpire)）并充当会话 Cookie。我们强烈建议您采取其他措施来保护引导程序文件。

以下命令集提供了加密引导程序文件输出的示例方法。此方法类似于[保护用于导入和导出操作的密文](https://help.tableau.com/v0.0/server-linux/zh-cn/security_secret_storage.htm#Securing)中更详细描述的加密过程。

但是请注意，此处的方法必须作为单独的参数传递，并具有 `&& \`尾随运算符，如下所示：

`mkfifo -m 600 /tmp/secure1 && \`

`tsm topology nodes get-bootstrap-file --file /tmp/secure1 && \`

`gpg --symmetric --batch --yes --passphrase-file ~/.secrets/pgppassphrase.txt --cipher-algo AES256 --output encrypted.enc < /tmp/secure1 && \`

`rm /tmp/secure1`

1. 在初始节点上安装 Tableau Server 之后，生成节点引导程序文件。
2. 在初始节点上，打开终端会话。
3. 键入以下命令来生成引导程序文件：
    
    `tsm topology nodes get-bootstrap-file --file <path\file>.json`
    
    默认情况下，引导程序文件中包括嵌入式凭据。如果不希望引导程序文件包括凭据，请使用 `-nec` 或 `--no-embedded-credentials` 选项：
    
    `tsm topology nodes get-bootstrap-file --file <path\file>.json --no-embedded-credentials`。
    
    如果要完全禁用在节点引导文件中包括嵌入式凭据的功能，则可以为服务器设置配置选项。有关更多详细信息，请参见[features.PasswordlessBootstrapInit](https://help.tableau.com/v0.0/server-linux/zh-cn/cli_configuration-set_tsm.htm#pwdlessbootstrap)。

### 安装和初始化附加节点

1. 复制您在第一个计算机上使用的原始安装程序，以及您生成的引导程序文件，并将其放在可从 Tableau Server 所要添加到的新计算机访问的位置中。此位置可以是装载的网络共享，或者直接位于新计算机上。
2. 如果正在运行本地防火墙，则您需要为群集中的所有节点配置防火墙规则。有关详细信息，请参见[配置本地防火墙](https://help.tableau.com/v0.0/server-linux/zh-cn/config_firewall_linux.htm)。
3. 在新节点上，运行 Tableau Server 安装程序：
    
    使用软件包管理器来安装 Tableau Server 软件包。
    
    您必须将新版本安装到与现有版本相同的位置。所有节点上的安装位置必须相同。请不要安装到使用符号链接的位置，或安装到网络文件系统 (NFS) 卷上的目录。
    
    - 在类似于 RHEL 分发（包括 CentOS）中，您可以选择将 Tableau 安装到非默认位置。
        
        - **默认位置** — 若要安装到默认位置 (`/opt/tableau/tableau_server`)，请运行以下命令，其中 `<version>` 的格式为主要-次要-维护（例如：`2025-3-5`）：
            
            `sudo yum update`
            
            `sudo yum install tableau-server-<version>.x86_64.rpm`
        - **非默认位置** — 若要安装到非默认位置，您必须使用 `rpm -i`。您还需要安装所有依赖包。请参见下面的注释。
            
            运行以下命令：
            
            sudo rpm -i --prefix /preferred/install/path tableau-server.rpm
        
        **注意：**当您使用 `yum` 安装 Tableau Server 时，将会自动下载和安装所有依赖包。这是安装 Tableau 的首选方法。如果要安装到非默认位置，或者组织不允许您使用 `yum` 并且必须使用 `rpm -i` 进行安装，则您还必须单独安装所有依赖包。有关安装依赖包的信息，请参见[在运行 Linux 的无网络连接计算机上安装 Tableau Server](https://help.tableau.com/v0.0/server-linux/zh-cn/install_air_gapped.htm#InstallAirgap)。
    - 在 Ubuntu 上，运行以下命令，其中 `<version>` 的格式为主要-次要-维护（例如：`2019-2-5`）：
        
        sudo apt-get update
        sudo apt-get upgrade
        sudo apt-get -y install gdebi-core
        sudo gdebi -n tableau-server-<version>\_amd64.deb
4. 若要初始化新节点与初始节点之间的通信，请运行安装 Tableau Server 时安装的 initialize-tsm 脚本。
    
    在新节点上：
    
    导航到 `scripts` 目录：
    
    cd /opt/tableau/tableau\_server/packages/scripts.<version\_code>/
    
    ：更新环境设置。
5. 运行 initialize-tsm 脚本：
    
    ```
    sudo ./initialize-tsm -b /path/to/<bootstrap>.json --accepteula
    ```
    
    - 使用 `-b` 标志提供复制到计算机的引导程序文件的路径。如果已对引导程序文件进行加密，则必须使用 pipe 命令对文件进行处理，如[保护用于导入和导出操作的密文](https://help.tableau.com/v0.0/server-linux/zh-cn/security_secret_storage.htm#Securing)中所述。
    - 如果生成的引导程序文件没有嵌入凭据，请使用 `-u` 标志来指定初始节点上管理用户的用户名。这是计算机上管理用户的名称，而不是 Tableau Server 管理员。将会提示您输入用户密码。有关详细信息，请参见[tsm topology nodes get-bootstrap-file](https://help.tableau.com/v0.0/server-linux/zh-cn/cli_topology_tsm.htm#TSMGetBootstrap)。
        
        ```
        sudo ./initialize-tsm -b /path/to/<bootstrap>.json -u <admin-user-on-first-node> --accepteula
        ```
        
        **重要信息：**您必须输入在初始节点上进行安装期间所使用的相同用户的凭据。
    - `--accepteula` 标志用于接受 Tableau Server 最终用户许可协议 (EULA)。EULA 可在以下位置中找到：
        
        ```
        /opt/tableau/tableau_server/packages/docs.<version_code>/EULA.rtf
        ```

### 配置其他节点

**注意：**这个基本的示例说明了如何在节点上设置拓扑。有关更详细的工作多节点示例，请参阅[示例：安装并配置三节点 HA 群集](https://help.tableau.com/v0.0/server-linux/zh-cn/distrib_ha_install_3node.htm)。

在初始（原始）节点上，为新添加的节点设置拓扑。拓扑指定应该在该节点上运行的进程，以及应该运行的每个进程的实例数。节点的拓扑将取决于您的环境和组织需求。以下只是设置拓扑的示例。

1. 在初始（原始）节点上，打开终端会话。
2. 获取新节点的节点 ID：
    
    tsm topology list-nodes -v
    
    `-v` 选项列出了节点及其当前运行的进程。您可以识别新添加的节点，因为它不会有任何进程。
3. 指定应在此节点上运行的各个进程。
    
    使用以下命令执行此操作：
    
    `tsm topology set-process -n <nodeID> -pr <processname> -c <n>`
    
    必须将群集控制器的实例添加到每个节点。
    
    例如，要向群集控制器添加后台程序的两个实例以及节点 2 的网关，请使用以下命令：
    
    tsm topology set-process -n node2 -pr clustercontroller -c 1
    tsm topology set-process -n node2 -pr backgrounder -c 2
    tsm topology set-process -n node2 -pr gateway -c 1
    
    您设置的具体进程和进程数将取决于您的组织环境和需求。添加其他进程时会自动添加一些进程。有关详细信息，请参见[配置节点](https://help.tableau.com/v0.0/server-linux/zh-cn/config_nodes.htm)和[Tableau Server 进程](https://help.tableau.com/v0.0/server-linux/zh-cn/processes.htm)。
4. 应用节点配置。如果待定更改需要重新启动服务器，`pending-changes apply` 命令将显示一个提示，告知您将进行重新启动。即使服务器已停止，此提示也会显示，但在这种情况下不会重新启动。您可以使用 `--ignore-prompt` 选项隐藏提示，但这样做不会改变重新启动行为。如果更改不需要重新启动，则会在不提示的情况下应用更改。有关详细信息，请参见[tsm pending-changes apply](https://help.tableau.com/v0.0/server-linux/zh-cn/cli_pending-changes.htm#pending-changes-apply)。
    
    `tsm pending-changes apply`
    
    如果您部署了三节点或五节点群集，则会显示一条有关部署协调服务整体的警告。如果只出现这条警告，您可以使用 `--ignore-warnings` 选项安全地忽略该警告，以便应用配置更改而不管警告。
    
    ```
    tsm pending-changes apply --ignore-warnings
    ```

## 安装驱动程序

您需要安装驱动程序，以便 Tableau Server 可以连接数据并运行数据提取。在运行以下任何进程的节点上安装这些驱动程序：

- VizQL Server (vizqlserver)
- 应用程序服务器 (vizportal)
- 数据服务器 (dataserver)
- 后台程序 (backgrounder)

### 驱动程序和管理视图

如果要使用 Tableau Server 中的内置管理视图，还需要在运行任何上述进程的任何节点上安装 PostgreSQL 驱动程序。

有关详细信息，请参见[数据库驱动程序](https://help.tableau.com/v0.0/server-linux/zh-cn/dbdriver.htm)。