¿Le ha servido de ayuda esta página?
Sí No

tsm maintenance

Versión: 2019.1

Ahora, Tableau Server en Windows incluye Tableau Services Manager (TSM), que reemplaza a la utilidad de configuración y la herramienta de línea de comandos tabadmin. Si necesita ayuda para una versión anterior de Tableau Server, consulte la página Ayuda de Tableau.

Los comandos de tsm maintenance sirven para gestionar tareas de mantenimiento de servidor como crear archivos de respaldo periódicamente o restaurar Tableau Server a partir de un archivo de respaldo creado previamente.

tsm maintenance backup

Crea un respaldo de los datos administrados por Tableau Server. Estos datos incluyen la base de datos PostgreSQL de Tableau (el repositorio), que contiene metadatos de libros de trabajo y de usuarios, archivos de extracción (.tde o .hyper) y datos de configuración de servidor. Consulte Realizar una copia de seguridad y restauración completa de Tableau Server.

Sinopsis

tsm maintenance backup --file <backup_file> [options] [global options].

Opciones

-d, --append-date

Opcional.

Anexa la fecha actual al nombre del archivo de respaldo.

-f, --file <archivo_respaldo>

Requerido.

Escribe el respaldo en el archivo especificado. Se utiliza automáticamente una extensión de .tsbak. El archivo se escribe en el directorio definido en la variable de TSM basefilepath.backuprestore. El directorio predeterminado es:

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

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

-i, --description <string>

Opcional.

Incluye la descripción especificada del archivo de respaldo.

--skip-compression

Opcional.

Crea una copia de seguridad sin comprimir. Esta operación da como resultado un archivo de copia de seguridad de mayor tamaño, pero reduce el tiempo necesario para realizar la copia de seguridad. Si usa esta opción en una instalación distribuida, se recomienda encarecidamente tener configurada una instancia del Almacén de archivos en el nodo inicial.

-k, --skip-verification

Opcional.

No se comprueba la integridad del archivo de respaldo de la base de datos.

--override-disk-space-check

Opcional.

Intenta crear una copia de seguridad incluso cuando existe una advertencia de espacio en disco reducido.

-po, --pg-only

Opcional.

Genera únicamente la copia de seguridad del repositorio.

--request-timeout <timeout in seconds>

Opcional.

Espera el tiempo especificado a que el comando finalice. El valor predeterminado es 1800 (30 minutos).

Ejemplos

Con este ejemplo se crea una copia de seguridad llamada ts_backup-<yyyy-mm-dd>.tsbak en la carpeta <install dir>\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\:

tsm maintenance backup -f ts_backup -d.

tsm maintenance cleanup

Elimina los archivos de registro antiguos y los archivos temporales.

Si ejecuta Tableau Server en una implementación distribuida, ejecute este comando en el nodo que ejecute el proceso Controlador de administración (también denominado Controlador de TSM). De forma predeterminada, el controlador se encuentra en el nodo inicial del clúster.

La utilidad de este comando consiste en crear espacio libre en la implementación de Tableau eliminando archivos antiguos. Por lo tanto, si este comando se ejecuta cuando el servidor se inicia, se eliminará casi todo el contenido antiguo en este caso. De modo que, para eliminar archivos de registro actuales, debe detener el servidor antes de ejecutar este comando.

Nota: este comando se añadió en la versión 10.5.1 de Tableau Server y algunas opciones se añadieron en la versión 2018.1.

Sinopsis

tsm maintenance cleanup [options] [global options]

Opciones

-a, --all

Opcional.

Realice todas las operaciones de cleanup con los valores de retención predeterminados. Equivale a ejecutar el comando cleanup con las opciones siguientes: -l -t -r -q.

--http-requests-table-retention <n.º de días>

Opcional.

Elimina de la tabla las entradas http_requests que sean más antiguas. (Valor predeterminado: 7 días)

-l, --log-files

Opcional.

Elimine los archivos de registro que tienen más de retention-period. Se eliminarán los archivos de los subdirectores en data\tabsvc\logs.

--log-files-retention <n.º de días>

Opcional.

Valor predeterminado: 1 (24 horas)

Elimina los registros cuya antigüedad supere el número de días especificado. Este comando no se aplica a los archivos temporales.

-q, --http-requests-table

Opcional.

Elimina de la tabla las entradas http_requests antiguas.

-r, --redis-cache

Opcional.

Borra la memoria caché de Redis.

--request-timeout <timeout in seconds>

Opcional.

Espera el tiempo especificado a que el comando finalice. El valor predeterminado es 1800 (30 minutos).

-t, --temp-files

Opcional.

Elimina todos los archivos y subdirectorios en los siguientes directorios:

  • <install dir>\ProgramData\Tableau\Tableau Server\data\tabsvc\temp: solo se eliminan los directorios que almacenen archivos de sesiones caducadas (es decir, que no estén en ejecución).

  • <install dir>\ProgramData\Tableau\Tableau Server\data\tabsvc\httpd\temp

  • <install dir>\ProgramData\Tableau\Tableau Server\temp

-v, --verbose

Opcional.

Muestra los detalles de lo que se ha borrado.

Ejemplos

Este ejemplo limpia todos los archivos de registro con una antigüedad de más de 2 días:

tsm maintenance cleanup -l --log-files-retention 2

