설치 및 구성 > ThingWorx 구성 리소스
ThingWorx 구성 리소스
ThingWorxStorage 폴더의 위치 수정
ThingWorx는 두 개의 최상위 디렉터리 폴더를 사용하여 저장합니다. ThingworxStorage는 모든 활성 정보(데이터, 로그, 확장 등)를 저장하고 ThingworxBackupStorage는 모든 백업 정보를 저장합니다. 기본적으로 ThingWorx는 루트 디렉터리에 이러한 폴더를 생성합니다.
• Microsoft Windows에서 루트 디렉터리는 <drive>:\\입니다. 여기서 <drive>는 Tomcat이 설치된 드라이브입니다.
• Microsoft Windows 이외의 시스템에서 루트 디렉터리는 /입니다.
Tomcat을 시작하기 전에 ThingworxStorage 폴더의 위치를 사용자 정의합니다. 위치를 변경하고 Tomcat을 중지하지 않은 경우 ThingworxStorage 위치를 변경한 후 Tomcat을 재시작합니다.
.
ThingWorxStorage의 사용자 정의 위치 지정
파일 시스템에서 ThingWorxStorage의 위치를 수정하려면 저장소 위치를 지정하는 JSON 구성 파일의 위치를 가리킵니다. 다음 두 가지 방법 중 하나를 수행할 수 있습니다.
1. ThingworxPlatform이라는 루트 디렉터리를 생성합니다.
◦ Microsoft Windows에서 루트 디렉터리는 <drive>:\\ThingworxPlatform입니다. 여기서 <drive>는 Tomcat이 설치된 드라이브입니다.
◦ Microsoft Windows가 아닌 경우에는 /ThingworxPlatform입니다.
또는
2. 환경 변수를 시스템 변수(사용자 아님)로 정의합니다. 환경 변수는 경로여야 합니다. platform-settings.json을 포함하지 마십시오.
◦ %THINGWORX_PLATFORM_SETTINGS% (Microsoft Windows)
◦ JSON 구성 파일의 위치를 가리키는 $THINGWORX_PLATFORM_SETTINGS(비 Microsoft Windows)
* 
Ubuntu는 /etc/environment에 시스템 전체 환경 변수를 정의할 것을 권장합니다. 이 파일에서 THINGWORX_PLATFORM_SETTINGS 변수를 정의하고 내보내야 합니다. 예를 들면, export THINGWORX_PLATFORM_SETTINGS=/usr/share/tomcatx/x.x.xx/conf입니다. 여기서 x는 사용 중인 Tomcat 버전입니다.
3. RHEL의 경우에 한해, tomcat.service 파일 또는 시작 스크립트와 같이 Tomcat 서비스에서 액세스할 수 있는 THINGWORX_PLATFORM_SETTINGS 변수를 정의합니다.
* 
시스템 서비스는 호출 사용자 및 해당 세션에서 컨텍스트(예: HOME 및 PATH 환경 변수)를 상속하지 않습니다. 각 서비스는 정리된 실행 컨텍스트에서 실행됩니다.
형식 예
JSON 구성 파일의 위치를 정의한 후 위에 지정된 위치에 platform-settings.json 파일을 생성합니다. 다음 예의 형식을 사용하여 ThingworxStorage 및 ThingworxBackupStorage 폴더의 위치를 수정합니다. 이 예에서는 모든 항목이 /ThingworxStorage라는 하나의 루트 디렉터리 아래에 있습니다.
이 파일의 각 설정은 선택 사항입니다. 이 파일에 설정이 지정되지 않으면 ThingWorx는 런타임에 하드코딩된 값을 기본값으로 사용합니다.
설정
DESCRIPTION
DEFAULT
코어 플랫폼 설정
BackupStorage
백업 저장소 디렉터리가 생성/배치되는 디렉터리입니다.
/ThingworxBackupStorage
DatabaseLogRetentionPolicy
데이터베이스 로그를 보관할 기간(일)입니다. ThingWorx 지원 담당자의 지시가 없는 한 이 설정을 수정하지 마십시오.
7
EnableBackup
백업을 사용할 수 있는지 여부를 제어합니다.
True
EnableHA
HA(고가용성) 환경에 맞게 플랫폼을 구성할지 여부를 결정합니다.
False
EnableSystemLogging
시스템 로깅이 활성화되었는지 여부를 제어합니다.
* 
ThingWorx 지원에서 그렇게 하도록 안내한 경우에만 사용하십시오.
False
HTTPRequestHeaderMaxLength
HTTP 요청 머리글 값의 최대 허용 길이입니다.
2000
HTTPRequestParameterMaxLength
HTTP 요청 매개 변수 값의 최대 허용 길이입니다.
2000
저장소
모든 저장소 디렉터리가 생성/배치되는 디렉터리(백업 저장소 제외)입니다.
ThingworxStorage
HA 설정
HA(고가용성) 환경 구성과 관련된 설정입니다. 선택 사항이며 EnableHA 설정(위)이 false로 설정된 경우 무시됩니다.
CoordinatorConnectionTimeout
플랫폼 리더십을 조정하는 데 사용되는 프로세스/서버와의 연결을 대기하는 데 걸리는 시간(밀리초)입니다.
15000
CoordinatorHosts
플랫폼 리더십을 조정하는 데 사용되는 프로세스가 있는 서버 IP 주소의 쉼표로 구분된 목록(예: "127.0.0.1:2181, 127.0.0.2:2181")입니다.
127.0.0.1:2181
CoordinatorMaxRetries
플랫폼 리더십을 조정하는 데 사용되는 프로세스/서버와의 연결을 설정하기 위한 최대 재시도 횟수입니다.
3
CoordinatorRetryTimeout
각 재시도를 대기하는 데 걸리는 시간(밀리초)입니다.
1000
CoordinatorSessionTimeout
플랫폼의 세션이 플랫폼 리더십을 조정하는 데 사용되는 프로세스/서버로부터 하트비트를 받지 않고 대기하는 시간(밀리초)입니다.
60000
LoadBalancerBase64EncodedCredentials
"<user>:<password>" 형식이며 HA 부하 분산에 대한 Base64 인코딩 자격 증명입니다.
PersistenceProviderPackageConfigs
데이터베이스 옵션에 따라 다릅니다.
가능한 모든 구성에 대해서는 지속성 공급자를 참조하십시오.
비 Windows용 스크립트 예
다음을 유효한 JSON 파일에 복사할 때 불필요한 서식 문자를 붙여넣지 마십시오.

