Détails de la configuration du fichier platform-settings.json

Installation et configuration > Installation de ThingWorx > Annexes relatives à l'installation > Détails de la configuration du fichier platform-settings.json

Le fichier platform-settings.json permet aux administrateurs d'ajuster les paramètres pour l'optimisation et est accessible dans les téléchargements logiciels.

L'exemple ci-dessous contient toutes les options. Seul le fournisseur de persistance est requis.

{
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "/ThingworxBackupStorage",
"DatabaseLogRetentionPolicy": 7,
"EnableBackup": true,
"EnableHA": false,
"EnableSystemLogging": false,
"EnableSSO": false,
"FileRepositoryRoot": "/ThingworxStorage",
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"InternalAesCryptographicKeyLength": 128,
"Storage": "/ThingworxStorage",
"ScriptTimeout": 30
},
"SolutionCentralSettings": {
"SolutionCentralHost": "<Solution Central host name>",
"KeyStorePath": "<Path for your keystore>",
"KeyStorePass": "<Password for your keystore>"
},
"AdministratorUserSettings": {
"InitialPassword": "changeme"
},
"ContentTypeSettings": {
"supportedMediaEntityContentTypes" : ["image/svg+xml","image/png","image/gif","image/bmp","image/jpeg","application/pdf","image/vnd.microsoft.icon"]
},
"OrchestrationSettings": {
"EnableOrchestration": true,
"QueueHost": "localhost",
"QueuePort": 5672,
"QueueName": "256mb",
"QueueUsername": "flowuser",
"QueuePassword": "encrypt.queue.password",
"QueueVHost": "orchestration"
},
"ExtensionPackageImportPolicy": {
"importEnabled": false,
"allowJarResources": false,
"allowJavascriptResources": false,
"allowCSSResources": false,
"allowJSONResources": false,
"allowWebAppResources": false,
"allowEntities": false,
"allowExtensibleEntities": false
},
"HASettings": {
"CoordinatorConnectionTimeout": 15000,
"CoordinatorHosts": "127.0.0.1:2181",
"CoordinatorMaxRetries": 3,
"CoordinatorRetryTimeout": 1000,
"CoordinatorSessionTimeout": 90000,
"CoordinatorZNode": "/HALeadershipCoordinator",
"LoadBalancerBase64EncodedCredentials": "QWRtaW5pc3RyYXRvcjphZG1pbg=="
},
"LicensingConnectionSettings": {
"username": "<username>",
"password": "<password>",
"timeout":"60",
"useProxy": false,
"proxyHost": "<proxyHost>",
"proxyPort" : "<proxy port>",
"proxyScheme": "<http or https>",
"proxyUseNTLM": true,
"proxyUsername": "<user>",
"proxyPassword": "<user password>",
"proxyWorkstation": "<dummyWorkstation>",
"proxyDomain": "<dummyDomain>"
}
},
"PersistenceProviderPackageConfigs": {
"NeoPersistenceProviderPackage": {
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"scanRate": 5,
"sizeThreshold": 1000
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 500000,
"maximumWaitTime": 10000,
"scanRate": 5,
"sizeThreshold": 1000
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
}
},
"H2PersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 30,
"acquireRetryDelay": 1000,
"checkoutTimeout": 2000,
"idleConnectionTestPeriod": 6,
"initialPoolSize": 10,
"maxConnectionAge": 0,
"maxIdleTime": 0,
"maxIdleTimeExcessConnections": 36000,
"maxPoolSize": 100,
"maxStatements": 0,
"maxStatementsPerConnection": 50,
"minPoolSize": 10,
"numHelperThreads": 6,
"password": "password",
"tableLockTimeout": 10000,
"testConnectionOnCheckout": false,
"unreturnedConnectionTimeout": 0,
"username": "twadmin"
},
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 10000,
"maximumQueueSize": 500000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
}
},
"PostgresPersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 3,
"acquireRetryDelay": 10000,
"checkoutTimeout": 1000000,
"driverClass": "org.postgresql.Driver",
"fetchSize": 5000,
"idleConnectionTestPeriod": 60,
"initialPoolSize": 5,
"jdbcUrl": "jdbc:postgresql://localhost:5432/thingworx",
"maxConnectionAge": 0,
"maxIdleTime": 0,
"maxIdleTimeExcessConnections": 300,
"maxPoolSize": 100,
"maxStatements": 100,
"minPoolSize": 5,
"numHelperThreads": 8,
"password": "password",
"testConnectionOnCheckout": false,
"unreturnedConnectionTimeout": 0,
"username": "twadmin"
},
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 500000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
}
},
"MssqlPersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 3,
"acquireRetryDelay": 10000,
"checkoutTimeout": 1000000,
"driverClass": "com.microsoft.sqlserver.jdbc.SQLServerDriver",
"fetchSize": 5000,
"idleConnectionTestPeriod": 60,
"initialPoolSize": 5,
"jdbcUrl": "jdbc:sqlserver://localhost:1433;databaseName=thingworx;applicationName=Thingworx;",
"maxConnectionAge": 0,
"maxIdleTime": 0,
"maxIdleTimeExcessConnections": 300,
"maxPoolSize": 100,
"maxStatements": 100,
"minPoolSize": 5,
"numHelperThreads": 8,
"password": "Password@123",
"testConnectionOnCheckout": false,
"unreturnedConnectionTimeout": 0,
"username": "msadmin"
},
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 10000,
"maximumQueueSize": 500000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
}
}
}
}

