ThingWorx 구성 리소스
ThingWorxStorage 폴더의 위치 수정
ThingWorx는 두 개의 최상위 디렉터리 폴더를 사용하여 저장합니다. ThingworxStorage는 모든 활성 정보(데이터, 로그, 확장 등)를 저장하고 ThingworxBackupStorage는 모든 백업 정보를 저장합니다. 기본적으로 ThingWorx는 루트 디렉터리에 이러한 폴더를 생성합니다.
• Microsoft Windows에서 루트 디렉터리는 <drive>:\\입니다. 여기서 <drive>는 Tomcat이 설치된 드라이브입니다.
• Microsoft Windows 이외의 시스템에서 루트 디렉터리는 /입니다.
Tomcat을 시작하기 전에 ThingworxStorage 폴더의 위치를 사용자 정의합니다. 위치를 변경하고 Tomcat을 중지하지 않은 경우 ThingworxStorage 위치를 변경한 후 Tomcat을 재시작합니다.
ThingworxPlatform 폴더에 대한 사용자 정의 위치 지정
1. 이름이 ThingworxPlatform인 디렉터리를 만듭니다.
◦ Microsoft Windows의 경우에는 <드라이브>:\\ThingworxPlatform입니다. 여기서 <드라이브>는 Tomcat이 설치된 드라이브입니다.
◦ Microsoft Windows가 아닌 경우에는 /ThingworxPlatform입니다.
2. THINGWORX_PLATFORM_SETTINGS 환경 변수를 정의하고 값을 새 위치로 설정합니다. 환경 변수는 시스템 수준 환경 변수로 정의되어야 합니다.
예를 들어, THINGWORX_PLATFORM_SETTINGS=/my/custom/path/ThingworxPlatform입니다.
운영 체제 정보:
◦ Ubuntu는 /etc/environment에 시스템 전체 환경 변수를 정의할 것을 권장합니다. 이 파일에서 THINGWORX_PLATFORM_SETTINGS 변수를 정의하고 내보내야 합니다. 예를 들면, export THINGWORX_PLATFORM_SETTINGS=/usr/share/tomcatx/x.x.xx/conf입니다. 여기서 x는 사용 중인 Tomcat 버전입니다.
◦ RHEL의 경우에 한해 tomcat.service 파일 또는 시작 스크립트와 같이 Tomcat 서비스에서 액세스할 수 있는 THINGWORX_PLATFORM_SETTINGS 변수를 정의합니다.
◦ Windows의 경우 시스템 환경 변수 또는 Windows 서비스의 일부로 정의합니다.
ThingWorxStorage의 사용자 정의 위치 지정
파일 시스템에서 ThingWorxStorage의 위치를 수정하려면 ThingworxPlatform 폴더의 platform-settings.json 파일에 정의된 위치를 업데이트합니다.
 |
이러한 구성을 변경하면 이미 실행 중인 Tomcat를 다시 시작해야 합니다.
|
형식 예
JSON 구성 파일의 위치를 정의한 후 위에 지정된 위치에 platform-settings.json 파일을 생성합니다. 다음 예의 형식을 사용하여 ThingworxStorage 및 ThingworxBackupStorage 폴더의 위치를 수정합니다. 이 예에서는 모든 항목이 /ThingworxStorage라는 하나의 루트 디렉터리 아래에 있습니다.
이 파일의 각 설정은 선택 사항입니다. 이 파일에 설정이 지정되지 않으면 ThingWorx는 런타임에 하드코딩된 값을 기본값으로 사용합니다.
|
설정
|
DESCRIPTION
|
DEFAULT
|
||||
|---|---|---|---|---|---|---|
|
코어 플랫폼 설정
|
||||||
|
BackupStorage
|
백업 저장소 디렉터리가 생성/배치되는 디렉터리입니다.
|
/ThingworxBackupStorage
|
||||
|
DatabaseLogRetentionPolicy
|
데이터베이스 로그를 보관할 기간(일)입니다. ThingWorx 지원 담당자의 지시가 없는 한 이 설정을 수정하지 마십시오.
|
7
|
||||
|
EnableBackup
|
백업을 사용할 수 있는지 여부를 제어합니다.
|
True
|
||||
|
EnableHA
|
HA(고가용성) 환경에 맞게 플랫폼을 구성할지 여부를 결정합니다.
|
False
|
||||
|
EnableSystemLogging
|
시스템 로깅이 활성화되었는지 여부를 제어합니다.
|
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=="
}
}
}
"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=="
}
}
}