tsm sites
É possível usar os comandos tsm sites
para exportar um site existente e importá-lo para um novo site (também chamado de migração de site) e para importar o novo site. O comando unlock
está disponível caso um erro bloqueie um site.
Os comandos tsm sites
usarão o armazenamento de arquivos local para armazenar os dados de exportação e importação. Se estiver executando um cluster do Tableau com vários nós, execute os comandos tsm sites
em um Tableau Server que estiver com o Processador de dados em execução. Para mais informações sobre o processo do processador de dados e os processos que o exigem, consulte Processos do Tableau Server.
Observação: ao migrar sites entre instâncias do Tableau Server, o site de destino deve estar em uma versão do Tableau Server que é igual ou posterior à versão do Tableau Server para o site de origem. Os sites de origem e de destino devem ser de versões compatíveis do Tableau Server.
Para obter as etapas mais abrangentes de como exportar um site, consulte Exportar ou importar um site.
tsm sites export
Exporta um site específico do Tableau Server para um arquivo .zip. Exporte um site para arquivar as configurações em um momento específico ou para completar a primeira etapa de um processo de migração de site.
Observação: os comandos tsm sites import
e tsm sites export
podem deixar um site em estado bloqueado se um erro ocorrer. Para desbloquear um site, use o comando tsm sites unlock
.
Sinopse
tsm sites export --site-id <source-siteID> --file <export-file> [options] [global options]
Opções
-f,--file <export-file>
Obrigatório.
Especifica o nome do arquivo no qual o Tableau Server salva todas as informações do site.
Este arquivo é gerado para o diretório definido na variável
basefilepath.site_export.exports
do TSM. Como padrão:C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports
Para obter mais informações sobre os caminhos do arquivo e como criá-los, consulte tsm File Paths.
-id,--site-id <source-siteID>
Obrigatório.
A ID do site sendo exportado. Você poderá obter a ID do site pela URL quando estiver conectado a um site por meio de um navegador da Web. Para obter informações sobre como localizar a ID do site, consulte Preparar os sites de origem e destino.
-ow,--overwrite
Opcional.
Substitui um arquivo de exportação do mesmo nome já existente.
--request-timeout <tempo limite em segundos>
Opcional.
Aguarde o tempo predefinido para que o comando seja concluído. O valor padrão é 43.200 (720 minutos).
tsm sites import
Este comando usa o arquivo .zip criado com tsm sites export
para gerar um conjunto de arquivos .csv que mostra como as configurações do site de origem exportado mapearão para o próximo site de destino.
Por padrão, o arquivo .zip é gerado e salvo no diretório siteexports
, em:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports
Antes de usar este comando, copie o arquivo .zip para o diretório no qual o Tableau espera que ele esteja. Este local está definido na variável basefilepath.site_import.exports
do TSM. Por padrão, o diretório de importação é:
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports
Para obter mais informações sobre os caminhos do arquivo e como criá-los, consulte tsm File Paths.
Observação: os comandos tsm sites import
e tsm sites export
podem deixar um site em estado bloqueado se um erro ocorrer. Para desbloquear um site, use o comando tsm sites unlock
.
Sinopse
tsm sites import --file <export-file.zip> --site-id <target-siteID> [options] [global options]
Opções
-f,--file <export-file.zip>
Obrigatório.
Nome do arquivo .zip criado pelo processo
tsm sites export
, e que deve ser copiado no diretório de importação. Como padrão:C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports
-id,--site-id <target-siteID>
Obrigatório.
A ID do novo site para o qual está sendo importado (o site de destino). Para obter informações sobre como localizar a ID do site, consulte Preparar os sites de origem e destino.
-c,--continue-on-ignorable-errors
Opcional.
Continuar importação de site se ocorrerem erros que podem ser ignorados. Esses erros podem indicar problemas com a importação de uma pasta de trabalho ou fonte de dados específica.
-k,--no-verify
Opcional.
Ignora a verificação de arquivos de mapeamento.
-m, --override-schedule-mapper <mapping-file.csv>
Opcional.
Agenda um arquivo de mapeamento para anular o mapeamento normal por nome.
--request-timeout <tempo limite em segundos>
Opcional.
Aguarde o tempo predefinido para que o comando seja concluído. O valor padrão é 7.200 (120 minutos).
tsm sites import-verified
Especifica o diretório que contém arquivos de mapeamento .csv de um site exportado, para importar a um novo site. Esta é a etapa final de um processo de migração de site.
Sinopse
tsm sites import-verified --import-job-dir <importjob-directory> --site-id <target-siteID> [options] [global options]
Opções
-id,--site-id <target-siteID>
Obrigatório.
A ID do novo site para o qual está sendo importado (o site de destino). Para obter informações sobre como localizar a ID do site, consulte Preparar os sites de origem e destino.
-w, --import-job-dir <importjob-directory>
Obrigatório.
Pai do diretório
mappings
que contém o arquivo .csv do site exportado (origem). O nome deste diretório pai inclui a ID de importação, a data e a hora. Por exemplo:C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\working\import_ff00_20180102022014457
--request-timeout <tempo limite em segundos>
Opcional.
Aguarde o tempo predefinido para que o comando seja concluído. O valor padrão é 7.200 (120 minutos).
tsm sites unlock
Use este comando para desbloquear um site.
Opções
-id,--site-id <target-siteID>
Obrigatório.
A ID do site sendo desbloqueado. Para obter informações sobre como localizar a ID do site, consulte Preparar os sites de origem e destino.
-d, --desired-state <state to leave unlocked site in>
Opcional.
O estado em que o site deve ser deixado após ser desbloqueado. As opções são "ativo” e "suspenso”. O padrão é "ativo” se não for especificado.
Por exemplo:
tsm sites unlock -id mysite -d suspended
--request-timeout <tempo limite em segundos>
Opcional.
Aguarde o tempo predefinido para que o comando seja concluído. O valor padrão é 300 (5 minutos).
Opções globais
-h, --help
Opcional.
Exibir a ajuda do comando.
-p, --password <senha>
Obrigatório, com
-u
ou--username
se não tiver sessões ativas.Especificar a senha do usuário especificado no
-u
ou--username
.Se a senha tiver espaços ou caracteres especiais, coloque-a entre aspas:
--password "my password"
-s, --server https://<hostname>:8850
Opcional.
Usar o endereço definido para o Gerenciador de serviços do Tableau. A URL deve começar com
https
, incluir a porta 8850 e usar o nome do servidor, não o endereço IP. Por exemplo,https://<tsm_hostname>:8850
. Se nenhum servidor for especificado, ohttps://<localhost | dnsname>:8850
é considerado.--trust-admin-controller-cert
Opcional.
Use este sinalizador para confiar no certificado autoassinado do controlador TSM. Para obter mais informações sobre confiança de certificado e conexões CLI, consulte Conexão de clientes do TSM.
-u, --username <usuário>
Obrigatório se nenhuma sessão estiver ativa, com
-p
ou--password
.Especificar uma conta de usuário. Se não incluir essa opção, o comando é executado usando as credenciais de logon.