From 660de8d6c8a1b108f358400546dd4159a34df7c1 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Ferr=C3=A3o?= Date: Sat, 11 Jul 2026 17:59:43 -0300 Subject: [PATCH 1/2] docs/install: fix comment spacing in code blocks MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A few code blocks run a comment line directly against the previous command, while every other comment in the same block is preceded by a blank line. Add the missing blank lines for consistent rendering: - network/infiniband/head-node.md.j2 (Start up NetworkManager) - scheduler/slurm/install.md.j2 (Setup default cgroups file) - customize/memlimits.md.j2 (Update memlock settings on compute) - customize/nhc.md.j2 (execute every five minutes) Cosmetic only. Signed-off-by: Vinícius Ferrão Sponsored-by: VersatusHPC --- docs/install/templates/customize/memlimits.md.j2 | 1 + docs/install/templates/customize/nhc.md.j2 | 1 + docs/install/templates/network/infiniband/head-node.md.j2 | 1 + docs/install/templates/scheduler/slurm/install.md.j2 | 1 + 4 files changed, 4 insertions(+) diff --git a/docs/install/templates/customize/memlimits.md.j2 b/docs/install/templates/customize/memlimits.md.j2 index 30194e2f11..5c3e18def5 100644 --- a/docs/install/templates/customize/memlimits.md.j2 +++ b/docs/install/templates/customize/memlimits.md.j2 @@ -16,6 +16,7 @@ echo '* soft memlock unlimited' >> \ /etc/security/limits.d/40-ohpc-limits.conf echo '* hard memlock unlimited' >> \ /etc/security/limits.d/40-ohpc-limits.conf + # Update memlock settings on compute {{ compute_echo("* soft memlock unlimited", "/etc/security/limits.d/40-ohpc-limits.conf") }} {{ compute_echo("* hard memlock unlimited", "/etc/security/limits.d/40-ohpc-limits.conf") }} diff --git a/docs/install/templates/customize/nhc.md.j2 b/docs/install/templates/customize/nhc.md.j2 index 8e423eae23..db6477789b 100644 --- a/docs/install/templates/customize/nhc.md.j2 +++ b/docs/install/templates/customize/nhc.md.j2 @@ -33,6 +33,7 @@ bad nodes, reducing the risk of system-induced job failures. ```bash # Register as SLURM's health check program echo "HealthCheckProgram=/usr/sbin/nhc" >> /etc/slurm/slurm.conf + # execute every five minutes echo "HealthCheckInterval=300" >> /etc/slurm/slurm.conf ``` diff --git a/docs/install/templates/network/infiniband/head-node.md.j2 b/docs/install/templates/network/infiniband/head-node.md.j2 index 41db149597..df2140736e 100644 --- a/docs/install/templates/network/infiniband/head-node.md.j2 +++ b/docs/install/templates/network/infiniband/head-node.md.j2 @@ -43,6 +43,7 @@ sed -i "s/ipoib_netmask/${ipoib_netmask}/" \ # configure NetworkManager to *not* override local /etc/resolv.conf echo "[main]" > /etc/NetworkManager/conf.d/90-dns-none.conf echo "dns=none" >> /etc/NetworkManager/conf.d/90-dns-none.conf + # Start up NetworkManager to initiate ib0 systemctl start NetworkManager diff --git a/docs/install/templates/scheduler/slurm/install.md.j2 b/docs/install/templates/scheduler/slurm/install.md.j2 index c68d0c2a81..1da126171b 100644 --- a/docs/install/templates/scheduler/slurm/install.md.j2 +++ b/docs/install/templates/scheduler/slurm/install.md.j2 @@ -14,6 +14,7 @@ also needs to be running on all hosts within the resource management pool. # Use ohpc-provided file for starting SLURM configuration cp /etc/slurm/slurm.conf.ohpc /etc/slurm/slurm.conf + # Setup default cgroups file cp /etc/slurm/cgroup.conf.example /etc/slurm/cgroup.conf From da2170157cf8ffb535bd6422a8d2b017ac1928e5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vin=C3=ADcius=20Ferr=C3=A3o?= Date: Sat, 11 Jul 2026 18:31:23 -0300 Subject: [PATCH 2/2] docs/install: drop redundant .service suffix in systemctl calls MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The guides overwhelmingly use bare unit names with systemctl (32 call sites) but seven stragglers spell out .service -- sometimes inconsistently within the same file (nfs.md.j2, time.md.j2). Normalize on the bare name; systemctl appends .service by default. Cosmetic only. Signed-off-by: Vinícius Ferrão Sponsored-by: VersatusHPC --- docs/install/templates/base-os/nfs.md.j2 | 2 +- docs/install/templates/base-os/time.md.j2 | 2 +- docs/install/templates/network/infiniband/head-node.md.j2 | 2 +- docs/install/templates/provisioner/openchami/setup.md.j2 | 4 ++-- .../provisioner/warewulf/compute-install-slurm.md.j2 | 4 ++-- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/install/templates/base-os/nfs.md.j2 b/docs/install/templates/base-os/nfs.md.j2 index cad384c344..5b2955aec4 100644 --- a/docs/install/templates/base-os/nfs.md.j2 +++ b/docs/install/templates/base-os/nfs.md.j2 @@ -10,7 +10,7 @@ example configuration. ```bash # Install and Start NFS server {{ pkg_install }} nfs-utils -systemctl start nfs-server.service +systemctl start nfs-server # Create OpenHPC public packages directory mkdir -p /opt/ohpc/pub diff --git a/docs/install/templates/base-os/time.md.j2 b/docs/install/templates/base-os/time.md.j2 index 185649338b..ea86e1da74 100644 --- a/docs/install/templates/base-os/time.md.j2 +++ b/docs/install/templates/base-os/time.md.j2 @@ -9,7 +9,7 @@ to serve as a local time server for the cluster, issue the following: ```bash {{ pkg_install }} chrony -systemctl enable chronyd.service +systemctl enable chronyd echo "local stratum 10" >> /etc/chrony.conf echo "server ${ntp_server}" >> /etc/chrony.conf echo "allow all" >> /etc/chrony.conf diff --git a/docs/install/templates/network/infiniband/head-node.md.j2 b/docs/install/templates/network/infiniband/head-node.md.j2 index df2140736e..18d347aa26 100644 --- a/docs/install/templates/network/infiniband/head-node.md.j2 +++ b/docs/install/templates/network/infiniband/head-node.md.j2 @@ -10,7 +10,7 @@ drivers to the chosen *head node*. {{ pkg_group_install }} "InfiniBand Support" # Load IB services udevadm trigger --type=devices --action=add -systemctl restart rdma-load-modules@infiniband.service +systemctl restart rdma-load-modules@infiniband ``` diff --git a/docs/install/templates/provisioner/openchami/setup.md.j2 b/docs/install/templates/provisioner/openchami/setup.md.j2 index 68a640efed..173748f156 100644 --- a/docs/install/templates/provisioner/openchami/setup.md.j2 +++ b/docs/install/templates/provisioner/openchami/setup.md.j2 @@ -101,8 +101,8 @@ containers to start. ```bash systemctl daemon-reload -systemctl start minio.service -systemctl start registry.service +systemctl start minio +systemctl start registry ``` diff --git a/docs/install/templates/provisioner/warewulf/compute-install-slurm.md.j2 b/docs/install/templates/provisioner/warewulf/compute-install-slurm.md.j2 index 1bda705539..54f4936b90 100644 --- a/docs/install/templates/provisioner/warewulf/compute-install-slurm.md.j2 +++ b/docs/install/templates/provisioner/warewulf/compute-install-slurm.md.j2 @@ -6,8 +6,8 @@ wwctl image exec --build=false {{ baseos }} -- /bin/bash -ex <<- EOF dnf -y install ohpc-slurm-client # Enable services to start on boot - systemctl enable munge.service - systemctl enable slurmd.service + systemctl enable munge + systemctl enable slurmd # Add Network Time Protocol (NTP) support dnf -y install chrony