Tableau Server i Windows-hjälp

Du kan köra tsm-kommandon på den initiala noden (noden där TSM är installerat) och på alla ytterligare noder i klustret.

För att köra tsm-kommandon måste du öppna Windows kommandotolk. Använd inte PowerShell för att köra tsm-kommandon. Om du använder PowerShell kan det orsaka oväntat beteende.

1. Öppna Windows kommandotolk med ett konto som är medlem i administratörsgruppen på en nod i klustret.

2. Kör önskat kommando. Om du kör kommandot från en annan nod än den initiala noden ska du inkludera alternativet -s för att ange URL:en till den initiala noden med namn (inte IP-adress) och inkludera TSM-porten 8850.

   Så här ser du versionen av TSM och Tableau Server från den initiala noden:

   tsm version

   Så här ser du versionen av TSM och Tableau Server från en ytterligare nod:

   tsm version -s https://<inital_node_name>:8850

   Till exempel:

   tsm version -s https://myTableauHost:8850

backgrounder.failure_threshold_for_run_prevention

Standardvärde: 5

Antalet samtidiga fel för ett prenumerations-, extrakt- eller flödeskörningsjobb innan det jobbet stoppas. Stopp av jobb som kontinuerligt misslyckas hjälper till att bevara bakgrundsprocessorns resurser för andra jobb. Inaktivera stopp av bakgrundsuppgifter som misslyckas genom att ange det här till -1.

backgrounder.log.level

Version: tillagt i version 2020.3.0.

Standardvärde: info

Loggningsnivå för bakgrundsprocessorn. Detta kan konfigureras dynamiskt, så om du bara ändrar detta behöver du inte starta om Tableau Server. Du hittar mer information i Ändra loggningsnivåer.

backgrounder.restrict_serial_collections_to_site_level

Standardvärde: false

I Tableau Server kan du schemalägga extraktuppdateringar, prenumerationer eller flöden att köras periodvis. Dessa schemalagda objekt kallas för uppgifter. Bakgrundsprocessorn initierar unika instanser av de här uppgifterna för att köra dem då de är schemalagda. De unika instanser av uppgifter som initieras som ett resultat av detta kallas för jobb.

Den här inställningen påverkar scheman som konfigurerats att köras seriellt. När ett schema konfigureras att köras seriellt körs alla jobb som använder det schemat seriellt som standard. När den här inställningen har angetts till true, kan jobb som körs på olika platser köras parallellt. Jobb för schemalagda uppgifter på samma plats kommer fortsätta köras seriellt.

Exemplet nedan illustrerar detta scenario:

Tableau Server inkluderar ett schema som heter Dagligen som kör jobb varje dag klockan 07.00. Dagligen-schemat har konfigurerats att köras seriellt. Platsen HR och platsen Löner har båda flera schemalagda uppgifter som använder schemat Dagligen. När den här inställningen har angetts som true, kan jobb för dessa schemalagda uppgifter på platsen HR köras parallellt med jobb på platsen Löner medan jobb på samma plats fortfarande endast körs seriellt.

backgrounder.timeout.single_subscription_notify

Version: tillagt i version 2021.2.

Standardvärde: 1800 sekunder (30 minuter)

Det här är max tillåten tid angett i sekunder för att slutföra ett enda prenumerationsjobb.

backgrounder.timeout.sync_ad_group

Version: Tillagt i version 2021.1.23, 2021.2.21, 2021.3.20, 2021.4.15, 2022.1.11, 2022.3.3, 2023.1.

Standardvärde: 14400 sekunder (4 timmar)

Det här är den längsta tillåtna tiden i sekunder för att slutföra en synkronisering av Active Directory-grupper. Detta gäller schemalagda gruppsynkroniseringar som utförs av bakgrundsprocessorn och förhindrar att långvariga synkroniseringar körs på obestämd tid. Detta påverkar inte gruppsynkroniseringar som utförs med Tableau Server-gränssnittet eller REST API.

backgrounder.vInstances_max_overflow_queue_size

Version: tillagt i version 20221.2.

Standardvärde: 1000

Max antal jobb som kan vara i den sekundära kön. En sekundär kö skapas när antalet jobb som körs är vid angiven samtidighetsgräns. Standardmaxvärdet är 1000 jobb vilket innebär att vid fler än 1000 jobb när samtidighetsgränsen uppnås så kommer de inte att köas. Använd kommandot backgrounder.vInstance_max_overflow_queue_size tsm för att ändra max köstorlek för överflöde.

Värdena ska anges i heltal.

backup.zstd.thread_count

Version: tillagt i version 2021.1.0. Den här nyckeln är dynamiskt konfigurerbar. Mer information finns i Dynamiska topologiförändringar för Tableau Server

Standardvärde: 2

Antalet trådar som ska användas när du skapar en säkerhetskopia.

Om du ökar det här talet kan det förbättra prestanda vid säkerhetskopiering men vi rekommenderar att antalet trådar inte överstiger antalet logiska processorer på Tableau Server-datorn, upp till fyra.

basefilepath.backuprestore

Standardvärde: C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\

Platsen där kommandot tsm maintenance backup skapar säkerhetskopian. Det är även den plats där säkerhetskopian måste finnas när den återställs med kommandot tsm maintenance restore eller tsm maintenance send-logs. Efter att ha angett det här bör du köra kommandot tsm maintenance validate-backup-basefilepath (finns i version 2022.1 och senare) för att verifiera att behörigheterna har angetts korrekt för platsen. Du hittar mer information i Sökvägar för tsm.

basefilepath.log_archive

Standardvärde: C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives\

Platsen där kommandot tsm maintenance ziplogs skapar det zip-komprimerade arkivet. Du hittar mer information i Sökvägar för tsm.

basefilepath.site_export.exports

Standardvärde: C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports\

Platsen där kommandot tsm sites export skapar exportfilen. Du hittar mer information i Sökvägar för tsm.

basefilepath.site_import.exports

Standardvärde: C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\

Platsen där kommandot tsm sites import förväntar sig att importfilen ska finnas. Du hittar mer information i Sökvägar för tsm.

clustercontroller.log.level

Version: tillagt i version 2020.3.0.

Standardvärde: info

Loggningsnivån för Cluster Controller. Detta kan konfigureras dynamiskt, så om du bara ändrar detta behöver du inte starta om Tableau Server. Du hittar mer information i Ändra loggningsnivåer.

databaseservice.max_database_deletes_per_run

Version: tillagt i version 2021.2.

Standardvärde: null

Använd det här alternativet för att justera max antal inbäddade externa resurser (databaser och tabeller) som kan tas bort varje gång bakgrundsprocessorn, som styrs av features.DeleteOrphanedEmbeddedDatabaseAsset körs. Om det här alternativet lämnas tomt är det standardmässiga maxantalet inbäddade externa resurser som kan tas bort 100.

Du hittar mer information i features.DeleteOrphanedEmbeddedDatabaseAsset.

dataserver.log.level

Version: tillagt i version 2020.3.0.

Standardvärde: info

Loggningsnivån för dataservern. Detta kan konfigureras dynamiskt, så om du bara ändrar detta behöver du inte starta om Tableau Server. Du hittar mer information i Ändra loggningsnivåer.

dataserver_<n>.port

Port som dataserverinstansen (anges av ”<n>”) körs på.

excel.shadow_copy_all_remote.enabled

Version: lades till i versionerna 2019.1.5, 2019.2.1.

Standardvärde: false

Styr om Tableau Server skapar en skuggkopia av ett delat Excel-kalkylblad (.xlxs eller .xlxm) som används som en livedatakälla. När det har aktiverats förhindrar det här alternativet Excel-användare från att se ett ”Delningsöverträdelsefel” och ett meddelande om att filen ”för tillfället används”. Det här alternativet kan påverka prestandan för stora Excel-filer. Om Excel-användare inte behöver redigera den delade filen så behöver du inte aktivera det här alternativet.

Obs! Tableau Server försöker alltid skapa en skuggkopia av en .xls-fil. Det här alternativet ändrar inte det beteendet.

extractservice.command.execution.timeout

Version: tillagt i version 2021.4.

Standardvärde: 7200 sekunder

Anger tidsgränsvärdet för tillåten körningstid för VConn-extraktuppdateringen.

Exempel: tsm configuration set -k extractservice.command.execution.timeout -v <timeout_in_seconds> --force-keys

Obs! Du måste använda alternativet --force-keys för att ändra det här värdet.

features.ActiveMQ

Version: tillagt i version 2021.4.

Standardvärde: true

Styr om Tableau Server använder Apache ActiveMQ-tjänsten (Tableau Server Messaging Service) för den interna meddelandemekanismen.

features.DeleteOrphanedEmbeddedDatabaseAsset

