Instalar desde la línea de comandos

En este artículo se describe cómo usar la línea de comandos para instalar Tableau Desktop, Tableau Prep Builder y Tableau Desktop Public Edition y realizar otras acciones de instalación, como la activación, el registro o la desinstalación del producto.

Para obtener información más detallada sobre cómo encontrar el instalador y la clave de producto, consulte ¿Dónde está el instalador? y Encontrar su clave de producto.

Nota: Si está actualizando, consulte Actualizar Tableau Desktop y Tableau Prep Builder para obtener información sobre cómo prepararse para una actualización.

Tableau habilita determinadas características de forma predeterminada, como, por ejemplo, informes de uso o actualizaciones de productos automatizadas (solo para Tableau Desktop). Para obtener información sobre cómo desactivar estas características y más, consulte Cambiar la configuración de instalación después de la instalación(El enlace se abre en una ventana nueva).

Antes de empezar

  • Compatibilidad con el servidor: los productos de Tableau no siempre se lanzan al mismo tiempo. Al instalar una nueva versión de Tableau Desktop, asegúrese de que sea compatible con Tableau Server. Consulte Búsqueda y resolución de problemas de compatibilidad.
  • Instale Desktop y Prep en el mismo equipo: Tableau Prep Builder está diseñado para funcionar con Tableau Desktop. Se recomienda instalar Tableau Prep Builder en el mismo equipo que Tableau Desktop.
  • No instale Tableau Prep Builder en el mismo equipo que ejecuta Tableau Server: Tableau Server Resource Manager (SRM) no puede distinguir entre el proceso de servidor de protocolo de Tableau Server y el proceso de servidor de protocolo de Tableau Prep Builder. Si los recursos del equipo se agotan, SRM podría cerrar el proceso de servidor de protocolos de Tableau Prep Builder, que no incluye un sistema de recuperación.
  • Requisito del instalador de Windows: Si usa una herramienta de implementación que requiere el instalador de Windows (archivo .msi) para instalar Tableau Desktop o Tableau Prep Builder, siga las instrucciones de Extraer y ejecutar el instalador de Windows (MSI) para extraer el archivo .msi del archivo .exe del instalador de Tableau.

Haga clic en la ficha que aparece a continuación relacionada con el producto que está instalando para ver los pasos de instalación.

Windows

  1. Ejecute como administrador el archivo .exe del instalador desde la línea de comandos del equipo.
    Si necesita extraer los archivos .msi, siga las instrucciones descritas en la sección Extraer y ejecutar el instalador de Windows (MSI) de este artículo.

    La sintaxis para ejecutar el instalador de Tableau desde la línea de comandos es la siguiente:

    tableau_<product_installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2

    • tableau_<product_installer_name>.exe: es el instalador de Tableau del producto y la versión que va a instalar.

    • Opciones: las opciones que utiliza especifican cómo debe ejecutarse el proceso de instalación. Por ejemplo, si debe mostrar el resultado durante la instalación o si debe crear archivos de registro. Consulte Opciones del instalador para ver la lista de opciones disponibles.

    • Propiedades: las opciones de propiedades especifican opciones de configuración que debe aplicar el instalador durante el proceso de instalación. Consulte Propiedades del instalador para ver la lista de propiedades disponibles.
  2. Ejecute el comando desde el directorio en el que se encuentra el archivo .exe o bien especifique una ruta completa a la ubicación del archivo .exe en el equipo. No ejecute el programa de instalación desde un directorio compartido de su red. En lugar de ello, descargue el archivo .exe a un directorio del equipo en el que va a efectuar la instalación.

    Ejemplo

    En el siguiente ejemplo se muestra un comando de instalador con algunas opciones y algunas preferencias de propiedades.

    tableauDesktop-64bit-2021-4-4.exe /quiet /norestart ACCEPTEULA=1 AUTOUPDATESERVER="assets.intranet.lan" REPORTINGSERVER="http://mytableau"

    El comando del ejemplo hace lo siguiente:

    • Instala la versión de 64 bits de Tableau Desktop 2021.4.4.

    • Ejecuta el instalador en modo silencioso; es decir, en el proceso de instalación no se muestran indicaciones, la IU ni el cuadro de diálogo de la licencia.

    • Configura la instalación para que finalice sin reiniciarse.

    • Acepta el Acuerdo de licencia de usuario final (EULA).

    • Configura un servidor de actualización del producto no predeterminado.

    • Configura el producto para enviar informes de licencias a un Tableau Server interno.

