Dettagli di configurazione di platform-settings.json
Il file platform-settings.json consente agli amministratori di regolare le impostazioni di ottimizzazione ed è disponibile nel download del software. Per le impostazioni specifiche del clustering a disponibilità elevata, vedere Impostazioni di piattaforma per ThingWorx a disponibilità elevata.
 |
L'esempio riportato di seguito contiene tutte le opzioni. È richiesto un solo provider di persistenza.
|
{
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "/ThingworxBackupStorage",
"DatabaseLogRetentionPolicy": 7,
"DatabaseWriteRetryAttempts": 10,
"EnableBackup": true,
"EnableClusteredMode": false,
"EnableSystemLogging": false,
"EnableSSO": false,
"FileRepositoryRoot": "/ThingworxStorage",
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"InternalAesCryptographicKeyLength": 128,
"MetricsLoggingFrequency": 30,
"MetricsLoggingLevel": "WARN",
"MetricsReportingEnabled": true,
"SessionUpdateDelay": 60,
"Storage": "/ThingworxStorage",
"ScriptTimeout": 30,
"MaxSearchItems": 100000
},
"DomainConfiguration": {
"trustedDomains":[
"www.example1.com",
"www.example2.com",
"images.example3.com",
"localhost"
],
"ignoreTrustedDomains": false
}
"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",
"TurnOffScopesApprovalPopup": true
},
"ExtensionPackageImportPolicy": {
"importEnabled": false,
"allowJarResources": false,
"allowJavascriptResources": false,
"allowCSSResources": false,
"allowJSONResources": false,
"allowWebAppResources": false,
"allowEntities": false,
"allowExtensibleEntities": false,
"haCompatibilityImportLevel": "WARN"
},
"ClusteredModeSettings": {
"PlatformId": "platform1",
"CoordinatorHosts": "localhost:2181",
"ModelSyncPollInterval": 100
},
"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>"
},
"MetricsUserSettings": {
"InitialPassword": "<password>"
},
"PersistenceProviderPackageConfigs": {
"H2PersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 30,
"acquireRetryDelay": 1000,
"checkoutTimeout": 2000,
"networkTimeout": 900000,
"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
"producerTimeout": 30000,
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 10000,
"maximumQueueSize": 500000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
"producerTimeout": 30000,
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
"producerTimeout": 30000,
}
},
"PostgresPersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 3,
"acquireRetryDelay": 10000,
"checkoutTimeout": 1000000,
"networkTimeout": 900000,
"queryTimeout": 600000,
"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
"producerTimeout": 30000,
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 500000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
"producerTimeout": 30000,
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
"producerTimeout": 30000,
}
},
"MssqlPersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 3,
"acquireRetryDelay": 10000,
"checkoutTimeout": 1000000,
"networkTimeout": 900000,
"queryTimeout": 600000,
"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
"producerTimeout": 30000,
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 10000,
"maximumQueueSize": 500000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
"producerTimeout": 30000,
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
"producerTimeout": 30000,
}
}
},
"cache": {
"provider-type": "com.thingworx.cache.ignite.IgniteCacheProvider",
"ignite": {
"instance-name": "twx-core-server",
"client-mode": false,
"address-resolver": {
"type": "zookeeper",
"connection": "localhost:2181"
}
}
}
}
}
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "/ThingworxBackupStorage",
"DatabaseLogRetentionPolicy": 7,
"DatabaseWriteRetryAttempts": 10,
"EnableBackup": true,
"EnableClusteredMode": false,
"EnableSystemLogging": false,
"EnableSSO": false,
"FileRepositoryRoot": "/ThingworxStorage",
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"InternalAesCryptographicKeyLength": 128,
"MetricsLoggingFrequency": 30,
"MetricsLoggingLevel": "WARN",
"MetricsReportingEnabled": true,
"SessionUpdateDelay": 60,
"Storage": "/ThingworxStorage",
"ScriptTimeout": 30,
"MaxSearchItems": 100000
},
"DomainConfiguration": {
"trustedDomains":[
"www.example1.com",
"www.example2.com",
"images.example3.com",
"localhost"
],
"ignoreTrustedDomains": false
}
"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",
"TurnOffScopesApprovalPopup": true
},
"ExtensionPackageImportPolicy": {
"importEnabled": false,
"allowJarResources": false,
"allowJavascriptResources": false,
"allowCSSResources": false,
"allowJSONResources": false,
"allowWebAppResources": false,
"allowEntities": false,
"allowExtensibleEntities": false,
"haCompatibilityImportLevel": "WARN"
},
"ClusteredModeSettings": {
"PlatformId": "platform1",
"CoordinatorHosts": "localhost:2181",
"ModelSyncPollInterval": 100
},
"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>"
},
"MetricsUserSettings": {
"InitialPassword": "<password>"
},
"PersistenceProviderPackageConfigs": {
"H2PersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 30,
"acquireRetryDelay": 1000,
"checkoutTimeout": 2000,
"networkTimeout": 900000,
"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
"producerTimeout": 30000,
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 10000,
"maximumQueueSize": 500000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
"producerTimeout": 30000,
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
"producerTimeout": 30000,
}
},
"PostgresPersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 3,
"acquireRetryDelay": 10000,
"checkoutTimeout": 1000000,
"networkTimeout": 900000,
"queryTimeout": 600000,
"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
"producerTimeout": 30000,
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 500000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
"producerTimeout": 30000,
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
"producerTimeout": 30000,
}
},
"MssqlPersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 3,
"acquireRetryDelay": 10000,
"checkoutTimeout": 1000000,
"networkTimeout": 900000,
"queryTimeout": 600000,
"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
"producerTimeout": 30000,
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 10000,
"maximumQueueSize": 500000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
"producerTimeout": 30000,
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
"producerTimeout": 30000,
}
}
},
"cache": {
"provider-type": "com.thingworx.cache.ignite.IgniteCacheProvider",
"ignite": {
"instance-name": "twx-core-server",
"client-mode": false,
"address-resolver": {
"type": "zookeeper",
"connection": "localhost:2181"
}
}
}
}
}
|
|
I parametri networkTimeout, queryTimeoute producerTimeout devono essere utilizzati solo da ThingWorx 9.2.8 e versioni successive ThingWorx e 9.3.3 e versioni successive.
|
Impostazioni di platform-settings.json
Impostazioni di base
Impostazione | Default | Descrizione | ||||
|---|---|---|---|---|---|---|
BackupStorage | /ThingworxBackupStorage | Nome della directory in cui vengono scritti tutti i backup. | ||||
DatabaseLogRetentionPolicy | 7 | Numero di giorni in cui vengono conservati i log del database. | ||||
DatabaseWriteRetryAttempts | 10 | Numero massimo di tentativi effettuati dal sistema di scrittura delle voci persistenti nel database in caso di perdita di connessione. | ||||
EnableBackup | true | Determina se i backup vengono conservati. | ||||
EnableClusteredMode | false | Determina se ThingWorx viene eseguito come server indipendente o cluster. | ||||
EnableSystemLogging | false | Determina se la registrazione del sistema è attivata.
| ||||
EnableSSO | false | Impostare su true per attivare l'SSO per ThingWorx Platform. Quando l'SSO è attivato, qualsiasi l'autenticazione viene reindirizzata al server di autenticazione centralizzata configurato nel file sso-settings.json. L'autenticazione WebSocket Edge non viene modificata. | ||||
FileRepositoryRoot | /ThingworxStorage | La directory in cui viene creato il repository di file radice. Il percorso di default è sufficiente per le distribuzioni autonome. Per le distribuzioni a disponibilità elevata di ThingWorx, è consigliabile posizionare il repository in un file system condiviso a cui tutti i server ThingWorx abbiano accesso. | ||||
HTTPRequestHeaderMaxLength | 2000 | La lunghezza massima consentita per i valori delle intestazioni della richiesta HTTP. | ||||
HTTPRequestParameterMaxLength | 2000 | La lunghezza massima consentita per i valori dei parametri della richiesta HTTP. | ||||
InternalAesCryptographicKeyLength | 128 | Lunghezza della chiave utilizzata durante la generazione di una chiave AES simmetrica. I valori supportati sono 128, 192 e 256.
| ||||
MetricsLoggingFrequency | 30 | Frequenza in minuti con cui le metriche raccolte dalla piattaforma vengono registrate nel log applicazioni. | ||||
MetricsLoggingLevel | WARN | Livello di registrazione a cui le metriche raccolte dalla piattaforma vengono registrate nel log applicazioni. Il valore può essere uno dei seguenti: WARN, DEBUG, TRACE, INFO o ERROR. | ||||
MetricsReportingEnabled | n/d | Determina se i dati dei criteri di misurazione delle prestazioni vengono inviati a PTC. È possibile configurare questa opzione anche nel sottosistema Piattaforma. Per ulteriori informazioni sulla raccolta dati in ThingWorx, vedere Raccolta dei dati in ThingWorx. | ||||
SessionUpdateDelay | 60 | Intervallo di tempo, in secondi, aggiunto a lastUpdateTime, dopo il quale viene aggiornato lastUpdateTime della sessione. Se si ricevono più richieste durante il ritardo, solo la prima richiesta aggiorna lastUpdateTime. Il valore di default è 60 secondi. | ||||
Storage | /ThingworxStorage | Directory in cui tutte le directory di archiviazione vengono create/posizionate, esclusa l'archiviazione dei backup. | ||||
ScriptTimeout | 30 | Numero massimo di secondi per i quali uno script può essere eseguito prima che ThingWorx Platform lo termini.
| ||||
MaxSearchItems | 100000 | Consente agli utenti di aumentare il limite di ricerca di default in base al numero di entità presenti nell'ambiente. Il valore MaxSearchItems impostato in base alle API del gruppo di risorse SearchFunctions in ThingWorx Composer ha la precedenza sul valore impostato nel file platform-settings.json. Se MaxSearchItems è impostato su un valore maggiore di 100.000, passare i criteri di ricerca appropriati in base al caso di utilizzo per ridurre il tempo di ricerca per il recupero del numero di entità richiesto.
|
Impostazioni di configurazione dei domini
Impostazione | Default | Descrizione | ||
|---|---|---|---|---|
ignoreTrustedDomains | true | Se questo flag è impostato su true, sono consentite tutte le chiamate HTTP esterne tramite entità multimediali. Se invece è impostato su false, sono consentite solo chiamate HTTP ai domini elencati in trustedDomains. | ||
trustedDomains | ND | Elenco dei domini verificati e attendibili che gli utenti possono utilizzare per accedere a risorse multimediali sul mashup tramite l'oggetto Entità multimediale.
|
Impostazioni di Solution Central
Impostazione | Default | Descrizione | ||
|---|---|---|---|---|
SolutionCentralHost | sc.thingworx.com | Nome host Solution Central. | ||
SolutionCentralPort | 443 | Dettagli porta Solution Central.
| ||
KeyStorePath | /ThingworxPlatform/sc-keystore | Percorso del keystore. | ||
KeyStorePass | Nessuno | Password del keystore.
|
Impostazioni di ThingWorx Flow
Queste proprietà sono applicabili solo se in ThingWorx Foundation è installato ThingWorx Flow. I valori devono essere definiti sia nei file di configurazione ThingWorx Flow che RabbitMQ e possono essere modificati solo se la modifica avviene in entrambe le applicazioni.
Impostazione | Default | Descrizione | ||
|---|---|---|---|---|
EnableOrchestration | true | Indica se ThingWorx Flow è attivato in ThingWorx Foundation. | ||
QueueHost | host locale | Nome host RabbitMQ | ||
QueuePort | 5672 | Porta RabbitMQ | ||
QueueName | 256mb | Nome coda RabbitMQ | ||
QueueUsername | flowuser | Nome utente coda RabbitMQ | ||
QueuePassword | encrypt.queue.password | Password coda RabbitMQ
| ||
QueueVHost | orchestration | Nome VHost RabbitMQ | ||
TurnOffScopesApprovalPopup | false | Impostare il valore su true per interrompere la visualizzazione di finestre di approvazione delle concessioni durante il processo di accesso. |
Impostazioni della regola di importazione di package di estensioni
Per default, l'importazione delle estensioni è disattivata per tutti gli utenti. Utilizzare le impostazioni seguenti per configurare la funzionalità di importazione delle estensioni. Per ulteriori informazioni, vedere Importazione di estensioni.
Impostazione | Descrizione | Default | Esempi | ||||
|---|---|---|---|---|---|---|---|
importEnabled | Controllo di livello superiore che rappresenta la capacità di importare (=true) o non importare (=false) le estensioni. | false | • "importEnabled": false - Non è possibile importare le estensioni, anche se altre impostazioni di ExtensionPackageImportPolicy sono impostate su true. • "importEnabled": true - Trasmette l'importazione delle estensioni all'insieme successivo di impostazioni di allow<Content>Resources (vedere le righe di seguito).
| ||||
allowJarResources | Consente di importare le estensioni con risorse JAR. | false | • "allowJarResources": true - Consente di importare le estensioni che dichiarano i file JAR nel manifest come risorse JAR. • "allowJarResources": false - Non consente di importare le estensioni che dichiarano i file JAR nel manifest come risorse JAR. | ||||
allowJavascriptResources | Consente di importare le estensioni con risorse JavaScript. | false | • "allowJavascriptResources": true - Consente di importare le estensioni che dichiarano le risorse del file dell'interfaccia utente JavaScript nel manifest come risorse JavaScript. • "allowJavascriptResources": false - Non consente di importare le estensioni che dichiarano le risorse del file dell'interfaccia utente JavaScript nel manifest come risorse JavaScript. | ||||
allowCSSResources | Consente di importare le estensioni con risorse CSS. | false | • "allowCSSResources": true - Consente di importare le estensioni che contengono le risorse del file dell'interfaccia utente CSS. • "allowCSSResources": false - Non consente di importare le estensioni che contengono le risorse del file dell'interfaccia utente CSS. | ||||
allowJSONResources | Consente di importare le estensioni con risorse JSON (ad esempio file di localizzazione). | false | • "allowJSONResources": true - Consente di importare le estensioni che contengono le risorse del file dell'interfaccia utente JSON. • "allowJSONResources": false - Non consente di importare le estensioni che contengono le risorse del file dell'interfaccia utente JSON. | ||||
allowWebAppResources | Consente di importare le estensioni con risorse Web. | false | • "allowWebAppResources": true - Consente di importare le estensioni che contengono le risorse del file dell'interfaccia utente dell'app Web. • "allowWebAppResources": false - Non consente di importare le estensioni che contengono le risorse del file dell'interfaccia utente dell'app Web. | ||||
allowEntities | Consente di importare le estensioni con entità non estendibili. Tra gli esempi di entità non estendibili figurano: • Chiave di accesso • Autenticatore • Dashboard • Definizione analisi dati • Data shape • GenericContentEntity e classi figlio derivate come Definizione stato, Definizione stile, Tema stile • Gruppo • Tabella di localizzazione • Log • Mashup • Entità multimediale • Menu • ModeledServiceProviderEntity e classi figlio come Contenuto notifica • Rete • Definizione notifica • Organizzazione • Provider di persistenza • PersistenceProviderPackage e classi figlio derivate • Progetto • Thing shape • Modello di oggetto • Utente • Vocabolario e classi figlio derivate come Vocabolario tag dati e Vocabolari tag modello | false | • "allowEntities": true - Consente di importare le estensioni che dichiarano entità non estendibili nel manifest. • "allowEntities": false - Non consente di importare le estensioni che dichiarano entità non estendibili nel manifest. | ||||
allowExtensibleEntities | Consente di importare le estensioni con entità non estendibili. Tra gli esempi di entità estendibili figurano: • DirectoryService e classi figlio derivate • ExtensionPackage • Risorsa e classi figlio derivate che contengono funzioni/servizi personalizzati utilizzati come risorse simili alle risorse predefinite come InfoTableFunctions, EntityServices ed EncryptionServices.
• ScriptFunctionLibrary e classi figlio derivate. • Sottosistema e classi figlio derivate.
• Package oggetto • Widget | false | • "allowExtensibleEntities": true - Non consente di importare le estensioni che dichiarano entità estendibili nel manifest. • "allowExtensibleEntities": false - Non consente di importare le estensioni che dichiarano entità estendibili nel manifest. | ||||
haCompatibilityImportLevel | Quando si esegue ThingWorx in modalità cluster, è possibile limitare l'importazione delle estensioni solo a quelle il cui flag haCompatibility è impostato su true nei metadati dell'estensione. L'impostazione di default è WARN, che consente l'importazione ma genera un messaggio di avvertenza nel log applicazioni. È possibile modificare l'impostazione in DENY; in questo caso l'importazione non riesce e viene generato un errore nel log applicazioni. | WARN | • "haCompatibilityImportLevel": "WARN" - L'importazione dell'estensione riesce e vengono generate avvertenze per le estensioni per le quali non è impostato "haCompatible" : "TRUE" . • "haCompatibilityImportLevel": "DENY" - Vengono importate solo le estensioni con "haCompatible" : "TRUE". Tutte le altre importazioni non riescono e vengono generati messaggi di errore. |
Impostazioni della modalità cluster
Impostazioni specifiche dell'esecuzione di ThingWorx nella modalità cluster. Tutte le impostazioni vengono ignorate se l'impostazione EnableClusteredMode soprastante è impostata su false.
Impostazione | Default | Descrizione |
|---|---|---|
PlatformId | none | Identificatore univoco per ogni nodo nel cluster. Questo ID viene visualizzato nei log aggregati. Deve essere alfanumerico e contenere meno di 32 caratteri. Deve coincidere con lo schema "^[a-zA-Z0-9]{1,32}$". |
CoordinatorHosts | none | Elenco delimitato da virgole dei server Apache ZooKeeper utilizzato per coordinare l'elezione della priorità di ThingWorx. Lo schema della stringa è IP:porta (ad esempio "127.0.0.1:2181, 127.0.0.2:2181"). |
ZKNamespace | ThingWorx | Percorso del nodo radice utilizzato per monitorare le informazioni in ZooKeeper per il cluster. È necessario quando si eseguono più cluster con lo stesso ZooKeeper. Sono applicabili le limitazioni di denominazione di ZooKeeper. Vedere http://zookeeper.apache.org/doc/current/zookeeperProgrammers.html#ch_zkDataModel. |
ModelSyncPollInterval | 100 | Frequenza di sincronizzazione del modello tra i server nel cluster. Il valore è espresso in millisecondi. |
ModelSyncWaitPeriod | 3000 | Quando si comunica tramite i WebSocket, il traffico viene instradato attraverso i server nella modalità round-robin. Se si apporta una modifica a un modello tramite i WebSocket, la richiesta successiva attende che trascorra il tempo specificato in millisecondi affinché il modello si sincronizzi sul server su cui viene eseguito. Se non si verifica alcuna sincronizzazione prima del timeout, la richiesta ha esito negativo e viene restituito un errore di timeout. |
ModelSyncTimeout | 120000 | Intervallo di attesa (in millisecondi) per ogni nuovo tentativo. |
CoordinatorMaxRetries | 3 | Nel caso in cui non sia possibile comunicare con il coordinatore, vengono effettuati n tentativi prima che venga restituito un esito negativo. |
CoordinatorSessionTimeout | 90000 | Tempo (in millisecondi) che ThingWorx attende senza ricevere un "heartbeat" dal servizio Apache ZooKeeper utilizzato per coordinare la priorità di ThingWorx. |
CoordinatorConnectionTimeout | 10000 | Quantità di tempo (in millisecondi) che il sistema attende affinché venga stabilita una connessione con il coordinatore. |
MetricsCacheFrequency | 60000 | Le metriche vengono monitorate per ogni server e aggregate per le metriche a livello di cluster. Questo valore è la frequenza (in millisecondi) di aggiornamento delle metriche del cluster. |
Impostazioni dell'utente amministratore
Impostazione | Default | Descrizione |
|---|---|---|
InitialPassword | n/d | Password di amministratore iniziale richiesta al primo accesso a ThingWorx. La lunghezza minima può essere configurata nel sottosistema Gestione utenti (minimo 10 caratteri e impostazione di default di 14 caratteri). Per ulteriori informazioni, vedere . |
Impostazioni del tipo di contenuto
Impostazione | Default | Descrizione | ||
|---|---|---|---|---|
supportedMediaEntityContentTypes | "image/svg+xml","image/png","image/gif","image/bmp","image/jpeg","application/pdf","image/vnd.microsoft.icon" | Elenco delimitato da virgole di tipi di contenuto MIME validi che possono essere collegati dinamicamente alle entità multimediali. È possibile aggiungere altri tipi.
|
Impostazioni di connessione della licenza
Impostazione | Default | Descrizione | ||
|---|---|---|---|---|
username | n/d | Nome utente del sito del supporto tecnico PTC | ||
password | n/d | Password del sito del supporto tecnico PTC | ||
timeout (in secondi) | 60 | Dopo il periodo di timeout, nel log applicazioni viene registrato l'errore riportato di seguito. License Server could not process request | ||
useProxy | false | Attiva le impostazioni proxy per la gestione delle licenze. Se è impostato su true, le impostazioni proxy vengono utilizzate per la connessione al server delle licenze. | ||
proxyHost | Nome dell'host proxy. | |||
proxyPort | Numero di porta dell'host proxy. | |||
proxyScheme | http | http o https | ||
proxyUsername | Nome utente per l'autenticazione, se la connessione al server proxy richiede l'autenticazione. | |||
proxyPassword | Password per l'autenticazione, se la connessione al server proxy richiede l'autenticazione.
| |||
proxyUseNTLM | false | Opzione per utilizzare il protocollo NTLM. | ||
proxyWorkstation | Nome del computer dell'utente nella rete, se è richiesta l'autenticazione NTLM. | |||
proxyDomain | Nome del dominio dell'utente, se è richiesta l'autenticazione NTLM. |
Impostazioni utente relative alle metriche
Impostazione | Default | Descrizione |
|---|---|---|
InitialPassword | Crea MetricsUser durante l'avvio del sistema e viene utilizzato dal server Prometheus per ottenere informazioni sulle metriche da un'istanza di ThingWorx. È obbligatorio per tutte le distribuzioni di MSAI, ma è facoltativo per tutti gli altri tipi di distribuzione. |
Impostazioni del provider di persistenza
Per tutti i database elencati di seguito, attenersi alle linee guida riportate di seguito per le impostazioni del processore degli stream e degli stream di valori.
StreamProcessorSettings.numberOfProcessingThreads + ValueStreamProcessorSettings.numberOfProcessingThreads < 50% of DB connection pool
And
ValueStreamProcessorSettings.numberOfProcessingThreads >= StreamProcessorSettings.numberOfProcessingThreads
And
ValueStreamProcessorSettings.numberOfProcessingThreads >= StreamProcessorSettings.numberOfProcessingThreads
Impostazione | Default | Descrizione | ||
|---|---|---|---|---|
Informazioni di connessione | ||||
acquireIncrement | 5 | Determina quante connessioni alla volta ThingWorx tenta di acquisire quando il pool è esaurito. | ||
acquireRetryAttempts | 30 | Definisce il numero di volte che ThingWorx tenta di acquisire una nuova connessione dal database prima di rinunciare. | ||
acquireRetryDelay | 1000 | Tempo (in millisecondi) che ThingWorx attende tra un tentativo di acquisizione e l'altro. | ||
checkoutTimeout | 1000000 | Numero di millisecondi che un cliente che chiama getConnection() attende prima del Check-In o dell'acquisizione di una connessione quando il pool è esaurito. | ||
Network Timeout | 900000 | Quantità di tempo (in millisecondi) di attesa di una risposta dal database da parte di un thread. Se non si riceve alcuna risposta entro il termine configurato, la piattaforma chiude la connessione sottostante e rilascia il thread in attesa di risposta. | ||
idleConnectionTestPeriod | 6 | Periodo di tempo (in secondi) in cui le connessioni vengono testate in modo che le connessioni inattive non vengano chiuse da processi esterni come firewall, ecc. Se questo numero è maggiore di 0, ThingWorx testa tutte le connessioni inattive, raggruppate nel pool ma con Check-Out annullato, ogni x numero di secondi.
| ||
initialPoolSize | 10 | Numero di connessioni al database iniziali create e gestite all'interno di un pool all'avvio. È consigliabile impostare un valore compreso tra minPoolSize e maxPoolSize. | ||
maxConnectionAge | 0 | Secondi, durata effettiva. Una connessione antecedente a maxConnectionAge viene eliminata e rimossa dal pool. | ||
maxIdleTime | 0 | Secondi in cui una connessione può rimanere in pool anche se inutilizzata prima che venga rimossa. Il valore zero indica che le connessioni inattive non scadono mai. | ||
maxIdleTimeExcessConnections | 36000 | Numero di secondi durante i quali alle connessioni in eccesso di minPoolSize è consentito di rimanere inattive nel pool prima che vengano rimosse. Destinato alle applicazioni che desiderano ridurre notevolmente il numero di connessioni aperte, restringendo il pool al valore di minPoolSize se, in seguito a un picco, il livello di carico diminuisce e le connessioni acquisite non sono più necessarie. Se maxIdleTime è impostata, è consigliabile che maxIdleTimeExcessConnections sia inferiore per produrre un qualche effetto. L'impostazione di questa opzione su zero indica che non vi sono applicazioni e che le connessioni in eccesso non vengono rese in attive. | ||
maxPoolSize | 100 | Numero massimo di connessioni gestite da un pool in un determinato momento. | ||
maxStatements | 0 | Dimensione della cache PreparedStatement globale di ThingWorx. | ||
maxStatementsPerConnection | 50 | Dimensione della cache PreparedStatement globale di ThingWorx per ogni connessione. | ||
minPoolSize | 5 | Numero minimo di connessioni gestite da un pool in un determinato momento. | ||
numHelperThreads | 6 | Numero di thread di helper da generare. Le operazioni JDBC lente vengono eseguite in genere dai thread di helper che non detengono blocchi contesi. La distribuzione di queste operazioni su più thread può migliorare notevolmente le prestazioni consentendo l'esecuzione simultanea di più operazioni. | ||
password | n/d | Password del database. | ||
username | twadmin | Nome utente del database. | ||
tableLockTimeout | 10000 | Numero di millisecondi per cui un client attende lo sblocco di una tabella di database. | ||
testConnectionOnCheckout | false | Se true, viene eseguita un'operazione ad ogni Check-Out di connessione per verificare che la connessione sia valida. | ||
unreturnedConnectionTimeout | 0 | Numero di secondi per cui attendere una risposta da una connessione che non risponde prima di rimuoverla. Se impostata, se un'applicazione effettua il Check-Out di una connessione ma non riesce a effettuarne il Check-In entro il periodo di tempo specificato, il pool rimuove la connessione. Ciò consente alle applicazioni con occasionali perdite di connessione di sopravvivere, anziché finire per esaurire il pool di connessioni. Il valore zero indica l'assenza di timeout, quindi è previsto che le applicazioni chiudano le proprie connessioni. | ||
StreamProcessorSettings | ||||
maximumBlockSize | 2500 | Numero massimo di scritture dello stream da elaborare in un unico blocco. | ||
maximumQueueSize | 250000 | Numero massimo di voci di stream da accodare (le voci successive vengono rifiutate). | ||
maximumWaitTime | 10000 | Tempo massimo di attesa (in millisecondi) prima di scaricare il buffer dello stream. | ||
numberOfProcessingThreads | 5 | Numero di thread da utilizzare durante l'elaborazione delle proprietà. | ||
scanRate | 5 | Frequenza (in millisecondi) in base a cui controllare lo stato del buffer. | ||
sizeThreshold | 1000 | Numero massimo di elementi da accumulare prima di scaricare il buffer dello stream. | ||
Producer Timeout | 3000 | Questa impostazione si applica ai processori di voci di stream e attualmente è valida solo per il processore delle proprietà persistenti. Nel caso in cui una coda sia piena e non abbia spazio per una nuova voce, questo è il tempo massimo (millisecondi) che un produttore attende prima di poter inserire la voce nella coda. Se una volta terminato il tempo di attesa la coda è ancora piena e non è possibile rendere disponibile spazio, la voce non viene aggiunta alla coda. | ||
ValueStreamProcessorSettings | ||||
maximumBlockSize | 2500 | Numero massimo di scritture dello stream da elaborare in un unico blocco. | ||
maximumQueueSize | 250000 | Numero massimo di voci di stream da accodare (le voci successive vengono rifiutate). | ||
maximumWaitTime | 10000 | Tempo massimo di attesa (in millisecondi) prima di scaricare il buffer dello stream. | ||
numberOfProcessingThreads | 5 | Numero di thread da utilizzare durante l'elaborazione delle proprietà. | ||
scanRate | 5 | Frequenza (in millisecondi) in base a cui controllare lo stato del buffer. | ||
sizeThreshold | 1000 | Numero massimo di elementi da accumulare prima di scaricare il buffer dello stream. | ||
Producer Timeout | 3000 | Questa impostazione si applica ai processori di voci di stream e attualmente è valida solo per il processore delle proprietà persistenti. Nel caso in cui una coda sia piena e non abbia spazio per una nuova voce, questo è il tempo massimo (millisecondi) che un produttore attende prima di poter inserire la voce nella coda. Se una volta terminato il tempo di attesa la coda è ancora piena e non è possibile rendere disponibile spazio, la voce non viene aggiunta alla coda. | ||
PersistentPropertyProcessorSettings | ||||
maximumBlockSize | 2500 | Numero massimo di scritture di proprietà da elaborare in un unico blocco. | ||
maximumWaitTime | 1000 | Tempo massimo di attesa (in millisecondi) prima di scaricare il buffer delle proprietà. | ||
maximumQueueSize | 100000 | Numero massimo di voci di proprietà da accodare (le voci successive vengono rifiutate). | ||
numberOfProcessingThreads | 20 | Numero di thread da utilizzare durante l'elaborazione delle proprietà. | ||
scanRate | 25 | Frequenza (in millisecondi) in base a cui controllare lo stato del buffer. | ||
sizeThreshold | 1000 | Numero massimo di elementi da accumulare prima di scaricare il buffer delle proprietà. | ||
Producer Timeout | 3000 | Questa impostazione si applica ai processori di voci di stream e attualmente è valida solo per il processore delle proprietà persistenti. Nel caso in cui una coda sia piena e non abbia spazio per una nuova voce, questo è il tempo massimo (millisecondi) che un produttore attende prima di poter inserire la voce nella coda. Se una volta terminato il tempo di attesa la coda è ancora piena e non è possibile rendere disponibile spazio, la voce non viene aggiunta alla coda. | ||
Impostazione | Default | Descrizione | ||||
|---|---|---|---|---|---|---|
ConnectionInformation | ||||||
acquireIncrement | 5 | Determina quante connessioni alla volta la piattaforma tenta di acquisire quando il pool è esaurito. | ||||
acquireRetryAttempts | 3 | Definisce il numero di volte che ThingWorx tenta di acquisire una nuova connessione dal database prima di rinunciare. | ||||
acquireRetryDelay | 10000 | Tempo (in millisecondi) che ThingWorx attende tra un tentativo di acquisizione e l'altro. | ||||
checkoutTimeout | 10000000 | Numero di millisecondi che un cliente che chiama getConnection() attende prima del Check-In o dell'acquisizione di una connessione quando il pool è esaurito. | ||||
Query Timeout | 600000 | Quantità di tempo (in millisecondi) concesso per il completamento di un'interrogazione prima che venga annullata. | ||||
Network Timeout | 900000 | Quantità di tempo (in millisecondi) di attesa di una risposta dal database da parte di un thread. Se non si riceve alcuna risposta entro il termine configurato, la piattaforma chiude la connessione sottostante e rilascia il thread in attesa di risposta. | ||||
driverClass | org.postgresql.Driver | Nome completo della classe del driver JDBC che deve fornire le connessioni. | ||||
fetchSize | 5000 | Conteggio delle righe da recuperare in batch invece di memorizzare nella cache tutte le righe sul lato client. | ||||
idleConnectionTestPeriod | 60 | Se questo numero è maggiore di 0, ThingWorx testa tutte le connessioni inattive, raggruppate in pool ma con Check-Out annullato, ogni x numero di secondi. | ||||
initialPoolSize | 5 | Numero di connessioni al database iniziali create e gestite all'interno di un pool all'avvio. È consigliabile impostare un valore compreso tra minPoolSize e maxPoolSize. | ||||
jdbcUrl | jdbc:postgresql://localhost:5432/thingworx | URL JDBC utilizzato per connettersi a PostgreSQL.
| ||||
maxConnectionAge | 0 | Secondi, durata effettiva. Una connessione antecedente a maxConnectionAge viene eliminata e rimossa dal pool. | ||||
maxIdleTime | 0 | Secondi in cui una connessione può rimanere in pool anche se inutilizzata prima che venga rimossa. Il valore zero indica che le connessioni inattive non scadono mai. | ||||
maxIdleTimeExcessConnections | 300 | Numero di secondi durante i quali alle connessioni in eccesso di minPoolSize è consentito di rimanere inattive nel pool prima che vengano rimosse. Destinato alle applicazioni che desiderano ridurre notevolmente il numero di connessioni aperte, restringendo il pool al valore di minPoolSize se, in seguito a un picco, il livello di carico diminuisce e le connessioni acquisite non sono più necessarie. Se maxIdleTime è impostata, è consigliabile che maxIdleTimeExcessConnections sia inferiore per produrre un qualche effetto. L'impostazione di questa opzione su zero indica che non vi sono applicazioni e che le connessioni in eccesso non vengono rese in attive. | ||||
maxPoolSize | 100 | Numero massimo di connessioni gestite da un pool in un determinato momento. | ||||
maxStatements | 100 | Dimensione della cache PreparedStatement globale di ThingWorx. | ||||
minPoolSize | 5 | Numero minimo di connessioni gestite da un pool in un determinato momento. | ||||
numHelperThreads | 8 | Numero di thread di helper da generare. Le operazioni JDBC lente vengono eseguite in genere dai thread di helper che non detengono blocchi contesi. La distribuzione di queste operazioni su più thread può migliorare notevolmente le prestazioni consentendo l'esecuzione simultanea di più operazioni. | ||||
password | <password univoca> | Password utilizzata per accedere al database. | ||||
testConnectionOnCheckout | false | Se true, viene eseguita un'operazione ad ogni Check-Out di connessione per verificare che la connessione sia valida. | ||||
unreturnedConnectionTimeout | 0 | Numero di secondi per cui attendere una risposta da una connessione che non risponde prima di rimuoverla. Se impostata, se un'applicazione effettua il Check-Out di una connessione ma non riesce a effettuarne il Check-In entro il periodo di tempo specificato, il pool rimuove la connessione. Ciò consente alle applicazioni con occasionali perdite di connessione di sopravvivere, anziché finire per esaurire il pool di connessioni. Il valore zero indica l'assenza di timeout, quindi è previsto che le applicazioni chiudano le proprie connessioni. | ||||
username | twadmin | Utente dotato del privilegio per modificare le tabelle. Si tratta dell'utente creato nel database per il server ThingWorx.
| ||||
Impostazioni del processore dello stream | ||||||
maximumBlockSize | 2500 | Numero massimo di scritture dello stream da elaborare in un unico blocco. | ||||
maximumQueueSize | 250000 | Numero massimo di voci di stream da accodare (le voci successive vengono rifiutate). | ||||
maximumWaitTime | 10000 | Numero di millisecondi che il sistema attende prima di scaricare il buffer dello stream. | ||||
numberOfProcessingThreads | 5 | Numero di thread di elaborazione. | ||||
scanRate | 5 | Lo stato del buffer viene controllato in base al valore della frequenza specificata in millisecondi. | ||||
sizeThreshold | 1000 | Numero massimo di elementi da accumulare prima di scaricare il buffer dello stream. | ||||
Producer Timeout | 3000 | Questa impostazione si applica ai processori di voci di stream e attualmente è valida solo per il processore delle proprietà persistenti. Nel caso in cui una coda sia piena e non abbia spazio per una nuova voce, questo è il tempo massimo (millisecondi) che un produttore attende prima di poter inserire la voce nella coda. Se una volta terminato il tempo di attesa la coda è ancora piena e non è possibile rendere disponibile spazio, la voce non viene aggiunta alla coda. | ||||
Impostazioni processore stream valori | ||||||
maximumBlockSize | 2500 | Numero massimo di scritture dello stream di valori da elaborare in un unico blocco. | ||||
maximumQueueSize | 500000 | Numero massimo di voci di stream di valori da accodare (le voci successive vengono rifiutate). | ||||
maximumWaitTime | 10000 | Numero di millisecondi che il sistema attende prima di scaricare il buffer dello stream di valori. | ||||
numberofProcessingThreads | 5 | Numero di thread di elaborazione. | ||||
scanRate | 5 | Frequenza dell'analisi (in millisecondi) prima di scaricare il buffer dello stream. | ||||
sizeThreshold | 1000 | Numero massimo di elementi da accumulare prima di scaricare il buffer dello stream di valori. | ||||
Producer Timeout | 3000 | Questa impostazione si applica ai processori di voci di stream e attualmente è valida solo per il processore delle proprietà persistenti. Nel caso in cui una coda sia piena e non abbia spazio per una nuova voce, questo è il tempo massimo (millisecondi) che un produttore attende prima di poter inserire la voce nella coda. Se una volta terminato il tempo di attesa la coda è ancora piena e non è possibile rendere disponibile spazio, la voce non viene aggiunta alla coda. | ||||
PersistentPropertyProcessorSettings | ||||||
maximumBlockSize | 2500 | Numero massimo di scritture di proprietà da elaborare in un unico blocco. | ||||
maximumWaitTime | 1000 | Tempo massimo di attesa (in millisecondi) prima di scaricare il buffer delle proprietà. | ||||
maximumQueueSize | 100000 | Numero massimo di voci di proprietà da accodare (le voci successive vengono rifiutate). | ||||
numberOfProcessingThreads | 20 | Numero di thread da utilizzare durante l'elaborazione delle proprietà. | ||||
scanRate | 25 | Frequenza (in millisecondi) in base a cui controllare lo stato del buffer. | ||||
sizeThreshold | 1000 | Numero massimo di elementi da accumulare prima di scaricare il buffer delle proprietà. | ||||
Producer Timeout | 3000 | Questa impostazione si applica ai processori di voci di stream e attualmente è valida solo per il processore delle proprietà persistenti. Nel caso in cui una coda sia piena e non abbia spazio per una nuova voce, questo è il tempo massimo (millisecondi) che un produttore attende prima di poter inserire la voce nella coda. Se una volta terminato il tempo di attesa la coda è ancora piena e non è possibile rendere disponibile spazio, la voce non viene aggiunta alla coda. | ||||
Impostazione | Default | Descrizione | ||
|---|---|---|---|---|
ConnectionInformation | ||||
acquireIncrement | 5 | Determina quante connessioni alla volta ThingWorx tenta di acquisire quando il pool è esaurito. | ||
acquireRetryAttempts | 3 | Definisce il numero di volte che ThingWorx tenta di acquisire una nuova connessione dal database prima di rinunciare. | ||
acquireRetryDelay | 10000 | Tempo (in millisecondi) che ThingWorx attende tra un tentativo di acquisizione e l'altro. | ||
checkoutTimeout | 1000000 | Numero di millisecondi che un cliente che chiama getConnection() attende prima del Check-In o dell'acquisizione di una connessione quando il pool è esaurito. | ||
driverClass | com.microsoft.sqlserver.jdbc.SQLServerDriver | Nome completo della classe del driver JDBC che deve fornire le connessioni. | ||
fetchSize | 5000 | Conteggio delle righe da recuperare in batch invece di memorizzare nella cache tutte le righe sul lato client. | ||
idleConnectionTestPeriod | 60 | Periodo di tempo (in secondi) in cui le connessioni vengono testate in modo che le connessioni inattive non vengano chiuse da processi esterni come firewall, ecc. Se questo numero è maggiore di 0, ThingWorx testa tutte le connessioni inattive, raggruppate nel pool ma con Check-Out annullato, ogni x numero di secondi.
| ||
initialPoolSize | 5 | Numero di connessioni al database iniziali create e gestite all'interno di un pool all'avvio. È consigliabile impostare un valore compreso tra minPoolSize e maxPoolSize. | ||
jdbcUrl | jdbc:sqlserver://localhost:1433;databaseName=thingworx;applicationName=Thingworx; | L'URL jdbc utilizzato per connettersi a MSSQL. | ||
maxConnectionAge | 0 | Secondi, durata effettiva. Una connessione antecedente a maxConnectionAge viene eliminata e rimossa dal pool. | ||
maxIdleTime | 0 | Secondi in cui una connessione può rimanere in pool anche se inutilizzata prima che venga rimossa. Il valore zero indica che le connessioni inattive non scadono mai. | ||
maxIdleTimeExcessConnections | 300 | Numero di secondi durante i quali alle connessioni in eccesso di minPoolSize è consentito di rimanere inattive nel pool prima che vengano rimosse. Destinato alle applicazioni che desiderano ridurre notevolmente il numero di connessioni aperte, restringendo il pool al valore di minPoolSize se, in seguito a un picco, il livello di carico diminuisce e le connessioni acquisite non sono più necessarie. Se maxIdleTime è impostata, è consigliabile che maxIdleTimeExcessConnections sia inferiore per produrre un qualche effetto. L'impostazione di questa opzione su zero indica che non vi sono applicazioni e che le connessioni in eccesso non vengono rese in attive. | ||
maxPoolSize | 100 | Numero massimo di connessioni gestite da un pool in un determinato momento. | ||
maxStatements | 100 | Dimensione della cache PreparedStatement globale di ThingWorx. | ||
minPoolSize | 5 | Numero minimo di connessioni gestite da un pool in un determinato momento. | ||
numHelperThreads | 8 | Numero di thread di helper da generare. Le operazioni JDBC lente vengono eseguite in genere dai thread di helper che non detengono blocchi contesi. La distribuzione di queste operazioni su più thread può migliorare notevolmente le prestazioni consentendo l'esecuzione simultanea di più operazioni. | ||
password | <password univoca> | Password utilizzata per accedere al database. | ||
testConnectionOnCheckout | false | Se true, viene eseguita un'operazione ad ogni Check-Out di connessione per verificare che la connessione sia valida. | ||
unreturnedConnectionTimeout | 0 | Numero di secondi per cui attendere una risposta da una connessione che non risponde prima di rimuoverla. Se impostata, se un'applicazione effettua il Check-Out di una connessione ma non riesce a effettuarne il Check-In entro il periodo di tempo specificato, il pool rimuove la connessione. Ciò consente alle applicazioni con occasionali perdite di connessione di sopravvivere, anziché finire per esaurire il pool di connessioni. Il valore zero indica l'assenza di timeout, quindi è previsto che le applicazioni chiudano le proprie connessioni. | ||
username | msadmin | Si tratta dell'ID utente che possiede lo schema TWSCHEMA e viene utilizzato per l'autenticazione con MSSQL nella stringa di connessione di JDBC. | ||
Query Timeout | 600000 | Quantità di tempo (in millisecondi) concesso per il completamento di un'interrogazione prima che venga annullata. | ||
Network Timeout | 900000 | Quantità di tempo (in millisecondi) di attesa di una risposta dal database da parte di un thread. Se non si riceve alcuna risposta entro il termine configurato, la piattaforma chiude la connessione sottostante e rilascia il thread in attesa di risposta. | ||
Impostazioni del processore dello stream | ||||
maximumBlockSize | 2500 | Numero massimo di scritture dello stream da elaborare in un unico blocco. | ||
maximumQueueSize | 250000 | Numero massimo di voci di stream da accodare (le voci successive vengono rifiutate). | ||
maximumWaitTime | 10000 | Numero di millisecondi che il sistema attende prima di scaricare il buffer dello stream. | ||
numberOfProcessingThreads | 5 | Numero di thread di elaborazione. | ||
scanRate | 5 | Lo stato del buffer viene controllato in base al valore della frequenza specificata in millisecondi. | ||
sizeThreshold | 1000 | Numero massimo di elementi da accumulare prima di scaricare il buffer dello stream. | ||
Producer Timeout | 3000 | Questa impostazione si applica ai processori di voci di stream e attualmente è valida solo per il processore delle proprietà persistenti. Nel caso in cui una coda sia piena e non abbia spazio per una nuova voce, questo è il tempo massimo (millisecondi) che un produttore attende prima di poter inserire la voce nella coda. Se una volta terminato il tempo di attesa la coda è ancora piena e non è possibile rendere disponibile spazio, la voce non viene aggiunta alla coda. | ||
Impostazioni processore stream valori | ||||
maximumBlockSize | 2500 | Numero massimo di scritture dello stream di valori da elaborare in un unico blocco. | ||
maximumWaitTime | 10000 | Numero di millisecondi che il sistema attende prima di scaricare il buffer dello stream di valori. | ||
maximumQueueSize | 500000 | Numero massimo di voci di stream di valori da accodare (le voci successive vengono rifiutate). | ||
numberofProcessingThreads | 5 | Numero di thread di elaborazione. | ||
scanRate | 5 | Frequenza dell'analisi (in millisecondi) prima di scaricare il buffer dello stream. | ||
sizeThreshold | 1000 | Numero massimo di elementi da accumulare prima di scaricare il buffer dello stream di valori. | ||
Producer Timeout | 3000 | Questa impostazione si applica ai processori di voci di stream e attualmente è valida solo per il processore delle proprietà persistenti. Nel caso in cui una coda sia piena e non abbia spazio per una nuova voce, questo è il tempo massimo (millisecondi) che un produttore attende prima di poter inserire la voce nella coda. Se una volta terminato il tempo di attesa la coda è ancora piena e non è possibile rendere disponibile spazio, la voce non viene aggiunta alla coda. | ||
PersistentPropertyProcessorSettings | ||||
maximumBlockSize | 2500 | Numero massimo di scritture di proprietà da elaborare in un unico blocco. | ||
maximumWaitTime | 1000 | Tempo massimo di attesa (in millisecondi) prima di scaricare il buffer delle proprietà. | ||
maximumQueueSize | 100000 | Numero massimo di voci di proprietà da accodare (le voci successive vengono rifiutate). | ||
numberOfProcessingThreads | 20 | Numero di thread da utilizzare durante l'elaborazione delle proprietà. | ||
scanRate | 25 | Frequenza (in millisecondi) in base a cui controllare lo stato del buffer. | ||
sizeThreshold | 1000 | Numero massimo di elementi da accumulare prima di scaricare il buffer delle proprietà. | ||
Producer Timeout | 3000 | Questa impostazione si applica ai processori di voci di stream e attualmente è valida solo per il processore delle proprietà persistenti. Nel caso in cui una coda sia piena e non abbia spazio per una nuova voce, questo è il tempo massimo (millisecondi) che un produttore attende prima di poter inserire la voce nella coda. Se una volta terminato il tempo di attesa la coda è ancora piena e non è possibile rendere disponibile spazio, la voce non viene aggiunta alla coda. | ||
Impostazioni della cache
Le impostazioni della cache sono necessarie solo quando si esegue ThingWorx Platform nella modalità cluster.
 | Se si esegue la modalità a server singolo, escludere le impostazioni della cache dalla configurazione. Se sono incluse per la modalità a server singolo, eseguono la modalità di memorizzazione nella cache distribuita utilizzando Apache Ignite, che è meno performante rispetto all'esecuzione della memorizzazione nella cache locale di default. |
