Ajuda do Tableau Server no Windows

Permissões para o local do arquivo de backup/restauração

Localização padrão dos arquivos

Durante os processos tsm maintenance backup, restore, send-logs e ziplogs e os processos tsm sites export e sites import , o Tableau Server usa os locais padrão dos arquivos criados ou usados por esses comandos.

Para obter detalhes sobre os requisitos de espaço em disco para fazer backup do Tableau Server, consulte Uso do espaço em disco para backup.

Como padrão:

• Comandos de manutenção de tsm:

  • backup — O arquivo de backup .tsbak é criado em um local temporário no diretório de dados do nó inicial e, em seguida, salvo em:

    <install drive>:<install\path>\data\tabsvc\files\backups

    Por padrão, ele é:

    C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\

    Mas isso será diferente se tiver instalado o Tableau em uma localização não padrão. Por exemplo, se tiver instalado no D:\Tableau Server o backup será salvo em:

    D:\Tableau Server\data\tabsvc\files\backups

    Observação: o comando de backup de manutenção do tsm não suporta os caminhos UNC (convenção de nomenclatura universal) de arquivo do Microsoft Windows, também conhecidos como "caminhos de rede" (\\<nome do computador>\<pasta>\<nome do arquivo>), como o caminho para o local onde os arquivos de backup estão gravados. Em vez disso, use caminhos de sistema do arquivo local (<drive letter>:\<folder name\<file name>).

  • restore—O processo de restauração restaura um arquivo de backup de:

    <install drive>:<install\path>\data\tabsvc\files\backups

    Por padrão, ele é:

    C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\

    Mas isso será diferente se tiver instalado o Tableau em uma localização não padrão. Por exemplo, se tiver instalado no D:\Tableau Server o processo de restauração usará um backup em:

    D:\Tableau Server\data\tabsvc\files\backups

  • send-logs—O processo de envio de logs envia os arquivos de:

    <install drive>:<install\path>\data\tabsvc\files\backups

    Por padrão, ele é:

    C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\

    Mas isso será diferente se tiver instalado o Tableau em uma localização não padrão. Por exemplo, se tiver instalado no D:\Tableau Server o processo de envio enviará arquivos de registro de:

    D:\Tableau Server\data\tabsvc\files\backups

  • ziplogs—O arquivo ziplogs é gerado em:

    <install drive>:<install\path>\data\tabsvc\files\log-archives

    Por padrão, ele é:

    C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives

    Mas isso será diferente se tiver instalado o Tableau em uma localização não padrão. Por exemplo, se tiver instalado no D:\Tableau Server o arquivo de ziplogs será gerado em:

    D:\Tableau Server\data\tabsvc\files\log-archives

• tsm sites

  • export—O arquivo .zip de exportação é gerado no seguinte diretório:

    <install drive>:<install\path>\data\tabsvc\files\siteexports

    Por padrão, ele é:

    C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports

    Mas isso será diferente se tiver instalado o Tableau em uma localização não padrão. Por exemplo, se tiver instalado no D:\Tableau Server o arquivo de exportação .zip será gerado em:

    D:\Tableau Server\data\tabsvc\files\siteexports

  • import—Durante o processo de importação, o Tableau Server busca os arquivos em:

    <install drive>:<install\path>\data\tabsvc\files\siteimports

    Por padrão, ele é:

    C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports

    Mas isso será diferente se tiver instalado o Tableau em uma localização não padrão. Por exemplo, se tiver instalado no D:\Tableau Server o processo de importação procurará arquivos em:

    D:\Tableau Server\data\tabsvc\files\siteimports

Obter o local atual do arquivo

Para ver o local atual do arquivo de um comando específico com tsm configuration get:

• Para comandos de manutenção de tsm:

  • backup, restore e send-logs:

    tsm configuration get -k basefilepath.backuprestore

  • ziplogs:

    tsm configuration get -k basefilepath.log_archive

• Para comandos de sites tsm:

  • export

    tsm configuration get -k basefilepath.site_export.exports

  • import

    tsm configuration get -k basefilepath.site_import.exports

Alterar o local atual do arquivo

É possível alterar os locais de arquivos esperados usando o comando tsm configuration set para atualizar as variáveis basefilepath. Para obter detalhes sobre caminhos específicos de arquivo base, consulte Opções do tsm configuration set.

A alteração da variável basefilepath não move os arquivos existentes do diretório original para o novo. Para que os arquivos de backup, restauração e log, ou os arquivos de exportação e importação de site residam no novo diretório especificado, é necessário movê-los manualmente. Você é responsável por criar o novo local e por definir as permissões corretas para permitir o acesso ao tsm a qualquer arquivo que será colocado aqui e à estrutura de diretório contendo esses arquivos. Se você alterar o caminho do arquivo base de backup/restauração, deverá executar o comando tsm maintenance validate-backup-basefilepath (disponível na versão 2022.1 e posterior) para verificar se as permissões estão configuradas corretamente.

O comando tsm maintenance backup reúne o backup em um local temporário no diretório de dados antes de salvar o arquivo de backup no local especificado pela variável basefilepath.backuprestore. Alterar o basefilepath não afeta onde o comando tsm maintenance backup reúne o arquivo de backup.

Não é possível especificar um local basefilepath.backuprestore na raiz de uma unidade. Deve estar em uma pasta.

• Para comandos de manutenção de tsm:

  • Para alterar o diretório de backup, restore ou send-logs, execute o seguinte comando:

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

  • Para alterar o diretório dos ziplogs:

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

• Para comandos de sites tsm:

  • Para alterar o diretório de exportação de sites:

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

  • Para alterar o diretório de importação de sites:

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

Após alterar o local padrão do arquivo, é necessário fazer o seguinte:

1. Aplique as alterações pendentes:

   tsm pending-changes apply

   Se as alterações pendentes exigirem uma reinicialização do servidor, o comando pending-changes apply exibirá um prompt para que você saiba que ocorrerá uma reinicialização. Esse prompt será exibido mesmo que o servidor esteja parado, porém, nesse caso, não há reinicialização. Cancele o prompt com a opção --ignore-prompt, mas isso não altera o comportamento de reinicialização. Se as alterações não exigirem uma reinicialização, elas serão aplicadas sem um prompt. Para obter mais informações, consulte tsm pending-changes apply.

2. Interrompa o Tableau Server:

   tsm stop

3. Reinicie o Controlador TSM:

   net stop tabadmincontroller_0

   net start tabadmincontroller_0

4. Espere alguns minutos até que o controlador reinicie. Confirme se o controlador foi reiniciado com este comando:

   tsm status -v

   Quando for possível executar o comando e o Controlador de administração do Tableau Server estiver listado como "em execução", o controle terá reiniciado.

5. Inicie o Tableau Server:

   tsm start