From ea5ab9fd433e255f618f0730173881bf77b60190 Mon Sep 17 00:00:00 2001
From: Adam Caprez <acaprez2@unl.edu>
Date: Wed, 26 Jun 2024 19:14:58 +0000
Subject: [PATCH] Expand guest partition section.
---
content/submitting_jobs/partitions/_index.md | 46 ++++++++++++++++++--
1 file changed, 43 insertions(+), 3 deletions(-)
diff --git a/content/submitting_jobs/partitions/_index.md b/content/submitting_jobs/partitions/_index.md
index 3fef5e55..7281ca47 100644
--- a/content/submitting_jobs/partitions/_index.md
+++ b/content/submitting_jobs/partitions/_index.md
@@ -86,10 +86,50 @@ or in the general queue, wherever resources become available first
(taking into account FairShare). Unless there are specific reasons to limit jobs
to owned resources, this method is recommended to maximize job throughput.
-### Guest Partition
+### Guest Partition(s)
The `guest` partition can be used by users and groups that do not own
dedicated resources on Swan. Jobs running in the `guest` partition
will run on the owned resources with Intel OPA interconnect. The jobs
-are preempted when the resources are needed by the resource owners and
-are restarted on another node.
+are preempted when the resources are needed by the resource owners:
+guest jobs will be killed and returned to the queue in a pending state
+until they can be started on another node.
+HCC recommends verifying job behavior will support the restart and
+modifying job scripts if necessary.
+
+To submit your job to the guest partition add the line
+
+{{% panel theme="info" header="Submit to guest partition" %}}
+{{< highlight bash >}}
+#SBATCH --partition=guest
+{{< /highlight >}}
+{{% /panel %}}
+
+to your submit script.
+
+Owned GPU resources may also be accessed in an opportunistic manner by
+submitting to the `guest_gpu` partition. Similar to `guest`, jobs are
+preempted when the GPU resources are needed by the owners. To submit
+your job to the `guest_gpu` partition, add the lines
+
+{{% panel theme="info" header="Submit to guest_gpu partition" %}}
+{{< highlight bash >}}
+#SBATCH --partition=guest_gpu
+#SBATCH --gres=gpu
+{{< /highlight >}}
+{{% /panel %}}
+
+to your SLURM script.
+
+#### Preventing job restart
+
+By default, jobs on the `guest` partition will be restarted elsewhere when they
+are preempted. To prevent preempted jobs from being restarted add the line
+
+{{% panel theme="info" header="Prevent job restart on guest partition" %}}
+{{< highlight bash >}}
+#SBATCH --no-requeue
+{{< /highlight >}}
+{{% /panel %}}
+
+to your SLURM submit file.
--
GitLab