Latest version: 6.0.16.153, SU-U16-9
Release date: June 28th 2016

The core components of EUCARIS contains the generic core functionalities, and these are deployed by EUCARIS System Updates. General information about System Updates can be found here.

This update contains all changes of previous Core updates (SU-Ux).

Requirements

This update requires:

  • an installation of EUCARIS release 6.0.0.18 (or higher) running on Windows server 2008/2012 using Microsoft SQL Server (all editions) or Oracle (all editions).
  • the latest version of the EUCARIS Configuration tool installed on the EUCARIS server.

Changes

Below enlists some of the most prominent features of the latest release.

  • Added message versioning functionality for asynchronous messages,
  • Added metadata services to support asynchronous message versioning,
  • Introduced the Eucaris.Core.Service.Scheduler which is able to run the required EUCARIS scheduled tasks. Currently the following tasks are implemented:
    • Queue Purge Task (was removed from the File Transfer Delivery Windows Service); responsible for purging the up- and download queue,
    • Service Message Version Request Task; responsible for periodically updating the asynchronous message versions supported of other connected member states.
  • Improved Service Configuration screen in the Management Client,
  • Improved performance of statistics report generation,
  • Improved error handling and logging for file transfer upload- and download,
  • Added ASP.Net roleprovider support in the EUCARIS Web client.
  • Improved performance and functionality of statistics report generation.
  • Added ability to generate reports for satellite countries.
  • This updates fixes an issue that has been raised in the ERRU statistics process. This issue is solved in both SU-U16-8 EUCARIS Core & SU-E54-3 ERRU extension.
    • Detailed information: In the current situation the EUCARIS Broker receives an ACK from the Central HUB, and gives an immediate HTTP OK. Subsequently it happened that the ACK could not be saved in EUCARIS, because the EUCARIS database was down (or any other reason), resulting in a retry of the same statistical records in a retry. The Central HUB does not accept this dataset because they already had received and processed them. Instead of an ACK the request to the Central HUB results in a NACK and this resulting in a process loop. This update contains a fix for this behavior.
  • Fixed rewriting of URLs in a SSLTermination scenario. It is now html source dependent on whether there are ajax libraries are found. For binary downloads no adjustments are made.

Upgrade notes

  • The previous System Update SU-U15 (which is included in this update) removes the Prüm functionality from the core. When updating from a System Update lower that SU-U15 and when the Prüm functionality is required, please make sure to also install the Prüm extension (System Update SU-E46 or higher).
  • Update SU-U16 introduces a metadata service which will request all authorised EUCARIS servers to provide the maximum supported asynchronous message versions once per 24 hours. By default EUCARIS will ask all known other member states, even if they are not migrated to SU-U16 yet. This will result in an application event log error message per country (not migrated to SU-U16) per 24 hours maximum. The error message “Request for service ServiceMessageVersionRequest in country [country] did not complete correctly. Request is aborted.” can therefore be ignored.

Known Issues

Below enlists the known issues of this release which the team is currently working on, or will be fixed in a next release.

  • No known issues in this release.

Database

This update contains the database scripts of all previous core updates and these scripts are only executed if any previous released scripts were not executed prior to this update.  The database scripts consists of Data Definition Language (DDL) instructions. Please make sure that the current configured database user (in the configuration tool) has sufficient rights to execute DDL scripts. Otherwise choose to manually execute these database scripts.

XSDs

This update contains the most recent XSDs which comply with the latest specifications.

Installation

To install this update a working EUCARIS release 6.0.0.18 (minimum) connected to sTESTA and the latest Configuration Tool installed on the EUCARIS server is required. EUCARIS Core System Updates are cumulative, meaning that it is not necessary to install any of the previous Core System Updates.  Previous installed Core System Updates don’t have to be uninstalled. For more information about EUCARIS System Updates, please refer to: https://www.eucaris.net/kb/system-updates. An installation of a System Update can normally be performed within 15 minutes.

The installation process is described in detail in the “EUCARIS – Installation and Operation Manual.pdf” document, available on this site.

