Hilfe zu Tableau Server für Linux

Sie können tsm-Befehle auf dem Einstiegsknoten (dem Knoten, auf dem TSM installiert ist) oder auf jedem weiteren Knoten im Cluster ausführen.

Zum Ausführen von tsm-Befehlen müssen Sie eine Eingabeaufforderung öffnen.

1. Öffnen Sie eine Eingabeaufforderung mit einem Konto, das Mitglied der Gruppe tsmadmin auf einem Knoten im Cluster ist.

2. Führen Sie den gewünschten Befehl aus. Wenn Sie den Befehl von einem anderen Knoten als dem anfänglichen Knoten aus ausführen, schließen Sie die Option -s ein, um die URL des anfänglichen Knotens namentlich (nicht die IP-Adresse) anzugeben, und schließen Sie den TSM-Port 8850 ein.

   Um die Version von TSM und Tableau Server vom Einstiegsknoten aus anzuzeigen:

   tsm version

   Um die Version von TSM und Tableau Server von einem zusätzlichen Knoten aus anzuzeigen:

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

   Beispiel:

   tsm version -s https://myTableauHost:8850

backgrounder.failure_threshold_for_run_prevention

Standardwert: 5

Die Anzahl der aufeinanderfolgenden Fehler einer Subscription, eines Extrakts oder einer Schema-Ausführung vor dieser Aufgabe wird angehalten. Durch Anhalten von Aufträgen, die fortlaufend fehlschlagen, stehen die Ressourcen der Hintergrundprozesskomponente für andere Aufträge zur Verfügung. Um das Aussetzen fehlgeschlagener im Hintergrund ausgeführter Aufgaben zu deaktivieren, legen Sie hierfür den Wert -1 fest.

backgrounder.log.level

Version: Hinzugefügt in Version 2020.3.0

Standardwert: info

Die Protokollierungsebene für den Prozess der Hintergrundprozesskomponente. Sie ist dynamisch konfigurierbar, sodass Sie Tableau Server nicht neu starten müssen, wenn Sie lediglich diese Änderung vornehmen. Weitere Informationen finden Sie unter Ändern von Protokollstufen.

backgrounder.restrict_serial_collections_to_site_level

Standardwert: false

In Tableau Server können Sie Extraktaktualisierungen, Abonnements oder Schemata für die regelmäßige Ausführung planen. Diese geplanten Elemente werden als Aufgaben bezeichnet. Der Hintergrundprozess initiiert eindeutige Instanzen dieser Aufgaben, um sie zum geplanten Zeitpunkt auszuführen. Die eindeutigen Instanzen der Aufgaben, die dadurch initiiert werden, werden als Aufträge bezeichnet.

Diese Einstellung wirkt sich auf Zeitpläne aus, die für die serielle Ausführung konfiguriert sind. Wenn ein Zeitplan für die serielle Ausführung konfiguriert ist, werden standardmäßig alle Aufträge, die diesen Zeitplan verwenden, seriell ausgeführt. Wenn diese Einstellung auf true eingestellt ist, können Aufträge, die auf verschiedenen Sites ausgeführt werden, parallel ausgeführt werden. Aufträge für geplante Aufgaben auf derselben Site werden weiterhin seriell ausgeführt.

Das folgende Beispiel veranschaulicht dieses Szenario:

Tableau Server enthält einen Zeitplan namens "Täglich", um Aufträge täglich um 7:00 Uhr auszuführen. Der Zeitplan "Täglich" ist so konfiguriert, dass er seriell ausgeführt wird. Die Site "HR" und die Site "Gehaltsabrechnung" haben jeweils mehrere geplante Aufgaben, die den Zeitplan "Täglich" verwenden. Wenn diese Einstellung auf true eingestellt ist, können Aufträge für diese geplanten Aufgaben auf der Site "HR" parallel zu Aufträgen auf der Site "Gehaltsabrechnung" ausgeführt werden, während Aufträge auf derselben Site weiterhin nur seriell ausgeführt werden.

backgrounder.timeout.single_subscription_notify

Version: Hinzugefügt in Version 2021.2.

Standardwert: 1800 Sekunden (30 Minuten)

Dies ist die maximal zulässige Zeit in Sekunden für die Ausführung eines einzelnen Abonnementauftrags.

backgrounder.timeout.sync_ad_group

Version: Hinzugefügt in Version 2021.1.23, 2021.2.21, 2021.3.20, 2021.4.15, 2022.1.11, 2022.3.3, 2023.1.

Standardwert: 14400 Sekunden (4 Stunden)

Dies ist die maximal zulässige Zeit in Sekunden für die Ausführung einer Active Directory-Gruppensynchronisierung. Dies gilt für geplante Gruppensynchronisierungen, die von der Hintergrundprozesskomponente durchgeführt werden, und verhindert, dass lang andauernde Synchronisierungen auf unbestimmte Zeit ausgeführt werden. Dies wirkt sich nicht auf Gruppensynchronisierungen aus, die über die Tableau Server-Benutzeroberfläche oder die REST-API durchgeführt werden.

backgrounder.vInstances_max_overflow_queue_size

Version: Hinzugefügt in Version 2022.1.2.

Standardwert: 1000

Die maximale Anzahl von Aufträgen, die sich in der sekundären Warteschlange befinden dürfen. Eine sekundäre Warteschlange wird erstellt, wenn die Anzahl der ausgeführten Aufträge das festgelegte Limit für parallel ausgeführte Aufträge erreicht. Der standardmäßige Maximalwert ist auf 1000 Aufträge festgelegt. Wenn also mehr als 1000 Aufträge vorhanden sind und somit das Limit für parallel ausgeführte Aufträge erreicht wird, wird alles über den 1000 Aufträgen nicht in die Warteschlange gestellt. Verwenden Sie den tsm-Befehl backgrounder.vInstance_max_overflow_queue_size, um Änderungen an der maximalen Überlaufgröße für Warteschlangen vorzunehmen.

Die Werte sind in ganzen Zahlen anzugeben.

backup.zstd.thread_count

Version: Hinzugefügt in Version 2021.1.0 Dieser Schlüssel ist dynamisch konfigurierbar. Weitere Informationen finden unter Änderungen der dynamischen Topologie von Tableau Server

Standardwert: 2

Anzahl der Threads, die beim Erstellen einer Sicherung verwendet werden sollen.

Eine Erhöhung dieser Anzahl kann die Backup-Leistung verbessern, aber wir empfehlen maximal vier, da die Thread-Anzahl die Anzahl der logischen Prozessoren auf dem Tableau Server-Computer nicht übersteigen sollte.

basefilepath.backuprestore

Standardwert: /var/opt/tableau/tableau_server/data/tabsvc/files/backups/

Der Speicherort, an dem der Befehl tsm maintenance backup die Sicherung erstellt. An diesem Speicherort muss sich auch die Sicherungsdatei befinden, wenn sie mit dem Befehl tsm maintenance restore oder dem Befehl tsm maintenance send-logs wiederhergestellt wird. Nachdem Sie dies festgelegt haben, sollten Sie den Befehl tsm maintenance validate-backup-basefilepath (ab Version 2022.1 verfügbar) ausführen, um zu überprüfen, dass die Berechtigungen für den Speicherort ordnungsgemäß festgelegt sind. Weitere Informationen finden Sie unter tsm-Dateipfade.

basefilepath.log_archive

Standardwert: /var/opt/tableau/tableau_server/data/tabsvc/files/log-archives/

Der Speicherort, an dem der Befehl tsm maintenance ziplogs das ZIP-Archiv erstellt. Weitere Informationen finden Sie unter tsm-Dateipfade.

basefilepath.site_export.exports

Standardwert: /var/opt/tableau/tableau_server/data/tabsvc/files/siteexports/

Der Speicherort, an dem der Befehl tsm sites export die Exportdatei erstellt. Weitere Informationen finden Sie unter tsm-Dateipfade.

basefilepath.site_import.exports

Standardwert: /var/opt/tableau/tableau_server/data/tabsvc/files/siteimports/

Der Speicherort, an dem der Befehl tsm sites import die Importdatei erwartet. Weitere Informationen finden Sie unter tsm-Dateipfade.

clustercontroller.log.level

Version: Hinzugefügt in Version 2020.3.0

Standardwert: info

Die Protokollebene für den Cluster-Controller. Sie ist dynamisch konfigurierbar, sodass Sie Tableau Server nicht neu starten müssen, wenn Sie lediglich diese Änderung vornehmen. Weitere Informationen finden Sie unter Ändern von Protokollstufen.

databaseservice.max_database_deletes_per_run

Version: Hinzugefügt in Version 2021.2.

Standardwert: null

Verwenden Sie diese Option, um die maximale Anzahl eingebetteter externer Assets (Datenbanken und Tabellen) anzupassen, die bei jedem durch features.DeleteOrphanedEmbeddedDatabaseAsset gesteuerten Hintergrundprozess gelöscht werden können. Wird diese Option leer gelassen, beträgt die standardmäßige maximale Anzahl eingebetteter externer Assets, die gelöscht werden können, 100.

Weitere Informationen finden Sie unter features.DeleteOrphanedEmbeddedDatabaseAsset.

dataserver.log.level

Version: Hinzugefügt in Version 2020.3.0

Standardwert: info

Die Protokollebene für den Datenserver. Sie ist dynamisch konfigurierbar, sodass Sie Tableau Server nicht neu starten müssen, wenn Sie lediglich diese Änderung vornehmen. Weitere Informationen finden Sie unter Ändern von Protokollstufen.

excel.shadow_copy_all_remote.enabled

Version: Hinzugefügt in den Versionen 2019.1.5, 2019.2.1.

Standardwert: false

Steuert, ob Tableau Server eine "Schattenkopie" eines gemeinsamen Excel-Arbeitsblatts (.xlxs oder.xlxm) erstellt, die als Live-Datenquelle verwendet wird. Wenn diese Option aktiviert ist, verhindert sie, dass Excel-Benutzer einen "Sharing Violation Error" und eine Meldung sehen, dass die Datei "aktuell verwendet wird". Diese Option kann bei großen Excel-Dateien Auswirkungen auf die Leistung haben. Wenn Excel-Benutzer nicht die gemeinsame Datei bearbeiten müssen, brauchen Sie diese Option nicht zu aktivieren.

Hinweis: Tableau Server versucht immer, eine Schattenkopie einer .xls-Datei zu erstellen. Diese Option ändert dieses Verhalten nicht.

extractservice.command.execution.timeout

Version: In Version 2021.4 hinzugefügt.

Standardwert: 7200 Sekunden

Legt den Timeout-Wert für die Laufzeit der VConn-Extraktaktualisierung fest.

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

Hinweis: Sie müssen die Option --force-keys verwenden, um diesen Wert zu ändern.

features.ActiveMQ

Version: In Version 2021.4 hinzugefügt.

Standardwert: true

Legt fest, ob Tableau Server den Apache ActiveMQ-Dienst (Tableau Server-Messaging-Dienst) als internes Messaging-Instrument verwendet.

features.DeleteOrphanedEmbeddedDatabaseAsset

Version: Hinzugefügt in Version 2021.2.

Standardwert: true

Steuert einen Hintergrundprozess für Tableau Catalog (oder Tableau Metadaten-API), der eingebettete externe Assets (Datenbanken und Tabellen) löscht, die nicht mehr mit nachgelagerten Tableau-Inhalten verknüpft sind. Dieser Prozess wird täglich um 22:00:00 UTC (koordinierte Weltzeit) ausgeführt und kann täglich maximal 100 externe Assets löschen, bis keine externen Assets ohne Verbindungen zu nachgelagerten Inhalten von Tableau mehr vorhanden sind. Sie können diese Option auf false einstellen, um die Ausführung dieses Prozesses zu stoppen. Alternativ können Sie auch die maximale Anzahl externer eingebetteter Assets, die gelöscht werden können, mit databaseservice.max_database_deletes_per_run anpassen.

Weitere Informationen finden Sie im Abschnitt Beheben von Problemen mit fehlenden Inhalten.

Features.IdentityMigrationBackgroundJob

Version: Hinzugefügt in Version 2022.1. Der Standardwert wurde in den Versionen 2021.4.22, 2022.1.18, 2022.3.10, 2023.1.6 und 2023.3 in false geändert.

Standardwert: false

Steuert den Prozess, der die Identitätsmigration durchführt. Wenn auf true eingestellt, wird die Identitätsmigration in vorhandenen Bereitstellungen unmittelbar nach dem Upgrade von Tableau Server auf Version 2022.1 (oder höher) und der Wiederherstellung einer Sicherung von Tableau Server Version 2021.4 (oder früher) ausgeführt. Stellen Sie ihn auf false (Standard), um die Identitätsmigration zu deaktivieren.

Um beispielsweise die Identitätsmigration zu starten, führen Sie Folgendes aus:

tsm configuration set -k features.IdentityMigrationBackgroundJob -v true

Weitere Informationen finden Sie unter Über die Identitätsmigration.

Hinweis: Wenn die Identitätsmigration deaktiviert ist, kann Tableau Server den Identitätsdienst nicht zum Speichern und Verwalten von Benutzeridentitätsinformationen verwenden. Die Verwendung des Identity Service ist eine Voraussetzung für bestimmte Funktionen wie Identitätspools.

Features.IdentityPools

Version: In Version 2023.1 hinzugefügt.

Standardwert: false

Eine Komponente der Identitätspoolfunktion, die aktiviert werden muss, wenn Sie eine neue Tableau Server-Installation durchführen. Erfordert feature.NewIdentityMode und wgserver.authentication.legacy_identity_mode.enabled. Stellen Sie dies auf true, um Identitätspools zu aktivieren. Stellen Sie dies auf false (Standard), um Identitätspools zu deaktivieren.

Um beispielsweise Identitätspools zu aktivieren, führen Sie Folgendes aus:

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

Weitere Informationen finden Sie unter Fehlerbehebung bei Identitätspools.

features.MessageBusEnabled

Version: Hinzugefügt in Version 2019.4.

Standardwert: true

Legt fest, ob Tableau Server das neue interne Messaging-Instrument verwendet.

Features.NewIdentityMode

Version: Hinzugefügt in Version 2022.1.

Standardwert: false. Der Standardwert wurde in 2023.1.6 von true in false geändert.

Ist eine Voraussetzung für die Identitätspoolfunktion. Erfordert, dass wgserver.authentication.legacy_identity_mode.enabled auf false festgelegt wird, um Identitätspools zu deaktivieren. Muss auf true festgelegt werden, um Identitätspools zu verwenden.

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

Weitere Informationen finden Sie unter Fehlerbehebung bei Identitätspools.

features.PasswordlessBootstrapInit

Standardwert: true

Steuert, ob der Tableau Server eingebettete Anmeldeinformationen in Bootstrap-Dateien zulässt. Wenn aktiviert (Standard), werden eingebettete Anmeldeinformationen in der Bootstrap-Datei mit eingeschlossen, es sei denn, Sie geben an, dass sie nicht enthalten sein sollen. Setzen Sie dies auf false, wenn Anmeldeinformationen niemals in einer von Ihnen erzeugten Bootstrap-Datei enthalten sein sollen. Für weitere Informationen zum Erzeugen von Bootstrap-Dateien, siehe tsm topology nodes get-bootstrap-file.

Diese Option wurde ab Tableau Server-Version 2019.3 hinzugefügt.

features.PasswordReset

Version: Eingestellt in Version 2024.2. Ab Versionen 2024.2 verwenden Sie vizportal.password_reset.

Standardwert: false

Gilt nur für Server, die lokale Authentifizierung verwenden. Stellen Sie trueein, um Benutzern das Zurücksetzen ihrer Kennwörter mit einer Option "Kennwort vergessen" auf der Anmeldeseite zu ermöglichen.

filestore.empty_folders_reaper.enabled

Version: Hinzugefügt in den Versionen 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2) und 2021.1.x. Der Standardwert wurde in 2021.2 in true geändert.

Standardwert: true

Aktiviert den Auftrag, der leere Filestore-Ordner "erntet" (entfernt).

filestore_empty_folders_reap.frequenz_s

Version: Hinzugefügt in Version 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2).

Standardwert: 86400 (24 Stunden)

Gibt in Minuten an, wie oft der Auftrag ausgeführt werden soll, der leere Filestore-Ordner entfernt.

features.Hyper_DisallowTDEPublishing

Version: Ist ab Version 2023.1.0 standardmäßig true . Ist in Tableau Server 2024.2 veraltet.

Standardwert: true

Gibt an, ob Benutzer Dateien im .tde-Format hochladen können. Dieses Format wurde ab Version 10.5 von Tableau Server durch das .hyper-Format ersetzt, wobei das Hochladen jedoch nicht blockiert wurde. Ab Version 2024.3 sind Dateien im TDE-Format nicht mehr verwendbar. Die Dateien wurden automatisch in das .hyper-Format konvertiert, wenn eine von mehreren Aktionen ausgeführt wurde. Weitere Informationen finden Sie unter Extrahieren des Upgrades in das .hyper-Format.

filestore.log.level

Version: Hinzugefügt in Version 2020.3.0

Standardwert: info

Die Protokollebene für den Dateispeicher. Sie ist dynamisch konfigurierbar, sodass Sie Tableau Server nicht neu starten müssen, wenn Sie lediglich diese Änderung vornehmen. Weitere Informationen finden Sie unter Ändern von Protokollstufen.

filestore.reapemptyfoldersholdoffms

Version: Hinzugefügt in Version 2020.x (2020.1.14, 2020.2.11, 2020.3.6, 2020.4.2). Diese ist in 2021.1 noch nicht verfügbar.

Standardwert:300000 (5 Minuten)

Gibt die Wartezeit in Millisekunden an, bevor leere Filestore-Ordner entfernt werden.

floweditor.max_datafile_upload_size_in_kb

Version: Hinzugefügt in Version 2020.4

Standardwert: 1048576

Für die Tableau Prep-Schema-Webdokumenterstellung die maximale Größe von abgegrenzten Textdateien (z. B. CSV oder TXT), die auf Tableau Server hochgeladen werden können.

gateway.external_url

Version: Hinzugefügt in Version 2023.1

Standardwert: null

Erforderlich, wenn die OpenID Connect-Authentifizierung (OIDC) in TSM während der Einrichtung von Tableau Server oder mit Identitätspools konfiguriert wird. Gibt die Tableau Server-URL an, die vom Identitätsanbieter (IdP) verwendet wird, um Benutzer umzuleiten, die sich bei Tableau authentifizieren. Die externe Gateway-URL ist dieselbe URL, die Sie als Umleitungs-URL bei Ihrem IdP angegeben haben und die zum Abgleich verwendet wird.

Um beispielsweise den mit der OIDC-Authentifizierungskonfiguration verknüpften IdP an Ihren Tableau Server http://myco umzuleiten, führen Sie den folgenden Befehl aus:

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

gateway.http.hsts

Standardwert: false

Wenn aktiviert, zwingt der HTTP-Header "Strict Transport Security (HSTS)" Browser dazu, HTTPS für die Domäne zu verwenden.

gateway.httpd.loglevel

Version: Hinzugefügt in 2021.3.0.

Standardwert: notice

Gibt die Protokollierungsebene für den Gateway (Apache-HTTPD-Server) an. Die Standardeinstellung ist notice. Andere Optionen umfassen debug, info, warning, error. Wenn Sie die Protokollierungsebene ändern, sollten Sie sich der möglichen Auswirkungen auf den Speicherplatzbedarf und die Leistung bewusst sein. Setzen Sie die Protokollierungsebene am besten wieder auf die Standardeinstellung zurück, nachdem Sie die benötigten Informationen gesammelt haben. Ausführliche Informationen zur Apache-Protokollierung finden Sie in der HTTP-Dokumentation von Apache(Link wird in neuem Fenster geöffnet).

gateway.httpd.shmcb.size

Version: Hinzugefügt in Version 2021.4

Standardwert: 2048000

Gibt die Speichergröße (in Byte) für den Ringpuffer an, wenn der Speichertyp shmcb verwendet wird. Bei Verwendung des Speichertyps dbm gilt dieser Konfigurationsschlüssel nicht.

gateway.httpd.socache

Version: Hinzugefügt in Version 2021.4

Standardwert: shmcb

Gibt den Speichertyp des globalen/prozessübergreifenden SSL-Sitzungscaches an. In der Standardeinstellung ist dieser auf shmcb festgelegt und kann optional alsdbm konfiguriert werden. Weitere Informationen zu den Speichertypen shmcb und dbm finden Sie unter SSLSessionCache Directive(Link wird in neuem Fenster geöffnet) auf der Apache-Website.

gateway.log.level

Version: Hinzugefügt in Version 2020.3.0

Standardwert: info

Die Protokollstufe für Gateway. Sie ist dynamisch konfigurierbar, sodass Sie Tableau Server nicht neu starten müssen, wenn Sie lediglich diese Änderung vornehmen. Weitere Informationen finden Sie unter Ändern von Protokollstufen.

