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

      • backup: ubicación temporal de estadificación. El archivo de copia de seguridad .tsbak se 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\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

    • 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 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:

    • backup and restore

      Para cambiar el directorio utilizado por los comandos backup y restore , ejecute el comando siguiente:

      tsm configuration set -k basefilepath.backuprestore -v "<drive>:\new\directory\path"

    • Ubicación de ensayo de backup

      Nota: 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 backup a los subdirectorios de la ubicación basefilepath.backuprestore, ejecute el siguiente comando:

      tsm configuration set -k backuprestore.use_custom_staging_dir.enabled -v true

      Cuando se establece en true, el comando backup utiliza directorios temporales debajo de la ubicación especificada por el valor basefilepath.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:

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

  2. Detenga Tableau Server:

    tsm stop

  3. Reinicie el controlador de TSM :

    net stop tabadmincontroller_0

    net start tabadmincontroller_0

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

  5. Inicie Tableau Server:

    tsm start

 

¡Gracias por sus comentarios!Sus comentarios se han enviado correctamente. ¡Gracias!