Configuration

SU-U16 introduces a new metadataservice ‘ServiceMessageVersionRequest’ which requires to be configured as local EUCARIS service. Please review the documentation for detailed instructions here.

Change History

SU-U16-9

  • Released June 28th 2016,
  • Fixed rewriting of URLs in a SSLTermination scenario. It is now html source dependent on whether there are ajax libraries are found. For binary downloads no adjustments are made.

SU-U16-8

  • Released April 12th 2016,
  • This updates fixes an issue that has been raised in the ERRU statistics process. This issue is solved in both SU-U16-8 EUCARIS Core & SU-E54-3 ERRU extension.
    • Detailed information: In the current situation the EUCARIS Broker receives an ACK from the Central HUB, and gives an immediate HTTP OK. Subsequently it happened that the ACK could not be saved in EUCARIS, because the EUCARIS database was down (or any other reason), resulting in a retry of the same statistical records in a retry. The Central HUB does not accept this dataset because they already had received and processed them. Instead of an ACK the request to the Central HUB results in a NACK and this resulting in a process loop. This update contains a fix for this behavior.

SU-U16-7

  • Released: March 24th 2016
  • Fixed bug in web clients when EUCARIS is installed on the same server as the domain controller,
  • Fixed logging for LogType 2 and 4 flow in the EUCARIS Delivery Service,
  • Fixed ResponseResult not filled in ServiceLog.

SU-U16-6

  • Released: Februari 25th 2016
  • Added HR as country in the generic Web Client components,
  • [Statistics] Fixed issue where some database connections were not properly closed during report creation,
  • [Statistics] Fixes issue where the CBE statistics process was not initialised correctly.

SU-U16-5

  • Released: February 19th 2016
  • Improved performance and functionality of statistics report generation.
  • Added ability to generate reports for satellite countries.

SU-U16-4

  • Released: December 3rd 2015
  • Fixed issue in the EUCARIS Broker. Outbound requests via the Broker relied on case sensitive Message IDs/ Business case IDs for correlation of the response message. This is not according specification of the EC (ERRU / RESPER) where casing of these identifiers cannot be guaranteed. Fixed in this version of the EUCARIS Core.

SU-U16-3

  • Released: November 17th 2015
  • Fixed issue in the (extended) client logic function GetServiceInformation. This function was not functioning as expected.

SU-U16-2

  • Released: October 1st 2015
  • Fixed issue in new Asynchronous Message Versioning string to number conversion for MessageVersion in case of different localisations (‘,’ in stead of ‘.’).
  • Fixed CBE report creation process which ended with a null reference exception.

SU-U16

  • Released: September 17th 2015
  • Added message versioning functionality for asynchronous messages,
  • Added metadata services to support asynchronous message versioning,
  • Introduced the Eucaris.Core.Service.Scheduler which is able to run the required EUCARIS scheduled tasks. Currently the following tasks are implemented:
    • Queue Purge Task (was removed from the File Transfer Delivery Windows Service); responsible for purging the up- and download queue,
    • Service Message Version Request Task; responsible for periodically updating the asynchronous message versions supported of other connected member states.
  • Improved Service Configuration screen in the Management Client,
  • Improved performance of statistics report generation,
  • Improved error handling and logging for file transfer upload- and download,
  • Added ASP.Net roleprovider support in the EUCARIS Web client.

