Expand guest partition section.

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.