Tableau Server 多节点升级指南（Windows）

📌 多节点升级：本文以 Tableau Server 2025.x 为例，系统梳理 Windows 环境下多节点部署的升级全流程——从升级前准备、拓扑验证、主节点升级、工作节点同步到升级后验证。
📌 核心原则：主节点先升级，工作节点后升级；升级期间服务全部停止；降级需从备份恢复。

Tableau Server 多节点部署是企业级 BI 平台的常见架构。相比单节点，多节点架构将不同的服务组件分布在多个计算机上，从而提供更好的性能隔离和高可用性。然而，多节点升级相比单节点要复杂得多——任何一个节点的操作失误都可能导致整个集群不可用。

本文结合官方文档和实际运维经验，详细介绍 Windows 环境下 Tableau Server 多节点部署的完整升级流程。

一、升级前准备

1.1 确认当前拓扑

升级之前，必须清楚了解当前集群的拓扑结构——每个节点上运行了哪些 Tableau Server 进程。在初始节点上运行以下命令查看拓扑：

tsm topology list-nodes -v

输出示例：

Node ID: node1 (初始节点)
  进程: Gateway, VizQL Server, Cache Server,
        Backgrounder, Repository (Active)
Node ID: node2 (工作节点)  
  进程: VizQL Server, Backgrounder, Cache Server
Node ID: node3 (工作节点)
  进程: VizQL Server, Data Server, Backgrounder

关键确认事项：初始节点是哪一台；工作节点数量及各自进程分布；存储库是否配置了被动节点。

1.2 检查版本兼容性

升级前务必确认当前版本与目标版本之间的升级路径。Tableau Server 支持跨多个版本升级，但某些大版本之间有特定的前置要求。

• 查看当前版本：tsm version
• 检查升级路径：访问 Tableau 官方版本导览页面确认兼容性

1.3 完整备份

升级前必须在初始节点上执行完整备份。这是升级失败时唯一的回退路径。

• （喜乐君个人建议）我通常会在升级之前，先清理日志，然后执行完整备份：tsm maintenance backup -f ts_backup_pre_upgrade -d

• 建议同时备份拓扑和配置：tsm settings export -f config_backup.json
• 将备份文件（.tsbak）复制到安全的外部存储

⚠️ 重要：多节点环境中，备份文件仅存储在初始节点上。务必手动将备份文件复制到其他安全位置。

1.4 下载安装程序

从 Tableau 官方下载页面获取目标版本的安装程序。多节点升级中，所有节点需要使用相同版本的安装程序。

认准唯一的官方链接： tableau.com/support/releases

• 下载 Tableau Server Windows 安装程序（.exe 文件）
• 将安装程序复制到每个节点的本地磁盘
• 验证安装程序的数字签名和文件完整性

2026/06/28 目前，最佳推荐是 2025.3.7

  TableauServer-64bit-2025-3-7.exe (3250 MB)

SHA-1: 455f5959155810ebb08867a141340d712bc371da
SHA-256: 8624e411198fed34a44f567591956bbd2c2c23bbd0745e5b65d8172045565562
MD5: 1b673e18d0c352c46512158e5c9e3447

1.5 通知用户和计划停机

多节点升级期间所有 Tableau Server 服务将停止。提前通知用户并协调维护窗口：

• 通过 Tableau Server 管理页面发布维护公告
• 预估停机时间：3-5 节点的部署通常需要 1-2 小时
• 协调相关 IT 团队（网络、存储、数据库管理员）

二、多节点升级流程

核心原则：先升级初始节点（主节点），再逐个升级其他工作节点。初始节点升级完成后，TSM 会自动检测其他节点的版本不匹配并提示升级。

步骤 1：停止所有服务

在初始节点上停止整个集群：

tsm stop

此命令会停止所有节点上的 Tableau Server 服务。确认所有服务状态为已停止：

tsm status -v

步骤 2：初始节点安装升级程序

以管理员身份运行新版本的安装程序。安装程序会自动检测已有安装并进入升级模式。