Mac

Importante: instale solo Tableau en la unidad raíz para que FlexNet y los controladores de dispositivo se instalen en la ubicación correcta.

  1. Cargue una copia del archivo DMG de Tableau Desktop en un recurso compartido de la red e indique a los usuarios que lo descarguen en sus equipos Mac desde esa ubicación. Debe seguir las indicaciones para completar la instalación.

    También puede crear un script .sh que monte el archivo DMG y que copie Tableau en los equipos de los usuarios. En los siguientes ejemplos se muestra un script que ejecuta esta tarea para distintas versiones de Tableau Desktop.

    Ejemplo: Tableau Desktop versión 10.2 y versiones posteriores

    #!/usr/bin/env bash
    # mount the DMG and copy Tableau.app to a folder
    output=`yes | hdiutil attach "<DMG_name>.dmg"`
    sleep 10
    volName=`echo "$output" | tail -n 1 |sed 's;^.*\(/Volumes.*$\);\1;'`
    open "/Volumes/Tableau/Tableau Desktop.pkg"
    # dismount the Tableau DMG volume
    hdiutil detach """${volName}""" -force
  2. (opcional) Ejecute la aplicación del instalador para realizar una instalación en modo silencioso. Escriba lo siguiente en la línea de terminal:

    sudo installer -pkg <path and name of .pkg file> -target /

    Escriba lo siguiente en la línea de terminal: Verá estas tres líneas:

    • installer: Package name is Tableau Desktop

    • installer: Upgrading at base path /
    • installer: The upgrade was successful.

Seleccione los controladores que desea instalar automáticamente

De forma predeterminada, con Tableau Desktop se instalan varios controladores de fuente de datos. Para ver la lista completa, consulte Antes de instalar.

Nota: A partir de la versión 2019.4 solo el controlador PostgreSQL se instala automáticamente en el Mac.

Para impedir que se instale automáticamente uno o todos los controladores, ejecute primero la aplicación del instalador para Mac en Desktop.pkg con ‑showChoiceChangesXML para generar un archivo plist que contenga todas las personalizaciones posibles. La sintaxis es la siguiente:

installer -showChoiceChangesXML -pkg <path and name of .pkg file> –target / > <name of plist>

Ejemplo:

installer -showChoiceChangesXML -pkg Install\ Tableau\ Desktop.pkg –target / > InstallTableauDesktopChoices.xml

Para el controlador de Oracle, la sección del archivo plist resultante tiene el aspecto siguiente:

<dict> <key>attributeSetting</key> <integer>1</integer> <key>choiceAttribute</key> <string>selected</string> <key>choiceIdentifier</key> <string>com.tableau.oracle</string> </dict>

Para impedir que se instale un controlador, haga lo siguiente:

  1. En el archivo .plist, cambie el valor de <integer> de 1 a 0 para cualquier controlador que no desee que se instale automáticamente.

  2. Guarde el archivo y, a continuación, páselo al instalador agregándolo a la línea de comandos mediante el comando siguiente:

    -applyChoiceChangesXML <pathToXMLFile>

La línea de comandos completa debería tener un aspecto similar al siguiente una vez creado un archivo plist con los cambios deseados:

sudo installer -pkg Install\ Tableau\ Desktop.pkg -applyChoiceChangesXML InstallTableauDesktopChoices.xml -pkg -target /

Para consultar la documentación de la aplicación del instalador para Mac, consulte la documentación Desarrollador de Apple(El enlace se abre en una ventana nueva).

Deshabilitar el atajo en escritorio