hyper.log_queries

Standardwert: true

Wenn Sie diese Einstellung auf "true" festlegen, werden Abfrageinformationen protokolliert.

Standardmäßig werden Abfrageinformationen protokolliert. Wenn sich jedoch herausstellt, dass die Protokolldateien für den verfügbaren Festplattenspeicherplatz zu groß sind, können Sie die Einstellung auf false festlegen, um das Protokollieren von Abfrageinformationen zu deaktivieren. Tableau empfiehlt, für diese Konfiguration die Einstellung true beizubehalten.

hyper.session_memory_limit

Standardwert: 0 (d. h. unbegrenzt)

Steuert den maximalen Speicherkonsum einer einzelnen Abfrage. Geben Sie die Anzahl Bytes an. Fügen Sie den Buchstaben "k" oder "K" an den Wert an, um "Kilobyte" anzugeben. Fügen Sie "m" an, um Megabyte anzugeben, "g" um Gigabyte anzugeben, oder "t", um Terrabyte anzugeben.

Um zum Beispiel das Arbeitsspeicherlimit auf 900 Megabyte zu setzen, führen Sie den folgenden Befehl aus:

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

Alternativ können Sie das Sitzungsarbeitsspeicherlimit als Prozentsatz des gesamten verfügbaren Systemarbeitsspeichers angeben, indem Sie den folgenden Befehl ausführen:

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

Das Senken dieses Werts kann hilfreich sein, wenn eine Abfrage übermäßig viel Arbeitsspeicher verwendet und andere Abfragen über einen langen Zeitraum fehlschlagen. Durch das Verringern des Grenzwerts schlägt die einzelne große Abfrage fehl (oder greift auf Spooling zurück, wenn das Spooling nicht deaktiviert ist) und sie hat keine negativen Auswirkungen auf andere Abfragen.

hyper.srm_cpu_limit_percentage

Standardwert (in Prozent): 75

Gibt die maximale stündliche durchschnittliche CPU-Auslastung an, die von Hyper zugelassen wird. Wird dieser Wert überschritten, startet die Daten-Engine sich selbst neu, um die Auswirkungen auf andere Prozesse auf dem Computer zu minimieren.

In der Standardeinstellung erfolgt der Neustart der Daten-Engine, wenn diese im Verlauf einer Stunde durchschnittlich mehr als 75 % der CPU auslastet. Dieser Wert sollte nicht geändert werden, außer wenn Sie mit dem Tableau-Support arbeiten oder wenn Sie die Daten-Engine auf einem dedizierten Serverknoten ausführen. Wird die Daten-Engine auf einem dedizierten Knoten ausgeführt, können Sie diesen Wert problemlos auf 95 Prozent erhöhen, um die verfügbare Computerhardware voll auszunutzen. Einzelheiten über das Ausführen der Daten-Engine auf einem dedizierten Knoten finden Sie unter Optimieren für extraktabfragelastige Umgebungen.

So wird dieser Wert auf 95 % erhöht:

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

tsm pending-changes apply

So wird dieser Wert wieder auf die Standardeinstellung von 75 % zurückgesetzt:

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

tsm pending-changes apply

hyper_standalone.consistent_hashing.enabled

Standardwert: true

Verbessert die Chance, dass der Extrakt für eine Abfrage bereits zwischengespeichert ist. Wenn der Knotenpunkt mit dem zwischengespeicherten Extrakt keine zusätzliche Last unterstützen kann, werden Sie an einen neuen Knotenpunkt weitergeleitet, und der Extrakt wird auf dem neuen Knotenpunkt in den Cache geladen. Dies führt zu einer besseren Systemauslastung, da Extrakte nur dann in den Arbeitsspeicher geladen werden, wenn eine Auslastung besteht, die den Bedarf rechtfertigt.

indexandsearchserver.vmopts

Version: Hinzugefügt in Version 2022.1.

Standardwert: "-Xmx<default_value> -Xms<default_value>"

Der Standardwert basiert auf der Größe des Systemspeichers und beträgt 3,125 % des gesamten System-RAMs.

Steuert die Heap-Größe für den Indizierungs- und Suchserver. Da der Standardwert automatisch skaliert wird, können Sie mithilfe dieser Option den Standardwert nur dann überschreiben, wenn dies unbedingt erforderlich ist. Fügen Sie an den Wert den Buchstaben 'k' an, um "Kilobyte" anzugeben, "m", um Megabyte anzugeben, oder "g", um Gigabyte anzugeben. Setzen Sie als allgemeine Regel die anfängliche Heap-Größe (-Xms) gleich mit der maximalen Heap-Größe (-Xmx), um die Sammlung von unbrauchbaren Dateien zu minimieren.

jmx.security.enabled

Version: Hinzugefügt in Version 2022.1.

Standardwert: false

JMX ist standardmäßig deaktiviert, daher ist sicheres JMX ebenfalls deaktiviert. Wenn Sie JMX aktivieren, empfehlen wir Ihnen dringend, auch sicheres JMX zu aktivieren.

Dieser Wert wird auf true gesetzt und schaltet dann sicheres JMX mit SSL und grundlegender Benutzername/Kennwort-Authentifizierung für schreibgeschützten Zugriff ein, wenn Sie den Befehl tsm maintenance jmx enable ausführen und mit y antworten, wenn Sie gefragt werden, ob Sie Sicherheitsfeatures für JMX aktivieren möchten:

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: Hinzugefügt in Version 2022.1.

Standardwert: true

Erzwingt SSL für JMX. Diese Option ist standardmäßig auftrue gesetzt, hat aber nur dann Auswirkungen, wenn auch jmx.security.enabled auf true eingestellt ist. Um JMX-Sicherheit zu aktivieren, führen Sie den Befehl tsm maintenance jmx enable aus. Antworten Sie mit y, wenn Sie gefragt werden, ob SSL aktiviert bleiben soll, oder mit n, um SSL zu deaktivieren:

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

jmx.ssl.require_client_auth

Version: Hiinzugefügt in Version 2022.1.

Standardwert: false

Dieser wird auf true gesetzt, wenn Sie den Befehl tsm maintenance jmx enable ausführen und mit y antworten, wenn Sie gefragt werden, ob Sie Client-Authentifizierung (mTLS) erforderlich machen möchten:

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

Um die Konfiguration abzuschließen, müssen Sie über ein Client-Zertifikat verfügen und dieses am richtigen Speicherort auf Ihrem Client-Computer ablegen.

jmx.ssl.user.name

Version: Hinzugefügt in Version 2022.1.

Standardwert: tsmjmxuser

Dieser wird bei der Installation oder bei einem Upgrade von Tableau Server festgelegt.

jmx.ssl.user.password

Version: Hinzugefügt in Version 2022.1.

Standardwert: <generated>

Dieser wird bei der Installation oder bei einem Upgrade von Tableau Server festgelegt.

jmx.user.access

Version: Hinzugefügt in Version 2022.1.

Standardwert: readonly

Sie können diesen Wert in readwrite ändern, wenn Sie den Befehl tsm maintenance jmx enable ausführen und mit y antworten, wenn Sie gefragt werden, ob readwrite -Zugriff hinzugefügt werden soll:

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

Standardwert: 0

Legen Sie die Dauer (in Sekunden) fest, nach der die (auf seiner Anmeldung basierende) Lizenz eines Benutzers gültig bleiben soll, wenn die Verbindung zu Tableau Server unterbrochen wird, bevor der Benutzer aufgefordert wird, Tableau erneut zu aktivieren. Diese Dauer wird immer aktualisiert, wenn Tableau Desktop in Gebrauch ist und eine Verbindung zu Tableau Server herstellen kann.

licensing.login_based_license_management.enabled

Standardwert: true

Legen Sie diese Einstellung auf "true" fest, um Anmeldungsbasierte Lizenzverwaltung zu aktivieren. Legen Sie sie auf "false" fest, um Anmeldungsbasierte Lizenzverwaltung zu deaktivieren.

Hinweis: Um Anmeldungsbasierte Lizenzverwaltung verwenden zu können, müssen Sie einen Produktschlüssel aktivieren, der für Anmeldungsbasierte Lizenzverwaltung aktiviert ist. In der tsm licenses list können Sie sehen, welche Produktschlüssel für Anmeldungsbasierte Lizenzverwaltung aktiviert wurden.

licensing.login_based_license_management.max_requested_duration_seconds

Standardwert: 7776000

Legen Sie die maximale Dauer (in Sekunden) fest, nach der die (auf seiner Anmeldung basierende) Lizenz eines Benutzers gültig bleiben soll, wenn die Verbindung zu Tableau Server unterbrochen wird, bevor der Benutzer aufgefordert wird, Tableau erneut zu aktivieren. Der Maximalwert beträgt 7.776.000 Sekunden (90 Tage). Diese Dauer wird immer aktualisiert, wenn Tableau Desktop in Gebrauch ist und eine Verbindung zu Tableau Server herstellen kann.

metadata.ingestor.blocklist

Standardwert: null

Wenn diese Option konfiguriert ist, blockiert Tableau Catalog die Aufnahme bestimmter Inhalte. Um festzulegen, welche Inhalte gesperrt werden sollen, müssen Sie die Sperrlistenwerte aus den "nicht interaktiven" Protokolldateien des Servers angeben, die aus einer Kombination der Site-ID, dem Inhaltstyp und der Inhalts-ID des Inhaltes bestehen, der gesperrt werden soll. Blocklistenwerte müssen durch Komma getrennt werden.

Wichtig: Sie sollten diese Option nur verwenden, wenn Sie vom Tableau-Support dazu aufgefordert werden.

Sie können beispielsweise tsm configuration set --force-keys -k metadata.ingestor.blocklist verwenden, um Aufnahme einer Kombination aus Datenquellen, Arbeitsmappen und Schemata mit dem folgenden Befehl zu blockieren:

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”

Überprüfen Sie zur Validierung der blockierten Inhalte die "nicht interaktiven" Protokolldateien des Servers auf die folgenden Ereignisse:

• Skipping ingestion for
• Successfully updated blocklist to

Beispiel:

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]

und

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

metadata.ingestor.pipeline.throttleEventsEnable

Standardwert: false

Steuert, ob die Indizierung neuer und aktualisierter Inhalte, auch Ereignisse genannt, über alle Websites auf dem Server geregelt ist. Standardmäßig ist die Ereigniseinschränkung deaktiviert. Wenn Sie die Ereigniseinschränkung aktivieren möchten, ändern Sie diese Einstellung mit dem folgenden Befehl in true: 

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

