tsm maintenance

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 libros de trabajo y metadatos del usuario y archivos de extracción (.tde o .hyper). Estos datos no incluyen datos de configuración. 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. Al restaurar un archivo de copia de seguridad, no se restauran los datos de configuración. 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

-ak, --asset-key-file <file_name>

Opcional. Especifique esta opción solo si va a restaurar a partir de los activos creados por tabadmin en Tableau Server (versiones 2018.1 y anteriores).

Nombre del archivo de clave de activo desde el que se va a restaurar. El archivo de clave de activo se crea mediante el comando tabadmin assetkeys. El archivo debe encontrarse en la ubicación de copia de seguridad/restauración predefinida en el servidor.

-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.

-k, --skip-identity-store-verification

Opcional. Especifique esta opción solo si va a restaurar a partir de un archivo de copia de seguridad creado por tabadmin en Tableau Server (versiones 2018.1 y anteriores).

Omita la verificación del almacén de identidades. Especifique esta opción si va a restaurar un archivo de copia de seguridad creado con el comando tabadmin backup --no-config.

-po, --pg-only

Opcional.

Restaura solo el repositorio.

-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).

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, --description <string>

Opcional.

Incluye la descripción especificada del archivo.

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

--password "my password"

-s, --server <url_to_tsm>

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://mytableauhost: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.

 

Gracias por sus comentarios. Se ha producido un error al enviar sus comentarios. Inténtelo de nuevo o envíenos un mensaje.