Sarus Cheat Sheet

help	List commands and options
version	Print sarus semantic version
--debug	Make commands output debug logs
--verbose	Make commands output info logs

Sarus is driven by its sarus.json configuration file, typically located at
/opt/sarus/<version-number>/etc/sarus.json.

images	`sarus images`	List local images
pull	`sarus pull python:alpine`	Pull image from DockerHub
load	`sarus load ./debian.tar my_debian`	Loads tarball as image
rmi	`sarus rmi centos:7`	Deletes image

run	`sarus run alpine cat /etc/os-release`
--tty	Allocate a pseudo-TTY in the container
--entrypoint echo hi	Overwrite the default ENTRYPOINT of the image
--mount=type=bind, src=HD,dst=CD	Mount custom host directories HD into the container at CD
--mpi	Enable MPI support
--ssh	Enable SSH in the container
--centralized-repository	Use centralized repository instead of the local one

You need to pull the image before you can run the container.

documentation	https://sarus.readthedocs.io
code	https://github.com/eth-cscs/sarus/
download	https://github.com/eth-cscs/sarus/releases

ssh-keygen

Generate SSH keys locally to be used later with

sarus run --ssh ...

More info about SSH hook here.

GPU nbody

sarus run ethcscs/cudasamples:9.2 /usr/local/cuda/samples/bin/x86_64/linux/release/nbody -benchmark -fp64 -numbodies=2000

OSU Micro

sarus run --mpi ethcscs/mvapich:ub1804_cuda92_mpi22_osu /usr/local/libexec/osu-micro-benchmarks/mpi/pt2pt/osu_latency

These require GPU and MPI libraries respectively installed on the host, and sarus.json correctly configured.

GPU nbody

srun -C gpu -N1 -t1 sarus run 
ethcscs/cudasamples:9.2 
/usr/local/cuda/samples/bin/x86_64/linux/release/nbody -benchmark -fp64 -numbodies=200000

MC all2all

srun -C gpu -N2 -t2 sarus run --mpi 
ethcscs/osu-mb:5.3.2-mpich3.1.4 ./osu_latency

Find more examples in the Sarus Cookbook.

Download the Sarus Cheat Sheet

1 Page

Sarus Cheat Sheet (DRAFT) by talita