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
, send-logs
, 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
.tsbak
se 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\backups
De 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\backups
Nota: 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>).
restore—El proceso de restauración restaura un archivo de respaldo desde:
<install drive>:<install\path>\data\tabsvc\files\backups
De 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\backups
send-logs—El proceso send-logs envía el archivo de registros desde:
<install drive>:<install\path>\data\tabsvc\files\backups
De 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 envío de registros enviará los archivos de registro desde aquí:D:\Tableau Server\data\tabsvc\files\backups
ziplogs—El archivo ziplogs se genera en:
<install drive>:<install\path>\data\tabsvc\files\log-archives
De forma predeterminada, es esta:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives
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 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\siteexports
De forma predeterminada, es esta:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports
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 archivo .zip de exportación se genera en:D:\Tableau Server\data\tabsvc\files\siteexports
import—Durante el proceso de importación, Tableau Server busca archivos en:
<install drive>:<install\path>\data\tabsvc\files\siteimports
De forma predeterminada, es el siguiente:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports
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 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, restore y send-logs:
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 la ubicación del archivo actual
Puede cambiar las ubicaciones de archivo previstas 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 basefilepath
no 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
crea la copia de seguridad en una ubicación temporal en el directorio de datos antes de guardar el archivo de copia de seguridad en la ubicación especificada por la variable basefilepath.backuprestore
. 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:
Para cambiar los directorios de respaldo, restauración y envío de registros, ejecute el comando siguiente:
tsm configuration set -k basefilepath.backuprestore -v "<drive>:\new\directory\path"
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 apply
Si los cambios pendientes requieren un reinicio del servidor, el comando
pending-changes apply
mostrará 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 stop
Reinicie el controlador de TSM :
net stop tabadmincontroller_0
net start tabadmincontroller_0
Espere varios minutos a que el controlador se reinicie. Puede confirmar si se ha reiniciado con este comando:
tsm status -v
Si, 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