Release of Daml 2.8.1

Summary

This is a maintenance release that addresses several issues.

What’s New

Canton

Daml enterprise now supports replicating a party from one participant node to another for migration or to have multiple participants hosting the same party. The party replication documentation has the details.

We have improved the background journal cleaning to reduce database load by using smaller transactions to clean up the journal.

The metrics for the executor services have been removed since they were not actively used and could have a negative performance impact under high load.

We have reworked the reference configuration example examples/03_advanced_configuration. The updated example contains the full configuration which can be customized by removing unneeded parts. The installation documentation has been updated accordingly.

Fabric Driver

When the in-memory blocks exceed 5000, an unexpected shutdown could occur which stops further block processing.  This occurs in a rare situation where the driver is catching up after being stopped and the Fabric Ledger size has increased greatly while it was stopped.  The workaround when this occurred was to restart the sequencer.  This workaround is no longer needed because this has been fixed.

Daml SDK

The multiple DAR build feature could fail to properly parse daml.yaml files that contained only the parameters `sdk-version` and `build-options`, mistakenly treating them as full packages and trying to build them.

Installation or Download

The Daml 2.8.1 SDK has been released. You can install it using the command:  daml install 2.8.1.

The table below lists how you can download Daml Enterprise or individual components.

Daml Enterprise v2.8.1

Component

File download

Docker Image

SDK

Linux
macOS
Windows

digitalasset/daml-sdk:2.8.1

Canton for Daml Enterprise

Standalone JAR file

digitalasset-docker.jfrog.io/canton-enterprise:2.8.1

Daml Finance

GitHub Page

N/A

HTTP JSON API Service

Standalone JAR file

digitalasset-docker.jfrog.io/http-json:2.8.1

Trigger Service

Standalone JAR file

digitalasset-docker.jfrog.io/trigger-service:2.8.1

OAuth 2.0 middleware (Open-Source)

GitHub Page

digitalasset-docker.jfrog.io/oauth2-middleware:2.8.1

Participant Query Store

Standalone JAR file

digitalasset-docker.jfrog.io/participant-query-store:0.1.0

Trigger Runner

Standalone JAR file

digitalasset-docker.jfrog.io/trigger-runner:2.8.1

Daml Script

Standalone JAR file

digitalasset-docker.jfrog.io/daml-script:2.8.1

If you are using Oracle JVM and testing security provider signatures, you should note that the provided Canton JAR file embeds the BouncyCastle Provider as a dependency. To enable the JVM to verify the signature, you need to put the “bcprov JAR on the classpath before the Canton Standalone JAR. For example:

java -cp bcprov-jdk15on-1.70.jar:canton-with-drivers-2.8.1-all.jar com.digitalasset.canton.CantonEnterpriseApp

Note: The Docker images are designed to be minimal in size and attack surface, and are thus suitable for production use. Minimal images can sometimes make debugging difficult (e.g. no shell in the containers). For convenience, we provide “debug” versions of each of the above images, which you can access by appending “-debug” to the image tag (e.g. digitalasset-docker.jfrog.io/http-json:2.8.1-debug).