pluginMerge script

pluginMerge script

The pluginMerge.bat|.sh script combines plugin-cfg.xmls from two or more unbridged cells so 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.

Default script usage...
cd app_server_root/bin
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.

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):
cd 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
Related:

Cell affinity function
Create and configure ODRs
Configure ODRs
Enable cell affinity
Configure cell affinity in a multi-tiered environment
Use generic server clusters with cell affinity
Intelligent Management: scripts

-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.