Weitere Informationen zur Ereigniseinschränkung finden Sie unter Tableau Catalog aktivieren.

metadata.ingestor.pipeline.throttleLimit

Standardwert: 20

Wenn die Ereigniseinschränkung aktiviert ist, ist dies die maximale Anzahl neuer und aktualisierter Inhaltselemente, die während eines bestimmten Zeitraums indiziert werden können. Sobald das angegebene Limit für ein bestimmtes Element erreicht ist, wird die Indizierung zurückgestellt.

Standardmäßig ist die Begrenzung auf 20 festgelegt. Sie kann nicht niedriger als 2sein. Sie können den folgenden Befehl verwenden, um die Begrenzung zu ändern: 

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

Gedrosselte Ereignisse können in den "nicht interaktiven" Protokolldateien des Servers als ingestor event flagged for removal by throttle filter identifiziert werden.

metadata.ingestor.pipeline.throttlePeriodLength

Standardwert: 20

Wenn die Ereigniseinschränkung aktiviert ist, ist dies der Zeitraum in Minuten, in dem eine angegebene maximale Anzahl neuer und aktualisierter Inhaltselemente indiziert werden kann. Sobald die angegebene Zeit erreicht ist, wird die Indizierung aller zusätzlicher neuer und aktualisierter Inhalte zurückgestellt.

Standardmäßig ist für die Zeit 30 Minuten eingestellt. Sie können den folgenden Befehl verwenden, um die Zeit zu ändern:

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

metadata.query.limits.time

Standardwert: 20

Dies ist die längste zulässige Zeit in Sekunden, die es dauern darf, eine Catalog- oder Metadaten-API-Abfrage auszuführen, bevor es zu einer Zeitüberschreitung kommt und die Abfrage abgebrochen wird. Tableau empfiehlt, die Zeitüberschreitungsobergrenze mit dem folgenden Befehl schrittweise auf maximal 60 Sekunden zu erhöhen:

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

Wichtig: Diese Option sollte nur geändert werden, wenn der unter Nachrichten zu Zeitüberschreitungen und Überschreitungen der Knotenobergrenze beschriebene Fehler angezeigt wird. Durch die Erhöhung der Zeitüberschreitungsobergrenze kann die CPU länger stärker belastet werden, was sich auf die Leistung anderer Prozesse auf Tableau Server auswirken kann. Die Erhöhung der Zeitüberschreitungsobergrenze kann auch zu einer höheren Speicherauslastung führen, was zu Problemen mit dem interaktiven Microservice-Container führen kann, wenn Abfragen parallel ausgeführt werden.

metadata.query.limits.count

Standardwert: 20000

Dies ist die Anzahl der Objekte (die lose der Anzahl der Abfrageergebnisse zugeordnet werden können), die Catalog zurückgeben kann, bevor die Knotenobergrenze überschritten und die Abfrage abgebrochen wird. Tableau empfiehlt, die Zeitüberschreitungsobergrenze mit dem folgenden Befehl schrittweise auf maximal 100.000 zu erhöhen:

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

Wichtig: Diese Option sollte nur geändert werden, wenn der unter Nachrichten zu Zeitüberschreitungen und Überschreitungen der Knotenobergrenze beschriebene Fehler angezeigt wird. Die Erhöhung der Knotenobergrenze kann zu einer höheren Speicherauslastung führen, was zu Problemen mit dem interaktiven Microservice-Container führen kann, wenn Abfragen parallel ausgeführt werden.

metadata.query.throttling.enabled

Version: Hinzugefügt in Version 2023.3

Standardwert: true

Steuert, ob die Abfragedrosselung der Metadaten-API(Link wird in neuem Fenster geöffnet) aktiviert ist. Die Drosselung der Metadaten-API-Abfrage ist eine Funktion, die verhindern soll, dass sich die API-Antworten eines Servers negativ auf die Gesamtleistung auswirken. Wenn auf true eingestellt (Standardeinstellung): Wenn eine Anfrage an die Metadaten-API den definierten Schwellenwert überschreitet, wird ein Fehler RATE_EXCEEDED zurückgegeben.

Wenn Benutzer der Metadaten-API häufig RATE_EXCEEDED-Fehler sehen, kann ein Administrator versuchen, die Drosselung mit den Einstellungen metadata.query.throttling.tokenRefilledPerSecond und metadata.query.throttling.queryCostCapacity anzupassen. Alternativ kann der Administrator die Drosselung vollständig deaktivieren, indem er den Wert von metadata.query.throttling.enabled auf false setzt. Dies würde jedoch die leistungsschützenden Vorteile der Funktion beeinträchtigen.

metadata.query.throttling.queryCostCapacity

Version: Hinzugefügt in Version 2023.3

Standardwert: 20000000

Eine Zahl, die die Kapazität der Metadaten-API(Link wird in neuem Fenster geöffnet) für die Beantwortung von Abfragen angibt. Für jede Anfrage an die Metadaten-API fallen berechnete Kosten an, die bei der Ausführung von dieser Zahl abgezogen werden. (Bei einem Token-Bucket-Modell ist dies die maximale Anzahl an Token, die sich im Bucket befinden können.)

Wenn Metadaten-API-Benutzer häufig RATE_EXCEEDED-Fehler sehen, kann ein Administrator die Drosselungseinstellungen anpassen. Er sollte metadata.query.throttling.tokenRefilledPerSecond anpassen und die Ergebnisse testen, bevor er versucht, metadata.query.throttling.queryCostCapacity anzupassen. Alternativ kann der Administrator die Drosselung auch vollständig deaktivieren, indem er metadata.query.throttling.enabled auf false setzt. Dies würde jedoch die leistungsschützenden Vorteile der Funktion beeinträchtigen.

metadata.query.throttling.tokenRefilledPerSecond

Version: Hinzugefügt in Version 2023.3

Standardwert: 5555

Eine Zahl, die die Abfragekapazität der Metadaten-API(Link wird in neuem Fenster geöffnet) angibt, die jede Sekunde neu generiert wird. (Bei Verwendung eines Token-Bucket-Modells ist dies die Anzahl der Token, die jede Sekunde in den Bucket getan werden.)

Wenn Metadaten-API-Benutzer häufig RATE_EXCEEDED-Fehler sehen, kann ein Administrator die Drosselungseinstellungen anpassen. Er sollte metadata.query.throttling.tokenRefilledPerSecond anpassen und die Ergebnisse testen, bevor er versucht, metadata.query.throttling.queryCostCapacity anzupassen. Alternativ kann der Administrator die Drosselung auch vollständig deaktivieren, indem er metadata.query.throttling.enabled auf false setzt. Dies würde jedoch die leistungsschützenden Vorteile der Funktion beeinträchtigen.

native_api.allowed_paths

Standardwert: ""

Hinweis: In Tableau Server-Versionen (einschließlich Wartungsversionen) vor Oktober 2023 war diese Einstellung so konfiguriert, dass standardmäßig der Zugriff auf alle Pfade zulässig war.

Verwenden Sie diese Einstellung, um eine Zulassungsliste für den Zugriff auf Dateien anzugeben, die in Tableau oder auf Remote-Freigaben gespeichert sind. Dieses Szenario ermöglicht es autorisierten Tableau Server-Benutzern, Arbeitsmappen zu erstellen, die Dateien auf dem Server als dateibasierte Datenquellen verwenden (z. B. Tabellenkalkulationen).

Mit dieser Einstellung können Sie den Zugriff auf die von Ihnen angegebenen Verzeichnisse beschränken. Der tableau-Zugriff auf das Systemkonto ist daher auf die Verzeichnispfade beschränkt, in denen Sie Datendateien hosten.

Wichtig Stellen Sie sicher, dass die Dateipfade, die Sie in dieser Einstellung angeben, existieren und für das Systemkonto zugänglich sind.

native_api.ExplainDataEnabled

Standardwert: true

Diese Option steuert, ob die Funktion "Erklär die Daten" für den Server aktiviert oder deaktiviert ist. Weitere Informationen zu "Erklär die Daten" finden Sie unter Erste Schritte mit "Erklär die Daten"(Link wird in neuem Fenster geöffnet) in der Tableau-Hilfe.

Diese Option wurde ab Tableau Server-Version 2019.3 hinzugefügt.

native_api.unc_mountpoints

Standardwert: keine

Gibt den UNC- und FQDN-Pfad für freigegebene Windows-Verzeichnisse an, auf die Tableau Server in Linux zugreift. Die einzelnen Pfade müssen zudem in einer entsprechenden auto.cifs-Datei referenziert werden. Trennen Sie die einzelnen Pfade durch ein Semikolon, z. B.:

'//filesrv01/development;/mnt/filesrv01/development;//filesrv01.example.lan/development;/mnt/filesrv01/development'

Nachfolgende Aktualisierungen des Werts native_api.unc_mountpoints überschreiben den vorhandenen Wert. Daher müssen Sie alle Freigaben im aktualisierten Wert einbeziehen, sobald Sie eine Windows-Freigabe hinzufügen.

Weitere Informationen dazu finden Sie im Community-Wiki-Thema Herstellen einer Verbindung zu einem in Windows freigegebenen Verzeichnis(Link wird in neuem Fenster geöffnet).

nlp.concepts_shards_count

Standardwert: 1

Hinweis: Die Standard-Shardanzahl ist für die meisten Tableau Server-Installationen ausreichend.

Regelt die Anzahl der Datenshards für den Concepts-Index von "Frag die Daten", Feldnamen, Feldsynonyme und analytische Begriffe, die in Shards gespeichert werden in:

• Dem Indizierungs- und Suchserver für 2022.1 und höhere Versionen.
• Elastic Server für 2019.1–2021. 4

Die Shardanzahl partitioniert den Suchindex, um die Gesamtindexgröße zu reduzieren, was die Leistung des semantischen Parsers von "Frag die Daten" verbessern kann. Die Anpassung der Shardanzahl ist eine weitere Maßnahme zur Leistungsverbesserung, die Sie zusammen mit der Erhöhung der Heapgröße mittels elasticserver.vmopts oder indexandsearchserver.vmopts vornehmen können (je nachdem, welche Version von Tableau Server Sie verwenden).

Tableau empfiehlt, die Shardanzahl um 1 pro 50 GB zu erhöhen. Um die Anzahl der Anpassungen der Shardanzahl zu reduzieren, berechnen Sie die Gesamtindexgröße, indem Sie dem aktuellen Index 50 % hinzufügen. Wenn die Gesamtindexgröße beispielsweise kleiner als 50 GB ist, ist 1 Shard ausreichend. Die tatsächliche Leistung hängt vom Server, der Geschwindigkeit, mit der die Indexgröße wächst, und weiteren Faktoren ab.

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