{
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "/home/johndoe/Developer/thingworx/platform/backup",
"DatabaseLogRetentionPolicy": 7,
"EnableBackup": true,
"EnableHA": false,
"EnableSystemLogging": false,
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"Storage": "/home/johndoe/Developer/thingworx/platform/storage"
},
"HASettings": {
"CoordinatorConnectionTimeout": 15000,
"CoordinatorHosts": "127.0.0.1:2181",
"CoordinatorMaxRetries": 3,
"CoordinatorRetryTimeout": 1000,
"CoordinatorSessionTimeout": 60000,
"LoadBalancerBase64EncodedCredentials": "QWRtbW4pc1RyYXRvajphZG1pbg=="
}
}
}
Windows용 스크립트 예
{
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "C:\\Users\\John Doe\\Developer\\thingworx\\platform\\backup",
"DatabaseLogRetentionPolicy": 7,
"EnableBackup": true,
"EnableHA": false,
"EnableSystemLogging": false,
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"Storage": "C:\\Users\\John Doe\\Developer\\thingworx\\platform\\storage"
},

"HASettings": {
"CoordinatorConnectionTimeout": 15000,
"CoordinatorHosts": "127.0.0.1:2181",
"CoordinatorMaxRetries": 3,
"CoordinatorRetryTimeout": 1000,
"CoordinatorSessionTimeout": 60000,
"LoadBalancerBase64EncodedCredentials": "QWRtbW4pc1RyYXRvajphZG1pbg=="
}
}
}