跳至正文

【升级】Tableau Server升级到2022.1.2版本（全新认证服务）

标签:

阿里云Linux环境升级Tableau Server

Jun 12, 2022 喜乐君 更新；从2020.4版本升级到2022.1.2版本

官方升级说明地址： 升级 Tableau Server 概述

关于升级的说明：

  • 10.5版本需要特别的处理，注意。
  • 升级可以立即升级，也可以先在新环境中升级，然后流量重新定向（蓝/绿升级），详见官方说明 使用蓝/绿方法升级 Tableau Server
  • 2022.1采用了全新的身份认证机制，升级后需要做身份迁移。

1、检查和准备

  1.1 检查硬件，检查升级事项

检查硬件符合要求等。

  1.2 备份

(base) [admin@Tableau2021 ~]$ tsm maintenance backup -po -f ts-backup -d 
作业 ID 为“44”，超时为 1440 分钟。
8% - 正在启动活动存储库实例、文件存储和群集控制器。
16% - 正在等待活动存储库、文件存储和群集控制器启动。
25% - 安装备份服务。     
33% - 正在估计所需的磁盘空间。     
41% - 从所有节点收集磁盘空间信息。
50% - 正在分析磁盘空间信息。
58% - 正在检查所有节点上是否有足够的磁盘空间。
66% - 备份数据库。     
75% - 备份配置。
83% - 组合 tsbak 存档。
91% - 如有必要，停止主动存储库。
100% - 如有必要，请等待主动存储库停止。
100% - 卸载备份服务。    
写入控制器节点上“/var/opt/tableau/tableau_server/data/tabsvc/files/backups/ts-backup-2022-06-12.tsbak”的备份。
(base) [admin@Tableau2021 ~]$ 
(base) [admin@Tableau2021 ~]$ tsm settings export -f settings-2022-5
写入 /home/admin/settings-2022-5 的配置文件。
(base) [admin@Tableau2021 ~]$

  1.3 下载新版本

    从https://www.tableau.com/zh-cn/support/releases获得最新的软件版本下载地址。

    这里下载rpm文件，使用wget命令。如下：

xilejun@Apeng-tableau ~ % ssh admin@39.101.73.XXX
admin@39.101.73.XXX's password: 
Last login: Sun Jun 12 11:26:38 2022 from 101.87.84.183

Welcome to Alibaba Cloud Elastic Compute Service !
[admin@Tableau2021 ~]$
[admin@Tableau2021 ~]$ wget https://downloads.tableau.com/esdalt/2022.1.2/tableau-server-2022-1-2.x86_64.rpm