Sie können den folgenden Befehl verwenden, um die Shardanzahl des Concepts-Index von der Standardgröße auf 2 zu erhöhen:

tsm configuration set -k nlp.concepts_shards_count -v 2

nlp.values_shards_count

Standardwert: 1

Regelt die Anzahl der Datenshards für den Concepts-Index von "Frag die Daten", Feldnamen, Feldsynonyme und analytische Begriffe, die in Shards gespeichert werden in:

• Dem Indizierungs- und Suchserver für 2022.1 und höhere Versionen.
• Elastic Server für 2019.1–2021. 4

Die Shardanzahl partitioniert den Suchindex, um die Gesamtindexgröße zu reduzieren, was die Leistung des semantischen Parsers von "Frag die Daten" verbessern kann. Die Anpassung der Shardanzahl ist eine weitere Maßnahme zur Leistungsverbesserung, die Sie zusammen mit der Erhöhung der Heapgröße mittels elasticserver.vmopts oder indexandsearchserver.vmopts vornehmen können (je nachdem, welche Version von Tableau Server Sie verwenden).

Tableau empfiehlt, die Shardanzahl um 1 pro 50 GB zu erhöhen. Um die Anzahl der Anpassungen der Shardanzahl zu reduzieren, berechnen Sie die Gesamtindexgröße, indem Sie dem aktuellen Index 50 % hinzufügen. Wenn die Gesamtindexgröße beispielsweise kleiner als 50 GB ist, ist 1 Shard ausreichend. Die tatsächliche Leistung hängt vom Server, der Geschwindigkeit, mit der die Indexgröße wächst, und weiteren Faktoren ab.

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

Sie können den folgenden Befehl verwenden, um die Shardanzahl des Werte-Index von der Standardgröße auf 2 zu erhöhen:

tsm configuration set -k nlp.values_shards_count -v 2

nlp.defaultNewSiteAskDataMode

Standardwert: disabled_by_default

Verwenden Sie diese Option, um den Anfangswert des Modus "Frag die Daten" festzulegen, wenn eine Website erstellt wird. Weitere Informationen finden Sie unter Deaktivieren oder Aktivieren von "Frag die Daten" für eine Site

Gültige Optionen sind disabled_by_default und disabled_always.

Diese Option wurde ab Tableau Server Version 2019.4.5 und Version 2020.1.3 hinzugefügt.

noninteractive.vmopts

pgsql.port

Standardwert: 8060

Port, der von PostgreSQL überwacht wird.

pgsql.preferred_host

Legt den Computernamen des Knotens mit dem bevorzugten installierten Repository fest. Dieser Wert wird verwendet, wenn die Option --preferred oder -r mit dem Befehl tsm topology failover-repository festgelegt wird.

Beispiel:

pgsql.ssl.ciphersuite

Standardwert: HIGH:MEDIUM:!aNULL:!MD5:!RC4

Gibt die Cipher-Algorithmen an, die für SSL für das Repository zulässig sind.

Akzeptable Werte und Formatierungsanforderungen finden Sie unter ssl_ciphers(Link wird in neuem Fenster geöffnet) auf der Postgres-Website.

pgsql.ssl.max_protocol_version

Standardwert: TLSv1.3

Legt die höchste SSL/TLS-Protokollversion fest, die beim Herstellen einer Verbindung zum Repository über SSL verwendet werden soll.

Gültige Werte: TLSv1, TLSv1.1, TLSv1.2, TLSv1.3

pgsql.ssl.min_protocol_version

Standardwert: TLSv1.2

Legt die niedrigste SSL/TLS-Protokollversion fest, die verwendet werden soll, wenn eine Verbindung zum Repository über SSL hergestellt wird.

Gültige Werte: TLSv1, TLSv1.1, TLSv1.2, TLSv1.3

pgsql.verify_restore.port

Standardwert: 8061

Port zur Verifizierung der Integrität der PostgreSQL-Datenbank. Weitere Informationen finden Sie unter tsm maintenance backup.

ports.blocklist

Version: Hinzugefügt in Version 2021.1

Standardwert: In dem für die automatische Portzuweisung verwendeten Bereich werden keine Ports blockiert.

Wird verwendet, um Ports innerhalb des Portzuweisungsbereichs anzugeben, die von Tableau beim dynamischen Zuweisen von Ports nicht verwendet werden sollen. Dies ist hilfreich, wenn Sie wissen, dass eine andere Anwendung einen Port innerhalb des Bereichs verwendet. Trennen Sie mehrere Ports durch Kommas, z. B.:

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

Weitere Informationen zur Verwendung des Schlüssels ports.blocklist finden Sie unter Blockieren bestimmter Ports innerhalb des Bereichs.

recommendations.enabled

Standardwert: true

Steuert die Empfehlungs-Funktion, welche Empfehlungen für Datenquellen und Tabellen (für Tableau Desktop) sowie Empfehlungen für Ansichten (für Tableau Server) bietet. Empfehlungen basieren auf der Popularität des Inhalts oder auf häufig von anderen Benutzern verwendeten Inhalten, die als dem aktuellen Benutzer ähnlich erkannt werden.

searchserver.connection_timeout_milliseconds

Version: Hinzugefügt in Version 2019.1. Eingestellt in Version 2022.3. In Version 2023.3 eingestellt.

Standardwert in Millisekunden: 100000

Gibt in Millisekunden an, wie lange Search & Browse-Clients warten, um eine Verbindung zum Search & Browse-Server herzustellen.

Auf besonders ausgelasteten Tableau Server-Computern oder wenn Protokollfehler wie "Fehlgeschlagene ZooKeeper-Integritätsprüfung. SOLR kann nicht gestartet werden" angezeigt werden, sollten Sie diesen Wert erhöhen.

Weitere Informationen finden Sie unter Zeitüberschreitungen bei Clientsitzungen.

searchserver.index.bulk_query_user_groups

Version: In Version 2022.3 eingestellt.

Standardwert: true

Gibt an, ob das Abfragen von Site-Benutzern beim Importieren oder Löschen von Benutzern mit einer CSV-Datei als Sammelvorgang erfolgen soll. Wenn auf true gesetzt (was die Standardeinstellung ist), erfolgt die Indexierung in Form eines Sammelvorgangs.

searchserver.javamemopts

Version: Hinzugefügt in Version 2019.1. In Version 2023.3 eingestellt

Standardwert: -Xmx512m -Xms512m -XX:+ExitOnOutOfMemoryError -XX:-UsePerfData

Legt die JVM-Optionen für SOLR fest.

Von allen konfigurierbaren Optionen ist der maximale Heap-Speicher, der durch den Parameter -Xmx konfiguriert wird, der wichtigste beim Optimieren des Suchservers. In den meisten Fällen sollte dies so hoch wie möglich eingestellt werden – bis zu 24 GB –, je nach verfügbarem physischem Speicher auf dem Tableau Server-Computer. Um nur den maximalen Heap-Speicher zu ändern, geben Sie die gesamte Standardzeichenfolge an, ändern Sie jedoch nur den Wert für -Xmx.

Die gültigen Werte für -Xmx hängen vom verfügbaren Arbeitsspeicher auf dem Tableau Server-Computer ab, dürfen jedoch nicht größer als 24 GB sein. Weitere Informationen finden Sie unter Search & Browse des maximalen Heap-Speichers.

searchserver.startup.zookeeper_healthcheck_timeout_ms

Version: Hinzugefügt in Version 2020.1. In Version 2023.3 eingestellt.

Standardwert in Millisekunden: 300000

Gibt in Millisekunden an, wie lange Tableau Server beim Start auf eine erfolgreiche ZooKeeper-Integritätsprüfung warten soll.

Auf besonders ausgelasteten Tableau Server-Computern oder wenn Protokollfehler wie "Fehlgeschlagene ZooKeeper-Integritätsprüfung. SOLR kann nicht gestartet werden" angezeigt werden, sollten Sie diesen Wert erhöhen.

Weitere Informationen finden Sie unter Zeitüberschreitung beim Start der Zookeeper-Verbindung für die Zustandsprüfung.

searchserver.zookeeper_session_timeout_milliseconds

Version: In Version 2022.3 eingestellt.

Standardwert in Millisekunden: 100000

Gibt in Millisekunden an, wie lange Search & Browse-Clients warten sollen, um eine Verbindung zum Koordinationsdienst (ZooKeeper) herzustellen.

Weitere Informationen finden Sie unter Zeitüberschreitungen bei Clientsitzungen.

ServerExportCSVMaxRowsByCols

Version: Hinzugefügt in Version 2020.3.

Standardwert: 0 (kein Limit)

Gibt die maximale Anzahl von Datenzellen an, die aus Ansichtsdaten in eine CSV-Datei heruntergeladen werden können. Standardmäßig gibt es keine Begrenzung. Geben Sie die Anzahl der Zellen an. Zum Beispiel, um ein Limit von 3 Millionen festzulegen: 

tsm configuration set -k ServerExportCSVMaxRowsByCols -v 3000000 

tsm pending-changes apply

ssl.ciphersuite

Standardwert: HIGH:MEDIUM:!EXP:!aNULL:!MD5:!RC4:!3DES:!CAMELLIA:!IDEA:!SEED

Gibt die Cipher-Algorithmen an, die für SSL für Gateway zulässig sind.

Akzeptable Werte und Formatierungsanforderungen finden Sie unter SSLCipherSuite(Link wird in neuem Fenster geöffnet) auf der Apache-Website.

ssl.client_certificate_login.blocklisted_signature_algorithms

Standardwert:

• Version 2020.4.0: 

  sha1withrsaencryption,
sha1withrsa

• Version 2020.4.1 und höher:

  sha1withrsaencryption,
sha1withrsa,
sha1withrsaandmgf1,
sha1withdsa,
sha1withecdsa

Der Standardwert blockiert Zertifikate mit dem SHA-1-Signaturalgorithmus. Gibt die Clientsignaturalgorithmen an, die für SSL blockiert sind. Um das Blockieren aller Signaturalgorithmen zu deaktivieren, führen Sie diesen Schlüssel mit einem leeren Satz von Anführungszeichen aus.

Weitere Informationen zu diesem Schlüssel finden Sie im Knowledgebase-Artikel Gegenseitige SSL schlägt nach dem Upgrade von mit SHA-1 signierten Zertifikaten fehl(Link wird in neuem Fenster geöffnet).