tsm maintenance reindex-search

Utilice el comando reindex-search para volver a construir el índice de búsqueda.

Sinopsis

tsm maintenance reindex-search [global options].

Opción

--request-timeout <timeout in seconds>

Opcional.

Espera el tiempo especificado a que el comando finalice. El valor predeterminado es 1800 (30 minutos).

tsm maintenance restore

Restaura Tableau Server usando el archivo de respaldo especificado. Consulte Realizar una copia de seguridad y restauración completa de Tableau Server.

Solo puede efectuar una restauración de copias de seguridad que tengan el mismo tipo de almacén de identidades que el servidor en ejecución. Por ejemplo, las copias de seguridad de un servidor mediante la autenticación local se pueden restaurar en un Tableau Server inicializado con la autenticación local, pero las copias de seguridad de un servidor mediante la autenticación con Active Directory no se pueden restaurar en un servidor inicializado con la autenticación local.

Sinopsis

tsm maintenance restore --file <file_name> [--restart-server] [global options].

Opciones

-f, --file <nombre_archivo>

Requerido.

Especifica el archivo de respaldo desde el que se va a restaurar.

El comando restore espera un archivo de respaldo en el directorio definido en la variable de TSM basefilepath.backuprestore. El directorio predeterminado es:

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

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

-r, --restart-server

Opcional.

Reinicia el servidor tras la restauración.

--request-timeout <timeout in seconds>

Opcional.

Espera el tiempo especificado a que el comando finalice. El valor predeterminado es 1800 (30 minutos).

--request-timeout <timeout in seconds>

Opcional.

Espera el tiempo especificado a que el comando finalice. El valor predeterminado es 1800 (30 minutos).

tsm maintenance send-logs

Carga el archivo especificado en Tableau y lo asocia con una incidencia de soporte.

Sinopsis

tsm maintenance send-logs --case <case_number> --email <contact_email> --file <path/to/file> [global options]

Opciones

-c,--case <número_caso>

Requerido.

Número del caso de soporte.

-e,--email <correo_contacto>

Requerido.

Correo electrónico de contacto.

-f, --file <ruta/al/archivo>

Requerido.

Especifica la ubicación y el nombre del archivo de registro que se enviará.

--request-timeout <timeout in seconds>

Opcional.

Espera el tiempo especificado a que el comando finalice. El valor predeterminado es 1800 (30 minutos).

tsm maintenance validate-resources

Valida los libros de trabajo y las fuentes de datos de un sitio.

Sinopsis

tsm maintenance validate-resources --site-id <site ID> [global options]

Opciones

-id,--site-id <site ID>

Requerido.

Identificador del sitio cuyos recursos se están validando.

-r,--repair

Opcional.

Reparar recursos no válidos.

--request-timeout <timeout in seconds>

Opcional.

Espera el tiempo especificado a que el comando finalice. El valor predeterminado es 1800 (30 minutos).

 

tsm maintenance ziplogs

El comando ziplogs sirve para crear un archivo de archivos de registro de Tableau Server.

Sinopsis

tsm maintenance ziplogs [options] [global options].

Opciones

-a, --all

Opcional.

Incluye todos los archivos, salvo los datos de PostgreSQL.

-d, --with-postgresql-data

Opcional.

Incluye la carpeta de datos de PostgreSQL si Tableau Server se detiene o los archivos de volcado de PostgreSQL si Tableau Server se está ejecutando.

--description <cadena>

Opcional.

Incluye la descripción especificada del archivo.

-f, --file <nombre>

Opcional.

Especifica un nombre para el archivo comprimido. Si no se proporciona ningún nombre, el archivo se crea como logs.zip. El archivo se escribe en el directorio definido en la variable de TSM basefilepath.log_archive. El directorio predeterminado es:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives\

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

-i, --with-msinfo

Opcional.

Incluye el informe de msinfo32, con información del sistema sobre el sistema operativo, el hardware y el software en ejecución.

-l, --with-latest-dump

Opcional.

Incluye los últimos archivos de volcado.

-m, --minimumdate <fecha>

Opcional.

Fecha más temprana de los archivos de registro que se van a incluir. Si no se especifica, se incluye un máximo de dos días de archivos de registro. El formato de fecha debe ser "mm/dd/yyyy".

-o, --overwrite

Opcional.

Sirve para sobrescribir un archivo zip de registros. Si ya existe un archivo con el mismo nombre y esta opción no se utiliza, el comando ziplogs generará un error.

El archivo se escribe de forma predeterminada en:

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives\

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

--request-timeout <timeout in seconds>

Opcional.

Espera el tiempo especificado a que el comando finalice. El valor predeterminado es 1800 (30 minutos).

-t, --with-netstat-info

Opcional.

Incluye información de netstat.

 

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 tiene espacios o caracteres especiales, escríbala entre comillas:

--password "my password"

-s, --server <server address>

Opcional.

Utiliza la dirección especificada para Tableau Services Manager. Si no se especifica ningún servidor, se da por hecho que es https://<localhost | dnsname>:8850.

--trust-admin-controller-cert

Opcional.

Use esta opción para confiar en el certificado autofirmado del controlador de TSM. Para obtener más información sobre la confianza de certificados y la conexiones de la interfaz de línea de comandos, 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.

 

Volver al principio