Generating an HTTP server configuration by using the IBM Integration API

Generate a configuration file for either the WebSphere® Application Server plug-in or the Apache mod_proxy module to use for connecting to a web server such as IBM® HTTP Server (IHS).

Before you begin

Read the concept topic, Using external web servers with IBM Integration Bus.

About this task

Use the IBM Integration API to generate the file contents for the mod_proxy module or the WebSphere Application Server plug-in configuration files. These files contain port and URL data for multiple integration nodes on multiple servers.

Procedure

Call the appropriate static method on the BrokerProxy class.
  • If you are using the WebSphere Application Server plug-in, use the following method, passing in as parameters a java.util.Map mapping of BrokerProxy objects to host names and a value of data type long that represents a timeout interval in milliseconds: 
    public static String generateWASPlugin(Map <BrokerProxy,String> brokerHostMap, long timeoutInMilliseconds) 
                               throws ConfigManagerProxyLoggedException
  • If you are using the Apache mod_proxy module, use the following method, passing in as parameters a java.util.Map mapping of BrokerProxy objects to host names and a value of data type long that represents a timeout interval in milliseconds: 
    public static String generateModProxyPlugin(Map <BrokerProxy,String> brokerHostMap, long timeoutInMilliseconds) 
                               throws ConfigManagerProxyLoggedException
  • If you want to use an alternative to the plug-ins provided by WebSphere Application Server or Apache, you can use the following static IBM Integration API method on the BrokerProxy class to retrieve port and URL data for an individual integration node in CSV format. 
    public static String getPortConfigAsCSV() 
                               throws ConfigManagerProxyLoggedException

For a sample API program that generates an HTTP server configuration file for multiple integration nodes, see the following article: Load balancing WebSphere Message Broker HTTP traffic.

For more information, see the IBM Integration API reference documentation (IBM Integration API).
Note: For details about support provided for configurations between IBM Integration Bus and IBM HTTP Server, see IHS support issues.

What to do next

Now that you have generated a configuration file, complete the relevant product instructions for configuring the web server: