Beispiel für eine Konfigurationsdatei
Dieser Artikel beinhaltet ein Beispiel für eine vollständige JSON-Konfigurationsdatei, in der die Entitäten gatewaySettings und identityStore festgelegt sind. Darüber hinaus ist der Wert für die Gateway-Zeitüberschreitung von einem Konfigurationsschlüssel auf 900 Sekunden festgelegt.
Abhängig von den Optionen, die Sie festlegen müssen, sieht Ihre Konfigurationsdatei möglicherweise anders aus.
Sie können während der Installation mehrere .json-Konfigurationsdateien festlegen. Führen Sie den folgenden Befehl einmal pro Konfigurationsdatei aus, um die Werte für jede Datei in Tableau Server festzulegen:
tsm settings import -f path-to-file.json
Nach der Festlegung der Konfigurationsdateien müssen Sie den Befehl tsm pending-changes apply ausführen, um die Änderungen von all den von Ihnen festgelegten .json-Dateien anzuwenden.
{ "configEntities": { "gatewaySettings": { "_type": "gatewaySettingsType", "port": 80, "publicHost": "localhost", "publicPort": 80 }, "identityStore": { "_type": "identityStoreType", "type": "local", "domain": "example.lan", "nickname": "EXAMPLE" } }, "configKeys": { "gateway.timeout": "900" } }
Entitäten im Vergleich zu Schlüsseln
Wie im vorherigen Beispiel gezeigt, gibt es zwei Klassen von Konfigurationparametern: configEntities und configKeys.
configEntities
Bestimmte Konfigurationstypen werden mithilfe von Entitätssätzen ausgeführt, die mit bestimmten Szenarien verknüpft sind, wie beispielsweise die Identitätsspeicher- und Gateway-Konfigurationen. Wenn Sie einen Satz von "configEntities" mit dem Befehl tsm settings import -f path-to-file.json
übermitteln, validiert TSM die Konfiguration. Wenn übermittelte Werte ungültig sind, gibt TSM einen Fehler aus. Auf diese Weise können Sie bereits während des Konfigurationsprozesses Änderungen vornehmen, anstatt dass während der Initialisierung oder Laufzeit ein Konfigurationsfehler angezeigt wird.
Entitäten können nur durch Einfügen eines "configEntities"-Blocks in eine .json-Datei festgelegt werden.
Wichtig: Dateien, auf die in "configEntities" verwiesen wird, müssen sich auf dem lokalen Computer befinden. Geben Sie keine UNC-Pfade an.
configKeys
Entitäten decken nur einen kleinen Teil der Konfigurationswerte ab, die festgelegt werden können. Hunderte von Schlüsseln entsprechen Parametern, die in .yml-Dateien gespeichert sind. Tableau Server verwendet diese Parameter zum Speichern all der Konfigurationsinformationen für alle Dienste.
Sie können einzelne Schlüssel mit dem Befehl tsm configuration festlegen. Es ist jedoch effizienter, sie während der Bereitstellung zusammen mit anderen Konfigurationsszenarien in JSON-Dateien (wie zuvor beschrieben) festzulegen.
Im Gegensatz zu configEntities werden configKeys nicht validiert.
Hinweis: Es wird nicht empfohlen, Parameter festzulegen, die nicht unter tsm configuration set-Optionen dokumentiert sind.