Application Deployment Parameters

Application deployment parameters specify whether failover or affinity are enabled on the application being deployed to the cluster. Manually create an application deployment (XML) configuration file to set these options. Each application to be deployed to the cluster, such as an adapter, requires its own configuration file.

The ESP installation directory does not include a sample application deployment configuration file. See Sample Application Deployment Configuration File for sample file content.

These options are only valid for adapters built using the adapter toolkit. For a full list of these adapters, see Preconfigured Adapters Included with the Adapter Toolkit in the SAP Event Stream Processor: Building Custom Adapters guide.

XML Element	Description
ApplicationDeployment	(Required) Root element containing all elements below.
Instances	(Required) Section containing the Instance element and its sub elements.
Instance	Type: `string` (Required) Specifies the application instance. Contains two attributes: name - the application name type - the application instance type The only valid value for the type attribute is toolkit_adapter. This element contains the Failover and Affinities elements.
Failover	Type: `boolean` (Required) Specifies whether you want to enable failover for the adapter. If disabled, adapter restarts are not permitted. If enabled, the FailureInterval and FailurePerInterval elements are accessible and adapter restarts are permitted. Contains the FailureInterval and FailurePerInterval elements.
FailureInterval	Type: `integer` (Required) Specifies the time, in seconds, of an interval. If failover is enabled, a value is required. If failover is enabled and this value is empty, the adapter cannot be successfully added to the cluster.
FailurePerInterval	Type: `integer` (Required) Specifies the number of restarts the application can attempt within a given interval. This count resets to zero if you restart the application manually, or if failures are dropped from the list because they are older than the size of the interval.
Affinities	(Optional) Section containing the Affinity element.
Affinity	Type: `string` (Optional) Specifies a controller affinity which determines the node the application can run on. The only valid value is controller. This element contains four attributes: charge, strength, type, and value. If an affinity is specified, values for these attributes must be specified. Charge can be positive or negative. If positive, the application runs on the node. If negative, the application does not run on the node. Strength can be strong or weak. Strong requires the application to run only on a specific node. If you have strong, positive affinity set for a node, and that node fails, the failover process tries to restart the application on that node. If the node has not recovered, the application restart fails, and you must restart manually. Type specifies the affinity type. Controller is the only valid value. Value specifies the value of the affinity. For example, if the affinity type is controller, its value should be the node name for which the affinity is set.