Version: tillagt i version 2021.2.

Standardvärde: true

Styr en bakgrundsprocessor för Tableau Catalog (eller Tableau Metadata API) som raderar inbäddade externa resurser (databaser och tabeller) som inte längre är associerade med Tableau-innehåll nedströms. Den här processen körs varje dag vid 22:00:00 UTC (koordinerad universell tid) och kan radera max 100 externa resurser varje dag tills det inte finns några externa resurser kvar utan anslutningar till Tableau-innehåll nedströms. Du kan ange det här alternativet som false för att stoppa att processen körs. Alternativt kan du justera max antal externa inbäddade resurser som kan raderas med hjälp av databaseservice.max_database_deletes_per_run.

Mer information finns i Felsöka innehåll som saknas.

features.IdentityMigrationBackgroundJob

Version: tillagt i version 2022.1. Standardvärdet har ändrats till false i version 2021.4.22, 2022.1.18, 2022.3.10, 2023.1.6 och 2023.3.

Standardvärde: false

Styr den process som utför identitetsmigreringen. När detta är inställt på true körs identitetsmigreringen i befintliga driftsättningar omedelbart efter uppgradering av Tableau Server till version 2022.1 (eller senare) och efter återställning av en säkerhetskopia av Tableau Server version 2021.4 (eller tidigare). Ange som false (standard) för att inaktivera identitetsmigrering.

Om du till exempel vill starta identitetsmigreringen kör du följande:

tsm configuration set -k features.IdentityMigrationBackgroundJob -v true

Mer information finns i Om identitetsmigrering.

Obs! Om identitetsmigrering är inaktiverat kan Tableau Server inte använda identitetstjänsten för att lagra och hantera information om användaridentiteter. Identitetstjänsten är en förutsättning för att vissa saker som identitetspooler ska kunna användas.

features.IdentityPools

Version: tillagt i version 2023.1.

Standardvärde: false

En komponent i funktionen för identitetspooler som måste aktiveras om du utför en ny Tableau Server-installation. Kräver feature.NewIdentityMode och wgserver.authentication.legacy_identity_mode.enabled. Ställ in på true för att aktivera identitetspooler. Ställ in på false (standard) för att inaktivera identitetspooler.

Om du till exempel vill aktivera identitetspooler kör du följande:

tsm configuration set -k features.IdentityPools -v true
tsm configuration set -k features.NewIdentityMode -v true
tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false
tsm pending-changes apply

Mer information finns i Felsöka identitetspooler.

features.MessageBusEnabled

Version: tillagt i version 2019.4.

Standardvärde: true

Styr om Tableau Server använder den nya interna meddelandemekanismen.

features.NewIdentityMode

Version: tillagt i version 2022.1.

Standardvärde: false. Standardvärdet ändrades från true till false i 2023.1.6.

En förutsättning för identitetspoolfunktionen. wgserver.authentication.legacy_identity_mode.enabled måste ställas in på false för att aktivera identitetspooler. Ställ in på true för att inaktivera identitetspooler.

tsm configuration set -k features.IdentityPools -v true
tsm configuration set -k features.NewIdentityMode -v true
tsm configuration set -k wgserver.authentication.legacy_identity_mode.enabled -v false
tsm pending-changes apply

Mer information finns i Felsöka identitetspooler.

features.PasswordlessBootstrapInit

Standardvärde: true

Styr om Tableau Server tillåter inbäddade inloggningsuppgifter i startfiler. När det är aktiverat (standardvärdet) inkluderas inbäddade inloggningsuppgifter i startfilen om du inte specificerar att de inte ska inkluderas. Ange det här som false om inloggningsuppgifter aldrig ska ingå i startfiler som du genererar. Mer information om att generera startfiler finns i tsm topology nodes get-bootstrap-file.

Det här alternativet lades till från och med Tableau Server version 2019.3.

features.PasswordReset

Version: utfasat i version 2024.2. För version 2024.2 och senare använder du vizportal.password_reset.

Standardvärde: false

Gäller endast för servrar som använder lokal autentisering. Ange till trueför att låta användare återställa sina lösenord med ett Glömt lösenord-alternativ på inloggningssidan.

filestore.empty_folders_reaper.enabled

Version: Lades till i 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2) och 2021.1.x. Standardvärdet ändrades till true i 2021.2.

Standardvärde: true

Aktiverar jobbet som ”erhåller” (raderar) tomma fillagringsplatser.

filestore_empty_folders_reap.frequency_s

Version: Lades till i 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2).

Standardvärde: 86400 (24 timmar)

Anger i minuter hur ofta jobbet som tar bort tomma fillagermappar ska köras.

features.Hyper_DisallowTDEPublishing

Version: Återgår som standard till true från och med version 2023.1.0. Inaktuell i Tableau Server 2024.2.

Standardvärde: true

Indikerar om användare kan ladda upp filer i formatet .tde. Det här formatet ersattes av formatet .hyper från och med version 10.5 av Tableau Server, men blockerades inte från uppladdning. Från och med version 2024.3 kan filer med .tde-format inte längre användas. Filerna konverterades automatiskt till formatet .hyper om en av flera åtgärder utfördes. Mer information finns i Extraktuppgradering till .hyper-format.

filestore.log.level

Version: tillagt i version 2020.3.0.

Standardvärde: info

Loggningsnivån för fillagret. Detta kan konfigureras dynamiskt, så om du bara ändrar detta behöver du inte starta om Tableau Server. Du hittar mer information i Ändra loggningsnivåer.

filestore.reapemptyfoldersholdoffms

Version: Lades till i 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2). Detta finns inte i version 2021.1.

Standardvärde: 300000 (5 minuter)

Anger i millisekunder tiden att vänta innan tomma fillagermappar tas bort.

floweditor.max_datafile_upload_size_in_kb

Version: tillagt i version 2020.4.

Standardvärde: 1048576

För Tableau Prep-flödet för webbredigering, max storlek för avgränsade textfiler (till exempel CSV eller TXT) som kan laddas upp till Tableau Server.

gateway.external_url

Version: Tillagt i version 2023.1

Standardvärde: Null

Krävs när OpenID Connect-autentisering (OIDC) är konfigurerad i TSM under installationen av Tableau Server eller med identitetspooler. Indikerar Tableau Server-webbadressen som används av identitetsprovidern för att omdirigera användare som autentiseras i Tableau. Webbadressen till den externa gateway:en är samma som den du angav som omdirigeringswebbadress med din identitetsprovider, som används för matchningsändamål.

Kör till exempel följande kommando för att omdirigera en identitetsprovider som är kopplad till OIDC-autentiseringskonfigurationen till Tableau Server med http://myco:

tsm configuration set -k gateway.external_url -v http://myco

gateway.http.hsts

Standardvärde: false

HSTS-huvudet (HTTP Strict Transport Security) tvingar webbläsare att använda HTTPS på den domän där det är aktiverat.

gateway.httpd.loglevel

Version: lades till i 2021.3.0.

Standardvärde: notice

Anger loggningsnivå för gatewayen (Apache HTTPD-server). Som standard är det här angett till notice. Andra alternativ innefattar debug, info, warning, error. Om du ändrar loggningsnivå bör du vara medveten om den potentiella inverkan på diskutrymmesanvändning och prestanda. Som bästa praxis bör du återställa loggningsnivån till standardvärdet efter att du fått den information du behöver. Detaljerad information om Apache-loggning finns i Apache HTTP-dokumentationen(Länken öppnas i ett nytt fönster).

gateway.httpd.shmcb.size

Version: tillagt i version 2021.4.

Standardvärde: 2048000

Anger mängden minne i byte för den cirkulära bufferten vid användning av lagringstypen shmcb. Den här konfigurationsnyckeln gäller inte när du använder lagringstypen dbm.

gateway.httpd.socache

Version: tillagt i version 2021.4.

Standardvärde: shmcb

Anger lagringstypen för global/inter-processens SSL-sessionscache. Som standard är det här angivet till shmcb, med det andra konfigurerbara alternativet dbm. Mer information om lagringstyperna shmcb och dbm finns i SSLSessionCache-direktivet(Länken öppnas i ett nytt fönster) på Apaches webbplats.

gateway.log.level

Version: tillagt i version 2020.3.0.

Standardvärde: info

Loggningsnivån för gatewayen. Detta kan konfigureras dynamiskt, så om du bara ändrar detta behöver du inte starta om Tableau Server. Du hittar mer information i Ändra loggningsnivåer.

hyper.log_queries

Standardvärde: true

När det angetts till true loggas frågeinformation.

Frågeinformation loggas som standard. Om du dock finner att loggfilerna är för stora för tillgänglig mängd diskutrymme så kan du ange det som false för att inaktivera loggning av frågeinformation. Tableau rekommenderar att du lämnar den här konfigurationen på true.

