logoBack to home screen

D1 2.8 (01/04/2022) Release Notes

Overview

This release introduces the following key features and bug fixes:

Manuel Steps After upgrading from ADx x.x to D1 2.8

  1. Synchronize all repositories: This will prevent errors with "Conection check" and unlock new features (eSignature and AntiVirus)
  2. Migrate DSCA to gain better performace by running the following scripts:
  • Download and unzip file with scripts migrateStorage.zip
  • Open file migrateStorage.sh and populate fields in section "USER PARAMETER VALUES"
  • Run script migrateStorage.sh in terminal
  • To get status of migration open file migrateStorageStatus.sh and populate fields in section "USER PARAMETER VALUES"
  • Run script migrateStorageStatus.sh in terminal

Java Version

The on-prem installation packages for this release have been tested with JDK JDK 11.0.14 (package zulu11.54.23-ca-jdk11.0.14-linux_x64)

Changes in actual version

Nothing has been removed since previous release.

Changes in upcoming versions

In the upcoming version D1 2.9 the following change will appear:

  • the minimal Java Runtime to start up will be Java 17.
  • the legacy API including legacy migration capabilities will be completely removed.

Runtime Properties and Configuration changes

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

List of New Features and Improvements

IssuePrioritySummary Description
AD-321CriticalEnsure proper DB-Indices for StandardRepository and CacheAccess
AD-1007CriticalAPI error codes
AD-2429CriticalHarmonise Explorer column handling
AD-2444CriticalSupport for Virus Scanning when documents are imported
AD-2473CriticalAdd access to document via API
AD-2498CriticalAdd rotate feature to WebReader
AD-2564CriticalSupport disabling of loading external resources when converting emails
AD-2614CriticalAdd support for custom types for transfer-in/transfer-out
AD-2633CriticalProvide custom types via API
AD-2663CriticalADx goes D1
AD-2669CriticalAdd support for versions in transfer-in/out
AD-2700CriticalAdd hide/show for annotations
AD-2720CriticalAdd way to display custom properties of annotations
AD-2733CriticalAdd force comment on resolve
AD-2738CriticalWebviewer Handmode (pan)
AD-2745CriticalSelect property panel tab on loading should be configurable
AD-2782CriticalAdd service for DCSA migration
AD-2793CriticalCreate entry exists API
AD-2792CriticalImprove login time
AD-2031MajorAdd context for Notifications
AD-2534MajorExport selected rows
AD-2586MajorMake dropdown searchable
AD-2591MajorAdd formatting for comments
AD-2640MajorAdd split-pdf to Content workbench
AD-2714MajorAdd support for copying id using shortcut
AD-2253MajorAdd esignature support
AD-2667MajorCreate 'exists' service
AD-2884MajorAllow download multiple entries
AD-2658MajorAdd scrolling to select list
AD-2743MajorProvide documentation to avoid WebReader reloading
AD-1739MinorAllow downloading of a sub-document within a Compound Document
AD-1567MinorImprove about page for Explorer
AD-2746MinorAdd troubleshooting documentation for suddenly shut down

Bug Fixes

IssuePrioritySummary Description
AD-2672BlockerError using CMIS with custom types
AD-2677BlockerCMIS repo cannot be viewed
AD-2693BlockerCannot query previous versions on CMIS
AD-2719BlockerCannot delete annotation
AD-2863BlockerFollow security issue CVE-2021-44228
AD-2993BlockerGet rid of query
AD-2556CriticalCMIS repository cannot connect to ADx due to certification error
AD-2592CriticalCannot convert documents
AD-2596CriticalError on sync of custom repository
AD-2696CriticalPermissions wrong in case of Split view
AD-2701CriticalNo scrollbar in file list
AD-2721CriticalFix comment handling
AD-2771CriticalAnnotation gets wrong ID on migration
AD-2780CriticalAdd support for deleting entries in target systems on migration
AD-2781CriticalCannot migrate content with different users
AD-2803CriticalCannot display document
AD-2888CriticalChange to log4j 2.17.0
AD-2362MajorThe number of tabs in explorer should be configurable
AD-2523MajorConnection check fails if S3 user cannot list all buckets
AD-2675Major"Error while synchronizing repository ""Mic Test"""
AD-2708MajorWebReader: Button is sometimes there sometimes not
AD-2940MajorWebReader is displaying logically deleted documents
AD-2737MinorFix position of visibility
AD-2652MinorFix ToPdf for different formats
AD-2967MinorD1 does not recover on DB error

Updating Conversion and D1

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

Known Issues

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

Known Issues D1

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.

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

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 D1 console output. It doesn't affect D1 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 D1.

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.