Connecting BMC Impact Integration Web Services server with BMC Impact Manager for event subscription

If the BMC Impact Manager cell needs to propagate events to BMC Impact Integration Web Services server, it must specify the gateway server of the BMC Impact Integration Web Services server by adding the IIWSGatewayServer entry in its mcell.dir file.

The following figure shows an example mcell.dir configuration of a cell. You must include the IIWSGatewayServer entry to specify the server that receives the events.

mcell.dir example: BMC Impact Manager cell

If your BMC Impact Integration Web Services server implementation serves multiple purposes, one of which is receiving events, then follow the mcell.dir examples for receiving events.

Before you begin

To verify whether the default port numbers are available, run the netstat -a -n command.

To add BMC Impact Manager cell entries to the mcell.dir file for the BMC Impact Integration Web Services server

For each BMC Impact Manager cell with which your BMC Impact Integration Web Services server communicates, you must make a corresponding entry in the server's mcell.dir file.

1. In a text editor, open the mcell.dir file located in the following directory:
   $IIWS_HOME/Tomcat/webapps/imws/WEB-INF/etc
2. Add the cell data for each BMC Impact Manager cell that you intend to connect to by using the following guidelines and example:
   • You can specify the local host by using one of the following:
     • Host name
     • Localhost string
     • Loopback IP, for example, 127.0.0.1

   • If you intend to query or communicate with a service model, include all the cells that comprise the service model in the mcell.dirfile.

     <Type>         <Name>       <EncryptionKey>      <IPAddress:Port>
     
     gateway.imcomm IIWSGatewayServer   MC            127.0.0.1:1859
     cell           cellConnect         MC            myIMComputer:1828
     cell           cellConnect1        MC            myIMComputer1:1828
     cell           cellConnect2        MC            myIMComputer2:1828
     cell           cellConnect3        MC            myIMComputer3:1828
3. Save and close the file.
4. Start or restart the server. If you have other configuration changes to make, you can start or restart the server when you have completed. For more information, see Starting, stopping, and connecting to the BMC Impact Integration Web Services server.

To add IIWSGatewayServer entries to the mcell.dir files

Perform the following steps if the cells are propagating events to the BMC Impact Integration Web Services server.

1. In a text editor, open the mcell.dir file of the BMC Impact Manager cell that is sending the events to the BMC Impact Integration Web Services server.

2. If the BMC Impact Manager cell is sending events to a single BMC Impact Integration Web Services server, add the IIWSGatewayServer entry as shown in the following figure. Include the host name or IP address and the port number. The lookup combination of event listener name, host name, and port number must be unique for each IIWSGatewayServer instance.

   <Type          <Name>        <EncryptionKey>   <IPAddress:Port>
   
   gateway.imcomm  IIWSGatewayServer          MC            myWSComputer:1859
   cell            cellConnect                MC            myIMComputer:1828

3. If the cell is sending events to multiple BMC Impact Integration Web Services server instances, then add the corresponding IIWSGatewayServer entries. Specify a unique combination of name, IP address (or host name), and port number for each IIWSGatewayServer entry.
   
   For example, if the server instances are on different systems, you can make the IIWSGatewayServer entries as shown in the following figure:

   <Type          <Name>        <EncryptionKey>   <IPAddress:Port>
   
   cell            cellConnect          MC           myIMComputer:1828
   gateway.imcomm  IIWSGatewayServer    MC           myWSComputer:1859
   gateway.imcomm  IIWSGatewayServer1   MC           myWSComputer:1859
   gateway.imcomm  IIWSGatewayServer2   MC           myWSComputer:1859

   Because each BMC Impact Integration Web Services server instance is on a different host system, you do not have to specify a distinct port number for each IIWSGatewayServer event listener.

4. Save and close the file.
5. Restart the BMC Impact Manager cell.
6. Repeat steps 1 through 5 in the mcell.dir file of each BMC Impact Manager cell that is sending events to the server.
7. To enable the BMC Impact Integration Web Services server to receive events from the connected cell, you must add a Propagate rule that specifies its IIWSGatewayServer to the Knowledge Base (KB) of the BMC Impact Manager cell. For more information, see Defining Propagate rules or event propagation policies for BMC Impact Manager cells. Alternatively, you can add a Propagate policy through the administration console.