tsm File Paths
Algunos comandos tsm leen archivos de ubicaciones predeterminadas o los escriben en ellas. Estas ubicaciones predeterminadas están determinadas por claves de configuración basefilepath definidas por cada comando. Puede utilizar tsm para ver el valor actual de las claves y para cambiar las ubicaciones.
Cuenta del sistema NetworkService
En algunas organizaciones, se implementan políticas de seguridad que restringen el acceso a archivos desde las cuentas del sistema, como la cuenta NetworkService. Si cambia las rutas de archivo de tsm, deberá comprobar que la cuenta del sistema NetworkService tiene permiso total (con la herencia de permisos habilitada) en las rutas finales. Además, si cambia la ruta de un archivo que estaba originalmente en la ruta *\data\tabsvc\*, debe mantener los permisos de NetworkService en la ruta original. Este permiso se debe conservar porque la cuenta del sistema NetworkService administra operaciones del controlador de administración de Tableau Server, el servicio de archivos de cliente de Tableau Server y el servicio de coordinación de Tableau Server.
Permisos para la ubicación del archivo de copia de seguridad/restauración
Permisos necesarios para la ubicación del archivo de copia de seguridad/restauración:
- NetworkService: permiso de lectura/escritura/ejecución
- Cuenta de servicio Ejecutar como: permiso de lectura/escritura/ejecución
Ubicaciones predeterminadas de los archivos
Durante los procesos tsm maintenance backup, restore, , ziplogs y los procesos tsm sites export y sites import , Tableau Server utiliza las ubicaciones predeterminadas para los archivos que estos comandos crean o usan.
Para obtener más información sobre los requisitos de espacio en disco para realizar una copia de seguridad de Tableau Server, consulte Uso de espacio en disco para copias de seguridad.
El directorio predeterminado es:
Comandos de mantenimiento de tsm:
Copia de seguridad: el archivo de copia de seguridad
.tsbakse crea en una ubicación temporal en el directorio de datos en el nodo inicial y luego se guarda en:<install drive>:<install\path>\data\tabsvc\files\backupsDe forma predeterminada, es esta:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\Pero si instaló Tableau en una ubicación distinta de la predeterminada, la ruta será otra. Por ejemplo, si lo instaló en
D:\Tableau Server, la copia de seguridad se guardará en:D:\Tableau Server\data\tabsvc\files\backupsNota: el comando tsm maintenance backup no admite rutas de archivo de Microsoft Windows UNC (Universal Naming Convention), también llamadas "rutas de red" (\\<nombre del equipo>\<carpeta>\<nombre del archivo>) como la ruta a la ubicación donde se escriben los archivos de copia de seguridad. En su lugar, use rutas de sistema de archivos locales (<letra de unidad>:\<nombre de carpeta\<nombre de archivo>).
backup: ubicación temporal de estadificación. El archivo de copia de seguridad
.tsbakse crea en una ubicación temporal en el directorio de datos en el nodo inicial.A partir de la versión 2026.2.0, puede especificar una ubicación temporal alternativa para la creación del archivo de copia de seguridad. Esto puede ser útil si el archivo de copia de seguridad es grande o si tiene espacio limitado en el nodo inicial. Para obtener más información, consulte backuprestore.use_custom_staging_dir.enabled.
restore—El proceso de restauración restaura un archivo de respaldo desde:
<install drive>:<install\path>\data\tabsvc\files\backupsDe forma predeterminada, es esta:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\Pero si instaló Tableau en una ubicación distinta de la predeterminada, la ruta será otra. Por ejemplo, si lo instaló en
D:\Tableau Server, el proceso de restauración usará la copia de seguridad de la siguiente ubicación:D:\Tableau Server\data\tabsvc\files\backupsziplogs—El archivo ziplogs se genera en:
<install drive>:<install\path>\data\tabsvc\files\log-archivesDe forma predeterminada, es esta:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archivesPero si instaló Tableau en una ubicación distinta de la predeterminada, la ruta será otra. Por ejemplo, si lo instaló en
D:\Tableau Server, el archivo ziplogs se genera en:D:\Tableau Server\data\tabsvc\files\log-archives
tsm sites
export—El archivo de exportación .zip se genera en el siguiente directorio:
<install drive>:<install\path>\data\tabsvc\files\siteexportsDe forma predeterminada, es esta:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexportsPero si instaló Tableau en una ubicación distinta de la predeterminada, la ruta será otra. Por ejemplo, si lo instaló en
D:\Tableau Server, el archivo .zip de exportación se genera en:D:\Tableau Server\data\tabsvc\files\siteexportsimport—Durante el proceso de importación, Tableau Server busca archivos en:
<install drive>:<install\path>\data\tabsvc\files\siteimportsDe forma predeterminada, es el siguiente:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimportsPero si instaló Tableau en una ubicación distinta de la predeterminada, la ruta será otra. Por ejemplo, si lo instaló en
D:\Tableau Server, el proceso de importación busca los archivos aquí:D:\Tableau Server\data\tabsvc\files\siteimports
Obtener la ubicación del archivo actual
Puede ver la ubicación del archivo actual de un comando específico con tsm configuration get:
Para los comandos de mantenimiento de tsm:
backup and restore:
tsm configuration get -k basefilepath.backuprestore.ziplogs:
tsm configuration get -k basefilepath.log_archive
Para los comandos de sitios de tsm:
export
tsm configuration get -k basefilepath.site_export.exports.import
tsm configuration get -k basefilepath.site_import.exports.
Cambiar las ubicaciones actuales de basefilepath
Puede cambiar algunas de las ubicaciones usadas por TSM para las acciones con archivos usando el comando tsm configuration set para actualizar las variables basefilepath. Para obtener más información sobre rutas de archivo base específicas, consulte Opciones de tsm configuration set.
Cambiar una variable basefilepathno mueve los archivos existentes del directorio original al nuevo. Si desea que un respaldo, restauración, archivo de registro o exportación de sitio o archivo de importación existente resida en el nuevo directorio que especifique, debe moverlo manualmente. Usted es el responsable de crear la nueva ubicación y de establecer los permisos correctos para permitir el acceso de tsm a los archivos que se coloquen ahí y a la estructura de directorio que contiene esos archivos. Si cambia la ruta del archivo base de copia de seguridad/restauración, debe ejecutar el comando tsm maintenance validate-backup-basefilepath (disponible en la versión 2022.1 y posteriores) para comprobar que los permisos estén configurados correctamente.
El comando tsm maintenance backup utiliza una ubicación de preparación temporal en el directorio de datos para acciones de archivo (ensamblaje, extracción) antes de guardar el archivo de copia de seguridad en la ubicación especificada por la variable basefilepath.backuprestore . A partir de la versión 2026.2.0, si configura TSM para usar la ubicación especificada por basefilepath.backuprestore y la copia de seguridad se ensambla en subdirectorios temporales en la ubicación especificada por basefilepath.backuprestore. Para versiones anteriores a la 2026.2.0, cambiar la ruta de archivo base no afecta a la ubicación en la que el comando tsm maintenance backup crea el archivo de copia de seguridad.
No puede especificar una ubicación de basefilepath.backuprestore en el directorio raíz de una unidad. Debe estar en una carpeta.
Para los comandos de mantenimiento de tsm:
backupandrestorePara cambiar el directorio utilizado por los comandos
backupyrestore, ejecute el comando siguiente:tsm configuration set -k basefilepath.backuprestore -v "<drive>:\new\directory\path"Ubicación de ensayo de
backupNota: La capacidad de cambiar la ubicación de ensayo está disponible a partir de la versión 2026.2.0.
Para cambiar la ubicación de ensayo temporal utilizada por
backupa los subdirectorios de la ubicaciónbasefilepath.backuprestore, ejecute el siguiente comando:tsm configuration set -k backuprestore.use_custom_staging_dir.enabled -v trueCuando se establece en
true, el comandobackuputiliza directorios temporales debajo de la ubicación especificada por el valorbasefilepath.backuprestore.Para cambiar el directorio de ziplogs:
tsm configuration set -k basefilepath.log_archive -v "<drive>:\new\directory\path"
Para los comandos de sitios de tsm:
Para cambiar el directorio de exportación de sitios:
tsm configuration set -k basefilepath.site_export.exports -v "<drive>:\new\directory\path"Para cambiar el directorio de importación de sitios:
tsm configuration set -k basefilepath.site_import.exports -v "<drive>:\new\directory\path"
Cuando haya cambiado una ubicación de archivo predeterminada, deberá hacer lo siguiente:
Aplique los cambios pendientes:
tsm pending-changes applySi los cambios pendientes requieren un reinicio del servidor, el comando
pending-changes applymostrará un mensaje para informarle de que se producirá un reinicio. Este mensaje aparece aunque el servidor esté detenido, pero en ese caso no se reiniciará. Puede suprimir el mensaje con la opción--ignore-prompt, pero no se modificará el comportamiento de reinicio. Si los cambios no requieren un reinicio, se aplicarán sin ningún mensaje. Para obtener más información, consulte tsm pending-changes apply.Detenga Tableau Server:
tsm stopReinicie el controlador de TSM :
net stop tabadmincontroller_0net start tabadmincontroller_0Espere varios minutos a que el controlador se reinicie. Puede confirmar si se ha reiniciado con este comando:
tsm status -vSi, al ejecutar el comando, el controlador de administración de Tableau Server aparece como "ejecutando", significa que el controlador se ha reiniciado.
Inicie Tableau Server:
tsm start
