Guia de Implantação do Tableau Server Enterprise

switchto

Switchto é um script do Tim que torna mais fácil alternar entre as janelas.

1. Copie o seguinte código em um arquivo chamadoswitchto no diretório inicial do seu host bastião.

#!/bin/bash
#-------------------------------------------------------------------
# switchto
#
# Helper function to simplify SSH into the various AWS hosts when
# following the Tableau Server Enterprise Deployment Guide (EDG).
#
# Place this file on your bastion host and provide your AWS hosts' 
# internal ip addresses or machine names here.
# Example: readonly NODE1="10.0.3.187"
#
readonly NODE1=""
readonly NODE2=""
readonly NODE3=""
readonly NODE4=""
readonly PGSQL=""
readonly PROXY1=""
readonly PROXY2=""
				
usage() {
echo "Usage: switchto.sh [ node1 | node2 | node3 | node4 | pgsql | proxy1 | proxy2 ]"
}


ip=""

case $1 in
	node1)
		ip="$NODE1"
		;;
	node2)
		ip="$NODE2"
		;;
	node3)
		ip="$NODE3"
		;;
	node4)
		ip="$NODE4"
		;;
	pgsql)
		ip="$PGSQL"
		;;
	proxy1)
		ip="$PROXY1"
		;;
	proxy2)
		ip="$PROXY2"
		;;
	?)
		usage
		exit 0
		;;
	*)
		echo "Unkown option $1."
		usage
		exit 1
		;;
esac

if [[ -z $ip ]]; then
echo "You must first edit this file to provide the ip addresses of your AWS hosts."
exit 1
fi

ssh -A ec2-user@$ip

2. Atualize os endereços IP no script para mapear para suas instâncias EC2 e, em seguida, salve o arquivo.
3. Aplique permissões ao arquivo de script:

sudo chmod +x switchto

Uso:

Para alternar para um host, execute os comandos a seguir:

./switchto <target>

Por exemplo, para mudar para o Nó 1, execute o seguinte comando:

./switchto node1

Solucionar problemas o Tableau Server Independent Gateway

A configuração de Independent Gateway, Okta, Mellon e SAML no Tableau Server pode ser um processo propenso a erros. A causa raiz mais comum de falhas é um erro de cadeia de caracteres. Por exemplo, uma barra final (/ ) nas URLs do Okta especificadas durante a configuração pode causar um erro de incompatibilidade relacionado à declaração SAML. Isso é apenas um exemplo. Há muitas oportunidades durante a configuração para inserir uma cadeia de caracteres incorreta em qualquer um dos aplicativos.

Reiniciar o serviço tableau-tsig

Sempre inicie (e termine) a solução de problemas reiniciando o serviço tableau-tsig nos computadores do Gateway Independente. Reiniciar esse serviço é rápido e geralmente aciona a configuração atualizada para carregar do Tableau Server.

Execute os comandos a seguir para atualizar o computador do Independent Gateway:

sudo su - tableau-tsig

systemctl --user restart tsig-httpd

exit

Encontrar cadeias de caracteres incorretas

Se você cometeu um erro de cadeia de caractere (erro de copiar/colar, cadeia de caractere truncada etc.), reserve um tempo para percorrer cada uma das configurações que você configurou:

• Configuração de pré-autenticação do Okta. Revise cuidadosamente as URLs que você definiu. Procure por barras à direita. Verifique HTTP vs HTTPS.
• Histórico de shell para configuração de SAML no nó 1. Reveja o comando tsm authentication saml configure que você executou. Verifique se todas as URLs correspondem àquelas que você configurou no Okta. Enquanto estiver revisando o histórico do shell do Nó 1, verifique se os comandos tsm configuration set que especificam os caminhos do arquivo de configuração do Mellon mapeiam exatamente para os caminhos do arquivo onde você copiou os arquivos no Independent Gateway.
• Configuração do Mellon no Independent Gateway. Revise o histórico do shell para verificar se você criou os metadados com a mesma cadeia de caractere de URL que você configurou no Okta e no Tableau SAML. Verifique se todos os caminhos especificados em/etc/mellon/conf.d/global.conf estão corretos e que MellonCookieDomain está definido para seu domínio raiz, não para seu subdomínio do Tableau.

Pesquisar registros relevantes

Se todas as cadeias de caracteres parecem estar configuradas corretamente, você deve inspecionar os registros em busca de erros.

O Tableau Server registra erros e eventos em dezenas de arquivos de registros diferentes. O Independent Gateway também registra em um conjunto de arquivos locais. Recomendamos inspecionar esses registros na seguinte ordem.

Arquivos de registro do Independent Gateway

O local padrão dos registros de arquivos de registro do Independent Gateway estão em /var/opt/tableau/tableau_tsig/logs.

• access.log: esse registro é útil na medida em que possui entradas que mostram conexões dos nós do Tableau Server. Se você estiver recebendo erros de gateway (não iniciará) ao tentar iniciar o TSM e não houver entradas no arquivo access.log, há um problema de conectividade principal. Sempre verifique a configuração do grupo de segurança da AWS como primeira etapa. Outro problema comum é um erro de digitação tsig.json. Se você fizer uma atualização para tsig.json, execute tsm stop antes de executar r tsm topology external-services gateway update -c tsig.json. Depois que o tsig.json for atualizado, execute tsm start.
• error.log: entre outras entradas, este registro inclui erros SAML e Mellon.

Arquivo de registro do tabadminagent do Tableau Server

O conjunto de arquivos tabadminagent (tabadmincontroller) são os únicos arquivos de registro relevantes para solucionar erros relacionados ao Independent Gateway.

