Akka.Cluster.Tools 1.4.19

Distributed publish/subscribe, client and singleton support for Akka.NET cluster

There is a newer version of this package available.
See the version list below for details.
Install-Package Akka.Cluster.Tools -Version 1.4.19
dotnet add package Akka.Cluster.Tools --version 1.4.19
<PackageReference Include="Akka.Cluster.Tools" Version="1.4.19" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Akka.Cluster.Tools --version 1.4.19
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Akka.Cluster.Tools, 1.4.19"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install Akka.Cluster.Tools as a Cake Addin
#addin nuget:?package=Akka.Cluster.Tools&version=1.4.19

// Install Akka.Cluster.Tools as a Cake Tool
#tool nuget:?package=Akka.Cluster.Tools&version=1.4.19
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Release Notes

Maintenance Release for Akka.NET 1.4**
Akka.NET v1.4.19 is a _substantial_ release that includes a number of critical Akka.Cluster fixes, baseline Akka.NET performance improvements, and entirely new dispatcher that has shown to improve performance when used across all of the major actor groups that run both inside the `/user` hierarchy and the `/system` actor hierarchy as well.
Akka.Cluster Improvements**
One of the most demanding issues of the v1.4.19 release was "[Akka.Cluster: quarantining / reachability changes appear to be extremely sensitive](https://github.com/akkadotnet/akka.net/issues/4849)" - and this is because debugging this issue touched so many different parts of Akka.Cluster.
We ultimately solved the problem - it is now quite feasible to rapidly scale an Akka.NET cluster from ~10 nodes to 50+ nodes without having a huge number of quarantines, accidentally downed nodes, and so on.
Here's the full set of fixes that went into resolving this issue:
[Added `PhiAccrualFailureDetector` warning logging for slow heartbeats](https://github.com/akkadotnet/akka.net/pull/4897)
[measure Akka.Cluster heartbeat timings, hardened Akka.Cluster serialization](https://github.com/akkadotnet/akka.net/pull/4934)
[`ClusterStressSpec` and Cluster Failure Detector Cleanup](https://github.com/akkadotnet/akka.net/pull/4940)
[Akka.Cluster: improve `HeartbeatNodeRing` performance](https://github.com/akkadotnet/akka.net/pull/4943)
[Akka.Cluster: Turned `HeatbeatNodeRing` into `struct`](https://github.com/akkadotnet/akka.net/pull/4944)
[Akka.Cluster: Configure duration for applying `MemberStatus.WeaklyUp`  to joining nodes](https://github.com/akkadotnet/akka.net/pull/4946)
[Akka.Cluster: Performance optimize `VectorClock`](https://github.com/akkadotnet/akka.net/pull/4952)
[Akka.Cluster: Refactored `Gossip` into `MembershipState`](https://github.com/akkadotnet/akka.net/pull/4968)
[Akka.Remote: Clean up bad outbound ACKs in Akka.Remote](https://github.com/akkadotnet/akka.net/pull/4963)
Akka.Cluster is now much more robust, faster, and capable of scaling up and down much more efficiently than in previous releases.
`ChannelExecutor` and Akka Performance Improvements**
In addition to improving Akka.Cluster, we also made substantial improvements to constructs found inside Akka.NET core itself:
[Perf optimize `ActorSelection`](https://github.com/akkadotnet/akka.net/pull/4962) - 20% throughput improvement, 25% memory consumption improvement
[fixed N-1 error inside `Mailbox`](https://github.com/akkadotnet/akka.net/pull/4964)
[Introduce `ChannelExecutor`](https://github.com/akkadotnet/akka.net/pull/4882)
In Akka.NET v1.4.19 we introduce an opt-in feature, the `ChannelExecutor` - a new dispatcher type that re-uses the same configuration as a `ForkJoinDispatcher` but runs entirely on top of the .NET `ThreadPool` and is able to take advantage of dynamic thread pool scaling to size / resize workloads on the fly.
In order to get the most use out of the `ChannelExecutor`, the default actor dispatcher, the internal dispatcher, and the Akka.Remote dispatchers all need to run on it - and you can see the latest configuration settings and guidance for that here in our documentation: https://getakka.net/articles/actors/dispatchers.html#channelexecutor
But a copy of today's configuration is included below - you can enable this feature inside your Akka.NET applications via the following HOCON:
```
akka.actor.default-dispatcher = {
executor = channel-executor
fork-join-executor { #channelexecutor will re-use these settings
parallelism-min = 2
parallelism-factor = 1
parallelism-max = 64
}
}
akka.actor.internal-dispatcher = {
executor = channel-executor
throughput = 5
fork-join-executor {
parallelism-min = 4
parallelism-factor = 1.0
parallelism-max = 64
}
}
akka.remote.default-remote-dispatcher {
type = Dispatcher
executor = channel-executor
fork-join-executor {
parallelism-min = 2
parallelism-factor = 0.5
parallelism-max = 16
}
}
akka.remote.backoff-remote-dispatcher {
executor = channel-executor
fork-join-executor {
parallelism-min = 2
parallelism-max = 2
}
}
```
We are looking for feedback on how well the `ChannelExecutor` works in real world applications here: https://github.com/akkadotnet/akka.net/discussions/4983**
Hyperion v0.10 and Improvements**
We also released [Hyperion v0.10.0](https://github.com/akkadotnet/Hyperion/releases/tag/0.10.0) and [v0.10.1](https://github.com/akkadotnet/Hyperion/releases/tag/0.10.1) as part of the Akka.NET v1.4.19 sprint, and this includes some useful changes for Akka.NET users who are trying to build cross-platform (.NET Framework + .NET Core / .NET 5) applications and need to handle all of the idiosyncrasies those platforms introduced by changing the default namespaces on primitive types such as `string` and `int`.
We have also introduced a [new `Setup` type](https://getakka.net/articles/concepts/configuration.html#programmatic-configuration-with-setup) designed to make it easy to resolve some of these "cross platform" serialization concerns programmatically when configuring Hyperion for use inside Akka.NET:
```csharp
#if NETFRAMEWORK
var hyperionSetup = HyperionSerializerSetup.Empty
.WithPackageNameOverrides(new Func<string, string>[]
{
str => str.Contains("System.Private.CoreLib,%core%")
? str.Replace("System.Private.CoreLib,%core%", "mscorlib,%core%") : str
}
#elif NETCOREAPP
var hyperionSetup = HyperionSerializerSetup.Empty
.WithPackageNameOverrides(new Func<string, string>[]
{
str => str.Contains("mscorlib,%core%")
? str.Replace("mscorlib,%core%", "System.Private.CoreLib,%core%") : str
}
#endif
var bootstrap = BootstrapSetup.Create().And(hyperionSetup);
var system = ActorSystem.Create("actorSystem", bootstrap);
```
See the full documentation for this feature here: https://getakka.net/articles/networking/serialization.html#cross-platform-serialization-compatibility-in-hyperion
To see the [full set of fixes in Akka.NET v1.4.19, please see the milestone on Github](https://github.com/akkadotnet/akka.net/milestone/49).
| COMMITS | LOC+ | LOC- | AUTHOR |
| --- | --- | --- | --- |
| 38 | 6092 | 4422 | Aaron Stannard |
| 13 | 2231 | 596 | Gregorius Soedharmo |
| 10 | 15 | 14 | dependabot-preview[bot] |
| 3 | 512 | 306 | zbynek001 |
| 3 | 417 | 1 | Ismael Hamed |
| 1 | 5 | 5 | Erik Følstad |
| 1 | 5 | 19 | Arjen Smits |
| 1 | 27 | 1 | Anton V. Ilyin |
| 1 | 21 | 33 | Igor |
| 1 | 1 | 1 | Cagatay YILDIZOGLU |

NuGet packages (4)

Showing the top 4 NuGet packages that depend on Akka.Cluster.Tools:

Package Downloads
Akka.Cluster.Sharding
Sharded actors with managed lifecycle for Akka.NET cluster
Akkatecture.Clustering
clustering library for akkatecture to enable distributed scenarios
AkkaDotModule.Webnori
Package Description
Shrimp.Akkling.Cluster.Intergraction
Package Description

GitHub repositories (2)

Showing the top 2 popular GitHub repositories that depend on Akka.Cluster.Tools:

Repository Stars
AElfProject/AElf
A scalable cloud computing blockchain platform
Lutando/Akkatecture
a cqrs and event sourcing framework for dotnet core using akka.net

Version History

Version Downloads Last updated
1.4.21 115 6/16/2021
1.4.21-beta1 264 6/4/2021
1.4.20 2,781 5/12/2021
1.4.19 3,038 4/28/2021
1.4.18 6,353 3/23/2021
1.4.17 3,449 3/10/2021
1.4.16 22,500 1/22/2021
1.4.15 1,007 1/20/2021
1.4.14 4,807 12/30/2020
1.4.13 1,531 12/16/2020
1.4.12 20,823 11/16/2020
1.4.11 7,920 11/5/2020
1.4.10 24,193 8/20/2020
1.4.9 20,091 7/21/2020
1.4.8 20,866 6/17/2020
1.4.7 5,242 5/27/2020
1.4.6 8,649 5/12/2020
1.4.5 4,722 4/29/2020
1.4.4 8,059 3/31/2020
1.4.3 6,542 3/18/2020
1.4.2 2,581 3/13/2020
1.4.1 4,920 3/11/2020
1.4.1-rc3 489 3/10/2020
1.4.1-rc2 260 3/10/2020
1.4.1-rc1 603 2/28/2020
1.4.0-beta4 1,927 1/28/2020
1.4.0-beta3 5,711 10/30/2019
1.4.0-beta2 2,809 9/23/2019
1.4.0-beta1 1,503 7/19/2019
1.3.18 10,510 3/9/2020
1.3.17 29,490 12/20/2019
1.3.16 6,931 11/14/2019
1.3.15 34,677 9/23/2019
1.3.14 19,417 7/30/2019
1.3.13 18,574 4/30/2019
1.3.12 16,497 3/14/2019
1.3.11 17,742 12/18/2018
1.3.10 17,291 11/2/2018
1.3.9 26,962 8/23/2018
1.3.8 23,336 6/5/2018
1.3.7 1,821 5/15/2018
1.3.6 3,932 4/17/2018
1.3.5 11,397 2/22/2018
1.3.4 3,663 2/1/2018
1.3.3 1,622 1/19/2018
1.3.2 21,045 10/21/2017
1.3.1 3,280 9/5/2017
1.3.0 2,378 8/11/2017
1.2.3 3,429 7/10/2017
1.2.2 1,117 6/28/2017
1.2.1 1,028 6/23/2017
1.2.0 17,716 4/12/2017
1.1.3.32-beta 2,812 1/23/2017
1.1.3.31-beta 685 1/23/2017
1.1.2.30-beta 4,263 9/22/2016
1.1.2.29-beta 690 9/22/2016
1.1.1.28-beta 1,121 7/16/2016
1.1.1.27-beta 676 7/16/2016
1.1.0.26-beta 773 7/7/2016
1.0.8.25-beta 1,135 4/26/2016
1.0.8.24-beta 750 4/26/2016
1.0.7.18-beta 969 4/6/2016
1.0.6 1,995 1/18/2016