ssl.client_certificate_login.min_allowed.elliptic_curve_size

Standardwert: 256

Gibt die Mindestgröße der elliptischen Kurve an, die für ECDSA-Client-Zertifikate erforderlich ist, die sich mit Tableau Server über wechselseitiges SSL authentifizieren. Wenn ein Client ein ECDSA-Client-Zertifikat vorlegt, das diese Mindestgröße der Kurve nicht erfüllt, schlägt die Authentifizierungsanfrage fehl.

Diese Option wurde ab Tableau Server-Version 2021.1 hinzugefügt.

ssl.client_certificate_login.min_allowed.rsa_key_size

Standardwert: 2048

Gibt die Mindestgröße der Schlüssel für RSA-Client-Zertifikate an, die sich mit Tableau Server über wechselseitiges SSL authentifizieren. Wenn ein Client ein RSA-Client-Zertifikat vorlegt, das diese Mindestschlüsselgröße nicht erfüllt, schlägt die Authentifizierungsanfrage fehl.

Diese Option wurde ab Tableau Server-Version 2021.1 hinzugefügt.

ssl.protocols

Standardwert: all +TLSv1.2 -SSLv2 -SSLv3 -TLSv1.3

Gibt die SSL-Protokolle an, die Tableau Server für TLS-Verbindungen für Gateway unterstützt. Akzeptable Werte leiten sich von der Apache SSLProtocol-Direktive(Link wird in neuem Fenster geöffnet) ab. Wir empfehlen die folgende SSL-Protokollkonfiguration wie in der Checkliste für die Absicherung beschrieben.

storage.monitoring.email_enabled

Standardwert: false

Steuert, ob E-Mail-Benachrichtigungen für die Überwachung des Festplattenplatz des Servers aktiviert sind. Standardmäßig sind E-Mail-Benachrichtigungen aktiviert. Um Benachrichtigungen für die Überwachung des Festplattenplatzes zu aktivieren, stellen Sie dies auf true.

SMTP muss konfiguriert sein, damit Benachrichtigungen gesendet werden können. Weitere Informationen finden Sie unter Konfigurieren des SMTP-Setups.

storage.monitoring.warning_percent

Standardwert: 20

Warnschwelle des verbleibenden Festplattenspeichers, in Prozent des gesamten Festplattenspeichers. Wenn der Festplattenspeicher unter diesen Schwellenwert fällt, wird eine Warnmeldung gesendet.

storage.monitoring.critical_percent

Standardwert: 10

Kritischer Schwellenwert des verbleibenden Festplattenspeichers, in Prozent des gesamten Festplattenspeichers. Wenn der Festplattenspeicher unter diesen Schwellenwert fällt, wird eine Warnmeldung gesendet.

storage.monitoring.email_interval_min

Standardwert: 60

Wie häufig, Angabe in Minuten, sollten E-Mail-Benachrichtigungen gesendet werden, wenn die Überwachung des Festplattenspeichers aktiviert ist und ein Schwellenwert überschritten wird.

storage.monitoring.record_history_enabled

Standardwert: true

Legt fest, ob der Verlauf des freien Festplattenspeichers gespeichert und in den Verwaltungsansichten angezeigt wird. Um den Verlaufsspeicher für die Überwachung zu deaktivieren, setzen Sie storage.monitoring.record_history_enabled auf false.

svcmonitor.notification.smtp.enabled

Standardwert: false

Steuert, ob E-Mail-Benachrichtigungen für Ereignisse im Serverprozess aktiviert sind. Standardmäßig werden Benachrichtigungen gesendet, wenn Prozesse fehlschlagen, ausfallen oder neu gestartet werden. Um Serverprozessbenachrichtigungen zu aktivieren, setzen Sie dies auf true.

SMTP muss konfiguriert sein, damit Benachrichtigungen gesendet werden können. Weitere Informationen finden Sie unter Konfigurieren des SMTP-Setups.

svcmonitor.notification.smtp.mime_use_multipart_mixed

Version: Hinzugefügt in den Versionen 2020.1.8, 2020.2.5 und 2020.3.1

Standardwert: false

Legt fest, ob Abonnement-HTML-MIME-Anlagen als mehrteilig/verknüpft (Standard) oder multipart/mixed gesendet werden.

In seltenen Fällen kann es vorkommen, dass E-Mail-Clients von Tableau Server gesendete E-Mails nicht ordnungsgemäß analysieren. In vielen Fällen kann dies behoben werden, indem diese Eigenschaft auf true festgelegt wird. Zu den bekannten Clients gehören iOS Mail und Microsoft Outlook (in Verbindung mit der Exchange S/MIME-Verschlüsselung).

tabadmincontroller.auth.expiration.minutes

Standardwert: 120

Steuert, wie lange Session-Cookies gültig sind. Standardmäßig ist dies auf 120 Minuten eingestellt. Dieser Wert bestimmt auch, wie lange die eingebetteten Anmeldeinformationen in einer Knoten-Bootstrap-Datei gültig sind. Weitere Informationen finden Sie unter tsm topology nodes get-bootstrap-file.

tdsservice.log.level

Version: Hinzugefügt in Version 2020.3.0

Standardwert: info

Die Protokollstufe für den Datenquelleneigenschaftsdienst. Sie ist dynamisch konfigurierbar, sodass Sie Tableau Server nicht neu starten müssen, wenn Sie lediglich diese Änderung vornehmen. Weitere Informationen finden Sie unter Ändern von Protokollstufen.

tomcat.useSystemProxies

Standardwert: false

Gibt an, ob Tomcat-Komponenten (OpenID) Zugriff auf die Forward-Proxy-Konfiguration auf dem lokalen Windows-Betriebssystem benötigen. Siehe Konfigurieren von Tableau Server für OpenID Connect.

tomcatcontainer.log.level

Standardwert: info

Die Protokollstufe für Microservices im interaktiven Microservice-Container und im nicht-interaktiven Microservice-Container. Dies kann ab Version 2020.4 dynamisch konfiguriert werden, sodass Sie Tableau Server nicht neu starten müssen, wenn Sie lediglich diese Änderung vornehmen. Weitere Informationen finden Sie unter Ändern von Protokollstufen.

tsm.log.level

Standardwert: info

Protokollierungsebene für TSM-Dienste. Diese Protokolle enthalten Informationen, die nützlich sein können, wenn Sie Probleme mit TSM-Diensten haben: Verwaltungsagent, Verwaltungs-Controller, Client-Dateidienst, Cluster-Controller, Service Manager und Lizenzdienst. Dieser Konfigurationsschlüssel ändert nicht die Protokollierungsebene für den Koordinationsdienst oder für Wartungsprozesse. Weitere Informationen finden Sie unter Ändern von Protokollstufen und Tableau Server-Prozesse.

tsm.controlapp.log.level

Standardwert: info

Protokollierungsebene für control_<app>-Dienste. Diese Protokolle enthalten Informationen, die nützlich sein können, wenn beim Starten oder Neukonfigurieren eines TSM- oder Tableau Server-Prozesses Probleme auftreten. Weitere Informationen finden Sie unter Ändern von Protokollstufen.

usernotifications.reap_after_days

Standardwert: 30

Anzahl der Tage, nach denen eine Benutzerbenachrichtigung vom Server gelöscht wird.

vizportal.adsync.update_system_user

Standardwert: false

Legt fest, ob die E-Mail-Adressen und Anzeigenamen der Benutzer geändert werden (selbst wenn sie in Active Directory geändert werden), wenn eine Active Directory-Gruppe in Tableau Server synchronisiert wird. Um sicherzugehen, dass die E-Mail-Adressen der Benutzer und die Anzeigenamen während der Synchronisierung aktualisiert werden, setzen Sie vizportal.adsync.update_system_user auf true, und starten Sie dann den Server neu.

vizportal.alwaysUseEmbeddedShareLinks

Version: Hinzugefügt in Version 2021.3.0

Standardwert: false

Gibt an, ob die Option Link kopieren den Parameter "embed=y" enthalten soll. Ab Version 2019.4 ist dieser Parameter standardmäßig nicht mehr enthalten. Wenn dieser Konfigurationsschlüssel auf "true" gesetzt wird, ändert sich das Verhalten so, dass der Parameter "embed=y" enthalten ist. Ausführliche Informationen zur Verwendung der Option Link kopieren zum Freigeben von Links zum Einbetten in Webseiten finden Sie unter Einbetten von Ansichten in Webseiten(Link wird in neuem Fenster geöffnet) in der Tableau Desktop- und Webdokumenterstellungs-Hilfe.

vizportal.art_skip_list

Version: Hinzugefügt in Version 2024.2.

Standardwert: null

Verwenden Sie diesen Konfigurationsschlüssel, um Aspekte der Tableau Server-Funktionalität anzugeben, die keine Aktivitäts- und Ressourcenablaufverfolgung (ART) verwenden und bei aktivierter ART große Mengen unnötiger Daten generieren.

Dieser Schlüssel wird zusammen mit vizportal.log_art_java und vizportal.enable_art zur Behebung von Problemen mit dem Anwendungsserver (VizPortal) verwendet. Wenn eingestellt auf [benötige hier Informationen darüber, worauf es eingestellt wird.] Informationen zur Verwendung dieser Konfigurationseinstellung finden Sie unter Beheben von Problemen mit dem Anwendungsserver.

vizportal.csv_user_mgmt.index_site_users

Version: In Version 2022.3 veraltet. In Version 2023.3 eingestellt (vollständig entfernt).

Standardwert: true

Gibt an, ob die Indexierung von Site-Benutzern beim Import oder beim Löschen der einzelnen Benutzer mit einer CSV-Datei erfolgt. Falls true eingestellt ist, erfolgt die (standardmäßige) Indexierung, wenn die einzelnen Benutzer hinzugefügt bzw. gelöscht werden. Um die Indexierung der Sitebenutzer zu verzögern, bis die gesamte CSV-Datei bearbeitet wurde, stellen Sie den Wert false ein.

vizportal.csv_user_mgmt.bulk_index_users

Version: In Version 2022.3 veraltet. In Version 2023.3 eingestellt (vollständig entfernt).

Standardwert: false

Gibt an, ob das Indexieren von Site-Benutzern beim Importieren oder Löschen von Benutzern mit einer CSV-Datei als Sammelvorgang erfolgen soll. Wenn auf false gesetzt (Standardeinstellung), wird die Indexierung für jeden Benutzer einzeln durchgeführt. Wenn die Indexierung als Sammelvorgang erfolgen soll, nachdem die CSV-Datei verarbeitet wurde, legen Sie diese Option auf true fest.

