Correlator Deployment Packages
Apama 5.0 introduces Correlator Deployment Packages (CDP). A CDP contains application EPL code in a proprietary, non-plain-text format. This treats EPL files similarly to Java files in a JAR file. You can inject a CDP file to the correlator just as you inject an EPL file or a JAR file containing a JMon application. When you inject a CDP file into the correlator, the package ensures that all the EPL files in the CDP are injected and injected in the correct order.
To support Correlator Deployment Packages, the following features have been added to Apama:
The
engine_package utility is a new command line tool in Apama 5.0. The utility assembles EPL files into a Correlator Deployment Package (CDP).
The
engine_inject utility has a new
-c (
--cdp) option that is used to inject CDP files.
The Apama C/C++ API has the following new methods for injecting CDP files:
virtual void injectCDP(const AP_uint8* cdpbytes, AP_uint32 size, const char *filename=NULL) = 0;virtual const char* const* injectCDPWithWarnings(const AP_uint8* cdpbytes, AP_uint32 size) = 0; virtual const char* const* injectCDPWithWarningsFilename(const AP_uint8* cdpbytes, AP_uint32 size, const char *filename) = 0; The Apama client API for Java has the following new methods for injecting CDP files:
void injectCDP(byte[] cdpBytes) void injectCDP(byte[] cdpBytes, java.lang.String filename) void injectCDPsFromFile(java.util.List<java.lang.String> filenames) The Apama client API for .NET has methods equivalent to the Apama client API for Java methods for injecting CDP files. For more information on the .NET client API, see the Apama .NET documentation help file located at
install_dir\doc\dotNet\engine_client_dotnet5.0.chmIn Apama Studio, you can use CDP files by adding them to your projects in the following ways:
As external dependencies to the
MonitorScript Build Path.
Directly including them in a project, for example, by dragging the CDP file from Windows Explorer and dropping it onto the project in Apama Studio's
Project Explorer view.
Apama Studio provides a new feature to export EPL files as a CDP file.