Tableau Server证书过期，到期控制器和 tsm 异常-Tableau喜乐君-Tableau Visionary，敏捷BI布道师

XILEJUN

喜乐君 Tableau Visionary ✦ 5

📊 业务数据分析「专家」· 敏捷 BI 布道师

📚 《数据可视化分析》《业务可视化分析》多本书作者

🎓 中国地质大学（武汉）经管学院 MBA 校外导师

🤝 以 Tableau 会友，致力于构建业务分析通识框架

🌐 XILEJUN.com 全球 🌐 VIZWISE.cn 国内

📚 本文配套课程 · 数据可视化分析系列

🎬 B 站课程：数据可视化分析：Tableau/SQL 原理与实践 — https://www.bilibili.com/cheese/play/ss8093

近期，一家三年前开始使用Tableau并部署Tableau server服务器的客户，遇到了服务器问题，TSM无法使用的问题；仔细研究发现，此类问题会在服务器使用三年后出现，特此记录。

一、问题描述

问题最基本的症状是，8850中，提示TSM管理服务器报错，而且重启TSM也无法解决问题。如下所示：

如果在终端中使用tsm命令，则会提示：

tableau server unable to verify the server's https certificate

或者

Could not connect to TSM Controller at 'https://servername:8850'（无法在“https://servername:8850”上连接到 TSM 控制器）

Tableau Server 的早期版本使用一年后过期的 TSM 控制器证书。目前，该证书最长可持续三年，升级时会安装新证书。

要验证 TSM 控制器 SSL 证书的到期日期，请在运行 Tableau Server 的计算机上的终端中输入以下命令（Linux 指令）：

 #openssl s_client  -connect servername:8850
 #echo | openssl s_client -connect servername:8850  2>/dev/null | openssl x509 -noout -dates

二、问题诊断

1、既然是tsm故障，可以查看tsm日志，或者tabadmincontroller日志来判断。如下所示，在tsm.log日志中，我们发现在ERROR报错行之前，有多个 FAILED/Invalid等的错误提示。

2023-02-26 17:12:23.030 main : DEBUG com.tableausoftware.tabadmin.commands.TabadminCommand - Creating ServerApi client
2023-02-26 17:12:23.137 main : INFO com.tableausoftware.tabadmin.cli.ServerApi - Creating ServerApi object - host:biganalyze, port:8850, skipCertValidation:false
2023-02-26 17:12:23.147 main : TRACE com.tableau.certificates.LinuxCertManager - Creating LinuxCertManager(/etc/opt/tableau/tableau_server/tableauservicesmanagerca.jks)
2023-02-26 17:12:23.148 main : TRACE com.tableau.certificates.PrivateKeystoreCertManager - Constructing PrivateKeystoreCertManager(/etc/opt/tableau/tableau_server/tableauservicesmanagerca.jks, /tmp/.tableauservicesmanagerca-lockfile)
2023-02-26 17:12:23.149 main : TRACE com.tableau.certificates.LinuxCertManager - Creating LinuxCertManager(/etc/opt/tableau/tableau_server/tableauservicesmanagerca.jks)
2023-02-26 17:12:23.149 main : TRACE com.tableau.certificates.PrivateKeystoreCertManager - Constructing PrivateKeystoreCertManager(/etc/opt/tableau/tableau_server/

仔细查看报错会发现，系统实在2019年12月安装的，到2022年12月正好三年！关键是为了稳定，客户三年没有升级，所以导致certification证书到期。

在一篇官方的说明文章中，我们找到类似的说明：

Error “Could not connect to TSM Controller at ‘https://servername:8850′” Running TSM Com

文章提到，如果有证书失效情况，优先查看tsm.log日志。

三、解决方案

也是在上面的官方帮助文件（英文）中，提到了该问题的背景信息和解决方案。

TSM使用了一个自签名的证书，在安装上生成。在早期版本中，Tableau重装时会自动重新生成证书，如今，重装安装tabadmincontroller也可以生成新证书。

TSM uses a self-signed SSL certificate that is generated at time of installation. In earlier versions, a full Tableau Server reinstall was required to regenerate a new SSL cert. In current versions, a reinstall of the tabadmincontroller can be performed to generate a new certificate.

另一个办法是在使用tsm时增加一个临时的参数–trust-admin-controller-cert，可以用于tsm命令和脚本升级。不过要注意，升级要在同一个大版本下操作，比如早期的2021.4.1版本，就可以升级到2021.4.14或者其他2021.4.1+版本。

Current releases have added a flag, –trust-admin-controller-cert, to tsm and the upgrade-tsm script. To perform this resolution, you need to install the same version family. For example, if using Tableau Server 2021.4.1, you will need to install Tableau Server 2021.4.1+.