Você deve localizar onde os erros do Independent Gateway foram registrados no tabdminagent. Esses erros podem estar em qualquer nó, mas estão apenas em um nó. Execute as etapas a seguir em cada nó no cluster do Tableau Server até encontrar a cadeia de caracteres “independent”:

1. Localize o local do arquivo de registro tabadminagent nos nós 1-4 do Tableau Server na configuração do EDG:

   cd /data/tableau_data/data/tabsvc/logs/tabadminagent

2. Abra o registro mais recente para ler:

   less tabadminagent_nodeN.log

   (substitua N pelo número do nó)

3. Pesquise todas as instâncias de “Independent” e “independent” - usando a seguinte cadeia de caracteres de pesquisa:

   /ndependent

   Se não houver correspondências, vá para o próximo nó e repita as etapas 1 a 3.

4. Quando você consegue uma correspondência: Shift + G para mover para baixo para obter as últimas mensagens de erro.

Recarregue o arquivo stub httpd

O Independent Gateway gerencia a configuração do httpd para Apache. Uma operação genérica que geralmente corrige problemas transitórios é recarregar o arquivo stub httpd que propaga a configuração subjacente do Apache. Execute os comandos a seguir em ambas as instâncias do Gateway Independente.

1. Copie o arquivo stub para httpd.conf:

   cp /var/opt/tableau/tableau_tsig/config/httpd.conf.stub /var/opt/tableau/tableau_tsig/config/httpd.conf

2. Reinicie o serviço do Independent Gateway:

   sudo su - tableau-tsig
   systemctl --user restart tsig-httpd
   exit

Excluir ou mover arquivos de registro

O Independent Gateway registra todos os eventos de acesso. Você precisará gerenciar o armazenamento de arquivos de registro para evitar o preenchimento de espaço em disco. Se o seu disco ficar cheio, o Independent Gateway não poderá gravar eventos de acesso e o serviço falhará. A seguinte mensagem será registrada em error.log no Independent Gateway:

(28)No space left on device: [client 10.0.2.209:54332] AH00646: Error writing to /var/opt/tableau/tableau_tsig/logs/access.%Y_%m_%d_%H_%M_%S.log

Esta falha resultará em um status de DEGRADED para o nó external quando você executa tsm status -v no Nó 1 do Tableau. O nó external na saída de status refere-se ao Independent Gateway.

Para resolver esse problema, exclua ou mova os arquivos access.log do disco. Os arquivos de registro são armazenados em /var/opt/tableau/tableau_tsig/logs. Depois de limpar o disco, reinicie o serviço tableau-tsig.

Erros do navegador

Solicitação inválida: um erro comum neste cenário é um erro de "Solicitação inválida" da Okta. Frequentemente, esse problema ocorre quando o navegador está armazenando dados em cache de uma sessão anterior do Okta. Por exemplo, se você gerencia os aplicativos Okta como um administrador Okta e, em seguida, tenta acessar o Tableau usando uma conta habilitada para Okta diferente, os dados da sessão dos dados do administrador podem causar o erro "Solicitação inválida". Se esse erro persistir mesmo depois de limpar o cache do navegador local, tente validar o cenário do Tableau conectando-se em um navegador diferente.

Outra causa do erro "Solicitação inválida" é um erro de digitação em uma das muitas URLs que você insere durante os processos de configuração do Okta, Mellon e SAML. Verifique se você digitou tudo isso sem erros.

Muitas vezes o arquivo error.log no servidor do Independent Gateway especificará qual URL está causando o erro.

Não encontrado - A URL solicitada não foi encontrado neste servidor: este erro indica um dos muitos erros de configuração.

Se o usuário for autenticado com Okta e receber esse erro, é provável que você tenha carregado o aplicativo de pré-autenticação Okta para o Tableau Server quando configurou o SAML. Verifique se você tem os metadados do aplicativo Okta Tableau Server configurados no Tableau Server, e não os metadados do aplicativo de pré-autenticação Okta

Outras etapas de solução de problemas:

• Revise as configurações do aplicativo de pré-autenticação do Okta. Certifique-se de que os protocolos HTTP vs HTTPS estejam definidos, conforme especificado neste tópico.
• Reinicie o tsig-httpd em ambos os servidores do Independent Gateway.
• Verifique se sudo apachectl configtest retorna “Sintaxe OK” em ambos Independent Gateways.
• Verifique se o usuário de teste está atribuído a ambos os aplicativos no Okta.
• Verifique se a aderência está definida no balanceador de carga e grupos de destino associados

Verifique o TLS do Tableau Server para o Independent Gateway

Use o comando wget para verificar a conectividade e o acesso do Tableau Server para o Independent Gateway. Variações desse comando podem ajudá-lo a entender se os problemas de certificado estão causando problemas de conexão.

Por exemplo execute este comando wget para verificar o protocolo de manutenção (HK) do Tableau Server:

wget https://ip-10-0-1-38.us-west-1.compute.internal:21319

Crie a URL com o mesmo endereço de host que você incluiu para a opção de host do arquivo tsig.json. Especifique o protocolo https e anexe a URL com a porta HK 21319.

Para verificar a conectividade e ignorar a verificação do certificado:

wget https://ip-10-0-1-38.us-west-1.compute.internal:21319 --no-check-certificate

Para verificar se o certificado CA raiz para TSIG é válido:

wget https://ip-10-0-1-38.us-west-1.compute.internal:21319 --ca-certificate=tsigRootCA.pem

Se o Tableau conseguir se comunicar, você ainda poderá receber erros relacionados ao conteúdo, mas não receberá erros relacionados à conexão. Se o Tableau não conseguir se conectar, comece verificando a configuração do protocolo nos grupos de firewall/segurança. Por exemplo, as regras de entrada para o grupo de segurança em que reside o Independent Gateway devem permitir TCP 21319.