설치 및 구성 > ThingWorx 설치 > 설치 부록 > platform-settings.json 구성 세부 정보
platform-settings.json 구성 세부 정보
platform-settings.json 파일은 관리자가 미세 조정하기 위해 설정을 조정하는 데 사용할 수 있으며 소프트웨어 다운로드에서 제공됩니다.
* 
아래의 샘플에는 모든 옵션이 포함되어 있습니다. 지속성 공급자는 하나만 필요합니다.
{
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "/ThingworxBackupStorage",
"DatabaseLogRetentionPolicy": 7,
"EnableBackup": true,
"EnableHA": false,
"EnableSystemLogging": false,
"EnableSSO": false,
"FileRepositoryRoot": "/ThingworxStorage",
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"InternalAesCryptographicKeyLength": 128,
"Storage": "/ThingworxStorage",
"ScriptTimeout": 30
},
"SolutionCentralSettings": {
"SolutionCentralHost": "<Solution Central host name>",
"KeyStorePath": "<Path for your keystore>",
"KeyStorePass": "<Password for your keystore>"
},
"AdministratorUserSettings": {
"InitialPassword": "changeme"
},
"ContentTypeSettings": {
"supportedMediaEntityContentTypes" : ["image/svg+xml","image/png","image/gif","image/bmp","image/jpeg","application/pdf","image/vnd.microsoft.icon"]
},
"OrchestrationSettings": {
"EnableOrchestration": true,
"QueueHost": "localhost",
"QueuePort": 5672,
"QueueName": "256mb",
"QueueUsername": "flowuser",
"QueuePassword": "encrypt.queue.password",
"QueueVHost": "orchestration"
},
"ExtensionPackageImportPolicy": {
"importEnabled": false,
"allowJarResources": false,
"allowJavascriptResources": false,
"allowCSSResources": false,
"allowJSONResources": false,
"allowWebAppResources": false,
"allowEntities": false,
"allowExtensibleEntities": false
},
"HASettings": {
"CoordinatorConnectionTimeout": 15000,
"CoordinatorHosts": "127.0.0.1:2181",
"CoordinatorMaxRetries": 3,
"CoordinatorRetryTimeout": 1000,
"CoordinatorSessionTimeout": 90000,
"CoordinatorZNode": "/HALeadershipCoordinator",
"LoadBalancerBase64EncodedCredentials": "QWRtaW5pc3RyYXRvcjphZG1pbg=="
},
"LicensingConnectionSettings": {
"username": "<username>",
"password": "<password>",
"timeout":"60",
"useProxy": false,
"proxyHost": "<proxyHost>",
"proxyPort" : "<proxy port>",
"proxyScheme": "<http or https>",
"proxyUseNTLM": true,
"proxyUsername": "<user>",
"proxyPassword": "<user password>",
"proxyWorkstation": "<dummyWorkstation>",
"proxyDomain": "<dummyDomain>"
}
},
"PersistenceProviderPackageConfigs": {
"NeoPersistenceProviderPackage": {
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"scanRate": 5,
"sizeThreshold": 1000
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 500000,
"maximumWaitTime": 10000,
"scanRate": 5,
"sizeThreshold": 1000
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
}
},
"H2PersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 30,
"acquireRetryDelay": 1000,
"checkoutTimeout": 2000,
"idleConnectionTestPeriod": 6,
"initialPoolSize": 10,
"maxConnectionAge": 0,
"maxIdleTime": 0,
"maxIdleTimeExcessConnections": 36000,
"maxPoolSize": 100,
"maxStatements": 0,
"maxStatementsPerConnection": 50,
"minPoolSize": 10,
"numHelperThreads": 6,
"password": "password",
"tableLockTimeout": 10000,
"testConnectionOnCheckout": false,
"unreturnedConnectionTimeout": 0,
"username": "twadmin"
},
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 10000,
"maximumQueueSize": 500000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
}
},
"PostgresPersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 3,
"acquireRetryDelay": 10000,
"checkoutTimeout": 1000000,
"driverClass": "org.postgresql.Driver",
"fetchSize": 5000,
"idleConnectionTestPeriod": 60,
"initialPoolSize": 5,
"jdbcUrl": "jdbc:postgresql://localhost:5432/thingworx",
"maxConnectionAge": 0,
"maxIdleTime": 0,
"maxIdleTimeExcessConnections": 300,
"maxPoolSize": 100,
"maxStatements": 100,
"minPoolSize": 5,
"numHelperThreads": 8,
"password": "password",
"testConnectionOnCheckout": false,
"unreturnedConnectionTimeout": 0,
"username": "twadmin"
},
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 500000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
}
},
"MssqlPersistenceProviderPackage": {
"ConnectionInformation": {
"acquireIncrement": 5,
"acquireRetryAttempts": 3,
"acquireRetryDelay": 10000,
"checkoutTimeout": 1000000,
"driverClass": "com.microsoft.sqlserver.jdbc.SQLServerDriver",
"fetchSize": 5000,
"idleConnectionTestPeriod": 60,
"initialPoolSize": 5,
"jdbcUrl": "jdbc:sqlserver://localhost:1433;databaseName=thingworx;applicationName=Thingworx;",
"maxConnectionAge": 0,
"maxIdleTime": 0,
"maxIdleTimeExcessConnections": 300,
"maxPoolSize": 100,
"maxStatements": 100,
"minPoolSize": 5,
"numHelperThreads": 8,
"password": "Password@123",
"testConnectionOnCheckout": false,
"unreturnedConnectionTimeout": 0,
"username": "msadmin"
},
"StreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumQueueSize": 250000,
"maximumWaitTime": 10000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"ValueStreamProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 10000,
"maximumQueueSize": 500000,
"numberOfProcessingThreads": 5,
"scanRate": 5,
"sizeThreshold": 1000
},
"PersistentPropertyProcessorSettings": {
"maximumBlockSize": 2500,
"maximumWaitTime": 1000,
"maximumQueueSize": 100000,
"numberOfProcessingThreads": 20,
"scanRate": 25,
"sizeThreshold": 1000
}
}
}
}
platform-settings.json 옵션
아래 나열된 모든 데이터베이스의 경우 가치 스트림 프로세서 설정 및 스트림 프로세서 설정에 대해 다음 지침을 따라야 합니다.
StreamProcessorSettings.numberOfProcessingThreads + ValueStreamProcessorSettings.numberOfProcessingThreads < 50% of DB connection pool
And
ValueStreamProcessorSettings.numberOfProcessingThreads >= StreamProcessorSettings.numberOfProcessingThreads
기본 설정
설정
기본값
설명
BackupStorage
/ThingworxBackupStorage
모든 백업이 작성되는 디렉터리 이름입니다.
DatabaseLogRetentionPolicy
7
데이터베이스 로그가 유지되는 일 수입니다.
EnableBackup
true
백업을 유지할지 여부를 결정합니다.
EnableHA
false
고가용성 환경을 위한 ThingWorx를 구성할 수 있는지 여부를 결정합니다.
EnableSystemLogging
false
시스템 로깅을 활성화할지 여부를 결정합니다.
* 
ThingWorx 지원 담당자의 지시가 없는 한 이 기능을 사용하지 마십시오.
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입니다.
* 
키 길이가 128보다 더 길고 Java 정책이 해당 키 크기를 사용하도록 구성되지 않은 경우 암호 및 암호 해독이 실패합니다.
Storage
/ThingworxStorage
모든 스토리지 디렉터리가 생성/배치되는 디렉터리입니다(백업 스토리지 제외).
ScriptTimeout
30
ThingWorx Platform에서 스크립트를 종료하기 전에 스크립트가 실행될 수 있는 최대 시간입니다.
* 
스크립트가 이 제한 시간에 대해 구성된 시간(초)보다 오래 실행되면 플랫폼에서 스크립트가 자동으로 종료됩니다.
* 
제한 시간 구성 시 스크립트가 처리하는 정보의 민감도 및/또는 중요도를 고려하십시오. 보안을 위해 일정 시간이 지나면 스크립트를 종료하는 것이 중요하지만 조기에 스크립트를 종료하면 데이터가 손실될 수 있습니다. ThingWorx Platform의 유연성으로 인해 기본 제한 시간보다 짧거나 긴 제한 시간이 필요한 사용 사례가 있습니다.
Solution Central 설정
설정
기본값
설명
SolutionCentralHost
sc.thingworx.com
Solution Central 호스트 이름
SolutionCentralPort
443
Solution Central 포트 세부 정보.
* 
기본값이 있는 경우 SolutionCentralPort를 설정하지 마십시오.
KeyStorePath
/ThingworxPlatform/sc-keystore
키 저장소 경로
KeyStorePass
없음
키 저장소 암호
* 
암호를 암호화하는 경우 KeyStorePassencrypt.sc.password로 설정하십시오.
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 대기열 암호
* 
ThingWorx Flow를 ThingWorx Foundation과 동일한 시스템에 설치한 경우 암호가 자동으로 암호화됩니다.
ThingWorx Flow를 ThingWorx Foundation과 다른 시스템에 설치한 경우 이 암호를 암호화해야 합니다.
QueueVHost
orchestration
RabbitMQ VHost 이름
확장 패키지 가져오기 정책
확장 가져오기는 모든 사용자에 대해 기본적으로 비활성화됩니다. 다음 설정을 사용하여 확장 가져오기 기능을 구성할 수 있습니다. 자세한 내용은 확장 가져오기를 참조하십시오.
설정
설명
기본값
importEnabled
확장 가져오기(=true) 또는 확장 가져오지 않음(=false)을 나타내는 최상위 수준의 제어입니다.
false
"importEnabled": false - 다른 ExtensionPackageImportPolicy 설정이 true로 설정되어도 확장을 가져올 수 없습니다.
"importEnabled": true - 확장 가져오기를 다음 allow<Content>Resources 설정 세트로 전달합니다(아래 행 참조).
* 
allow<Content>Resources 설정이 false이면 빈 확장(엔티티 없음, 확장 가능 엔티티 또는 리소스)을 가져올 수 있습니다. 이 구성이 유용하지 않을 가능성이 있으므로 importEnabled가 true로 설정되면 하나 이상의 다른 allow<Content>Resources 설정도 true로 설정되어야 합니다.
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)와 유사한 리소스로 사용되는 사용자 정의 함수/서비스를 포함하는 파생된 하위 클래스
* 
확장의 일부가 아닌 OOTB 하위 시스템은 영향을 받지 않습니다.
ScriptFunctionLibrary 및 파생된 하위 클래스
하위 시스템 및 파생된 하위 클래스
* 
확장의 일부가 아닌 OOTB 하위 시스템은 영향을 받지 않습니다.
사물 패키지
위젯
false
"allowExtensibleEntities": true - 매니페스트에 있는 확장 가능 엔티티를 선언하는 확장을 가져올 수 있습니다.
"allowExtensibleEntities": false - 매니페스트에 있는 확장 가능 엔티티를 선언하는 확장을 가져올 수 없습니다.
HA 설정
PostgreSQL HA 환경 구성과 관련된 설정입니다. 위의 EnableHA 설정이 false로 설정되면 모든 설정이 무시됩니다. CoordinatorHostsLoadBalancerBase64EncodedCredentials는 환경에 맞게 수정되어야 합니다.
설정
기본값
설명
CoordinatorConnectionTimeout
15000
ThingWorx 리더십을 조정하는 데 사용되는 Apache ZooKeeper 서비스와의 연결이 설정될 때까지 대기하는 시간(밀리초)입니다.
CoordinatorHosts
127.0.0.1:2181
ThingWorx 리더 선택을 조정하는 데 사용되는 Apache ZooKeeper 서버를 쉼표로 구분한 목록입니다. 문자열 패턴은 IP:포트입니다. (예: "127.0.0.1:2181, 127.0.0.2:2181")
CoordinatorMaxRetries
3
ThingWorx 리더십을 조정하는 데 사용되는 Apache ZooKeeper 서비스와의 연결을 설정하기 위해 허용되는 최대 재시도 횟수입니다.
CoordinatorRetryTimeout
1000
각 재시도를 대기하는 데 걸리는 시간(밀리초)입니다.
CoordinatorSessionTimeout
90000
ThingWorx가 ThingWorx 리더십을 조정하는 데 사용되는 Apache ZooKeeper 서비스에서 "하트비트"를 수신하지 않고 대기하는 시간(밀리초)입니다.
CoordinatorZNode
/HALeadershipCoordinator
Apache ZooKeeper 서비스 하나가 여러 ThingWorx HA 배포에 의해 공유되는 경우 이 설정은 각 ThingWorx HA 배포에 대해 고유한 값을 제공해야 합니다. 이 설정의 값은 임의로 지정할 수 있지만 /<anyTextHere> 형식을 따라야 합니다. 예를 들어, ThingWorx 인스턴스 TWX1 및 TWX2는 HA 시스템 A에 있고 ThingWorx 인스턴스 TWX3 및 TWX4는 HA 시스템 B에 있습니다. CoordinatorZNode는 TWX1 및 TWX2의 경우 /HAsystemA로 설정되고 TWX3 및 TWX4의 경우 /HAsystemB로 설정됩니다.
LoadBalancerBase64EncodedCredentials
QWRtaW5pc3RyYXRvcjphZG1pbg==
<사용자>:<고유한 암호> 형식의 HA 부하 분산에 대한 Base64 인코딩 자격 증명입니다.
* 
ThingWorx 사용자를 사용하지 마십시오.
* 
부하 분산 설정에서 사용된 <user>:<unique password> 문자열과 일치하며 Base64 형식으로 인코딩된 모든 유틸리티를 사용할 수 있습니다.
관리자 사용자 설정
설정
기본값
설명
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 인증이 필요한 경우 사용자 도메인의 이름입니다.
NeoPersistenceProviderPackage
Neo4j 관련 지속성 공급자 설정을 포함합니다. Neo4j가 지속성 공급자가 아닌 경우 이 단원 전체를 무시하십시오.
설정
기본값
설명
StreamProcessorSettings
maximumBlockSize
2500
블록 하나에서 처리할 스트림 쓰기 최대 수입니다.
maximumQueueSize
250000
대기할 스트림 엔트리의 최대 수입니다(그 이후 거부됨).
maximumWaitTime
10000
스트림 버퍼를 플러시하기 전 최대 대기 시간(밀리초)입니다.
scanRate
5
버퍼 상태를 확인하는 속도(밀리초)입니다.
sizeThreshold
1000
스트림 버퍼를 플러시하기 전 누적되는 최대 항목 수입니다.
ValueStreamProcessorSettings
maximumBlockSize
2500
블록 하나에서 처리할 스트림 쓰기 최대 수입니다.
maximumQueueSize
500000
대기할 스트림 엔트리의 최대 수입니다(그 이후 거부됨).
maximumWaitTime
10000
스트림 버퍼를 플러시하기 전 최대 대기 시간(밀리초)입니다.
scanRate
5
버퍼 상태를 확인하는 속도(밀리초)입니다.
sizeThreshold
1000
스트림 버퍼를 플러시하기 전 누적되는 최대 항목 수입니다.
PersistentPropertyProcessorSettings
maximumBlockSize
2500
블록 하나에서 처리할 속성 쓰기 최대 수입니다.
maximumWaitTime
1000
속성 버퍼를 플러시하기 전 최대 대기 시간(밀리초)입니다.
maximumQueueSize
100000
대기할 속성 엔트리의 최대 수입니다(그 이후 거부됨).
numberOfProcessingThreads
20
속성을 처리할 때 사용할 스레드 수입니다.
scanRate
25
버퍼 상태를 확인하는 속도(밀리초)입니다.
sizeThreshold
1000
속성 버퍼를 플러시하기 전 누적되는 최대 항목 수입니다.
H2PersistenceProviderPackage
설정
기본값
설명
연결 정보
acquireIncrement
5
풀이 소진될 때 ThingWorx가 취득하려고 한 번에 시도하는 연결의 수를 결정합니다.
acquireRetryAttempts
30
ThingWorx가 포기하기 전에 데이터베이스에서 새 연결을 취득하려고 시도하는 횟수를 정의합니다.
acquireRetryDelay
1000
취득 시도 간 ThingWorx가 대기하는 시간(밀리초)입니다.
checkoutTimeout
1000000
풀이 소진될 때 getConnection()을 호출하는 클라이언트가 연결을 체크 인 또는 취득할 때까지 대기하는 시간(밀리초)입니다.
idleConnectionTestPeriod
6
유휴 연결이 방화벽 등의 외부 프로세스에서 끊기지 않도록 연결을 테스트하는 시간(초)입니다. 이 값이 0보다 큰 경우 ThingWorx는 풀링되었지만 체크 아웃하지 않은 모든 유휴 연결을 x초마다 테스트합니다.
* 
"모델 공급자에 대한 연결 없음" 오류가 발생하면 이 설정을 검토하십시오. 방화벽 기본값을 비교해 보십시오. 기본값을 낮게 설정하면 연결 끊김 문제가 완화됩니다.
initialPoolSize
10
시작 시 풀 내에서 생성되고 유지되는 초기 데이터베이스 연결의 수입니다. 이 값은 minPoolSizemaxPoolSize 사이여야 합니다.
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
스트림 버퍼를 플러시하기 전 누적되는 최대 항목 수입니다.
ValueStreamProcessorSettings
maximumBlockSize
2500
블록 하나에서 처리할 스트림 쓰기 최대 수입니다.
maximumQueueSize
250000
대기할 스트림 엔트리의 최대 수입니다(그 이후 거부됨).
maximumWaitTime
10000
스트림 버퍼를 플러시하기 전 최대 대기 시간(밀리초)입니다.
numberOfProcessingThreads
5
속성을 처리할 때 사용할 스레드 수입니다.
scanRate
5
버퍼 상태를 확인하는 속도(밀리초)입니다.
sizeThreshold
1000
스트림 버퍼를 플러시하기 전 누적되는 최대 항목 수입니다.
PersistentPropertyProcessorSettings
maximumBlockSize
2500
블록 하나에서 처리할 속성 쓰기 최대 수입니다.
maximumWaitTime
1000
속성 버퍼를 플러시하기 전 최대 대기 시간(밀리초)입니다.
maximumQueueSize
100000
대기할 속성 엔트리의 최대 수입니다(그 이후 거부됨).
numberOfProcessingThreads
20
속성을 처리할 때 사용할 스레드 수입니다.
scanRate
25
버퍼 상태를 확인하는 속도(밀리초)입니다.
sizeThreshold
1000
속성 버퍼를 플러시하기 전 누적되는 최대 항목 수입니다.
PostgresPersistenceProviderPackage
설정
기본값
설명
ConnectionInformation
acquireIncrement
5
풀이 소진될 때 플랫폼이 취득하려고 한 번에 시도하는 연결의 수를 결정합니다.
acquireRetryAttempts
3
ThingWorx가 포기하기 전에 데이터베이스에서 새 연결을 취득하려고 시도하는 횟수를 정의합니다.
acquireRetryDelay
10000
취득 시도 간 ThingWorx가 대기하는 시간(밀리초)입니다.
checkoutTimeout
10000000
풀이 소진될 때 getConnection()을 호출하는 클라이언트가 연결을 체크 인 또는 취득할 때까지 대기하는 시간(밀리초)입니다.
driverClass
org.postgresql.Driver
연결을 제공할 것으로 예상되는 JDBC driverClass의 전체 클래스 이름입니다.
fetchSize
5000
클라이언트 측에서 모든 행을 캐시하는 대신 일괄적으로 가져올 행의 수입니다.
idleConnectionTestPeriod
60
이 값이 0보다 큰 경우 ThingWorx는 풀링되었지만 체크 아웃하지 않은 모든 유휴 연결을 x초마다 테스트합니다.
initialPoolSize
5
시작 시 풀 내에서 생성되고 유지되는 초기 데이터베이스 연결의 수입니다. 이 값은 minPoolSizemaxPoolSize 사이여야 합니다.
jdbcUrl
jdbc:postgresql://localhost:5432/thingworx
PostgreSQL에 연결하는 데 사용된 JDBC URL입니다.
* 
기본 스키마 이름이 공용에서 변경된 경우 <데이터베이스 이름>?currentSchema=<스키마의 이름>를 추가해야 합니다. 예를 들어, 스키마 이름이 mySchema인 경우 다음과 같이 됩니다. jdbc:postgresql://<DBServer>:<DBPort>/<databasename>?currentSchema=mySchema
* 
HA 솔루션을 구성하는 경우 pgPool 프로세스가 실행되는 서버 IP를 반영해야 합니다. 포트를 pgPool이 사용되는 포트로 변경하십시오.
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 서버에 대한 데이터베이스에서 생성된 사용자입니다.
* 
PostgreSQL 암호를 변경하려면 이 사용자의 암호를 변경하고 platform-settings.json 파일의 암호화되지 않은 암호 설정 또는 /ThingworxStorage/keystore.jks 키 저장소의 암호화된 값도 변경합니다.
스트림 프로세서 설정
maximumBlockSize
2500
블록 하나에서 처리할 스트림 쓰기 최대 수입니다.
maximumQueueSize
250000
대기할 스트림 엔트리의 최대 수입니다(그 이후 거부됨).
maximumWaitTime
10000
스트림 버퍼를 플러시하기 전에 시스템이 대기하는 시간(밀리초)입니다.
numberOfProcessingThreads
5
처리 스레드 수입니다.
scanRate
5
지정된 속도 값(밀리초)에서 버퍼 상태를 확인합니다.
sizeThreshold
1000
스트림 버퍼를 플러시하기 전 누적되는 최대 항목 수입니다.
가치 스트림 프로세서 설정
maximumBlockSize
2500
블록 하나에서 프로세스에 쓰는 가치 스트림의 최대 수입니다.
maximumQueueSize
500000
대기할 가치 스트림 엔트리의 최대 수입니다(그 이후 거부됨).
maximumWaitTime
10000
가치 스트림 버퍼를 플러시하기 전에 시스템이 대기하는 시간(밀리초)입니다.
numberofProcessingThreads
5
처리 스레드 수입니다.
scanRate
5
스트림 버퍼를 플러시하기 전 속도(밀리초)입니다.
sizeThreshold
1000
가치 스트림 버퍼를 플러시하기 전 누적되는 최대 항목 수입니다.
PersistentPropertyProcessorSettings
maximumBlockSize
2500
블록 하나에서 처리할 속성 쓰기 최대 수입니다.
maximumWaitTime
1000
속성 버퍼를 플러시하기 전 최대 대기 시간(밀리초)입니다.
maximumQueueSize
100000
대기할 속성 엔트리의 최대 수입니다(그 이후 거부됨).
numberOfProcessingThreads
20
속성을 처리할 때 사용할 스레드 수입니다.
scanRate
25
버퍼 상태를 확인하는 속도(밀리초)입니다.
sizeThreshold
1000
속성 버퍼를 플러시하기 전 누적되는 최대 항목 수입니다.
MssqlPersistenceProviderPackage
설정
기본값
설명
ConnectionInformation
acquireIncrement
5
풀이 소진될 때 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
시작 시 풀 내에서 생성되고 유지되는 초기 데이터베이스 연결의 수입니다. 이 값은 minPoolSizemaxPoolSize 사이여야 합니다.
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입니다.
스트림 프로세서 설정
maximumBlockSize
2500
블록 하나에서 처리할 스트림 쓰기 최대 수입니다.
maximumQueueSize
250000
대기할 스트림 엔트리의 최대 수입니다(그 이후 거부됨).
maximumWaitTime
10000
스트림 버퍼를 플러시하기 전에 시스템이 대기하는 시간(밀리초)입니다.
numberOfProcessingThreads
5
처리 스레드 수입니다.
scanRate
5
지정된 속도 값(밀리초)에서 버퍼 상태를 확인합니다.
sizeThreshold
1000
스트림 버퍼를 플러시하기 전 누적되는 최대 항목 수입니다.
가치 스트림 프로세서 설정
maximumBlockSize
2500
블록 하나에서 프로세스에 쓰는 가치 스트림의 최대 수입니다.
maximumWaitTime
10000
가치 스트림 버퍼를 플러시하기 전에 시스템이 대기하는 시간(밀리초)입니다.
maximumQueueSize
500000
대기할 가치 스트림 엔트리의 최대 수입니다(그 이후 거부됨).
numberofProcessingThreads
5
처리 스레드 수입니다.
scanRate
5
스트림 버퍼를 플러시하기 전 속도(밀리초)입니다.
sizeThreshold
1000
가치 스트림 버퍼를 플러시하기 전 누적되는 최대 항목 수입니다.
PersistentPropertyProcessorSettings
maximumBlockSize
2500
블록 하나에서 처리할 속성 쓰기 최대 수입니다.
maximumWaitTime
1000
속성 버퍼를 플러시하기 전 최대 대기 시간(밀리초)입니다.
maximumQueueSize
100000
대기할 속성 엔트리의 최대 수입니다(그 이후 거부됨).
numberOfProcessingThreads
20
속성을 처리할 때 사용할 스레드 수입니다.
scanRate
25
버퍼 상태를 확인하는 속도(밀리초)입니다.
sizeThreshold
1000
속성 버퍼를 플러시하기 전 누적되는 최대 항목 수입니다.