tsm maintenance
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. 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.
Puede utilizar una copia de seguridad de Tableau Server en Linux para restaurar Tableau Server en Linux, pero no puede utilizarla para restaurar Tableau Server en Windows.
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 endata\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 TSMbasefilepath.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, 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.