---
schema_version: "1"
id: 8f2e0dce91440e7e0ea9f7b00f44dab86c3da06ade0bdee789ebe379bb30ad56
title: 服务器升级 - 收集配置详细信息
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/server-linux/server-upgrade-prepare-gather-config.md
canonical_url: https://help.tableau.com/v0.0/server-linux/zh-cn/server-upgrade-prepare-gather-config.htm
source_site: help.tableau.com
content_type: documentation
content_hash: dfbdb1488112ca8b2ead3c77213191f2c0970be56a85a6adcf2740982fc11ac2
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-linux/zh-cn/sign_in_tsm.htm)
- [登录到 Tableau Server 管理区域](https://help.tableau.com/v0.0/server-linux/zh-cn/sign_in_server_admin.htm)

## 记录对象计数

当您在 Tableau Server 管理区域中时，对每个站点中的以下内容进行计数和记录：

- 项目、工作簿、视图、数据源
- 用户和组

## 记录防火墙配置

如果您为 Linux 版 Tableau Server 配置了本地防火墙，那么最好复制记录的配置。

我们的设置文档介绍了如何使用[防火墙](http://www.firewalld.org/) 在 RHEL/CentOS 发行版上运行的 Tableau Server 单节点和多节点部署上配置防火墙。请参见[配置本地防火墙](https://help.tableau.com/v0.0/server-linux/zh-cn/config_firewall_linux.htm)。

运行以下命令以检索防火墙配置：

sudo firewall-cmd --list-all

## 验证 TSM 控制器证书过期

验证 TSM 控制器的证书是否仍然有效。

若要验证 TSM 控制器 SSL 证书的过期日期，请执行以下操作：

1. 打开一个终端会话。
2. 键入以下命令以显示证书的有效日期：
    
    openssl s\_client -connect <tsm\_servername>:8850
    
    echo | openssl s\_client -connect <tsm\_servername>:8850 2>/dev/null | openssl x509 -noout -dates
3. 如果证书已过期，请向我们的支持团队[提起一个案例](https://www.tableau.com/zh-cn/support/case)，他们可以提供相关指导。

## 收集资产文件

上载到 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-linux/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-linux/zh-cn/server_external_repo.htm)。

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

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

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