SU-U15

  • Released: June 30th 2015
  • Improved Batch Processor handling:
    • stability fixes,
    • more data available to resolve errors,
    • added ProcessingState=3 to the selection of downloadqueue files that need to be processed, fixing the bug that files were not reprocessed after resetting the retrieved flag,
    • enabled logging of messages retrieved by the Batch Processor.
  • Improved legacy / forwarding / asynchronous messages handling:
    • added default credential authentication for requests to (local) legacy services, but only if the usage of Client Certificate is disabled,
    • added extended logging for debuging FileTransfer issues,
    • changed asynchronous forwarding to preserve whitespace in forwarding the file content,
    • changed Receive and ReceiveAggregated methods to preserve whitspace in XML content.
  • Minor modifications to EUCARIS and CBE Statistics controls:
    • removed caching functionality from statistics overviews,
    • set default start and end date to previous month instead of previous half year,
    • incorrect LogType Filtering causing missing entries in Statistics. sCBE request where left out because selection was made on optional logstream/setting CoreMemberState_MemberStateInitiated instead of the mandatory CoreLegacy_CoreInitiated logging stream,
    • improved statistics retrieving proces to make sure the correct LogType and LogDirection parameters are used with servicelog queries.
  • Modifications to System update database scripts:
    • removing EUCARIS database name adn dbo schema from queries
  • Removed Prum logic/services from core. Functionality is replaced by the Prüm extension (SU-E46 or higher).

SU-U14

  • Released: February 20th 2015
  • Added generic statistics reporting functionality in the management client
    • To use the statistics reporting functionality the statistical report tools, deployed in system update ST-Ux are required
    • More information on EUCARIS statistics in the EUCARIS Statistics Manual available in the files section.
  • Logging fixes:
    • fixed: EUCARIS did not log messages when using GenericAsyncService.ReceiveAggregated (both ISO2 and EUCARIS Codes)
    • fixed: EUCARIS logs the ISO2 country code when using the iso2 interface of the GenericAsyncService.Receive. Now changed to EUCARIS Country Code

SU-U12

  • Released: October 29th 2014
  • Fixed an issue where EUCARIS was not able to acknowledge a FileTransfer message which contained an empty ‘ServiceName’ element (backwards compatibility).
  • Fixed the logging of a message when using the iso2 interface of the GenericAsyncService.Receive. Logging now logs the EUCARIS Code instead of the ISO2 code in the ServiceLog.
  • Fixed the logging of a message when using the ReceiveAggregated method of the GenericAsyncService (for both ISO2 and EUCARIS Codes). ReceiveAggregate did not stored messages in the ServiceLog.

SU-U11

  • Released: September 30th 2014
  • Added support for VHInfo response message version 3.0
  • Added the feature to do XML content validation (next to XML structure validation) for all services,
  • Added the EUCARIS Broker core to the EUCARIS Core deployment (SU-B5 is now withdrawn),
  • Improved performance of Secure Messages,
  • Improvement of the general logging framework of EUCARIS,
  • Improvement of log settings in the Management Client; clear distinction between synchronous and asynchronous services,
  • Fixed bug with Prum services and ISO2 when using the GenericService,
  • Fix for the “Root element is missing.” error when using the batchprocessor with uploaded files with FileTransferService and XML including processing instructions,
  • Removed all foreign key constraints to the ServiceLog in Oracle. MSSQL did not have foreign key constraint on this table. Foreign key constraints are not required on this table,
  • Several improvements and fixes for EUCARIS statistics [only available for EUCARIS Operations],
  • Improved error messages handling,
  • Many other minor fixes and improvements.

SU-U10

  • Released: March 6th 2014
  • Fixed the storage of the wrong date-time format when using Secure Messages (RESPER) in conjunction with an Oracle database. New Secure Messages will now be stored with the correct date-time format.

SU-U9

  • Released: Februari 11th 2014
  • Error handling: Improved error- handling and persisting in the Windows Eventlog from the core send and receive routines. The event log messages should have more clear messages.
  • Batch processor: Error handling is improved, and for certain situations using the concurrency options fixed.
  • Batch processor: ‘xml processing instruction’ bug fixed
  • Batch processor: Improved logic in regards to maximum number of consecutive errors and the aborting of possibly already queued requests to stop from being actually executed.
  • Logging; Added the restriction that logging of a message in the ServiceLog is mandatory for all services. No drivers- or vehicle data is being provided when EUCARIS was unable to persist to the message log, and an error is returned.
  • Management client: Fixed sorting of log settings in LogConfigurationAdministration control and fixed sorting of services in ServiceMultiSelect control and fixed the unwanted scrolling of the ServiceMultiSelect control after a selection was made.
  • Management client: Fixed strange menu effect where the menu of Home jumped up visually compared to when looking at one of the settings screens.
  • ClientLogic- and ExtendedClientLogic service: Updated GetAuthorization implementation, to allow the recipient country to be either Eucaris, DS, ISO2 or ISO3. The GetAuthorization webservice method is fully backwards compatible.