hyper.session_memory_limit

Standardvärde: 0 (vilket betyder obegränsat)

Styr max minnesförbrukning som en enskild fråga kan ha. Ange antalet byte. Lägg till bokstaven ”k” i värdet för att ange kilobyte, ”m” för megabyte, ”g” för gigabyte eller ”t” för terabyte.

Om du till exempel vill ställa in minnesgränsen till 900 megabyte kör du följande kommando:

tsm configuration set -k hyper.session_memory_limit -v 900m.

Alternativt kan du ange minnesgränsen som en procentsats av totalt tillgängligt systemminne genom att köra följande kommando:

tsm configuration set -k hyper.session_memory_limit -v 90%.

Om du sänker det här värdet kan det hjälpa med när en fråga använder överdrivna mängder minne och gör att andra frågor misslyckas över en lång tidsperiod. Genom att sänka gränsen misslyckas den enskilda stora frågan (eller spoolas om spooling inte avaktiverats) och ger ingen negativ inverkan på övriga frågor.

hyper.srm_cpu_limit_percentage

Standardvärde (i procent): 75

Anger den maximala genomsnittliga CPU-användningen per timme som tillåts av Hyper. Om värdet överskrids startar datamotorn om sig själv för att minimera inverkan på andra processer på datorn.

Som standard startar datamotorn om sig själv om den i genomsnitt använder mer än 75 % av processorns resurser under en timme. Det här värdet bör inte ändras förutom när du arbetar med Tableau Support eller kör datamotorn på en dedikerad servernod. Om datamotorn körs på en dedikerad nod kan det här värde säkert ökas till 95 procent för att dra full nytta av tillgänglig hårdvara. Se Optimera för extraktfrågeintensiva miljöer för mer information om hur datamotorn körs på en dedikerad nod.

För att öka detta till 95 %:

tsm configuration set -k hyper.srm_cpu_limit_percentage -v 95 --force-keys

tsm pending-changes apply

Så återställer du detta till standardvärdet på 75 %:

tsm configuration set -k hyper.srm_cpu_limit_percentage -v 75 --force-keys

tsm pending-changes apply

hyper_standalone.consistent_hashing.enabled

Standardvärde: true

Förbättrar chansen att extraktet för en fråga redan cachelagrats. Om noden med extraktet cachelagrats och inte kan stödja ytterligare belastning kommer du att routas till en ny nod och extraktet läsas in i cacheminnet på den nya noden. Det ger bättre systemanvändning eftersom extrakt endast läses in i minnet om det finns en belastning som berättigar behovet.

indexandsearchserver.vmopts

Version: tillagt i version 2022.1.

Standardvärde: -Xmx<default_value> -Xms<default_value>

Standardvärdet baseras på mängden minne i systemet och är 3,125 % av systemets totala RAM-minne.

Styr heapstorlek för index- och sökserver. Eftersom standardvärdet skalas automatiskt bör du bara använda det här alternativet för att åsidosätta standardvärdet om det är absolut nödvändigt. Lägg till bokstaven ”k” i värdet för att ange kilobyte, ”m” för megabyte eller ”g” för gigabyte. En allmän regel är att ange den inledande heapstorleken (-Xms) till samma som den maximala heapstorleken (-Xmx) för att minimera skräpinsamling.

jmx.security.enabled

Version: tillagt i version 2022.1.

Standardvärde: false

JMX är inaktiverat som standard så säker JMX är också inaktiverat. Om du aktiverar JMX rekommenderar vi starkt att du även aktiverar säker JMX.

Det här anges till true och aktiverar säker JMX med SSL och grundläggande autentisering med användarnamn/lösenord för skrivskyddad åtkomst när du kör kommandot tsm maintenance jmx enable och svarar y vid uppmaning att aktivera säkerhetsfunktioner för JMX:

tsm maintenance jmx enable
We do not recommend you enable JMX unsecured on a production environment. Would you like to enable security features for JMX?
(y/n): y

jmx.ssl.enabled

Version: tillagt i version 2022.1.

Standardvärde: true

Upprätthåller SSL för JMX. Det här alternativet är som standard true men har ingen effekt om inte jmx.security.enabled är också satt till true. Kör kommandot tsm maintenance jmx enable för att aktivera JMX. Svara y när du uppmanas att lämna SSL aktiverat eller n för att inaktivera SSL:

tsm maintenance jmx enable
...
Would you like to enable SSL?
(y/n): n

jmx.ssl.require_client_auth

Version: tillagt i version 2022.1.

Standardvärde: false

Det här anges som true när du kör kommandot tsm maintenance jmx enable och svarar y vid uppmaning att kräva klientautentisering (mTLS):

tsm maintenance jmx enable
...
Would you like to require client authentication (mTLS)?
(y/n): y

För att slutföra konfigurationen måste du ha ett klientcertifikat och placera det på rätt plats på klientdatorn.

jmx.ssl.user.name

Version: tillagt i version 2022.1.

Standardvärde: tsmjmxuser

Detta anges när du installerar eller uppgraderar Tableau Server.

jmx.ssl.user.password

Version: tillagt i version 2022.1.

Standardvärde: <generated>

Detta anges när du installerar eller uppgraderar Tableau Server.

jmx.user.access

Version: tillagt i version 2022.1.

Standardvärde: readonly

Du kan ändra det här till readwrite när du kör kommandot tsm maintenance jmx enable och svarar y när du uppmanas att lägga till readwrite -åtkomst:

tsm maintenance jmx enable
...
JMX access is readonly by default. Would you like to add readwrite access?
(y/n): y

licensing.login_based_license_management.default_requested_duration_seconds

Standardvärde: 0

Ange varaktighet (i sekunder) som en användares inloggningsbaserade licens kan vara offline utan anslutning till Tableau Server innan de uppmanas att aktivera igen. Den här varaktigheten uppdateras alltid när Tableau Desktop används och kan ansluta till Tableau Server.

licensing.login_based_license_management.enabled

Standardvärde: true

Ange till sant för att aktivera inloggningsbaserad licenshantering. Ange till falskt för att inaktivera inloggningsbaserad licenshantering.

Obs! Om du vill använda inloggningsbaserad licenshantering måste du aktivera en produktnyckel som det här är aktiverat för inloggningsbaserad licenshantering. Du kan använda tsm licenses list för att se vilka produktnycklar som har inloggningsbaserad licenshantering aktiverat.

licensing.login_based_license_management.max_requested_duration_seconds

Standardvärde: 7776000

Ange till max varaktighet (i sekunder) som en användares inloggningsbaserade licens kan vara offline utan anslutning till Tableau Server innan de uppmanas att aktivera Tableau igen. Maxvärde är 7776000 sekunder (90 dagar). Den här varaktigheten uppdateras alltid när Tableau Desktop används och kan ansluta till Tableau Server.

metadata.ingestor.blocklist

Standardvärde: null

När det konfigurerats blockerar Tableau Catalog angivet innehåll från att inmatas. Om du vill specificera vilket innehåll du vill blockera måste du identifiera blocklistevärdena som är en kombination av både plats-ID, innehållstyp och innehålls-ID för det innehåll du vill blockera från serverns icke-interaktiva loggfiler. Blocklistevärden måste avgränsas med komma.

Viktigt: du får endast använda det här alternativet när du blivit instruerad att göra det av Tableau Support.

Du kan till exempel använda tsm configuration set --force-keys -k metadata.ingestor.blocklist för att blockera inmatning av en kombination av datakällor, arbetsbökcer och flöden med följande kommando:

tsm configuration set --force-keys -k metadata.ingestor.blocklist -v "sites/1/datasources/289, sites/2/datasources/111, sites/1/workbooks/32, sites/3/workbooks/15, sites/1/flows/13, sites/1/flows/18”

Validera blockerat innehåll genom att granska serverns icke-interaktiva filer för följande händelser:

• Skipping ingestion for
• Successfully updated blocklist to

Till exempel:

Skipping ingestion for contentType [Workbook], contentId [sites/1/datasources/289], siteDisabled [false], swallowEvent [false], contentBlocked [true]

Skipping ingestion for contentType [Workbook], contentId [sites/3/workbooks/15], siteDisabled [false], swallowEvent [false], contentBlocked [true]

och

Successfully updated blocklist to: [sites/1/datasources/289, sites/1/workbooks/32, sites/2/datasources/111]

metadata.ingestor.pipeline.throttleEventsEnable

Standardvärde: false

Styr om indexering av nytt och uppdaterat innehåll, vilket även kallas eventing, regleras för alla platser på servern. Som standard är händelsebegränsning inaktiverat. Aktivera händelsebegränsning genom att ändra den här inställningen till true med hjälp av följande kommando: 

tsm configuration set -k metadata.ingestor.pipeline.throttleEventsEnable -v true --force-keys

Mer information om händelsebegränsning finns i Aktivera Tableau Catalog.

metadata.ingestor.pipeline.throttleLimit

Standardvärde: 20

När händelsebegränsning är aktiverat är det här det maximala antalet nya och uppdaterade innehållsobjekt som kan indexeras under en angiven tidsperiod. När den angivna gränsen har uppnåtts för ett specifikt objekt skjuts indexering upp.

Som standard är gränsen satt till 20 och kan inte anges som lägre än 2. Du kan använda följande kommando för att ändra gränsen: 

tsm configuration set -k metadata.ingestor.pipeline.throttleLimit -v 25 --force-keys

Begränsade händelser kan identifieras i serverns icke-interaktiva loggfiler som ingestor event flagged for removal by throttle filter.

metadata.ingestor.pipeline.throttlePeriodLength

Standardvärde: 20

När händelsebegränsning har aktiverats är det här den tidsperiod i minuter som ett angivet maxantal nya och uppdaterade innehållsobjekt kan indexeras. När den angivna tiden uppnås skjuts indexering av ytterligare nytt och uppdaterat innehåll upp.

Som standard är tiden satt till 30 minuter. Du kan använda följande kommando för att ändra tiden:

tsm configuration set -k metadata.ingestor.pipeline.throttlePeriodLength -v PT45M --force-keys

metadata.query.limits.time

Standardvärde: 20

Detta är den längsta tillåtna tid i sekunder som en Catalog- eller Metadata-API-fråga kan köra innan en timeout inträffar och frågan avbryts. Tableau rekommenderar att du inkrementellt ökar timeoutgränsen till högst 60 sekunder med hjälp av följande kommando:

tsm configuration set -k metadata.query.limits.time –v PT30S --force-keys

Viktigt: Det här alternativet bör bara ändras om du råkar ut för det fel som beskrivs här, Meddelanden om överskriden tidsgräns och nodgräns. Om du ökar timeoutgränsen kan det förbruka mer processorkraft under längre tid, vilket kan påverka prestandan för uppgifter på Tableau Server. Om du ökar timeouten kan det även leda till högre minnesanvändning vilket kan skapa problem med interaktiva mikrotjänstbehållare när frågor körs parallellt.

metadata.query.limits.count

Standardvärde: 20000

Det här är det antal objekt (vilka löst mappar till antalet frågeresultat) som Catalog kan returnera innan nodgränsen överskrids och frågan abryts. Tableau rekommenderar , att du inkrementellt ökar timeoutgränsen till högst 100 000 med hjälp av följande kommando:

tsm configuration set -k metadata.query.limits.count –v 3000 --force-keys

Viktigt: Det här alternativet bör bara ändras om du råkar ut för det fel som beskrivs här, Meddelanden om överskriden tidsgräns och nodgräns. Om du ökar nodgränsen kan det leda till högre minnesanvändning vilket kan skapa problem med interaktiva mikrotjänstbehållare när frågor körs parallellt.

metadata.query.throttling.enabled

Version: tillagt i version 2023.3

Standardvärde: true

Styr om frågebegränsning för metadata-API(Länken öppnas i ett nytt fönster) är aktiverat. Frågebegränsning för metadata-API är en funktion som är tänkt att förhindra att en servers API-svar påverkar den övergripande prestandan negativt. När detta är angett som true (standard), och om en begäran till metadata-API:et överskrider den definierade tröskeln, returneras ett RATE_EXCEEDED-fel.

Om de som använder metadata-API:et ofta råkar ut för RATE_EXCEEDED-fel, så kan en administratör försöka justera begränsningen med inställningarna metadata.query.throttling.tokenRefilledPerSecond och metadata.query.throttling.queryCostCapacity. Administratören kan också inaktivera begränsning helt genom att ställa in värdet metadata.query.throttling.enabled på false. Detta skulle emellertid innebära att funktionens prestandaförbättrande verkan sätts ur spel.

metadata.query.throttling.queryCostCapacity

Version: tillagt i version 2023.3

Standardvärde: 20000000

Ett tal som representerar metadata-API:ets(Länken öppnas i ett nytt fönster) kapacitet att besvara frågor. Varje begäran till metadata-API:et har en beräknad kostnad som subtraheras från detta tal vid körning. (Om du använder en modell med tokenhink är detta det högsta antal token som kan finnas i hinken.)

Om de som använder metadata-API:et ofta råkar ut för RATE_EXCEEDED-fel, så kan en administratör justera begränsningsinställningarna. Denne bör då ändra metadata.query.throttling.tokenRefilledPerSecond och testa resultatet innan metadata.query.throttling.queryCostCapacity ändras. Administratören kan också inaktivera begränsning helt genom att ställa in metadata.query.throttling.enabled på false. Detta skulle emellertid innebära att funktionens prestandaförbättrande verkan sätts ur spel.

metadata.query.throttling.tokenRefilledPerSecond

Version: tillagt i version 2023.3

Standardvärde: 5555

Ett tal som representerar hur stor del av metadata-API:ets(Länken öppnas i ett nytt fönster) frågekapacitet som återskapas varje sekund. (Om du använder en modell med tokenhink är detta antalet token som hamnar i hinken varje sekund.)

Om de som använder metadata-API:et ofta råkar ut för RATE_EXCEEDED-fel, så kan en administratör justera begränsningsinställningarna. Denne bör då ändra metadata.query.throttling.tokenRefilledPerSecond och testa resultatet innan metadata.query.throttling.queryCostCapacity ändras. Administratören kan också inaktivera begränsning helt genom att ställa in metadata.query.throttling.enabled på false. Detta skulle emellertid innebära att funktionens prestandaförbättrande verkan sätts ur spel.

native_api.allowed_paths

Standardvärde: ""

Obs! I Tableau Server-versioner (inklusive underhållsversioner) före oktober 2023 var den här inställningen konfigurerad till att som standard tillåta åtkomst till alla sökvägar.

Använd den här inställningen för att skapa en godkännandelista för åtkomst till filer lagrade på Tableau eller på fjärrresurser. Med detta scenario kan auktoriserade Tableau Server-användare skapa arbetsböcker som använder filer på servern som filbaserade datakällor (till exempel kalkylblad).

Med den här inställningen kan du begränsa åtkomsten endast till de kataloger som du anger. Åtkomsten Kör som tjänst-konto är därför begränsad till katalogsökvägarna där du lagrar datafiler.

Viktigt! Se till att filsökvägarna som du anger i den här inställningen finns och är tillgängliga för systemkontot.

native_api.ExplainDataEnabled

Standardvärde: true

Alternativet styr om Förklara data är aktiverat eller inaktiverat för servern. Mer information om Fråga data finns i Kom igång med Förklara data(Länken öppnas i ett nytt fönster) i Tableau-hjälpen.

Det här alternativet lades till i Tableau Server version 2019.3.

nlp.concepts_shards_count

Standardvärde: 1

Obs! Standardantalet skärvor är tillräckligt för de flesta Tableau Server-installationer.

Styr antalet dataskärvor för Concepts-indexet i Fråga data, fältnamn, fältsynonymer och analystermer som lagras i skärvor i:

• Indexerings- och sökservern för 2022.1 och senare versioner.
• Elastic Server för 2019.1–2021. 4

Antalet skärvor partitionerar sökindexet för att minska den totala indexstorleken, vilket kan förbättra resultatet för den semantiska tolken i Fråga data. Du kan förbättra prestanda genom att ändra antalet skärvor och öka heapstorleken med elasticserver.vmopts eller indexandsearchserver.vmopts, beroende på vilken version av Tableau Server du kör.

Tableau rekommenderar att du ökar antalet skärvor med 1 för varje 50 GB. För att du ska slippa justera antalet skärvor alltför ofta kan du beräkna den totala indexstorleken genom att lägga till 50 % till det aktuella indexet. Om den totala indexstorleken till exempel är mindre än 50 GB räcker det med 1 skärva. Faktiska prestanda varierar beroende på servern, tillväxttakten för indexet och andra faktorer.

• 0 till 50 GB: 1
• 50 GB till 100 GB: 2
• 100 GB till 150 GB: 3

Du kan använda följande kommando för att öka antalet skärvor i Concepts-indexet från standardvärdet till 2:

tsm configuration set -k nlp.concepts_shards_count -v 2

nlp.values_shards_count

Standardvärde: 1

Styr antalet dataskärvor för Concepts-indexet i Fråga data, fältnamn, fältsynonymer och analystermer som lagras i skärvor i:

• Indexerings- och sökservern för 2022.1 och senare versioner.
• Elastic Server för 2019.1–2021. 4

