X Platform Documentation Portal

Release Notes

X Platform Documentation Portal

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Correcting ADM compatibility level advisory.

...

Section

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

Table of Content Zone
maxLevel3
minLevel1
outlinefalse
locationtop
stylecircle
typelist
printabletrue

New Feature

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

div
classreleaseNote

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

Code Block
xml
xml
<model>

<env>
  <property1>value1<property1>
  <property2>value2</property2>
</env>

<apps>
  <app name="app-1" mainClass="com.acme.MyApp">
  </app>
<apps>

<servers>
  <server name="xvm-1">
    <apps>
      <app name="app-1"/>
    <apps>
    <env>
       <property2>value2a</property2>
       <property3>value3a</property3>
    </env>
  <server>
</servers>

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

Align
alignright
Status
subtlefalse
colourYellow
titleConfiguration

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

div
classreleaseNote

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

Align
alignright
Status
subtlefalse
colourYellow
titleSolace Binding

Anchor
XPLATFORM-1665
XPLATFORM-1665
XPLATFORM-1665 - Add support for DDL config templates

div
classreleaseNote

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.

Code Block
xml
xml
<apps>
  <templates>
    <app name="app-template">
      <captureEventLatencyStats>false</captureEventLatencyStats>
      <captureTransactionLatencyStats>true</captureTransactionLatencyStats>
      <captureMessageTypeStats>true</captureMessageTypeStats>
      <capturePerTransactionStats>false</capturePerTransactionStats>
    </app>
  </templates>

  <app name="ems" mainClass="com.neeve.tick2trade.App" template="app-template">
    <messaging>
      <bus name="ems">
...

See DDL Config Reference for more details

(warning) documentation is still in progress for the feature

Align
alignright
Status
subtlefalse
colourYellow
titleConfiguration

Anchor
XPLATFORM-1668
XPLATFORM-1668
XPLATFORM-1668 - Add support for DDL config profiles.

div
classreleaseNote

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.

Code Block
xml
xml
<model>
  <apps>
    <app name="order-processor" mainClass="com.acme.MyApp">
      ...
    </app>
<apps>
<profiles>
  <profile name="troubleshooting">
    <apps>
      <app name="order-processor">
         <enableMessageTrace>true</enableMessageTrace>
      </app>
    </apps>
  </profile>
</profiles>
</model>

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

Align
alignright
Status
subtlefalse
colourYellow
titleConfiguration

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

div
classreleaseNote

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

Code Block
xml
xml
<xvm name="ems1">
  <provisioning>
    <host>192.168.1.13</host>
    <rootDirectory>/root/work/lumino</rootDirectory>
    <dataDirectory>rdat</dataDirectory>
    <qualifyPathsWithSystem>true</qualifyPathsWithSystem>
    <jvm>
      <javaHome>/usr/java/jdk1.8.0_60</javaHome>
      <jvmParams>
        -Xms8g
        -Xmx8
      </jvmParams>
    </jvm>
  </provisioning>
...

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

Align
alignright
Status
subtlefalse
colourYellow
titleConfiguration

Improvement

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

div
classreleaseNote

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:

div
classreleaseNote
 

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.

Align
alignright
Status
subtlefalse
colourYellow
titleConfiguration
div

Change

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

div
classreleaseNote
 

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

Align
alignright
Status
subtlefalse
colourYellow
titleMaven Plugins

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

div
classreleaseNote

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:

div
classreleaseNote
 

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.

Align
alignright
Status
subtlefalse
colourYellow
titleBuild/Infrastructure
div

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

div
classreleaseNote
 

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.

Align
alignright
Status
subtlefalse
colourYellow
titleConfiguration

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

div
classreleaseNote

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

div
classreleaseNote
 

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.

Align
alignright
Status
subtlefalse
colourYellow
titleADM
div

Bug

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

div
classreleaseNote
 

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.

Align
alignright
Status
subtlefalse
colourYellow
titleDirect Binding