SU-U8

  • Released: November 28th 2013
  • VHInfo and DLInfo functionality removed from core (replaced by Extensions SU-E22 & SU-E23),
  • Adapted functionality to support DLInfo and VHInfo statistics processing,
  • Added additional indexes on the following database tables: ServiceLog, FileTransferDownloadQueue and FileTransferUploadQueue,
  • sCBE response is added as selectable message in the Management Client Log Viewer window,
  • Batch Processor now supports multiple running instances,
  • Bugfix for double byte characters (UTF-8) in the origanisation name causing problems in the LogViewer window,
  • Other small fixes and improvements.
  • Upgrade notes:
    • The VHInfo and DLInfo functionality is removed from the core and moved to the extensions VHInfo (SU-E22) and DLInfo (SU-E23). It is therefore important to download and install these updates if you are exchanging data under the EUCARIS Treaty.
    • This update adds table indexes to the table ServiceLog. Although the index is created ‘Online’ (causing no downtime), it is advised to execute this outside office hours due to the high volume of records in the ServiceLog table.
    • For the support of Prüm statistics and log collection, it might be possible that one or more additional indexes were created manually. Please review this and optionally adapt the SQL scripts as desired.
    • MSSQL Express editions do not support ‘Online’ index creation. Please adapt the MSSQL script SU-U8b.sql and change ‘ONLINE = ON’ to ‘ONLINE = OFF’. Due to the volume of records in the ServiceLog table, a downtime of 15 to 30 minutes is to be expected.

SU-U7

  • Released: October 14th 2013
  • New feature: EUCARIS now supports automatic forwarding of asynchronous messages received into the Download queue (described in paragraph 6.1.1 of the Installation and Operation manual),
  • New feature: Added Statistics triggers, supporting ERRU and RESPER statistics gathering process (described in paragraph 6.1.2.2 of the Installation and Operation manual),
  • New feature: Possibility to secure the communications with Legacy Services using Client Certificates (contact EUCARIS Operations for more information about this feature),
  • New feature: Added the possibility to limit the logged information for privacy and sizing issues. Currently only implemented in the IVI extension.
  • Improvement: The Configuration files for extensions are now stored on one central location (described in the documentation of the regarding extension),
  • Update of the SimpleTypeDefinitions XSD for the addition of Croatia.
  • Several other small bug fixes.
  • Management Client improvements:
    • Added sorting on the Service Configuration page (Management client)
    • Added the new services (IVI/CBE) to the logviewer functionality
    • Removed a minor bug where in some circumstances async response messages could not be found anymore

SU-U6

  • Released: May 28th 2013
  • New feature: Added “Organisation Name” to EUCARIS user profiles,
  • New feature: Statistics gathering functionality,
  • New feature: Batch-processor for splitting multiple requests in a batch to single synchronous requests,
  • Removed VHOH functionality from the Core, and created a separate extension for this functionality (SU-E12),
  • Bugfix: Result grid of the Log Viewer. Paging was not working as it should.
  • Bugfix: Logging of validation errors is now capped to 20kb per message since the eventlog has a limit of 32kb per event,
  • Improved: Error handling of the EUCARIS Delivery Windows Service,
  • Several other small bug fixes.

SU-U5

  • Released: Februari 26th 2013
  • New feature: Core mechanism for Secure Message functionalities, which can be used on a ‘per service’ base.
  • New feature: Authorization functionality based on sub-menu level in the EUCARIS web client.
  • New feature: Extended logging enabled for all existing services.
  • Several small bug fixes. Please review SU-Ux_Changes for more details.

