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:

  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!