Skip to main content
17-Peridot
March 6, 2020

How to change hostname for Thingworx Flow after installation (Windows only)

  • March 6, 2020
  • 1 reply
  • 2274 views

Hi,

 

If you need to change the used hostname at installation of Thingworx Flow, some manual changes should be done without re-installing Flow.

Basically, hostname for Flow should be changed in the nginx configuration and in Flow modules configuration; whenever you see the hostname used at Flow installation, change it with the new hostname.

 

Change the following configurations after renaming the ThingWorx Flow server in Windows OS :

1. Stop Flow, Nginx and ThingWorx Tomcat services
2. Update C:\Program Files\ <nginx>\conf\conf.d\vhost-flow.conf
server_name : change hostname with new one

    

3. Update C:\Program Files (x86)\ <ThingWorxFlow>\modules\lookup\deploymentConfig.json
ENDPOINT : change hostname with new one

    

4. Update <ThingWorxFlow>\modules\oauth\deploymentConfig.json
UI_ENDPOINT : change hostname with new one
ENDPOINT : change hostname with new one

    

5. Update <ThingWorxFlow>\modules\trigger\deploymentConfig.json
DOMAIN : change hostname with new one
TRIGGER_HOST : change hostname with new one

6. Update <ThingWorxFlow>\modules\ux\deploymentConfig.json
api_endpoint : change hostname with new one
view > oauth_server : change hostname with new one
service_api_endpoint : change hostname with new one

    

If the ThingWorx Platform is installed on the Flow server :
enterprise > built > host prefix_url : change hostname with new one

7. If the ThingWorx Platform is not installed on the Flow server:
  1. Stop Thingworx Tomcat service
  2. Update <ThingworxPlatform>\platform-settings.json
        PlatformSettingsConfig >  OrchestrationSettings > QueueHost : change flow hostname with new one

8. Restart the Thingworx, Flow and Nginx services
 
After these steps, Flow should be accessible with the new hostname:
https://new_hostname:port/Thingworx/Composer/apps/flow/
 
 
Regards,
Raluca Edu
 
 

1 reply

17-Peridot
March 16, 2020

Thank you for the article.

 

It's always good to have such information at hand, because, as is often the case, all of a sudden, someone wants you to have it done yesterday.

 

One more thought regarding this... I couldn't find a similar article in the Knowledge Base. Don't really care, but as a matter of form, I believe it would be a good idea to have one there.

17-Peridot
March 16, 2020

Hi,

 

Thanks for your message, here is an article on this subject: https://www.ptc.com/en/support/article/CS317502

 

Hope it helps,

Raluca Edu