Cluster Information
One of the core concepts of GigaSpaces processing units is the fact that the clustering topology of the processing unit is determined at deployment time. Therefore, when building a processing unit, there is almost no need to be aware of the actual clustering topology with which the processing unit is deployed. However, in some cases you may want your processing unit to be aware of it. This mechanism is also used internally by the platform to maintain the clustering information when deploying a space for example.
Available Cluster Information
As mentioned above the cluster information is passed to the components of each processing unit instance via an instance of the GigaSpaces.Core.ClusterInfo class, which holds the following information:
| Attribute Name | Description |
|---|---|
| Schema | If the processing unit contains an embedded space, the cluster schema of that space |
| NumberOfInstances | The number of instances of the processing unit. If the processing unit contains an embedded space, denotes the number of primary instances |
| NumberOfBackups | If the processing unit contains an embedded space with backups, denotes the number of backups per primary instance The number of backups per partition is zero or one. |
| InstanceId | A value between 1 to numberOfInstances, denoting the instance ID of the processing unit instance |
| BackupId | A value of zero or 1, denoting the backup ID of the processing instance. If the processing unit instance is not a backup, then null is returned. |
| RunningNumber | A running number of the processing unit instance instance. Takes into account different topologies and provides a unique identifier (starting from 0) of the processing unit instance within the cluster |
null value for one of these properties means that they are not applicable for the processing unit instance at hand or the used deployment topology.
Obtaining the Cluster Information
The cluster information is injected to the processing unit container at runtime and is available throughout it's lifecycle using the singleton ProcessingUnitContainer.Current.ClusterInfo.
