Getting Started¶

Welcome to Deceema. This guide takes you from your first login to submitting a Slurm job with the correct project and Quality of Service (QoS) settings.

By the end, you will know how to:

Confirm which projects and QoS options you can use.
Find your Deceema home directory.
Understand and customize a Slurm job script.
Submit your script and continue to job monitoring.

Before you begin

You need an active Deceema account and access to a login node. If you have not completed those steps, start with Requesting Access.

1. Confirm Your Account Resources¶

Review your Deceema access approval or onboarding information in Deceema Admin. Record the project code and its corresponding QoS before preparing a job. If those details are missing or unclear, ask your project owner or contact Support; do not guess them.

Account detail	How you use it
Project code	Identifies the project allocation used by your job. Supply it to Slurm with `--account`.
QoS	Selects an available Quality of Service for the job. Supply it with `--qos`.
Home directory	Your personal working area on Deceema, located at `/hpc/home/$USER`.

In the home-directory path, $USER represents your Deceema username. You can find more account details in Deceema Admin.

Match the project and QoS

If you belong to multiple projects or can use multiple QoS options, do not choose them independently. Select the project code that corresponds to the QoS required for your job.

2. Prepare Your First Slurm Script¶

Deceema uses Slurm job scripts to describe the resources a workload needs and the commands it should run. Start with this template:

job.sh
#!/bin/bash
#SBATCH --qos=<qos>
#SBATCH --account=<account>
#SBATCH --time=1:0:0
#SBATCH --ntasks=4
#SBATCH --gres=gpu:1

module purge
module load deceema

# Add your commands below

What the script requests¶

Directive	Request
`--qos=<qos>`	The Quality of Service under which the job will run.
`--account=<account>`	The project allocation to charge for the job.
`--time=1:0:0`	A maximum run time of one hour.
`--ntasks=4`	Four tasks for the workload.
`--gres=gpu:1`	One GPU resource.

The template is a starting point. Resource requests should reflect the needs of your workload.

3. Customize the Script¶

Before submitting job.sh:

Replace <account> with your approved project code.
Replace <qos> with the corresponding QoS.
Review the time, task, and GPU requests.
Replace # Add your commands below with the command that launches your application or workflow.

Do not submit the placeholders

<account> and <qos> are examples, not valid settings. Replace both with values assigned to your Deceema account.

4. Submit Your Job¶

When the script is ready, submit it to Slurm:

$ sbatch job.sh

Slurm returns a job ID when the submission is accepted. Keep that ID—it is the reference you will use to monitor and troubleshoot the job.

Continue to Jobs on Deceema to learn how to inspect the queue, monitor a running job, review output, and manage job failures.

Ready-to-Submit Checklist¶

I reviewed my approved project and its corresponding QoS.
My --account value is the correct project code.
My --qos value corresponds to that project.
My time, task, and GPU requests match my workload.
I replaced the sample comment with the command I want to run.

Acknowledging the Use of Deceema in Your Research¶

Access to Deceema is conditional on acknowledging the service in research outputs generated through its use. Use the acknowledgement statement provided by the Deceema team when preparing publications, presentations, reports, and other research outputs.