IBM Support

Mapping the BPMHelp module with IBM HTTP Server does not work for the IBM Business Process Manager (BPM) products

Troubleshooting


Problem

You cannot map the BPMHelp.war module with IBM HTTP Server. As a result, the BPMHelp.war module is broken when you use a web server URL.

Symptom

When you attempt to map the module to the web server using the administrative console, you encounter the following error message:

ADMA0014E: Validation failed. ADMA0010E: A Validation error occurred in task Selecting virtual hosts for Web modules. A virtual host is not specified for Web module BPM Help with URI BPMHelp.war,WEB-INF/web.xml.

Resolving The Problem

To resolve this issue, verify whether the ibm-web-bnd.xmi file is missing in the deployment manager profile. If it is missing, complete the following steps using the administrative console:

    1. Click Applications > Application Types > WebSphere enterprise applications.

    2. Click IBM_BPM_Help<node name>_<cluster name> where the <node name > and <cluster name> values are specific to your environment.

    3. Under Web Module Properties, click Virtual hosts.

    4. Ensure that a virtual host is set to the default_host value.

    5. Without making any changes, click OK.

    6. Save the changes in the administrative console.

      These steps produce the ibm-web-bnd.xmi file.

If the previous steps do not resolve this issue, complete the following steps:
  1. Open the HTTPServer\conf\httpd.conf file.

  2. Look for the WebSpherePluginConfig entry and note the associated value.
    For example, the WebSpherePluginConfig value might be:
    WebSpherePluginConfig
    "C:\Program Files (x86)\IBM\WebspherewebserverPlugins\config\webserver1\plugin-cfg.xml"

  3. Open the plugin-cfg.xml file from the previous step.

  4. Locate the child elements for UriGroup.

  5. Determine whether /BPMHelp/* is mentioned in one of the child elements.


    See the following code as an example of the UriGroup child elements:
    <UriGroupName="default_host_server1_nodename1_Cluster_URIs">
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/BusinessSpace/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/BSpaceWebformsProxy/*" />
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/snoop/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"    
         Name="/hello"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/hitcount"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="*.jsp"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="*.jsv"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="*.jsw"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/j_security_check"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/ibm_security_logout"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/servlet/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/FileNet/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/fncmis/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
        Name="/PerformanceAdmin/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/portal/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/ProcessPortal/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/ProcessAdmin/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/bpm/notification/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/ProcessCenter/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/teamworks/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
        Name="/teamworks/webservices/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/teamworks.legacy/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/eventmgr/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/bpm/repo/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/rest/bpm/wle/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/rest/bpm/wle/*.jsp"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
             Name="/rest/bpm/wle/*.jsv"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
        Name="/rest/bpm/wle/*.jsw"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
        Name="/rest/bpm/wle/j_security_check"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
        Name="/rest/bpm/wle/ibm_security_logout"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
        Name="/rest/bpm/wle/servlet/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/bpm/fds/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/bpm/fds/*.jsp"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/bpm/fds/*.jsv"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/bpm/fds/*.jsw"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
        Name="/bpm/fds/j_security_check"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
        Name="/bpm/fds/ibm_security_logout"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/bpm/fds/servlet/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/bpmrest-ui/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/WebViewer/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/bpmasset/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/webapi/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/bpmjaxws/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/PageBuilder2/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/rest/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/rest/*.jsp"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/rest/*.jsv"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/rest/*.jsw"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
        Name="/rest/j_security_check"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
        Name="/rest/ibm_security_logout"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/producer/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/ivt/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
        Name="/mum/widgetsandbox"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/mum/config"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/mum/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/mum/proxy/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
        Name="/mum/demos/loaddemo.jsp"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/mum/*.jsp"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/mum/*.jsv"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/mum/*.jsw"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
        Name="/mum/j_security_check"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
        Name="/mum/ibm_security_logout"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/mum/servlet/*"/>
      <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"
         Name="/widgets/*"/>
          <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"  
         Name="/BPMHelp/*"/>
    </UriGroup>

  6. If the /BPMHelp/* module is missing, add the following code:
    <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid"  
         Name="/BPMHelp/*"/>

  7. Restart the HTTP server.

  8. Try the scenario again.

[{"Product":{"code":"SSFTN5","label":"IBM Business Process Manager Advanced"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation \/ Configuration","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"},{"code":"PF035","label":"z\/OS"}],"Version":"8.5;8.0.1;8.0;7.5.1;7.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSFTDH","label":"IBM Business Process Manager Standard"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation \/ Configuration","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"","label":"Linux zSeries"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.5;8.0.1;8.0;7.5.1;7.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSFTBX","label":"IBM Business Process Manager Express"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation \/ Configuration","Platform":[{"code":"PF016","label":"Linux"},{"code":"","label":"Linux zSeries"},{"code":"PF033","label":"Windows"}],"Version":"8.5;8.0.1;8.0;7.5.1;7.5","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

BPM

Document Information

Modified date:
15 June 2018

UID

swg21643203

Page Feedback