Antalet skärvor partitionerar sökindexet för att minska den totala indexstorleken, vilket kan förbättra resultatet för den semantiska tolken i Fråga data. Du kan förbättra prestanda genom att ändra antalet skärvor och öka heapstorleken med elasticserver.vmopts eller indexandsearchserver.vmopts, beroende på vilken version av Tableau Server du kör.

Tableau rekommenderar att du ökar antalet skärvor med 1 för varje 50 GB. För att du ska slippa justera antalet skärvor alltför ofta kan du beräkna den totala indexstorleken genom att lägga till 50 % till det aktuella indexet. Om den totala indexstorleken till exempel är mindre än 50 GB räcker det med 1 skärva. Faktiska prestanda varierar beroende på servern, tillväxttakten för indexet och andra faktorer.

• 0 till 50 GB: 1
• 50 GB till 100 GB: 2
• 100 GB till 150 GB: 3

Du kan använda följande kommando för att öka antalet skärvor i Values-indexet från standardvärdet till 2:

tsm configuration set -k nlp.values_shards_count -v 2

nlp.defaultNewSiteAskDataMode

Standardvärde: disabled_by_default

Använd det här alternativet för att ange det initiala värdet för Fråga data-läge när en webbplasts skapas. Mer information finns i Inaktivera eller aktivera Fråga data för en webbplats.

Giltiga alternativ är disabled_by_default och disabled_always.

Det här alternativet lades till från och med Tableau Server version: 2019.4.5, 2020.1.3.

noninteractive.vmopts

pgsql.port

Standardvärde: 8060

Port som PostgreSQL lyssnar på.

pgsql.preferred_host

Anger datornamn för noden med den föredragna lagringsplatsen installerad. Det här värdet används om alternativet --preferred or -r anges med kommandot tsm topology failover-repository.

Exempel:

pgsql.ssl.ciphersuite

Standardvärde: HIGH:MEDIUM:!aNULL:!MD5:!RC4

Anger de chifferalgoritmer som tillåts för SSL för lagringsplatsen.

Du hittar godkända värden och formateringskrav i ssl_ciphers(Länken öppnas i ett nytt fönster) på Postgres-webbplatsen.

pgsql.ssl.max_protocol_version

Standardvärde: TLSv1.3

Ställer in den maximala versionen av SSL/TLS-protokoll som ska användas vid anslutning till lagringsplatsen via SSL.

Giltiga värden: TLSv1, TLSv1.1, TLSv1.2 och TLSv1.3

pgsql.ssl.min_protocol_version

Standardvärde: TLSv1.2

Ställer in den minsta versionen av SSL/TLS-protokoll som ska användas vid anslutning till lagringsplatsen via SSL.

Giltiga värden: TLSv1, TLSv1.1, TLSv1.2 och TLSv1.3

pgsql.verify_restore.port

Standardvärde: 8061

Porten användes för att verifiera integriteten för PostgreSQL-databasen. Se tsm maintenance backup för mer information.

ports.blocklist

Version: tillagt i version 2021.1.

Standardvärde: inga portar blockerade i det intervall som används för automatisk porttilldelning.

Används för att ange portar inom det porttilldelningsintervall som inte ska användas av Tableau vid automatisk tilldelning av portar. Det är anändbart när du vet att ett annat program använder en port inom intervallet. Avgränsa flera portar med komma, till exempel:

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

Mer information om att använda nyckeln ports.blocklist finns i Blockera specifika portar i intervallet

recommendations.enabled

Standardvärde: true

Styr rekommendationer-funktionen som driver rekommendationer för datakällor och tabeller (för Tableau Desktop) och rekommendationer för vyer (för Tableau Server). Rekommendationerna bygger på innehållets popularitet och på innehåll som används av andra användare som bedöms likna den aktuella användaren.

searchserver.connection_timeout_milliseconds

Version: tillagt i version 2019.1. Inaktuell i version 2022.3. Utfasad i version 2023.3.

Standardvärde i millisekunder: 100000

Anger tidsmängden i millisekunder som Sök och bläddra väntar på att upprätta en anslutning till Sök och bläddra-servern.

På Tableau Server-datorer med särskilt hög belastning eller om du ser loggfel av typen ”Det gick inte att köra Zookeepers hälsokontroll. SOLR startas inte.” ökar du det här värdet.

Du hittar mer information i Tidsgränser för klientsession.

searchserver.index.bulk_query_user_groups

Version: utfasad i version 2022.3.

Standardvärde: true

Anger om frågor om platsanvändare sker i grupp vid import eller borttagning av användare med en CSV-fil. När alternativet är satt till true (standardvärdet) sker indexering i grupp.

searchserver.javamemopts

Version: tillagt i version 2019.1. Utfasad i 2023.3

Standardvärde: -Xmx512m -Xms512m -XX:+ExitOnOutOfMemoryError -XX:-UsePerfData

Fastställer JVM-alternativ för SOLR.

Av alla konfigurerbara alternativ är max heap-minnne som konfigureras av parametern -Xmx den viktigaste vid inställning av sökservern. I de flesta fall bör det här anges så högt som möjligt, upp till 24 GB baserat på tillgängligt fysiskt minne på Tableau Server-datorn. Om du bara vill ändra max heapminne anger du hela standardstränen men ändrar bara värdet för -Xmx.

Giltiga värden för -Xmx beror på tillgängligt minne på Tableau Server-datorn men kan inte vara mer än 24 GB. Mer information finns i Sök och bläddra i Maximalt heapminne.

searchserver.startup.zookeeper_healthcheck_timeout_ms

Version: tillagt i version 2020.1. Utfasad i version 2023.3.

Standardvärde i millisekunder: 300000

Anger mängden tid i millisekunder som Tableau Server ska vänta på en lyckad Zookeeper-hälsokontroll vid start.

På Tableau Server-datorer med särskilt hög belastning eller om du ser loggfel av typen ”Det gick inte att köra Zookeepers hälsokontroll. SOLR startas inte.” ökar du det här värdet.

Mer information finns i Hälsokontroll av Zookeeper-anslutningens tidsgräns vid start.

searchserver.zookeeper_session_timeout_milliseconds

Version: utfasad i version 2022.3.

Standardvärde i millisekunder: 100000

Anger tidsmängden i millisekunder som Sök och bläddra-klienter väntar på att upprätta en anslutning till Coordination Service (Zookeeper).

Du hittar mer information i Tidsgränser för klientsession.

ServerExportCSVMaxRowsByCols

Version: tillagt i version 2020.3.

Standardvärde: 0 (ingen gräns)

Anger max antal celler data som kan laddas ner från Visa data till en CSV-fil. Som standard finns ingen gräns. Ange antalet celler. Om du till exempel vill ange en gräns på 3 miljoner: 

tsm configuration set -k ServerExportCSVMaxRowsByCols -v 3000000 

tsm pending-changes apply

ssl.ciphersuite

Standardvärde: HIGH:MEDIUM:!EXP:!aNULL:!MD5:!RC4:!3DES:!CAMELLIA:!IDEA:!SEED

Anger de chifferalgoritmer som tillåts för SSL för gateway.

Du hittar godkända värden och formateringskrav i SSLCipherSuite(Länken öppnas i ett nytt fönster) på Apaches webbplats.

ssl.client_certificate_login.blocklisted_signature_algorithms

Standardvärde:

• Version 2020.4.0: 

  sha1withrsaencryption,
sha1withrsa

• Version 2020.4.1 och senare:

  sha1withrsaencryption,
sha1withrsa,
sha1withrsaandmgf1,
sha1withdsa,
sha1withecdsa

Standardvärdet blockerar certifikat med SHA-1 signeringsalgoritmen. Anger de klientsigneringsalgoritmer som blockeras för SSL. Inaktivera blcokering av alla signeringsalgoritmer genom att köra nyckeln med en tom uppsättning citattecken.

Mer information om den här nyckeln finns i kunskapsbasartikeln, Ömsesidig SSL misslyckas efter uppgradering om certifikat signeras med SHA-1(Länken öppnas i ett nytt fönster).

ssl.client_certificate_login.min_allowed.elliptic_curve_size

Standardvärde: 256

Anger den minsta elliptiska kurvstorlek som krävs för ECDSA-klientcertifikat som autentiserar med Tableau Server över ömsesidig SSL. Om en klient uppvisar ett ECDSA-klientcertifikat som inte tillfredsställer denna minsta kurvstorlek så misslyckas autentiseringsbegäran.

Det här alternativet lades till i Tableau Server version 2021.1.

ssl.client_certificate_login.min_allowed.rsa_key_size

Standardvärde: 2048

