diff --git a/content/submitting_jobs/partitions/_index.md b/content/submitting_jobs/partitions/_index.md index 3fef5e55a8d263a8943591e69fb0145e2ce09062..7281ca4729282067a8f0ab70677f6087002f07a4 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.