ADx 2.5.283 (22/1/2021) Release Notes

Overview

This is a patch release to ADx 2.5. Here's a list of new features and issue fixes:

• A new mapRecordImports field has been introduced in TemplateSpecifications in apply-template and merge-templates requests. This allows to use the same style templates for different requests. However, if the main template specification contains a key with a value different from the value of the same key inside the mapRecordImports, then the value in the main map record takes precedence. For more information, see Importing mapRecords into TemplateSpecifications.

• ADx now enables you to download contents as a .zip file. Content IDs remain unchanged. Also, you can upload a zip file you have previously downloaded. This imports contents and replaces contents that have the same IDs as the uploaded ones. To download and upload contents, call the following APIs:

  • /access.adx.content.{repositoryName}/v1/entries/transfer-out
  • /access.adx.content.{repositoryName}/v1/entries/transfer-in See Transferring Contents a ZIP Files from and into ADx.

See List of New Features and Improvements and Bug Fixes for more details.

Java Version

This release was tested with JDK 11. Download here.

Runtime Properties and Configuration changes

No runtime properties have been added, changed or removed in this release.

List of New Features and Improvements

The following features are added in this release:

Feature Number	Priority	Summary	Description
AD-1946	Critical	Support for common (imported) MapRecords in Apply/Merge Template calls	Converting Contents
AD-1951	Critical	Add content export/import	See Transferring Contents as ZIP Files from and into ADx

Bug Fixes

Issue	Priority	Summary	Description
AD-1957	Critical	S3 listing of buckets may not be permitted	When accessed by a user who did not have the proper permissions, the listing of S3 buckets would be broken. This issue has been resolved.
AD-1947	Critical	Order of templates in merge-templates is not kept in result	Previously, when calling the merge­-templates endpoint, the order of templates in the result template was set automatically. Now, ADx uses the template order as it is set in the merge-templates request or specified in the Merge Templates action in ADx UI.
AD-1952	Critical	Error on exporting repository in cloud environment	An error was displayed when attempting to export repositories in cloud environment. This issue has been resolved.
AD-1945	Critical	Standard Content Icons will be lost after tmp Cleanup	Content icons were accidentally deleted upon the Conversion service cleanup. This issue has been resolved.
AD-1953	Major	Merge API does not work	An error occurred when calling the Create Content, content, and Merge Templates, merge-templates, APIs. This issue has been resolved.
AD-1884	Conversion (remote) health button doesn't work.	After clicking on Conversion Health button a new tab was opened with broken link. This issue has been resolved.

Updating Conversion and ADx

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

• Updating Conversion
• Updating ADx

Known Issues

Below you can find a list of problems we're still working on.

Known Issues ADx

Ticket	SEVERITY	Description
https://jira.braintribe.com/browse/AD-321	CRITICAL	Add missing indices
https://jira.braintribe.com/browse/AD-348	MAJOR	ADx Admin: Repository Modification-Status not updated on Update
https://jira.braintribe.com/browse/AD-1898	MAJOR	Min and Max length metadata not respected on initial upload
https://jira.braintribe.com/browse/AD-342	MINOR	Hibernate warnings in the log files
https://jira.braintribe.com/browse/AD-341	MINOR	Java warnings during for Java 9 and later
https://jira.braintribe.com/browse/AD-311	MINOR	Oracle - DbLockManager prints Oracle constraint message

Reimporting an Existing Repository Requires UI Reload

In some cases, when reimporting an existing repository, repository properties are not rendered correctly. To make sure properties are rendered correctly, refresh your browser after each import.

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.

Min and Max length metadata not respected on initial upload

String length checks are only applied when values are updated but not on the initial upload.

Known Issues Conversion

Ticket	SEVERITY	Description
https://jira.braintribe.com/browse/AD-338	CRITICAL	Introduce roles for conversion
https://jira.braintribe.com/browse/AD-337	MAJOR	Make TF Conversion workbench consistent to ADx
<!--	https://jira.braintribe.com/browse/AD-501	MAJOR
https://jira.braintribe.com/browse/EXTDOCS-71	MINOR	Fix 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.

Tomcat Shutdown Warning

The following warning is sometimes thrown by Tomcat when stopping the service:

./tribefire-console-stop.sh
...
Tomcat did not stop in time.
PID file was not removed.
To aid diagnostics a thread dump has been written to standard out.
Tribefire Host stopped.

This happens when shutdown takes longer than Tomcat expects. Shutdown may take several minutes, which will result in this message being printed out. This warning could appear on both Conversion and ADx.

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.