安装和初始化 TSM


本主题引导您完成安装 Tableau Server 和初始化 Tableau 服务管理器 (TSM) 的过程。

重要信息：请不要在生产环境中安装 Tableau Server 的测试版。并且，您决不应使用测试版的备份来还原生产 Tableau Server 安装。

先决条件

在继续之前，请查看安装之前...主题。

查看可选初始化参数

在安装和初始化 TSM 之前，您必须查看可在初始化操作过程中根据需要设置的参数。您只能运行 initialize-tsm 一次，因此一定要在运行时包含组织需要的所有选项。某些选项（例如非默认系统用户和组）只能在初始化操作过程中配置。其他配置（例如转发代理和动态端口设置）可在运行初始化之后手动设置，但这样做将是一个非常耗费人力的过程。

有关可选参数的完整列表，请参见initialize-tsm 脚本的帮助输出。

下面是使用可选初始化参数的一些常见方案：

  • 配置 Tableau Server 以使用转发代理服务器。请参见本主题后面的可选：常用 initalize-tsm 参数，以在安装过程中配置 Tableau Server。您也可以在安装之后配置 Tableau Server，请参见配置 Linux 版 Tableau Server 以使用转发代理。
  • 指定动态端口映射。默认情况下，会从预定义的端口范围动态分配（映射）Tableau Server 需要的大多数端口。端口分配是在安装过程中针对每个服务或进程进行的。如果要修改端口映射，我们建议在安装过程中配置此项，请参见使用 initialize-tsm 控制端口重新映射。
  • 指定非默认系统用户或组。此配置更改只能在初始化过程中进行。请参见系统用户和组。
  • 指定非默认数据目录。此配置更改只能在初始化过程中进行。请参见数据目录。

安装 Tableau Server

使用发行版的软件包管理器安装 Tableau Server，然后运行脚本以初始化 TSM。安装的软件包附带了该脚本。

重要信息：启动 TSM 之后不能更改服务器的主机名。举例来说，如果您使用 cloud-init 软件包来初始化虚拟机，并在该虚拟机上安装 Tableau Server，则可能会发生这种情况。

安装 Tableau Server 软件包

默认情况下，Tableau Server 安装在 /opt 目录中。在类似于 RHEL 的分发版上，您可以指定其他安装位置。

  1. 以具有 sudo 访问权限的用户身份登录到要在其中安装 Tableau Server 的计算机。

    注意：为避免可能出现的复杂情况，我们建议使用不包含任何特殊字符（例如，非 ASCII、“+”、“-”）的用户帐户。这些字符可能会导致问题，包括无法完全安装 Tableau Server，具体取决于您的环境的配置方式。

  2. 从 Tableau Server 下载和版本说明页面下载 .rpm 或 .deb 安装程序包。

  3. 导航到您在其中复制了 .rpm 或 .deb 软件包的目录。

  4. 使用软件包管理器来安装 Tableau Server 软件包。

    您必须将新版本安装到与现有版本相同的位置。所有节点上的安装位置必须相同。请不要安装到使用符号链接的位置，或安装到网络文件系统 (NFS) 卷上的目录。

    • 在类似于 RHEL 分发（包括 CentOS）中，您可以选择将 Tableau 安装到非默认位置。

      • 默认位置 — 若要安装到默认位置 (/opt/tableau/tableau_server)，请运行以下命令，其中 <version> 的格式为主要-次要-维护（例如：2019-2-5）：

        sudo yum update

        sudo yum install tableau-server-<version>.x86_64.rpm

      • 非默认位置 — 若要安装到非默认位置，您必须使用 rpm -i。您还需要安装所有依赖包。请参见下面的注释。

        运行以下命令：

        sudo rpm -i --prefix /preferred/install/path tableau-server.rpm

      注意：当您使用 yum 安装 Tableau Server 时，将会自动下载和安装所有依赖包。这是安装 Tableau 的首选方法。如果要安装到非默认位置，或者组织不允许您使用 yum 并且必须使用 rpm -i 进行安装，则您还必须单独安装所有依赖包。有关安装依赖包的信息，请参见在运行 Linux 的无网络连接计算机上安装 Tableau Server。

    • 在 Ubuntu 上，运行以下命令，其中 <version> 的格式为主要-次要-维护（例如：2019-2-5）：

      sudo apt-get update
sudo apt-get upgrade
sudo apt-get -y install gdebi-core
sudo gdebi -n tableau-server-<version>_amd64.deb

初始化 TSM

不管是否将 Tableau 安装到默认位置，您都可以为数据（数据提取和数据提取元数据）存储指定单独的位置。

  1. 导航到 scripts 目录：

    cd /opt/tableau/tableau_server/packages/scripts.<version_code>/
    ：更新环境设置。

  2. 运行以下脚本以启动 TSM：

    sudo ./initialize-tsm --accepteula --activation-service --<optional_parameters>

    initialize-tsm 脚本的唯一必需参数为 --accepteula。您必须包括此参数来接受 Tableau Server 最终用户许可协议 (EULA)。EULA 可在以下位置中找到：

    /opt/tableau/tableau_server/packages/docs.<version_code>/Commercial_EULA.txt

    但是，请在运行脚本之前查看以下常用参数。

    可选：常用 initalize-tsm 参数

    运行 initialize-tsm 时可以设置许多参数（也称为标志）。下面列出了常用标志。有关完整列表，请运行 sudo ./initialize-tsm -h 命令，或参见initialize-tsm 脚本的帮助输出。

    • 使用 --activation-service 选项，以便使用 Tableau 授权运行 (ATR) 服务来激活 Tableau Server。自 Tableau Server 2021.4 及更高版本起，此选项是 Microsoft Windows 版 Tableau Server、Linux 版 Tableau Server 和容器中的 Tableau Server 的默认值。服务器 ATR 仅用于全新安装，而不是升级。此选项非常适合基于云的环境或虚拟环境，但可供可在线激活 Tableau Server 副本的任何人使用。选择 ATR 进行产品激活是一种永久的选择，以后无法撤消。有关详细信息，请参见使用授权运行 (ATR) 服务激活 Tableau Server(链接在新窗口中打开)。如果不想使用服务器 ATR 激活 Tableau Server，请使用 --no-activation-service 选项。

    • -a 标志，用于指定要添加到 tsmadmin 和 tableau 组的用户，而不是运行此脚本的用户。如果使用 root 帐户进行安装，您必须指定 -a 标志，

    • --unprivileged-user 标志，用于设置其他服务帐户。默认情况下，将创建一个名为 tableau 的新用户。此帐户是用于运行大多数 Tableau 进程的无特权服务帐户。我们建议，只有在计算机上已存在 tableau 用户帐户的情况下，才创建其他用户。

    • -d 标志，用于指定“数据目录”（Tableau Server 在其中存储数据提取、数据提取相关信息以及其他内容）的非默认位置。

      默认情况下，Tableau Server 为此目录使用以下位置：

      /var/opt/tableau/tableau_server

      如果设置此标志，intialize-tsm 脚本将创建您指定的目录并将权限应用于该目录。更改默认目录路径时存在重要限制。请参见数据目录。

    • --debug 标志用于故障排除。此选项在脚本运行时显示脚本中的每个命令，并可以更轻松地排除问题。使用此选项会生成大量的屏幕输出内容。

      注意：从版本 2021.3 开始，此选项已被移除，并且将显示的脚本输出记录到 /var/tmp/。

    • 我们建议在此安装过程中将 Tableau Server 配置为使用转发代理解决方案。

      为此，请包括用于指定转发代理服务器的 --http_proxy 和/或 --https_proxy 标志。指定包含端口的 URL，例如：

      --http_proxy=http://proxy.exampe.lan:80/

      --https_proxy=http://1.2.3.4:443/

      在为 https_proxy 环境变量指定 URL 时，注意要使用 http。不要为 https_proxy 环境变量的值指定 https 协议。

      若要将 Tableau Server 配置为绕过转发代理，请包括 --no_proxy 标志。您还应向此代理配置中添加例外来保证本地 Tableau Server 群集（如果目前有该群集或稍后将有该群集）内的所有通信不会路由到代理服务器。例如：

      --no_proxy=localhost,127.0.0.1,localaddress,.localdomain.com。

    • 如果要手动管理 TSM 和 Tableau Server 进程的端口分配，则可能需要将一个或多个端口相关的开关与 initialize-tsm 配合使用。有关详细信息，请参见使用 initialize-tsm 控制端口重新映射。

  3. 在配置 Tableau Server 之前，请注销并再次登录到终端。

    再次登录时，将会创建一个组成员身份变更已生效的新会话。新会话也具有 initialize-tsm 脚本所添加环境变量的访问权限。

后续步骤

回到顶部
感谢您的反馈!您的反馈已成功提交。谢谢!