Certos comandos tsm leem ou gravam arquivos nos locais padrão. Esses locais são determinados por chaves de configuração basefilepath definidas para cada comando. O tsm pode ser usado para exibir o valor atual das chaves e alterar os locais.

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:

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

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

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

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

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

    • ziplogs—O arquivo ziplogs é gerado em:

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

  • tsm sites

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

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

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

      /var/opt/tableau/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. Para obter mais informações sobre as permissões e o tsm, consulte Arquivos e permissões no TSM. 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 "/new/directory/path"

    • Para alterar o diretório dos ziplogs:

      tsm configuration set -k basefilepath.log_archive -v "/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 "/new/directory/path"

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

      tsm configuration set -k basefilepath.site_import.exports -v "/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 (como a conta de sistema do tableau):

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

  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

 

Agradecemos seu feedback!