Ayuda de Tableau Server en Windows

Puede utilizar los comandos tsm sites para exportar un sitio existente a fin de importarlo a un sitio nuevo (proceso denominado "migración de sitio") y para importar el sitio nuevo. Tiene a su disposición un comando unlock por si algún error hace que el sitio se quede bloqueado.

Los comandos tsm sites usan el almacén de archivos local para albergar los datos de exportación e importación. Si ejecuta un clúster de Tableau de varios nodos, debe ejecutar los comandos tsm sites en un Tableau Server que ejecute el proceso de motor de datos. Si desea información sobre el proceso de motor de datos y los procesos que lo necesitan, consulte Procesos de Tableau Server.

Nota: Al migrar sitios entre instancias de Tableau Server, el sitio de destino debe estar en una versión de Tableau Server que sea igual o posterior a la versión de Tableau Server del sitio de origen. Tanto el sitio de origen como el de destino deben contar con versiones compatibles de Tableau Server.

Para ver todos los pasos necesarios para migrar un sitio, consulte Exportar o importar un sitio.

tsm sites export

Exporta un sitio de Tableau Server concreto a un archivo .zip. Puede exportar un sitio para archivar su configuración en un momento dado o bien para llevar a cabo el primer paso del proceso de migración de un sitio.

Nota: Los comandos tsm sites import y tsm sites export pueden dejar un sitio en el estado bloqueado si se produce un error. Para desbloquear un sitio, use el comando tsm sites unlock.

Sinopsis

tsm sites export --site-id <source-siteID> --file <export-file> [options] [global options].

Opciones

-f,--file <export-file>

Requerido.

Especifica el nombre del archivo en el que Tableau Server guarda toda la información del sitio.

Este archivo se genera en el directorio definido en la variable basefilepath.site_export.exports de TSM. El directorio predeterminado es:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports

Para obtener más información sobre las rutas de archivo y cómo cambiarlas, consulte tsm File Paths.

-id,--site-id <source-siteID>

Requerido.

ID del sitio que se está exportando. El identificador de sitio se puede obtener de la URL al iniciar sesión en el sitio desde un navegador web. Para obtener información sobre cómo localizar el identificador del sitio, consulte Preparar los sitios de origen y de destino.

-ow,--overwrite

Opcional.

Sobrescribe un archivo de exportación con el mismo nombre que ya existe.

--request-timeout <timeout in seconds>

Opcional.

Espere el tiempo especificado a que el comando finalice. El valor predeterminado es 43200 (720 minutos).

tsm sites import

Este comando utiliza el archivo .zip que ha creado mediante tsm sites export para generar un conjunto de archivos .csv en los que se muestra cómo se asignará la configuración del sitio fuente exportado al nuevo sitio de destino.

De forma predeterminada, el archivo .zip se genera y se guarda en el directorio siteexports en:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports

Antes de utilizar este comando, debe copiar el archivo .zip en el directorio en el que Tableau prevé encontrarlo. Esta ubicación se define en la variable basefilepath.site_import.exports de TSM. De forma predeterminada, el directorio de importación es el siguiente:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports

Para obtener más información sobre las rutas de archivo y cómo cambiarlas, consulte tsm File Paths.

Nota: Los comandos tsm sites import y tsm sites export pueden dejar un sitio en el estado bloqueado si se produce un error. Para desbloquear un sitio, use el comando tsm sites unlock.

Sinopsis

tsm sites import --file <export-file.zip> --site-id <target-siteID> [options] [global options].

Opciones

-f,--file <export-file.zip>

Requerido.

Nombre del archivo .zip creado por el proceso tsm sites export, que debe copiar en el directorio de importación. El directorio predeterminado es:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports

-id,--site-id <target-siteID>

Requerido.

ID del sitio nuevo al que importa (el sitio de destino). Para obtener información sobre cómo localizar el identificador del sitio, consulte Preparar los sitios de origen y de destino.

-c,--continue-on-ignorable-errors

Opcional.

Continúa la importación del sitio si se producen errores que pueden omitirse. Estos errores pueden indicar problemas con la importación de un libro de trabajo o una fuente de datos específicos.

-k,--no-verify

Opcional.

Omite la comprobación de los archivos de mapeo.

-m, --override-schedule-mapper <mapping-file.csv>

Opcional.

Archivo de asignación de programas para anular la asignación normal por nombre.

--request-timeout <timeout in seconds>

Opcional.

Espere el tiempo especificado a que el comando finalice. El valor predeterminado es 7200 (120 minutos).

tsm sites import-verified

Especifica el directorio que contiene los archivos de mapeo .csv de un sitio exportado para importarlos a un sitio nuevo. Este es el último paso del proceso de migración de un sitio.

Sinopsis

tsm sites import-verified --import-job-dir <importjob-directory> --site-id <target-siteID> [options] [global options].

Opciones

-id,--site-id <target-siteID>

Requerido.

ID del sitio nuevo al que importa (el sitio de destino). Para obtener información sobre cómo localizar el identificador del sitio, consulte Preparar los sitios de origen y de destino.

-w, --import-job-dir <importjob-directory>

Requerido.

Directorio principal del directorio mappings que contiene los archivos .csv del sitio (de origen) exportado. El nombre de este directorio principal incluye el ID de importación, así como la fecha y hora. Por ejemplo:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\working\import_ff00_20180102022014457

--request-timeout <timeout in seconds>

Opcional.

Espere el tiempo especificado a que el comando finalice. El valor predeterminado es 7200 (120 minutos).

tsm sites unlock

Use este comando para desbloquear un sitio.

Opciones

-id,--site-id <target-siteID>

Requerido.

ID del sitio que se está desbloqueando. Para obtener información sobre cómo localizar el identificador del sitio, consulte Preparar los sitios de origen y de destino.

-d, --desired-state <estado en el que dejar el sitio desbloqueado>

Opcional.

El estado en el que el sitio se debe dejar tras desbloquearlo. Las opciones son "active" (activo) y "suspended" (suspendido). El valor predeterminado es "active", si no se especifica lo contrario.

Por ejemplo:

tsm sites unlock -id mysite -d suspended.

--request-timeout <timeout in seconds>

Opcional.

Espere el tiempo especificado a que el comando finalice. El valor predeterminado es 300 (5 minutos).

Opciones globales

-h, --help

Opcional.

Muestra la ayuda relativa al comando.

-p, --password <password>

Obligatoria junto con -u o --username si no hay ninguna sesión activa.

Indica la contraseña del usuario especificado en -u o --username.

Si la contraseña incluye espacios o caracteres especiales, escríbala entre comillas:

--password "my password"

-s, --server https://<hostname>:8850

Opcional.

Utiliza la dirección especificada para Tableau Services Manager. La dirección URL debe comenzar con https, incluir el puerto 8850 y usar el nombre del servidor en lugar de la dirección IP. Por ejemplo: https://<tsm_hostname>:8850. Si no se especifica ningún servidor, se da por hecho que es https://<localhost | dnsname>:8850.

--trust-admin-controller-cert

Opcional.

Use esta marca para confiar en el certificado autofirmado en el controlador SM. Para obtener más información acerca de la confianza de certificados y las conexiones CLI, consulte Conectar clientes de TSM.

-u, --username <user>

Obligatoria si no hay ninguna sesión activa, junto con -p o --password.

Indica una cuenta de usuario. Si no se incluye esta opción, el comando se ejecuta con las credenciales con las que se haya iniciado sesión.