Anger den minsta nyckelstorleken för RSA-klientcertifikat som autentiserar med Tableau Server över ömsesidig SSL. Om en klient uppvisar ett RSA-klientcertifikat som inte tillfredsställer denna minsta nyckelstorlek så misslyckas autentiseringsbegäran.

Det här alternativet lades till i Tableau Server version 2021.1.

ssl.protocols

Standardvärde: all +TLSv1.2 -SSLv2 -SSLv3 -TLSv1.3

Anger de SSL-protokoll som Tableau Server stödjer för TLS-anslutningar för gateway. Godkända värden härstammar från Apache SSLProtocol-direktivet(Länken öppnas i ett nytt fönster). Vi rekommenderar följande SSL-protokollkonfiguration som den beskrivs i Checklista för säkerhetsförstärkning.

storage.monitoring.email_enabled

Standardvärde: false

Styr om e-postaviseringar är aktiverade för övervakning av diskutrymme på servern. Som standard är e-postaviseringar aktiverade. Om du vill aktivera aviseringar för övervakning av diskutrymme på servern så anger du det här till true.

SMTP måste vara konfigurerat för att skicka aviseringar. Du hittar mer information i Konfigurera SMTP-inställningar.

storage.monitoring.warning_percent

Standardvärde: 20

Varningströskelvärdet för kvarvarande diskutrymme i procentandel totalt diskutrymme. Om diskutrymmet faller under detta tröskelvärde skickas ett varningsmeddelande.

storage.monitoring.critical_percent

Standardvärde: 10

Kritiskt tröskelvärde för kvarvarande diskutrymme i procentandel totalt diskutrymme. Om diskutrymmet faller under detta tröskelvärde skickas ett kritiskt meddelande.

storage.monitoring.email_interval_min

Standardvärde: 60

Hur ofta, i minuter, som e-postaviseringar ska skickas när övervakning av diskutrymme är aktiverat och ett tröskelvärde överskrids.

storage.monitoring.record_history_enabled

Standardvärde: true

Fastställer om historik över ledigt diskutrymme sparas och finns tillgängligt för visning i Administratörsvyer. Inaktivera övervakning av lagringshistorik genom att ange storage.monitoring.record_history_enabled till false.

svcmonitor.notification.smtp.enabled

Standardvärde: false

Styr om e-postaviseringar är aktiverade för serverprocesshändelser. Som standard skickas aviseringar när processer slutar fungera, redundansväxlas eller startas om. Om du vill aktivera aviseringar om serverprocesser så anger du det här till true.

SMTP måste vara konfigurerat för att skicka aviseringar. Du hittar mer information i Konfigurera SMTP-inställningar.

svcmonitor.notification.smtp.mime_use_multipart_mixed

Version: Lades till i version: 2020.1.8, 2020.2.5, 2020.3.1

Standardvärde: false

Styr om prenumerationens HTML MIME-bilagor skickas som multipart/related (standard) eller multipart/mixed.

I sällsynta fall kan det hända att e-postklienter inte analyserar e-postmeddelanden, som har skickats av Tableau Server, på ett korrekt sätt. Oftast kan detta åtgärdas genom att ställa in den här egenskapen till true. Kända klienter inkluderar iOS Mail och Microsoft Outlook (när de är parkopplade med Exchange S/MIME-kryptering).

tabadmincontroller.auth.expiration.minutes

Standardvärde: 120

Styr hur länge sessionscookies är giltiga. Detta är inställt på 120 minuter som standard. Det här värdet fastställer även hur länge inbäddade inloggningsuppgifter i en nods startfil är giltiga. Du hittar mer information i tsm topology nodes get-bootstrap-file.

tdsservice.log.level

Version: tillagt i version 2020.3.0.

Standardvärde: info

Loggningsnivå för tjänst för datakällsegenskaper. Detta kan konfigureras dynamiskt, så om du bara ändrar detta behöver du inte starta om Tableau Server. Du hittar mer information i Ändra loggningsnivåer.

tomcat.useSystemProxies

Standardvärde: false

Anger om tomcat-komponenter (OpenID) kräver tillgång till konfiguration för proxy för vidarebefordran på det lokala Windows-operativsystemet. Läs mer i Konfigurera Tableau Server för OpenID Connect.

tomcatcontainer.log.level

Standardvärde: info

Loggningsnivån för mikrotjänster i den interaktiva mikrotjänstbehållaren och icke-interaktiva mikrotjänstbehållaren. Detta kan konfigureras dynamiskt från och med version 2020.4, så om du bara ändrar detta behöver du inte starta om Tableau Server. Du hittar mer information i Ändra loggningsnivåer.

tsm.log.level

Standardvärde: info

Loggningsnivå för TSM-tjänster. Dessa loggar inkluderar information som kan vara till hjälp om du har problem med TSM-tjänster: administrationsagent, administrationsstyrenhet, klientfiltjänst, Cluster Controller, servicehanteraren och licenstjänsten. Den här konfigurationsnyckeln ändrar inte loggningsnivå för Coordination Service eller för underhållsprocesser. Mer information finns i Ändra loggningsnivåer och Tableau Server-processer.

tsm.controlapp.log.level

Standardvärde: info

Loggningsnivå för control_<app>-tjänster. Dessa loggar inkluderar information som kan vara till hjälp om du stöter på problem med att starta eller konfigurera om en TSM- eller Tableau Server-process. Du hittar mer information i Ändra loggningsnivåer.

usernotifications.reap_after_days

Standardvärde: 30

Antal dagar efter vilket ett användarmeddelande tas bort från servern.

vizportal.adsync.update_system_user

Standardvärde: false

Anger om e-postadresser och visningsnamn för användare ändras (även när de ändras i Active Directory) när en Active Directory-grupp synkroniseras i Tableau Server. Om du vill se till att användares e-postadresser och visningsnamn uppdateras under synkronisering anger du vizportal.adsync.update_system_user till true och startar därefter om servern.

vizportal.alwaysUseEmbeddedShareLinks

Version: tillagt i version 2021.3.0.

Standardvärde: false

Anger om alternativet Kopiera länk ska inkludera parametern embed=y. Från och med version 2019.4 inkluderar den inte den här parametern som standard. Om du anger den här konfigurationsnyckeln till sant ändras beteendet så att parametern embed=y ingår. Information om hur du använder alternativet Kopiera länk för att dela länkar för inbäddning i webbsidor finns i Bädda in vyer i webbsidor(Länken öppnas i ett nytt fönster) i hjälpen för Tableau Desktop och webbredigering.

vizportal.art_skip_list

Version: tillagt i version 2024.2.

Standardvärde: null

Använd den här konfigurationsnyckeln för att specificera aspekter av Tableau Server-funktioner som inte använder ART (Activity and Resource Tracing) och som genererar stora mängder onödiga data medan ART är aktiverat.

Denna nyckel används tillsammans med vizportal.log_art_java och vizportal.enable_art för felsökning av problem med Application Server (VizPortal). När den är inställd på [need info here about what it gets set to.] Information om hur du använder den här konfigurationsinställningen finns i Felsöka problem med Application Server.

vizportal.csv_user_mgmt.index_site_users

Version: inaktuell i version 2022.3 Utfasad (helt borttagen) i version 2023.3.

Standardvärde: true

Anger om indexering av platsanvändare sker per användare vid import eller borttagning av användare med en CSV-fil. När det angetts till true(standardvärdet) sker indexering allteftersom varje användare läggs till eller tas bort. Om du vill fördröja indexering av platsanvändare tills dess att hela CSV-filen bearbetats anger du detta till false.

vizportal.csv_user_mgmt.bulk_index_users

Version: inaktuell i version 2022.3 Utfasad (helt borttagen) i version 2023.3.

Standardvärde: false

Anger om indexering om platsanvändare sker i grupp vid import eller borttagning av användare med en CSV-fil. När alternativet är satt till false (standardvärdet) sker indexering individuellt. För att indexering ska ske i grupp efter att CSV-filen har bearbetats ska alternativet ställas in till true.

vizportal.enable_art

Version: tillagt i version 2024.2.

Standardvärde: false

Denna konfigurationsnyckel används tillsammans med vizportal.log_art_java och vizportal.art_skip_list för felsökning av problem med Application Server (VizPortal). När den är inställd på sant aktiveras ART i Application Server. Information om hur du använder den här konfigurationsinställningen finns i Felsöka problem med Application Server.

vizportal.log_art_java

Version: tillagt i version 2024.2.

Standardvärde: false

Denna konfigurationsnyckel används tillsammans med vizportal.enable_art och vizportal.art_skip_list för felsökning av problem med Application Server (VizPortal). När den är inställd på sant aktiveras ART i Application Server. Information om hur du använder den här konfigurationsinställningen finns i Felsöka problem med Application Server.

