Troubleshooting Your Installation
You can use log files to troubleshoot your installation. The log files are saved to the following locations:
ThingWorx Flow installation or upgrade logs
<ThingWorx_Flow_Install_Location>\installer\logs\
ThingWorx Flow running logs
<ThingWorx_Flow_Install_Location>\.pm2\logs\
RabbitMQ logs
Windows: <ThingWorx_Flow_Install_Location>\modules\RabbitMQ\log
Linux: /var/log/rabbitmq
NGinx logs
Windows: C:\Program Files\nginx-<version>\logs
Linux: /var/log/nginx
ThingWorx Foundation logs
<ThingWorx_Foundation_Install_Location>\ThingworxStorage\logs\
Abort or failure logs
<system_temp_directory>/ThingWorxFlow_Failed_installs/
Example: /tmp/ThingWorxFlow_Failed_installs/
Uninstall logs
<system_temp_directory>/bitrock_installer_<pid>.log
The log file name has prefix bitrock.
Example: /tmp/bitrock_installer_3008.log
Scenario
Resolution
To validate ThingWorx Flow connectivity
If the ThingWorx Flow server URL is not accessible or returns an error code 502 or 504
If the ThingWorx Foundation host is not accessible from the ThingWorx Flow virtual machine
1. Navigate to the RabbitMQ log files under the <ThingWorx_Flow_Install_Location>\modules\RabbitMQ\log folder.
2. Open the log file and check if the following line is available in the log file:
user 'flowuser' authenticated and granted access to vhost 'orchestration'
3. If the line is not available, do the following:
Check the firewall connection on the ThingWorx Foundation virtual machine.
Ensure that the RabbitMQ port is accessible on both hosts.
Check if ThingWorx Foundation and ThingWorx Flow hosts can reach each other using the DNS name or the host name.
If flow execution in the engine stops abruptly
Review your software before you make any changes:
Set the ephemeral ports for services on your operating system between 5000 and 65535.
For information about ephemeral ports and its range, see The Ephemeral Port Range.
Reduce TIME_WAIT on sockets to 30 seconds.
If you have updated the password of the ThingWorx Flow database administrator
You must update the same password in ThingWorx Flow. To do so, complete the steps in Updating the ThingWorx Flow Database Administrator Password.
If you want to update the RabbitMQ password
If the password of the user that ran the ThingWorx Flow installer changed
You must restart ThingWorx Flow. To do so, complete the following steps:
Windows
1. Stop the ThingWorx-Flow service.
2. Right-click the ThingWorxFlow installation folder, and provide all permissions to the NETWORK SERVICE group.
3. In Windows Services, right-click the ThingWorx-Flow service, and select Properties. Select the Log On tab, and for the Network Service account, update the password.
4. Start the ThingWorx-Flow service.
5. If the ThingWorx-Foundation service uses the same user, then repeat the same procedure.
Linux
1. Restart the ThingWorx-Flow service.
2. If the ThingWorx-Foundation service uses the same user, then restart the ThingWorx-Foundation service.
If you are unable to run ThingWorx Flow in case ThingWorx Analytics was installed before ThingWorx Flow
This may be caused as RabbitMQ services for both, ThingWorx Analytics and ThingWorx Flow, are listening to the same default port. If this is the case, you must reconfigure RabbitMQ port for ThingWorx Flow to listen to other port than default port.
Was this helpful?