Skip to content
Orleans logoMicrosoft Orleans

GrainDirectoryOptions

class

Namespace: Orleans.Configuration

Supports all classes in the .NET class hierarchy and provides low-level services to derived classes. This is the ultimate base class of all .NET classes; it is the root of the type hierarchy.
public class GrainDirectoryOptions

Constructors

Properties

  • CacheSize Gets or sets the maximum number of grains to cache directory information for.
  • CacheTTLExtensionFactor Gets or sets the factor by which cache entry TTLs should be extended when they are found to be stable.
  • CachingStrategy Gets or sets the caching strategy to use. The options are None, which means don't cache directory entries locally; LRU, which indicates that a standard fixed-size least recently used strategy should be used; and Adaptive, which indicates that an adaptive strategy with a fixed maximum size should be used. The LRU strategy is used by default.
  • InitialCacheTTL Gets or sets the initial (minimum) time, in seconds, to keep a cache entry before revalidating.
  • LazyDeregistrationDelay Gets or sets the time span between when we have added an entry for an activation to the grain directory and when we are allowed to conditionally remove that entry. Conditional deregistration is used for lazy clean-up of activations whose prompt deregistration failed for some reason (e.g., message failure). This should always be at least one minute, since we compare the times on the directory partition, so message delays and clcks skues have to be allowed.
  • MaximumCacheTTL Gets or sets the maximum time, in seconds, to keep a cache entry before revalidating.
  • PartitionsPerSilo Gets or sets the number of directory partitions per silo.
  • RangeLeaseDuration Gets or sets the range lease duration applied after an ungraceful silo failure. This duration applies in two scenarios:
    • When a specific silo crashes ungracefully, grain lease holds prevent individual re-registration of its grains for this duration.
    • When a directory partition can not acquire a snapshot from a previous owner, range lease holds prevent new registrations in that whole range for this duration.
    For a declared-dead silo, the lease begins at its estimated failure time by subtracting the configured failure-detection window from the declaration time. Set this value to System.TimeSpan.Zero to disable range leases.

Fields