---
schema_version: "1"
id: 17fd54201b0882dd10bea5fd4ecb8e1aaf1d435194592c1833c4e5a743a5a066
title: 服务器升级 - 收集配置详细信息
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/server/server-upgrade-prepare-gather-config.md
canonical_url: https://help.tableau.com/v0.0/server/zh-cn/server-upgrade-prepare-gather-config.htm
source_site: help.tableau.com
content_type: documentation
content_hash: e4f7e8f65806204b298ed453ad2ce6caa8a45f3bc260541c49352b9a369d1f3d
description: Gather configuration details before a Tableau Server upgrade.
---
[跳转到主要内容](#main-content)

# 服务器升级 - 收集配置详细信息

如果您正在运行就地升级（您没有在升级时更新硬件），则几乎所有配置数据都将保留。严格地说，在这种情况下，您不需要收集所有配置信息。但是，我们建议收集本主题中详细说明的信息。在最坏的情况下，如果升级失败，那么您将拥有需要恢复的所有配置信息的记录。在任何情况下，您都可以使用收集的配置详细信息在升级完成时验证升级。

## 截取屏幕截图

捕获基本配置内容的一种相对快速的方法是截取 TSM Web 界面页面和 Tableau Server 管理区域的屏幕截图。

依次单击所有可见页面并截取屏幕截图：

- [登录到 Tableau 服务管理器 Web UI](https://help.tableau.com/v0.0/server/zh-cn/sign_in_tsm.htm)
- [登录到 Tableau Server 管理区域](https://help.tableau.com/v0.0/server/zh-cn/sign_in_server_admin.htm)

## 记录对象计数

当您在 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_enabled`
- `svcmonitor.notification.smtp.ssl_required`
- `svcmonitor.notification.smtp.ssl_check_server_identity`
- `svcmonitor.notification.smtp.ssl_trust_all_hosts`
- `svcmonitor.notification.smtp.ssl_ciphers`
- `svcmonitor.notification.smtp.ssl_versions`

例如，若要检索为 SMTP TLS 配置的密码列表，请运行以下命令：

tsm configuration get -k svcmonitor.notification.smtp.ssl\_ciphers

您可以在[配置 SMTP 设置](https://help.tableau.com/v0.0/server/zh-cn/config_smtp.htm)的“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 外部存储库](https://help.tableau.com/v0.0/server/zh-cn/server_external_repo.htm)。

如果您使用的是外部存储库，则升级时可能需要执行其他步骤。

- **无版本更改** — 如果 PostgreSQL 中没有版本更改，则不需要执行任何特殊操作。
- **次要版本更改** — 如果 PostgreSQL 中有次要版本更改，您需要在升级 Tableau Server 之前升级外部存储库。在大多数情况下，都有现成的方法可以做到这一点。您使用的方法取决于存储库的位置，超出了本文档的范围。
- **主要版本更改** — 如果 PostgreSQL 中有主要版本更改，您需要按照[针对 PostgreSQL 新的主要版本升级包含外部存储库的 Tableau Server](https://help.tableau.com/v0.0/server/zh-cn/server_external_repo_upgrade_postgres.htm)中描述的步骤进行操作。
    
    步骤包括：
    
    1. 创建 PostgreSQL DB 的新实例。有关详细信息，请参见：
        - [在 AWS 关系数据库服务 (RDS) 上创建 PostgreSQL DB 实例](https://help.tableau.com/v0.0/server/zh-cn/server_external_repo_configure_RDS.htm)
        - [在 Azure 上创建 Azure 数据库 PostgreSQL 实例](https://help.tableau.com/v0.0/server/zh-cn/server_external_repo_configure_Azure.htm)
        - [在 Google Cloud 上创建 PostgreSQL 实例](https://help.tableau.com/v0.0/server/zh-cn/server_external_repo_configure_gcp.htm)
        - [以独立安装的形式创建 PostgreSQL 数据库](https://help.tableau.com/v0.0/server/zh-cn/server_external_repo_configure_standalone.htm)
    2. 创建配置文件，并下载在步骤 1 中创建的新实例的 SSl 证书文件。
    
    在升级期间，您需要使用配置文件将 Tableau Server 指向新实例。升级过程会将内容从当前外部存储库迁移到新实例。有关更多详细信息，请参见[针对 PostgreSQL 新的主要版本升级包含外部存储库的 Tableau Server](https://help.tableau.com/v0.0/server/zh-cn/server_external_repo_upgrade_postgres.htm)。

### 外部文件存储

升级配置有外部文件存储的 Tableau Server 时不需要特殊的步骤、操作或配置。您可以使用正常过程升级 Tableau Server。

### 端口自定义

如果更改了动态端口范围或为 Tableau Server 手动配置了端口，请记录所做的更改。

运行以下命令：

tsm topology list-ports

有关详细信息，请参见[Tableau 服务管理器端口](https://help.tableau.com/v0.0/server/zh-cn/ports.htm)。

### 代理自定义

如果您正在使用 OAuth，并且对 `<drive>:\Program Files\Tableau\Tableau Server\packages\repository.<version>\jre\conf` 文件夹中 Tableau Server 的 `net.properties` 文件进行了任何更改，您应该记录您所做的更改。升级过程会创建一个新的 `net.properties` 文件，升级后您可能需要更新这个新文件。

您可以将副本保存到安全的位置，并在升级后使用它来与新创建的文件进行比较，以找出任何差异。

有关详细信息，请参见 Tableau Desktop 和 Web 制作帮助中的[为 OAuth 身份验证配置转发代理](https://help.tableau.com/current/pro/desktop/zh-cn/config_proxy_oauth.htm)。

继续执行[服务器升级 - 验证许可状态](https://help.tableau.com/v0.0/server/zh-cn/server-upgrade-prepare-verify-licensing.htm)