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).
For more information on engine_package, see "Event Correlator Utilities Reference" in Deploying and Managing Apama Applications.
The
engine_inject utility has a new
-c (
--cdp) option that is used to inject CDP files.
For more information on engine_inject, see "Event Correlator Utilities Reference" in Deploying and Managing Apama Applications.
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; For more information on the C++/C API, see "The Client Software Development Kits for C++ and Java" in Developing Clients.
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) For more information on these methods, see "The JavaBeans API" in Developing Clients.
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.
For more information on adding resources to Apama projects, see "Working with Projects" in Using Apama Studio.
Apama Studio provides a new feature to export EPL files as a CDP file. For information on the
Export as Correlator Deployment Package wizard, see "Working with Projects" in
Using Apama Studio.