NERV Configuration Properties

You can configure the default transport layer, the guaranteed delivery for EDA events with Ehcache, as well as the error handling options that NERV uses during runtime.

When NERV is used by emit applications in the Software AG Common Platform, modify the configuration properties as described in Modifying the Transport Layer Configuration.

When NERV is used by the Event Bus Console, modify the properties available in the com.softwareag.eda.nerv.properties file, located in the Software AG_directory \common\conf directory.

com.softwareag.eda.nerv.dead.letter.channel.uri - specifies the location where NERV sends any undelivered events after the maximum number of redelivery attempts has been reached. The default value is @url:sag.install.area/common/nerv/dlc. When NERV runs in the Common Platform, the @url:sag.install.area token is dynamically resolved to point to your Software AG installation directory.

com.softwareag.eda.nerv.in.memory.channel.size - specifies the maximum number of messages contained in the in-memory channel used by NERV. This property is global and applies to all event types. The default value is 1000.

com.softwareag.eda.nerv.maximum.redelivery.attempts - defines the maximum number of attempts that NERV makes to redeliver events, in case the initial delivery attempt fails. The default value is 100. Set to -1 for infinite redelivery attempts.

Note:

When you set up the guaranteed delivery level to MAXIMUM_STRONG or MAXIMUM_EVENTUAL, the value you have defined for the com.softwareag.eda.nerv.maximum.redelivery.attempts property is disregarded. Instead, NERV attempts to redeliver events infinitely to prevent the loss of events, as well as to ensure that their order is kept.

com.softwareag.eda.nerv.cache.configuration.location - specifies the location of the Ehcache configuration files. It is used together with the com.softwareag.eda.nerv.guaranteed.delivery.level property.

com.softwareag.eda.nerv.default.jms.provider - defines the default transport layer which NERV uses to connect to the Event Bus. The value of this parameter is populated during installation. The default value is nsp://<host_name>:9000.

Note:

This property supports only the use of webMethods Universal Messaging or webMethods Broker as JMS providers. If you want to use another JMS provider, you must deploy a custom NERV component configuration bundle for the respective provider.

com.softwareag.eda.nerv.jms.asynch.subscription - defines the way NERV subscribers consume events. The default value is false. If set to true, NERV subscribers consume events asynchronously.

com.softwareag.eda.nerv.jms.auto.generate.topics - enables NERV to create topics automatically on the specified JMS provider. The default value is true. If set to false, users must create topics manually on the JMS provider.

Note:

This property supports only the use of webMethods Universal Messaging or webMethods Broker as JMS providers. When NERV is used in a Universal Messaging cluster environment, this property must be set to false.

com.softwareag.eda.nerv.guaranteed.delivery.level - specifies the guaranteed delivery level for storing events. Possible values are NONE, MAXIMUM_STRONG (default), and MAXIMUM_EVENTUAL.

com.softwareag.eda.nerv.configbundles.location - contains the path to the location where NERV expects to find its component configuration bundles. The default value is @path:sag.install.area/common/nerv/bundles. When NERV runs in the Common Platform, the @path:sag.install.area token is dynamically resolved to point to your Software AG installation directory.

com.softwareag.eda.nerv.eventtypestore.location - contains the path to the Event Type Store location. The value of this parameter is populated during installation. The default value is:@path:sag.install.area/common/EventTypeStore. When NERV runs in the Common Platform, the @path:sag.install.area token is dynamically resolved at runtime to point to your Software AG installation directory.

com.softwareag.eda.nerv.redelivery.delay.ms - defines the interval (in milliseconds) at which NERV makes the redelivery attempts. The default value is 3000.

com.softwareag.eda.nerv.security.file.location - contains the path to the NERV security file. This file contains the encrypted secret key used by NERV for encrypting and decrypting passwords specified in the route bundles making connections which require password authentications. The default value is: @path\:sag.install.area/common/conf/nerv/nerv-security.xml. When NERV runs in the Common Platform, the @path:sag.install.area token is dynamically resolved at runtime to point to your Software AG installation directory.