vizportal.oauth.connected_apps.max_expiration_period_in_minutes

Version: tillagt i version 2021.4.

Standardvärde: 10

Den maximala tidsperiod, i minuter, som JSON-webbtoken (JWT) är giltig. När JWT verifieras kontrollerar Tableau Server att den tidsperiod som angetts i JWT inte överskrider det här standardvärdet. Den här inställningen används när ett Tableau-anslutet program har konfigurerats på Tableau Server med hjälp av Tableau REST API(Länken öppnas i ett nytt fönster).

Om du till exempel vill ändra maxperioden till 5 minuter kör du följande kommando:

tsm configuration set -k vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes -v 5

vizportal.oauth.external_authorization.enabled

Version: tillagt i version 2021.4.

Standardvärde: false

I Tableau Server 2024.2 och senare är alternativet Aktivera anslutna program aktiverat för Tableau Server. I Tableau Server 2023.2 och tidigare anger detta om alternativet Aktivera OAuth-åtkomst för inbäddat innehåll är aktiverat för Tableau Server.

Använd det här alternativet för att registrera en extern auktoriseringsserver (EAS) med Tableau Server, så att du kan aktivera programintegrering. Du hittar mer information i Konfigurera anslutna program med OAuth 2.0-förtroende.

Aktivera det här alternativet genom att köra följande kommando:

tsm configuration set -k vizportal.oauth.external_authorization.enabled -v true

vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms

Version: tillagt i version 2021.4.

Standardvärde: ES256K

När en extern auktoriseringsserver (EAS) registreras eller ett anslutet program konfigureras kan du använda detta kommando för att ange den signeringsalgoritm som används i sidhuvudet för JSON-webbtoken (JWT). Mer information finns i Konfigurera anslutna program med OAuth 2.0-förtroende eller Använda Tableau-anslutna appar för programintegrering.

Vid behov kan du till exempel köra följande kommandot för att ta bort algoritmen:

tsm configuration set - k vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms -v

Viktigt: exempelkommandot ovan tillåter osäkra signeringsalgoritmer och ska endast användas för att felsöka fel.

vizportal.oauth.external_authorization_server.issuer

Version: tillagt i version 2021.4.

Standardvärde: null

Obligatoriskt. Använd det här kommandot för att ange utgivar-URL. Utgivar-URL krävs för att registrera den externa auktoriseringsservern (EAS) med Tableau Server. Du hittar mer information i Konfigurera anslutna program med OAuth 2.0-förtroende.

Om din EAS till exempel är Okta, kanske du kör ett kommando som liknar följande:

tsm configuration set -k vizportal.oauth.external_authorization_server.issuer -v "https://dev-12345678.okta.com/oauth2/abcdefg9abc8eFghi76j5"

vizportal.oauth.external_authorization_server.jwks

Version: tillagt i version 2021.4.

Standardvärde: null

När en extern auktoriseringsserver (EAS) registreras kan du använda det här kommandot för att ange URL till JSON-webbnyckeluppsättningen (JWKS). JWKS-URL krävs om identitetsprovidern iinte exponerar metadataslutpunkten för den externa auktoriseringsservern.

Om din identitetsprovider till exempel är Amazon Cognito, kanske du kör ett kommando som liknar följande:

tsm configuration set -k vizportal.oauth.external_authorization_server.jwks -v "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_Ab129faBb/.well-known/jwks.json"

vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes

Version: tillagt i version 2021.4.

Standardvärde: 10

Den maximala tidsperiod, i minuter, som JSON-webbtoken (JWT) är giltig. När JWT verifieras kontrollerar Tableau Server att den tidsperiod som angetts i JWT inte överskrider det här standardvärdet. Den här inställningen används när EAS har registrerats med Tableau Server. Du hittar mer information i Konfigurera anslutna program med OAuth 2.0-förtroende.

Om du till exempel vill ändra maxperioden till 5 minuter kör du följande kommando:

tsm configuration set -k vizportal.oauth.external_authorization_server.max_expiration_period_in_minutes -v 5

vizportal.openid.full_server_request_logging_enabled

Standardvärde: false

Anger om fullständig loggning av OpenID-aktivitet ska utföras.

Ange det här som true vid felsökning av problem med OpenID Connect för att få mer detaljerade loggar och låta dig felsöka bättre.

Precis som med alla loggningsrelaterade konfigurationer så rekommenderar vi att du återställer nyckeln till standardvärdet (false) när du är klar med att felsöka och samla in loggar. Det här begränsar mängden information som loggas och håller loggfilstorlekarna till ett minimum.

vizportal.password_reset

Version: Ersätter features.PasswordReset i version 2024.2.

Standardvärde: false

Gäller endast för servrar som använder lokal autentisering. Ange till trueför att låta användare återställa sina lösenord med ett Glömt lösenord-alternativ på inloggningssidan.

vizportal.rest_api.cors.enabled

Standardvärde: false

Styr om Tableau Server tillåter resursdelning mellan ursprung (CORS). När det angetts till true, tillåter servern webbläsare åtkomst till Tableau REST API-slutpunkterna. Du kan använda det här alternativet och REST API för att skapa anpassade portaler. Som standard är den här funktionen inte aktiverad. Ange vilka ursprung (platser) som har åtkomst genom att använda alternativet vizportal.rest_api.cors.allow_origin. Endast de ursprung som anges med det här alternativet får göra begäranden till Tableau Server-REST API. Du hittar mer information i Aktivera CORS på Tableau Server.

vizportal.site_user_group_count_enabled

Version: Lades till i Version 2022.3.5 och senare, 2023.1.0 och senare.

Standardvärde: false

Reglerar om platsens användarsida ska innehålla en kolumn som visar gruppantalet för varje användare.

vizqlserver.force_maps_to_offline

Version: tillagt i version 2020.4.0.

Standardvärde: false

Fastställer om Tableau Server körs i offlineläge för kartor. Det är användbart i frånkopplade miljöer där åtkomst till internet och kartservern är begränsad. Aktivera offlineläge för kartor genom att ange det här värdet till true. Mer information om att installera och konfigurera Tableau Server i en miljö utan internetåtkomst finns i Installera Tableau Server i en frånkopplad miljö.

wgserver.authentication.legacy_identity_mode.enabled

Version: Tillagt i version 2022.1

Standardvärde: false för Tableau Server 2022.1 och senare. För Tableau Server-versioner före 2022.1 som uppgraderats till 2022.1 eller senare är standardvärdet true.

Inställt på false för att använda identitetspooler.

Mer information finns i Felsöka identitetspooler.

wgserver.authentication.identity_pools.default_pool_description

Version: Tillagt i version 2023.1

Standardvärde: Null

Alternativt kan en beskrivning läggas till för den initiala poolen (TSM-konfigurerad) på Tableau Server-landningssidan. Den är synlig för alla användare. När en eller flera identitetspooler skapas läggs den här beskrivningen till under det primära inloggningsalternativet. Den kan användas för att hjälpa användare, som tillhör den initiala poolen (TSM-konfigurerad), att hitta rätt inloggningsalternativ.

Följande kommando kan till exempel användas för att lägga till en beskrivning såsom ”Vanliga anställda ska logga in här”:

tsm configuration set -k wgserver.authentication.identity_pools.default_pool_description -v “Regular employees sign in here"

Obs! Beskrivningen av den initiala poolen (TSM-konfigurerad) skiljer sig från anmärkningen Anpassning av inloggning. Anmärkningen Anpassning av inloggning visas på Tableau Server-landningssidan under alla inloggningsalternativ och på sidan där användare av din initiala pool (TSM-konfigurerade) anger sitt användarnamn och lösenord.

wgserver.domain.accept_list

Version: det här lades till i version 2020.4.0 och ersätter wgserver.domain.whitelist.

Standardvärde: null

Tillåter anslutning från Tableau Server till sekundära Active Directory-domäner. En sekundär domän är en domän som Tableau Server ansluter till för användarsynkronisering, men där Tableau Server inte är installerat. Tableau Server försöker ansluta till sekundära domäner för synkronisering av användare och grupper. I vissa fall kan Tableau Server inte ansluta till den sekundära domänen vilket ger upphov till felet ”Domänen inte i listan över godkända (errorCode=101015).”

Inställning av alternativet wgserver.domain.accept_list krävs av en korrigering för säkerhetsrisken, [Viktigt] ADV-2020-003: Tableau Server-framtvingad autentisering(Länken öppnas i ett nytt fönster). Från och med februari 2020 ingår korrigeringen av den här sårbarheten i alla nya versioner och underhållsversioner av Tableau Server.

Om du vill ställa in det här alternativet anger du den sekundära domänen omgiven av dubbla citattecken. Flera domäner behöver avgränsas med ett komma och ett blanksteg. Till exempel tsm configuration set -k wgserver.domain.accept_list -v "example.org, domain.com".