vizportal.enable_art

Version: Hinzugefügt in Version 2024.2.

Standardwert: false

Dieser Konfigurationsschlüssel wird zusammen mit vizportal.log_art_java und vizportal.art_skip_list zur Behebung von Problemen mit dem Anwendungsserver (VizPortal) verwendet. Wenn der Wert auf „true“ gesetzt ist, wird die Aktivitäts- und Ressourcenverfolgung im Anwendungsserver aktiviert. Informationen zur Verwendung dieser Konfigurationseinstellung finden Sie unter Beheben von Problemen mit dem Anwendungsserver.

vizportal.log_art_java

Version: Hinzugefügt in Version 2024.2.

Standardwert: false

Dieser Konfigurationsschlüssel wird zusammen mit vizportal.enable_art und vizportal.art_skip_list zur Behebung von Problemen mit dem Anwendungsserver (VizPortal) verwendet. Wenn der Wert auf „true“ gesetzt ist, wird die Aktivitäts- und Ressourcenverfolgung im Anwendungsserver aktiviert. Informationen zur Verwendung dieser Konfigurationseinstellung finden Sie unter Beheben von Problemen mit dem Anwendungsserver.

vizportal.oauth.connected_apps.max_expiration_period_in_minutes

Version: Hinzugefügt in Version 2021.4.

Standardwert: 10

Die maximale Gültigkeitsdauer des JSON-Webtokens (JWT) in Minuten. Bei der Überprüfung des JWT prüft Tableau Server, ob der im JWT angegebene Zeitraum diesen Standardwert nicht überschreitet. Diese Einstellung wird verwendet, wenn eine mit Tableau verbundene App auf Tableau Server mithilfe der Tableau REST API(Link wird in neuem Fenster geöffnet) konfiguriert wurde.

Um beispielsweise die maximale Dauer auf 5 Minuten zu ändern, führen Sie den folgenden Befehl aus:

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

vizportal.oauth.external_authorization.enabled

Version: Hinzugefügt in Version 2021.4.

Standardwert: false

Ab Tableau Server 2024.2 ist die Option Verbundene Apps aktivieren für Tableau Server aktiviert. Bis Tableau Server 2023.2 gibt sie an, ob die Option OAuth-Zugriff für das Einbetten von Inhalten aktivieren für Tableau Server aktiviert ist.

Verwenden Sie diese Option, um einen externen Autorisierungsserver (EAS) bei Tableau Server zu registrieren, sodass Sie Anwendungsintegration aktivieren können. Weitere Informationen finden Sie unter Konfigurieren von verbundenen Apps mit OAuth 2.0-Vertrauensstellung.

Um diese Option zu aktivieren, führen Sie den folgenden Befehl aus:

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

vizportal.oauth.external_authorization_server.blocklisted_jws_algorithms

Version: Hinzugefügt in Version 2021.4.

Standardwert: ES256K

Wenn ein externer Autorisierungsserver (EAS) registriert oder eine verbundene App konfiguriert wird, können Sie diesen Befehl verwenden, um den im JSON-Webtoken-Header (JWT) verwendeten Signieralgorithmus anzugeben. Weitere Informationen finden Sie unter Konfigurieren von verbundenen Apps mit OAuth 2.0-Vertrauensstellung oder Verwenden von mit Tableau verbundenen Apps für die Anwendungsintegration.

Bei Bedarf können Sie zum Beispiel den folgenden Befehl ausführen, um den Algorithmus zu entfernen:

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

Wichtig: Der obige Beispielbefehl erlaubt unsichere Signieralgorithmen und sollte nur zur Fehlersuche verwendet werden.

vizportal.oauth.external_authorization_server.issuer

Version: Hinzugefügt in Version 2021.4.

Standardwert: null

Erforderlich. Verwenden Sie diesen Befehl, um die URL des Ausstellers anzugeben. Die URL des Ausstellers ist erforderlich, um den externen Autorisierungsserver (EAS) bei Tableau Server zu registrieren. Weitere Informationen finden Sie unter Konfigurieren von verbundenen Apps mit OAuth 2.0-Vertrauensstellung.

Wenn Ihr EAS beispielsweise Okta ist, können Sie einen Befehl ähnlich dem folgenden ausführen:

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: Hinzugefügt in Version 2021.4.

Standardwert: null

Wenn ein externer Autorisierungsserver (EAS) registriert ist, können Sie diesen Befehl verwenden, um die JWKS-URL (JSON Web Key Set) anzugeben. Die JWKS-URL ist erforderlich, wenn der Identitätsanbieter (IdP) den Metadatenendpunkt des externen Autorisierungsservers nicht zur Verfügung stellt.

Wenn Ihr IdP beispielsweise Amazon Cognito ist, können Sie einen Befehl ähnlich dem folgenden ausführen:

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: Hinzugefügt in Version 2021.4.

Standardwert: 10

Die maximale Gültigkeitsdauer des JSON-Webtokens (JWT) in Minuten. Bei der Überprüfung des JWT prüft Tableau Server, ob der im JWT angegebene Zeitraum diesen Standardwert nicht überschreitet. Diese Einstellung wird verwendet, wenn ein EAS bei Tableau Server registriert wurde. Weitere Informationen finden Sie unter Konfigurieren von verbundenen Apps mit OAuth 2.0-Vertrauensstellung.

Um beispielsweise die maximale Dauer auf 5 Minuten zu ändern, führen Sie den folgenden Befehl aus:

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

vizportal.openid.full_server_request_logging_enabled

Standardwert: false

Gibt an, ob die OpenID-Aktivität vollständig protokolliert werden soll.

Setzen Sie diesen Wert auf true , wenn Sie Probleme mit OpenID Connect beheben, um detailliertere Protokolle zu sammeln und eine bessere Fehlerbehebung zu ermöglichen.

Wie bei allen Konfigurationen, die mit der Protokollierung zusammenhängen, empfehlen wir, dass Sie diesen Schlüssel auf den Standardwert (false) zurücksetzen, nachdem Sie die Fehlerbehebung und die Erfassung von Protokollen abgeschlossen haben. Dadurch wird die Menge der protokollierten Informationen begrenzt und die Größe der Protokolldatei auf ein Minimum beschränkt.

vizportal.password_reset

Version: Ersetzt features.PasswordReset in Version 2024.2.

Standardwert: false

Gilt nur für Server, die lokale Authentifizierung verwenden. Stellen Sie trueein, um Benutzern das Zurücksetzen ihrer Kennwörter mit einer Option "Kennwort vergessen" auf der Anmeldeseite zu ermöglichen.

vizportal.rest_api.cors.enabled

Standardwert: false

Legt fest, ob Tableau Server CORS (Cross Origin Resource Sharing) zulässt. Wenn der Wert true festgelegt ist, räumt der Server Webbrowsern Zugriff auf die Tableau REST API-Endpunkte ein. Sie können mithilfe dieser Option und der REST API benutzerdefinierte Portale erstellen. Standardmäßig ist diese Funktion nicht aktiviert. Um festzulegen, welche Ursprünge (Sites) Zugriff erhalten, verwenden Sie die Option vizportal.rest_api.cors.allow_origin. Nur die über diese Option festgelegten Ursprünge dürfen Anforderungen an die REST API von Tableau Server senden. Weitere Informationen finden Sie unter Aktivieren von CORS auf Tableau Server.

vizportal.site_user_group_count_enabled

Version: Hinzugefügt in Version 2022.3.5 und höher sowie 2023.1.0 und höher.

Standardwert: false

Steuert, ob die Seite "Site-Benutzer" eine Spalte enthält, die die Gruppenanzahl für jeden Benutzer anzeigt.

vizqlserver.force_maps_to_offline

Version: Hinzugefügt in Version 2020.4.0

Standardwert: false

Bestimmt, ob Tableau Server für Karten im Offlinemodus ausgeführt wird. Dies ist in getrennten Umgebungen nützlich, in denen der Zugriff auf das Internet und den Kartenserver eingeschränkt ist. Um den Offlinemodus für Karten zu aktivieren, legen Sie für diesen Wert true fest. Weitere Informationen über die Installation und Konfiguration von Tableau Server in einer Umgebung ohne Internetzugriff finden Sie unter Installieren von Tableau Server in einer nicht vernetzten Umgebung (Air-Gapped).

wgserver.authentication.legacy_identity_mode.enabled

Version: Hinzugefügt in Version 2022.1

Standardwert: false für Tableau Server 2022.1 (und höher). Für Tableau Server-Bereitstellungen von vor 2022.1, die auf 2022.1 oder höher aktualisiert wurden, lautet der Standardwert true.

Stellen Sie dies auf false, um Identitätspools zu verwenden.

Weitere Informationen finden Sie unter Fehlerbehebung bei Identitätspools.

wgserver.authentication.identity_pools.default_pool_description

Version: Hinzugefügt in Version 2023.1

Standardwert: null

Optional können Sie der Zielseite von Tableau Server eine Beschreibung für den anfänglichen Pool (TSM konfiguriert) hinzufügen, die für alle Benutzer sichtbar ist. Wenn ein oder mehrere Identitätspools erstellt werden, wird diese Beschreibung unter der primären Anmeldeoption hinzugefügt und kann verwendet werden, um Benutzer, die zum anfänglichen Pool (TSM konfiguriert) gehören, zur richtigen Anmeldeoption zu führen.

Um beispielsweise die Beschreibung "Regular employees sign in here" (Reguläre Mitarbeiter melden sich hier an) hinzuzufügen, können Sie den folgenden Befehl verwenden:

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

Hinweis: Die Beschreibung des anfänglichen Pools (TSM konfiguriert) unterscheidet sich vom Hinweis Anmeldeanpassung. Der Hinweis zur Anmeldeanpassung wird auf der Zielseite von Tableau Server unterhalb aller Anmeldeoptionen und auf der Seite angezeigt, auf der die Benutzer Ihres anfänglichen Pools (TSM konfiguriert) ihren Benutzernamen und ihr Kennwort eingeben.

wgserver.domain.accept_list

Version: Diese Option wurde in Version 2020.4.0 hinzugefügt und ersetzt wgserver.domain.whitelist.

Standardwert: null