Para evitar que el instalador de Tableau cree un acceso directo en el escritorio para Tableau Desktop, genere el archivo XML como se indica en la sección anterior y cambie el valor del entero de 0 a 1 en la siguiente sección.

<dict> <key>attributeSetting</key> <integer>0</integer> <key>choiceAttribute</key> <string>selected</string> <key>choiceIdentifier</key> <string>com.tableau.desktopShortcut</string> </dict>

Nota: esta opción solo está disponible para Windows.

  1. Ejecute como administrador el archivo .exe del instalador desde la línea de comandos del equipo.

    La sintaxis para ejecutar el instalador de Tableau desde la línea de comandos es la siguiente:

    tableau_<product_installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2

    • tableau_<product_installer_name>.exe: es el instalador de Tableau del producto y la versión que va a instalar.

    • Opciones: las opciones que utiliza especifican cómo debe ejecutarse el proceso de instalación. Por ejemplo, si debe mostrar el resultado durante la instalación o si debe crear archivos de registro. Consulte Opciones del instalador para ver la lista de opciones disponibles.

    • Propiedades: las opciones de propiedades especifican opciones de configuración que debe aplicar el instalador durante el proceso de instalación. Consulte Propiedades del instalador para ver la lista de propiedades disponibles.
  2. Ejecute el comando desde el directorio en el que se encuentra el archivo .exe o bien especifique una ruta completa a la ubicación del archivo .exe en el equipo. No ejecute el programa de instalación desde un directorio compartido de su red. En lugar de ello, descargue el archivo .exe a un directorio del equipo en el que va a efectuar la instalación.

    Ejemplo

    En el siguiente ejemplo se muestra un comando de instalador con algunas opciones y algunas preferencias de propiedades.

    tableauPrepBuilder-64bit-2021-4-4.exe /quiet /norestart ACCEPTEULA=1 CRASHDUMP="0" SENDTELEMETRY="0"

    El comando del ejemplo hace lo siguiente:

    • Instala Tableau Prep Builder 2021.4.4.

    • Ejecuta el instalador en modo silencioso; es decir, en el proceso de instalación no se muestran indicaciones, la IU ni el cuadro de diálogo de la licencia.

    • Configura la instalación para que finalice sin reiniciarse.

    • Acepta el Acuerdo de licencia de usuario final (EULA).

    • Desactiva la generación de informes de errores.

    • Desactiva la generación de informes de uso.

Extraer y ejecutar el instalador de Windows (MSI)

Si usa una herramienta de implementación que requiera el instalador de Windows (archivo .msi) para instalar Tableau Desktop o Tableau Prep Builder, puede extraer el archivo .msi del archivo .exe del instalador de Tableau. Al extraer el archivo .msi, verá el archivo .msi del instalador con los archivos .mside cada controlador de base de datos que se incluye en el proceso de instalación de Tableau Desktop.

Para extraer el archivo .msi puede usar una herramienta de terceros como WiX Toolset.

