Hjälp för Tableau Server på Linux

Processerna och tjänsterna som tillsammans utgör komponenterna i Services Manager (TSM) och Tableau Server i Linux kommunicerar via flera olika portar. Som standard tilldelas (mappas) de flesta av dessa portar dynamiskt från ett fördefinierat intervall med portar. Porttilldelningarna görs för varje tjänst eller process i samband med installationen. Du kan styra vilka portar som används på flera olika sätt.

En mindre deluppsättning av processerna använder inte dynamisk portmappning och fungerar på ett speciellt sätt. Mer information finns i Portar som inte mappas dynamiskt nedan.

Obs! Den här åtgärden inkluderar steg som du kan behöva utföra med TSM-kommandoraden.

Kortlivad portanvändning

Om ditt operativsystem är konfigurerat för att använda kortlivade portar kan din Tableau-trafik komma att dirigeras genom dessa, även när det är konfigurerat enligt beskrivningen nedan. Detta sker på operativsystemsnivå och är inget du kan konfigurera i Tableau. Läs dokumentationen för ditt operativsystem om hur du begränsar den kortlivade portanvändningen om du vill kontrollera portanvändningen.

Brandväggskrav

Om du kör en brandvägg på datorn där du ska installera Tableau Server, måste du öppna följande standardportar för Tableau Server-trafik. Alla portnummer utom 443 kan ändras.

Läs mer i Konfigurera en lokal brandvägg.

Porttilldelning

Du kan använda någon av två metoder när du tilldelar eller mappar portar i TSM:

• Dynamisk porttilldelning. Det här är standardmetoden och innebär minst arbete för administratören.
• Manuell porttilldelning. Det här alternativet kräver att en administratör tilldelar varje port för sig.

Om du ändrar porttilldelningarna och har en lokal brandvägg läser du Konfiguration av lokal brandvägg.

Dynamisk porttilldelning

Du kan styra vilka portar som används genom att ändra portintervallet som är tillgängligt för dynamisk tilldelning. På så sätt kan du använda dynamisk porttilldelning, men samtidigt styra vilka portar som är tillgängliga. Du kan fortfarande tilldela portar för vissa processer manuellt när du använder dynamisk porttilldelning. Det här är en bra metod om du vill tilldela vissa processer specifika portar och använda dynamisk mappning för resten. Dynamisk mappning, där inga eller några portar tilldelats separat, är den enklaste metoden och uppfyller oftast kundernas krav. Dynamiskt tilldelade portar bevaras om du exporterar Tableau Server-konfigurationen.

Som standard tilldelas portar för varje tjänst eller process från tillgängliga portar i intervallet 8000–9000. Den här tilldelningen äger rum när tjänster installeras för första gången på en nod. När Tableau Server har initierats kan du se vilka portar som används av vilka tjänster eller processer genom att köra det här kommandot:

tsm topology list-ports

Om du har ett kluster med flera noder visas portar på alla noder.

"configKeys": {
    "ports.range.min": "8300",
    "ports.range.max": "8600"
}

tsm configuration set -k ports.blocklist -v <port>[,<port>,<port>]

tsm configuration set -k ports.blocklist -v 8000,8088, 8090

Inaktivera dynamisk porttilldelning

Om du behöver bättre kontroll över porttilldelningen än du kan få genom att både begränsa portintervallet och tilldela portar separat kan du inaktivera dynamisk portmappning när du installerar och konfigurerar servern. Om du inaktiverar dynamisk portmappning måste du manuellt tilldela varje port för varje process. Därför är det inget vi rekommenderar såvida du inte behöver styra varje enskild process.

Om du inaktiverar dynamisk portmappning måste du konfigurera porten för varje process på varje nod i installationen.

Du kan inaktivera dynamisk mappning genom att lägga till en post som följande i konfigurationsfilen:

"configKeys": {
    "service.port_remapping.enabled": false
}

Viktigt: Om du inaktiverar dynamiska porttilldelningar så tillämpas inte ändringen på portintervallet som används av licenstjänsten. Portarna i detta intervall (från port 27000 till och med port 27009) måste vara öppna på noden där licenstjänsten körs och kunna nås från andra noder. Som standard är det den initiala noden som kör licenstjänsten.

Manuell porttilldelning

Du kan inaktivera automatisk porttilldelning helt och hållet och tilldela en port för varje enskild process separat. Om du gör det måste du tilldela en port för varje process på varje nod. Du kan tilldela portar i en konfigurationsfil, när processerna installeras eller efter installationen med hjälp av ett TSM-kommando. Endast portar som tilldelas i samband med installationen av processerna bevaras om du exporterar Tableau Server-konfigurationen.

Du kan ange enskilda portar för specifika processer, oavsett om dynamisk mappning är aktiverat eller inte. Du kan göra det om du vill att en process ska använda en viss port, eller om du har inaktiverat dynamisk mappning. Du kan ange portar för processer på två sätt: under installationen och i efterhand.

