启用 JMX 端口

为帮助您解决 Tableau Server 的问题,Tableau 支持人员可能会要求您启用服务器的 JMX 端口。这些端口对于通常使用像 JConsole 这样的工具进行监视和故障排除的情况会非常有用。在版本 2022.1 及更高版本中,可以安全地启用 JMX 端口,这是推荐的方法。在 2022.1 之前的版本中,您只能启用不安全的端口。

启用安全的 JMX 端口

Tableau Server 的版本 2022.1 开始,您可以安全地启用 JMX 端口。本过程介绍了如何启用安全的 JMX。若要在早期版本中启用 JMX,请参见下面的启用不安全的 JMX 端口

Tableau Server 上启用安全的 JMX 端口:

  1. 以对要在其中安装 TSM 的计算机具有管理员权限的用户身份打开命令提示符。

  2. 运行此命令:

    tsm maintenance jmx enable

    该命令有几个选项,您可以在运行时提供。如果您在运行命令时未提供任何选项,系统将根据您给出的答案提示您提供选项。

    例如:

    C:\Windows\system32>tsm maintenance jmx enable
    We do not recommend you enable JMX unsecured on a production environment. Would you like to enable security features for JMX?
    (y/n): y
    JMX access is readonly by default. Would you like to add readwrite access?
    (y/n): n
    Would you like to enable SSL?
    (y/n): y
    Would you like to require client authentication (mTLS)?
    (y/n): n
    Enabling JMX with the specified settings. This will perform a server restart. Do you want to continue?
    (y/n): y
    Starting enable JMX asynchronous job.

    有关该命令及其选项的详细信息,请参见tsm maintenance jmx enable

启用不安全的 JMX 端口

对于 2022.1.0 之前的 Tableau Server 版本,如果您启用 JMX 端口,则只能以不安全的方式启用它们。

重要信息:启用不安全的 JMX 端口可能会引入一些安全风险。我们强烈建议使用安全的 JMX。如果您没有支持这一点的 Tableau Server 版本,请注意风险,并通过将 JMX 端口的访问限制为对您的场景实用的最少客户端数量来减轻风险。您通常使用主机防火墙规则、外部安全设备或路由规则来限制访问。

在 Tableau Server 上启用不安全的 JMX 端口:

  1. 停止服务器。

  2. 输入以下命令:

    tsm configuration set -k service.jmx_enabled -v true
  3. 应用待处理的更改:

    tsm pending-changes apply

    如果待定更改需要重新启动服务器,pending-changes apply 命令将显示一个提示,告知您将进行重新启动。即使服务器已停止,此提示也会显示,但在这种情况下不会重新启动。您可以使用 --ignore-prompt 选项隐藏提示,但这样做不会改变重新启动行为。如果更改不需要重新启动,则会在不提示的情况下应用更改。有关详细信息,请参见tsm pending-changes apply

  4. 重新启动协调服务和 TSM 管理控制器:

    net stop appzookeeper_0

    net start appzookeeper_0

    net stop tabadmincontroller_0

    net start tabadmincontroller_0

    注意:您必须以管理员身份通过命令提示符运行这些命令。根据您的计算机的配置方式,您可能需要在 C:\Windows\System32 文件夹中运行这些命令。

    tabadmincontroller 可能需要几分钟才会重新启动。如果尝试在下一步中控制器重新启动之前应用待处理更改,则 TSM 将无法连接到控制器。您可以使用 tsm status -v 命令验证控制器是否正在运行。Tableau Server 管理控制器应列为“正在运行”。

  5. 启动服务器

如何确定 JMX 端口

默认情况下,会从可用端口范围内动态分配 JMX 端口。有关如何完成端口分配以及如何覆盖动态映射的详细信息,请参见Tableau 服务管理器端口

感谢您的反馈!您的反馈已成功提交。谢谢!