X Platform Documentation Portal

Release Notes

X Platform Documentation Portal

Skip to end of metadata
Go to start of metadata

Release Date: Friday, October 20, 2017

Release Highlights

  • Several new DDL configuration features including ability to use configuration profiles and templates.

This milestone introduced several new configuration features and changes. Not all of these have been documented in the Talon Manual as these changes are part of a larger body of work in the 3.8 release which is still ongoing, these new configuration features will be documented as part of the first 3.8 release or when the set of configuration enhancements for 3.8 has been completed.

Compatibility Notes

ADM Compatibility Level: 3.8.1 (see ADM Compatibility Matrix). This release bumps the ADM compatibility level to 3.8.1 as part of the fix for XPLATFORM-1823. The Adm Compatibility level last changed in Core X 3.7.242

(warning) The following issues have compatibility implications:

Change Log

New Feature

XPLATFORM-1120 - Allow DDL to provide vm scoped <env> section which overrides global env.

This release provides the ability to specify XVM specific <env> properties in config DDL. For example:

Would result in the XRruntime for server-1 ending up with:

  • property1=value1
  • property2=value2a (from xvm specific env)
  • property3=value3a (from xvm specific env)

(warning) documentation is still in progress for the feature

CONFIGURATION

XPLATFORM-1524 - Allow validation of solace queue's configured max bind count

This release introduces the ability to validate and enforce the value of a solace queue's max bind count when starting a solace message bus binding by setting

See Enforcing Max Queue Bind Count in the Talon Manual for more details

SOLACE BINDING

XPLATFORM-1665 - Add support for DDL config templates

This release provides the ability for DDL config to define template apps, buses and xvms that can provide base configuration shared by multiple applications.

For example in the following DDL snippet tracing configuration is defined in the "app-template" which is referenced by the ems1 app which inherits that configuration.

See DDL Config Reference for more details

(warning) documentation is still in progress for the feature

CONFIGURATION

XPLATFORM-1668 - Add support for DDL config profiles.

This release introduce DDL profiles as a new configuration feature. DDL profiles allow defining overlay configuration directly inside a the <profiles> section of a DDL. DDL profiles can be activated explicitly or via the profile's <activation> element which support the ability to automatically activate a profile based on environment variables.

In the above code snippet if DDL is parsed with -Dnv.ddl.profiles=troubleshooting, the configuration defined in the troubleshooting profile will be overlaid on top of the main configuration.

See DDL Config Reference for more details.

(warning) documentation is still in progress for the feature

CONFIGURATION

XPLATFORM-1817 - Provide support for specifying provisioning information in DDL

This release provides the ability to specify provisioning information in DDL Config. For example:

This allows provisioning tools such as Robin or Lumino to leverage configuration directly from DDL rather than relying on additional files such as <xvmname>.jvmparams or <xvmname>.env

For more information see DDL Config Refefence

(warning) documentation is still in progress for the feature

CONFIGURATION

Improvement

XPLATFORM-1821 - Properties based DDL should fail on unrecognized x.* properties

Prior to this release when DDL is specified in properties format (for users using an external configuration mechanism) unrecognized properties were ignored. With this release VMConfigurer now throws an error if any x.* property is specified that is not defined in the DDL xml schema.

Note that this validation does not apply to generic properties such as bus properties or env properties (that correspond to hierarchical properties in the DDL xml). Additionally this validation does not cover any properties that are outside of x.* configuration.
Compatibility Notes:

 

This release adds additional validation of DDL configuration supplied via properties rather than xml. Applications using properties based DDL configuration that pass in unknown x.* properties may fail to start. To revert to the old behavior of ignoring unknown properties, applications may set the property nv.ddl.propertynamevalidation=false in the ddl property set passed to VMConfigurer or as a system property.

CONFIGURATION

Change

XPLATFORM-1803 - Talon Maven build should use nvx-adm-maven-plugin, and nvx-adm-maven-pluging should not declare nvx-hummingbird as optional

 

This release changes the nvx-platform-plugin to include the nvx-adm-maven-plugin's goals rather than the deprecated nvx-core-maven-plugin.

MAVEN PLUGINS

XPLATFORM-1805 - Update DDL to allow using <xvms> and <xvm> instead of <servers> and <server>

This release provides DDL support for specifing <xvms> and <xvm> rather than <servers> and <servers>. The <servers> and <server> elements are deprecated, but remain usable for backwards compatibility ... with the caveat that only one or the other nomenclature can be used.
Compatibility Notes:

 

It is recommended that user's update their configuration DDL to switch from <servers> to <xvms> and from <server> to <xvm> as support the former variants will be dropped in a future release.

BUILD/INFRASTRUCTURE

XPLATFORM-1820 - Allow configuring DDL config prefix in ddl config properties in addition to the environment

 

This release adds the ability to change the ddl configuration prefix used to specify platform related properties in the DDL property set itself by setting the property nv.ddl.prefix. Prior to this release a user could only specify the prefix by setting this property in the environment or set of override properties passed in to VMConfigurer.

CONFIGURATION

XPLATFORM-1823 - Allow lendXXX(XString value) to accept a null XString

This release changes the ADM generated lendXXX(XString val) method to allow it to accept a null value without throwing a NullPointerException.
Compatibility Notes:

 

To take advantage of this change ADM models need to be regenerated. The ADM compatibility version was incremented from 3.8.0 to 3.8.1 as a result of this change.

ADM

Bug

XPLATFORM-1827 - Direct Binding can lose messages during retransmit.

 

This release resolves a bug in the direct binding implementation which can cause it to lose messages during a connection failure when sending protobuf encoded messages with pooling enabled.

DIRECT BINDING
  • No labels