Detalles de la configuración de platform-settings.json
El fichero platform-settings.json está disponible para que los administradores puedan ajustar la configuración para ajuste fino y se puede encontrar en la descarga de software. Para ver la configuración específica de la agrupación de alta disponibilidad, consulte Configuración de plataforma para la alta disponibilidad de ThingWorx.
 |
En el siguiente ejemplo se incluyen todas las opciones. Solo se necesita un proveedor de persistencia.
|
{
"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"
}
}
}
}
}
|
|
Los parámetros networkTimeout, queryTimeout y producerTimeout solo se deben utilizar en ThingWorx 9.2.8 y versiones posteriores, y ThingWorx 9.3.3 y versiones posteriores.
|
Configuración de platform-settings.json
Configuración básica
Configuración | Por defecto | Descripción | ||||
|---|---|---|---|---|---|---|
BackupStorage | /ThingworxBackupStorage | El nombre del directorio donde se escriben todas las copias de seguridad. | ||||
DatabaseLogRetentionPolicy | 7 | El número de días que se conservan los registros de base de datos. | ||||
DatabaseWriteRetryAttempts | 10 | Intentos máximos realizados por el sistema para reintentar entradas de persistencia en la base de datos en caso de pérdida de conexión. | ||||
EnableBackup | true | Permite determinar si se conservan copias de seguridad. | ||||
EnableClusteredMode | falso | Permite determinar si ThingWorx se ejecutará como un clúster o un servidor independiente. | ||||
EnableSystemLogging | falso | Permite determinar si se activa el registro del sistema.
| ||||
EnableSSO | falso | Se define en true para activar SSO para ThingWorx Platform. Cuando se activa el SSO, toda la autenticación se redirige al servidor de autorización central que está configurado en el fichero sso-settings.json. La autenticación mediante WebSocket de Edge no se ve afectada. | ||||
FileRepositoryRoot | /ThingWorxStorage | El directorio donde se crea el almacén de ficheros raíz. La ubicación por defecto es suficiente para las implementaciones autónomas. Para las implementaciones de alta disponibilidad de ThingWorx, el almacén debe encontrarse en un sistema de ficheros compartidos donde todos los servidores de ThingWorx tengan acceso. | ||||
HTTPRequestHeaderMaxLength | 2000 | La longitud máxima permitida para los valores de las cabeceras de solicitud HTTP. | ||||
HTTPRequestParameterMaxLength | 2000 | La longitud máxima permitida para los valores de parámetros de solicitud HTTP. | ||||
InternalAesCryptographicKeyLength | 128 | Longitud de clave que se utiliza al generar una clave AES simétrica. Los valores soportados son 128, 192 y 256.
| ||||
MetricsLoggingFrequency | 30 | Frecuencia en minutos en que las métricas que recopila la plataforma se registrarán en el registro de la aplicación. | ||||
MetricsLoggingLevel | WARN | Nivel de registro en el que las métricas que recopila la plataforma se registrarán en el registro de la aplicación. El valor puede ser uno de los siguientes: WARN, DEBUG, TRACE, INFO o ERROR. | ||||
MetricsReportingEnabled | n/d | Permite determinar si se envían datos de métricas de rendimiento a PTC. Esta opción también se puede configurar en el subsistema de plataforma. Para obtener más información sobre la recopilación de datos en ThingWorx, consulte Recopilación de datos en ThingWorx. | ||||
SessionUpdateDelay | 60 | La cantidad de tiempo, en segundos, que se añade a lastUpdateTime, después del cual se actualizará el elemento lastUpdateTime de la sesión. Si se reciben varias solicitudes durante la demora, solo la primera solicitud actualizará el elemento lastUpdateTime. El valor por defecto es de 60 segundos. | ||||
Storage | /ThingWorxStorage | El directorio donde se crean/ubican todos los directorios de almacenamiento (excepto el almacenamiento de copia de seguridad). | ||||
ScriptTimeout | 30 | El número máximo de segundos que un script puede ejecutarse antes de que ThingWorx Platform lo termine.
| ||||
MaxSearchItems | 100000 | Se debe permitir a los usuarios aumentar el límite de búsqueda por defecto en función del número de entidades presentes en el entorno. Los objetos MaxSearchItems definidos por las API del grupo de recursos SearchFunctions en ThingWorx Composer prevalecerán sobre el valor definido en platform-setting.json. Si MaxSearchItems se define en un valor mayor que 100.000, pase los criterios de búsqueda adecuados según el caso de uso para reducir el tiempo de búsqueda y obtener el número necesario de entidades.
|
Opciones de configuración del dominio
Configuración | Por defecto | Descripción | ||
|---|---|---|---|---|
ignoreTrustedDomains | true | Si este señalizador se define en true, se permiten todas las llamadas HTTP externas a través de entidades multimedia. Y si se define en false, solo se permiten las llamadas HTTP a los dominios de la lista trustedDomains. | ||
trustedDomains | N/D | Lista de dominios verificados y de confianza que los usuarios pueden utilizar para acceder a medios en el mashup a través de un objeto de entidad multimedia.
|
Configuración de Solution Central
Configuración | Por defecto | Descripción | ||
|---|---|---|---|---|
SolutionCentralHost | sc.thingworx.com | Nombre de host de Solution Central. | ||
SolutionCentralPort | 443 | Detalles del puerto de Solution Central
| ||
KeyStorePath | /ThingworxPlatform/sc-keystore | Ruta de keystore. | ||
KeyStorePass | Ninguno | Contraseña de keystore.
|
Configuración de ThingWorx Flow
Estas propiedades solo se aplican si ThingWorx Flow está instalado en ThingWorx Foundation. Estos valores se deben definir en los ficheros de configuración de ThingWorx Flow y RabbitMQ, y no se deben editar a menos que se modifiquen en ambas aplicaciones.
Configuración | Por defecto | Descripción | ||
|---|---|---|---|---|
EnableOrchestration | verdadero | Permite indicar si ThingWorx Flow está activado en ThingWorx Foundation. | ||
QueueHost | Host local | Nombre de host de RabbitMQ | ||
QueuePort | 5672 | Puerto de RabbitMQ | ||
QueueName | 256mb | Nombre de cola de RabbitMQ | ||
QueueUsername | flowuser | Nombre de usuario de cola de RabbitMQ | ||
QueuePassword | encrypt.queue.password | Contraseña de cola de RabbitMQ
| ||
QueueVHost | orchestration | Nombre de host virtual de RabbitMQ | ||
TurnOffScopesApprovalPopup | false | Defina el valor en true para detener la aparición de ventanas de aprobación durante el proceso de conexión. |
Configuración de la directiva de importación de paquetes de extensión
La importación de extensiones está desactivada por defecto para todos los usuarios. Utilice las siguientes opciones para configurar la funcionalidad de importación de extensiones. Para obtener más información, consulte Importación de extensiones.
Configuración | Descripción | Por defecto | Ejemplos | ||||
|---|---|---|---|---|---|---|---|
importEnabled | El control de nivel superior que representa la posibilidad de importar (= true) o no importar (= false) extensiones. | false | • "importEnabled": false: no se pueden importar extensiones, incluso si otra configuración de ExtensionPackageImportPolicy se defina en true. • "importEnabled": true: se pasa la importación de extensiones al siguiente conjunto de configuración de allow<Content>Resources (consulte las filas siguientes).
| ||||
allowJarResources | Permite la importación de las extensiones con recursos Jar. | false | • "allowJarResources": true : permite la importación de las extensiones que declaran ficheros jar en su manifiesto como recursos jar. • "allowJarResources": false : no permitirá la importación de las extensiones que declaran ficheros jar en su manifiesto como recursos jar. | ||||
allowJavascriptResources | Permite la importación de las extensiones con recursos JavaScript. | false | • "allowJavascriptResources": true: permite la importación de las extensiones que declaran recursos de fichero de interfaz de usuario JavaScript en su manifiesto como recursos JavaScript. • "allowJavascriptResources": false: no permitirá la importación de las extensiones que declaran recursos de fichero de interfaz de usuario JavaScript en su manifiesto como recursos JavaScript. | ||||
allowCSSResources | Permite la importación de las extensiones con recursos CSS. | false | • "allowCSSResources": true: permite la importación de las extensiones que contienen recursos de fichero de interfaz de usuario CSS. • "allowCSSResources": false: no permitirá la importación de las extensiones que contienen recursos de fichero de interfaz de usuario CSS. | ||||
allowJSONResources | Permite la importación de las extensiones con recursos JSON (por ejemplo, ficheros de localización). | false | • "allowJSONResources": true: permite la importación de las extensiones que contienen recursos de fichero de interfaz de usuario JSON. • "allowJSONResources": false: no permitirá la importación de las extensiones que contienen recursos de fichero de interfaz de usuario JSON. | ||||
allowWebAppResources | Permite la importación de las extensiones con recursos Web. | false | • "allowWebAppResources": true: permite la importación de las extensiones que contienen recursos de fichero de interfaz de usuario WebApp. • "allowWebAppResources": false: no permitirá la importación de las extensiones que contienen recursos de fichero de interfaz de usuario WebApp. | ||||
allowEntities | Permite la importación de las extensiones con entidades no extensibles. Los siguientes son ejemplos de entidades no extensibles: • Clave de aplicación • Autenticador • Tablero • Definición de análisis de datos • Definición de datos • GenericContentEntity y clases hijo derivadas, como la definición de estado, la definición de estilo y el tema de estilo • Grupo • Tabla de localización • Registro • Mashup • Entidad multimedia • Menú • ModeledServiceProviderEntity y clases hijo, como el contenido de notificación • Red • Definición de notificación • Organización • Proveedor de persistencia • PersistenceProviderPackage y clases hijo derivadas • Proyecto • Definición de cosa • Plantilla de cosa • User • Vocabulario y clases hijo derivadas, como DataTagVocabulary, ModelTagVocabulary | false | • "allowEntities": true: permite la importación de las extensiones que declaran entidades no extensibles en su manifiesto. • "allowEntities": false: no permitirá la importación de las extensiones que declaran entidades no extensibles en su manifiesto. | ||||
allowExtensibleEntities | Permite la importación de las extensiones con entidades no extensibles. Los siguientes son ejemplos de entidades extensibles: • DirectoryService y clases hijo derivadas • ExtensionPackage • Las clases de recurso e hijo derivadas en las que se incluyen funciones y servicios personalizados que se utilizan como recursos similares a los recursos de fábrica, como InfoTableFunctions, EntityServices y EncryptionServices.
• ScriptFunctionLibrary y clases hijo derivadas. • El subsistema y clases hijo derivadas.
• Paquete de cosa • Widget | false | • "allowExtensibleEntities": true: permite la importación de las extensiones que declaran entidades no extensibles en su manifiesto. • "allowExtensibleEntities": false: no permitirá la importación de las extensiones que declaran entidades no extensibles en su manifiesto. | ||||
haCompatibilityImportLevel | Al ejecutar ThingWorx en modo de clúster, se puede restringir la importación de extensiones a solo aquellas que tengan el señalizador haCompatibility definido en verdadero en los metadatos de la extensión. La configuración por defecto es WARN, que permite la importación, pero genera un mensaje de aviso en el registro de la aplicación. La configuración se puede cambiar a DENY. En este caso, la importación falla y se genera un error en el registro de la aplicación. | AVISAR | • "haCompatibilityImportLevel": "WARN": las importaciones de las extensiones se realizan correctamente y se generan avisos para las extensiones que no tienen definido "haCompatible" : "TRUE" . • "haCompatibilityImportLevel": "DENY": solo se importarán las extensiones con "haCompatible" : "TRUE". El resto de las importaciones de extensiones fallará y se generarán mensajes de error. |
Configuración de modo agrupado
Configuración específica para la ejecución de ThingWorx en modo de clúster. Toda la configuración se desestima si la opción EnableClusteredMode anterior se define en false.
Configuración | Por defecto | Descripción |
|---|---|---|
PlatformId | ninguno | Un identificador único para cada nodo del clúster. Este ID se mostrará en registros agregados. Debe ser alfanumérico y tener menos de 32 caracteres. Debe coincidir con el patrón "^[a-zA-Z0-9]{1,32}$". |
CoordinatorHosts | ninguno | Una lista delimitada por comas de los servidores de Apache ZooKeeper utilizados para coordinar la elección de la prioridad de ThingWorx. El patrón de la cadena es IP:puerto. (Por ejemplo, "127.0.0.1:2181, 127.0.0.2:2181"). |
ZKNamespace | ThingWorx | La ruta del nodo raíz que se utiliza para realizar el seguimiento de la información en Zookeeper para el clúster. Se requiere cuando se ejecutan varios clústeres utilizando el mismo Zookeeper. Se aplican las limitaciones de asignación de nombres de Zookeeper, consulte http://zookeeper.apache.org/doc/current/zookeeperProgrammers.html#ch_zkDataModel. |
ModelSyncPollInterval | 100 | Frecuencia con la que el modelo se sincroniza entre los servidores del clúster. El valor se especifica en milisegundos. |
ModelSyncWaitPeriod | 3000 | En la comunicación a través de WebSockets, el tráfico se rutea de manera round robin entre servidores. Si se realiza un cambio de modelo a través de WebSockets, la siguiente solicitud esperará hasta que haya transcurrido el tiempo especificado en milisegundos para que el modelo se sincronice en el servidor de destino. Si no se produce ninguna sincronización antes de que se agote el tiempo de espera, la solicitud fallará con un error de tiempo de espera. |
ModelSyncTimeout | 120000 | La cantidad de tiempo que se debe esperar (en milisegundos) para cada reintento. |
CoordinatorMaxRetries | 3 | En caso de que se produzca un fallo en la comunicación con el coordinador, se volverá a intentar n veces antes de fallar. |
CoordinatorSessionTimeout | 90000 | La cantidad de tiempo que ThingWorx espera (en milisegundos) sin recibir un "latido" del servicio Apache ZooKeeper que se utiliza para coordinar la prioridad de ThingWorx. |
CoordinatorConnectionTimeout | 10000 | La cantidad de tiempo (en milisegundos) que el sistema esperará una conexión con el coordinador. |
MetricsCacheFrequency | 60000 | Se realiza un seguimiento de las métricas por servidor y se agregan para las métricas de nivel de clúster. Este valor es la frecuencia (en milisegundos) con la que se actualizan las métricas del clúster. |
Configuración del usuario administrador
Configuración | Por defecto | Descripción |
|---|---|---|
InitialPassword | n/d | La contraseña inicial del administrador que se requiere para conectarse a ThingWorx por primera vez. La longitud mínima se puede configurar en el subsistema de gestión de usuarios (mínimo 10 caracteres, por defecto tiene 14 caracteres). Consulte para obtener más información. |
Configuración de tipo de contenido
Configuración | Por defecto | Descripción | ||
|---|---|---|---|---|
supportedMediaEntityContentTypes | "image/svg+xml","image/png","image/gif","image/bmp","image/jpeg","application/pdf","image/vnd.microsoft.icon" | Lista delimitada por comas de tipos de contenido MIME válidos que se pueden vincular dinámicamente a entidades multimedia. Se pueden añadir tipos adicionales.
|
Configuración de conexión de licencias
Configuración | Por defecto | Descripción | ||
|---|---|---|---|---|
username | n/d | Nombre de usuario del sitio de soporte técnico de PTC | ||
password | n/d | Contraseña del sitio de soporte técnico de PTC | ||
timeout (en segundos) | 60 | Tras el período de tiempo de espera, se registra el siguiente error en el registro de aplicación: License Server could not process request | ||
useProxy | falso | Permite activar la configuración de Proxy para licencias. Si se define en verdadero, se utiliza la configuración de proxy para conectar con el servidor de licencias. | ||
proxyHost | El nombre del host Proxy. | |||
proxyPort | El número de puerto del host Proxy. | |||
proxyScheme | http | http o https. | ||
proxyUsername | El nombre de usuario para la autentificación si la conexión del servidor Proxy requiere autenticación. | |||
proxyPassword | La contraseña para la autentificación si la conexión del servidor Proxy requiere autenticación.
| |||
proxyUseNTLM | falso | Opción para utilizar el protocolo NTLM. | ||
proxyWorkstation | El nombre del ordenador del usuario en la red, si se requiere la autenticación NTLM. | |||
proxyDomain | El nombre del dominio del usuario, si se requiere la autenticación NTLM. |
Configuración del usuario de métricas
Configuración | Por defecto | Descripción |
|---|---|---|
InitialPassword | Crea MetricsUser durante el inicio del sistema y el servidor de Prometheus lo utiliza para eliminar información de métricas de una instancia de ThingWorx. Es necesario para todas las implementaciones de MSAI, pero opcional para todos los demás tipos de implementaciones. |
Configuración del proveedor de persistencia
Para todas las bases de datos que se indican a continuación, se deben seguir las siguientes directrices para la configuración del procesador de flujo de valores y la configuración del procesador de flujo:
StreamProcessorSettings.numberOfProcessingThreads + ValueStreamProcessorSettings.numberOfProcessingThreads < 50% of DB connection pool
And
ValueStreamProcessorSettings.numberOfProcessingThreads >= StreamProcessorSettings.numberOfProcessingThreads
And
ValueStreamProcessorSettings.numberOfProcessingThreads >= StreamProcessorSettings.numberOfProcessingThreads
Configuración | Por defecto | Descripción | ||
|---|---|---|---|---|
Información de conexión | ||||
acquireIncrement | 5 | Permite determinar el número de conexiones que ThingWorx intentará adquirir a la vez cuando la agrupación se agote. | ||
acquireRetryAttempts | 30 | Permite definir cuántas veces ThingWorx intentará adquirir una nueva conexión de la base de datos antes de abandonar. | ||
acquireRetryDelay | 1000 | El tiempo (en milisegundos) que ThingWorx esperará entre los intentos de adquisición. | ||
checkoutTimeout | 1000000 | El número de milisegundos que un cliente que llama a getConnection() esperará a que se archive o adquiera una conexión cuando la agrupación se agote. | ||
Network Timeout | 900000 | La cantidad de tiempo (en milisegundos) para que un subproceso espere la respuesta de la base de datos. Si no se recibe ninguna respuesta en este tiempo configurado, la plataforma cerrará la conexión subyacente y liberará el subproceso que espera la respuesta. | ||
idleConnectionTestPeriod | 6 | El período de tiempo (en segundos) durante el que se probarán las conexiones de modo que las conexiones inactivas no se cerrarán desde procesos externos, como barreras de seguridad, etc. Si se trata de un número mayor que 0, ThingWorx probará todas las conexiones inactivas, agrupadas pero no extraídas, cada x segundos.
| ||
initialPoolSize | 10 | Número inicial de conexiones de base de datos creadas y conservadas dentro de una agrupación durante el arranque. Debe estar entre minPoolSize y maxPoolSize. | ||
maxConnectionAge | 0 | Segundos, efectivamente un período de vida. Una conexión más antigua que maxConnectionAge se destruirá y se depurará de la agrupación. | ||
maxIdleTime | 0 | Segundos que una conexión puede permanecer en la agrupación, pero sin utilizar, antes de que se descarte. Cero significa que las conexiones inactivas nunca vencen. | ||
maxIdleTimeExcessConnections | 36000 | El número de segundos que debe permitirse que las conexiones en exceso de minPoolSize permanezcan inactivas en la agrupación antes de que se seleccionen. Está previsto para las aplicaciones que desean minimizar agresivamente el número de conexiones abiertas, reduciendo la agrupación de nuevo a minPoolSize si, después de un pico, disminuye el nivel de carga y ya no se necesitan las conexiones adquiridas. Si se define maxIdleTime, maxIdleTimeExcessConnections debe ser inferior para que surta efecto. Si se define en cero, significa que no hay ninguna aplicación y que las conexiones en exceso no se desactivan. | ||
maxPoolSize | 100 | El número máximo de conexiones que una agrupación conservará en un momento dado. | ||
maxStatements | 0 | El tamaño de la caché PreparedStatement global de ThingWorx. | ||
maxStatementsPerConnection | 50 | El tamaño de la caché PreparedStatement global de ThingWorx para cada conexión. | ||
minPoolSize | 5 | El número mínimo de conexiones que una agrupación conservará en un momento dado. | ||
numHelperThreads | 6 | El número de subprocesos auxiliares que se van a generar. Generalmente, las operaciones JDBC lentas las realizan subprocesos auxiliares que no contienen bloqueos de contención. La distribución de estas operaciones en varios subprocesos puede mejorar significativamente el rendimiento, ya que permitirá que varias operaciones se realicen simultáneamente. | ||
password | n/d | Contraseña de base de datos. | ||
username | twadmin | Nombre de usuario de base de datos. | ||
tableLockTimeout | 10000 | El número de milisegundos que un cliente esperará a que se desbloquee una tabla de base de datos. | ||
testConnectionOnCheckout | falso | Si es true, se realizará una operación en cada extracción de conexión para verificar que la conexión es válida. | ||
unreturnedConnectionTimeout | 0 | El número de segundos que se debe esperar una respuesta de una conexión que no responde antes de descartarla. Si se define y una aplicación extrae una conexión, pero no la archiva dentro del período de tiempo especificado, la agrupación descartará la conexión. De este modo, las aplicaciones con pérdidas ocasionales de conexión persistirán, en lugar de agotar la agrupación de conexión. Cero significa ningún tiempo de espera y las aplicaciones deberán cerrar sus propias conexiones. | ||
StreamProcessorSettings | ||||
maximumBlockSize | 2500 | El número máximo de escrituras de flujo que se van a procesar en un bloque. | ||
maximumQueueSize | 250000 | El número máximo de entradas de flujo que pueden existir en cola (las posteriores se rechazarán). | ||
maximumWaitTime | 10000 | El tiempo de espera máximo (en milisegundos) antes de vaciar el búfer de flujo. | ||
numberOfProcessingThreads | 5 | El número de subprocesos que se deben utilizar al procesar propiedades. | ||
scanRate | 5 | La velocidad (en milisegundos) con la que se debe verificar el estado del búfer. | ||
sizeThreshold | 1000 | El número máximo de elementos que se pueden acumular antes de vaciar el búfer de flujo. | ||
Producer Timeout | 3000 | Esta configuración se aplica a los procesadores de entrada de flujos y actualmente solo es efectivo para el procesador de propiedades persistentes. En caso de que una cola esté llena y no tenga espacio para una nueva entrada, este es el tiempo máximo (en milisegundos) que un productor esperará para poner una entrada en la cola. Una vez transcurrido este tiempo de espera, si la cola sigue llena y no se puede disponer de espacio, la entrada no se añadirá a la cola. | ||
ValueStreamProcessorSettings | ||||
maximumBlockSize | 2500 | El número máximo de escrituras de flujo que se van a procesar en un bloque. | ||
maximumQueueSize | 250000 | El número máximo de entradas de flujo que pueden existir en cola (las posteriores se rechazarán). | ||
maximumWaitTime | 10000 | El tiempo de espera máximo (en milisegundos) antes de vaciar el búfer de flujo. | ||
numberOfProcessingThreads | 5 | El número de subprocesos que se deben utilizar al procesar propiedades. | ||
scanRate | 5 | La velocidad (en milisegundos) con la que se debe verificar el estado del búfer. | ||
sizeThreshold | 1000 | El número máximo de elementos que se pueden acumular antes de vaciar el búfer de flujo. | ||
Producer Timeout | 3000 | Esta configuración se aplica a los procesadores de entrada de flujos y actualmente solo es efectivo para el procesador de propiedades persistentes. En caso de que una cola esté llena y no tenga espacio para una nueva entrada, este es el tiempo máximo (en milisegundos) que un productor esperará para poner una entrada en la cola. Una vez transcurrido este tiempo de espera, si la cola sigue llena y no se puede disponer de espacio, la entrada no se añadirá a la cola. | ||
PersistentPropertyProcessorSettings | ||||
maximumBlockSize | 2500 | El número máximo de escrituras de propiedad para procesar en un bloque. | ||
maximumWaitTime | 1000 | El tiempo de espera máximo (en milisegundos) antes de vaciar el búfer de propiedad. | ||
maximumQueueSize | 100000 | El número máximo de entradas de propiedad que pueden existir en cola (las posteriores se rechazarán). | ||
numberOfProcessingThreads | 20 | El número de subprocesos que se deben utilizar al procesar propiedades. | ||
scanRate | 25 | La velocidad (en milisegundos) con la que se debe verificar el estado del búfer. | ||
sizeThreshold | 1000 | El número máximo de elementos que se pueden acumular antes de vaciar el búfer de propiedad. | ||
Producer Timeout | 3000 | Esta configuración se aplica a los procesadores de entrada de flujos y actualmente solo es efectivo para el procesador de propiedades persistentes. En caso de que una cola esté llena y no tenga espacio para una nueva entrada, este es el tiempo máximo (en milisegundos) que un productor esperará para poner una entrada en la cola. Una vez transcurrido este tiempo de espera, si la cola sigue llena y no se puede disponer de espacio, la entrada no se añadirá a la cola. | ||
Configuración | Por defecto | Descripción | ||||
|---|---|---|---|---|---|---|
ConnectionInformation | ||||||
acquireIncrement | 5 | Permite determinar el número de conexiones que la plataforma intentará adquirir a la vez cuando la agrupación se agote. | ||||
acquireRetryAttempts | 3 | Permite definir cuántas veces ThingWorx intentará adquirir una nueva conexión de la base de datos antes de abandonar. | ||||
acquireRetryDelay | 10000 | El tiempo (en milisegundos) que ThingWorx esperará entre los intentos de adquisición. | ||||
checkoutTimeout | 10000000 | El número de milisegundos que un cliente que llama a getConnection() esperará a que se archive o adquiera una conexión cuando la agrupación se agote. | ||||
Query Timeout | 600000 | La cantidad de tiempo (en milisegundos) que una consulta esperará para completarse antes de ser cancelada. | ||||
Network Timeout | 900000 | La cantidad de tiempo (en milisegundos) para que un subproceso espere la respuesta de la base de datos. Si no se recibe ninguna respuesta en este tiempo configurado, la plataforma cerrará la conexión subyacente y liberará el subproceso que espera la respuesta. | ||||
driverClass | org.postgresql.Driver | El nombre de clase completo de JDBC driverClass que se espera que proporcione las conexiones. | ||||
fetchSize | 5000 | El número de filas que se debe capturar por lotes en lugar del almacenamiento en caché de todas las filas en el lado del cliente. | ||||
idleConnectionTestPeriod | 60 | Si se trata de un número mayor que 0, ThingWorx probará todas las conexiones inactivas, agrupadas pero no extraídas, cada x segundos. | ||||
initialPoolSize | 5 | Número inicial de conexiones de base de datos creadas y conservadas dentro de una agrupación durante el arranque. Debe estar entre minPoolSize y maxPoolSize. | ||||
jdbcUrl | jdbc:postgresql://localhost:5432/thingworx | El URL de JDBC que se utiliza para conectar con PostgreSQL.
| ||||
maxConnectionAge | 0 | Segundos, efectivamente un período de vida. Una conexión más antigua que maxConnectionAge se destruirá y se depurará de la agrupación. | ||||
maxIdleTime | 0 | Segundos que una conexión puede permanecer en la agrupación, pero sin utilizar, antes de que se descarte. Cero significa que las conexiones inactivas nunca vencen. | ||||
maxIdleTimeExcessConnections | 300 | El número de segundos que debe permitirse que las conexiones en exceso de minPoolSize permanezcan inactivas en la agrupación antes de que se seleccionen. Está previsto para las aplicaciones que desean minimizar agresivamente el número de conexiones abiertas, reduciendo la agrupación de nuevo a minPoolSize si, después de un pico, disminuye el nivel de carga y ya no se necesitan las conexiones adquiridas. Si se define maxIdleTime, maxIdleTimeExcessConnections debe ser inferior para que surta efecto. Si se define en cero, significa que no hay ninguna aplicación y que las conexiones en exceso no se desactivan. | ||||
maxPoolSize | 100 | El número máximo de conexiones que una agrupación conservará en un momento dado. | ||||
maxStatements | 100 | El tamaño de la caché PreparedStatement global de ThingWorx. | ||||
minPoolSize | 5 | El número mínimo de conexiones que una agrupación conservará en un momento dado. | ||||
numHelperThreads | 8 | El número de subprocesos auxiliares que se van a generar. Generalmente, las operaciones JDBC lentas las realizan subprocesos auxiliares que no contienen bloqueos de contención. La distribución de estas operaciones en varios subprocesos puede mejorar significativamente el rendimiento, ya que permitirá que varias operaciones se realicen simultáneamente. | ||||
password | <contraseña única> | La contraseña que se utiliza para conectarse a la base de datos. | ||||
testConnectionOnCheckout | falso | Si es true, se realizará una operación en cada extracción de conexión para verificar que la conexión es válida. | ||||
unreturnedConnectionTimeout | 0 | El número de segundos que se debe esperar una respuesta de una conexión que no responde antes de descartarla. Si se define y una aplicación extrae una conexión, pero no la archiva dentro del período de tiempo especificado, la agrupación descartará la conexión. De este modo, las aplicaciones con pérdidas ocasionales de conexión persistirán, en lugar de agotar la agrupación de conexión. Cero significa ningún tiempo de espera y las aplicaciones deberán cerrar sus propias conexiones. | ||||
username | twadmin | El usuario que tiene permiso para modificar las tablas. Se trata del usuario que se ha creado en la base de datos para el servidor de ThingWorx.
| ||||
Configuración del procesador de flujos | ||||||
maximumBlockSize | 2500 | El número máximo de escrituras de flujo que se van a procesar en un bloque. | ||||
maximumQueueSize | 250000 | El número máximo de entradas de flujo que pueden existir en cola (las posteriores se rechazarán). | ||||
maximumWaitTime | 10000 | Número de milisegundos que el sistema espera antes de vaciar el búfer de flujo. | ||||
numberOfProcessingThreads | 5 | Número de subprocesos de procesamiento. | ||||
scanRate | 5 | El estado de búfer se verifica con el valor de velocidad especificado en milisegundos. | ||||
sizeThreshold | 1000 | Número máximo de elementos que se pueden acumular antes de vaciar el búfer de flujo. | ||||
Producer Timeout | 3000 | Esta configuración se aplica a los procesadores de entrada de flujos y actualmente solo es efectivo para el procesador de propiedades persistentes. En caso de que una cola esté llena y no tenga espacio para una nueva entrada, este es el tiempo máximo (en milisegundos) que un productor esperará para poner una entrada en la cola. Una vez transcurrido este tiempo de espera, si la cola sigue llena y no se puede disponer de espacio, la entrada no se añadirá a la cola. | ||||
Configuración de procesador de flujo de valores | ||||||
maximumBlockSize | 2500 | Número máximo de escrituras de flujo de valores para procesar en un bloque. | ||||
maximumQueueSize | 500000 | Número máximo de entradas de flujo de valor que pueden existir en cola (las posteriores se rechazarán). | ||||
maximumWaitTime | 10000 | Número de milisegundos que el sistema espera antes de vaciar el búfer de flujo de valor. | ||||
numberofProcessingThreads | 5 | Número de subprocesos de procesamiento. | ||||
scanRate | 5 | La velocidad (en milisegundos) antes de vaciar el búfer de flujo. | ||||
sizeThreshold | 1000 | Número máximo de elementos que se pueden acumular antes de vaciar el búfer de flujo de valor. | ||||
Producer Timeout | 3000 | Esta configuración se aplica a los procesadores de entrada de flujos y actualmente solo es efectivo para el procesador de propiedades persistentes. En caso de que una cola esté llena y no tenga espacio para una nueva entrada, este es el tiempo máximo (en milisegundos) que un productor esperará para poner una entrada en la cola. Una vez transcurrido este tiempo de espera, si la cola sigue llena y no se puede disponer de espacio, la entrada no se añadirá a la cola. | ||||
PersistentPropertyProcessorSettings | ||||||
maximumBlockSize | 2500 | El número máximo de escrituras de propiedad para procesar en un bloque. | ||||
maximumWaitTime | 1000 | El tiempo de espera máximo (en milisegundos) antes de vaciar el búfer de propiedad. | ||||
maximumQueueSize | 100000 | El número máximo de entradas de propiedad que pueden existir en cola (las posteriores se rechazarán). | ||||
numberOfProcessingThreads | 20 | El número de subprocesos que se deben utilizar al procesar propiedades. | ||||
scanRate | 25 | La velocidad (en milisegundos) con la que se debe verificar el estado del búfer. | ||||
sizeThreshold | 1000 | El número máximo de elementos que se pueden acumular antes de vaciar el búfer de propiedad. | ||||
Producer Timeout | 3000 | Esta configuración se aplica a los procesadores de entrada de flujos y actualmente solo es efectivo para el procesador de propiedades persistentes. En caso de que una cola esté llena y no tenga espacio para una nueva entrada, este es el tiempo máximo (en milisegundos) que un productor esperará para poner una entrada en la cola. Una vez transcurrido este tiempo de espera, si la cola sigue llena y no se puede disponer de espacio, la entrada no se añadirá a la cola. | ||||
Configuración | Por defecto | Descripción | ||
|---|---|---|---|---|
ConnectionInformation | ||||
acquireIncrement | 5 | Permite determinar el número de conexiones que ThingWorx intentará adquirir a la vez cuando la agrupación se agote. | ||
acquireRetryAttempts | 3 | Permite definir cuántas veces ThingWorx intentará adquirir una nueva conexión de la base de datos antes de abandonar. | ||
acquireRetryDelay | 10000 | El tiempo (en milisegundos) que ThingWorx esperará entre los intentos de adquisición. | ||
checkoutTimeout | 1000000 | El número de milisegundos que un cliente que llama a getConnection() esperará a que se archive o adquiera una conexión cuando la agrupación se agote. | ||
driverClass | com.microsoft.sqlserver.jdbc.SQLServerDriver | El nombre de clase completo de JDBC driverClass que se espera que proporcione las conexiones. | ||
fetchSize | 5000 | El número de filas que se debe capturar por lotes en lugar del almacenamiento en caché de todas las filas en el lado del cliente. | ||
idleConnectionTestPeriod | 60 | El período de tiempo (en segundos) durante el que se probarán las conexiones de modo que las conexiones inactivas no se cerrarán desde procesos externos, como barreras de seguridad, etc. Si se trata de un número mayor que 0, ThingWorx probará todas las conexiones inactivas, agrupadas pero no extraídas, cada x segundos.
| ||
initialPoolSize | 5 | Número inicial de conexiones de base de datos creadas y conservadas dentro de una agrupación durante el arranque. Debe estar entre minPoolSize y maxPoolSize. | ||
jdbcUrl | jdbc:sqlserver://localhost:1433;databaseName=thingworx;applicationName=Thingworx; | El URL de jdbc que se utiliza para conectar con MSSQL. | ||
maxConnectionAge | 0 | Segundos, efectivamente un período de vida. Una conexión más antigua que maxConnectionAge se destruirá y se depurará de la agrupación. | ||
maxIdleTime | 0 | Segundos que una conexión puede permanecer en la agrupación, pero sin utilizar, antes de que se descarte. Cero significa que las conexiones inactivas nunca vencen. | ||
maxIdleTimeExcessConnections | 300 | El número de segundos que debe permitirse que las conexiones en exceso de minPoolSize permanezcan inactivas en la agrupación antes de que se seleccionen. Está previsto para las aplicaciones que desean minimizar agresivamente el número de conexiones abiertas, reduciendo la agrupación de nuevo a minPoolSize si, después de un pico, disminuye el nivel de carga y ya no se necesitan las conexiones adquiridas. Si se define maxIdleTime, maxIdleTimeExcessConnections debe ser inferior para que surta efecto. Si se define en cero, significa que no hay ninguna aplicación y que las conexiones en exceso no se desactivan. | ||
maxPoolSize | 100 | El número máximo de conexiones que una agrupación conservará en un momento dado. | ||
maxStatements | 100 | El tamaño de la caché PreparedStatement global de ThingWorx. | ||
minPoolSize | 5 | El número mínimo de conexiones que una agrupación conservará en un momento dado. | ||
numHelperThreads | 8 | El número de subprocesos auxiliares que se van a generar. Generalmente, las operaciones JDBC lentas las realizan subprocesos auxiliares que no contienen bloqueos de contención. La distribución de estas operaciones en varios subprocesos puede mejorar significativamente el rendimiento, ya que permitirá que varias operaciones se realicen simultáneamente. | ||
password | <contraseña única> | La contraseña para conectarse a la base de datos. | ||
testConnectionOnCheckout | falso | Si es true, se realizará una operación en cada extracción de conexión para verificar que la conexión es válida. | ||
unreturnedConnectionTimeout | 0 | El número de segundos que se debe esperar una respuesta de una conexión que no responde antes de descartarla. Si se define y una aplicación extrae una conexión, pero no la archiva dentro del período de tiempo especificado, la agrupación descartará la conexión. De este modo, las aplicaciones con pérdidas ocasionales de conexión persistirán, en lugar de agotar la agrupación de conexión. Cero significa ningún tiempo de espera y las aplicaciones deberán cerrar sus propias conexiones. | ||
username | msadmin | Se trata del ID de usuario que es propietario del esquema TWSCHEMA y se utiliza para la autenticación en MSSQL en la cadena de conexión JDBC. | ||
Query Timeout | 600000 | La cantidad de tiempo (en milisegundos) que una consulta esperará para completarse antes de ser cancelada. | ||
Network Timeout | 900000 | La cantidad de tiempo (en milisegundos) para que un subproceso espere la respuesta de la base de datos. Si no se recibe ninguna respuesta en este tiempo configurado, la plataforma cerrará la conexión subyacente y liberará el subproceso que espera la respuesta. | ||
Configuración del procesador de flujos | ||||
maximumBlockSize | 2500 | El número máximo de escrituras de flujo que se van a procesar en un bloque. | ||
maximumQueueSize | 250000 | El número máximo de entradas de flujo que pueden existir en cola (las posteriores se rechazarán). | ||
maximumWaitTime | 10000 | Número de milisegundos que el sistema espera antes de vaciar el búfer de flujo. | ||
numberOfProcessingThreads | 5 | Número de subprocesos de procesamiento. | ||
scanRate | 5 | El estado de búfer se verifica con el valor de velocidad especificado en milisegundos. | ||
sizeThreshold | 1000 | Número máximo de elementos que se pueden acumular antes de vaciar el búfer de flujo. | ||
Producer Timeout | 3000 | Esta configuración se aplica a los procesadores de entrada de flujos y actualmente solo es efectivo para el procesador de propiedades persistentes. En caso de que una cola esté llena y no tenga espacio para una nueva entrada, este es el tiempo máximo (en milisegundos) que un productor esperará para poner una entrada en la cola. Una vez transcurrido este tiempo de espera, si la cola sigue llena y no se puede disponer de espacio, la entrada no se añadirá a la cola. | ||
Configuración de procesador de flujo de valores | ||||
maximumBlockSize | 2500 | Número máximo de escrituras de flujo de valores para procesar en un bloque. | ||
maximumWaitTime | 10000 | Número de milisegundos que el sistema espera antes de vaciar el búfer de flujo de valor. | ||
maximumQueueSize | 500000 | Número máximo de entradas de flujo de valor que pueden existir en cola (las posteriores se rechazarán). | ||
numberofProcessingThreads | 5 | Número de subprocesos de procesamiento. | ||
scanRate | 5 | La velocidad (en milisegundos) antes de vaciar el búfer de flujo. | ||
sizeThreshold | 1000 | Número máximo de elementos que se pueden acumular antes de vaciar el búfer de flujo de valor. | ||
Producer Timeout | 3000 | Esta configuración se aplica a los procesadores de entrada de flujos y actualmente solo es efectivo para el procesador de propiedades persistentes. En caso de que una cola esté llena y no tenga espacio para una nueva entrada, este es el tiempo máximo (en milisegundos) que un productor esperará para poner una entrada en la cola. Una vez transcurrido este tiempo de espera, si la cola sigue llena y no se puede disponer de espacio, la entrada no se añadirá a la cola. | ||
PersistentPropertyProcessorSettings | ||||
maximumBlockSize | 2500 | El número máximo de escrituras de propiedad para procesar en un bloque. | ||
maximumWaitTime | 1000 | El tiempo de espera máximo (en milisegundos) antes de vaciar el búfer de propiedad. | ||
maximumQueueSize | 100000 | El número máximo de entradas de propiedad que pueden existir en cola (las posteriores se rechazarán). | ||
numberOfProcessingThreads | 20 | El número de subprocesos que se deben utilizar al procesar propiedades. | ||
scanRate | 25 | La velocidad (en milisegundos) con la que se debe verificar el estado del búfer. | ||
sizeThreshold | 1000 | El número máximo de elementos que se pueden acumular antes de vaciar el búfer de propiedad. | ||
Producer Timeout | 3000 | Esta configuración se aplica a los procesadores de entrada de flujos y actualmente solo es efectivo para el procesador de propiedades persistentes. En caso de que una cola esté llena y no tenga espacio para una nueva entrada, este es el tiempo máximo (en milisegundos) que un productor esperará para poner una entrada en la cola. Una vez transcurrido este tiempo de espera, si la cola sigue llena y no se puede disponer de espacio, la entrada no se añadirá a la cola. | ||
Configuración de la caché
La configuración de la caché solo es necesaria cuando se ejecuta ThingWorx Platform en modo de clúster.
 | Si se ejecuta en el modo de servidor único, las opciones de la caché se deben excluir de la configuración. Si se incluyen para el modo de servidor único, se ejecutarán en el modo de almacenamiento en caché distribuido con Apache Ignite, que es menos eficaz que la ejecución del almacenamiento en caché de la memoria local por defecto. |
