BPMConfig command-line utility

Indicates this functionality was introduced in fixpack 8.0.1.2 This command configures a custom context root for a deployment environment. The custom context root that you specify applies across the deployment environment.

Purpose

Use the BPMConfig command to configure a custom context root for a deployment environment. Before you run the command, create the deployment environment and stop all running servers. Run the command from the <install_root>\bin directory in the Windows environment.

Restriction: The BPMConfig command can be used only for deployment environments that have been created using a supported method, such as the deployment environment wizard, the configNode command, or a BPM admin command (for example, the $AdminTask createDeploymentEnvDef command).

Parameters

-update: A required parameter to update the deployment environment.
-profile deployment_manager_profile_name: A required parameter that identifies the deployment manager profile.
-de deployment_environment_name: A required parameter that identifies the deployment environment name.
-contextRootPrefix prefix: A required parameter that specifies the custom context root prefix you want. The prefix value requires a leading forward slash (/). It is added to the beginning of the default context root. The prefix should contain only letters, numbers, or the underline character. Other characters are invalid.

Note: If you see a window requesting you to log in a second time when you create a context root prefix, try these changes to fix the problem. Are you using Lightweight Third Party Authentication (LTPA) security? A log in is requested because you have multiple cells sharing the same IBM HTTP Server (IHS) without sharing the LTPA keys. Share the LTPA keys. Another reason for this problem is a limitation that users can access only one cell on the same IHS. If a user wants to access another cell on the same IHS, it can be done through another browser; that is, use one browser per cell.

Example of configuring a custom context root

The following example shows you how to configure a custom context root for a deployment environment in the Windows environment. Before you run the command, create the deployment environment and stop all running servers.

BPMConfig has a .bat type in a Windows environment and a .sh type in a Linux environment. Running the command updates the deployment environment that has a deployment manager profile name of mydeploymentmgrprofilename and a deployment environment name of mydeploymentenvname. The custom context root URL that is added to the beginning of the default context root is mycorporation.

<install_root>\bin\BPMConfig -update -profile mydeploymentmgrprofilename -de mydeploymentenvname -contextRootPrefix /mycorporation