Upgrading the configuration of the Content event emitter

When you upgrade your CPE deployment with the Content event emitter from an earlier version to a newer version, also upgrade the configuration of the event emitter.

Before you begin

Before you upgrade the configuration of the Content event emitter, make sure that the traditional WebSphere® Application Server deployment is properly prepared. For more information, see Preparing a traditional WebSphere Application Server deployment for Content event emitter installation.

For CPE containerized deployments, make sure that you specify the object store initialization parameter oc_cpe_obj_store_enable_content_event_emitter to have the operator configure the content event emitter. If not, you have to configure the content event emitter manually. For more information, see Configuring the Content event emitter for the first time.

Procedure

  1. Retrieve the bai-content-emitter.jar file.

    For instructions, see Retrieving the Content event emitter module for configuration.

  2. Log in to the Administration Console for Content Platform Engine.
  3. Go to Object Stores > object store name > Browse > Root Folder > CodeModuleEmitter (or to the path for where the existing Business Automation Insights Content event emitter is located).
    Note: The object store names placeholder represents the name of the object store where you want to create the event action and subscription,for example, TARGET or DESIGN.
  4. Click EmitterCodeModule or the name of the existing Code Module object.
  5. Click Actions, then select Checkin, checkout, cancel > Exclusive Checkout.
  6. Click Checkout.
  7. Click Actions, then select Checkin, checkout, cancel > Exclusive Checkin.
  8. Click Add, click Browse to select the bai-content-emitter.jar file that you retrieved in step 1 to 7, and then click Add Content.
  9. Select Check Update all Action class instances that reference earlier versions of this Code Module class.
  10. Click Check In Major Version.
  11. Optional: Check if you want to add more subscribed events.
    1. Go to Object Stores > object store name > Events, Actions, Processes, Subscriptions.
      Note: The object store names placeholder represents the name of the object store where you want to create the event action and subscription,for example, TARGET or DESIGN.
    2. Click ContentEventEmitterSubscription or the name of the existing subscription used by the Content event emitter.
    3. Clicked Subscribed Events tab.
    4. Select Deletion Event. Optionally, you can also select Get Content Event. Selecting the Get Content Event will result in a large increase in emitted events. Events other than Creation Event, Update Event, Deletion Event, and Get Content Event are not supported.
    5. Click Save.

Results

The updated code module is immediately available for use and no restart of the Content Platform Engine container is needed.