Impostazione | Default | Descrizione |
|---|---|---|
provider-type | [Provider della cache per l'esecuzione nella modalità a server singolo.] | Nella modalità cluster, il valore deve essere sempre impostato su com.thingworx.cache.ignite.IgniteCacheProvider. |
instance-name | none | Imposta il nome dell'istanza locale della cache. |
client-mode | true | Determina se Ignite incorporato viene eseguito come client (impostazione di default) o server. Nella modalità server partecipa alla memorizzazione dei dati e utilizza più memoria. |
address-resolver type | static | Determina il modo in cui vengono individuati altri nodi Ignite. L'impostazione consigliata è zookeeper. |
connection | none | Per address-resolver type di zookeeper si tratta di un elenco separato da virgole dei server Apache ZooKeeper utilizzati per coordinare l'elezione del leader ThingWorx. La serie di stringhe è IP:porta (ad esempio, 127.0.0.1:2181, 127.0.0.2:2181). |
endpoints | none | For address-resolver type di static, si tratta di una matrice di indirizzi statici in cui è in esecuzione Ignite. |
Aggiunta di una sezione di evento sottoposta a verifica a platform-settings.json
Quando ThingWorx Platform viene riavviato, tutti gli oggetti attivano l'evento ThingStart. La verifica di tutti questi eventi aumenta il tempo di avvio della piattaforma. Per evitare questa situazione, l'evento ThingStart è disattivato per default. Se si desidera comunque verificare questa azione, è possibile attivare e disattivare gli eventi nel file platform-settings.json.
Il file platform-settings.json non contiene una sezione per Audit. Per attivare o disattivare le categorie e i messaggi, è necessario aggiungere una struttura JSON al file. Per l'istanza di ThingWorx Platform per cui si desidera attivare i messaggi di verifica, è necessario un amministratore dotato dei permessi per individuare e modificare il file platform-settins.json e aggiungere la configurazione appropriata.
| | La sezione Audit deve essere inserita come nodo di pari livello alla voce JSON di PlatformSettingsConfig. Può essere inserita prima o dopo il nodo PlatformSettingsConfig ma deve trovarsi allo stesso livello di nodo. |
Di seguito è riportato un esempio di una struttura di verifica posizionata dopo il nodo PlatformSettingsConfignel file platform-settings.json:
"PlatformSettingsConfig:: {
"BasicSettings":( . . .
}
}
"Audit": {
"Disabled": [{
"CategoryKey": "audit.AuditCategory.Collaboration",
"MessageKeys": ["ALL"]
}, {
"CategoryKey": "audit.AuditCategory.Authentication",
"MessageKeys": [
"com.thingworx.things.security.SecurityMonitorThing.LoginSucceeded.Audit",
"com.thingworx.things.security.SecurityMonitorThing.ApplicationKeyFailed.Audit"
]
}
],
"Enabled": [{
"CategoryKey": "audit.AuditCategory.RemoteAccess",
"MessageKeys": ["ALL"]
}, {
"CategoryKey": "audit.AuditCategory.Authentication",
"MessageKeys": [
"thingworx.things.security.SecurityMonitorThing.LoginFailed.Audit" ]
], {
"CategoryKey": "audit.AuditCategory.ThingGroupMemberships",
"MessageKeys": [
"com.thingworx.thinggroups.ThingGroup.AddedThingAsChildMember",
"com.thingworx.thinggroups.ThingGroup.DeletedThingAsChildMember",
"com.thingworx.thinggroups.ThingGroup.AddedThingGroupAsChildMember",
"com.thingworx.thinggroups.ThingGroup.DeletedThingGroupAsChildMember",
"com.thingworx.thinggroups.ThingGroup.DeletedAllChildMembers"
]
}
]
}
In questo esempio vengono disattivati la categoria COLLABORATION e tutti gli eventi o i messaggi (["ALL"]). Per la categoria AUTHENTICATION vengono disattivati due eventi o messaggi: LoginSucceeded e ApplicationKeyFailed. La categoria REMOTE_ACCESS e tutti gli eventi o i messaggi (["ALL"]) sono attivati. Per la categoria AUTHENTICATION è attivato l'evento o il messaggio LoginFailed. Per THINGGROUPMEMBERSHIPs sono attivati tutti i messaggi di verifica. Anziché utilizzare ["ALL"], questi messaggi vengono elencati separatamente. È possibile scegliere questo metodo per immettere i messaggi di verifica in modo che sia possibile determinare, anche dopo avere eseguito l'istanza della piattaforma, se sono tutti necessari.
La categoria audit.AuditCategory.ThingGroupMemberships fornisce messaggi di verifica sulle modifiche apportate all'appartenenza di un gruppo di oggetti. Tale categoria è disattivata per default perché non tutte le configurazioni/distribuzioni richiedono questi messaggi, né gli amministratori di sistema desiderano occuparsi del calcolo e della persistenza di queste modifiche. Se le configurazioni o le distribuzioni richiedono messaggi di verifica per le modifiche apportate all'appartenenza al gruppo di oggetti, è possibile attivarle come illustrato nell'esempio precedente. L'impostazione di ciascun messaggio di verifica può essere attivata o disattivata senza che sia necessario attivare o disattivare altri messaggi di verifica. È possibile, ad esempio, verificare solo alcune modifiche di appartenenza. I messaggi di verifica per le appartenenze ai gruppi di oggetti sono elencati nella tabella, Tabella 122nell'argomento Messaggi di verifica ThingWorx in questo Help Center.
 | I messaggi di verifica per i due tipi di messaggi riportati di seguito sono sempre attivati e non richiedono l'attivazione esplicita. Forniscono messaggi di verifica quando la funzionalità di delega dei permessi di visibilità per i gruppi di oggetti viene attivata o disattivata: com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationEnabled com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationDisabled . |
Per attivare o disattivare una categoria e un messaggio di verifica, è possibile copiare la struttura illustrata sopra e aggiungere le chiavi appropriate ai gruppi "Disabled" e/o "Enabled". Per la procedura dettagliata, fare riferimento a Attivazione e disattivazione degli eventi di verifica. Per trovare le chiavi appropriate per le categorie e i messaggi di evento, fare riferimento alla Tabella 122 disponibile in Messaggi di verifica ThingWorx di questo Help Center.