Сведения о конфигурации platform-settings.json
Файл platform-settings.json, входящий в пакет загрузки программного обеспечения, доступен администраторам для корректировки и более тонкой настройки параметров. Настройки, специфичные для кластеризации высокой доступности, см. в разделе настройки платформы для ThingWorx HA.
 |
Ниже приведен пример, содержащий все опции. Обязательным является только один поставщик хранилища данных.
|
{
"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"
}
}
}
}
}
|
|
Параметры networkTimeout, queryTimeout и producerTimeout должны использоваться только из ThingWorx 9.2.8 и более поздних версий, а также из ThingWorx 9.3.3 и более поздних версий.
|
Настройки platform-settings.json
Базовые настройки
Настройка | По умолчанию | Описание | ||||
|---|---|---|---|---|---|---|
BackupStorage | /ThingworxBackupStorage | Наименование каталога, в который записываются все резервные копии. | ||||
DatabaseLogRetentionPolicy | 7 | Число суток, в течение которых сохраняются журналы баз данных. | ||||
DatabaseWriteRetryAttempts | 10 | Максимальное число попыток, выполняемых системой для повторной попытки сохранения записей в базе данных в случае потери соединения. | ||||
EnableBackup | true | Определяет, нужно ли сохранять резервные копии. | ||||
EnableClusteredMode | false | Определяет, выполняется ли ThingWorx как кластер или как автономный сервер. | ||||
EnableSystemLogging | false | Определяет, включено ли системное ведение журнала.
| ||||
EnableSSO | false | Задайте значение true, чтобы включить SSO для ThingWorx Platform. Когда единый вход (SSO) включен, вся аутентификация перенаправляется на центральный сервер авторизации, который настроен в файле sso-settings.json. На аутентификацию через WebSocket в Edge это не влияет. | ||||
FileRepositoryRoot | /ThingworxStorage | Каталог, в котором создается корневой репозиторий файлов. Расположение по умолчанию, которое можно использовать для автономных развертываний. Для развертываний ThingWorx высокой доступности репозиторий должен быть расположен в совместно используемой файловой системе, к которой имеют доступ все серверы ThingWorx. | ||||
HTTPRequestHeaderMaxLength | 2000 | Максимально допустимая длина значений заголовков HTTP-запросов. | ||||
HTTPRequestParameterMaxLength | 2000 | Максимально допустимая длина значений параметров HTTP-запросов. | ||||
InternalAesCryptographicKeyLength | 128 | Длина ключа, используемая при генерации симметричного ключа AES. Поддерживаемые значения: 128, 192 и 256.
| ||||
MetricsLoggingFrequency | 30 | Частота в минутах, с которой метрики, собранные платформой, регистрируются в журнале приложений. | ||||
MetricsLoggingLevel | WARN | Уровень журнала, на котором метрики, собранные платформой, регистрируются в журнале приложений. Значение может быть одним из следующих: WARN, DEBUG, TRACE, INFO или ERROR. | ||||
MetricsReportingEnabled | Н/Д | Определяет, отправлять ли в PTC данные о параметрах производительности. Можно также сконфигурировать эту опцию в подсистеме платформы. Дополнительные сведения о сборе данных в ThingWorx см. в разделе Сбор данных в ThingWorx. | ||||
SessionUpdateDelay | 60 | Количество времени в секундах, добавленное в lastUpdateTime, после которого будет обновлено значение lastUpdateTime сессии. Если во время задержки получено несколько запросов, то только первый запрос обновит lastUpdateTime. Значение по умолчанию: 60 секунд. | ||||
Storage | /ThingworxStorage | Каталог, в котором создаются/находятся все каталоги хранилищ (за исключением хранилища резервных копий). | ||||
ScriptTimeout | 30 | Максимальное число секунд, в течение которых сценарий может выполняться до того, как платформа ThingWorx прервет выполнение сценария.
| ||||
MaxSearchItems | 100000 | Разрешите пользователям увеличивать предел поиска по умолчанию в соответствии с количеством сущностей, присутствующих в среде. Значение MaxSearchItems, заданное интерфейсами API SearchFunctions группы ресурсов в ThingWorx Composer, будет иметь более высокий приоритет, чем значение, заданное в platform-settings.json. Если в MaxSearchItems задано значение больше 100 тысяч, передайте соответствующие критерии поиска в соответствии с вариантом использования, чтобы сократить время поиска для получения необходимого количества объектов.
|
Настройки конфигурации домена
Настройка | По умолчанию | Описание | ||
|---|---|---|---|---|
ignoreTrustedDomains | true | Если для этого флага задано значение true, разрешены все внешние HTTP-вызовы через медиаобъекты. Если задано значение false, разрешены только HTTP-вызовы перечисленных в trustedDomains доменов. | ||
trustedDomains | Н/Д | Список проверенных и доверенных доменов, которые пользователи могут использовать для доступа к медиаобъекту в мэшапе через объект Media-Entity.
|
Настройки центра решений
Настройка | По умолчанию | Описание | ||
|---|---|---|---|---|
SolutionCentralHost | sc.thingworx.com | Имя хост-компьютера центра решений | ||
SolutionCentralPort | 443 | Сведения о порте Центра решений
| ||
KeyStorePath | /ThingworxPlatform/sc-keystore | Путь к своему хранилищу ключей | ||
KeyStorePass | Нет | Пароль для своего хранилища ключей
|
Настройки ThingWorx Flow
Эти свойства применимы только в том случае, если приложение ThingWorx Flow установлено вместе с ThingWorx Foundation. Эти значения должны быть определены как в файлах конфигурации потока, так и в RabbitMQ и не должны правиться, если они не были изменены ThingWorx в обоих приложениях.
Настройка | По умолчанию | Описание | ||
|---|---|---|---|---|
EnableOrchestration | true | Указывает, активен ли ThingWorx Flow в ThingWorx Foundation. | ||
QueueHost | localhost | Имя хост-компьютера RabbitMQ | ||
QueuePort | 5672 | Порт RabbitMQ | ||
QueueName | 256mb | Наименование очереди RabbitMQ | ||
QueueUsername | flowuser | Имя пользователя очереди RabbitMQ | ||
QueuePassword | encrypt.queue.password | Пароль очереди RabbitMQ
| ||
QueueVHost | orchestration | Имя RabbitMQ VHost | ||
TurnOffScopesApprovalPopup | false | Задайте для этого параметра значение true, чтобы окна утверждения разрешения не открывались в процессе входа в систему. |
Настройки политики импорта пакета расширений
Импорт расширений отключен по умолчанию для всех пользователей. Используйте следующие настройки, чтобы сконфигурировать функциональность импорта расширений. Дополнительные сведения см. в разделе Импорт расширений.
Настройка | Описание | По умолчанию | Примеры | ||||
|---|---|---|---|---|---|---|---|
importEnabled | Управление на верхнем уровне, которое предоставляет возможность импортировать (= true) или не импортировать (= false) расширения. | false | • importEnabled: false - расширения невозможно импортировать, даже если в других настройках ExtensionPackageImportPolicy задано значение true. • importEnabled: true - передает импорт расширений в следующий набор настроек allow<Content>Resources (см. строки ниже).
| ||||
allowJarResources | Разрешает импортировать расширения с ресурсами JAR. | false | • allowJarResources: true - разрешает импортировать расширения, которые объявляют файлы JAR в своем манифесте, как ресурсы JAR. • allowJarResources: false - не разрешает импортировать расширения, которые объявляют файлы JAR в своем манифесте, как ресурсы JAR. | ||||
allowJavascriptResources | Разрешает импортировать расширения с ресурсами JavaScript. | false | • allowJavascriptResources: true - разрешает импортировать расширения, которые объявляют ресурсы файла интерфейса пользователя JavaScript типа JS в своем манифесте, как ресурсы JavaScript. • allowJavascriptResources: false - не разрешает импортировать расширения, которые объявляют ресурсы файла интерфейса пользователя JavaScript типа JS в своем манифесте, как ресурсы JavaScript. | ||||
allowCSSResources | Разрешает импортировать расширения с ресурсами CSS. | false | • allowCSSResources: true - разрешает импортировать расширения, которые содержат ресурсы файла интерфейса пользователя CSS. • allowCSSResources: false - не разрешает импортировать расширения, которые содержат ресурсы файла интерфейса пользователя CSS. | ||||
allowJSONResources | Разрешает импортировать расширения с ресурсами JSON (например, файлы локализации). | false | • allowJSONResources: true - разрешает импортировать расширения, которые содержат ресурсы файла интерфейса пользователя JSON. • allowJSONResources: false - не разрешает импортировать расширения, которые содержат ресурсы файла интерфейса пользователя JSON. | ||||
allowWebAppResources | Разрешает импортировать расширения с веб-ресурсами. | false | • allowWebAppResources: true - разрешает импортировать расширения, которые содержат ресурсы файла интерфейса пользователя WebApp. • allowWebAppResources: false - не позволит импортировать расширения, которые содержат ресурсы файла интерфейса пользователя WebApp. | ||||
allowEntities | Разрешает импортировать расширения с нерасширяемыми сущностями. В число нерасширяемых сущностей входят: • Ключ приложения • Аутентификатор • Информационная панель • Определение анализа данных • Структура данных • GenericContentEntity и производные дочерние классы, такие как "Определение состояния", "Определение стилей" и "Темы оформления стиля" • Группа • Таблица локализации • Журнал • Мэшап • Медиаобъект • Menu • ModeledServiceProviderEntity и дочерние классы, такие как "Содержимое уведомления" • Сеть • Определение уведомления • Организация • Поставщик хранилища данных • PersistenceProviderPackage и производные дочерние классы • Проект • Профиль вещи • Шаблон вещи • Пользователь • Словарь и производные дочерние классы, такие как DataTagVocabulary, ModelTagVocabulary | false | • allowEntities: true - разрешает импортировать расширения, которые объявляют нерасширяемые сущности в своем манифесте. • allowEntities: false - не разрешает импортировать расширения, которые объявляют нерасширяемые сущности в своем манифесте. | ||||
allowExtensibleEntities | Разрешает импортировать расширения с нерасширяемыми сущностями. В число расширяемых сущностей входят: • DirectoryService и производные дочерние классы • ExtensionPackage • Ресурс и полученные дочерние классы, которые содержат пользовательские функции/сервисы, используемые в качестве ресурсов, подобных готовым к применению ресурсам (OOTB), таким как InfoTableFunctions, EntityServices и EncryptionServices.
• ScriptFunctionLibrary и производные дочерние классы. • Подсистема и производные дочерние классы.
• Пакет вещей • Виджет | false | • allowExtensibleEntities: true - разрешает импортировать расширения, которые объявляют расширяемые сущности в своем манифесте. • allowExtensibleEntities: false - не разрешает импортировать расширения, которые объявляют расширяемые сущности в своем манифесте. | ||||
haCompatibilityImportLevel | При выполнении ThingWorx в кластерном режиме можно ограничить импорт расширений только теми, для которых для флага haCompatibility в метаданных расширения задано значение true. По умолчанию задана настройка WARN, которая разрешает импорт, но генерирует предупреждение в журнале приложения. Можно изменить ее значение на DENY; в этом случае импорт завершается сбоем и в журнале приложения генерируется ошибка. | WARN | • "haCompatibilityImportLevel": "WARN" - импорт расширений выполняется успешно, и предупреждения генерируются для расширений, для которых не задано "haCompatible" : "TRUE" . • "haCompatibilityImportLevel": "DENY" - будут импортированы только расширения с настройкой "haCompatible" : "TRUE". Импорт всех другие расширений приведет к сбою и созданию сообщений об ошибке. |
Настройки режима кластеризации
Настройки, специфичные для выполнения ThingWorx в кластерном режиме. Все настройки игнорируются, если описанная выше настройка EnableClusteredMode имеет значение false.
Настройка | По умолчанию | Описание |
|---|---|---|
PlatformId | none | Уникальный идентификатор для каждого узла в кластере. Этот идентификатор будет отображаться в объединенных журналах. Он должен содержать буквенно-цифровые символы и иметь длину меньше 32 символов. Он должен соответствовать шаблону "^[a-zA-Z0-9]{1,32}$". |
CoordinatorHosts | none | Разделенный запятыми список серверов Apache ZooKeeper, используемых для координации выбора ведущего объекта ThingWorx. Шаблон строки: "IP:port". (Например, "127.0.0.1:2181, 127.0.0.2:2181".) |
ZKNamespace | ThingWorx | Корневой путь узла, используемый для отслеживания информации в ZooKeeper для кластера. Это требуется при выполнении нескольких кластеров с использованием одного и того же ZooKeeper. Применяются ограничения именования ZooKeeper; см. документ http://zookeeper.apache.org/doc/current/zookeeperProgrammers.html#ch_zkDataModel (на английском языке). |
ModelSyncPollInterval | 100 | Частота синхронизации модели между серверами в кластере. Значение в миллисекундах. |
ModelSyncWaitPeriod | 3000 | При обмене данными через WebSocket трафик направляется на серверы с циклическим обходом. Если изменение модели выполняется через WebSocket, следующий запрос будет ожидать, пока не пройдет указанное время в миллисекундах для синхронизации модели на любом сервере, на который он попадает. Если синхронизация не выполняется до истечения тайм-аута, запрос завершается сбоем с ошибкой тайм-аута. |
ModelSyncTimeout | 120000 | Время ожидания (в миллисекундах) каждой повторной попытки. |
CoordinatorMaxRetries | 3 | В случае сбоя связи с координатором он будет повторен n раз перед сбоем. |
CoordinatorSessionTimeout | 90000 | Время (в миллисекундах), в течение которого ThingWorx ожидает получения контрольного сигнала от сервиса Apache ZooKeeper, используемого для координации приоритета ThingWorx. |
CoordinatorConnectionTimeout | 10000 | Промежуток времени (в миллисекундах), в течение которого система будет ожидать соединения с координатором. |
MetricsCacheFrequency | 60000 | Метрики отслеживаются по серверам и суммируются для метрик уровня кластера. Это значение представляет частоту (в миллисекундах), с которой обновляются метрики кластера. |
Настройки администратора
Настройка | По умолчанию | Описание |
|---|---|---|
InitialPassword | Н/Д | Начальный пароль администратора, необходимый для входа в ThingWorx впервые. Минимальная длина может быть сконфигурирована в подсистеме управления пользователями (минимум: 10 символов, по умолчанию: 14 символов). Дополнительные сведения см. в разделе . |
Настройки типов содержимого
Настройка | По умолчанию | Описание | ||
|---|---|---|---|---|
supportedMediaEntityContentTypes | "image/svg+xml","image/png","image/gif","image/bmp","image/jpeg","application/pdf","image/vnd.microsoft.icon" | Разделенный запятыми список допустимых типов содержимого MIME, которые могут динамически связываться с медиаобъектами. Можно добавлять дополнительные типы.
|
Лицензирование настроек подключения
Настройка | По умолчанию | Описание | ||
|---|---|---|---|---|
username | Н/Д | Имя пользователя для сайта поддержки PTC | ||
password | Н/Д | Пароль для сайта поддержки PTC | ||
timeout (в секундах) | 60 | По окончании тайм-аута в журнале приложения регистрируется следующая ошибка: License Server could not process request | ||
useProxy | false | Включает настройки прокси для лицензирования. Если задано значение true, для соединения с сервером лицензий используются учетные данные прокси-сервера. | ||
proxyHost | Наименование хост-компьютера прокси. | |||
proxyPort | Номер порта хост-компьютера прокси. | |||
proxyScheme | http | http или https. | ||
proxyUsername | Имя пользователя для аутентификации, если для подключения к прокси-серверу требуется аутентификация. | |||
proxyPassword | Пароль для аутентификации, если для подключения к прокси-серверу требуется аутентификация.
| |||
proxyUseNTLM | false | Опция использования протокола NTLM. | ||
proxyWorkstation | Имя компьютера пользователя в сети, если требуется аутентификация NTLM. | |||
proxyDomain | Имя домена пользователя, если требуется аутентификация NTLM. |
Настройки пользователя метрик
Настройка | По умолчанию | Описание |
|---|---|---|
InitialPassword | Создает MetricsUser во время запуска системы и используется сервером Prometheus для получения информации о метриках из экземпляра ThingWorx. Это требуется для всех развертываний MSAI, но необязательно для всех других типов развертываний. |
Настройки поставщика хранилища данных
Для всех перечисленных ниже баз данных необходимо выполнять следующие правила для настроек процессоров потоков значений и настроек процессоров потоков:
StreamProcessorSettings.numberOfProcessingThreads + ValueStreamProcessorSettings.numberOfProcessingThreads < 50% of DB connection pool
And
ValueStreamProcessorSettings.numberOfProcessingThreads >= StreamProcessorSettings.numberOfProcessingThreads
And
ValueStreamProcessorSettings.numberOfProcessingThreads >= StreamProcessorSettings.numberOfProcessingThreads
Настройка | По умолчанию | Описание | ||
|---|---|---|---|---|
Информация о соединении | ||||
acquireIncrement | 5 | Определяет число подключений, которое будет пытаться получить ThingWorx за один раз после исчерпания пула. | ||
acquireRetryAttempts | 30 | Определяет для ThingWorx доступное число попыток получить новое подключение к базе данных. | ||
acquireRetryDelay | 1000 | Время (в миллисекундах), в течение которого ThingWorx будет ожидать между попытками получения подключения. | ||
checkoutTimeout | 1000000 | Число миллисекунд, в течение которых клиент, выполняющий вызов getConnection(), будет ожидать сдачи на хранение или получения подключения, если пул исчерпан. | ||
Network Timeout | 900000 | Длительность времени ожидания потоком ответа от базы данных (в миллисекундах). Если ответ не получен за сконфигурированный промежуток времени, платформа закрывает базовое соединение и освобождает поток, ожидающий ответа. | ||
idleConnectionTestPeriod | 6 | Период времени (в секундах), в течение которого подключения будут тестироваться, а неактивные подключения не смогут быть закрыты из внешних процессов, таких как брандмауэры и т. д. Если это число будет больше 0, ThingWorx будет проверять все неактивные, находящиеся в пуле, но не используемые подключения каждые x секунд.
| ||
initialPoolSize | 10 | Начальное число соединений с базой данных, создаваемых и поддерживаемых в пуле после запуска. Значение должно быть между minPoolSize и maxPoolSize. | ||
maxConnectionAge | 0 | Эффективное время жизни, в секундах. Соединения, которые существуют дольше maxConnectionAge, будут разорваны и удалены из пула. | ||
maxIdleTime | 0 | Число секунд, в течение которых подключение может оставаться в пуле без использования, прежде чем оно будет отменено. Ноль означает, что время ожидания для подключений не ограничено. | ||
maxIdleTimeExcessConnections | 36000 | Число секунд, в течение которых соединения, превышающие размер пула minPoolSize, могут оставаться в пуле неактивными, прежде чем они будут разорваны. Предназначено для приложений, активно минимизирующих числа открытых подключений путем сокращения пула до minPoolSize, если после пика нагрузки ее уровень уменьшается и наличные подключения больше не нужны. Если задано значение maxIdleTime, значение maxIdleTimeExcessConnections должно быть меньше него, чтобы обеспечить нужный эффект. Задание этого значения равным нулю означает отсутствие ограничений, т. е. избыточные соединения не делаются неактивными. | ||
maxPoolSize | 100 | Максимальное количество подключений, которое будет поддерживаться в пуле в любой момент времени. | ||
maxStatements | 0 | Размер глобального кэша PreparedStatement в ThingWorx. | ||
maxStatementsPerConnection | 50 | Размер глобального кэша PreparedStatement в ThingWorx для каждого подключения. | ||
minPoolSize | 5 | Максимальное количество подключений, которое будет поддерживаться в пуле в любой момент времени. | ||
numHelperThreads | 6 | Число вспомогательных потоков, которые нужно создать. Медленные операции JDBC обычно выполняются во вспомогательных потоках, которые не содержат конфликтные блокировки. Распределение этих операций по нескольким потокам может значительно повысить производительность благодаря возможности одновременного выполнения нескольких операций. | ||
password | Н/Д | Пароль базы данных. | ||
username | twadmin | Имя пользователя базы данных. | ||
tableLockTimeout | 10000 | Число миллисекунд, в течение которых клиент будет ожидать разблокирования таблицы базы данных. | ||
testConnectionOnCheckout | false | Если задано значение true, операция будет выполняться при каждом взятии на изменение подключения, чтобы проверить, что подключение является допустимым. | ||
unreturnedConnectionTimeout | 0 | Число секунд ожидания отклика от неотвечающего подключения перед его удалением. Если задано и если приложение получает подключение, а затем не может вернуть его в указанный период времени, подключение будет удалено из пула. Это позволяет приложениям со случайным нарушением подключения продолжать работать и предотвращает преждевременное исчерпание пула подключений. Ноль означает отсутствие тайм-аута, то есть приложения сами должны закрывать свои подключения. | ||
StreamProcessorSettings | ||||
maximumBlockSize | 2500 | Максимальное число операций записи потока в блоке обработки | ||
maximumQueueSize | 250000 | Максимальное число записей потока для постановки в очередь (записи сверх этого числа будут отклонены). | ||
maximumWaitTime | 10000 | Максимальное время ожидания (в миллисекундах) перед сбросом буфера потока. | ||
numberOfProcessingThreads | 5 | Число потоков, которое будет использоваться при обработке свойств. | ||
scanRate | 5 | Частота (в миллисекундах), с которой необходимо проверять статус буфера. | ||
sizeThreshold | 1000 | Максимальное число элементов, которое может быть накоплено перед сбросом буфера потока | ||
Producer Timeout | 3000 | Эта настройка применяется к процессорам записей потока и в настоящее время действует только для процессора сохраняемых свойств. Если очередь заполнена и в ней нет места для новой записи, это максимальное время (в миллисекундах, в течение которого производитель будет ожидать помещения записи в очередь. Если после превышения времени ожидания очередь все еще заполнена и в ней нет доступного места, запись не будет добавлена в очередь. | ||
ValueStreamProcessorSettings | ||||
maximumBlockSize | 2500 | Максимальное число операций записи потока в блоке обработки | ||
maximumQueueSize | 250000 | Максимальное число записей потока для постановки в очередь (записи сверх этого числа будут отклонены). | ||
maximumWaitTime | 10000 | Максимальное время ожидания (в миллисекундах) перед сбросом буфера потока. | ||
numberOfProcessingThreads | 5 | Число потоков, которое будет использоваться при обработке свойств. | ||
scanRate | 5 | Частота (в миллисекундах), с которой необходимо проверять статус буфера. | ||
sizeThreshold | 1000 | Максимальное число элементов, которое может быть накоплено перед сбросом буфера потока | ||
Producer Timeout | 3000 | Эта настройка применяется к процессорам записей потока и в настоящее время действует только для процессора сохраняемых свойств. Если очередь заполнена и в ней нет места для новой записи, это максимальное время (в миллисекундах, в течение которого производитель будет ожидать помещения записи в очередь. Если после превышения времени ожидания очередь все еще заполнена и в ней нет доступного места, запись не будет добавлена в очередь. | ||
PersistentPropertyProcessorSettings | ||||
maximumBlockSize | 2500 | Максимальное число операций записи свойств в блоке обработки. | ||
maximumWaitTime | 1000 | Максимальное время ожидания (в миллисекундах) перед сбросом буфера свойств. | ||
maximumQueueSize | 100000 | Максимальное число записей свойств для постановки в очередь (записи сверх этого числа будут отклонены). | ||
numberOfProcessingThreads | 20 | Число потоков, которое будет использоваться при обработке свойств. | ||
scanRate | 25 | Частота (в миллисекундах), с которой необходимо проверять статус буфера. | ||
sizeThreshold | 1000 | Максимальное число элементов, которое может быть накоплено перед сбросом буфера свойств | ||
Producer Timeout | 3000 | Эта настройка применяется к процессорам записей потока и в настоящее время действует только для процессора сохраняемых свойств. Если очередь заполнена и в ней нет места для новой записи, это максимальное время (в миллисекундах, в течение которого производитель будет ожидать помещения записи в очередь. Если после превышения времени ожидания очередь все еще заполнена и в ней нет доступного места, запись не будет добавлена в очередь. | ||
Настройка | По умолчанию | Описание | ||||
|---|---|---|---|---|---|---|
ConnectionInformation | ||||||
acquireIncrement | 5 | Определяет число подключений, которое платформа будет пытаться получить одновременно после исчерпания пула. | ||||
acquireRetryAttempts | 3 | Определяет для ThingWorx доступное число попыток получить новое подключение к базе данных. | ||||
acquireRetryDelay | 10000 | Время (в миллисекундах), в течение которого ThingWorx будет ожидать между попытками получения подключения. | ||||
checkoutTimeout | 10000000 | Число миллисекунд, в течение которых клиент, выполняющий вызов getConnection(), будет ожидать сдачи на хранение или получения подключения, если пул исчерпан. | ||||
Query Timeout | 600000 | Длительность времени ожидания выполнения запроса (в миллисекундах) перед его отменой. | ||||
Network Timeout | 900000 | Длительность времени ожидания потоком ответа от базы данных (в миллисекундах). Если ответ не получен за сконфигурированный промежуток времени, платформа закрывает базовое соединение и освобождает поток, ожидающий ответа. | ||||
driverClass | org.postgresql.Driver | Полностью определенное имя класса JDBC driverClass - предполагаемого поставщика подключений. | ||||
fetchSize | 5000 | Число строк, которые будут выбраны в пакетах вместо кэширования всех строк на стороне клиента. | ||||
idleConnectionTestPeriod | 60 | Если это число больше 0, ThingWorx будет проверять все неактивные находящиеся в пуле, но не возвращенные подключения каждые x секунд. | ||||
initialPoolSize | 5 | Начальное число соединений с базой данных, создаваемых и поддерживаемых в пуле после запуска. Значение должно быть между minPoolSize и maxPoolSize. | ||||
jdbcUrl | jdbc:postgresql://localhost:5432/thingworx | URL-адрес JDBC, используемый для соединения с PostgreSQL.
| ||||
maxConnectionAge | 0 | Эффективное время жизни, в секундах. Соединения, которые существуют дольше времени maxConnectionAge, будут разорваны и удалены из пула. | ||||
maxIdleTime | 0 | Число секунд, в течение которых подключение может оставаться в пуле без использования, прежде чем оно будет отменено. Ноль означает, что время ожидания для подключений не ограничено. | ||||
maxIdleTimeExcessConnections | 300 | Число секунд, в течение которых соединения, превышающие размер пула minPoolSize, могут оставаться в пуле неактивными, прежде чем они будут разорваны. Предназначено для приложений, активно минимизирующих числа открытых подключений путем сокращения пула до minPoolSize, если после пика нагрузки ее уровень уменьшается и наличные подключения больше не нужны. Если задано значение maxIdleTime, значение maxIdleTimeExcessConnections должно быть меньше него, чтобы обеспечить нужный эффект. Задание этого значения равным нулю означает отсутствие ограничений, т. е. избыточные соединения не делаются неактивными. | ||||
maxPoolSize | 100 | Максимальное количество подключений, которое будет поддерживаться в пуле в любой момент времени. | ||||
maxStatements | 100 | Размер глобального кэша PreparedStatement в ThingWorx. | ||||
minPoolSize | 5 | Максимальное количество подключений, которое будет поддерживаться в пуле в любой момент времени | ||||
numHelperThreads | 8 | Число вспомогательных потоков, которые нужно создать. Медленные операции JDBC обычно выполняются во вспомогательных потоках, которые не содержат конфликтные блокировки. Распределение этих операций по нескольким потокам может значительно повысить производительность благодаря возможности одновременного выполнения нескольких операций. | ||||
password | <уникальный пароль> | Пароль, используемый для входа в базу данных. | ||||
testConnectionOnCheckout | false | Если задано значение true, операция будет выполняться при каждом взятии на изменение подключения, чтобы проверить, что подключение является допустимым. | ||||
unreturnedConnectionTimeout | 0 | Число секунд ожидания отклика от неотвечающего подключения перед его удалением. Если задано и если приложение получает подключение, а затем не может вернуть его в указанный период времени, подключение будет удалено из пула. Это позволяет приложениям со случайным нарушением подключения продолжать работать и предотвращает исчерпание через некоторое время пула подключений. Ноль означает отсутствие тайм-аута, то есть приложения сами должны закрывать свои подключения. | ||||
username | twadmin | Пользователь, который имеет право изменять таблицы. Это пользователь, созданный в базе данных для сервера ThingWorx.
| ||||
Настройки процессора потоков | ||||||
maximumBlockSize | 2500 | Максимальное число операций записи потока в блоке обработки | ||||
maximumQueueSize | 250000 | Максимальное число записей потока для постановки в очередь (записи сверх этого числа будут отклонены). | ||||
maximumWaitTime | 10000 | Число миллисекунд, которые система ожидает, прежде чем сбросить буфер потока. | ||||
numberOfProcessingThreads | 5 | Число потоков обработки | ||||
scanRate | 5 | Статус буфера проверяется в соответствии с указанным значением частоты (в миллисекундах). | ||||
sizeThreshold | 1000 | Максимальное число элементов, которое может быть накоплено перед сбросом буфера потока. | ||||
Producer Timeout | 3000 | Эта настройка применяется к процессорам записей потока и в настоящее время действует только для процессора сохраняемых свойств. Если очередь заполнена и в ней нет места для новой записи, это максимальное время (в миллисекундах, в течение которого производитель будет ожидать помещения записи в очередь. Если после превышения времени ожидания очередь все еще заполнена и в ней нет доступного места, запись не будет добавлена в очередь. | ||||
Настройки процессора потоков значений | ||||||
maximumBlockSize | 2500 | Максимальное число операций записи потока значений для обработки в одном блоке. | ||||
maximumQueueSize | 500000 | Максимальное число записей потока значений для постановки в очередь (записи сверх этого числа будут отклонены). | ||||
maximumWaitTime | 10000 | Число миллисекунд, в течение которых система ожидает, прежде чем сбросить буфер потока значений. | ||||
numberofProcessingThreads | 5 | Число потоков обработки | ||||
scanRate | 5 | Время (в миллисекундах) перед сбросом буфера потока. | ||||
sizeThreshold | 1000 | Максимальное число элементов, которое может быть накоплено перед сбросом буфера потока значений. | ||||
Producer Timeout | 3000 | Эта настройка применяется к процессорам записей потока и в настоящее время действует только для процессора сохраняемых свойств. Если очередь заполнена и в ней нет места для новой записи, это максимальное время (в миллисекундах, в течение которого производитель будет ожидать помещения записи в очередь. Если после превышения времени ожидания очередь все еще заполнена и в ней нет доступного места, запись не будет добавлена в очередь. | ||||
PersistentPropertyProcessorSettings | ||||||
maximumBlockSize | 2500 | Максимальное число операций записи свойств в блоке обработки. | ||||
maximumWaitTime | 1000 | Максимальное время ожидания (в миллисекундах) перед сбросом буфера свойств. | ||||
maximumQueueSize | 100000 | Максимальное число записей свойств для постановки в очередь (записи сверх этого числа будут отклонены). | ||||
numberOfProcessingThreads | 20 | Число потоков, которое будет использоваться при обработке свойств. | ||||
scanRate | 25 | Частота (в миллисекундах), с которой необходимо проверять статус буфера. | ||||
sizeThreshold | 1000 | Максимальное число элементов, которое может быть накоплено перед сбросом буфера свойств | ||||
Producer Timeout | 3000 | Эта настройка применяется к процессорам записей потока и в настоящее время действует только для процессора сохраняемых свойств. Если очередь заполнена и в ней нет места для новой записи, это максимальное время (в миллисекундах, в течение которого производитель будет ожидать помещения записи в очередь. Если после превышения времени ожидания очередь все еще заполнена и в ней нет доступного места, запись не будет добавлена в очередь. | ||||
Настройка | По умолчанию | Описание | ||
|---|---|---|---|---|
ConnectionInformation | ||||
acquireIncrement | 5 | Определяет число подключений, которое будет пытаться получить ThingWorx за один раз после исчерпания пула. | ||
acquireRetryAttempts | 3 | Определяет для ThingWorx доступное число попыток получить новое подключение к базе данных. | ||
acquireRetryDelay | 10000 | Время (в миллисекундах), в течение которого ThingWorx будет ожидать между попытками получения подключения. | ||
checkoutTimeout | 1000000 | Число миллисекунд, в течение которых клиент, выполняющий вызов getConnection(), будет ожидать возврата или получения подключения, если пул исчерпан. | ||
driverClass | com.microsoft.sqlserver.jdbc.SQLServerDriver | Полностью определенное имя класса JDBC driverClass - предполагаемого поставщика подключений. | ||
fetchSize | 5000 | Число строк, которые будут выбраны в пакетах вместо кэширования всех строк на стороне клиента. | ||
idleConnectionTestPeriod | 60 | Период времени (в секундах), в течение которого подключения будут тестироваться, а неактивные подключения не смогут быть закрыты из внешних процессов, таких как брандмауэры и т. д. Если это число будет больше 0, ThingWorx будет проверять все неактивные, находящиеся в пуле, но не используемые подключения каждые x секунд.
| ||
initialPoolSize | 5 | Начальное число соединений с базой данных, создаваемых и поддерживаемых в пуле после запуска. Значение должно быть между minPoolSize и maxPoolSize. | ||
jdbcUrl | jdbc:sqlserver://localhost:1433;databaseName=thingworx;applicationName=Thingworx; | URL-адрес JDBC, используемый для подключения к MSSQL. | ||
maxConnectionAge | 0 | Эффективное время жизни, в секундах. Соединения, которые существуют дольше maxConnectionAge, будут разорваны и удалены из пула. | ||
maxIdleTime | 0 | Число секунд, в течение которых подключение может оставаться в пуле без использования, прежде чем оно будет отменено. Ноль означает, что время ожидания для подключений не ограничено. | ||
maxIdleTimeExcessConnections | 300 | Число секунд, в течение которых соединения, превышающие размер пула minPoolSize, могут оставаться в пуле неактивными, прежде чем они будут разорваны. Предназначено для приложений, активно минимизирующих число открытых подключений путем сокращения пула до minPoolSize, если после пика нагрузки ее уровень уменьшается и полученные подключения больше не нужны. Если задано значение maxIdleTime, значение maxIdleTimeExcessConnections должно быть меньше него, чтобы обеспечить нужный эффект. Задание этого значения равным нулю означает отсутствие ограничений, т. е. избыточные соединения не делаются неактивными. | ||
maxPoolSize | 100 | Максимальное количество подключений, которое будет поддерживаться в пуле в любой момент времени. | ||
maxStatements | 100 | Размер глобального кэша PreparedStatement в ThingWorx. | ||
minPoolSize | 5 | Максимальное количество подключений, которое будет поддерживаться в пуле в любой момент времени | ||
numHelperThreads | 8 | Число вспомогательных потоков, которые нужно создать. Медленные операции JDBC обычно выполняются во вспомогательных потоках, которые не содержат конфликтные блокировки. Распределение этих операций по нескольким потокам может значительно повысить производительность благодаря возможности одновременного выполнения нескольких операций. | ||
password | <уникальный пароль> | Пароль для входа в базу данных. | ||
testConnectionOnCheckout | false | Если задано значение true, операция будет выполняться при каждом взятии на изменение подключения, чтобы проверить, что подключение является допустимым. | ||
unreturnedConnectionTimeout | 0 | Число секунд ожидания отклика от неотвечающего подключения перед его удалением. Если задано и если приложение получает подключение, а затем не может вернуть его в указанный период времени, подключение будет удалено из пула. Это позволяет приложениям со случайным нарушением подключения продолжать работать и предотвращает исчерпание через некоторое время пула подключений. Ноль означает отсутствие тайм-аута, то есть приложения сами должны закрывать свои подключения. | ||
username | msadmin | Это идентификатор пользователя, владеющего схемой TWSCHEMA, используемый для аутентификации при соединении с MSSQL в строке соединения JDBC. | ||
Query Timeout | 600000 | Длительность времени ожидания выполнения запроса (в миллисекундах) перед его отменой. | ||
Network Timeout | 900000 | Длительность времени ожидания потоком ответа от базы данных (в миллисекундах). Если ответ не получен за сконфигурированный промежуток времени, платформа закрывает базовое соединение и освобождает поток, ожидающий ответа. | ||
Настройки процессора потоков | ||||
maximumBlockSize | 2500 | Максимальное число операций записи потока в блоке обработки | ||
maximumQueueSize | 250000 | Максимальное число записей потока для постановки в очередь (записи сверх этого числа будут отклонены). | ||
maximumWaitTime | 10000 | Число миллисекунд, которые система ожидает, прежде чем сбросить буфер потока. | ||
numberOfProcessingThreads | 5 | Число потоков обработки | ||
scanRate | 5 | Статус буфера проверяется в соответствии с указанным значением частоты (в миллисекундах). | ||
sizeThreshold | 1000 | Максимальное число элементов, которое может быть накоплено перед сбросом буфера потока. | ||
Producer Timeout | 3000 | Эта настройка применяется к процессорам записей потока и в настоящее время действует только для процессора сохраняемых свойств. Если очередь заполнена и в ней нет места для новой записи, это максимальное время (в миллисекундах, в течение которого производитель будет ожидать помещения записи в очередь. Если после превышения времени ожидания очередь все еще заполнена и в ней нет доступного места, запись не будет добавлена в очередь. | ||
Настройки процессора потоков значений | ||||
maximumBlockSize | 2500 | Максимальное число операций записи потока значений для обработки в одном блоке. | ||
maximumWaitTime | 10000 | Число миллисекунд, в течение которых система ожидает, прежде чем сбросить буфер потока значений. | ||
maximumQueueSize | 500000 | Максимальное число записей потока значений для постановки в очередь (записи сверх этого числа будут отклонены). | ||
numberofProcessingThreads | 5 | Число потоков обработки | ||
scanRate | 5 | Аремя (в миллисекундах) перед сбросом буфера потока. | ||
sizeThreshold | 1000 | Максимальное число элементов, которое может быть накоплено перед сбросом буфера потока значений. | ||
Producer Timeout | 3000 | Эта настройка применяется к процессорам записей потока и в настоящее время действует только для процессора сохраняемых свойств. Если очередь заполнена и в ней нет места для новой записи, это максимальное время (в миллисекундах, в течение которого производитель будет ожидать помещения записи в очередь. Если после превышения времени ожидания очередь все еще заполнена и в ней нет доступного места, запись не будет добавлена в очередь. | ||
PersistentPropertyProcessorSettings | ||||
maximumBlockSize | 2500 | Максимальное число операций записи свойств в блоке обработки. | ||
maximumWaitTime | 1000 | Максимальное время ожидания (в миллисекундах) перед сбросом буфера свойств. | ||
maximumQueueSize | 100000 | Максимальное число записей свойств для постановки в очередь (записи сверх этого числа будут отклонены). | ||
numberOfProcessingThreads | 20 | Число потоков, которое будет использоваться при обработке свойств. | ||
scanRate | 25 | Частота (в миллисекундах), с которой необходимо проверять статус буфера. | ||
sizeThreshold | 1000 | Максимальное число элементов, которое может быть накоплено перед сбросом буфера свойств | ||
Producer Timeout | 3000 | Эта настройка применяется к процессорам записей потока и в настоящее время действует только для процессора сохраняемых свойств. Если очередь заполнена и в ней нет места для новой записи, это максимальное время (в миллисекундах, в течение которого производитель будет ожидать помещения записи в очередь. Если после превышения времени ожидания очередь все еще заполнена и в ней нет доступного места, запись не будет добавлена в очередь. | ||
Настройки кэша
Настройки кэша требуются только при выполнении ThingWorx Platform в кластерном режиме.
 | Если используется режим с одним сервером, исключите настройки кэша из конфигурации. Если они включены в режиме с одним сервером, они будут запускать режим распределенного кэширования с помощью Apache Ignite, который меньше выполняется, чем выполнение кэширования локальной памяти по умолчанию. |
Настройка | По умолчанию | Описание |
|---|---|---|
provider-type | [Поставщик кэша для выполнения в режиме одиночного сервера.] | В режиме кластера всегда должно быть задано значение com.thingworx.cache.ignite.IgniteCacheProvider. |
instance-name | none | Задает имя локального экземпляра кэша. |
client-mode | true | Определяет, будет ли встроенный Ignite выполняться как клиент (по умолчанию) или как сервер. В режиме сервера он участвует в хранении данных и будет использовать больше памяти. |
address-resolver type | static | Определяет, как будут обнаруживаться другие узлы Ignite. Рекомендуется задать значение zookeeper. |
connection | none | Для типа address-resolver type опции zookeeper - это разделенный запятыми список серверов Apache Zookeeper, используемых для координирования выбора ведущего сервера ThingWorx. Строковый шаблон - IP:порт (например, 127.0.0.1:2181, 127.0.0.2:2181). |
endpoints | none | Для типа address-resolver type опции static - массив статических адресов, где выполняется Ignite. |
Добавление раздела событий аудита в platform-settings.json
При перезапуске ThingWorx Platform все вещи инициируют событие ThingStart. При аудите всех этих событий увеличивается время запуска платформы. Во избежание такой ситуации событие ThingStart по умолчанию отключено. Если все еще требуется провести аудит этого действия, можно включать или выключать события в файле platform-settings.json.
Файл platform-settings.json не содержит раздел для аудита. Чтобы включать или отключать категории и сообщения, необходимо добавить структуру JSON в файл. Для экземпляра ThingWorx Platform, для которого требуются сообщения аудита, необходимо быть администратором, имеющим разрешения на поиск и правку файла platform-settings.json и на добавление подходящей конфигурации.
| | Раздел Audit должен быть добавлен как соседний узел в запись JSON в PlatformSettingsConfig. Он может располагаться до или после узла PlatformSettingsConfig, но должен находиться на одном уровне с узлом. |
Ниже приведен пример структуры аудита, размещенной после узла PlatformSettingsConfig в файле 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"
]
}
]
}
В этом примере отключаются категория COLLABORATION и ["ALL"] ее события и сообщения. Для категории AUTHENTICATION отключаются два события и сообщения, LoginSucceeded и ApplicationKeyFailed. Включаются события и сообщения REMOTE_ACCESS и ["ALL"]. Для категории AUTHENTICATION включаются событие и сообщениеLoginFailed. Для THINGGROUPMEMBERSHIPs включаются все сообщения аудита. Вместо использования ["ALL"] эти сообщения перечисляются по отдельности. Может потребоваться выбрать этот метод ввода сообщений аудита, чтобы после некоторого времени выполнения экземпляра платформы можно было определить, нужны ли они все.
Категория audit.AuditCategory.ThingGroupMemberships предоставляет сообщения аудита об изменениях участия в группе вещи. Эта категория сообщений аудита отключена по умолчанию, так как не для всех конфигураций или развертываний требуются такие сообщения аудита, а системным администраторам не требуется брать на себя расчет влияния этих изменений на постоянное сохранение. Если для конфигураций или развертываний требуются сообщения аудита об изменениях участия в группе вещи, можно включить их, как показано в приведенном выше примере. Настройка для каждого сообщения аудита может быть включена или выключена без необходимости включать или отключать другие сообщения аудита. Например, может потребоваться аудит только определенных изменений участия в группе. Сообщения аудита для участия в группах вещей перечислены в таблице Табл. 122 в разделе Сообщения аудита ThingWorx в этом справочном центре.
 | Сообщения аудита для следующих двух типов сообщений всегда включены и не требуют явного включения. Они предоставляют сообщения аудита при включении или выключении функции делегирования разрешений на видимость для групп вещей. com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationEnabled com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationDisabled . |
Чтобы включить или отключить сообщение о категории и аудите, можно скопировать показанную выше структуру и добавить соответствующие ключи в группы "Disabled" и/или "Enabled". Пошаговые инструкции см. в разделе Включение и выключение событий аудита. Чтобы найти подходящие ключи для категорий и сообщений о событиях, см. таблицу Табл. 122 в разделе Сообщения аудита ThingWorx в этом справочном центре.