Skip to content

Commit 16cabbb

Browse files
committed
Add section explaining dynamically starting/stopping cluster management services
Signed-off-by: Anthony Floeder <anthony.floeder@hpe.com>
1 parent 8763fae commit 16cabbb

1 file changed

Lines changed: 37 additions & 0 deletions

File tree

docs/guides/ha-cluster/readme.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,7 @@ NNF software supports provisioning of Red Hat GFS2 (Global File System 2) storag
3131
- [Common Issues](#common-issues)
3232
- [Testing Fence Operations](#testing-fence-operations)
3333
- [GFS2 File System Configuration](#gfs2-file-system-configuration)
34+
- [Dynamic Cluster Lifecycle](#dynamic-cluster-lifecycle)
3435
- [References](#references)
3536

3637
## Background: Pacemaker and Corosync
@@ -403,6 +404,42 @@ After the cluster is configured with fencing, you can configure GFS2 file system
403404

404405
- [Configuring a GFS2 File System in a Cluster](https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/configuring_and_managing_high_availability_clusters/assembly_configuring-gfs2-in-a-cluster-configuring-and-managing-high-availability-clusters)
405406

407+
## Dynamic Cluster Lifecycle
408+
409+
Unlike traditional HA clusters that run continuously on all nodes, NNF manages Pacemaker cluster services dynamically on compute nodes based on workflow requirements. Cluster services run **continuously on the Rabbit** but are **started and stopped dynamically on compute nodes**.
410+
411+
### When Cluster Services Start on Compute Nodes
412+
413+
NNF software starts Pacemaker/Corosync cluster services on compute nodes when:
414+
415+
1. A workflow requests GFS2 storage
416+
2. The NNF software provisions the GFS2 file system
417+
3. Compute nodes need to mount the shared storage
418+
419+
At this point, cluster services are started on participating compute nodes, they join the Rabbit's cluster, fencing is enabled, and the GFS2 file system is mounted.
420+
421+
> See [Storage Profiles](https://nearnodeflash.github.io/latest/guides/storage-profiles/readme/) for more information about how to start cluster services using the `PreActivate` command.
422+
423+
### When Cluster Services Stop on Compute Nodes
424+
425+
When the GFS2 workflow completes:
426+
427+
1. The GFS2 file system is unmounted from all compute nodes
428+
2. Storage resources are cleaned up
429+
3. Pacemaker/Corosync cluster services are stopped on compute nodes
430+
4. The Rabbit continues running cluster services
431+
432+
> See [Storage Profiles](https://nearnodeflash.github.io/latest/guides/storage-profiles/readme/) for more information about how to stop cluster services using the `PostDeactivate` command.
433+
434+
This dynamic lifecycle means:
435+
436+
- **Rabbit runs cluster services continuously**: Always ready to accept compute nodes
437+
- **Compute node services are transient**: They run only for the duration of GFS2 workflows
438+
- **Resource efficiency**: Cluster overhead on compute nodes is incurred only when needed
439+
- **Reduced complexity**: No long-running cluster services to maintain on compute nodes between jobs
440+
441+
> **Note:** The cluster configuration (node membership, quorum votes, STONITH resources) is set up during system provisioning and persists on all nodes. Only the cluster *services* on compute nodes are started and stopped dynamically.
442+
406443
## References
407444

408445
- [Red Hat: Configuring and Managing High Availability Clusters](https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/configuring_and_managing_high_availability_clusters/)

0 commit comments

Comments
 (0)