Implementing Event Streaming

Use these steps as a summary of tasks required to implement event streaming in a MATRIXX Digital Commerce environment.

To implement event streaming in a MATRIXX Digital Commerce environment:

  1. Determine the additional hardware and software that event streaming requires.
    • No additional hardware is required to run the Event Streaming Framework on a MATRIXX Proxy Server. However, dedicate Proxy Server systems to primarily run the Event Streaming Framework if your MATRIXX Digital Commerce environment uses event streaming heavily.
    • No additional hardware is required to run the Event Stream Server on publishing blades.
    • If you use the Event Stream Server HA features you will need additional physical Proxy Servers. For more information, see the discussion about creating an Event Streaming Framework HA group.
    • You must configure more SSD storage on each MATRIXX Engine running event streaming. For more information, see the discussion about storage configuration requirements.
  2. Install MATRIXX Engine RPMs normally; support for the Event Stream Server is included.

    For more information, see the discussion about installing MATRIXX Engine.

  3. Install the event streaming RPM file. For more information, see the discussion about installing the MATRIXX Engine gateways and web applications.
  4. (Optional). If your MATRIXX Digital Commerce environment requires the Event Streaming Framework HA features, install and configure additional Event Streaming Framework nodes. For more information, see the discussion about creating an Event Streaming Framework HA group.
  5. Configure the Traffic Routing Agent (TRA) load balancer for publishing blades (TRA-PUB).

    For more information, see the discussion about configuring the engine-level TRA Servers (TRA-PROC and TRA-PUB).

  6. (Optional) If your MATRIXX Digital Commerce environment uses sub-domain routing, configure an Event Streaming Framework virtual server (VS) for the TRA-RT-(SI/DR) for each sub-domain while configuring the TRA DR. The TRA configuration requires that:
    • The VS point to the external-facing VIP.
    • The VS protocol is set to evs.
    • The VS pool balance-method is domain_id_protocol.
    For example: 
    <vip name="vip-int-1" ifName="lo" address="127.0.0.101" netmask="32"/>

<vs name="intStreamSD1" vip="vip-int-1" port=[port] protocol="evs" pool="streamSD1Pool"/> 

<pool name=""streamSD1Pool"" balance-method="domain_id_protocol">
 <node name="sd1e1pub" id="1" address=[engine 1 publisher TRA-LB VIP]/>
 <node name="sd1e2pub" id="1" address=[engine 2 publisher TRA-LB VIP]/>
</pool>
    For more information on TRA configuration, see the discussion about configuring Traffic Routing Agent in Installation and Configuration.
  7. On the MATRIXX Engine, configure the create_config.info parameters and the publishing blade NFS export table.
    For more information, see these discussions:
    • Event Streaming publishing server configuration.
    • Configuring the publishing blade NFS server export table.
  8. On the Event Streaming Framework server, create the event-stream definitions for the event streams you want MATRIXX Engine to generate.

    You include your event stream definitions in the Event Streaming Framework configuration. The Event Streaming Framework sends your definitions to the MATRIXX Engine cluster upon start-up. Define different event streams for each sub-domain in your environment. The Event Streaming Framework includes an out-of-the-box configuration file that serves as a template for defining custom event streams.

    To configure the Event Streaming Framework:
    1. Edit the Event Streaming Framework properties file.

      For more information, see the discussion about configuring the Event Streaming Framework.

    2. Configure Event Streaming Framework connectors.

      For more information, see the discussion about Event Streaming Framework connectors.

  9. Configure one of the default connectors, or create and configure a custom connector. For more information, see the discussion about Event Streaming Framework connectors.
  10. Start the MATRIXX Engine.

    For more information, see the discussion about starting an engine.

  11. Start the Event Streaming Framework. For more information, see the discussion about starting, stopping, or restarting the Event Streaming Framework.
  12. Verify that event streaming is occurring in your MATRIXX Digital Commerce environment by checking logs.

    For more information, see the discussion about verifying event streaming from log file messages.

If you need to reconfigure an existing event stream, see the discussion about reconfiguring event streaming during runtime.