IBM Support

The Process Portal for the IBM Business Process Manager (BPM) products does not render properly when using Load Balancer

Technote (troubleshooting)


When you enable Load Balancer or specify "localhost" as the host name during IBM Business Process Manager server installation, the Process Portal user interface does not have any Cascading Style Sheet (CSS) styling.


Symptom #1 :

You see a screen that is similar to the following screen when you log into IBM Business Process Manager Process Portal:

Symptom #2 :

If you monitor HTTP traffic in your browser, you notice that the portal application tries to load a CSS file from a host other than where you have Process Server or Process Center installed :

For example: http://localhost:9081/portal/skins/Leapfrog/application.css


There are a couple of known causes for this issue:

  • You did not customize any IBM Business Process Manager configuration files after enabling the load balancer.
  • You installed IBM Business Process Manager with "localhost" as the host name.


This issue can occur with an IBM Business Process Manager product in a stand-alone or a clustered environment.

Resolving the problem

To resolve the problem, complete the following steps:

  1. Shut down all the Java™ virtual machines (JVMs) that are associated with the problematic environment.

  2. Locate the 100Custom.xml file under your config directory.

    Sample paths:
    • Stand-alone environment:

    • Clustered environment:

  3. Edit the 100Custom.xml file.

    Note: For Process Center environments, omit the <teamworks-webapp-prefix> code as it causes problems in the authoring environment.

    Add following lines to the existing file between the <properties> and </properties> tags. Replace the host name and port values with your environment specific values before adding the code to the XML file. For example: http://NODE1:9081/portal
    <common merge="mergeChildren">
    <portal-prefix merge="replace">http://hostname:port/portal</portal-prefix>
    <process-admin-prefix merge="replace">https://hostname:port/ProcessAdmin
    <teamworks-webapp-prefix merge="replace">https://hostname:port/teamworks
    <server merge="mergeChildren">
    <email merge="mergeChildren">
    <mail-template merge="mergeChildren">
    <client-link merge="replace">https://hostname:port/teamworks

    Note: You need to modify the 100Custom.xml file on every Process Center Process Server cluster member configuration in a clustered environment. Editing XML files in a deployment manager profile configuration is sufficient. You do not need edit this file on node machines. Changes are pushed to the node machine when you complete the synchronization process.

    Caution: Make sure that there are no extra characters appended to previous lines of code when you copy it from this document.

Post editing tasks:
  • Stand alone environment:
    Bring up your server and check portal page.

  • Clustered environment:
    1. Start your Deployment manager and node agents.

    2. Synchronize the nodes.

    3. Start your clustered environment.

    4. Log into the Process Portal and verifythe CSS styling

After completing the previous steps, the Process Portal displays with CSS styling as shown in the following screen shot::

Cross reference information
Segment Product Component Platform Version Edition
Business Integration IBM Business Process Manager Express Installation / Configuration Linux, Linux zSeries, Windows 8.0.1, 8.0, 7.5.1, 7.5
Business Integration IBM Business Process Manager Advanced Installation / Configuration AIX, Linux, Linux zSeries, Solaris, Windows 8.0.1, 8.0, 7.5.1, 7.5

Product Alias/Synonym


Document information

More support for: IBM Business Process Manager Standard
Installation / Configuration

Software version: 7.5, 7.5.1, 8.0, 8.0.1

Operating system(s): AIX, Linux, Solaris, Windows

Reference #: 1587668

Modified date: 26 March 2012

Translate this page: