pluginMerge script

You can use the pluginMerge script to merge the plugin-cfg.xml files from two or more unbridged cells in order to allow an IBM® HTTP server plug-in to route to all cells according to the defined mode.

Purpose

The pluginMerge.bat|.sh script combines the plugin-cfg.xml files from two or more unbridged cells so that an IBM HTTP server plug-in can load-balance across the cells, fail over to defined (backup) cells, or route to all cells, according to precedence.

Location

The pluginMerge script is in the app_server_root/bin directory. Before running this script, ensure that you have the environment variable configured to point to the directory of your WebSphere® installation.

Usage

The default script usage follows:

pluginMerge.sh [MODE] plugin-cfg1.xml plugin-cfg2.xml [...] outputfile.xml

To display help, run the script without passing any arguments.

Modes

-l: Load-balance merge. Merged output allows for load-balancing across the cells.
-f: Failover merge. The merged output allows for failover to backup servers. The sequence of the input plugin-cfg.xml files determines which servers are considered primary or backup for a specific URI. If a shared URI is discovered, the primary server is the one corresponding to the URI in the leftmost matched plugin-cfg.xml file. All other servers are listed as backup. If a URI is unique to a specific plugin-cfg.xml file, the corresponding servers are marked as primary for the unique URI.
-p: Precedence merge. The precedence ranking is determined by the sequence of the input plugin-cfg.xml files. The merged output limits routing requests for shared URIs to only the servers contained in the leftmost matched input plugin-cfg.xml file. If a URI is unique across the input plugin-cfg.xml files, then the servers corresponding to that URI are the ones routed to.

Note: A URI is considered to be shared between two unbridged cells if the URI and the corresponding virtual host definition are identical between plugin-cfg.xml files.

In the following example, the merged output contained in plugin-cfg-merged.xml allows an IBM HTTP server plug-in to load balance requests between all servers contained in the input plugin-cfg.xml files (plugin-cfg-cell1.xml, plugin-cfg-cell2.xml, plugin-cfg-cell3.xml):

app_server_root/bin/pluginMerge.sh -l /tmp/plugin-cfg-cell1.xml /tmp/plugin-cfg-cell2.xml 
 /tmp/plugin-cfg-cell3.xml /tmp/plugin-cfg-merged.xml