安装和初始化 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 和 Debian 上,运行以下命令,其中 <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 --<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 脚本的帮助输出

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

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

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

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

      /var/opt/tableau/tableau_server

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

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

    • 我们建议在此安装过程中将 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 控制端口重新映射

    • 如果要使用 Tableau 授权运行 (ATR) 服务来激活 Tableau Server,请使用 --activation-service。此选项仅用于全新安装,而不是升级。此选项非常适合基于云的环境或虚拟环境,但可供可在线激活 Tableau Server 副本的任何人使用。选择 ATR 进行产品激活是一种永久的选择,以后无法撤消。有关详细信息,请参见使用授权运行 (ATR) 服务激活 Tableau Server(链接在新窗口中打开)

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

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

后续步骤

感谢您的反馈!