Configure Property Transform Settings in ThingWorx
Update the platform-settings.json File
If you opted to install the Property Transform component of Platform Analytics, the platform-settings.json file for the ThingWorx server must be updated. Specifically, a section must be added to identify the location of the RabbitMQ server. Whether you have chosen to install the RabbitMQ instance provided with the installer, or you are using an existing, external instance, the ThingWorx settings must be updated with the RabbitMQ parameters.
1. Open the terminal window as root user.
2. Navigate to the /ThingworxPlatform/platform-settings.json file and open it.
3. Add the following parameters to the PlatformSettingsConfig section, substituting actual values in the angled brackets:
{
"PlatformSettingsConfig": {
...
"PropertyTransformSettings": {
"EnablePropertyTransform": true,
"QueueHost": "<rabbitmq IP address>",
"QueuePort": <port number>,
"QueueUsername": "<rabbitmq user name>",
"QueuePassword": "encrypt.propertytransform.password",
"QueueVHost": "/"
}
}
}
Encrypt the RabbitMQ Password
Before you can encrypt a password in ThingWorx, follow the steps below to download the Security Management Tool and configure it. For detailed information about this tool and its features, see Security Management Tool in the ThingWorx Help Center.
1. Obtain the Security Management Tool zip file from the PTC Support site.
2. Extract the contents of the zip file to a directory.
3. Open a terminal window as the root user.
4. Create a configuration file similar to the example file below and place it in the bin folder of the unzipped Security Management Tool.
Example keystore.conf file:
{
security {
secret-provider = "com.thingworx.security.provider.keystore.KeyStoreProvider"
default-encryption-key-length = 128
keystore {
password-file-path = "/ThingworxPlatform"
password-file-name = "keystore-password"
path = "/ThingworxStorage"
name = "keystore.jks"
}
}
}
security {
secret-provider = "com.thingworx.security.provider.keystore.KeyStoreProvider"
default-encryption-key-length = 128
keystore {
password-file-path = "/ThingworxPlatform"
password-file-name = "keystore-password"
path = "/ThingworxStorage"
name = "keystore.jks"
}
}
}
 |
If ThingWorx is installed on a Windows server, adjust the keystore file paths as shown below.
keystore {
password-file-path = "C:\\ThingworxPlatform" password-file-name = "keystore-password" path = "C:\\ThingworxStorage" name = "keystore.jks" |
5. Run the following command:
./security-common-cli keystore.conf set encrypt.propertytransform.password "<RabbitMQ password>"
|
|
When encrypting the RabbitMQ password for the first time, you must use the password created at installation.
|
6. Restart ThingWorx.