SU-U4

  • Released: November 28th 2012
  • New feature: EUCARIS is now able to purge the File transfer queues based on the specific asynchronous service. The purging behavior is now configurable using the EUCARIS management client.
  • New feature: Implemented ExtendedLogging according the specs of Use Case-4: Log EUCARIS Message
  • Several fixes regarding the use of MessageId and MessageRefId in the EUCARIS core (please review SU-Ux_Changes for more details).

SU-U3

Released: September 18th 2012

New Feature 16:

This update adds the EUCARIS Generic Asynchronous Service, the GenericAsyncService. This service functions as a single point of entry for all asynchronous messages and has the following properties:

  • Simplifies the sending of an asynchronous message without the need for wrapping to FileTransfer messages or encoding to base64,
  • get an index of received messages for specific asynchronous services,
  • receive an asynchronous message without the need for wrapping from FileTransfer messages or encoding from base64.

New Feature 20:

In this update the ability to communicate using ISO 3166-1 alpha-2 (ISO-2) country codes is made possible. The connecting (custom) client is able to choose which code base to use (based on endpoint URL of the EUCARIS public services), and the EUCARIS core translates all applicable country codes from EUCARIS Country Codes to ISO 3166-1 alpha-2 (ISO-2). For more information about this feature, please contact EUCARIS Operations.

New Feature 21:

This update adds the ability to send a Multiple Country Inquiry (MCI) to a selection of countries instead of all authorized countries. This update is primarily required for RESPER requests, but is backwards compatible for all EUCARIS requests supporting MCI (using the Generic Service). For more information about this feature, please contact EUCARIS Operations.

Fix / Patch 18 & 19:

This update also contains important security and performance fixes. In some occasions the DEBUG or TRACE switch is enabled for one or more EUCARIS applications. This update changes the folowing configuration elements:

  • If the element <compilation debug=”true”/> is found in any of the EUCARIS application configurations, it is set to <compilation debug=”false”/>,
  • if the element <trace enabled=”true” /> is found in any of the EUCARIS applications, it is set to <trace enabled=”false” />.

SU-U2

Released: May 10th 2012

This update adds the EUCARIS Log Viewer (which was a seperate product) as integral part of the EUCARIS Management client. The integrated is only available for the users which are included in the following Windows group: “EucarisII Logviewer Users”. The previous version of the Log Viewer can be removed after installation of SU-U2.

This update also contains several fixes and additions to the EUCARIS ServiceLog to better distinguish each log entry and facilitate statistics for ERRU and RESPER. Added columns are:

  • LogDirectionId. Contains data if the message is a request or response
  • LogTypeId. Contains the stream of the message. (Client -> Core, Core -> Core MS , Core MS -> Core, Core -> Legacy, Legacy -> Core)
  • SenderName. Contains the (original) sender name from the requesting country. This data is copied from the XML Header Element <SenderName>.
  • ResponseTime. Contains the total round-trip time from the request to the received response. Only used for ERRU and RESPER.
  • ResponseResult. Contains the result of the response. (Unknown, Found, NotFound, Accepted, Error, Timeout, Request). Only used for ERRU and RESPER.
  • PrimairySearchKey. Contains the primairy searchkeys for the request. Only used for ERRU and RESPER.
  • OtherSearchKeys Contains the other relevant searchkeys for the request. Only used for ERRU and RESPER.

For a more detailed description of all changes, please download the changes document: SU-Ux_Changes.

SU-U1

Released: April 2nd 2012

This update contains a number of patches for problems we have detected, as well as some new features to support all upcomming functionalities. One of the major improvement is the ability to translate country codes from ISO2, ISO3, Distinguished Signs (DS) code to EUCARIS country/organisation codes. This new functionality is particularly useful to discover the correct EUCARIS country/organisation code when more than one EUCARIS instance is installed in a particular country (i.e. L and L2 or RO and RO2).

For a more detailed description of all changes, please download the changes document: SU-Ux_Changes.