Driftsättningsguide för Tableau Server för företag

switchto

Switchto är ett skript från Tim som gör det enkelt att växla mellan fönster.

1. Kopiera följande fil till en fil som heter switchto i startkatalogen på din bastion-värd.

#!/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. Uppdatera IP-adresserna i skriptet så de mappar till dina EC2-instanser och spara filen.
3. Tillämpa behörigheter för skriptfilen:

sudo chmod +x switchto

Syntax:

Växla till en värd genom att köra följande kommando:

./switchto <target>

Om du till exempel vill växla till nod 1 kör du följande kommando:

./switchto node1

Felsöka oberoende gateway för Tableau Server

Det kan uppstå många fel när oberoende gateway, Okta, Mellon och SAML på Tableau Server konfigureras. Den vanligaste grundorsaken till fel är ett strängfel. ett snedstreck (/) i Okta-URL:n som anges under konfigurationen kan till exempel orsaka ett matchningsfel relaterat till ett SAML-påstående. Det här är bara ett exempel. Det finns många möjligheter att mata in en felaktig sträng i någon av applikationerna under konfigurationen.

Starta om tableau-tsig-tjänsten

Börja (och avsluta) alltid felsökningen genom att starta om tableau-tsig-tjänsten på datorerna med oberoende gateway. Det går snabbt att starta om den här tjänsten och det får ofta den uppdaterade konfigurationen att läsas in från Tableau-servern.

Kör följande kommandon på datorn med oberoende gateway:

sudo su - tableau-tsig

systemctl --user restart tsig-httpd

exit

Hitta felaktiga strängar

Om du har gjort ett strängfel (kopierat/klistrat in felaktigt, trunkerat en sträng osv.) bör du ta dig tid att gå igenom var och en av inställningarna du har konfigurerat:

• Konfiguration av Okta-förautentisering. Granska noggrant URL:erna som du har angett. Leta efter snedstreck. Verifiera HTTP kontra HTTPS.
• Kommandotolkshistorik för SAML-konfiguration på nod 1. Granska kommandot tsm authentication saml configure som du körde. Kontrollera att alla URL:er matchar dem som du har konfigurerat i Okta. Medan du granskar kommandotolkshistoriken på nod 1 ska du verifiera att kommandona tsm configuration set som anger Mellon-konfigurationsfilens sökvägar mappar exakt till filsökvägarna där du kopierade filerna på oberoende gateway.
• Mellon-konfiguration på oberoende gateway. Granska kommandotolkshistoriken för att verifiera att du skapade metadata med samma URL-sträng som du har konfigurerat i Okta och Tableau SAML. Kontrollera att alla sökvägar som anges i /etc/mellon/conf.d/global.conf är korrekta och att MellonCookieDomain är inställd på din rotdomän, inte din Tableau-underdomän.

Söka i relevanta loggar

Om alla strängar verkar vara korrekt inställda bör du granska loggar efter fel.

Tableau Server loggar fel och händelser till dussintals olika loggfiler. Den oberoende gatewayen loggar också till en uppsättning lokala filer. Vi rekommenderar att du granskar dessa loggar i följande ordning.

Loggfiler från oberoende gateway

Standardplatsen för loggfilerna från oberoende gateway är /var/opt/tableau/tableau_tsig/logs.

• access.log: Den här loggen är användbar eftersom den har poster som visar anslutningar från Tableau Server-noderna. Om du får gateway-fel (startar inte) när du försöker starta TSM och det inte finns några poster i filen access.log, så finns det ett kärnanslutningsproblem. Verifiera alltid AWS-säkerhetsgruppens konfiguration som ett första steg. Ett annat vanligt problem är ett stavfel i tsig.json. Om du uppdaterar något i tsig.json bör du köra tsm stop innan du kör tsm topology external-services gateway update -c tsig.json. Efter att tsig.json har uppdaterats kör du tsm start.
• error.log: Utöver andra poster innehåller den här loggen SAML- och Mellon-fel.

Tableau Server tabadminagent-loggfil

Uppsättningen av tabadminagent-filer (inte tabadmincontroller-filer) är de enda relevanta loggfilerna för felsökning av fel relaterade till oberoende gateway.

Du måste hitta var oberoende gateway-fel har loggats till tabdminagent. Felen kan finnas på vilken nod som helst, men de finns bara på en nod. Utför följande steg på varje nod i Tableau Server-klustret tills du hittar den ”oberoende” strängen:

1. Leta reda på tabadminagent-loggfilens plats på Tableau Server-noderna 1–4 i EDG-installationen:

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

2. Öppna senaste loggen för att läsa:

   less tabadminagent_nodeN.log

   (ersätt N med nodnummer)

