Skip to content

Latest commit

 

History

History
238 lines (165 loc) · 12.4 KB

RELEASE_NOTES.md

File metadata and controls

238 lines (165 loc) · 12.4 KB
Raw

1.5.32 December 23rd 2024

Breaking Change Notice

Due to breaking changes in MongoDb.Driver v3.0.0, from this point forward, Akka.Persistence.MongoDb releases WILL NOT support:

  • MongoDb server v3.6 and earlier
  • Projects that targets .NET Core 2.x and lower
  • Projects that targets .NET Framework 2.7.1 and lower
  • LINQ2 provider
  • TLS 1.0 and 1.1

Driver Behavior Change And Workaround

There is a behavior change in MongoDb.Driver v3.0.0 where it would use the DNS resolved server host address when it actually tries to connect to the server. This is problematic if your application lives inside a container and hard code your MongoDb server address inside the connection string.

Example:

  • Server address used in connection string: "host.docker.internal:27017"
  • Actual server address being used in MongoDb connection: "127.0.0.1:27017"

The workaround is to add "directConnection=true" in your connection string.

MongoDb.Driver Upgrade Advisories

MongoDb.Driver 3.0.0 release note: https://github.com/mongodb/mongo-csharp-driver/releases/tag/v3.0.0

MongoDb.Driver 3.0.0 Upgrade advisory: https://www.mongodb.com/docs/drivers/csharp/v3.0/upgrade/v3/

1.5.32-beta1 December 5th 2024

Breaking Change Notice

Due to breaking changes in MongoDb.Driver v3.0.0, from this point forward, Akka.Persistence.MongoDb releases WILL NOT support:

  • MongoDb server v3.6 and earlier
  • Projects that targets .NET Core 2.x and lower
  • Projects that targets .NET Framework 2.7.1 and lower
  • LINQ2 provider
  • TLS 1.0 and 1.1

MongoDb.Driver 3.0.0 release note: https://github.com/mongodb/mongo-csharp-driver/releases/tag/v3.0.0

MongoDb.Driver 3.0.0 Upgrade advisory: https://www.mongodb.com/docs/drivers/csharp/v3.0/upgrade/v3/

1.5.31 December 4th 2024

Version Notice

Due to breaking changes in MongoDb.Driver v3.0.0, This release will be the last Akka.Persistence.MongoDb that will support:

  • MongoDb server v3.6 and earlier
  • Projects that targets .NET Core 2.x and lower
  • Projects that targets .NET Framework 2.7.1 and lower
  • LINQ2 provider
  • TLS 1.0 and 1.1

1.5.30 October 3rd 2024

Breaking Change Notice

The MongoDb driver 2.28.0 is now strongly-named which may affect your project(s). You can read more about this decision here.

1.5.29 October 1st 2024

Note

Deprecated

Deprecated due to Akka.NET 1.5.29 deprecation. Please use 1.5.30 instead.

Breaking Change Notice

The MongoDb driver 2.28.0 is now strongly-named which may affect your project(s). You can read more about this decision here.

1.5.28 September 11th 2024

Support For Large (Greater Than 16 Megabytes) Snapshot Store

Note

GridFS is considered as an advanced feature, it will not be supported by Akka.Hosting.

We added a new SnapshotStore that supports GridFS. To use it, you will need to set it through manual HOCON setting.

akka.persistence.snapshot-store.mongodb.class = "Akka.Persistence.MongoDb.Snapshot.MongoDbGridFsSnapshotStore, Akka.Persistence.MongoDb"

1.5.26 July 15th 2024

1.5.12.1 September 15 2023

Breaking Behavior Change

In this version, we're turning transaction on by default. If you're more concerned with database write and read performance compared to data consistency and correctness, you can move back to the old behavior by setting this flag in the HOCON configuration:

akka.persistence.journal.mongodb.use-write-transaction = off
akka.persistence.snapshot-store.mongodb.use-write-transaction = off

Or by setting them inside the hosting options:

var journalOptions = new MongoDbJournalOptions(true) 
    {
        UseWriteTransaction = false
    };
var snapshotOptions = new MongoDbSnapshotOptions(true)
    {
        UseWriteTransaction = false
    };

1.5.12 August 10 2023

1.5.8 June 30 2023

1.5.7 May 31 2023

1.5.1.1 March 24 2023

1.5.1 March 21 2023

1.5.0 March 03 2023

1.4.48 January 24 2023

1.4.40 July 27 2022

1.4.40-RC1 July 1 2022

1.4.39 June 6 2022

1.4.38-beta2 May 27 2022

1.4.38-beta1 April 15 2022

1.4.37 April 15 2022

1.4.31 December 21 2021

1.4.25 September 9 2021

1.4.21 July 07 2021

1.4.19 May 04 2021

Please read the Akka.Persistence.MongoDb README.md on how to use the new MongoDbPersistenceSetup feature to programmatically configure your MongoDbClient.