(b [admin@Tableau2021 ~]$ ll -h
总用量 2.8G
-rw-r--r--  1 admin wheel 2.7G 5月  24 05:31 tableau-server-2022-1-2.x86_64.rpm
-rw-r--r--  1 admin wheel  12K 2月  26 20:46 tableau_server_settings_2021-2-26
-rw-r--r--  1 admin wheel  51M 2月  24 09:02 tableau-tabcmd-2021-4-4.noarch.rpm
-rw-r--r--  1 admin wheel  880 12月 14 10:54 tnsnames.ora

2、升级tableau server

2.1安装程序

使用具有sudo权限的账号，最好是之前的tableau安装账号。推荐 yum update

(base) [admin@Tableau2021 ~]$ sudo yum install tableau-server-2022-1-2.x86_64.rpm  -y 
[sudo] admin 的密码：
已加载插件：fastestmirror
正在检查 tableau-server-2022-1-2.x86_64.rpm: tableau-server-20221.22.0516.1720-20221-22.0516.1720.x86_64
tableau-server-2022-1-2.x86_64.rpm 将被安装
正在解决依赖关系
--> 正在检查事务
---> 软件包 tableau-server-20221.22.0516.1720.x86_64.0.20221-22.0516.1720 将被 安装
--> 解决依赖关系完成


依赖关系解决

========================================================================================================
 Package                            架构    版本                 源                                大小
========================================================================================================
正在安装:
 tableau-server-20221.22.0516.1720  x86_64  20221-22.0516.1720   /tableau-server-2022-1-2.x86_64  5.1 G

事务概要
========================================================================================================
安装  1 软件包

总计：5.1 G
安装大小：5.1 G
Downloading packages:
Running transaction check
Running transaction test
Transaction test succeeded
Running transaction

Your hardware meets the minimum requirements for a trial of Tableau Server.
If you plan to run Tableau Server in a production environment, we recommend the following hardware specifications: http://www.tableau.com/products/server/specs
Tableau Server runs best with at least 64 GB memory, but found only 31 GB of memory.
Tableau Server runs best with at least 8 cores, but found only 4 core(s).

  正在安装    : tableau-server-20221.22.0516.1720-20221-22.0516.1720.x86_64                                            1/1 

Found existing installation version '20214.22.0213.1102' in /var/opt/tableau/tableau_server

Tableau Server runs best with at least 50 GB of free disk space,
but found only 30 GB for the data directory '/var/opt/tableau/tableau_server'. Continuing.

Found existing installation version '20214.22.0213.1102' in /var/opt/tableau/tableau_server

After new version has been installed on every Tableau Server node, run:

    sudo /opt/tableau/tableau_server/packages/scripts.20221.22.0516.1720/upgrade-tsm --accepteula

on initial (controller) node to continue upgrading Tableau Server.
  验证中      : tableau-server-20221.22.0516.1720-20221-22.0516.1720.x86_64                                            1/1 

已安装:
  tableau-server-20221.22.0516.1720.x86_64 0:20221-22.0516.1720                                                            

完毕！
(base) [admin@Tableau2021 ~]$

2.2运行升级脚本

推荐使用之前安装主节点的账号，无需-u指定。

sudo /opt/tableau/tableau_server/packages/scripts.<version_code>/upgrade-tsm -u <system_admin> --accepteula

其中 <version_code> 是要升级到的新版本的长格式，例如 scripts.20183.18.1128.2033，system_admin 安装了初始节点的计算机上具有管理权限的用户。系统将提示您输入管理用户的密码。

推荐分为多个步骤执行，确保scirpt路径正确。

[admin@Tableau2021 ~]$ cd /opt/tableau/tableau_server/packages/scripts.20221.22.0516.1720/
[admin@Tableau2021 scripts.20221.22.0516.1720]$ 
[admin@Tableau2021 scripts.20221.22.0516.1720]$ ls
after-install                                initialize-tsm               start-administrative-services
after-install-common                         initialize-tsm-common        stop-administrative-services
auto-node-recovery                           local-configuration          tabcmd.autocomplete
before-remove                                move-tsm-controller          tableau-server-obliterate
checkprocessorspecs                          pam-systemd-check            tsm.autocomplete
config.json                                  README                       upgrade-tsm
defaults.bash                                README-TSIG.txt              user-at-override.conf
disable-coordination-service-authentication  stack-traces-from-coredumps  user-at.service
(base) [admin@Tableau2021 scripts.20221.22.0516.1720]$ 
(base) [admin@Tableau2021 scripts.20221.22.0516.1720]$ sudo ./upgrade-tsm  --accepteula
Upgrading Tableau Server to version 20221.22.0516.1720. 
See log file at /var/opt/tableau/tableau_server/logs/app-upgrade.log for progress.

正在验证升级脚本是否在正确的环境中运行。
正在验证 Tableau Server 版本。
验证新的软件包是否已安装在所有群集节点上。
正在验证 Active Directory 连接。
验证配置是否有效。
执行预检以确保服务器处于良好状态以便升级。
正在验证对备份文件路径的访问。
正在重新连接异步作业...
25% - 正在验证 Tableau Server 管理控制器是否有权访问备份文件。
正在运行 - 安装备份服务。作业 ID 为“45”，超时为 60 分钟。
50% - 安装备份服务。    
75% - 正在验证备份还原服务是否有权访问备份文件。
100% - 卸载备份服务。    
正在停止服务...
此操作将停止服务器。若要启动服务器，请在升级完成后运行“tsm start”。是否要继续?
(y/n): y
……

升级时长大约30分钟左右，具体步骤这里不展开。

2.3 升级完成后，退出终端会话并再次登录

这样可确保您的会话将使用更新的 TSM 版本。

(base) [admin@Tableau2021 ~]$ exit
登出
Connection to 39.101.73.127 closed.
xilejun@Apeng-tableau ~ %

2.4 启动 Tableau Server

启动服务。

(base) [admin@Tableau2021 ~]$ tsm version
Tableau 服务管理器命令行版本 20221.22.0516.1720。
Tableau Server 版本 20221.22.0516.1720。
(base) [admin@Tableau2021 ~]$ tsm start 
正在启动服务...
作业 ID 为“65”，超时为 30 分钟。

……

3.用户身份迁移

从2022.1开始，tableau使用了全新的身份策略 identify service，因此升级之后需要增加身份转换。在新的身份策略下，每个用户都将有一个 通用唯一标识符 (UUID) 。

参考官方说明： 关于身份迁移

3.1 在80页面执行身份转换

  • 以管理员身份登录到 Tableau Server。
  • 从左侧导航窗格中，选择“用户”（对于多站点 Tableau Server，选择“所有站点”>“用户”），然后单击“身份迁移”页面以验证迁移是否已开始。
  • 执行以下操作之一：
    • 若要立即运行身份迁移作业，请单击“编辑计划”下拉箭头，选择“立即运行”。
    • 或者，可以等待迁移作业在下一个计划的时间运行。
  • 迁移完成后，从“身份迁移”页面中验证“迁移概述”是否显示“100% 完成”。

如图所示：

3.2 在命令终端中禁用传统身份策略

身份迁移完成后，将 Tableau Server 配置为使用身份服务，以确保用户预置和身份验证过程的身份结构更加安全且不可变。

  • 在群集中的初始节点（安装了 TSM 的节点）上以管理员身份打开命令提示符。
  • 运行以下命令：
 [admin@Tableau2021 ~]$ tsm authentication legacy-identity-mode disable 
已成功完成。请运行“tsm pending-changes apply”以应用新的配置。
 [admin@Tableau2021 ~]$ tsm pending-changes apply
此操作将执行服务器重新启动。是否确实要继续?
(y/n): y
正在开始部署异步作业。
作业 ID 为“66”，超时为 46 分钟。
7% - 检索要部署的拓扑。
15% - 检索要部署的配置。
23% - 正在验证新的拓扑。
30% - 正在确定是否需要启动服务器。
38% - 禁用所有服务。
46% - 等待停止服务。     
53% - 正在将节点更新为新拓扑。
61% - 等待应用拓扑。
69% - 将节点更新为新配置。     
76% - 重新配置服务。

Tableau Server 配置为使用身份服务后，当用户登录到 Tableau Server 时，Tableau Server 会使用他们在配置的身份存储中的标识符来搜索他们的用户身份。

从标识符中，将返回通用唯一标识符 (UUID) 并用于匹配现有 Tableau Server 用户身份。然后，此过程为用户生成会话并完成身份验证工作流程。

未尽事项：新的用户身份机制，对于嵌入等的影响。

Jun 12, 2022

《【升级】Tableau Server升级到2022.1.2版本（全新认证服务）》有2个想法

  1. Pingback： Tableau Server集群部署之hostname问题 – 喜乐君

  2. Pingback： 【故障排除】Tableau Server集群部署之用户与hostname问题 – 喜乐君

评论已关闭。

了解 喜乐君 的更多信息

立即订阅以继续阅读并访问完整档案。

Continue reading