Skip to content
Snippets Groups Projects
resources-allocation-policy.md 5.38 KiB
Newer Older
  • Learn to ignore specific revisions
  • Jan Siwiec's avatar
    Jan Siwiec committed
    # Resource Allocation Policy
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    ## Job Queue Policies
    
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    Resources are allocated to jobs in a fair-share fashion,
    subject to constraints set by the queue and the resources available to the project.
    The fair-share system ensures that individual users may consume approximately equal amounts of resources per week.
    Detailed information can be found in the [Job scheduling][1] section.
    
    Resources are accessible via several queues for queueing the jobs.
    Queues provide prioritized and exclusive access to the computational resources.
    
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    Computational resources are subject to [accounting policy][7].
    
    
    !!! important
        Queues are divided based on a resource type: `qcpu_` for non-accelerated nodes and `qgpu_` for accelerated nodes. <br><br>
    
    Jan Siwiec's avatar
    Jan Siwiec committed
        EuroHPC queues are no longer available. If you are an EuroHPC user, use standard queues based on allocated/required type of resources.
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    
    | <div style="width:86px">Queue</div>| Description |
    | -------------------------------- | ----------- |
    | `qcpu`                           | Production queue for non-accelerated nodes intended for standard production runs. Requires an active project with nonzero remaining resources. Full nodes are allocated. Identical to `qprod`. |
    
    | `qgpu`                           | Dedicated queue for accessing the NVIDIA accelerated nodes. Requires an active project with nonzero remaining resources. It utilizes 8x NVIDIA A100 with 320GB HBM2 memory per node. The PI needs to explicitly ask support for authorization to enter the queue for all users associated with their project. **On Karolina, you can allocate 1/8 of the node - 1 GPU and 16 cores**. For more information, see [Karolina qgpu allocation][4]. |
    
    | `qgpu_big`                       | Intended for big jobs (>16 nodes), queue priority is lower than production queue prority, **priority is temporarily increased every even weekend**. |
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    | `qcpu_biz`<br>`qgpu_biz`         | Commercial queues, slightly higher priority.                   |
    
    | `qcpu_exp`<br>`qgpu_exp`         | Express queues for testing and running very small jobs. There are 2 nodes always reserved (w/o accelerators), max 8 nodes available per user. The nodes may be allocated on a per core basis. It is configured to run one job and accept five jobs in a queue per user. |
    
    | `qcpu_free`<br>`qgpu_free`       | Intended for utilization of free resources, after a project exhausted all its allocated resources. Note that the queue is **not free of charge**. [Normal accounting][2] applies. Consumed resources will be accounted to the Project. Access to the queue is removed if consumed resources exceed 150% of the allocation. Full nodes are allocated. |
    
    | `qcpu_long`       | Queues for long production runs. Require an active project with nonzero remaining resources. Only 200 nodes without acceleration may be accessed. Full nodes are allocated. |
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    | `qcpu_preempt`<br>`qgpu_preempt` | Free queues with the lowest priority (LP). The queues require a project with allocation of the respective resource type. There is no limit on resource overdraft. Jobs are killed if other jobs with a higher priority (HP) request the nodes and there are no other nodes available. LP jobs are automatically re-queued once HP jobs finish, so **make sure your jobs are re-runnable**. |
    | `qdgx`                           | Queue for DGX-2, accessible from Barbora. |
    | `qfat`                           | Queue for fat node, PI must request authorization to enter the queue for all users associated to their project. |
    | `qviz`                           | Visualization queue Intended for pre-/post-processing using OpenGL accelerated graphics. Each user gets 8 cores of a CPU allocated (approx. 64 GB of RAM and 1/8 of the GPU capacity (default "chunk")). If more GPU power or RAM is required, it is recommended to allocate more chunks (with 8 cores each) up to one whole node per user. This is currently also the maximum allowed allocation per one user. One hour of work is allocated by default, the user may ask for 2 hours maximum. |
    
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    See the following subsections for the list of queues:
    
    * [Karolina queues][5]
    * [Barbora queues][6]
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    ## Queue Notes
    
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    The job time limit defaults to **half the maximum time**, see the table above.
    Longer time limits can be [set manually, see examples][3].
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    Jobs that exceed the reserved time limit get killed automatically.
    The time limit can be changed for queuing jobs (state Q) using the `scontrol modify job` command,
    however it cannot be changed for a running job.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    ## Queue Status
    
    !!! tip
        Check the status of jobs, queues and compute nodes [here][c].
    
    
    ![rsweb interface](../img/barbora_cluster_usage.png)
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    Display the queue status:
    
    ```console
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    ```
    
    
    The Slurm allocation overview may also be obtained using the `rsslurm` command:
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    ```console
    
    $ rsslurm
    Usage: rsslurm [options]
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    Options:
      --version             show program's version number and exit
      -h, --help            show this help message and exit
      --get-server-details  Print server
      --get-queues          Print queues
      --get-queues-details  Print queues details
      --get-reservations    Print reservations
      --get-reservations-details
                            Print reservations details
    
    Jan Siwiec's avatar
    Jan Siwiec committed
      ...
      ..
      .
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    ```
    
    ---8<--- "mathjax.md"
    
    [1]: job-priority.md
    [2]: #resource-accounting-policy
    
    Roman Sliva's avatar
    Roman Sliva committed
    [3]: job-submission-and-execution.md
    
    Roman Sliva's avatar
    Roman Sliva committed
    [4]: karolina-slurm.md
    
    [5]: ./karolina-partitions.md
    [6]: ./barbora-partitions.md
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    [7]: ./resource-accounting.md
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    [a]: https://support.it4i.cz/rt/
    [c]: https://extranet.it4i.cz/rsweb