Knowledgebase
Cumulative Update 1 for Neuron ESB 3.5 (KB351-121114)
Posted by Marty Wasznicky on 11 December 2014 11:54 PM

Cumulative Update 1 for Neuron ESB 3.5 (KB351-121114)

Cumulative Update 1 (CU1) for Neuron ESB 3.5 resolves issues that were found in Neuron ESB 3.5 since the software was released. This update rollup is highly recommended for all Neuron ESB 3.5 customers. This rollup release can be used to upgrade existing installations to Neuron ESB version 3.5.1.1

Released Versions CU1 can be applied to:

Neuron ESB builds 3.5.0.4 to 3.5.0.63.

System Requirements:

*This patch requires Powershell 4.0. Microsoft Powershell 4.0 can be downloaded and installed from the following location : http://www.microsoft.com/en-us/download/details.aspx?id=40855

Prior to installation, the NeuronPatch_3.5_CU1.zip file should be extracted to the local file system of the machine running Neuron ESB 3.5. As part of the update process all Neuron ESB files are backed up to a folder named Backup-NeuronESB_3.5_CU1. One folder is located beside the folder where the Discovery Service is installed. Another folder is located beside the folder where the Neuron ESB runtime instance is installed. You need to ensure that at least 60MB free disk space available plus 105MB for each instance that will be updated. The files for the update requires another 70MB of disk space. If you were updating a single instance, then you will need a total of 235MB. For two instances, a total of 340MB.

Fixes Included in CU1:

Business Processes

FIX – ODBC Process Step – When setting the dynamic connection string property and running multiple steps in sequence or within a loop, the first setting would take effect, but any other modifications to the connection string property would be ignored. Also, in a prior fix, to use dynamic properties the user was required to clear the associated property grid property. This requirement has been removed.

NEW – JSON Process Step – A new property, “Exclude Xml Root”, has been added. This property is available when serializing an XML document to JSON. When set to True, this will exclude the root element of the XML document from being serialized within outputted JSON.

FIX – Schema Validation Process Step – When a user attempted to delete all schemas entries from the Schema collection dialog, close the dialog and reopen it, all the previous deleted schemas would reappear. The UI was not handling empty collections correctly. This has been fixed.

FIX – Adapter Endpoint Process Step – When attempting to run in a Business Process that is remotely hosted, an exception would occur because the Neuron ESB configuration was inaccessible. This has been corrected.

Service and Adapter Policies

NEW - Republish to Topic option has been changed to preserve all header of custom properties of original message. The policies will also publish 3 additional custom properties that users can access to retrieve the specific error information related to the message.  The custom property prefix is "neuron". The properties are "FailureDetail", "FailureType" and "FailureDateTime"

Adapters

FIX – SalesForce.com Adapter – A exception may occur with the following message: The request message was already sent. Cannot send the same request message multiple times.

MOD – Microsoft Exchange Adapter - modified the Microsoft Exchange adapter so if an error occurs during the poll process (Publish mode), the following poll attempt will recreate the reference to the Microsoft Exchange service.

NEW – Microsoft Exchange Adapter – A KeepAlive property has been added to the adapter. Default value is false. This controls whether a request to Microsoft Exchange should contain a Keep-alive header. This property is only applicable for endpoints that target Exchange Online and versions of Exchange starting with Exchange Server 2013.

FIX – Microsoft Exchange Adapter – When processing an email retrieved from Exchange, if the Content-Type could not be found in the Internet Message Headers an “Object reference not set to an instance of an object” exception would be thrown.

NEW – SalesForce.com Adapter – Added the ability to download image and binary files using REST calls.

MOD – SalesForce.com Adapter - Added a dynamic resolver to hide the metadata generation property when OAuth is set to true.

NEW – Adapter Framework - A new Configuration property has been added to the ESBAdapterBase class. This property will receive the active Neuron ESB configuration when the adapter is created. The Neuron ESB Adapter Framework that ships in the Samples Browser has been modified to use this new property. 

FIX – Dynamics CRM 2011/2013 Workflow Adapter Plugin – When trying to install the workflow adapter a System.BadImageFormatException exception may be thrown on the file Neuron.Crm.Workflow.Setup.CustomAction.dll. This has been fixed.

Installation and Setup

MOD – The default settings for the optional Erlang and Rabbit MQ components has been changed so they are no longer selected by default.

