安装和配置 > 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)
◦ $THINGWORX_PLATFORM_SETTINGS (非 Microsoft Windows)，指向 JSON 配置文件位置
* 
Ubuntu 建议在 /etc/environment 中定义系统范围的环境变量。在此文件中，您必须定义并导出 THINGWORX_PLATFORM_SETTINGS 变量。例如，导出 THINGWORX_PLATFORM_SETTINGS=/usr/share/tomcatx/x.x.xx/conf，其中 x 是您正在使用的 Tomcat 的版本。
3. 仅对于 RHEL，定义 Tomcat 服务可在其中访问它的 THINGWORX_PLATFORM_SETTINGS 变量，如 tomcat.service 文件或启动脚本。
* 
系统服务不会从调用用户及其会话中继承任何上下文 (如 HOME 和 PATH 环境变量)。每个服务均在一个清空的执行上下文中运行。
格式示例
定义完 JSON 配置文件的位置后，在上述指定位置创建一个 platform-settings.json 文件。使用以下示例中的格式修改 ThingworxStorage 和 ThingworxBackupStorage 文件夹的位置。在该示例中，所有内容都包含在一个名为 /ThingworxStorage 的根目录下。
此文件中的每个设置均是可选的。如果未在此文件中指定设置，则 ThingWorx 将在运行时默认为硬编码值。
设置
说明
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
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=="
}
}
}