Konfigurera portar i samband med installationen

Vi rekommenderar att du konfigurerar porttilldelningen i samband med installationsprocessen, på det sätt som beskrivs här. Det är betydligt krångligare att byta portar efter installationen.

Du konfigurerar portar i samband med installationen genom att skapa en JSON-fil som definierar portkonfigurationen. Den här processen påminner om hur du definierar ett annat portintervall än standardintervallet. Skillnaden är att du anger en viss port för en specifik tjänst eller process. Om du vill tilldela specifika portar är det här den mest robusta metoden eftersom portmappningen bevaras om du exporterar serverkonfigurationen och topologiinställningarna med kommandot tsm settings export.

Du definierar portar i anslutning till installationen genom att lägga till information i konfigurationsfilen för att ange noden (workerN), processen (servicename), instans-ID:t (instanceid), porttypen (porttype) och vilken port som ska användas. Så här ser formatet ut:

workerN.{servicename}_{instanceid}.{porttype}.port:X

Där:

• workerN är en valfri parameter som identifierar noden som ommappningen gäller för. Nodnummer börjar på noll (0).
  Vi rekommenderar att du utelämnar den här parametern såvida du inte behöver mappa olika portar för samma tjänst på olika noder. Om du inte använder den här parametern kan du mappa en tjänstport på den första noden, eller mappa samma tjänstport på flera noder.
• servicename är namnet på den process eller tjänst som ska använda porten.
• instanceid är instansen av processen. Om du ska konfigurera flera instanser av en process på samma nod måste du öka det här värdet för varje instans. Starta instanceid på (0) och öka det med (1) för varje instans av processen. Använd inte detta för tjänster som installerar en enda instans på en viss nod.
• porttype Utelämna det här alternativet om du konfigurerar den primära porten.
• port är den port som processen eller tjänsten ska använda.

Om du till exempel vill att porten för den första instansen av fillagringsprocessen på den första noden ska vara port 8500 lägger du till en post i konfigurationsfilen som den nedan:

"configKeys": {
    "filestore_0.port: "8500"
}

I exemplet ovan används inte den valfria parametern workerN, och därför konfigureras porten för alla noder i klustret. Eftersom det är den primära filestore-porten som konfigureras utelämnas även porttype-alternativet.

Viktigt: När du anger portändringar med en konfigurationsfil måste du använda parametern --force-keys med kommandot import av tsm-inställningar.

Konfigurera portar efter installationen

Om du behöver ändra portarna när du har installerat Tableau Server använder du kommandot tsm topology set-ports. Med den här metoden kan du ange en port för en specifik process i efterhand, när processen redan har installerats. Tänk dock på följande:

• Du måste ange portarna separat, på varje nod.
• När du har ställt in en enskild port måste du köra tsm restart.
• Porttilldelningarna bevaras inte om du behöver importera en Tableau Server-konfiguration med tsm settings import.
• Portnamn använder en annan syntax för tsm-kommandon än syntaxen som krävs för configKeys. Tabellen i slutet av det här avsnittet innehåller en syntaxreferens.

Om du till exempel vill konfigurera en andra filestore-instans på den första noden och använda port 8500 använder du:

tsm topology set-ports --node-name node1 --port-name filestore --port-value 8500 --instance 2

Följande exempel visar hur du använder kortkommandon för att ange JMX-portarna:

tsm topology set-ports -n node1 --port-name vizqlserver:jmx.rmi -pv 9403 -i 1

tsm topology set-ports -n node1 --port-name vizqlserver:jmx -pv 9404 -i 2

Obs! Portposter valideras inte när du anger dem. Det betyder att om du använder en port som redan tilldelats, eller om syntaxen för ett kommando är fel, så visas inget fel i Tableau förrän du startar om. När du har startat om kan ett allmänt fel av typen Det gick inte att omkonfigurera det asynkrona jobbet visas.

Om du lägger till fel portname:type med en giltig port kan du inte ta bort den felaktiga posten. I stället måste du tilldela värdet en annan port som inte används, så att den port som du vill använda blir ledig igen.

Portar som inte mappas dynamiskt

Tableau Server-lagringsplatsen använder två portar som inte mappas dynamiskt. Du kan åsidosätta standardportarna med hjälp av kommandot tsm configuration set och en processpecifik parameter.

Eftersom dessa portar inte använder dynamisk mappning visas de inte i utmatningen från kommandot tsm topology list-ports. För att se deras värde måste du köra kommandot tsm configuration get -k <config.value>. Exempel:

tsm configuration get -k pgsql.port

Dynamiskt mappade portar

Den här tabellen innehåller de processer eller tjänster som använder dynamiskt mappade portar.

Andra artiklar i det här avsnittet