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 Number | Priority | Summary | Description |
|---|---|---|---|
| AD-1796 | Story | Critical | Copy folder including content |
| AD-2404 | Story | Critical | Conversion should respect paper size in ppt and xls |
| AD-2473 | Story | Critical | Add access to document via API |
| AD-2397 | Story | Critical | Add complete path information to copy/move feature |
| AD-2463 | Story | Critical | Add properties to WebReader |
| AD-2403 | Story | Critical | Add multi custom property search on CMIS/DCTM |
| AD-2346 | Story | Critical | Add search for custom types |
| AD-2398 | Story | Critical | Improve search dialogue |
| AD-1479 | Story | Critical | One click download of diagnostic package |
| AD-2486 | Task | Critical | Add TOC per Excel worksheet |
| AD-2043 | Task | Critical | Add Email support for sending content |
| AD-2343 | Story | Major | Add swap documents in split view |
| AD-2202 | Task | Major | Action New implement with ActionFolderContent |
| AD-2371 | Task | Major | Improve validation of property constraints |
| AD-2373 | Task | Major | Make workbench/save search panel width configurable |
| AD-2275 | Task | Major | Show Document Comments in Explorer |
| AD-2277 | Task | Major | Add badge for annotations |
| AD-1739 | Story | Minor | Allow downloading of a sub-document within a Compound Document |
| AD-651 | Story | Minor | Create shortcuts for UI navigation |
| AD-2090 | Task | Minor | Sorting/searching of annotations in WebReader |
| AD-1767 | Task | Minor | Add cheatsheet for Shortcuts |
| AD-2166 | Task | Minor | All conversion operations should work on Repo level |
Bug Fixes
| Issue | Priority | Summary | Description |
|---|---|---|---|
| AD-2505 | Bug | Blocker | Login form sends user/password in plaintext as GET parameter to server |
| AD-1168 | Bug | Blocker | READ ACL does not properly restrict user priviledges |
| AD-2528 | Bug | Critical | Multiple content references in templateMerge not working |
| AD-2506 | Bug | Critical | CreateContents/DeleteContents not responding list of touched entries |
| AD-2362 | Bug | Critical | The number of tabs in explorer should be configurable |
| AD-1957 | Bug | Critical | S3 listing of buckets may not be permitted |
| AD-1898 | Bug | Major | Min and Max length metadata not respected on initial upload |
| AD-2247 | Bug | Major | Change log-path of logs causing error |
| AD-1993 | Bug | Trivial | Getting 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
| 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.
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
| 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/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.