3. Sök efter alla instanser av ”Oberoende” och ”oberoende” genom att använda följande söksträng:

   /ndependent

   Om det inte finns några matchningar går du till nästa nod och upprepar steg 1–3.

4. När du får en matchning trycker du på Shift + G för att hoppa längst ner för att få senaste felmeddelanden.

Läsa in httpd-stubbfilen på nytt

Oberoende gateway hanterar konfigurationen av httpd för Apache. En generisk åtgärd som ofta åtgärdar övergående problem är att läsa in httpd-stubbfilen som seedar den underliggande Apache-konfigurationen på nytt. Kör följande kommandon på båda instanserna av oberoende gateway.

1. Kopiera stubbfilen till httpd.conf:

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

2. Starta om oberoende gateway-tjänsten:

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

Ta bort eller flytta loggfiler

Oberoende gateway loggar alla åtkomsthändelser. Du behöver hantera loggfillagringen för att undvika att fylla upp diskutrymme. Om din disk fylls kan den oberoende gatewayen inte skriva åtkomsthändelser och tjänsten kommer att misslyckas. Följande meddelande loggas till error.log på den oberoende gatewayen:

(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

Det här felet resulterar i statusen DEGRADED för noden external när du kör tsm status -v på Tableau-nod 1. Noden external i den returnerade statusen hänvisar till oberoende gateway.

För att lösa problemet behöver du ta bort eller flytta access.log-filerna från disken. Loggfiler lagras under /var/opt/tableau/tableau_tsig/logs. När du har rensat disken ska du starta om tableau-tsig-tjänsten.

Webbläsarfel

Dålig begäran: Ett vanligt fel för det här scenariot är ett Dålig begäran-fel från Okta. Det här problemet uppstår ofta när webbläsaren cachelagrar data från tidigare Okta-sessioner. Om du till exempel hanterar Okta-applikationer som en Okta-administratör och därefter försöker få åtkomst till Tableau med ett annat Okta-aktiverat konto så kan sessionsdata från administratörsdata orsaka Dålig begäran-felet. Om felet kvarstår även efter att du rensat den lokala webbläsarens cacheminne så kan du testa att validera Tableau-scenariot genom att ansluta med en annan webbläsare.

En annan orsak till felet ”Felaktig begäran” är ett stavfel i en av de många URL:er som du anger under Okta-, Mellon- och SAML-konfigurationsprocesserna. Kontrollera att du har angett alla dessa utan fel.

Ofta kommer filen error.log på oberoende gateway-servern att ange vilken URL som orsakar felet.

Hittades inte – Den begärda URL:en hittades inte på den här servern: Det här felet indikerar ett av flera konfigurationsfel.

Om användaren autentiserats med Okta och därefter stöter på det här felet så har du sannolikt laddat upp Okta förautentiseringsapplikationen till Tableau Server när du konfigurerade SAML. Verifiera att du har konfigurerat Okta-applikationsmetadata för Tableau Server på Tableau Server och inte applikationsmetadata för Okta förautentisering.

Andra felsökningssteg:

• Granska applikationsinställningarna för Okta förautentisering. Se till att HTTP- kontra HTTPS-protokollen angetts som specificerade i det här ämnet.
• Starta om tsig-httpd på båda oberoende gateway-servrarna.
• Verifiera att sudo apachectl configtest returnerar ”Syntax OK” för bägge oberoende gateways.
• Verifiera att testanvändaren tilldelats båda applikationerna i Okta.
• Verifiera att ihållande angetts för lastbalanseraren och associerade målgrupper.

Verifiera TLS-anslutning från Tableau Server till oberoende gateway

Använd kommandot wget för att verifiera anslutning och åtkomst från Tableau Server till oberoende gateway. Variationer av det här kommandot kan hjälpa dig att förstå om certifikatproblem orsakar anslutningsproblem.

Kör till exempel det här wget-kommando för att verifiera rensningsprotokollet (HK) från Tableau Server:

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

Konstruera URL:en med samma värdadress som du inkluderade för värdalternativet för filen tsig.json. Specificera https-protokollet och lägg till URL:en med HK-porten 21319.

Så här kontrollerar du anslutningen och ignorerar certifikatverifiering:

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

Så här verifierar du att rot-CA-certifikatet för TSIG är giltigt:

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

Om Tableau kan kommunicera kan du fortfarande få innehållsrelaterade fel, men du kommer inte att få anslutningsrelaterade fel. Om Tableau inte kan ansluta alls ska du börja med att verifiera protokollkonfigurationen i brandväggen/säkerhetsgrupperna. Till exempel måste reglerna för inkommande trafik för säkerhetsgruppen där oberoende gateway finns tillåta TCP 21319.