Instalar el agente usando la línea de comandos

El agente es un proceso ligero que consume un mínimo de recursos del servidor y envía datos al servidor Resource Monitoring Tool (servidor de RMT). Instale el agente de Resource Monitoring Tool en cada uno de los nodos de Tableau Server. Para instalar y registrar un agente, descargue el archivo de configuración de arranque del agente y guárdelo en una ubicación accesible desde los nodos agente de Resource Monitoring Tool.

En este tema se describen los pasos que puede usar para instalar el agente de Resource Monitoring Tool usando la línea de comandos. La instalación con la línea de comandos es compatible con los sistemas operativos Windows y Linux.

En un esfuerzo por alinearnos con los valores de igualdad de nuestra empresa, hemos cambiado la terminología no inclusiva siempre que sea posible. Debido a que el cambio de términos en ciertos lugares puede causar un cambio radical, mantenemos la terminología existente. Por lo tanto, puede seguir viendo los términos en los comandos y opciones de la CLI, las carpetas de instalación y los archivos de configuración y otras instancias. Para obtener más información, consulte Acerca de la ayuda de Tableau(El enlace se abre en una ventana nueva).

Antes de instalar

  • Descargue el archivo de arranque y guárdelo en una ubicación a la que puedan acceder los nodos en los que va a instalar el agente de RMT. Los archivos de arranque solo son válidos durante 24 horas después de la descarga. Deberá volver a generar el archivo de arranque si el que está utilizando tiene más de 24 horas.
  • A partir de la versión 2021.3, el registro del agente deberá comunicarse tanto a través de un extremo https y RabbitMQ para completar el registro del agente. Asegúrese de que ambos puertos 443 y 5672 estén abiertos para estas comunicaciones.

Para instalar y configurar el agente:

  1. Instalación:
    1. Descargue el instalador .rpm o .deb del agente y guárdelo en una ubicación a la que pueda acceder desde el equipo donde va a instalar el agente.

    2. Ejecute el siguiente comando para instalar el agente, donde <versión> debe tener el formato versión principal-secundaria-mantenimiento:

      Para distribuciones similares a RHEL incluyendo CentOS:

      sudo yum install Tabrmt-Agent-x86_64-<version>.rpm

      Para Ubuntu:

      sudo apt install Tabrmt-Agent-amd64-<version>.deb

  2. Inicializar el agente RMT:

    Debe aceptar explícitamente el Acuerdo de licencia de usuario final (EULA) cuando inicialice el agente RMT. También tiene la opción de especificar configuraciones no predeterminadas. Para inicializar el agente RMT con una configuración predeterminada, ejecute este comando:

    sudo /opt/tableau/tabrmt/agent/install-scripts/initialize-rmt-agent --accepteula

    El EULA se puede encontrar en la carpeta /opt/tableau/tabrmt/agent/docs.

    A partir de la versión 2023.1, puede especificar una cuenta de ejecución personalizada para que la utilice RMT, así como otras opciones de configuración. De forma predeterminada, RMT crea y usa una cuenta llamada rmt-agent para ejecutarse. Para especificar una cuenta de ejecución personalizada para que la utilice el agente RMT, incluya la opción --unprivileged-user cuando ejecuta el script de inicialización. Para obtener información sobre todos los switches disponibles para el script initialize-rmt-agent, consulte Opciones del script de inicialización del agente RMT.

  3. Registro:
    1. Cierre la sesión e inicie sesión como usuario tabrmt-agent para que pueda ejecutar comandos rmtadmin, que siempre requieren que se ejecuten como usuario tabrmt-agent. Además, cuando vuelva a iniciar sesión, creará una nueva sesión en la que se hayan aplicado los cambios en los miembros del grupo.

      sudo su --login tabrmt-agent

    2. Ejecute el siguiente comando y proporcione la ruta de acceso donde se encuentra el archivo de arranque. Proporcione una descripción del nodo donde se está instalando el agente.

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --server-description=<server description> --username=<name of the RMT admin user>

      Se le pedirá la contraseña del usuario con permisos de administración en RTM.

      Nota: El usuario ejecuta los comandos tabrmt-agent de forma predeterminada desde el directorio de trabajo base: /var/opt/tableau/tabrmt/agent, por lo que debe especificar la ruta de archivo. Por ejemplo, si coloca el archivo de arranque en la carpeta /var/opt/tableau/tabrmt/agent/bootstrap/, tal y como se recomienda, la ruta del archivo sería /var/opt/tableau/tabrmt/agent/bootstrap/<bootstrap_file_name>.

      En la tabla siguiente se enumeran las opciones de configuración utilizadas para registrar el agente:

      Opción¿Obligatorio?PredeterminadoDescripción
      --bootstrap file<none>La ubicación del archivo de arranque.
      --username<none>Este suele ser el usuario administrador que creó durante la instalación del servidor de RMT.
      --password<none>Esta es la contraseña de la cuenta de usuario.
      --password-file

      No

      La contraseña se puede proporcionar en la línea de comandos o en un archivo que contenga la contraseña. Si no se proporciona ninguna, se le pedirá que lo haga.

      <none>Ruta que incluye el nombre del archivo donde se almacena la contraseña.
      -- server-nameNoNombre de host del equipoNombre del equipo que tiene el agente instalado. Si no se proporciona ninguna opción, este campo se establecerá de forma predeterminada en el nombre de host del equipo.
      --server-descriptionNo<none>Descripción del equipo que tiene instalado el agente. Si no se proporciona ninguna opción, este campo permanecerá en blanco.

Instalación del agente en una versión de Tableau Server de varios nodos

Ejecute los pasos descritos anteriormente en cada uno de los nodos de Tableau Server. En la interfaz web del servidor de RMT debería poder ver todos los nodos donde está instalado el agente.

¿Quién puede hacer esto?

Para instalar Resource Monitoring Tool, debe tener todo lo siguiente:

Windows:

  • Permisos de administrador en el equipo en el que está instalando Resource Monitoring Tool.
  • Rol en el sitio Administrador de Tableau Server.

Linux:

  • Acceso sudo completo para la cuenta de usuario que se utiliza para instalar el agente.

Paso siguiente

Configure Resource Monitoring Tool de Tableau