Ermöglicht die Verbindung von Tableau Server zu sekundären Active Directory-Domänen. Eine sekundäre Domäne ist eine Domäne, mit der Tableau Server für die Benutzersynchronisierung eine Verbindung herstellt, auf der Tableau Server jedoch nicht installiert ist. Tableau Server versucht, eine Verbindung mit sekundären Domänen für die Benutzer- und Gruppensynchronisierung herzustellen. In einigen Fällen kann Tableau Server möglicherweise keine Verbindung mit der sekundären Domäne herstellen, was zu dem Fehler "Domain not in accept list (errorCode=101015)" führt.

Das Einstellen der wgserver.domain.accept_list-Option ist für die Korrektur dieser Sicherheitslücke erforderlich, [Wichtig] ADV-2020-003: Erzwungene Tableau Server-Authentifizierung(Link wird in neuem Fenster geöffnet). Seit Februar 2020 ist die Korrektur dieser Sicherheitslücke in allen neuesten Versionen und Wartungsversionen von Tableau Server enthalten.

Um diese Option einzustellen, geben Sie die sekundäre Domäne ein, die durch doppelte Anführungszeichen eingeschlossen ist. Mehrere Domänen müssen durch ein Komma und ein Leerzeichen getrennt werden. Beispiel: tsm configuration set -k wgserver.domain.accept_list -v "example.org, domain.com".

Die Platzhalterfunktionalität wird nicht unterstützt. Wenn Tableau z. B. eine Verbindung mit sub1.example.org und sub2.example.org herstellen soll, müssen beide Domänen hinzugefügt werden.

Durch das Aktualisieren der wgserver.domain.accept_list-Option wird der vorhandene Wert überschrieben. Wenn Sie daher eine neue Domäne zu einem vorhandenen Satz von Domänen hinzufügen, die im Wert gespeichert sind, schließen Sie alle vorhandenen Domänen in die neue Domäne ein, wenn Sie die Option einstellen. Sie können eine vollständige Liste der vorhandenen Domänen abrufen, indem Sie tsm configuration get –k wgserver.domain.accept_list ausführen.

wgserver.domain.ldap.domain_custom_ports

Standardwert: null

Ermöglicht die Zuordnung von Unterdomänen und deren LDAP-Ports. Domäne und Port sind durch einen Doppelpunkt (:) getrennt und jedes Domäne/Port-Paar ist durch ein Komma (,) getrennt. Dabei wird folgendes Format verwendet: FQDN1:port,FQDN2:port

Beispiel: tsm configuration set -k wgserver.domain.ldap.domain_custom_ports -v childdomain1.lan:3269,childdomain2.lan:3269,childdomain3.lan:389

wgserver.domain.password

Standardwert: null

Gibt das Kennwort für das Benutzerkonto an, das für die LDAP-Verbindung verwendet wird. Siehe Konfigurationsreferenz für externe Identitätsspeicher.

wgserver.domain.username

Standardwert: null

Gibt den Namen für das Benutzerkonto an, das für die LDAP-Verbindung verwendet wird. Siehe Konfigurationsreferenz für externe Identitätsspeicher.

wgserver.domain.whitelist

Wichtig: Dieser Schlüssel ist ab der Version 2020.4.0 veraltet. Verwenden Sie stattdessen wgserver.domain.accept_list .

Standardwert: null

Ermöglicht die Verbindung von Tableau Server zu sekundären Active Directory-Domänen. Eine sekundäre Domäne ist eine Domäne, mit der Tableau Server für die Benutzersynchronisierung eine Verbindung herstellt, auf der Tableau Server jedoch nicht installiert ist. Tableau Server versucht, eine Verbindung mit sekundären Domänen für die Benutzer- und Gruppensynchronisierung herzustellen. In einigen Fällen kann Tableau Server möglicherweise keine Verbindung mit der sekundären Domäne herstellen, was zu dem Fehler "Domäne nicht in der Whitelist (errorCode=101015)" führt.

wgserver.ignore_domain_in_username_for_matching

Version: Hinzugefügt in den Versionen 2021.4.21, 2022.1.17, 2022.3.9 und 2023.1.5

Standardwert: false

Wenn Sie SAML aktivieren, können Sie Tableau Server so konfigurieren, dass der Domänenteil des SAML-Benutzernamenattributs ignoriert wird, wenn der Benutzername des Identitätsanbieters (IdP) einem Benutzerkonto auf Tableau Server zugeordnet wird. Sie können den Domänenteil des Benutzernamensattributs ignorieren, wenn Sie in Tableau Server bereits Benutzer definiert haben, die mit dem Präfixteil eines Benutzernamensattributs, aber nicht mit dem Domänenteil des Benutzernamensattributs übereinstimmen. Weitere Informationen finden Sie im Abschnitt Ignorieren der Domäne beim Abgleichen des SAML-Benutzernamensattributs im Thema SAML-Anforderungen.

Um beispielsweise den Domänennamen im SAML-Benutzernamensattribut zu ignorieren, führen Sie den folgenden Befehl aus:

tsm configuration set -k wgserver.ignore_domain_in_username_for_matching -v true

Wichtig:

• Sie sollten den Benutzerdomänennamen nicht ignorieren, ohne Vorsichtsmaßnahmen zu ergreifen Überprüfen Sie insbesondere, ob die Benutzernamen über die konfigurierten Domänen hinweg, die Sie in Ihrem Identitätsanbieter erstellt haben, eindeutig sind.
• Dieser Befehl funktioniert nur in Tableau Server-Bereitstellungen, die im legacy-identity-mode sind, oder in Bereitstellungen, die nicht durch Identitätsmigration(Link wird in neuem Fenster geöffnet) aktualisiert wurden, um den Identitätsdienst zu nutzen.

wgserver.saml.blocklisted_digest_algorithms

Version: In Version 2021.1 hinzugefügt.

Standardwert: SHA1

Gibt die Hashing-Algorithmen an, die für relevante SAML-Zertifikatsignaturen oder SAML-Assertion-Digestmethoden oder Signaturmethoden nicht zulässig sind. Wenn diese Option festgelegt ist, werden Zertifikate und Assertionen, die mit einem blockierten Algorithmus signiert sind, abgelehnt und schlagen fehl.

Es gibt mehrere Stellen, an denen SHA-1 sowohl auf der Tableau- als auch auf der IdP-Seite verwendet werden kann. Beispiel:

• Über TSM hochgeladene Zertifikate, die von Tableau Server zum Signieren der an den IdP gesendeten Anforderung verwendet werden.
• Zertifikate in den IdP-Metadaten, mit denen die vom IdP empfangene AuthnResponse (Signatur) mithilfe des öffentlichen Schlüssels im Zertifikat überprüft wird.
• Eingehende Zusicherungen werden mit SHA-1 signiert und gehasht (DigestMethod auf SHA-1 und SignatureMethod auf SHA-1 gesetzt).

Der Standardwert wurde in Tableau Server 2021.2 in SHA1 geändert. Weitere Informationen zum Upgrade auf 2021.2 mit konfigurierter SAML finden Sie im Knowledge Base-Artikel Tableau Server Using SAML Authentication Fails to Start or Rejects Login After Upgrade to Tableau Server 2021.2.

wgserver.saml.forceauthn

Version: In Version 2019.3 hinzugefügt.

Standardwert: false

Wenn die Tableau-Benutzersitzung abläuft, authentifiziert Tableau Server den Benutzer erneut beim Identitätsanbieter, wenn dieser Wert auf true gesetzt ist. Diese Option kann auch verwendet werden, um den Identitätsanbieter zur erneuten Authentifizierung des Benutzers aufzufordern, selbst wenn für den Benutzer eine aktive Identitätsanbieter-Sitzung besteht.

wgserver.saml.min_allowed.elliptic_curve_size

Standardwert: 256

Version: Wurde in Version 2021.1 hinzugefügt, enthält aber keinen Standardwert. In Version 2021.2 wurde der Standardwert auf 256 gesetzt.

Diese Option gibt die minimal zulässige ECDSA-Kurvengröße für das für die SAML-Authentifizierung verwendete Zertifikat an. Wenn Sie ein Zertifikat mit einer ECDSA-Kurvengröße von weniger als 256 hochladen, protokolliert TSM einen Fehler, wenn Sie Änderungen anwenden.

Wenn Sie ein Upgrade auf Tableau Server 2021.2 oder höher durchführen und Ihr SAML-Zertifikat eine ECDSA-Kurvengröße von weniger als 256 verwendet, wird Tableau Server nach dem Upgrade nicht gestartet. Wir empfehlen, vor dem Upgrade ein neues Zertifikat mit einer ECDSA-Kurvengröße von 256 (oder mehr) hochzuladen. Alternativ können Sie diesen Befehl ausführen, um vor dem Upgrade eine niedrigere ECDSA-Kurvengröße für ältere Versionen (vor 2021.1) von Tableau Server festzulegen. Wenn Sie diesen Befehl in einer Version vor 2021.1 ausführen, müssen Sie die Option --force-keys in den Befehl einschließen. Weitere Informationen zum Upgrade auf 2021.2 mit konfigurierter SAML finden Sie im Knowledge Base-Artikel 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

Standardwert: 2048

Version: Wurde in Version 2021.1 hinzugefügt, enthält aber keinen Standardwert. In Version 2021.2 wurde der Standardwert auf 2048 gesetzt.

Diese Option gibt die minimal zulässige RSA-Schlüssellänge für das für die SAML-Authentifizierung verwendete Zertifikat an. Wenn Sie ein Zertifikat mit einer RSA-Schlüssellänge von weniger als 2048 hochladen, protokolliert TSM einen Fehler, wenn Sie Änderungen anwenden.

Um die SAML-Authentifizierung mit einer RSA-Schlüssellänge von 1024 durchzuführen (nicht empfohlen), setzen Sie diesen Wert auf 1024.

Wenn Sie ein Upgrade auf Tableau Server 2021.2 oder höher durchführen und Ihr SAML-Zertifikat eine Schlüssellänge von weniger als 2048 verwendet, wird Tableau Server nach dem Upgrade nicht gestartet. Wir empfehlen, vor dem Upgrade ein neues Zertifikat mit einer Schlüssellänge von 2048 (oder mehr) hochzuladen. Alternativ können Sie diesen Befehl ausführen, um eine niedrigere Schlüsselstärke für ältere Versionen (vor 2021.1) von Tableau Server festzulegen, bevor Sie ein Upgrade durchführen. Wenn Sie diesen Befehl in einer Version vor 2021.1 ausführen, müssen Sie die Option --force-keys in den Befehl einschließen. Weitere Informationen zum Upgrade auf 2021.2 mit konfigurierter SAML finden Sie im Knowledge Base-Artikel Tableau Server Using SAML Authentication Fails to Start or Rejects Login After Upgrade to Tableau Server 2021.2.