Bundle instances
When you add a connectivity bundle or an adapter bundle to a project in the Project Explorer view, the bundle appears in the project's directory structure. Many bundles contain only EPL or Java files. Adding these bundles means that references to the bundle files will be added to the project build path, but does not involve copying any files into the project. However, when you add a connectivity bundle or an adapter bundle that contains customizable files such as .evt or configuration files, Software AG Designer physically copies these files into the project, in addition to the changes made to the project build path.
If you add more than one instance of a particular connectivity bundle or an adapter bundle to the project, Software AG Designer creates separate copies of these files for each instance (except for bundles where it only makes sense to have one copy of the instance files per project). You can change and customize the bundle instance files in any manner. It is possible to add multiple instances of such bundles to a given project to allow different customization of the same instance files, for example if your application needs to run with two instances of a particular adapter, each connected to a different data provider.
Note:
In addition to using
Software AG Designer to add bundle instances to Apama projects (or to remove bundle instances), you can also do this using the
apama_project command-line tool. See
Creating and managing an Apama project from the command line for more information.
To add more than one bundle instance
1. Right-click the bundle and select Add instance. The Connectivity and Adapter dialog appears.
2. Provide a unique name for the bundle instance in the Instance name text box to identify the instance to distinguish it from any other instances of the same bundle.
Optionally, you can also accept the default bundle instance name.
Note:
You can provide a name only for some of the connectivity bundles and adapter bundles.
This instance name will be included in the filename of the bundle instance files when they are copied into the project. If only one instance of a given bundle will be required, it is fine to use the default bundle instance name.
3. Click OK.
A bundle_name.yaml file and a bundle_name.properties file are created in the Connectivity and Adapters > bundle_name > bundle_instance node.