Voorbeeld van configuratiebestand

Dit artikel geeft een voorbeeld van een compleet JSON-configuratiebestand, waarin gatewaySettings- en IdentityStore-entiteiten zijn opgegeven. Daarnaast stelt een configuratiesleutel de gatewaytime-out in op 900 seconden.

Uw configuratiebestand zal er anders uitzien, afhankelijk van de opties die u moet instellen.

Mogelijk stelt u tijdens de installatie meerdere JSON-configuratiebestanden in. Als u de waarden wilt instellen voor elk bestand in Tableau Server, voert u de volgende opdracht voor elk configuratiebestand één keer uit:

tsm settings import -f path-to-file.json

Nadat u de configuratiebestanden hebt ingesteld, voert u tsm pending-changes apply uit om de wijzigingen toe te passen van alle JSON-bestanden die u hebt ingesteld.

{
   "configEntities": {
      "gatewaySettings": {
         "_type": "gatewaySettingsType",
         "port": 80,
         "publicHost": "localhost",
         "publicPort": 80
      },
      "identityStore": {
         "_type": "identityStoreType",
         "type": "local",
         "domain": "example.lan",
         "nickname": "EXAMPLE"
      }
    },
     "configKeys": {
        "gateway.timeout": "900"
     }
}

Entiteiten versus sleutels

Zoals u in het bovenstaande voorbeeld kunt zien, zijn er twee klassen configuratieparameters: configEntities en configKeys.

configEntities

Bepaalde soorten configuraties worden uitgevoerd via entiteitensets die zijn toegewezen aan specifieke scenario's, zoals identiteitsopslag- en gatewayconfiguraties. Wanneer u een set configEntities doorgeeft met de opdracht tsm settings import -f path-to-file.json, valideert TSM de configuratie. Als doorgegeven waarden ongeldig zijn, geeft TSM een foutmelding. Hierdoor kunt u tijdens het configuratieproces wijzigingen aanbrengen, in plaats van tijdens de initialisatie of runtime een configuratiefout te krijgen.

Entiteiten kunnen alleen worden ingesteld door een configEntities-blok op te nemen in een JSON-bestand.

Belangrijk: alle bestanden waar in configEntities naar wordt verwezen, moeten zich op de lokale computer bevinden. Geef geen UNC-paden op.

configKeys

Entiteiten dekken slechts een klein deel van de configuratiewaarden die kunnen worden ingesteld. Er zijn honderden sleutels die overeenkomen met parameters die zijn opgeslagen in YML-bestanden. Tableau Server gebruikt deze parameters om alle configuratie-informatie voor alle services op te slaan.

U kunt afzonderlijke sleutels instellen met de opdracht tsm configuration. Maar tijdens de implementatie is het handiger om ze binnen andere configuratiescenario's in JSON-bestanden in te stellen, zoals hierboven weergegeven.

In tegenstelling tot configEntities worden configKeys niet gevalideerd.

Opmerking: we raden niet aan om parameters in te stellen die niet zijn gedocumenteerd in tsm configuration set-opties.

Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.