Updating context roots in an existing network deployment environment

Indicates this functionality was introduced in fixpack 8.0.1.2 You can update the context root of your applications and widgets by adding a prefix.

Before you begin

In this topic, you will see how to update your context roots in 8.0.1.2. First make sure that you have upgraded the existing network deployment environment to 8.0.1.2, as described in the support site.

Procedure

Complete the following steps:

Make sure that all the servers in the environment are stopped, including the deployment manager, the node agents and clusters. Ensure the clusters are stopped in the following order:
1. AppTarget
2. WebApp
3. Support
4. Messaging
For more information, see Stopping a cluster.
Run the BPMConfig command to update the context root of the deployment environment.
Update the online Process Server environments. See Modifying IBM Process Server connection properties.
Start the deployment manager and the node agents, and ensure that a full synchronization takes place. Then start the clusters in the following order:
1. Messaging
2. Support
3. WebApp
4. AppTarget
For more information, see Starting a cluster.

What to do next

Do your process applications use inbound web services, the web API, or the REST API? All URLs exposed by IBM Business Process Manager will contain the newly configured context root, therefore this change will affect client applications that are using the previous context root as an endpoint. Update your client applications to use the new custom context root.

Any previously installed Process Designer needs to be downloaded and installed again as Process Designer must use the new context root configuration.

After you make the configuration changes, start Business Space.

Tip: Clear your browser cache before you start IBM Business Process Manager user interfaces.