logoBack to home screen

ADx 2.7 (09/08/2021) Release Notes

Overview

This release introduces the following key features and bug fixes:

For more details on each feature, see List of New Features and Improvements

Java Version

ADx 2.7 on-prem installation packages support Java 8 and 11. We recommend Java 11. Within a major Java version, it is fine to update to the latest release (for example 11.0.x) to receive latest available bug fixes and security patches.

The on-prem installation packages for this release have been tested with JDK JDK 11.0.12 (package zulu11.50.19-ca-jdk11.0.12-linux_x64)

Changes in upcoming versions

Nothing is going to be removed in future release.

Runtime Properties and Configuration changes

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

General Features

  • Copy folder supports coping of its content.

  • Conversion is enhanced so it respact paper size for Pover point and Excel files.

  • Documents are exposed via API.

  • Diagnostic packages of all ADx nodes can be downloaded with single click.

  • You can send content by email to yourself.

  • All conversion operations are working on repository level.

REST

  • You can do search of custopm types with custom properies on any kind of repository (Standard or External).

UI Changes

  • Validation is improved for property constrains.
  • You can save seach on workbench.
  • Added shorcuts for UI navigation.
  • Added cheatsheet for UI navigation shortcuts

WebReader

  • Custom properties are added to WebReader.
  • You can swap documents in split view.
  • Added badges for annotations which count open tasks.
  • Allow downloading of a sub-document within a Compound Document.
  • Sorting/searching of annotations in WebReader

Documentation

Performance

Runtime Properties and Configuration changes

ADx

No new runtime properties for ADx in this release.

Conversion

No new runtime properties for the Conversion service in this release.

Tribefire

List of New Features and Improvements

The following features are added in this release:

Feature NumberPrioritySummaryDescription
AD-1796StoryCriticalCopy folder including content
AD-2404StoryCriticalConversion should respect paper size in ppt and xls
AD-2473StoryCriticalAdd access to document via API
AD-2397StoryCriticalAdd complete path information to copy/move feature
AD-2463StoryCriticalAdd properties to WebReader
AD-2403StoryCriticalAdd multi custom property search on CMIS/DCTM
AD-2346StoryCriticalAdd search for custom types
AD-2398StoryCriticalImprove search dialogue
AD-1479StoryCriticalOne click download of diagnostic package
AD-2486TaskCriticalAdd TOC per Excel worksheet
AD-2043TaskCriticalAdd Email support for sending content
AD-2343StoryMajorAdd swap documents in split view
AD-2202TaskMajorAction New implement with ActionFolderContent
AD-2371TaskMajorImprove validation of property constraints
AD-2373TaskMajorMake workbench/save search panel width configurable
AD-2275TaskMajorShow Document Comments in Explorer
AD-2277TaskMajorAdd badge for annotations
AD-1739StoryMinorAllow downloading of a sub-document within a Compound Document
AD-651StoryMinorCreate shortcuts for UI navigation
AD-2090TaskMinorSorting/searching of annotations in WebReader
AD-1767TaskMinorAdd cheatsheet for Shortcuts
AD-2166TaskMinorAll conversion operations should work on Repo level

Bug Fixes

IssuePrioritySummaryDescription
AD-2505BugBlockerLogin form sends user/password in plaintext as GET parameter to server
AD-1168BugBlockerREAD ACL does not properly restrict user priviledges
AD-2528BugCriticalMultiple content references in templateMerge not working
AD-2506BugCriticalCreateContents/DeleteContents not responding list of touched entries
AD-2362BugCriticalThe number of tabs in explorer should be configurable
AD-1957BugCriticalS3 listing of buckets may not be permitted
AD-1898BugMajorMin and Max length metadata not respected on initial upload
AD-2247BugMajorChange log-path of logs causing error
AD-1993BugTrivialGetting Log of some time period causing exception

Updating Conversion and ADx

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

Known Issues

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

Known Issues ADx

TicketSEVERITYDescription
https://jira.braintribe.com/browse/AD-321CRITICALAdd missing indices
https://jira.braintribe.com/browse/AD-348MAJORADx Admin: Repository Modification-Status not updated on Update
https://jira.braintribe.com/browse/AD-1898MAJORMin and Max length metadata not respected on initial upload
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

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.

Exteranal repositories pointing to the same source

Issues with content cache appear due to cache database being shared between repositories if there are several External repositories pointing to the same source (and same root folder). To overcome this you need to change cache table prefix for each External repository.

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.

Annotations are deleted on removing representations

Annotations are bound to cache files, in order to prevent their loss please set Representations TTL to 100y.

Known Issues Conversion

TicketSEVERITYDescription
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/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.

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.