logoBack to home screen

ADx 2.1 (17/02/2020) Release Notes

This release introduces a number of key updates, including a major WebReader update, callback parameters on REST conversion services, the possibility to configure custom content types, and more.

This release has been patched - see Patch Release Notes for details.


You can install this release from the provided package. Follow Installation Instructions if you're installing from scratch.

Updating Conversion and ADx

For information on how to update previously installed Conversion and ADx, see the following:

New Features and Improvements

The following features are provided in this release:

https://jira.braintribe.com/browse/AD-695Conversion Callback Support in ADx - see documentationCritical
https://jira.braintribe.com/browse/AD-386ADx Admin: Custom Types Management - see documentationCritical
https://jira.braintribe.com/browse/AD-327DCTM Repository: Support for Documentum 6Critical
https://jira.braintribe.com/browse/AD-818Backup & Restore scripts - see documentationMajor
https://jira.braintribe.com/browse/AD-625MetaData Export Support - see documentationMajor
https://jira.braintribe.com/browse/AD-566Drag & Drop Support for EntitiesMajor
https://jira.braintribe.com/browse/AD-726Add missing conversion mimetypesMajor
https://jira.braintribe.com/browse/AD-570UI improvements - Open Action & GotoModelPath Command, see UI ImprovementsMajor
https://jira.braintribe.com/browse/AD-764Version Switch in Documentation SiteMajor

UI Improvements

Full Breadcrumb Structure in Explorer

You can now use the Go to action to open the contents of a folder:

When you open the folder, a full structure is shown in the breadcrumb:

Visual Grouping in Thumbnail View

Items in Grid View are now grouped by content type:

Note that you can configure custom types now! For details, see Configuring Custom Types.

New WebReader

New WebReader is now available:

For information on how to use WebReader features, see Browsing Contents in WebReader.

Versioning in Documentation

You will notice that this site has a version switch in the top-right corner. Use this switch to find content relevant for a specific version (2.0 and 2.1 at the time of this release).

Bug Fixes

The following known issues were resolved.

https://jira.braintribe.com/browse/AD-347MAJORADx Admin: Repository Deletion not properly working

Configuration changes

No changes made to example-installation-settings file (only minor comment adjustments).

New Runtime Properties

The following runtime properties were added in this release:

PropertyDescriptionDefault Value
ADX_AUTO_SYNC_REPOSITORIESOptionally, you can add this property to your installation settings file. When set to true, repositories are automatically synchronized after ADx installation.false

Changed Runtime Properties


Removed Runtime Properties


Known Issues

A list of problems we're aware of and working on.

Known Issues ADx

https://jira.braintribe.com/browse/AD-321CRITICALAdd missing indices
https://jira.braintribe.com/browse/AD-354CRITICALADx Admin: Problem when synchronizing Type Definitions form DCTM/CMIS
https://jira.braintribe.com/browse/AD-350CRITICALADx Admin: Repository Activation state sometimes not correct in case of errors
https://jira.braintribe.com/browse/AD-348MAJORADx Admin: Repository Modification-Status not updated on Update
https://jira.braintribe.com/browse/AD-330MAJORADx Content: Missing ADx context information for conversion jobs
https://jira.braintribe.com/browse/AD-342MINORHibernate warnings in the log files
https://jira.braintribe.com/browse/AD-341MINORJava warnings during for Java 9 and later
https://jira.braintribe.com/browse/AD-311MINOROracle - DbLockManager prints Oracle constraint message

Cannot migrate legacy contents simultaneously

Due to cache database being shared between repositories, it's not possible for now to run multiple migration jobs from a single legacy repository at the same time. You need to wait for the previous migration to finish before running a new one.

Known Issues Conversion

https://jira.braintribe.com/browse/AD-338CriticalIntroduce roles for conversion
https://jira.braintribe.com/browse/AD-337MAJORMake TF Conversion workbench consistent to ADx
https://jira.braintribe.com/browse/AD-501MAJORtf-conversion user has the admin role assigned
 https://jira.braintribe.com/browse/EXTDOCS-71MINORFix wrong encoding on opening resource in Browser

Minor Warnings

StatusLogger Error

The following error currently appears in ADx console output. It doesn't affect ADx functionality or performance.

ERROR StatusLogger No log4j2 configuration file found. Using default configuration: logging only errors to the console.
  Set system property 'org.apache.logging.log4j.simplelog.StatusLogger.level' to TRACE to show Log4j2 internal initialization logging.

Java Warnings

When using Java 9 or later, the following warning may appear in application logs and also during installation procedure:

WARNING: An illegal reflective access operation has occurred
WARNING	: Illegal reflective access by com.braintribe.model.processing.itw.asm.AsmClassLoaderWrapper$1 (file:/path/to/instant-type-weaving-1.0.28.jar) to method java.lang.ClassLoader.defineClass(java.lang.String,byte[],int,int)
WARNING: Please consider reporting this to the maintainers of com.braintribe.model.processing.itw.asm.AsmClassLoaderWrapper$1
WARNING: Use --illegal-access=warn to enable warnings of further illegal reflective access operations
WARNING: All illegal access operations will be denied in a future release

Ticket: https://jira.braintribe.com/browse/AD-341

Hibernate Warnings

The log files may contain Hibernate-related warnings. They can be identified based on the fully qualified class which starts with org.hibernate, as in:

WARNING org.hibernate.tuple.entity.EntityMetamodel 'HHH000084: Entity [com.braintribe.model.user.User] is abstract-class/interface explicitly mapped as non-abstract; be sure to supply entity-names' [TribefireServices-2.0:tribefire-services#initialize,ApplicationLoader:/tribefire-services#initialize]

Ticket: https://jira.braintribe.com/browse/AD-342

These warnings do not affect the functionality of the application and can be ignored. We are working on a fix.