Options du fichier platform-settings.json

Pour toutes les bases de données répertoriées ci-dessous, les instructions suivantes doivent être respectées pour les paramètres du processeur de flux de valeurs et les paramètres du processeur de flux :

StreamProcessorSettings.numberOfProcessingThreads + ValueStreamProcessorSettings.numberOfProcessingThreads < 50% of DB connection pool
And
ValueStreamProcessorSettings.numberOfProcessingThreads >= StreamProcessorSettings.numberOfProcessingThreads

Paramètres de base

Paramètre

Par défaut

Description

BackupStorage

/ThingworxBackupStorage

Nom du répertoire de toutes les sauvegardes.

DatabaseLogRetentionPolicy

Nombre de jours pendant lesquels les journaux de base de données sont conservés.

EnableBackup

true

Détermine si les sauvegardes sont conservées.

EnableHA

false

Détermine si ThingWorx peut être configuré pour un environnement haute disponibilité.

EnableSystemLogging

false

Détermine si la journalisation système est activée.

N'activez pas ce paramètre, à moins d'y être invité par le support ThingWorx.

EnableSSO

false

Définissez ce paramètre sur Vrai pour activer l'authentification unique pour ThingWorx Platform. Lorsque l'authentification unique est activée, toute authentification est redirigée vers le serveur d'autorisation central configuré dans le fichier sso-settings.json. L'authentification WebSocket Edge n'est pas affectée.

FileRepositoryRoot

/ThingworxStorage

Le répertoire où le référentiel de fichiers racine est créé. L'emplacement par défaut est suffisant pour les déploiements autonomes. Pour les déploiements ThingWorx haute disponibilité (HA), le référentiel doit se trouver sur un système de fichiers partagé accessible par tous les serveurs ThingWorx.

HTTPRequestHeaderMaxLength

2000

Longueur maximale autorisée pour les valeurs d'en-tête des requêtes HTTP.

HTTPRequestParameterMaxLength

2000

Longueur maximale autorisée pour les valeurs de paramètre des requêtes HTTP.

InternalAesCryptographicKeyLength

128

Longueur de clé utilisée lors de la génération d'une clé AES symétrique. Les valeurs prises en charge sont 128, 192 et 256.

Si la longueur de clé est supérieure à 128 et que les politiques Java ne sont pas configurées pour utiliser cette taille de clé, le chiffrement et le déchiffrement échoueront.

Storage

/ThingworxStorage

Répertoire de création/localisation de tous les dossiers de stockage (à l'exception du stockage de sauvegarde).

ScriptTimeout

Nombre maximal de secondes pendant lesquelles un script peut s'exécuter avant que la plateforme ThingWorx n'y mette fin.

Les scripts de la plateforme sont arrêtés automatiquement s'ils s'exécutent plus longtemps que le nombre de secondes configuré pour ce délai d'expiration.

Prenez en considération la sensibilité et/ou l'importance des informations gérées par les scripts lors de la configuration de leur délai d'inactivité. Bien qu'il soit important de mettre fin à des scripts après une période donnée pour des raisons de sécurité, le faire prématurément peut entraîner une perte de données. En raison de la flexibilité de ThingWorx Platform, il existe des cas d'utilisation susceptibles de nécessiter des délais d'inactivité plus courts ou plus longs que la valeur par défaut.

Paramètres Solution Central

Paramètre

Par défaut

Description

SolutionCentralHost

sc.thingworx.com

Nom d'hôte Solution Central

SolutionCentralPort

443

Détails du port Solution Central

Ne définissez pas SolutionCentralPort si la valeur est définie par défaut.

KeyStorePath

/ThingworxPlatform/sc-keystore

Chemin d'accès au KeyStore

KeyStorePass

Aucun

Mot de passe de votre KeyStore

Pour le chiffrement de votre mot de passe, définissez KeyStorePass sur encrypt.sc.password.

Paramètres de ThingWorx Flow

Ces propriétés ne s'appliquent que si ThingWorx Flow est installé sur ThingWorx Foundation. Ces valeurs doivent être définies dans les fichiers de configuration de ThingWorx Flow et de RabbitMQ et ne doivent pas être modifiées, sauf si elles le sont dans les deux applications.

Paramètre

Par défaut

Description

EnableOrchestration

vrai

Indique si ThingWorx Flow est activé dans ThingWorx Foundation.

QueueHost

localhost

Nom d'hôte RabbitMQ

QueuePort

5672

Port RabbitMQ

QueueName

256mb

Nom de la file d'attente RabbitMQ

QueueUsername

flowuser

Nom d'utilisateur de la file d'attente RabbitMQ

QueuePassword

encrypt.queue.password

Mot de passe de la file d'attente RabbitMQ

Le mot de passe est automatiquement chiffré lors de l'installation de ThingWorx Flow sur la même machine que ThingWorx Foundation.

Si ThingWorx Flow n'est pas installé sur le même ordinateur que ThingWorx Foundation, vous devez chiffrer ce mot de passe.

QueueVHost

orchestration

Nom VHost RabbitMQ

Politique d'importation des packages d'extension

L'importation d'extensions est désactivée par défaut pour tous les utilisateurs. Utilisez les paramètres suivants pour configurer la fonctionnalité d'importation d'extensions. Consultez la rubrique Importation d'extensions pour plus d'informations.

Paramètre

Description

Par défaut

Exemples

importEnabled

Contrôle le niveau supérieur qui définit l'autorisation (=true) ou l'interdiction (=false) d'importer des extensions.

false

• "importEnabled": false : l'importation d'extensions est impossible, même si d'autres paramètres ExtensionPackageImportPolicy sont définis sur "true".

• "importEnabled": true : transmet l'importation d'extensions à l'ensemble suivant de paramètres allow<Content>Resources (voir les lignes ci-dessous).

Si les paramètres allow<Content>Resources sont définis sur "false", une extension vide (qui ne contient aucune entité, entité extensible ou ressource) peut être importée. Cette configuration n'est cependant pas particulièrement utile. Ainsi, si importEnabled est défini sur "true", au moins un autre paramètre allow<Content>Resources doit également être défini sur "true".

allowJarResources

Autorise l'importation d'extensions avec ressources JAR.

false

• "allowJarResources": true : autorise l'importation d'extensions déclarant dans leur manifeste les fichiers JAR comme ressources JAR.

• "allowJarResources": false : n'autorise pas l'importation d'extensions déclarant dans leur manifeste les fichiers JAR comme ressources JAR.

allowJavascriptResources

Autorise l'importation d'extensions avec ressources JavaScript.

false

• "allowJavascriptResources": true : autorise l'importation d'extensions déclarant dans leur manifeste les ressources du fichier de l'interface utilisateur JavaScript de type JS comme ressources JavaScript.

• "allowJavascriptResources": false : n'autorise pas l'importation d'extensions déclarant dans leur manifeste les ressources du fichier de l'interface utilisateur JavaScript de type JS comme ressources JavaScript.

allowCSSResources

Autorise l'importation d'extensions avec ressources CSS.

false

• "allowCSSResources": true : autorise l'importation d'extensions contenant des ressources du fichier de l'interface utilisateur CSS.

• "allowCSSResources": false : n'autorise pas l'importation d'extensions contenant des ressources du fichier de l'interface utilisateur CSS.

allowJSONResources

Autorise l'importation d'extensions contenant des ressources JSON (par exemple, des fichiers de localisation).

false

• "allowJSONResources": true : autorise l'importation d'extensions contenant des ressources du fichier de l'interface utilisateur JSON.

• "allowJSONResources": false : n'autorise pas l'importation d'extensions contenant des ressources du fichier de l'interface utilisateur JSON.

allowWebAppResources

Autorise l'importation d'extensions avec ressources WebApp.

false

• "allowWebAppResources": true : autorise l'importation d'extensions contenant des ressources du fichier de l'interface utilisateur WebApp.

• "allowWebAppResources": false : n'autorise pas l'importation d'extensions contenant des ressources du fichier de l'interface utilisateur WebApp.

allowEntities

Autorise l'importation d'extensions contenant des entités non extensibles. Voici quelques exemples d'entités non extensibles :

• Clé d'application

• Authentificateur

• Tableau de bord

• Définition d'analyse de données

• Forme de données

• GenericContentEntity et classes enfant dérivées comme les définitions d'état et de style, le thème stylistique, etc.

• Groupe

• Table de localisation

• Logarithme

• Application composite

• Entité de média

• Menu

• ModeledServiceProviderEntity et classes enfant comme le contenu de notification

• Réseau

• Définition de notification

• Organisation

• Fournisseur de persistance

• PersistenceProviderPackage et classes enfant dérivées

• Projet

• Forme d'objet

• Modèle d'objet

• Utilisateur

• Vocabulaire et classes enfant dérivées comme DataTagVocabulary et ModelTagVocabulary

false

• "allowEntities": true : autorise l'importation d'extensions déclarant dans leur manifeste des entités non extensibles.

• "allowEntities": false : n'autorise pas l'importation d'extensions déclarant dans leur manifeste des entités non extensibles.

allowExtensibleEntities

Autorise l'importation d'extensions contenant des entités non extensibles. Voici quelques exemples d'entités extensibles :

• DirectoryService et classes enfant dérivées

• ExtensionPackage

• Ressource et classes enfant dérivées contenant des services/fonctions personnalisés utilisés comme ressources similaires aux ressources standard comme InfoTableFunctions, EntityServices et EncryptionServices.

Les sous-systèmes standard qui ne font pas partie d'extensions ne sont pas affectés.

• ScriptFunctionLibrary et classes enfant dérivées

• Sous-système et classes enfant dérivées

Les sous-systèmes standard qui ne font pas partie d'extensions ne sont pas affectés.

• Package d'objet

• Widget

false

• "allowExtensibleEntities": true : autorise l'importation d'extensions déclarant dans leur manifeste des entités extensibles.

• "allowExtensibleEntities": false : n'autorise pas l'importation d'extensions déclarant dans leur manifeste des entités extensibles.

Paramètres HA

Paramètres spécifiques à une configuration haute disponibilité (HA) PostgreSQL. Tous les paramètres sont ignorés si le paramètre EnableHA est défini sur false. CoordinatorHosts et LoadBalancerBase64EncodedCredentials doivent être modifiés en fonction de votre environnement.

Paramètre

Par défaut

Description

CoordinatorConnectionTimeout

15000

Délai d'attente (en millisecondes) d'une connexion avec le service Apache ZooKeeper utilisé pour coordonner la priorité de ThingWorx.

CoordinatorHosts

127.0.0.1:2181

Liste délimitée par des virgules des serveurs Apache ZooKeeper utilisés pour coordonner la priorité de ThingWorx. Le modèle de chaîne est IP:port (par exemple, "127.0.0.1:2181, 127.0.0.2:2181").

CoordinatorMaxRetries

Nombre maximal autorisé de tentatives d'établissement d'une connexion avec le service Apache ZooKeeper utilisé pour coordonner la priorité de ThingWorx.

CoordinatorRetryTimeout

1000

Délai d'attente (en millisecondes) pour chaque nouvelle tentative.

CoordinatorSessionTimeout

90000

Délai d'attente par ThingWorx (en millisecondes) d'une pulsation du service Apache ZooKeeper utilisé pour coordonner la priorité de ThingWorx.

CoordinatorZNode

/HALeadershipCoordinator

Lorsqu'un service Apache ZooKeeper est partagé par plusieurs déploiements ThingWorx HA, ce paramètre doit fournir une valeur unique pour chaque d'eux. La valeur de ce paramètre peut être arbitraire mais doit respecter le format /<votreTexte>. Prenons, par exemple, les instances ThingWorx TWX1 et TWX2 sur le système HA A, et les instances ThingWorx TWX3 et TWX4 sur le système HA B. CoordinatorZNode est défini sur /HAsystemA pour TWX1 et TWX2, et sur /HAsystemB pour TWX3 et TWX4.

LoadBalancerBase64EncodedCredentials

QWRtaW5pc3RyYXRvcjphZG1pbg==

Informations d'identification codées en Base64 pour l'équilibreur de charge HA, au format <utilisateur>:<mot de passe unique>.

N'utilisez pas un utilisateur ThingWorx.

Vous pouvez utiliser n'importe quel utilitaire pour coder en Base64 la chaîne <utilisateur>:<mot de passe unique> correspondante utilisée dans la configuration de votre équilibreur de charge.

Paramètres utilisateur administrateur

Paramètre	Par défaut	Description
InitialPassword	n/a	Mot de passe administrateur initial requis pour se connecter à ThingWorx pour la première fois. La longueur minimale peut être configurée dans le sous-système de gestion des utilisateurs (10 caractères minimum, la valeur par défaut est de 14 caractères). Consultez Mots de passe pour en savoir plus.

Paramètres de type de contenu

Paramètre

Par défaut

Description

supportedMediaEntityContentTypes

"image/svg+xml","image/png","image/gif","image/bmp","image/jpeg","application/pdf","image/vnd.microsoft.icon"

Liste des types de contenu MIME valides, séparés par une virgule, qui peuvent être liés dynamiquement aux entités de média. Des types supplémentaires peuvent être ajoutés.

Si le type de contenu provenant d'un serveur différent n'est pas un type d'entité de média pris en charge, le contenu est téléchargé sous la forme d'un fichier sur l'ordinateur client au lieu d'être diffusé avec l'entité de média.

Paramètres de connexion pour la licence

Paramètre

Par défaut

Description

username

n/a

Nom d'utilisateur du site de support PTC.

password

n/a

Mot de passe du site de support PTC.

timeout (en secondes)

Une fois le délai d'inactivité dépassé, le message d'erreur suivant est consigné dans le journal de l'application :

License Server could not process request

useProxy

faux

Active les paramètres de proxy pour la gestion des licences. Si la valeur est définie sur "vrai", les paramètres de proxy sont utilisés pour la connexion au serveur de licence.

proxyHost

Nom de l'hôte proxy.

proxyPort

Numéro de port de l'hôte proxy.

proxyScheme

http

http ou https.

proxyUsername

Nom d'utilisateur aux fins de l'authentification si la connexion au serveur proxy requiert une authentification.

proxyPassword

Mot de passe aux fins de l'authentification si la connexion au serveur proxy requiert une authentification.

Pour plus d'informations sur le chiffrement de cette valeur, consultez la section Chiffrement de mots de passe.

proxyUseNTLM

faux

Option permettant d'utiliser le protocole NTLM.

proxyWorkstation

Nom de l'ordinateur de l'utilisateur sur le réseau, si l'authentification NTLM est requise.

proxyDomain

Nom du domaine de l'utilisateur, si l'authentification NTLM est requise.

NeoPersistenceProviderPackage

Contient les paramètres du fournisseur de persistance spécifiques à Neo4j. Si Neo4j n'est pas le fournisseur de persistance, cette section doit être ignorée.

Paramètre	Par défaut	Description
StreamProcessorSettings
maximumBlockSize	2500	Nombre maximal d'écritures de flux à traiter dans un bloc.
maximumQueueSize	250000	Nombre maximal d'entrées de flux à mettre en file d'attente (les suivantes seront rejetées).
maximumWaitTime	10000	Délai d'attente maximal (en millisecondes) avant le vidage du tampon de flux.
scanRate	5	Fréquence (en millisecondes) selon laquelle le statut du tampon est vérifié.
sizeThreshold	1000	Nombre maximal d'éléments à accumuler avant le vidage du tampon de flux.
ValueStreamProcessorSettings
maximumBlockSize	2500	Nombre maximal d'écritures de flux à traiter dans un bloc.
maximumQueueSize	500000	Nombre maximal d'entrées de flux à mettre en file d'attente (les suivantes seront rejetées).
maximumWaitTime	10000	Délai d'attente maximal (en millisecondes) avant le vidage du tampon de flux.
scanRate	5	Fréquence (en millisecondes) selon laquelle le statut du tampon est vérifié.
sizeThreshold	1000	Nombre maximal d'éléments à accumuler avant le vidage du tampon de flux.
PersistentPropertyProcessorSettings
maximumBlockSize	2500	Nombre maximal d'écritures de propriétés à traiter dans un bloc.
maximumWaitTime	1000	Délai d'attente maximal (en millisecondes) avant le vidage du tampon de propriété.
maximumQueueSize	100000	Nombre maximal d'entrées de propriété à mettre en file d'attente (les suivantes seront rejetées).
numberOfProcessingThreads	20	Nombre de threads à utiliser lors du traitement des propriétés.
scanRate	25	Fréquence (en millisecondes) selon laquelle le statut du tampon est vérifié.
sizeThreshold	1000	Nombre maximal d'éléments à accumuler avant le vidage du tampon de propriété.

H2PersistenceProviderPackage

Paramètre

Par défaut

Description

Informations de connexion

acquireIncrement

Détermine le nombre de connexions simultanées que ThingWorx tentera d'acquérir lorsque le pool est épuisé.

acquireRetryAttempts

Définit le nombre maximal de tentatives de ThingWorx pour acquérir une nouvelle connexion à partir de la base de données.

acquireRetryDelay

1000

Délai (en millisecondes) attendu par ThingWorx entre chaque tentative.

checkoutTimeout

1000000

Délai en millisecondes attendu par un client appelant getConnection() pour récupérer ou obtenir une connexion lorsque le pool est épuisé.

idleConnectionTestPeriod

Période de temps (en secondes) pendant laquelle les connexions seront testées afin que les connexions inactives ne soient pas fermées par des processus externes, notamment les pare-feu. Si la valeur est supérieure à 0, ThingWorx testera toutes les x secondes les connexions inactives, dans le pool, mais non utilisées.

Si vous rencontrez des erreurs vous indiquant qu'aucune connexion n'est établie avec le fournisseur de modèles, vérifiez ce paramètre. Comparez-le avec les paramètres par défaut du pare-feu. Diminuer la valeur par défaut limitera les problèmes de déconnexion.

initialPoolSize

Nombre initial de connexions de base de données créées et conservées dans un pool au démarrage. Ce paramètre doit être compris entre minPoolSize et maxPoolSize.

maxConnectionAge

Durée de vie en secondes. Une connexion dont l'ancienneté est supérieure à la valeur de maxConnectionAge sera détruite et purgée du pool.

maxIdleTime

Nombre de secondes pendant lesquelles une connexion non utilisée peut rester dans le pool avant d'être supprimée. Une valeur de zéro signifie que les connexions inactives n'expireront jamais.

maxIdleTimeExcessConnections

36000

Délai en secondes pendant lequel les connexions en trop de minPoolSize sont autorisées à rester inactives dans le pool avant d'être détruites. Destiné aux applications qui souhaitent réduire considérablement le nombre de connexions ouvertes, en limitant le pool selon la valeur de minPoolSize si, après une pointe, le niveau de charge diminue et les connexions acquises ne sont plus nécessaires. Si maxIdleTime est défini, maxIdleTimeExcessConnections doit être inférieur pour être actif. Une valeur de zéro signifie qu'aucun délai n'est défini et que les connexions en trop ne seront pas désactivées.

maxPoolSize

100

Nombre maximal de connexions qu'un pool maintient à tout moment.

maxStatements

Taille du cache PreparedStatement global de ThingWorx.

maxStatementsPerConnection

Taille du cache PreparedStatement global ThingWorx pour chaque connexion.

minPoolSize

Nombre minimal de connexions qu'un pool maintient à tout moment.

numHelperThreads

Nombre de threads d'assistance à générer. Les opérations JDBC lentes sont généralement effectuées par des threads d'assistance qui ne disposent pas de verrouillage pour la contention. Le fait de répartir ces opérations sur plusieurs threads peut considérablement améliorer les performances, plusieurs opérations étant effectuées en même temps.

password

n/a

Mot de passe de la base de données.

username

twadmin

Nom d'utilisateur de la base de données.

tableLockTimeout

10000

Nombre de millisecondes attendues par un client pour le déverrouillage d'une table de base de données.

testConnectionOnCheckout

false

Si ce paramètre est défini sur Vrai, une opération sera exécutée à chaque récupération de connexion pour vérifier la validité de cette dernière.

unreturnedConnectionTimeout

Nombre de secondes attendues pour obtenir une réponse d'une connexion ne répondant pas avant de la supprimer. Si ce paramètre est défini, lorsqu'une application récupère une connexion, mais ne parvient pas à s'y connecter dans la période de temps spécifiée, le pool détruit la connexion. Cela permet aux applications subissant occasionnellement des pertes de connexion de persister, au lieu d'épuiser le pool de connexions. Une valeur de zéro signifie qu'aucun délai n'est défini et les applications sont tenues de fermer leurs propres connexions.

StreamProcessorSettings

maximumBlockSize

2500

Nombre maximal d'écritures de flux à traiter dans un bloc.

maximumQueueSize

250000

Nombre maximal d'entrées de flux à mettre en file d'attente (les suivantes seront rejetées).

maximumWaitTime

10000

Délai d'attente maximal (en millisecondes) avant le vidage du tampon de flux.

numberOfProcessingThreads

Nombre de threads à utiliser lors du traitement des propriétés.

scanRate

Fréquence (en millisecondes) selon laquelle le statut du tampon est vérifié.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de flux.

ValueStreamProcessorSettings

maximumBlockSize

2500

Nombre maximal d'écritures de flux à traiter dans un bloc.

maximumQueueSize

250000

Nombre maximal d'entrées de flux à mettre en file d'attente (les suivantes seront rejetées).

maximumWaitTime

10000

Délai d'attente maximal (en millisecondes) avant le vidage du tampon de flux.

numberOfProcessingThreads

Nombre de threads à utiliser lors du traitement des propriétés.

scanRate

Fréquence (en millisecondes) selon laquelle le statut du tampon est vérifié.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de flux.

PersistentPropertyProcessorSettings

maximumBlockSize

2500

Nombre maximal d'écritures de propriétés à traiter dans un bloc.

maximumWaitTime

1000

Délai d'attente maximal (en millisecondes) avant le vidage du tampon de propriété.

maximumQueueSize

100000

Nombre maximal d'entrées de propriété à mettre en file d'attente (les suivantes seront rejetées).

numberOfProcessingThreads

Nombre de threads à utiliser lors du traitement des propriétés.

scanRate

Fréquence (en millisecondes) selon laquelle le statut du tampon est vérifié.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de propriété.

PostgresPersistenceProviderPackage

Paramètre

Par défaut

Description

ConnectionInformation

acquireIncrement

Détermine le nombre de connexions simultanées que la plateforme tentera d'acquérir lorsque le pool est épuisé.

acquireRetryAttempts

Définit le nombre maximal de tentatives de ThingWorx pour acquérir une nouvelle connexion à partir de la base de données.

acquireRetryDelay

10000

Délai (en millisecondes) attendu par ThingWorx entre chaque tentative.

checkoutTimeout

10000000

Délai en millisecondes attendu par un client appelant getConnection() pour récupérer ou obtenir une connexion lorsque le pool est épuisé.

driverClass

org.postgresql.Driver

Nom de classe complet du paramètre driverClass JDBC censé fournir des connexions.

fetchSize

5000

Nombre de lignes à extraire par lots au lieu de mettre en cache toutes les lignes côté client.

idleConnectionTestPeriod

Si la valeur est supérieure à 0, ThingWorx testera toutes les x secondes les connexions inactives, dans le pool, mais non utilisées.

initialPoolSize

Nombre initial de connexions de base de données créées et conservées dans un pool au démarrage. Ce paramètre doit être compris entre minPoolSize et maxPoolSize.

jdbcUrl

jdbc:postgresql://localhost:5432/thingworx

URL JDBC utilisée pour la connexion à PostgreSQL.

Si le nom de schéma par défaut (public) est modifié, vous devez ajouter <nom de la base de données>?currentSchema=<nom du schéma>. Par exemple, si le nom de schéma est mySchema, la valeur serait la suivante : jdbc:postgresql://<DBServer>:<DBPort>/<databasename>?currentSchema=mySchema

Si vous configurez une solution haute disponibilité, cette valeur doit correspondre à l'adresse IP du serveur sur lequel le processus pgPool est exécuté. Remplacez le port par celui que pgPool sert.

maxConnectionAge

Durée de vie en secondes. Une connexion dont l'ancienneté est supérieure à la valeur de maxConnectionAge sera détruite et purgée du pool.

maxIdleTime

Nombre de secondes pendant lesquelles une connexion non utilisée peut rester dans le pool avant d'être supprimée. Une valeur de zéro signifie que les connexions inactives n'expireront jamais.

maxIdleTimeExcessConnections

300

maxPoolSize

100

Nombre maximal de connexions qu'un pool maintient à tout moment.

maxStatements

100

Taille du cache PreparedStatement global de ThingWorx.

minPoolSize

Nombre minimal de connexions qu'un pool maintient à tout moment.

numHelperThreads

password

Mot de passe utilisé pour se connecter à la base de données.

testConnectionOnCheckout

false

Si ce paramètre est défini sur Vrai, une opération sera exécutée à chaque récupération de connexion pour vérifier la validité de cette dernière.

unreturnedConnectionTimeout

username

twadmin

Utilisateur disposant du privilège de modification des tables. Il s'agit de l'utilisateur créé dans la base de données du serveur ThingWorx.

Pour modifier le mot de passe PostgreSQL : modifiez le mot de passe de cet utilisateur et également le paramètre de mot de passe non chiffré dans le fichier platform-settings.json ou la valeur chiffrée dans le keystore /ThingworxStorage/keystore.jks.

Paramètres du processeur de flux

maximumBlockSize

2500

Nombre maximal d'écritures de flux à traiter dans un bloc.

maximumQueueSize

250000

Nombre maximal d'entrées de flux à mettre en file d'attente (les suivantes seront rejetées).

maximumWaitTime

10000

Nombre de millisecondes attendues par le système avant le vidage du tampon de flux.

numberOfProcessingThreads

Nombre de threads de traitement.

scanRate

Le statut du tampon est vérifié selon la fréquence définie en millisecondes.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de flux.

Paramètres du processeur de flux de valeurs

maximumBlockSize

2500

Nombre maximal d'écritures de flux de valeurs à traiter dans un bloc.

maximumQueueSize

500000

Nombre maximal d'entrées de flux de valeurs à mettre en file d'attente (les suivantes seront rejetées).

maximumWaitTime

10000

Nombre de millisecondes attendues par le système avant le vidage du tampon de flux de valeurs.

numberofProcessingThreads

Nombre de threads de traitement.

scanRate

Fréquence d'analyse (en millisecondes) avant le vidage du tampon de flux.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de flux de valeurs.

PersistentPropertyProcessorSettings

maximumBlockSize

2500

Nombre maximal d'écritures de propriétés à traiter dans un bloc.

maximumWaitTime

1000

Délai d'attente maximal (en millisecondes) avant le vidage du tampon de propriété.

maximumQueueSize

100000

Nombre maximal d'entrées de propriété à mettre en file d'attente (les suivantes seront rejetées).

numberOfProcessingThreads

Nombre de threads à utiliser lors du traitement des propriétés.

scanRate

Fréquence (en millisecondes) selon laquelle le statut du tampon est vérifié.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de propriété.

MssqlPersistenceProviderPackage

Paramètre

Par défaut

Description

ConnectionInformation

acquireIncrement

Détermine le nombre de connexions simultanées que ThingWorx tentera d'acquérir lorsque le pool est épuisé.

acquireRetryAttempts

Définit le nombre maximal de tentatives de ThingWorx pour acquérir une nouvelle connexion à partir de la base de données.

acquireRetryDelay

10000

Délai (en millisecondes) attendu par ThingWorx entre chaque tentative.

checkoutTimeout

1000000

Délai en millisecondes attendu par un client appelant getConnection() pour récupérer ou obtenir une connexion lorsque le pool est épuisé.

driverClass

com.microsoft.sqlserver.jdbc.SQLServerDriver

Nom de classe complet du paramètre driverClass JDBC censé fournir des connexions.

fetchSize

5000

Nombre de lignes à extraire par lots au lieu de mettre en cache toutes les lignes côté client.

idleConnectionTestPeriod

initialPoolSize

Nombre initial de connexions de base de données créées et conservées dans un pool au démarrage. Ce paramètre doit être compris entre minPoolSize et maxPoolSize.

jdbcUrl

jdbc:sqlserver://localhost:1433;databaseName=thingworx;applicationName=Thingworx;

URL JDBC utilisée pour la connexion à MSSQL.

maxConnectionAge

Durée de vie en secondes. Une connexion dont l'ancienneté est supérieure à la valeur de maxConnectionAge sera détruite et purgée du pool.

maxIdleTime

Nombre de secondes pendant lesquelles une connexion non utilisée peut rester dans le pool avant d'être supprimée. Une valeur de zéro signifie que les connexions inactives n'expireront jamais.

maxIdleTimeExcessConnections

300

maxPoolSize

100

Nombre maximal de connexions qu'un pool maintient à tout moment.

maxStatements

100

Taille du cache PreparedStatement global de ThingWorx.

minPoolSize

Nombre minimal de connexions qu'un pool maintient à tout moment.

numHelperThreads

password

Mot de passe utilisé pour se connecter à la base de données.

testConnectionOnCheckout

false

Si ce paramètre est défini sur Vrai, une opération sera exécutée à chaque récupération de connexion pour vérifier la validité de cette dernière.

unreturnedConnectionTimeout

username

msadmin

Il s'agit de l'ID utilisateur qui possède le schéma TWSCHEMA et est utilisé pour l'authentification à MSSQL dans la chaîne de connexion JDBC.

Paramètres du processeur de flux

maximumBlockSize

2500

Nombre maximal d'écritures de flux à traiter dans un bloc.

maximumQueueSize

250000

Nombre maximal d'entrées de flux à mettre en file d'attente (les suivantes seront rejetées).

maximumWaitTime

10000

Nombre de millisecondes attendues par le système avant le vidage du tampon de flux.

numberOfProcessingThreads

Nombre de threads de traitement.

scanRate

Le statut du tampon est vérifié selon la fréquence définie en millisecondes.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de flux.

Paramètres du processeur de flux de valeurs

maximumBlockSize

2500

Nombre maximal d'écritures de flux de valeurs à traiter dans un bloc.

maximumWaitTime

10000

Nombre de millisecondes attendues par le système avant le vidage du tampon de flux de valeurs.

maximumQueueSize

500000

Nombre maximal d'entrées de flux de valeurs à mettre en file d'attente (les suivantes seront rejetées).

numberofProcessingThreads

Nombre de threads de traitement.

scanRate

Fréquence d'analyse (en millisecondes) avant le vidage du tampon de flux.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de flux de valeurs.

PersistentPropertyProcessorSettings

maximumBlockSize

2500

Nombre maximal d'écritures de propriétés à traiter dans un bloc.

maximumWaitTime

1000

Délai d'attente maximal (en millisecondes) avant le vidage du tampon de propriété.

maximumQueueSize

100000

Nombre maximal d'entrées de propriété à mettre en file d'attente (les suivantes seront rejetées).

numberOfProcessingThreads

Nombre de threads à utiliser lors du traitement des propriétés.

scanRate

Fréquence (en millisecondes) selon laquelle le statut du tampon est vérifié.

sizeThreshold

1000

Nombre maximal d'éléments à accumuler avant le vidage du tampon de propriété.