Overview

When working with Event Sourcing, applications cannot make business logic decisions that affect recoverable state or the contents of outbound messages based on data in the local environmental or reference data that may be out of sync with backup instances. Doing so can lead to situations where a backup application instance makes different decisions than the primary instance that result in divergent state. Divergence of state can causes major problems if the backup takes over after a failure in the primary. This section introduces Talon's Environment Replication feature which provides developers with a means of avoiding such pitfalls in a manner that doesn't incur major performance overhead.One approach to making sure that primaries and backups are always operating on the same reference data is to inject that data into the applications messaging stream for use in subsequent business logic decisions. This approach is not always tenable. Consider a financial trading system making time sensitive order routing decisions based off a "firehose" of market data. A logically valid approach would be to inject all market data directly into the event sourced application's replication stream, but in reality such an approach is infeasible as it would overwhelm the application with data that will mostly be ignored. 

Talon provides an alternative approach to solving this problem, called Environment Replication. With this approach the platform provides an API which allow applications to write HA safe environment providers that capture local decisions on the primary instance into a capture buffer that is replicated along with the inbound message being processed. On the backup instance the capture buffer is then used to playback the same results as were used on the primary thereby allowing the same business logic decisions to be made. Environment providers are fairly simple to write and simple for applications to work with.

For example, Exegy, in partnership with Neeve backed their entire market data api with an environment provider, providing a seamless ultra low latency solution to the market data problem referenced above. With this approach market data is received out band with the respect to the trading application's order processing messages. As the primary instance of a trading application looks at current market data via Exegy's market data apis, the values presented in those calls are captured and replicated to the backup such the the backup instances see the same values when it makes the same api calls. In this fashion the entire stream of market data being absorbed by Exegy need not be replicated to backup instances, just the data that the primary instance uses in making decisions is replicated. 

This section discusses how a developer can write an environment provider to replicate its own replication data.

Sample Provider

Let's consider a contrived but simple example in which we want to include some local environment data on an outbound message: the current host name. We can create an environment provider that will provide the host name in an Event Sourcing safe fashion. 

Using the environment provider

Writing the Environment Provider

The above implementation encloses the IAepEnvironmentProvider implementation in an inner class called ProviderImpl. The application's AepEngine:

• Supplies a BufferManager to the provider implementation at intialization. The provider uses the buffer manager to request a larger buffer if it exceed the initial length of the buffer with capture data. 
• Calls onTransactionStart with a capture buffer and the TransactionAction indicating whether the provider should record or playback (depending on whether the application is operating as a Primary or Backup respectively. 

When the application calls getHostNameTo(XString hostName) the provider either reads the host name out of the capture buffer or writes the local hostname to the capture buffer. 

Restrictions

 When using environment replication, it is not possible to configure the application's storage to use parallel replication because the message handler must be invoked first to collect environment provider data.