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.

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:

      /var/opt/tableau/tableau_server/data/tabsvc/files/backups/

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

      /var/opt/tableau/tableau_server/data/tabsvc/files/backups/

    • ziplogs—El archivo ziplogs se genera en:

      /var/opt/tableau/tableau_server/data/tabsvc/files/log-archives.

  • tsm sites

    • export—El archivo de exportación .zip se genera en el siguiente directorio:

      /var/opt/tableau/tableau_server/data/tabsvc/files/siteexports.

    • import—Durante el proceso de importación, Tableau Server busca archivos en:

      /var/opt/tableau/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. Para obtener más información sobre los permisos y tsm, consulte Archivos y permisos en TSM. 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.

  • 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 "/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 "/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 "/new/directory/path".

    • Para cambiar el directorio de importación de sitios:

      tsm configuration set -k basefilepath.site_import.exports -v "/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 (con la cuenta del sistema tableau):

    sudo su -l tableau -c "systemctl --user restart tabadmincontroller_0.service"

  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!