Configuración | Por defecto | Descripción |
|---|---|---|
provider-type | El proveedor de la caché para ejecutar en modo de servidor único.] | En el modo de clúster, el valor debe definirse siempre en com.thingworx.cache.ignite.IgniteCacheProvider. |
instance-name | ninguno | Permite definir el nombre de la instancia local de la caché. |
client-mode | true | Permite determinar si la instancia integrada de Ignite se ejecuta como cliente (por defecto) o como servidor. En el modo de servidor, participa en el almacenamiento de datos y utilizará más memoria. |
address-resolver type | static | Permite determinar cómo se detectarán otros nodos de Ignite. La configuración recomendada es zookeeper. |
connection | ninguno | Para un elemento address-resolver type de zookeeper, una lista delimitada por comas de los servidores de Apache ZooKeeper que se utilizan para coordinar la elección principal de ThingWorx. El patrón de la cadena es IP:puerto (por ejemplo, 127.0.0.1:2181, 127.0.0.2:2181). |
endpoints | ninguno | En el caso de un elemento address-resolver type de static, una matriz de direcciones estáticas en las que Ignite se está ejecutando. |
Adición de una sección de evento auditado a platform-settings.json
Cuando se reinicia ThingWorx Platform, todas las cosas activan el evento ThingStart. La auditoría de todos estos eventos aumenta el tiempo de arranque de la plataforma. Para evitar esta situación, el evento ThingStart está desactivado por defecto. Si aún desea auditar esta acción, se pueden activar y desactivar los eventos en el fichero platform-settings.json.
El fichero platform-settings.json no contiene ninguna sección para la auditoría. Para activar o desactivar categorías y mensajes, es necesario añadir una estructura JSON al fichero. En el caso de la instancia de ThingWorx Platform para la que se desean mensajes de auditoría, se necesita ser un administrador con permisos para localizar y editar el fichero platform-settins.json y añadir la configuración adecuada.
| | La sección Audit se debe añadir como nodo del mismo nivel a la entrada JSON de PlatformSettingsConfig. Puede encontrarse antes o después del nodo PlatformSettingsConfig, pero debe estar en el mismo nivel de nodo. |
A continuación se muestra un ejemplo de una estructura de auditoría colocada después del nodo PlatformSettingsConfig en el fichero 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"
]
}
]
}
En este ejemplo, la categoría COLLABORATION y ["ALL"] de sus eventos/mensajes están desactivados. Para la categoría AUTHENTICATION, se desactivan dos eventos/mensajes, LoginSucceeded y ApplicationKeyFailed. REMOTE_ACCESS y ["ALL"] de sus eventos/mensajes están activados. Para la categoría AUTHENTICATION, el evento/mensaje LoginFailed está activado. Para THINGGROUPMEMBERSHIPs, todos los mensajes de auditoría están activados. En lugar de utilizar ["ALL"], estos mensajes se muestran por separado. Es posible que desee elegir este método para introducir mensajes de auditoría de modo que se pueda determinar si se necesitan todos después de ejecutar la instancia de plataforma durante un tiempo prolongado.
La categoría audit.AuditCategory.ThingGroupMemberships permite proporcionar mensajes de auditoría sobre los cambios en la afiliación de un grupo de cosas. Esta categoría de mensajes de auditoría está desactivada por defecto porque no todas las configuraciones o implementaciones requieren estos mensajes de auditoría ni los administradores del sistema quieren incurrir en el cálculo y el impacto en la persistencia de estos cambios. Si las configuraciones o implementaciones requieren mensajes de auditoría para los cambios en la afiliación al grupo de cosas, se pueden activar tal como se muestra en el ejemplo anterior. La configuración de cada mensaje de auditoría se puede activar o desactivar sin necesidad de activar o desactivar otros mensajes de auditoría. Por ejemplo, es posible que solo desee auditar determinados cambios de afiliación. Los mensajes de auditoría para las afiliaciones a un grupo de cosas se muestran en la tabla Tabla 122, en el tema Mensajes de auditoría de ThingWorx de este centro de ayuda.
 | Los mensajes de auditoría para los dos tipos de mensaje siguientes siempre están activados y no requieren una activación explícita. Proporcionan mensajes de auditoría cuando la función de delegación de permisos de visibilidad para grupos de cosas está activada o desactivada: com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationEnabled com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationDisabled . |
Para activar o desactivar cualquier categoría y mensaje de auditoría, se puede copiar la estructura que se muestra arriba y añadir las claves adecuadas a los grupos "Disabled" y/o "Enabled". Para obtener un procedimiento paso a paso, consulte Activación y desactivación de eventos de auditoría. Para buscar las claves adecuadas para las categorías y los mensajes de evento, consulte la tabla Tabla 122 en el tema Mensajes de auditoría de ThingWorx de este centro de ayuda.