Jokertecken stöds inte. Om Tableau till exempel ansluter till sub1.example.org och sub2.example.org så måste bägge domänerna läggas till.

Uppdatering av alternativet wgserver.domain.accept_list skriver över det befintliga värdet. Om du lägger till en ny domän till en befintlig uppsättning domäner som lagras i värdet behöver du därför inkludera alla befintliga domäner med den nya domänen när du anger alternativet. Du kan hämta den fullständiga listan med befintliga domäner genom att köra tsm configuration get –k wgserver.domain.accept_list.

wgserver.domain.allow_insecure_connection

Standardvärde: False

Den här inställningen gäller bara Windows. Det här alternativet anger om Tableau Server kommer att ansluta till Active Directory över en okrypterad kanal. Standardvärdet False framtvingar en krypterad kanal. Om LDAP-kanalen inte är krypterad kommer Tableau Server inte ansluta till Active Directory.

Active Directory-infrastrukturen bör hantera certifikat och förtroende med domänanslutna datorer. Då krypteras kanalkommunikationen mellan resurser i Tableau Server och Active Directory. Vi avråder bestämt från att tillåta okrypterad kommunikation med Active Directory, eftersom den konfigurationen är sårbar för man-i-mitten-attacker.

Om du uppgraderar till Tableau Server 2021.2 eller senare och din LDAP-kanal inte är krypterad så kommer din uppgradering att misslyckas. Du kan köra det här kommandot och tillåta en osäker anslutning till äldre versioner av Tableau Server innan du uppgraderar. Om du kör det här kommandot på en version tidigare än 2021.2 måste du inkludera alternativet --force-keys med kommandot.

wgserver.domain.fqdn

Standardvärde: värde för %USERDOMAIN%

Det fullständigt kvalificerade domännamnet för den Active Directory-server som ska användas.

wgserver.domain.password

Standardvärde: null

Anger lösenordet för det användarkonto som används för LDAP-anslutning. Se Konfigurationsreferens för externt identitetsregister.

wgserver.domain.username

Standardvärde: null

Anger namnet på det användarkonto som används för LDAP-anslutning. Se Konfigurationsreferens för externt identitetsregister.

wgserver.domain.whitelist

Viktigt: den här nyckeln är inaktuell från och med version 2020.4.0. Använd wgserver.domain.accept_list i stället.

Standardvärde: null

Tillåter anslutning från Tableau Server till sekundära Active Directory-domäner. En sekundär domän är en domän som Tableau Server ansluter till för användarsynkronisering, men där Tableau Server inte är installerat. Tableau Server försöker ansluta till sekundära domäner för synkronisering av användare och grupper. I vissa fall kan Tableau Server inte ansluta till den sekundära domänen vilket ger upphov till felet ”Domänen inte i listan över godkända (errorCode=101015).”

wgserver.ignore_domain_in_username_for_matching

Version: Tillagt i version 2021.4.21, 2022.1.17, 2022.3.9 och 2023.1.5

Standardvärde: false

När du aktiverar SAML kan du konfigurera Tableau Server att ignorera domändelen av SAML-användarnamnsattributet när identitetsproviderns användarnamn matchas till ett användarkonto på Tableau Server. Du kan ignorera domändelen av användarnamnsattributet om du redan har definierade användare i Tableau Server som matchar prefixdelen av ett användarnamnsattribut, men inte domändelen av användarnamnsattributet. Mer information finns i Ignorera domän när SAML-användarnamnsattribut matchas i avsnittet SAML-krav.

Om du till exempel vill ignorera domännamnet i SAML-användarnamnsattributet kör du följande kommando:

tsm configuration set -k wgserver.ignore_domain_in_username_for_matching -v true

Viktigt:

• Du bör inte ignorera domännamnet utan att vidta försiktighetsåtgärder. Mer specifikt bör du kontrollera att användarnamnen är unika i alla konfigurerade domäner som du har skapat i identitetsprovidern.
• Det här kommandot fungerar bara i Tableau Server-driftsättningar i legacy-identity-mode eller driftsättningar som inte har uppdaterats för att använda identitetstjänsten via identitetsmigrering(Länken öppnas i ett nytt fönster).

wgserver.saml.blocklisted_digest_algorithms

Version: tillagt i version 2021.1.

Standardvärde: SHA1

Anger de hashingalgoritmer som inte tillåts för några relevanta SAML-certifikatsignaturer eller SAML-intygssammanfattningsmetod eller signaturmetoder. När det angetts kommer certifikat eller intyg som signerats och hashats med en algoritm från blocklistan att avvisas och misslyckas.

Det finns flera ställen där SHA-1 kan användas på både Tableau- och identitetsprovidersidan. Till exempel:

• Certifikat som laddats upp med TSM som används av Tableau Server för att signera begäranden som skickas till identitetsprovidern.
• Certifikat i identitetsprovidermetadata som används för att verifiera det AuthnResponse (signatur) som tas emot från identitetsprovidern med hjälp av den offentliga nyckeln i certifikatetet.
• Inkommande intyg som signerats och hashats med SHA-1 (DigestMethod satt som SHA-1 och SignatureMethod satt som SHA-1).

Standardvärdet ändrades till SHA1 i Tableau Server 2021.2. Mer information om hur du uppgraderar till 2021.2 med SAML konfigurerat finns i Knowledge Base-artikeln Tableau Server Using SAML Authentication Fails to Start or Rejects Login After Upgrade to Tableau Server 2021.2.

wgserver.saml.forceauthn

Version: tillagt i version 2019.3.

Standardvärde: false

När det angetts som true återautentiserar Tableau Server användaren med identitetsprovidern om Tableau-användarsessionen går ut. Det här alternativet kan även användas för att säga till identitetsprovidern att be användaren återautentisera sig även om användaren har en aktiv identitetsprovidersession.

wgserver.saml.min_allowed.elliptic_curve_size

Standardvärde: 256

Version: lades till i version 2021.1 men inkluderade inget standardvärde. I version 2021.2 är standardvärdet 256.

Det här alternativet anger minsta tillåtna ECDSA-kurvstorlek för det certifikat som används för SAML-autentisering. Om du laddar upp ett certifikat som har en ECDSA-kurvstorlek som är mindre än 256 kommer TSM att logga ett fel när du tillämpar ändringar.

Om du uppgraderar till Tableau Server 2021.2 eller senare och ditt SAML-certifikat använder sig av en ECDSA-kurvstorlek som är mindre än 256 så kommer Tableau Server inte att starta efter uppgraderingen. Vi rekommenderar att du laddar upp ett nytt certifikat med en ECDSA-kurvstorlek på 256 (eller större) innan du uppgraderar. Alternativt kan du köra det här kommandot för att ange en lägre ECDSA-kurvstorlek på äldre versioner (innan 2021.1) av Tableau Server innan du uppgraderar. Om du kör det här kommandot på en version tidigare än 2021.1 måste du inkludera alternativet --force-keys med kommandot. Mer information om hur du uppgraderar till 2021.2 med SAML konfigurerat finns i Knowledge Base-artikeln Tableau Server Using SAML Authentication Fails to Start or Rejects Login After Upgrade to Tableau Server 2021.2.

wgserver.saml.min_allowed.rsa_key_size

Standardvärde: 2048

Version: lades till i version 2021.1 men inkluderade inget standardvärde. I version 2021.2 är standardvärdet 2048.

Det här alternativet anger minsta tillåtna RSA-nyckellängd för certifikatet som används för SAML-autentisering. Om du laddar upp ett certifikat som har en RSA-nyckellängd på mindre än 2048 kommer TSM att logga ett fel när du tillämpar ändringar.

Om du vill köra SAM-autentisering med en RSA-nyckelländ på 1024 (inte rekommenderat) anger du det här värdet till 1024.

Om du uppgraderar till Tableau Server 2021.2 eller senare och ditt SAML-certifikat använder sig av en nyckellängd på mindre än 2048 så kommer Tableau Server inte att starta efter uppgraderingen. Vi rekommenderar att du laddar upp ett nytt certifikat med en nyckellängd på 2048 (eller större) innan du uppgraderar. Alternativt kan du köra det här kommandot för att ange en lägre nyckelstyrka på äldre versioner (innan 2021.1) av Tableau Server innan du uppgraderar. Om du kör det här kommandot på en version tidigare än 2021.1 måste du inkludera alternativet --force-keys med kommandot. Mer information om hur du uppgraderar till 2021.2 med SAML konfigurerat finns i Knowledge Base-artikeln Tableau Server Using SAML Authentication Fails to Start or Rejects Login After Upgrade to Tableau Server 2021.2.