MOD – 2 Neuron ESB assemblies were not properly versioned, defaulting instead to 1.0.0.0. This should have no impact. The 2 assemblies are RestControllers.dll and RestHostingService.dll. They are used by the Neuron ESB Discovery service to expose various management REST services.

Runtime

FIX – The Test Client and Workflow Host app.config files have been modified to probe the Neuron ESB Adapters and Pipelines directories for referenced assemblies. If the new Adapter Endpoint Process Step or Adapter Endpoint Workflow Activity were used at runtime, a file not found error could occur.

NEW – REST Documentation - In Neuron EBS 3.5 we released REST API documentation that shows the available REST endpoints and describes what they do. These REST APIs expose solution, runtime, deployment and endpoint management features. This patch provides improved REST API documentation including the ability to test the REST API directly from the help documentation page. To view the help documentation for an installed instance of Neuron ESB 3.5, navigate to the following URL in your browser:

http://localhost:51002/help

NEW - REST API - GET /neuronesb/api/v1/Activity/{instance}/{messageid} Now returns a new optimized ESB Message serialization format. This REST API can be used to return an ESB Message from the Failed Audit table within the Neuron ESB database.

FIX – WS-Discovery API – When using the Neuron ESB Test Client, displaying the Connection Settings dialog may log the following erroneous warning to the Neuron ESB Event log: Discovery Online Event received an unknown type from 'net.tcp://<machinename>:9021/Announcement'

Neuron ESB Explorer

FIX – x86 version of the Neuron ESB Explorer did not properly expose Process Step properties for editing. Also, Workflows could not be created using the Create New Workflow dialog within the Neuron ESB Explorer. This issue was isolated to the x86 version of the Neuron ESB Explorer.

FIX – Various UI fixes were made

NEW – A “Refresh” button has been added to the “Getting Started” screen that displays the RSS feed for the Neuron ESB product team blog.  This allows users to refresh the RSS feed on demand.

FIX – When trying to load the assembly references set on a C# code process step, if the path of assembly is not in legal format or dependencies of the referenced assemblies are not found, the Neuron Explorer may crash

FIX - Selecting the delete button to delete the assembly references on c# code process step could cause the Neuron explorer to crash.

Workflow

FIX – Attempting to cancel a workflow instance within the Workflow Tracking UI could generate an either an “An error occurred while performing operation Stop on workflow Instance X” or a “Value cannot be null” error message.

FIX – SOAP Collection within the Correlation Set dialog was not editable.

FIX – Neuron ESB Messages returned or sent out by a Workflow Instance at runtime were missing the workflow endpoint name, workflow instance id and workflow name context properties.

FIX – When using the Code Workflow Activity Editors within a Loop Activity, the item property was not accessible via intellisense in the tabbed view of the Code Editor.

FIX – The TransformXml Workflow Activity parameters collection has been changed to a Dictionary<string,object> collection. The values for parameters can now be set at runtime by using any of the Code Editor Workflow Activities just prior to executing the TransformXml Workflow Activity.

NEW - A new Workflow Activity named TransformMessage has been added to the Workflow Toolbox. This activity accepts a Neuron ESBMessage as a parameter and outputs a new ESBMessage containing the transformed output of the source message's body. The Workflow Activity allows customers to dynamically pass in XSLT parameters by using either XPATH, Neuron ESB custom message properties or Neuron ESB environmental variables.

To use a custom property, enter the following into the value field for the parameter:

{property:<prefix>.<name>}

For example, if I have defined the custom property “Person.Name” with value “Michael Jones”, then using “{property:Person.Name}” will insert the value “Michael Jones” into the parameter value when the XSLT is evaluated.

For an environment variable:

{env:<name>}

If I have the environment variable “MachineName” set to “MJONES01”, then using “{env:MachineName}” will result in the parameter having the value “MJONES01”.

Finally, for an XPath expression:

{xpath:<xpath-expression>}

If the source XML looks like this:

<person>

    <firstname>Michael</firstname>

    <lastname>Jones</lastname>

</person>

Using “{xpath:/person/firstname}” will use the value “Michael” for the parameter value.

Samples

MOD – The correlated Send and Receive sample has been modified to receive all correlated messages on sub topics.