Exención de responsabilidad: Esta solución incluye información sobre un producto de terceros. Aunque hacemos todo lo posible para garantizar la precisión de las referencias a contenido de terceros, las opciones de WiX Toolset pueden cambiar sin previo aviso. Para obtener la información más actualizada, consulte la documentación de WiX. Si necesita ayuda con las utilidades de WiX, póngase en contacto con la lista de correo de usuarios de WiX.

  1. En el equipo en el que haya descargado el instalador de Tableau, descargue e instale la versión más reciente de WiX Toolset del sitio web de WiX (http://wixtoolset.org/(El enlace se abre en una ventana nueva)).

  2. Abra una ventana de comandos como administrador y navegue hasta el directorio raíz de la carpeta donde instaló WiX Toolset.

  3. Ejecute el comando siguiente:

    Dark.exe <path_to_the_Tableau_exe_installer> -x <output_folder>

    Por ejemplo, ejecute el siguiente comando:

    Dark.exe C:\tableau-setup-std-tableau-2021-1.21.0125.1838-x64.exe -x c:\output

La carpeta de salida contendrá una carpeta denominada AttachedContainerque contiene los archivos .msi .

Activar Tableau Desktop y Tableau Prep Builder

Una vez que se haya instalado Tableau Desktop o Tableau Prep Builder, puede activarlo usando Administración de licencias basadas en inicio de sesión iniciando sesión en Tableau Cloud o Tableau Server. De lo contrario, debe proporcionar una clave de producto para activar el producto, enviando una solicitud de activación a Tableau. Puede introducir una clave de producto desde la línea de comandos durante la instalación (Windows) o después de la instalación (Windows y Mac).

Para automatizar este proceso durante la instalación, añada una sola línea de comandos que incluya la opción del instalador ACTIVATE_KEY "<clave>" y escriba la clave de producto entre comillas. El instalador aplica la clave de producto como parte del proceso de instalación.

Para automatizar este proceso después de la instalación, ejecute Tableau.exe o Tableau Prep Builder.exe después de la instalación con la opción -activate <clave> (por ejemplo, tableau.exe -activate <my_product_key>).

Nota: si desea activar Tableau Server con scripts automatizados, consulte Automatizar las tareas de licencia(El enlace se abre en una ventana nueva) en la ayuda de Tableau Server.

Windows

Ejecute tableau.exe o Tableau Prep Builder.exe con la opción -activate y una clave de producto.

Por ejemplo:

Tableau Desktop: "C:\Program Files\Tableau\Tableau <version>\bin\tableau.exe" -activate <product_key>

Tableau Prep Builder: “C:\Program Files\Tableau\Tableau Prep Builder <version>\Tableau Prep Builder.exe" -activate <product_key>

Mac

Ejecute el ejecutable de Tableau o de Tableau Prep Builder con la opción -activate y una clave de producto en la ruta /Applications.

Por ejemplo:

Tableau Desktop: "Tableau Desktop <version>.app/Contents/MacOS/Tableau" –activate <product_key>

Tableau Prep Builder: "Tableau Prep Builder <vesion>.app/Contents/MacOS./Tableau Prep Builder" –activate <product_key>

Para obtener información sobre los códigos de salida que puede capturar y evaluar si se produce un error en la licencia, consulte Solucionar errores de activación usando códigos de salida de activación en el artículo Solucionar problemas de instalación de esta guía.

Registrar Tableau Desktop y Tableau Prep Builder

Puede garantizar un registro coherente en toda la organización si automatiza la tarea de registrar las copias individuales de Tableau. Si desea automatizar este proceso para Windows, basta con añadir una sola línea de comandos que incluya la opción del instalador REGISTER="1". El instalador ejecuta -register y registra el producto.

Para registrar Tableau desde la línea de comandos, necesita completar de forma previa los valores del Registro (Windows) o de .plist (Mac) en todos los equipos donde se ejecutarán Tableau Desktop y Tableau Prep Builder. En el caso de Windows, puede activar este proceso durante la instalación. En cuanto a Windows y Mac, puede realizar el proceso de instalación y, después, usar la opción de línea de comandos register. Cuando se inicie Tableau, leerá la información de registro y registrará la instancia de Tableau para ese usuario.

La información de registro se almacena en el equipo donde se instala Tableau.

  • Windows: la información se almacena en el Registro.

  • Mac: la información se encuentra en el archivo de lista de propiedades (.plist).

En la información de registro se incluyen campos de ubicación que pueden coincidir para varios usuarios (por ejemplo, city, country, y zip) y campos que suelen ser únicos para cada usuario (email, first_name, last_name, title).

Para Tableau Desktop, debe incluir los campos "opt_in" y "privac_consent" para registrar con éxito el producto al utilizar la opción de línea de comandos.

La información de registro se guarda en una de las ubicaciones siguientes:

  • Windows. Registro: HKEY_CURRENT_USER\Software\Tableau\Registration\Data

  • Mac. Ubicación del archivo .plist: /Users/<user_name>/Library/Preferences/<.plist_file_name>

La forma más sencilla de completar previamente los valores del Registro o de la lista de propiedades en varios equipos es instalar y registrar Tableau de forma manual en un equipo y, a continuación, usar las entradas del Registro o del archivo de lista de propiedades rellenado por ese proceso como una plantilla para actualizar el Registro en otros equipos.

Windows

Registrar Tableau y crear una plantilla

  1. Como administrador del equipo, haga una copia de seguridad del archivo de registro antes de modificarlo.

  2. Instale y registre de forma manual el producto como mínimo en un equipo Windows. Puede usar la información de registro como una plantilla al instalar Tableau en otros equipos.

    La información de registro se guarda en el Registro de Windows en la clave siguiente:

    HKEY_CURRENT_USER\Software\Tableau\Registration\Data

  3. Exporte los datos (la clave) a un archivo de texto del Registro.

  4. Cree un script que:

    1. Realice una copia del archivo de texto del Registro de plantilla y actualice los campos que sean únicos para cada usuario.

    2. Copie el archivo de texto del Registro actualizado en el equipo del usuario.

    3. Actualice el Registro en ese equipo.

    Los campos que actualice dependerán de la información que desee enviar con el registro. Para obtener información sobre cómo automatizar las actualizaciones en el Registro, consulte la documentación de Microsoft.

    A continuación, se muestra un ejemplo de los valores de registro que se pueden ver en el archivo de registro exportado:

    [HKEY_CURRENT_USER\Software\Tableau\Registration\Data]
    "campaign_id"=""
    "company"=""
    "country"=""
    "db_title"=""
    "department"=""
    "elqCustomerGUID"=""
    "elqFormName"=""
    "email"=""
    "first_name"=""
    "form_environment"=""
    "form_variant"=""
    "ga_client_id"=""
    "job_role"=""
    "last_name"=""
    "lead_source"=""
    "lead_source_detail"=""
    "phone"=""
    "product_key"=""
    "product_name"=""
    "state"=""
    "title"=""
    "zip"=""
    "registration_date"=""
    "city"=""
    "industry"=""
    "opt_in"=""
    "privac_consent"=""

Utilizar la plantilla para registrar Tableau en otro equipo

  1. En otro equipo, instale Tableau Desktop o Tableau Prep Builder.

  2. Ejecute tableau.exe o Tableau Prep Builder.exe con la opción -register.

    Por ejemplo:

    Tableau Desktop: "Program Files\Tableau\Tableau <version>\bin\tableau.exe -register"

    Tableau Prep Builder: "Program Files\Tableau\Tableau Prep Builder<version>\Tableau Prep Builder.exe -register"

    Si el registro se completa correctamente, en el archivo de registro de instalación verá la entrada siguiente:

    Current registration state: complete / not needed

    Si el registro no se completa correctamente, Tableau se cerrará con el código de error 117. También puede comprobar el archivo de registro, que contiene información sobre campos no válidos o no encontrados. El archivo de registro se encuentra en esta ubicación:

    Documentos >Mi repositorio de Tableau o Mi Repositorio de Tableau Prep Builder > Registros> log.txt

    Si el registro produce errores, deberá actualizar el script automatizado que creó. Consulte consejos de solución de problemas en Solucionar problemas de instalación de Tableau Desktop o Tableau Prep Builder.

Mac

Registrar Tableau y crear una plantilla

Para registrar Tableau Desktop o Tableau Prep Builder en un equipo Mac, puede usar Xcode o el comando defaults para actualizar el siguiente archivo de lista de propiedades: com.tableau.Registration.plist.

Encontrará más información sobre cómo editar los archivos de lista de propiedades de OS X en el Soporte técnico de Apple.

  1. Instale y registre de forma manual el producto como mínimo en un equipo Mac. Esto creará el archivo .plist, que puede usar como una plantilla para registrar Tableau Desktop o Tableau Prep Builder en otros equipos.

  2. Vaya a /Users/<user_name>/Library/Preferences y haga una copia de seguridad del archivo com.tableau.Registration.plistque desea utilizar como plantilla.

  3. Copie el archivo de plantilla com.tableau.Registration.plist en la carpeta /Users/<user_name</Library/Preferences del equipo Mac en el que desea instalar Tableau Desktop.

  4. Ejecute el comando siguiente:

    cd /Users/<user_name>/Library/Preferences

    Por ejemplo:

    cd /Users/agarcia/Library/Preferences

  5. Por cada clave de .plist que quiera actualizar, ejecute el comando siguiente:

    defaults write com.tableau.Registration.plist <key_value>

    Por ejemplo:

    defaults write com.tableau.Registration.plist Data.first_name Ashley

    defaults write com.tableau.Registration.plist Data.last_name Garcia

Utilizar la plantilla para registrar Tableau en otro equipo

  • En otro equipo, instale Tableau Desktop o Tableau Prep Builder.

    Durante la instalación, se le solicitará una clave de producto; luego, aparecerá el asistente de activación. Si sale del programa antes de completar la activación con el registro (o si ejecuta la instalación en modo silencioso), inicie la aplicación Terminal y, a continuación, ejecute los comandos siguientes:

    • Para activar Tableau Desktop o Tableau Prep Builder, ejecute el comando siguiente:

      Tableau Desktop: "Tableau Desktop <version>.app/Contents/MacOS/Tableau" –activate <product_key>

      Tableau Prep Builder: "Tableau Prep Builder <vesion>.app/Contents/MacOS./Tableau Prep Builder" –activate <product_key>

    • Para registrar Tableau Desktop o Tableau Prep Builder, ejecute el comando siguiente:

      Tableau Desktop: "Tableau Desktop <version>.app/Contents/MacOS./Tableau" –register

      Tableau Prep Builder: "Tableau Prep Builder <vesion>.app/Contents/MacOS./Tableau Prep Builder" –register

Desinstalar Tableau Desktop y Tableau Prep Builder

Aunque al instalar una versión más reciente no es necesario desinstalar versiones anteriores de Tableau Desktop y Tableau Prep Builder, puede desinstalar cualquier versión de estas aplicaciones si ya no las necesita en el equipo.

Windows

Para desinstalar Tableau Desktop o Tableau Prep Builder de forma silenciosa desde la línea de comandos, haga lo siguiente:

  1. Abra el símbolo del sistema como administrador.

  2. En la ubicación en la que se ha instalado el archivo .exe, ejecute el siguiente comando:

    TableauDesktop-<product_installer_name>.exe /uninstall /quiet

    o

    TableauPrepBuilder-<product_installer_name>.exe /uninstall /quiet

    Por ejemplo:

    Downloads\TableauPrepBuilder-2021-1-4.exe /uninstall /quiet

Para desinstalar varias versiones de Tableau Desktop desde la línea de comandos, haga lo siguiente:

Nota: esta opción no está disponible para Tableau Prep Builder.

  1. Instale la última versión de Tableau Desktop con la opción REMOVEINSTALLEDAPP.

    Por ejemplo: tableauDesktop-64bit-2021-4-4.exe /quiet /norestart ACCEPTEULA=1 REMOVEINSTALLEDAPP=1

  2. Confirme que se han desinstalado todas las versiones anteriores excepto la última.

  3. Desinstale la última versión. Por ejemplo: tableauDesktop-64bit-2021-4-4.exe /uninstall /quiet /norestart

  4. Elimine todas las carpetas no utilizadas siguiendo los pasos que aparecen en Eliminación completa de Tableau Desktop(El enlace se abre en una ventana nueva).

Mac

Para desinstalar Tableau Desktop en Mac, haga lo siguiente:

  1. Si se requiere una desactivación o devolución de una clave de producto, ejecute la opción -return en el objeto de Tableau de la ruta de acceso /Applications. Para obtener más información, consulte Mover o desactivar las claves de producto.
  2. Arrastre la aplicación y el acceso directo de Desktop (si lo hubiera) a la carpeta de la papelera de reciclaje y luego vacíela.
  3. Desinstale los controladores que se instalaron automáticamente.
¡Gracias por sus comentarios!Sus comentarios se han enviado correctamente. ¡Gracias!