服务器升级 - 收集配置详细信息
如果您正在运行就地升级（您没有在升级时更新硬件），则几乎所有配置数据都将保留。严格地说，在这种情况下，您不需要收集所有配置信息。但是，我们建议收集本主题中详细说明的信息。在最坏的情况下，如果升级失败，那么您将拥有需要恢复的所有配置信息的记录。在任何情况下，您都可以使用收集的配置详细信息在升级完成时验证升级。
截取屏幕截图
捕获基本配置内容的一种相对快速的方法是截取 TSM Web 界面页面和 Tableau Server 管理区域的屏幕截图。
依次单击所有可见页面并截取屏幕截图：
记录对象计数
当您在 Tableau Server 管理区域中时，对每个站点中的以下内容进行计数和记录：
- 项目、工作簿、视图、数据源
- 用户和组
收集资产文件
上载到 Tableau Server 的许多支持文件（证书、IdP 元数据、徽标等）在上载后，将无法使用 TSM 进行访问。具体而言，由客户端文件服务上载和管理的文件在跨部署分发之前将被重命名和混淆。此过程还会将 Tableau 服务所需的文件属性参数化。因此，对于以下文件，文件不会映射到文件系统上的单一文件位置。如果已上载以下任何文件，请确保从运行 Tableau Server 的计算机中保存这些文件的副本：
- SAML 证书文件
- SAML 密钥文件
- SAML IdP 元数据文件
- OpenID .static 文件
- Kerberos .keytab 文件
- LDAP Kerberos 密钥表文件
- LDAP Kerberos conf 文件
- 相互 SSL 证书文件
- 相互 SSL 吊销文件
- 自定义标头徽标文件
- 自定义登录徽标文件
- 自定义压缩徽标文件
收集自定义配置信息
某些配置信息不会显示在 TSM 或 Tableau Server 网页中。此部分包括您可能需要收集的配置详细信息，具体取决于您自定义 Tableau 部署的方式。
安全 SMTP
如果已为 Tableau 服务器配置 TLS，则需要记录与 TLS 相关的配置，这些配置不包括在 TSM Web UI 的“电子邮件服务器”配置中。
若要收集与 TLS 相关的配置，必须使用以下键值运行 tsm configuration get：
svcmonitor.notification.smtp.ssl_enabledsvcmonitor.notification.smtp.ssl_requiredsvcmonitor.notification.smtp.ssl_check_server_identitysvcmonitor.notification.smtp.ssl_trust_all_hostssvcmonitor.notification.smtp.ssl_cipherssvcmonitor.notification.smtp.ssl_versions
例如，若要检索为 SMTP TLS 配置的密码列表，请运行以下命令：
tsm configuration get -k svcmonitor.notification.smtp.ssl_ciphers
您可以在配置 SMTP 设置的“TSM CLI”部分找到有关上述每个密钥的详细信息。
分析扩展程序
如果配置了分析扩展程序（以前称为“外部服务”），则需要记录配置信息。升级到 Tableau Server 2020.2 或更高版本将移除此功能的所有配置。
若要从 Tableau Server 版本 2019.1 至 2020.1 检索分析扩展程序配置，请运行以下命令：
tsm security vizql-extsvc-ssl list
若要检索为分析扩展程序连接存储的密码（如果有），请运行以下 tsm 命令：
tsm configuration get -k vizqlserver.rserve.password
如果配置了 SSL，则还应该有用于分析扩展程序的证书副本。
外部存储库
这仅适用于将外部存储库配置与 Tableau Server 一起使用的情况。如果您不确定这是否适用于您，请参见Tableau Server 外部存储库。
如果您使用的是外部存储库，则升级时可能需要执行其他步骤。
- 无版本更改 — 如果 PostgreSQL 中没有版本更改，则不需要执行任何特殊操作。
- 次要版本更改 — 如果 PostgreSQL 中有次要版本更改，您需要在升级 Tableau Server 之前升级外部存储库。在大多数情况下，都有现成的方法可以做到这一点。您使用的方法取决于存储库的位置，超出了本文档的范围。
主要版本更改 — 如果 PostgreSQL 中有主要版本更改，您需要按照针对 PostgreSQL 新的主要版本升级包含外部存储库的 Tableau Server中描述的步骤进行操作。
步骤包括：
- 创建 PostgreSQL DB 的新实例。有关详细信息，请参见：
- 创建配置文件，并下载在步骤 1 中创建的新实例的 SSl 证书文件。
在升级期间，您需要使用配置文件将 Tableau Server 指向新实例。升级过程会将内容从当前外部存储库迁移到新实例。有关更多详细信息，请参见针对 PostgreSQL 新的主要版本升级包含外部存储库的 Tableau Server。
外部文件存储
升级配置有外部文件存储的 Tableau Server 时不需要特殊的步骤、操作或配置。您可以使用正常过程升级 Tableau Server。
端口自定义
如果更改了动态端口范围或为 Tableau Server 手动配置了端口，请记录所做的更改。
运行以下命令：
tsm topology list-ports
有关详细信息，请参见Tableau 服务管理器端口。
代理自定义
如果您正在使用 OAuth，并且对 <drive>:\Program Files\Tableau\Tableau Server\packages\repository.<version>\jre\conf 文件夹中 Tableau Server 的 net.properties 文件进行了任何更改，您应该记录您所做的更改。升级过程会创建一个新的 net.properties 文件，升级后您可能需要更新这个新文件。
您可以将副本保存到安全的位置，并在升级后使用它来与新创建的文件进行比较，以找出任何差异。
有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的为 OAuth 身份验证配置转发代理(链接在新窗口中打开)。