MOD – The correlated Send and Receive and Correlated Workflow samples did not have the default localhost selected in the Deployment Settings of the Availability Group. Also, the Availability Group would show a Stopped state instead of a Disabled state in Endpoint health. If a user ran attempted to run these samples without localhost enabled, they would receive a “The given key was not present in the dictionary" error. This has been fixed. 

Install Instructions:

Running Powershell:

  • Open command prompt as administrator
  • Enter: powershell
  • Enter: set-executionpolicy allsigned
  • Change to the directory where the InstallPatch.ps1 script file is located
  • Enter: .\InstallPatch.ps1 > log.txt 
  • Enter "r" at prompt
  • When the script runs, it will prompt you if you want to upgrade each qualifying instance.  Type Y and press Enter if you want to update or N if you do not.
  • When the script completed, open the log.txt file and make sure that the Errors count at the end of the log is 0.
  • For each database at version 9, upgrade them to database version 10 by doing one of the following:
    • Using SQL Server Management Studio, run the 0010_UpdateTo3_5_0_34.sql contained in the Sql folder of the   Neuron ESB Install folder
    • Using Neuron ESB Explorer - open a configuration solution - navigate to Deployment > Databases and select the database - click the Test/Create button

The update could make changes to Test Client configuration which could be different than custom settings you might have set. To correct this:

  • open a Neuron Test Client
  • navigate to Tools > Connection Settings
  • update the values for Address, Zone and Service Identity as needed  

Manual update:

To manually install this update, do the following:

  • Stop the "Neuron ESB 3.5 Discovery Service" which should also stop the dependent Neuron ESB v3 instance services
  • Make backup copies of the following folders (examples assume that the Neuron ESB instances are installed in the child folder of the main install folder:   
    • - C:\Program Files (x86)\Neudesic\Neuron ESB v3   
    • - C:\Program Files\Neudesic\Neuron ESB v3 (or the location you installed Neuron ESB)   
    • - Each instance folder if not installed in C:\Program Files\Neudesic\Neuron ESB v3
  • Copy files from NeuronESB_3.5_CU1.zip "files\DiscoveryService" folder to C:\Program Files (x86)\Neudesic\Neuron ESB v3
  • Copy files from NeuronESB_3.5_CU1.zip "files\InstallPath" folder to C:\Program Files\Neudesic\Neuron ESB v3 (or the location you installed Neuron ESB)
  • For each Neuron ESB Instance being updated that is running x64 version of files, copy files from NeuronESB_3.5_CU1.zip "files\Instancex64" folder to instance folder
  • For each Neuron ESB Instance being updated that is running x86 version of files, copy files from NeuronESB_3.5_CU1.zip "files\Instancex86" folder to instance folder
  • For each database at version 9, upgrade them to database version 10 by doing one of the following:
    • Using SQL Server Management Studio, run the 0010_UpdateTo3_5_0_34.sql contained in the Sql folder of the   Neuron ESB Install folder
    • Using Neuron ESB Explorer
      • - open a configuration solution
      • - navigate to Deployment > Databases and select the database
      • - click the Test/Create button
  • Start the "Neuron ESB 3.5 Discovery Service" and each "Neuron ESB v3 ..." instance service
  • The update could make changes to Test Client configuration which could be different than custom settings you might have set. To correct this:
    • - open a Neuron Test Client
    • - navigate to Tools > Connection Settings
    • - update the values for Address, Zone and Service Identity as needed.

Download Locations:

NOTE: You must be logged into the Neuron ESB Support Center to view downloadable files.

The Neuron ESB 3.5 CU1 Update patch package can be downloaded directly from the Neuron ESB Support Center's 3.5 download section. Title: Neuron ESB 3.5 Cumulative Update 1 (CU1) - Patch, Filename is :NeuronPatch_3.5_CU1.zip Size: approx. 71MB

Alternatively, the Full Neuron ESB 3.5.1 CU1 installation package can be downloaded. This can be found in the Neuron ESB Support Center's 3.5 download section. Title: Neuron ESB 3.5 Cumulative Update 1 (CU1) - Full Install, Filename is: NeuronInstall_3.5_CU1.zip , Size: approx. 178MB

(0 vote(s))
This article was helpful
This article was not helpful

Comments (0)
Post a new comment
 
 
Full Name:
Email:
Comments:
Help Desk Software by Kayako Fusion