MARC Cluster Guide

From RCSWiki
Revision as of 20:55, 5 September 2023 by Lleung (talk | contribs) (Spell check and formatting)
Jump to navigation Jump to search

MARC status: Cluster operational


No upgrades planned. Please contact us if you experience system issues.

See the MARC Cluster Status page for system notices.

Support Icon.png

Need Help or have other MARC Related Questions?

For all general RCS related issues, questions, or comments, please contact us at support@hpc.ucalgary.ca.

This guide gives an overview of the MARC (Medical Advanced Research Computing) cluster at the University of Calgary.

It is intended to be read by new account holders getting started on MARC, covering such topics as the hardware and performance characteristics, available software, usage policies and how to log in.

If you are looking for how to login to MARC or how to get an account, please see MARC_accounts

Introduction

MARC is a cluster comprised of Linux-based computers purchased in 2019

The MARC cluster has been designed with controls appropriate for Level 3 and Level 4 classified data. The University of Calgary Information Security Classification Standard is published here: https://www.ucalgary.ca/policies/files/policies/im010-03-security-standard_0.pdf

Due to security requirements for Level 3/4 data, some necessary restrictions have been placed on MARC to prevent accidental (or otherwise) data exfiltration.

  • Compute nodes and login nodes have no access to the internet
  • All data must be ingested to MARC by first copying it to SCDS (Secure Compute Data Store) and then fetching it from SCDS to MARC.
  • Resulting data (outputs of analyses) must be copied to SCDS and then fetching it from SCDS to wherever it needs to go using established means.
  • All file accesses are recorded for auditing purposes.
  • ssh connections to MARC must be through the IT Citrix system (Admin VPN is not sufficient nor necessary)
  • All accounts must be IT accounts
  • A project ID is required to use MARC. This project ID is the same number that is used on SCDS

Hardware

MARC has compute nodes of two different varieties:

  • 4 GPU (Graphics Processing Unit)-enabled nodes containing:
    • 40-cores: each node having 2 sockets. Each socket has an Intel Xeon Gold 6148 20-core processor, running at 2.4 GHz.
    • The 40 cores on the individual compute nodes share about 750 GB of RAM (memory) but, jobs should request no more than 753000 MB.
    • Two Tesla V100-PCIE-16GB GPUs.
  • 1 Bigmem Node
    • 80-cores: node with 4 sockets. Each socket has an Intel Xeon Gold 6148 20-core processor, running at 2.4 GHz.
    • The 80 cores on the node share about 3 TB of RAM (memory), but, jobs should request no more than 3000000 MB.

The hardware is broken out into three distinct partitions with the following restrictions.

Partition Purpose and description CPUs per Node GPUs per Node Memory per Node
cpu2019 For non-GPU jobs; homogeneous nodes Up to 38 No GPUs Up to 500GB
gpu2019 For jobs requiring nVidia v100 gpu jobs Up to 40 1 or 2 GPUs Up to 750GB
bigmem For very large memory jobs Up to 80 No GPUs Up to 3TB

Storage

About a petabyte of raw disk storage is available to the MARC cluster, but for error checking and performance reasons, the amount of usable storage for researchers' projects is considerably less than that. From a user's perspective, the total amount of storage is less important than the individual storage limits. As described below, there are two storage areas: home and project.

Home file system: /home

There is a per-user quota of 25 GB under /home. This limit is fixed and cannot be increased. Each user has a directory under /home, which is the default working directory when logging in to MARC. It is expected that most researchers will work from /project and only use home for software and such things. /home is expected to be used only for L1/L2 data and not for your patient identifiable files. The identifiable files go in the appropriate directory under /project.

Project file system for larger projects: /project

Directories will be created in /project named after your project ID. This name will be the same as your SCDS share name. The expectation is that all files to do with that project will be stored in /project/projectid. Quotas in /project are somewhat flexible. Please write to support@hpc.ucalgary.ca with an estimate of how much space you will require.

However, the SCDS share and the project directory on MARC are two separate storages.

Data transferred to the /project directory is a second copy of the data on the SCDS share. MARC storage is not accessible outside of MARC.

On a SCDS share deleting files will not create free space. The NetApp device that hosts the SCDS drive maintains a copy of the deleted files in ‘snapshot space’. Hence the quota is consumed by the files in the SCDS share plus the files in ‘snapshot space’.

Temporary file system: /tmp

Each node has a location called /tmp that is only accessible from within that node. /tmp is a temporary storage. The user has access to /tmp during the run time of a job and can not access /tmp of that node after the job is completed. The user need to ensure that no L4 data is left in the /tmp directory. The jobs must clean up /tmp before exiting and any files or directory created in /tmp must not be world readable or writable.

Software installations

Python

There are some complications in using Python on MARC relative to using ARC. Normally, we would recommend installing conda in user's home directory. On MARC, security requirements for working with L4 data require that we block outgoing and incoming internet connections. As a result, new packages cannot be downloaded with conda.

Depending on what you need, the two recommendations we can make are

  • Download the standard anaconda distribution from the anaconda website to a personal computer: https://repo.anaconda.com/archive/Anaconda3-2020.07-Linux-x86_64.sh
    • Transfer the script to MARC via SCDS
    • Copy it to your /home directory
    • Install it in your home directory with $bash Anaconda3-2020.07-Linux-x86_64.sh
    • you will be asked to agree to a license agreement and to confirm that you wish to create a folder anaconda3 once the installation completes, you will have a new directory under your home directory ~/anaconda3. In order to make it possible to use the local conda instance you will need to change the system path to include your local python directories $ export PATH=~/anaconda3/bin:$PATH
  • Download a docker container with the software that you need including python (e.g. tensorflow-gpu)
    • Transfer the docker container to MARC via SCDS
    • Copy it to your /home directory
    • Run it with singularity
  • Non-open source software which requires a connection to a license server may require admin assistance to set up. contact support@hpc.ucalgary.ca for support.

Further Reading

See Running_jobs for information on starting a job