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 | ThingWorx Platform에 대해 SSO를 활성화하려면 true로 설정합니다. SSO를 활성화하면 모든 인증이 sso-settings.json 파일에 구성된 중앙 승인 서버로 리디렉션됩니다. Edge WebSocket 인증은 영향을 받지 않습니다. | ||||
FileRepositoryRoot | /ThingworxStorage | 루트 파일 저장소가 생성되는 디렉터리입니다. 독립형 배포의 경우 기본 위치로 충분합니다. ThingWorx HA 배포의 경우 저장소는 모든 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 Platform에서 스크립트를 종료하기 전에 스크립트가 실행될 수 있는 최대 시간입니다.
| ||||
MaxSearchItems | 100000 | 사용자가 기본 검색 제한을 환경에 있는 엔티티 수에 따라 늘릴 수 있습니다. ThingWorx Composer에서 SearchFunctions 리소스 그룹 API가 설정한 MaxSearchItems는 platform-settings.json에 설정된 값보다 우선합니다. MaxSearchItems가 100k 초과로 설정된 경우 사용 사례에 따라 적절한 검색 조건을 전달하여 필요한 엔티티 수를 가져오기 위해 검색 시간을 줄입니다.
|
도메인 구성 설정
설정 | 기본값 | 설명 | ||
|---|---|---|---|---|
ignoreTrustedDomains | true | 이 플래그를 true로 설정하면 미디어 엔티티를 통한 모든 외부 HTTP 호출이 허용됩니다. false로 설정하면 trustedDomains 아래에 나열된 도메인에 대한 HTTP 호출만 허용됩니다. | ||
trustedDomains | 해당 없음 | 사용자가 미디어 엔티티 객체를 통해 매쉬업의 미디어에 액세스하는 데 사용할 수 있는 검증되고 신뢰할 수 있는 도메인의 목록입니다.
|
Solution Central 설정
설정 | 기본값 | 설명 | ||
|---|---|---|---|---|
SolutionCentralHost | sc.thingworx.com | Solution Central 호스트 이름 | ||
SolutionCentralPort | 443 | Solution Central 포트 세부 정보.
| ||
KeyStorePath | /ThingworxPlatform/sc-keystore | 키 저장소 경로 | ||
KeyStorePass | 없음 | 키 저장소 암호
|
ThingWorx Flow 설정
이러한 속성은 ThingWorx Flow를 ThingWorx Foundation에 설치한 경우에만 적용됩니다. 이러한 값은 ThingWorx Flow와 RabbitMQ 구성 파일 모두에서 정의해야 하며, 두 응용 프로그램 모두에서 변경하지 않는 한 편집해서는 안 됩니다.
설정 | 기본값 | 설명 | ||
|---|---|---|---|---|
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 - 매니페스트에 있는 JS 유형의 JavaScript UI 파일 리소스를 JavaScript 리소스로 선언하는 확장을 가져올 수 있습니다. • "allowJavascriptResources": false - 매니페스트에 있는 JS 유형의 JavaScript UI 파일 리소스를 JavaScript 리소스로 선언하는 확장을 가져올 수 없습니다. | ||||
allowCSSResources | CSS 리소스 포함 확장을 가져올 수 있습니다. | false | • "allowCSSResources": true - CSS UI 파일 리소스를 포함하는 확장을 가져올 수 있습니다. • "allowCSSResources": false - CSS UI 파일 리소스를 포함하는 확장을 가져올 수 없습니다. | ||||
allowJSONResources | JSON 리소스(예: 로컬리제이션 파일) 포함 확장을 가져올 수 있습니다. | false | • "allowJSONResources": true - JSON UI 파일 리소스를 포함하는 확장을 가져올 수 있습니다. • "allowJSONResources": false - JSON UI 파일 리소스를 포함하는 확장을 가져올 수 없습니다. | ||||
allowWebAppResources | 웹 리소스 포함 확장을 가져올 수 있습니다. | false | • "allowWebAppResources": true - WebApp UI 파일 리소스를 포함하는 확장을 가져올 수 있습니다. • "allowWebAppResources": false - WebApp UI 파일 리소스를 포함하는 확장을 가져올 수 없습니다. | ||||
allowEntities | 확장 불가능 엔티티 포함 확장을 가져올 수 있습니다. 확장 불가능 엔티티의 예는 다음과 같습니다. • 응용 프로그램 키 • 인증자 • 대시보드 • 데이터 분석 정의 • 데이터 셰이프 • GenericContentEntity 및 파생된 하위 클래스(예: 상태 정의, 스타일 정의, 스타일 테마) • 그룹 • 로컬리제이션 테이블 • 로그 • 매쉬업 • 미디어 엔티티 • 메뉴 • 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 | 없음 | 클러스터의 각 노드에 대한 고유 식별자입니다. 이 ID는 집계 로그에 표시됩니다. 이는 영숫자여야 하며 32자 미만이어야 합니다. "^[a-zA-Z0-9]{1,32}$" 패턴과 일치해야 합니다. |
CoordinatorHosts | 없음 | ThingWorx 리더 선택을 조정하는 데 사용되는 Apache ZooKeeper 서버를 쉼표로 구분한 목록입니다. 문자열 패턴은 IP:포트입니다. (예: "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가 ThingWorx 리더십을 조정하는 데 사용되는 Apache ZooKeeper 서비스에서 "하트비트"를 수신하지 않고 대기하는 시간(밀리초)입니다. |
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 | 실질적인 TTL(지속 시간)이며, 단위는 초입니다. maxConnectionAge보다 오래된 연결은 풀에서 파기 및 제거됩니다. | ||
maxIdleTime | 0 | 취소되기 전에 연결이 풀링을 유지하지만 사용되지 않는 시간(초)입니다. 0은 유휴 연결이 만료되지 않음을 의미합니다. | ||
maxIdleTimeExcessConnections | 36000 | minPoolSize를 초과하는 연결을 골라내기 전에 풀에서 유휴 상태로 유지될 수 있는 시간(초)입니다. 열려 있는 연결의 수를 적극적으로 최소화하려는 응용 프로그램을 위한 것으로, 스파이크 다음에 로드 수준이 약해지고 취득한 연결이 더 이상 필요하지 않은 경우 풀을 minPoolSize로 축소합니다. maxIdleTime이 설정되면 maxIdleTimeExcessConnections가 더 작아야 효과가 나타납니다. 이 값을 0으로 설정하면 적용되지 않으며 초과 연결이 유휴 상태가 되지 않습니다. | ||
maxPoolSize | 100 | 지정된 기간에 풀이 유지할 연결의 최대 수입니다. | ||
maxStatements | 0 | ThingWorx 글로벌 PreparedStatement 캐시의 크기입니다. | ||
maxStatementsPerConnection | 50 | 각 연결에 대한 ThingWorx 글로벌 PreparedStatement 캐시의 크기입니다. | ||
minPoolSize | 5 | 지정된 기간에 풀이 유지할 연결의 최소 수입니다. | ||
numHelperThreads | 6 | 생성할 도우미 스레드 수입니다. 느린 JDBC 작업은 일반적으로 경합 잠금을 보유하지 않은 도우미 스레드에 의해 수행됩니다. 이러한 작업을 여러 스레드로 분배하면 여러 작업을 동시에 수행할 수 있어 성능이 매우 향상될 수 있습니다. | ||
password | 해당 없음 | 데이터베이스 암호입니다. | ||
username | twadmin | 데이터베이스 사용자 이름입니다. | ||
tableLockTimeout | 10000 | 데이터베이스 테이블이 잠금 해제될 때까지 클라이언트가 대기할 시간(밀리초)입니다. | ||
testConnectionOnCheckout | false | true인 경우 연결이 유효한지 확인하기 위해 연결이 체크 아웃될 때마다 작업이 수행됩니다. | ||
unreturnedConnectionTimeout | 0 | 응답하지 않는 연결로부터 취소하기 전 응답을 대기하는 시간(초)입니다. 설정되면 응용 프로그램이 체크 아웃하지만 지정된 시간 내에 연결을 체크 인하지 못한 경우 풀에서 연결이 취소됩니다. 이를 통해 결과적으로 연결 풀을 소진하지 않으면서 가끔 연결 누수가 있는 응용 프로그램이 존속할 수 있습니다. 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 | PostgreSQL에 연결하는 데 사용된 JDBC URL입니다.
| ||||
maxConnectionAge | 0 | 실질적인 TTL(지속 시간)이며, 단위는 초입니다. maxConnectionAge보다 오래된 연결은 풀에서 파기 및 제거됩니다. | ||||
maxIdleTime | 0 | 취소되기 전에 연결이 풀링을 유지하지만 사용되지 않는 시간(초)입니다. 0은 유휴 연결이 만료되지 않음을 의미합니다. | ||||
maxIdleTimeExcessConnections | 300 | minPoolSize를 초과하는 연결을 골라내기 전에 풀에서 유휴 상태로 유지될 수 있는 시간(초)입니다. 열려 있는 연결의 수를 적극적으로 최소화하려는 응용 프로그램을 위한 것으로, 스파이크 다음에 로드 수준이 약해지고 취득한 연결이 더 이상 필요하지 않은 경우 풀을 minPoolSize로 축소합니다. maxIdleTime이 설정되면 maxIdleTimeExcessConnections가 더 작아야 효과가 나타납니다. 이 값을 0으로 설정하면 적용되지 않으며 초과 연결이 유휴 상태가 되지 않습니다. | ||||
maxPoolSize | 100 | 지정된 기간에 풀이 유지할 연결의 최대 수입니다. | ||||
maxStatements | 100 | ThingWorx 글로벌 PreparedStatement 캐시의 크기입니다. | ||||
minPoolSize | 5 | 지정된 기간에 풀이 유지할 연결의 최소 수입니다. | ||||
numHelperThreads | 8 | 생성할 도우미 스레드 수입니다. 느린 JDBC 작업은 일반적으로 경합 잠금을 보유하지 않은 도우미 스레드에 의해 수행됩니다. 이러한 작업을 여러 스레드로 분배하면 여러 작업을 동시에 수행할 수 있어 성능이 매우 향상될 수 있습니다. | ||||
password | <고유한 암호> | 데이터베이스에 로그인하는 데 사용된 암호입니다. | ||||
testConnectionOnCheckout | false | true인 경우 연결이 유효한지 확인하기 위해 연결이 체크 아웃될 때마다 작업이 수행됩니다. | ||||
unreturnedConnectionTimeout | 0 | 응답하지 않는 연결로부터 취소하기 전 응답을 대기하는 시간(초)입니다. 설정되면 응용 프로그램이 체크 아웃하지만 지정된 시간 내에 연결을 체크 인하지 못한 경우 풀에서 연결이 취소됩니다. 이를 통해 결과적으로 연결 풀을 소진하지 않으면서 가끔 연결 누수가 있는 응용 프로그램이 존속할 수 있습니다. 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; | MSSQL에 연결하는 데 사용된 JDBC URL입니다. | ||
maxConnectionAge | 0 | 실질적인 TTL(지속 시간)이며, 단위는 초입니다. maxConnectionAge보다 오래된 연결은 풀에서 파기 및 제거됩니다. | ||
maxIdleTime | 0 | 취소되기 전에 연결이 풀링을 유지하지만 사용되지 않는 시간(초)입니다. 0은 유휴 연결이 만료되지 않음을 의미합니다. | ||
maxIdleTimeExcessConnections | 300 | minPoolSize를 초과하는 연결을 골라내기 전에 풀에서 유휴 상태로 유지될 수 있는 시간(초)입니다. 열려 있는 연결의 수를 적극적으로 최소화하려는 응용 프로그램을 위한 것으로, 스파이크 다음에 로드 수준이 약해지고 취득한 연결이 더 이상 필요하지 않은 경우 풀을 minPoolSize로 축소합니다. maxIdleTime이 설정되면 maxIdleTimeExcessConnections가 더 작아야 효과가 나타납니다. 이 값을 0으로 설정하면 적용되지 않으며 초과 연결이 유휴 상태가 되지 않습니다. | ||
maxPoolSize | 100 | 지정된 기간에 풀이 유지할 연결의 최대 수입니다. | ||
maxStatements | 100 | ThingWorx 글로벌 PreparedStatement 캐시의 크기입니다. | ||
minPoolSize | 5 | 지정된 기간에 풀이 유지할 연결의 최소 수입니다. | ||
numHelperThreads | 8 | 생성할 도우미 스레드 수입니다. 느린 JDBC 작업은 일반적으로 경합 잠금을 보유하지 않은 도우미 스레드에 의해 수행됩니다. 이러한 작업을 여러 스레드로 분배하면 여러 작업을 동시에 수행할 수 있어 성능이 매우 향상될 수 있습니다. | ||
password | <고유한 암호> | 데이터베이스에 로그인하기 위한 암호입니다. | ||
testConnectionOnCheckout | false | true인 경우 연결이 유효한지 확인하기 위해 연결이 체크 아웃될 때마다 작업이 수행됩니다. | ||
unreturnedConnectionTimeout | 0 | 응답하지 않는 연결로부터 취소하기 전 응답을 대기하는 시간(초)입니다. 설정되면 응용 프로그램이 체크 아웃하지만 지정된 시간 내에 연결을 체크 인하지 못한 경우 풀에서 연결이 취소됩니다. 이를 통해 결과적으로 연결 풀을 소진하지 않으면서 가끔 연결 누수가 있는 응용 프로그램이 존속할 수 있습니다. 0은 제한 시간이 없음을 의미하며, 응용 프로그램에서는 자체의 연결을 종료합니다. | ||
username | msadmin | TWSCHEMA 스키마를 소유하고 JDBC 연결 문자열의 MSSQL을 인증하는 데 사용되는 사용자 ID입니다. | ||
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 | 없음 | 캐시의 로컬 인스턴스 이름을 설정합니다. |
client-mode | true | 포함된 Ignite를 클라이언트로 실행할지(기본값) 아니면 서버로 실행할지 여부를 결정합니다. 서버 모드에서는 이 클라이언트가 데이터 저장에 참여하며 더 많은 메모리를 사용합니다. |
address-resolver type | static | 다른 Ignite 노드를 검색하는 방법을 결정합니다. 권장 설정은 zookeeper입니다. |
connection | 없음 | address-resolver type이 zookeeper인 경우 ThingWorx 리더 선택을 조정하기 위해 쉼표로 구분된 Apache ZooKeeper 서버 목록이 사용됩니다. 문자열 패턴은 IP:포트(예, 127.0.0.1:2181, 127.0.0.2:2181)입니다. |
endpoints | 없음 | address-resolver type이 static인 경우 Ignite가 실행되는 정적 주소의 배열입니다. |
platform-settings.json에 감사된 이벤트 섹션 추가
ThingWorx Platform을 재시작하면 모든 사물이 ThingStart 이벤트를 트리거합니다. 이러한 이벤트를 모두 감사하면 플랫폼 시작 시간이 늘어납니다. 이러한 상황을 방지하기 위해 ThingStart 이벤트는 기본적으로 비활성화되어 있습니다. 그럼에도 여전히 이 작업을 감사하고 싶은 경우 platform-settings.json 파일에서 이벤트를 활성화한 후 다시 비활성화하면 됩니다.
platform-settings.json 파일에 Audit에 대한 섹션은 포함되어 있지 않습니다. 카테고리 및 메시지를 활성화하거나 비활성화하려면 파일에 JSON 구조를 추가해야 합니다. 감사 메시지를 설정할 ThingWorx Platform 인스턴스의 platform-settins.json 파일을 찾아서 편집하고 적절한 구성을 추가할 수 있는 권한을 가진 관리자여야 합니다.
| | Audit 섹션은 PlatformSettingsConfig의 JSON 엔트리에 등위 노드로 추가해야 합니다. PlatformSettingsConfig 노드의 앞이나 뒤에 있을 수 있지만 동일한 노드 수준에 있어야 합니다. |
다음은 platform-settings.json 파일의 PlatformSettingsConfig 노드 뒤에 오는 Audit 구조의 예입니다.
"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 카테고리는 사물 그룹의 멤버 자격 변경에 대한 감사 메시지를 제공합니다. 모든 구성/배포에 이러한 감사 메시지가 필요하거나 시스템 관리자가 해당 변경 사항에 대한 계산 및 지속성 영향을 원하는 것은 아니므로 이 카테고리의 감사 메시지는 비활성화되어 있습니다. 구성/배포에 사물 그룹 멤버 자격 변경에 대한 감사 메시지가 필요한 경우 감사 메시지를 위 예와 같이 활성화할 수 있습니다. 다른 감사 메시지를 활성화하거나 비활성화하지 않고도 각 감사 메시지에 대한 설정을 활성화하거나 비활성화할 수 있습니다. 예를 들어, 특정 멤버 자격 변경 사항만 감사할 수 있습니다. 사물 그룹 멤버 자격을 위한 감사 메시지는 이 도움말 센터의 ThingWorx 감사 메시지 항목의 표 122 테이블에 나와 있습니다.
 | 다음 두 메시지 유형에 대한 감사 메시지는 항상 활성화되어 있으므로 명시적 활성화가 필요하지 않습니다. 사물 그룹에 대한 표시 유형 사용 권한 위임 기능을 활성화하거나 비활성화하면 감사 메시지를 제공합니다. com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationEnabled com.thingworx.thinggroups.ThingGroup.VisibilityPermissionDelegationDisabled . |
카테고리 및 감사 메시지를 활성화하거나 비활성화하려면 위에 표시된 구조를 복사하고 "Disabled" 및/또는 "Enabled" 그룹에 적절한 키를 추가합니다. 단계별 절차는 감사 이벤트 활성화 및 비활성화 항목을 참조하십시오. 카테고리 및 이벤트 메시지에 대한 적절한 키를 찾으려면 이 도움말 센터의 ThingWorx 감사 메시지 항목에 나오는 표 122 표를 참조하십시오.