• 右键安装程序 → 以管理员身份运行
• 安装程序检测到现有安装后，自动进入升级模式
• 确认升级路径（安装目录不可更改）
• 在 ATR 激活配置界面，升级不能改变 ATR 设置——该选项通常为灰色不可选
• 安装完初始节点后，先不要勾选「自动启动升级脚本」，停留在当前页面

步骤 3：其他工作节点安装升级程序

初始节点升级完成后，登录到每个工作节点，以管理员身份运行相同版本的安装程序。

• 在每个工作节点上重复步骤 2 的操作
• 工作节点升级不需要运行升级脚本——不要勾选自动运行升级脚本，点击确定

步骤 4：初始节点执行更新脚本

所有节点安装程序都完成后，回到初始节点，勾选自动运行升级脚本，点击确定。该脚本会执行以下操作：

• 启动 TSM 管理服务
• 应用配置更改和数据库架构迁移
• 提示确认：是否停止服务器（输入 Y）、是否启用使用信息共享（输入 N）

注意：升级脚本并非完全无人值守——需要在命令行中输入确认。

步骤 5：验证初始节点升级

升级脚本完成后，验证初始节点状态：

tsm status -v

确认初始节点的所有服务正常启动且版本号已更新。

常见的节点状态: 所有节点应显示为 Running 状态，版本号一致。如果某节点显示 Degraded 或 Error，检查该节点的 Windows 事件日志和 Tableau 日志。

步骤 6：启动集群

所有节点升级完成后，在初始节点上启动整个集群：

tsm start

启动过程会依次启动所有节点上的 Tableau Server 进程。可以通过以下命令监控进度：

tsm status -v

三、升级后验证

3.1 服务状态验证

确认所有节点和进程正常运行：

tsm status -v

• 检查所有节点的状态是否为 Running
• 确认各进程（VizQL Server、Backgrounder、Data Server 等）均正常
• 在 TSM Web UI（https://初始节点:8850）中查看拓扑可视化

3.2 功能验证

• 使用浏览器打开 Tableau Server 登录页面
• 使用管理员账户登录，验证站点和项目可见
• 打开几个常用工作簿，确认视图正常渲染
• 发布一个测试工作簿，验证 VizQL Server 和数据源连接
• 运行一个数据提取刷新任务，确认 Backgrounder 正常

3.3 性能验证

• 访问 Tableau Server 状态页面：https://localhost:8850/status
• 确认负载均衡和工作节点响应正常
• 检查 Windows 事件查看器中是否有错误日志

四、多节点升级的注意事项

4.1 升级顺序不可改变

初始节点必须先升级，工作节点后升级。如果先升级工作节点，TSM 会因版本不匹配而拒绝连接。

4.2 所有节点版本必须一致

升级过程中如果某个工作节点升级失败，其他节点也无法正常工作。所有节点的 Tableau Server 版本必须完全相同。

4.3 存储库的特殊考虑

如果配置了被动存储库节点，升级过程中需要特别注意：

• 主动和被动存储库节点都必须升级
• 升级期间存储库会自动进行数据迁移
• 确保在升级前存储库服务完全健康

4.4 防火墙和网络配置

升级过程中，节点之间需要以下端口通信：

• 8850：TSM Web UI 和管理端口
• 8000-9000：Tableau Server 内部通信端口
• 27000-27009：许可证服务端口

升级前确认防火墙规则没有阻止这些端口。

4.5 蓝/绿升级（高级方案）

对于 7x24 业务场景，可以考虑蓝/绿升级方案——构建一个并行的新版本集群，然后切换负载均衡器将流量指向新集群。这需要额外的硬件资源和网络配置，但可以实现近乎零停机升级。

4.6 升级失败的回退方案

如果升级失败，回退的唯一方法是：

• 卸载所有节点上的 Tableau Server
• 重新安装旧版本
• 使用之前的备份文件恢复：tsm maintenance restore -f ts_backup_pre_upgrade.tsbak

⚠️ 警告：Tableau Server 不支持直接降级。回退必须通过卸载、重装、恢复备份来完成。

结语

Tableau Server 多节点升级虽然步骤较多，但只要遵循「先主后从、逐节点升级、升级前备份」的基本原则，就可以顺利完成。

对于生产环境，建议先在测试环境中完成一次完整的演练升级，确认无问题后再对生产环境执行。