Manually configuring additional remote CEI servers for a single model

If you want one monitor model to receive events that are emitted to multiple CEI servers in multiple cells, you must manually configure each additional Common Event Infrastructure (CEI) server before monitor model deployment.

Before you begin

Before you begin this task, you must log in to the WebSphere® Application Server administrative console.

If you are using the table-based method to receive events, you need to perform only steps 4a to 4k and step 5 below.

If you are using a remote CEI server and using the queue-based method to receive events, you must have configured the service integration bus links before beginning this task. See the related task about "Configuring queue-based event management in a multiple-cell environment."

About this task

When you deploy a monitor model, the monitor model deployment process creates the "_Q" queue. When you create another version of the monitor model, the original queue is re-created as a "_Q_A" queue, and the newer version has a "_Q" queue created during monitor model deployment.
Note: If your monitor model has been configured to receive events from a remote CEI server, and you want it to also receive events sent by IBM® Business Monitor, you only need to perform step 4.

Using the WebSphere Application Server administrative console, complete the following steps on each additional CEI server:

Procedure

  1. (Queue-based only:) Configure the queue destinations to be accessible in the CEI server cell:
    1. In the navigation panel, select Service integration > Buses. Click MONITOR.cell_name.Bus.
    2. Under Destination resources, click Destinations, and click New.
    3. Select Foreign for the destination type, and click Next.
    4. Enter wbm_model_name_model_version_Q_Destination for the Identifier. This value should match the destination name on the IBM Business Monitor server server.
    5. Click bus_name for the Bus. This value represents the name of the foreign bus on which the destination is defined.
    6. Click Next, and click Finish.
    7. Click New.
    8. Select Foreign for the destination type, and click Next.
    9. Enter wbm_model_name_model_version_Q_A_Destination for the Identifier. This value should match the destination name on the Monitor server.
    10. Click bus_name for the Bus. This value represents the name of the foreign bus on which the destination is defined.
    11. Click Next, and click Finish.
  2. (Queue-based only:) Configure the JMS queues that are backed by each foreign destination that you created:
    1. In the navigation panel, select Resources > JMS Providers > Queues.
    2. Select Cell, and click Apply to set the scope to cell.
    3. Click New.
    4. Enter wbm_model_name_model_version_Q for the Name.
    5. Enter jms/wbm/model_id/valid from date as YYYYMMddHHmmss/Q for the JNDI name.
    6. Select bus_name from the Bus drop-down list.
    7. Select queue_name from the Queue name list. Click OK.
    8. Click New to create a second queue.
    9. Enter wbm_model_name_model_version_Q_A for the Name.
    10. Enter jms/wbm/model_id/valid from date as YYYYMMddHHmmss/Q_A for the JNDI name.
    11. Select bus_name from the Bus drop-down list.
    12. Select queue_name from the Queue name list. Click OK, and click Save.
  3. (Queue-based only:) Configure the queue connection factory for each JMS queue:
    1. In the navigation panel, select Resources > JMS Providers > Queue connection factories.
    2. Select Cell, and click Apply to set the scope to cell.
    3. Click New.
    4. Enter wbm_model_name_model_version_QF for the Name.
    5. Enter jms/wbm/model_id/valid from date as YYYYMMddHHmmss/QF for the JNDI name.
    6. Select bus_name from the Bus list. Click OK.
    7. Click New to create the second queue connection factory.
    8. Enter wbm_model_name_model_version_QF_A for the Name.
    9. Enter jms/wbm/model_id/valid from date as YYYYMMddHHmmss/QF_A for the JNDI name.
    10. Select bus_name from the Bus drop-down list.
    11. Click OK, and click Save.
  4. (Queue-based and table-based:) Create the Event Group Profile to configure the CEI server to accept the events by completing the following steps:
    1. In the navigation panel, select Service integration > Common Event Infrastructure > Event service.
    2. Under Additional Properties, click Event services.
    3. Click Default Common Event Infrastructure event server in the list of event services.
    4. Under Additional Properties, click Event groups.
    5. Click event_group.
    6. Click New.
    7. Enter wbm_model_version_Group for the Event group name.
    8. Enter value for the Event group selector string. The value must match the value of the event group created on the initial CEI server that was configured during the initial model deployment.
    9. Click OK.
    10. Click group_name for the event group you created.
    11. Under General Properties, ensure that the Persist events to the event data store box is not checked.
    12. Under General Properties, ensure that the Compatibility mode with previous event service transmission protocol box is not checked.
    13. (Table-based only:) Under Additional Properties, click Custom Properties and add the following property.
      • name: customEventSelectorFilterClass
      • value: The value must match the value for the event group created on the initial CEI server that was configured during the initial model deployment.
    14. Under Additional Properties, click Custom Properties and ensure that any properties other than customEventSelectorFilterClass contain values that correspond to the values for the event group created on the initial CEI server that was configured during the initial model deployment.
    15. (Queue-based only:) Under Additional Properties, click Distribution queues. Click New. Enter one of the following values for the Queue JNDI Name. The value must match the value of the distribution queue created on the initial CEI server that was configured during the initial model deployment.
      • model_id/valid from date as YYYYMMddHHmmss/Q
      • model_id/valid from date as YYYYMMddHHmmss/Q_A
    16. (Queue-based only:) Enter one of the following values for the Queue Connection Factory JNDI Name. The value must correspond to the Queue JNDI Name and must match the value of the distribution queue connection factory created on the initial CEI server that was configured during the initial model deployment.
      • jms/wbm/model_id/valid from date as YYYYMMddHHmmss/QF
      • jms/wbm/model_id/valid from date as YYYYMMddHHmmss/QF_A
    17. Click OK.
  5. (Queue-based and table-based:) Restart the CEI Server for the configuration changes to take effect.

Results

You can now send Common Base Events from this CEI server to the model you have configured.