Archive Service release notes

The Archive Service is a standalone service that operates on a different release cadence to the Corda platform.

The following table shows the compatibility of the Archive Service versions with Corda Enterprise:

Archive Service versionCorda Enterprise version
1.0.x4.10.x and below
1.1.x4.11.x and above

Archive Service 1.1.1 is a patch release focused on resolving issues.

  • When creating a backup table, the Archive Service created a backup table index name greater than 30 characters. This caused problems with Oracle 11.

  • When used with a Corda 4.11 node, it was possible for the Archive Service create-snapshot command to fail. This issue occurred when the node database was one of SQL Server, Oracle, or PostgreSQL, and the Archive Service was configured to use a backup schema.

  • When done immediately after a delete-vault operation, the import-snapshot failed to import transactions in an Archive Service regression.

In this release:

  • Version 1.1 is a compatibility release of the Archive Service. This and all future 1.1.x releases will only work with Corda 4.11.x and above and will not be compatible with Corda Enterprise 4.10.x and below. Use the latest Archive Service 1.0.x for Corda Enterprise 4.10.x and below.
  • In Corda Enterprise 4.11 a new column has been added to the node transactions table for additional signatures. The new Archive Service release includes this new column in its snapshot data.

Archive Service 1.0.6 is a patch release focused on resolving issues.

  • When the node database was Oracle and the Archive Service was configured to use a backup schema, it was possible for the Archive Service create-snapshot command to fail.

  • When creating a backup table, the Archive Service created a backup table index name greater than 30 characters. This caused problems with Oracle 11.

The Archive Service misunderstood reference states. As a result, the Archive Service could not archive a transaction if it referenced an unconsumed transaction and there were no unconsumed transactions that referenced it.

As of this release, the Archive Service marks a transaction, that only has outbound references (to unconsumed transactions) and no inbound references (from unconsumed transactions), as archivable. Any inbound references will still make a transaction unarchivable.

When using a Microsoft SQL Server database, an error was generated when using the vault-states filter with a positive value specified for the retentionDays parameter.

A new configuration option has been added which allows the Archive Service to skip transactions that have legacy contract states that cause exceptions during a JSON snapshot export. This configuration option is: ignoreSnapshotExportFailures: true.

By default, this value is false and the behaviour of the Archive Service is unchanged. However, if you are experiencing a TransactionDeserializationException or a JsonMappingException during the export of a JSON snapshot, this configuration option can be added to skip these transactions for a successful export. These transactions are not included in the export, but if a binary export is also created, all transactions can be preserved.

In this release:

  • The archiving support of tokens when they are moved between more than one party and then redeemed has been improved.
  • Logging of the Archiving tool has been increased to aid in troubleshooting.
  • The Archiving client can now connect to nodes which are set up to use RPC SSL connection settings.
  • Tables are now ordered by table name length in descending order to prevent foreign key constraints from being violated when deleting rows.

The Archive Service is now compatible with Ledger Graph V1.2.1 On Demand function.

Was this page helpful?

Thanks for your feedback!

Chat with us

Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.

Propose documentation improvements directly

Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.

We're sorry this page wasn't helpful. Let us know how we can make it better!

Chat with us

Chat with us on our #docs channel on slack. You can also join a lot of other slack channels there and have access to 1-on-1 communication with members of the R3 team and the online community.

Create an issue

Create a new GitHub issue in this repository - submit technical feedback, draw attention to a potential documentation bug, or share ideas for improvement and general feedback.

Propose documentation improvements directly

Help us to improve the docs by contributing directly. It's simple - just fork this repository and raise a PR of your own - R3's Technical Writers will review it and apply the relevant suggestions.