Restarting the Active Workspace gateway and microservices

When you make changes to the configuration files for the Active Workspace gateway and microservices, you must restart them for your changes to be recognized. Make sure the FMS server cache (FSC) service is running before you start the Active Workspace gateway. Windows On Windows, all of the gateway and microservices on a given machine are managed by a single multi-threaded Windows service. To implement your configuration changes, restart the service using the Services control panel: Or from the command line: Copy net stop "Teamcenter Process Manager" && net start "Teamcenter Process Manager" Caution You must use Microsoft Services to start the service. Do not run the service script directly. Linux On Linux, the gateway and microservices are manged by Docker. Remove and recreate the gateway services and config. The other services will restart in turn. Locate the gateway service and remove it. Copy TC_ROOT/container> docker service ls | grep gateway wfvrc598nkbz config1_MS_STACK_gateway replicated 1/1 localhost:5000/teamcenter/afx-gateway:1.9.0 TC_ROOT/container> docker service rm wfvrc598nkbz wfvrc598nkbz TC_ROOT/container> Locate the config.json config and remove it. Copy TC_ROOT/container> docker config ls | grep config.json e9ldu5xqhhwsya7t4i22skr9u config1_MS_STACK_config.json TC_ROOT/container> docker config rm e9ldu5xqhhwsya7t4i22skr9u e9ldu5xqhhwsya7t4i22skr9u TC_ROOT/container> Deploy the gateway.yml Compose file. Copy TC_ROOT/container> docker stack deploy -c gateway.yml config1_MS_STACK Creating config config1_MS_STACK_config.json Creating service config1_MS_STACK_gateway TC_ROOT/container> Start up race conditions It is recommended to start the gateway after any graphQL services have had a chance to stabilize. The gateway will make several attempts before giving up, but in some cases this will not be enough. You can adjust the number of attempts made in the gateway's config.json file. Each attempt is 15 seconds. Copy "graphql": { "endpoints": [ "darsi", "tcgql" ], "attempts": 5 }, This problem is more prevalent on Linux and Docker and especially if all of your gateway services are installed on the same machine.